bug: squad config version not auto-updated during upgrade

[diberry]

Problem

Squad has two different "version" concepts, but only one is auto-maintained:

Version	Location	Auto-updated?	Risk
CLI version	squad.agent.md HTML comment	Yes (init + upgrade)	None
Config version	squad.config.ts version field	No	Stale after upgrades
Schema version	.squad/config.json version: 1	No (hardcoded)	Never incremented

What works

• squad.agent.md version is auto-stamped by stampVersion() during both init and upgrade
• upgrade.ts compares the stamped version to detect if already current

What does not work

• squad.config.ts version is set to 1.0.0 at init and never touched again
• .squad/config.json version is hardcoded to 1 and never incremented
• If SDK introduces breaking config schema changes, users have no migration path
• squad upgrade does not bump config versions

Customer impact

• Users assume squad upgrade handles everything (it does not touch config version)
• No warning when config schema is stale vs. installed CLI version
• Breaking changes to config format silently fail at runtime

Proposed fix

• Auto-stamp config version during upgrade (similar to squad.agent.md stamping)
• Track schema version separately from CLI version
• Add migration hooks: when schema version changes, run config migration
• squad doctor should validate config version matches installed CLI expectations

Related

• PRD: Versioned file layout manifest - single source of truth for directory structure bradygaster/squad#670 / arch: file layout manifest — single source of truth for directory structure across versions #79 -- file layout manifest (broader version tracking architecture)
• packages/squad-cli/src/cli/core/version.ts -- stampVersion()
• packages/squad-cli/src/cli/core/upgrade.ts -- lines 453-513
• packages/squad-cli/src/cli/core/init.ts -- line 258

[github-actions]

🏗️ Squad Triage — Flight (Lead)

Issue: #84 — bug: squad config version not auto-updated during upgrade
Assigned to: FIDO (Quality Owner)
Reason: Issue relates to testing/quality work

@copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

Team roster:

• Flight (Lead) → label: squad:flight
• Procedures (Prompt Engineer) → label: squad:procedures
• EECOM (Core Dev) → label: squad:eecom
• FIDO (Quality Owner) → label: squad:fido
• PAO (DevRel) → label: squad:pao
• CAPCOM (SDK Expert) → label: squad:capcom
• CONTROL (TypeScript Engineer) → label: squad:control
• Surgeon (Release Manager) → label: squad:surgeon
• Booster (CI/CD Engineer) → label: squad:booster
• GNC (Node.js Runtime) → label: squad:gnc
• Network (Distribution) → label: squad:network
• RETRO (Security) → label: squad:retro
• INCO (CLI UX & Visual Design) → label: squad:inco
• GUIDO (VS Code Extension) → label: squad:guido
• Telemetry (Aspire & Observability) → label: squad:telemetry
• VOX (REPL & Interactive Shell) → label: squad:vox
• DSKY (TUI Engineer) → label: squad:dsky
• Sims (E2E Test Engineer) → label: squad:sims
• Handbook (SDK Usability) → label: squad:handbook
• Ralph (Work Monitor) → label: squad:ralph
• @copilot (Coding Agent) → label: squad:copilot

To reassign, remove the current squad:* label and add the correct one.

[diberry]

📡 Ralph Status Update — Issue #84

Status: ✅ Upstream PR opened

Step	Status
Fork PR	diberry/squad#127 ✅
Team Reviews	All 19 squad members posted reviews ✅
Upstream PR	bradygaster/squad#725 ✅
Upstream Merge	⏳ Waiting for upstream maintainer

The fix auto-stamps squad.config.ts/js version during squad upgrade. 9 tests cover both upgrade paths, missing config, and quote-style preservation.

Will close this issue when upstream PR bradygaster#725 is merged.

[diberry]

🛰️ Ralph — P0 Status Update

Issue: #84 — squad config version not auto-updated during upgrade
Status: 🟢 Fix in review
PR: #127 — fix(cli): auto-update config version during upgrade

Progress

• PR fix(cli): auto-update config version during upgrade #127 posted and reviewed by squad team
• 3 files changed: version.ts, upgrade.ts, upgrade.test.ts
• 9 new tests covering all upgrade paths and edge cases
• Adds discoverSquadConfig(), stampConfigVersion(), readConfigVersion()
• Both full upgrade and already-current refresh paths now stamp config version

Pipeline Status

• ✅ squad:pr-needs-review — complete
• ✅ squad:pr-reviewed — team review posted
• ⏳ Waiting for Dina's review (human gate)
• Needs rebase against dev before merge

Ralph — Work Monitor