Skip to content

docs(SMA-25): recover codex artefacts from blocked branch#37

Merged
cskwork merged 1 commit into
mainfrom
chore/recover-sma-25-artefacts
May 17, 2026
Merged

docs(SMA-25): recover codex artefacts from blocked branch#37
cskwork merged 1 commit into
mainfrom
chore/recover-sma-25-artefacts

Conversation

@cskwork
Copy link
Copy Markdown
Owner

@cskwork cskwork commented May 17, 2026

Summary

Recovers the high-signal phase deliverables that SMA-25's codex worker produced before self-Blocking at the Learn merge gate. The Blocked state itself was caused by a sandbox gap (no .git/worktrees/<ID>/ in writable_roots), which #36 fixes separately. The artefacts under docs/SMA-25/ and docs/llm-wiki/ are independent of that gap and are worth keeping.

What was recovered (11 files, +311 lines)

Path Purpose
docs/SMA-25/explore/notes.md Explore findings — including the base-squash lifecycle risk that went beyond the original brief
docs/SMA-25/explore/reuse-inventory.md Reuse inventory from Explore
docs/SMA-25/plan/implementation-plan.md Implementation plan
docs/SMA-25/work/feature.md + qa-rewind.md Work-phase deliverables (initial + post-QA rewind)
docs/SMA-25/qa/api-surface.md + details.md QA evidence (gates that ran, surfaces touched)
docs/SMA-25/learn/details.md Learn write-up, including the explicit merge-gate failure capture
docs/features/SMA-25/index.md As-Is/To-Be one-pager
docs/llm-wiki/workspace-auto-commit-excludes.md New wiki entry for the symphony.autocommitExclude opt-in
docs/llm-wiki/INDEX.md One new row referencing the wiki entry (kept the existing SMA-24 row that the SMA-25 branch had silently dropped)

What was deliberately NOT recovered

How verified

git diff --cached --stat

shows exactly the 11 listed paths and no source-code or version-file changes. The docs/llm-wiki/INDEX.md row count is unchanged versus main except for one new appended workspace-auto-commit-excludes row — the SMA-24 orchestrator-phase-transition row is preserved.

Test plan

  • CI green (docs-only, no source changes)
  • The wiki entry renders correctly on GitHub

SMA-25 (Verify autocommitExclude mechanism from PR #23) ran on codex
and was self-Blocked at Learn when the merge gate failed against
.git/worktrees/<ID>/ — the codex sandbox refused writes through the
worktree's git admin dir. That sandbox gap is fixed separately in PR #36.

The agent reached Learn with substantive artefacts though, and they are
worth keeping independently of the merge-gate failure. This recovers
only the high-signal files from `symphony/SMA-25` (commit 9c964fe) and
leaves out the per-turn status echoes and raw pytest JSON/diff runs
that were progress noise rather than reference material.

Recovered:
- docs/SMA-25/{explore,plan,work,qa,learn}/* — phase deliverables
  (Explore notes + reuse inventory, implementation plan, work + qa-rewind
  summaries, QA api-surface + details, Learn details).
- docs/features/SMA-25/index.md — As-Is/To-Be one-pager.
- docs/llm-wiki/workspace-auto-commit-excludes.md — new wiki entry
  covering the opt-in `symphony.autocommitExclude` mechanism, including
  the base-squash safety case Explore surfaced beyond the original brief.
- docs/llm-wiki/INDEX.md — one new row for the wiki entry (kept the
  existing SMA-24 `orchestrator-phase-transition` row, which the
  SMA-25 branch had silently dropped because it was forked before SMA-24
  merged into main).

Not recovered (deliberately):
- docs/SMA-25/todo/turn-*-status.md + blocker.md (stale-worker echo logs
  from the pre-restart cycle).
- docs/SMA-25/qa/runs/*.json + qa/diff/*.diff (raw pytest output, large
  and reproducible from `pytest` directly).
- src/symphony/*.py / tests/*.py / pyproject.toml / __init__.py changes
  on the SMA-25 branch — those were forked before PR #19/#21/#22/#23/#34/
  #36 landed and would revert main.
@cskwork cskwork merged commit 5c8f41e into main May 17, 2026
2 of 3 checks passed
@cskwork cskwork deleted the chore/recover-sma-25-artefacts branch May 17, 2026 10:04
@cskwork cskwork mentioned this pull request May 17, 2026
2 tasks
cskwork added a commit that referenced this pull request May 17, 2026
Patch release rolling up two post-0.6.1 reliability fixes:

- #36 codex sandbox writable_roots now auto-includes the git-worktree
       gitdir (`.git/worktrees/<ID>/`). Without this, codex 0.130 with
       workspace-write sandbox refused index.lock / merge-tree writes,
       causing Learn-stage Symphony tickets to surface as "Blocked" with
       no obvious cause. Surfaced live on SMA-25.

- #37 (docs-only) recovered the high-signal codex artefacts from the
       blocked SMA-25 branch — Explore through Learn deliverables plus
       a new `workspace-auto-commit-excludes` wiki entry. Included here
       only because the release notes should point at the wiki entry as
       canonical reference for the autocommitExclude opt-in.

All changes are bug fixes restoring intended behavior — no user-facing
feature additions or signature changes. Pinning pyproject.toml and
src/symphony/__init__.py in lockstep.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant