docs: add efficiency-levers setup and current-run instructions

- PROJECT_STATE.md: section on three deployed levers (FK annotations, context-pack, recap v2)
  with setup instructions for new workspaces; psd pre-configured
- README.md: one-time setup for workspace (tht schema suggest-fks); note that levers 2+3 auto-activate
- Updated 'How to run' with explicit command and prereq checklist
- Last-updated timestamp: 2026-07-08

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-07 17:43:51 +02:00
co-authored by Claude Fable 5
parent e24b41b156
commit ade6838182
2 changed files with 54 additions and 5 deletions
+21
View File
@@ -65,6 +65,27 @@ tht lsh build -c /path/to/tht-workspace-<customer>/<customer>.yaml
tht session new -c /path/to/tht-workspace-<customer>/<customer>.yaml
```
## Efficiency levers setup (one-time per workspace)
To enable the three deployed optimization levers on a **new workspace**:
```bash
# Lever 1: Foreign key suggestions from approved SQL + heuristics.
# Run once after schema introspection to populate annotations.yaml.
tht schema suggest-fks \
--from-sql /path/to/customer/sessions \
--assume cod_paz=dim_patient \
-c /path/to/customer/workspace.yaml \
--write
# (psd workspace: 228 FK suggestions already generated via this command 2026-07-08)
# Levers 2 + 3: automatic at next session (context-pack + recap from ledger).
# No setup needed — SKILL.md prescribes them automatically.
```
See `PROJECT_STATE.md` for what each lever does.
## The workflow
`workflow.yaml` is the **single source of workflow truth** (spec F2). Eight phases