|
1 | 1 | --- |
2 | | -updated_at: 2026-03-23T22:00:00Z |
3 | | -focus_area: Release Stabilized, Process Hardened, Community Engaged |
4 | | -version: v0.9.1 |
5 | | -branch: main |
6 | | -tests_passing: 4655+ |
7 | | -tests_todo: ~20 |
8 | | -tests_skipped: ~5 |
9 | | -test_files: 149 |
10 | | -team_size: 19 active agents + Scribe + Ralph + @copilot |
| 2 | +updated_at: 2026-06-10T13:50:00+03:00 |
| 3 | +focus_area: Framework R&D — empirical validation, governance integrity, MCP architecture |
| 4 | +version: v0.10.0 (shipped); developing toward v0.10.1+ |
| 5 | +branch: main / squad/1244-memory-mcp-bridge |
| 6 | +team_size: 19 active engineers + Fact Checker + Scribe + Ralph + @copilot |
11 | 7 | team_identity: Apollo 13 / NASA Mission Control |
12 | | -process: All work through PRs. Branch naming squad/{issue-number}-{slug}. Releases driven by Surgeon. Pre-flight gates mandatory. Never commit to main directly. |
| 8 | +cto: Tamir Dresher (Microsoft EMU — tamirdresher_microsoft) |
| 9 | +maintainer: Brady Gaster (bradygaster) — upstream owner |
| 10 | +operating_mode: Tamir's principal engineers — investigative + framework R&D |
13 | 11 | --- |
14 | 12 |
|
15 | 13 | # What We're Focused On |
16 | 14 |
|
17 | | -**Status:** Release v0.9.1 stable on npm. Docs deployed with dark mode fix. 10 community PRs merged. Discussion board fully triaged. Release process hardened with 6 action items (A1–A6). 9 GitHub issues filed for improvements. Ready for next development cycle. |
18 | | - |
19 | | -## Session Recap: Release Crisis Recovery & Governance Hardening (2026-03-23) |
20 | | - |
21 | | -**Agents Deployed:** Flight (Lead), EECOM (SDK/CLI), Booster (DevOps), Surgeon (Release), PAO (DevRel), Coordinator |
22 | | - |
23 | | -### Release Incident Resolved |
24 | | -**v0.9.0 → v0.9.1:** Critical defect in CLI package (dependency reference). Published with `"file:../squad-sdk"` (local path) instead of registry version. Broken on global install. Detected immediately; hotfix prepared in minutes. **Publish workflow infrastructure failed:** GitHub Actions cache race condition + npm workspace automation issues + npm 2FA hang. Extended resolution from 10 minutes to 8 hours. |
25 | | - |
26 | | -**Root causes identified (5 total):** |
27 | | -1. Dependency validation gap (prefixable — no pre-publish checks) |
28 | | -2. GitHub workflow cache race condition (GitHub infrastructure bug) |
29 | | -3. npm workspace publish broken with 2FA enabled (tool gap) |
30 | | -4. Coordinator repeated failed approaches (process gap) |
31 | | -5. No pre-publish verification step (preventable) |
32 | | - |
33 | | -**Outcomes:** |
34 | | -- ✅ v0.9.1 released and stable |
35 | | -- ✅ Preflight job added to publish pipeline (dependency scanning) |
36 | | -- ✅ Release governance hardened (Surgeon owns all publishing) |
37 | | -- ✅ 6 action items (A1–A6) documented for next release |
38 | | -- ✅ Release process skill created at `.squad/skills/release-process/SKILL.md` |
39 | | - |
40 | | -### PRs Merged (10 total) |
41 | | -| PR | Title | Status | |
42 | | -|---|---|---| |
43 | | -| #569 | Docs deployment | ✅ Merged | |
44 | | -| #570 | Dark mode fix (ViewTransitions + 3-layer theme) | ✅ Merged | |
45 | | -| #571 | Docs features | ✅ Merged | |
46 | | -| #555 | Community contribution | ✅ Merged | |
47 | | -| #552 | Community contribution | ✅ Merged | |
48 | | -| #568 | Infrastructure improvement | ✅ Merged | |
49 | | -| #572 | Chinese README (PAO/community collab) | ✅ Merged | |
50 | | -| #513 | Earlier feature work | ✅ Merged | |
51 | | -| #573 | Community contribution | ✅ Merged | |
52 | | -| #574 | Community contribution | ✅ Merged | |
53 | | - |
54 | | -**PR #507:** Closed (superseded by #572) |
55 | | - |
56 | | -### Issues Filed (9 total) |
57 | | -**#556–#564:** Release process improvements documented by Flight: |
58 | | -- Dependency validation patterns |
59 | | -- npm workspace publish policy |
60 | | -- GitHub Actions cache handling |
61 | | -- Publish escalation protocol |
62 | | -- Pre-flight checklist |
63 | | -- Smoke test gating |
64 | | -- Runbook documentation |
65 | | - |
66 | | -### Community Engagement |
67 | | -**Discussion Triage:** 15 discussions analyzed by PAO |
68 | | -- 4 close-as-resolved (features shipped) |
69 | | -- 1 consolidate (duplicate answer) |
70 | | -- 2 convert-to-issue (bugs/roadmap) |
71 | | -- 8 keep-open (ongoing feedback) |
72 | | - |
73 | | -**Critical Finding:** Teams MCP docs need urgent update — Office 365 Connectors deprecated Dec 2024, needs Power Automate Workflows path. |
74 | | - |
75 | | -### Governance Decisions Merged (12 total) |
76 | | -**Infrastructure & CI:** CI audit (15 workflows, lean + healthy), preflight job (dependency scanning), ghost workflow cleanup |
77 | | - |
78 | | -**Release & Process:** Surgeon owns all publishing; strict playbooks; pre-publish validation; escalation protocol; smoke tests mandatory; npm-only distribution; runbooks in PUBLISH-README.md |
79 | | - |
80 | | -**Community:** README slim-down (512 → 331 lines); discussion triage patterns; v0.9.0 blog structure; Teams MCP urgency |
81 | | - |
82 | | -### Skills Created |
83 | | -**`.squad/skills/release-process/SKILL.md`:** Comprehensive skill documenting pre-publish validation, publish automation flow, GitHub Actions failure runbook, npm workspace policy, escalation protocol, post-publish verification. |
84 | | - |
85 | | -### Team Learnings Documented |
86 | | -- **Flight:** Issue filing patterns, PR triage workflow |
87 | | -- **EECOM:** CLI version subcommand pattern (inline handlers) |
88 | | -- **Booster:** CI preflight patterns, workflow audit methodology |
89 | | -- **Surgeon:** Release governance rules, retrospective analysis patterns |
90 | | -- **PAO:** Discussion triage patterns, Teams MCP urgency, Chinese README workflow |
| 15 | +**Status:** v0.10.0 shipped (March 2026). Active work: framework R&D under Tamir Dresher (Squad CTO). Recent focus has been empirical validation of the governed memory subsystem — exposing real architectural drift and silent-failure modes that the docs and tests did not catch. |
91 | 16 |
|
92 | | -## Current State |
| 17 | +## Operating Context (June 2026) |
93 | 18 |
|
94 | | -**Version:** v0.9.1 (released, on npm, stable) |
95 | | -- **Packages:** @bradygaster/squad-sdk@0.9.1, @bradygaster/squad-cli@0.9.1 |
96 | | -- **Branch:** main (default) |
97 | | -- **Build:** ✅ clean (0 errors) |
98 | | -- **Tests:** 4,655+ passed, ~20 todo, ~5 skipped, 149 test files |
99 | | -- **Docs:** Deployed to production with dark mode fix |
| 19 | +The team is now operating in two parallel modes simultaneously: |
100 | 20 |
|
101 | | -**Open Issues:** 9 filed for release improvements (#556–#564). PR #567 (StorageProvider) parked as draft. Ready for next development phase. |
| 21 | +1. **Brady's upstream maintenance** — releases, community PRs, customer-facing stability work. Driven by Surgeon 🚢 + Booster ⚙️ + PAO 📣. |
| 22 | +2. **Tamir's framework R&D** — empirical hardening of the architecture: governance integrity, MCP correctness, memory governance, claim-verification discipline. Driven by Procedures 🧠 + EECOM 🔧 + Fact Checker 🔍 + Flight 🏗️. |
102 | 23 |
|
103 | | -## Next Steps |
| 24 | +Both modes share the same roster and the same `.squad/decisions.md`. Coordination happens through this team's standard drop-box pattern — no parallel state. |
| 25 | + |
| 26 | +## Recent Sessions — Memory MCP Gap Investigation (2026-06-09 → 2026-06-10) |
| 27 | + |
| 28 | +**Coordinator + manual A/B testing.** Discovered architectural defects in the governed memory pipeline that, in combination, allow agents to silently fabricate audit-log entries: |
| 29 | + |
| 30 | +| # | Finding | Issue/PR | |
| 31 | +|---|---------|----------| |
| 32 | +| 1 | `.copilot/skills/` vs `.squad/skills/` docs drift | [#1241](https://github.com/bradygaster/squad/issues/1241) / [PR #1242 ✅](https://github.com/bradygaster/squad/pull/1242) | |
| 33 | +| 2 | `history.md` vs governed-memory direction unclear | [#1243](https://github.com/bradygaster/squad/issues/1243) | |
| 34 | +| 3 | `memory_*` tools not exposed via squad_state MCP | [#1244](https://github.com/bradygaster/squad/issues/1244) / [PR #1245](https://github.com/bradygaster/squad/pull/1245) | |
| 35 | +| 4 | `squad.agent.md` spawn template bypasses classifier | [#1246](https://github.com/bradygaster/squad/issues/1246) | |
| 36 | +| 5 | Workspace-only `.mcp.json` doesn't load in `copilot -p` → agents forge audit entries | [#1247](https://github.com/bradygaster/squad/issues/1247) | |
| 37 | +| 6 | Two-layer upgrade docs miss pre-commit hook | [#1226](https://github.com/bradygaster/squad/issues/1226) / [PR #1227](https://github.com/bradygaster/squad/pull/1227) | |
| 38 | +| 7 | Conditional `.gitignore` for two-layer/orphan | [#1228](https://github.com/bradygaster/squad/issues/1228) / [PR #1229](https://github.com/bradygaster/squad/pull/1229) | |
| 39 | + |
| 40 | +**Pending — to be filed 2026-06-10:** |
| 41 | +- `.squad/identity/*` not in mutable-state allowlist of `squad_state_write` (this very session hit it) |
| 42 | +- `squad_decide` author-name regex (`[A-Za-z0-9_-]+` only) prevents naming actors with role context |
104 | 43 |
|
105 | | -### Immediate (This Sprint) |
106 | | -- [ ] Implement A1–A6 action items from release retrospective |
107 | | -- [ ] Delete ghost workflow (publish-npm.yml) via GitHub API |
108 | | -- [ ] Update Teams MCP docs (Office 365 → Power Automate) |
109 | | -- [ ] Enable Ralph's heartbeat cron if periodic triage desired |
| 44 | +**Empirical methodology established:** every architectural claim is now verified via reproducible A/B test before being filed. Pattern is captured in the new Fact Checker charter (`.squad/agents/fact-checker/charter.md`). |
110 | 45 |
|
111 | | -### Short-Term (Next Release) |
112 | | -- [ ] Mandatory pre-flight checklist before tagging any release |
113 | | -- [ ] Update PUBLISH-README.md with full runbook |
114 | | -- [ ] Add semver validation to bump-build.mjs |
115 | | -- [ ] Policy: 2FA must be auth-only; always `cd` into package for publish |
| 46 | +## Team Structure Update (2026-06-10) |
116 | 47 |
|
117 | | -### Backlog |
118 | | -- **#556–#564** — Release improvements (9 issues) |
119 | | -- **#567** — StorageProvider PRD (draft, parked for v1.0) |
| 48 | +**Fact Checker promoted to roster.** Previously existed as a stub charter (256 bytes), never on team.md. Now: |
120 | 49 |
|
121 | | -## Process |
| 50 | +- Full charter with FAO-inspired role definition, verification methodology, hard rules |
| 51 | +- On routing.md as the verification specialist |
| 52 | +- Owns the new **Pre-Ship Fact Check** ceremony in `ceremonies.md` |
| 53 | +- Tier policy: Lightweight (manual) / Standard (Pre-Ship) / Full (multi-claim batch) |
| 54 | + |
| 55 | +**Known gap (not fixed here):** Rai 🛡️ (RAI Reviewer) is required by `squad.agent.md` governance but missing from this team's roster. The `.squad/agents/Rai/` directory exists. This is migration drift from the team predating Rai's introduction. Should be addressed in a separate PR with Brady's review. |
| 56 | + |
| 57 | +## Current State |
| 58 | + |
| 59 | +- **Version:** v0.10.0 shipped (npm). Local working branch: `squad/1244-memory-mcp-bridge` with PR #1245's `memory_*` MCP bridge. |
| 60 | +- **Tests:** 4,655+ passing (last verified March 2026 release). |
| 61 | +- **Open upstream work:** 7 issues filed, 3 merged or in flight as PRs. |
| 62 | +- **Workaround skill published:** [`tamirdresher/squad-skills`](https://github.com/tamirdresher/squad-skills) → `plugins/governed-memory-cli-bridge/SKILL.md` (commit `a9a13c9`) — now carries an honest-limitations section explaining when the skill alone won't help. |
| 63 | + |
| 64 | +## Next Steps |
122 | 65 |
|
123 | | -All work through PRs. Branch naming: `squad/{issue-number}-{slug}`. Releases driven by **Surgeon** (not Coordinator or user). **Pre-publish gates mandatory.** Never commit to main directly. All decisions in `.squad/decisions.md`; inbox files auto-merged by Scribe. |
| 66 | +### Immediate |
| 67 | +- Drive PR #1245 to merge (memory_* MCP bridge) |
| 68 | +- Push #1247 with empirical evidence; coordinate the bootstrap fix with Brady |
| 69 | +- File the two new state-tool gaps discovered today |
| 70 | +- Expand Fact Checker's history with the verification patterns we used in the 2026-06-09 session |
| 71 | +- Build subsystem-expertise documents (per engineer) covering: state-mcp wiring, classifier internals, spawn-template invariants, casting algorithm, Ralph dynamics |
124 | 72 |
|
125 | | -## Team Identity |
| 73 | +### Short-term |
| 74 | +- Audit `.squad/` mutable-state writes across coordinator + sub-agent paths to find more silent-fallback modes |
| 75 | +- Verify orphan and two-layer state backends behave correctly under the new memory pipeline |
| 76 | +- Help Brady's release work where requested |
126 | 77 |
|
127 | | -**Apollo 13 / NASA Mission Control:** Flight (Lead), EECOM, FIDO, PAO, CAPCOM, CONTROL, SURGEON, Booster, GNC, Network, RETRO, INCO, GUIDO, Telemetry, VOX, DSKY, Sims, Handbook. Scribe (Session Logger), Ralph (Autonomy Agent). @copilot (Coordinator). |
| 78 | +## Operating Principles |
128 | 79 |
|
129 | | -**Status:** Team stable, process hardened, community engaged, next cycle ready. |
| 80 | +- Every factual claim → cite a source or mark unverifiable |
| 81 | +- Every architectural assertion → reproducible empirical test before filing |
| 82 | +- Never forge audit entries. Never paper over missing evidence with confident prose. |
| 83 | +- Coordinator never writes domain artifacts; specialists own their code; Fact Checker owns claim validation. |
0 commit comments