Skip to content

Commit 800ba71

Browse files
hoomanclaude
andcommitted
docs: update session end docs and test count
- CLAUDE.md: document session end confirmation prompt, --yes flag, selective staging (data/ only), update test count to 381 - CLAUDE_CHAT_SESSION_INSTRUCTIONS.md: detail session end behavior including file review, confirmation, selective staging, abort path Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 3144115 commit 800ba71

2 files changed

Lines changed: 12 additions & 4 deletions

File tree

CLAUDE.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -226,8 +226,9 @@ uv run baft session start --session-id my-run # Start with explicit ID
226226
uv run baft session status # Show active sessions + service health
227227
uv run baft session sync-check # Check if framework remote has new commits
228228
uv run baft session sync # Pull framework + incremental DuckDB import
229-
uv run baft session end # End session (commit + push framework)
229+
uv run baft session end # End session (shows changes, confirms, commits + pushes)
230230
uv run baft session end -m "added new entity" # End with commit message
231+
uv run baft session end --yes # Skip confirmation prompt
231232
```
232233

233234
## Session CLI details
@@ -236,7 +237,7 @@ The `baft` CLI provides session lifecycle automation:
236237

237238
- **`baft preflight`** — Validates the entire environment: Python, uv, repos, deps, env vars, NATS, Ollama, DuckDB, framework git status (10 checks)
238239
- **`baft session start`** — Pulls framework, runs incremental DuckDB import, checks services, registers session marker
239-
- **`baft session end`**Unregisters session, commits framework changes, pushes to remote
240+
- **`baft session end`**Shows changed files, asks for confirmation, commits only `data/` directory + tracked changes, pushes to remote. Use `--yes/-y` to skip confirmation
240241
- **`baft session status`** — Shows active sessions, framework git state, service health
241242
- **`baft session sync-check`** — Fetches remote, reports ahead/behind/diverged status
242243
- **`baft session sync`** — Fast-forward pulls framework and runs incremental DuckDB import
@@ -257,7 +258,7 @@ All configuration and infrastructure is implemented and working:
257258
- Telegram-to-source-bundle converter
258259
- Config resolution script (silo expansion, ${ITP_ROOT} substitution)
259260
- OpenTelemetry tracing integration (`baft.tracing` module)
260-
- Unit tests: 356 tests pass (workers, contracts, pipelines, DuckDB import, config resolution, new loom features)
261+
- Unit tests: 381 tests pass (workers, contracts, pipelines, DuckDB import, config resolution, sessions, new loom features)
261262
- Helm chart with 24 deployments (13 workers + infra + services), helm lint clean
262263
- 7 Dockerfiles for container images (worker, router, pipeline, workshop, mcp, import, commit-agent)
263264
- CI: docs deploy, helm lint, container image build on tag push

docs/CLAUDE_CHAT_SESSION_INSTRUCTIONS.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,18 @@ When the analyst says they're done or wants to end the session:
3333
1. Ask: "Would you like me to commit the framework changes from this
3434
session? If so, please provide a brief description."
3535
2. Call `session.end` with their message
36-
3. Confirm the result:
36+
3. The CLI will:
37+
- Show the list of changed files for review
38+
- Ask for confirmation before committing (use `--yes` to skip)
39+
- Commit only the `data/` directory and tracked changes (prevents
40+
accidental staging of untracked files)
41+
- Push to remote
42+
4. Confirm the result:
3743
- If committed + pushed: "Changes committed and pushed."
3844
- If committed but push failed: "Committed locally but push failed.
3945
Run `baft session sync-check` to diagnose."
4046
- If no changes: "No framework changes to commit. Session ended."
47+
- If analyst cancels at confirmation: "Aborted. Session still active."
4148

4249
## Available tool namespaces
4350

0 commit comments

Comments
 (0)