@bradygaster/squad-cli 0.9.6-insider.3 → 0.10.0

package/dist/cli/commands/migrate-backend.js

@@ -1,12 +1,18 @@
 /**
- * Backend migration — upgrades state backend from local to orphan or two-layer.
+ * Backend migration — upgrades state backend across allowed transitions.
  *
- * Currently supports:
+ * Supported migrations:
  * - local → orphan
  * - local → two-layer
+ * - worktree → orphan
+ * - worktree → two-layer
+ * - orphan ↔ two-layer (both write to the squad-state orphan branch via different layers)
  *
- * Migration from orphan/two-layer back to local is not supported (would require
- * materializing all state from the orphan branch back to the working tree).
+ * In addition to flipping the `stateBackend` key in `.squad/config.json`, this
+ * function MIGRATES pre-existing working-tree state (`decisions.md`,
+ * `agents/<name>/history.md`) onto the squad-state orphan branch when moving
+ * from a working-tree backend to an orphan-storage backend, so post-upgrade
+ * agents can read pre-upgrade content (UPGRADE-NO-MIGRATION fix).
  */
 import { execFileSync } from 'node:child_process';
 import path from 'node:path';
@@ -15,43 +21,22 @@ import { installGitHooks } from './install-hooks.js';
 const GREEN = '\x1b[32m';
 const YELLOW = '\x1b[33m';
 const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
 const RESET = '\x1b[0m';
-const VALID_TARGETS = ['orphan', 'two-layer'];
-/**
- * Migrate the state backend for an existing squad project.
- * Only local → orphan/two-layer is supported.
- */
-export async function migrateStateBackend(dest, target) {
-    if (!VALID_TARGETS.includes(target)) {
-        console.log(`${YELLOW}⚠ Invalid backend target '${target}'. Supported: ${VALID_TARGETS.join(', ')}${RESET}`);
-        return;
-    }
-    const configPath = path.join(dest, '.squad', 'config.json');
-    let config = {};
-    try {
-        if (fs.existsSync(configPath)) {
-            config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-        }
-    }
-    catch { /* start fresh */ }
-    const current = config['stateBackend'] || 'local';
-    // Validate migration direction
-    if (current === target) {
-        console.log(`${YELLOW}⚠ Backend is already '${target}'. Nothing to do.${RESET}`);
-        return;
-    }
-    if (current !== 'local' && current !== null) {
-        console.log(`${YELLOW}⚠ Migration from '${current}' to '${target}' is not supported.${RESET}`);
-        console.log(`  Only local → orphan or local → two-layer is supported at this time.`);
-        return;
-    }
-    console.log(`\n${BOLD}Migrating state backend: ${current} → ${target}${RESET}\n`);
-    // Step 1: Create orphan branch if needed
+const VALID_TARGETS = ['local', 'worktree', 'orphan', 'two-layer'];
+const ORPHAN_BACKENDS = new Set(['orphan', 'two-layer']);
+const WORKTREE_BACKENDS = new Set(['local', 'worktree']);
+/** Paths inside .squad/ that should be carried over to the orphan branch on migration. */
+const MIGRATABLE_PATHS = [
+    'decisions.md',
+];
+/** Best-effort: ensure the squad-state orphan branch exists. Returns true on success. */
+export function ensureOrphanBranch(dest) {
     try {
         execFileSync('git', ['rev-parse', '--verify', 'refs/heads/squad-state'], {
             cwd: dest, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
         });
-        console.log(`  ${GREEN}✓${RESET} squad-state branch already exists`);
+        return true;
     }
     catch {
         try {
@@ -69,19 +54,244 @@ export async function migrateStateBackend(dest, target) {
             execFileSync('git', ['update-ref', 'refs/heads/squad-state', commitHash], {
                 cwd: dest, stdio: ['pipe', 'pipe', 'pipe'],
             });
-            console.log(`  ${GREEN}✓${RESET} squad-state orphan branch created`);
+            return true;
         }
         catch (err) {
             console.log(`${YELLOW}⚠ Could not create squad-state branch: ${err instanceof Error ? err.message : err}${RESET}`);
+            return false;
+        }
+    }
+}
+/**
+ * Collect existing working-tree state files that should be migrated to the orphan branch.
+ * Returns array of {path, content} pairs (paths are relative to .squad/).
+ */
+function collectWorktreeState(dest) {
+    const squadDir = path.join(dest, '.squad');
+    const collected = [];
+    for (const p of MIGRATABLE_PATHS) {
+        const full = path.join(squadDir, p);
+        if (fs.existsSync(full) && fs.statSync(full).isFile()) {
+            collected.push({ relPath: p, content: fs.readFileSync(full, 'utf-8') });
+        }
+    }
+    // agents/<name>/history.md
+    const agentsDir = path.join(squadDir, 'agents');
+    if (fs.existsSync(agentsDir) && fs.statSync(agentsDir).isDirectory()) {
+        for (const agentName of fs.readdirSync(agentsDir)) {
+            const histPath = path.join(agentsDir, agentName, 'history.md');
+            if (fs.existsSync(histPath) && fs.statSync(histPath).isFile()) {
+                collected.push({
+                    relPath: path.posix.join('agents', agentName, 'history.md'),
+                    content: fs.readFileSync(histPath, 'utf-8'),
+                });
+            }
+        }
+    }
+    return collected;
+}
+/**
+ * Write a set of files onto the squad-state orphan branch via git plumbing.
+ * Preserves any files already on the branch (merges trees by path).
+ * Returns the number of files written, or -1 on failure.
+ */
+function writeFilesToOrphanBranch(dest, files) {
+    if (files.length === 0)
+        return 0;
+    try {
+        // Load the current squad-state tree into the index using a temporary index file
+        const gitDir = execFileSync('git', ['rev-parse', '--git-dir'], {
+            cwd: dest, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const indexFile = path.resolve(dest, gitDir, 'squad-migrate-index');
+        if (fs.existsSync(indexFile))
+            fs.unlinkSync(indexFile);
+        const env = { ...process.env, GIT_INDEX_FILE: indexFile };
+        // Seed index with existing squad-state tree
+        execFileSync('git', ['read-tree', 'refs/heads/squad-state'], {
+            cwd: dest, env, stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Add each migrated file
+        for (const f of files) {
+            const blobHash = execFileSync('git', ['hash-object', '-w', '--stdin'], {
+                cwd: dest, env, encoding: 'utf-8', input: f.content, stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            execFileSync('git', ['update-index', '--add', '--cacheinfo', `100644,${blobHash},${f.relPath}`], {
+                cwd: dest, env, stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        const treeHash = execFileSync('git', ['write-tree'], {
+            cwd: dest, env, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const parentSha = execFileSync('git', ['rev-parse', 'refs/heads/squad-state'], {
+            cwd: dest, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const commitHash = execFileSync('git', ['commit-tree', treeHash, '-p', parentSha, '-m', `migrate: import working-tree state on backend upgrade (${files.length} file(s))`], { cwd: dest, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        execFileSync('git', ['update-ref', 'refs/heads/squad-state', commitHash, parentSha], {
+            cwd: dest, stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Cleanup the temporary index
+        if (fs.existsSync(indexFile))
+            fs.unlinkSync(indexFile);
+        return files.length;
+    }
+    catch (err) {
+        console.log(`${YELLOW}⚠ Could not migrate state onto squad-state branch: ${err instanceof Error ? err.message : err}${RESET}`);
+        return -1;
+    }
+}
+/**
+ * Migrate the state backend for an existing squad project.
+ *
+ * Fixes:
+ *   - UPGRADE-FLAG-IGNORED: writes the new `stateBackend` value into config.json
+ *     via JSON-aware merge (never textual append → avoids Bug E duplicates).
+ *   - UPGRADE-NO-MIGRATION: when moving from a working-tree backend to an
+ *     orphan-storage backend, carries existing decisions.md and agent histories
+ *     onto the squad-state orphan branch so post-upgrade agents see prior state.
+ *   - WI-1: re-installs the full hook set (including new pre-commit/post-commit).
+ */
+export async function migrateStateBackend(dest, target) {
+    if (!VALID_TARGETS.includes(target)) {
+        console.log(`${YELLOW}⚠ Invalid backend target '${target}'. Supported: ${VALID_TARGETS.join(', ')}${RESET}`);
+        return;
+    }
+    const configPath = path.join(dest, '.squad', 'config.json');
+    let config = {};
+    try {
+        if (fs.existsSync(configPath)) {
+            config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        }
+    }
+    catch { /* start fresh */ }
+    const current = config['stateBackend'] || 'local';
+    if (current === target) {
+        console.log(`${YELLOW}⚠ Backend is already '${target}'. Ensuring hooks + config are consistent.${RESET}`);
+        if (ORPHAN_BACKENDS.has(target)) {
+            ensureOrphanBranch(dest);
+            installGitHooks(dest, { force: false });
+        }
+        return;
+    }
+    console.log(`\n${BOLD}Migrating state backend: ${current} → ${target}${RESET}\n`);
+    // Step 1: Ensure orphan branch exists when the target needs it
+    if (ORPHAN_BACKENDS.has(target)) {
+        if (!ensureOrphanBranch(dest))
             return;
+        console.log(`  ${GREEN}✓${RESET} squad-state branch ready`);
+    }
+    // Step 2 (UPGRADE-NO-MIGRATION): move working-tree state onto the orphan branch
+    // when transitioning from a worktree backend to an orphan-storage backend.
+    if (WORKTREE_BACKENDS.has(current) && ORPHAN_BACKENDS.has(target)) {
+        const files = collectWorktreeState(dest);
+        if (files.length > 0) {
+            const wrote = writeFilesToOrphanBranch(dest, files);
+            if (wrote > 0) {
+                console.log(`  ${GREEN}✓${RESET} migrated ${wrote} state file(s) onto squad-state branch:`);
+                for (const f of files) {
+                    console.log(`      ${DIM}.squad/${f.relPath}${RESET}`);
+                }
+                // F1 fix (Round 5, P1.1): the working-tree copies are now stale — the
+                // orphan branch is the source of truth for an orphan/two-layer backend.
+                // Remove them so `git status` is clean and post-upgrade agents can't
+                // accidentally read stale content. Mirrors liftInitMutableStateOntoOrphan
+                // behavior. Only files we just successfully migrated are removed; we
+                // never touch config.json, charter.md, team.md, casting/, templates/, etc.
+                const squadDir = path.join(dest, '.squad');
+                const removed = [];
+                const removeFailed = [];
+                for (const f of files) {
+                    const full = path.join(squadDir, f.relPath);
+                    try {
+                        if (fs.existsSync(full))
+                            fs.unlinkSync(full);
+                        removed.push(f.relPath);
+                    }
+                    catch {
+                        removeFailed.push(f.relPath);
+                    }
+                }
+                // Clean up now-empty agent directories (e.g. .squad/agents/data/) so
+                // they don't leak as zero-content folders post-upgrade.
+                const agentsDir = path.join(squadDir, 'agents');
+                if (fs.existsSync(agentsDir) && fs.statSync(agentsDir).isDirectory()) {
+                    for (const agentName of fs.readdirSync(agentsDir)) {
+                        const agentDir = path.join(agentsDir, agentName);
+                        try {
+                            if (fs.statSync(agentDir).isDirectory() &&
+                                fs.readdirSync(agentDir).length === 0) {
+                                fs.rmdirSync(agentDir);
+                            }
+                        }
+                        catch { /* best-effort */ }
+                    }
+                }
+                if (removed.length > 0) {
+                    console.log(`  ${GREEN}✓${RESET} removed ${removed.length} stale working-tree file(s) (now sourced from squad-state):`);
+                    for (const r of removed) {
+                        console.log(`      ${DIM}.squad/${r}${RESET}`);
+                    }
+                }
+                if (removeFailed.length > 0) {
+                    console.log(`  ${YELLOW}⚠${RESET} could not remove: ${removeFailed.join(', ')} (will appear in git status)`);
+                }
+            }
+            else if (wrote === 0) {
+                console.log(`  ${DIM}no working-tree state files to migrate${RESET}`);
+            }
+            // If wrote === -1 we already printed a warning; continue so config still updates.
+        }
+        else {
+            console.log(`  ${DIM}no migratable state in working tree${RESET}`);
         }
     }
-    // Step 2: Update config
+    // Step 3 (UPGRADE-FLAG-IGNORED + Bug E): JSON-merge the new value.
+    // Reading + re-stringifying guarantees one canonical `stateBackend` key.
     config['stateBackend'] = target;
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
     fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
     console.log(`  ${GREEN}✓${RESET} config.json updated: stateBackend = ${target}`);
-    // Step 3: Install git hooks
-    installGitHooks(dest, { force: true });
+    // Step 4 (WI-1): re-install hooks (force so new pre-commit/post-commit land)
+    if (ORPHAN_BACKENDS.has(target)) {
+        installGitHooks(dest, { force: true });
+    }
     console.log(`\n${GREEN}${BOLD}✓ Migration complete.${RESET} Backend is now '${target}'.\n`);
 }
+/**
+ * INSIDER3-INIT-LEAK fix: when `squad init --state-backend orphan|two-layer`
+ * runs, the SDK still hand-writes mutable state files (decisions.md and each
+ * agent's history.md) into the working tree because it has no knowledge of the
+ * future backend choice. This helper, invoked by the CLI immediately after the
+ * orphan branch is created, lifts those mutable files onto the squad-state
+ * orphan branch and removes them from the working tree so post-init agents
+ * read state exclusively through the runtime bridge.
+ *
+ * Source-of-truth hierarchy preserved: static files (team.md, charters,
+ * ceremonies.md, casting/*, templates/*) are NEVER touched — only mutable
+ * state (decisions.md, agents/<n>/history.md) migrates.
+ *
+ * Returns the relative paths of files that were migrated + removed.
+ */
+export function liftInitMutableStateOntoOrphan(dest) {
+    const files = collectWorktreeState(dest);
+    if (files.length === 0)
+        return [];
+    const wrote = writeFilesToOrphanBranch(dest, files);
+    if (wrote <= 0)
+        return [];
+    const removed = [];
+    const squadDir = path.join(dest, '.squad');
+    for (const f of files) {
+        const full = path.join(squadDir, f.relPath);
+        try {
+            if (fs.existsSync(full))
+                fs.unlinkSync(full);
+            removed.push(f.relPath);
+        }
+        catch {
+            // Leave file behind rather than aborting; the runtime bridge already has authoritative copy.
+        }
+    }
+    return removed;
+}
 //# sourceMappingURL=migrate-backend.js.map

package/dist/cli/commands/migrate-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrate-backend.js","sourceRoot":"","sources":["../../../src/cli/commands/migrate-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"migrate-backend.js","sourceRoot":"","sources":["../../../src/cli/commands/migrate-backend.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/notes.d.ts

@@ -0,0 +1,27 @@
+/**
+ * squad notes — manage squad git-notes state (Round 5, P0.3 A3).
+ *
+ * Subcommand:
+ *   promote [--ref <ref>] [--all] [--dry-run]
+ *
+ * Production caller for {@link TwoLayerBackend.promoteNotes}. Walks notes on
+ * each `refs/notes/squad/*` ref, moves notes flagged `promote_to_permanent`
+ * into the orphan layer under `promoted/<ref>/<sha>.json`, copies notes
+ * flagged `archive_on_close` under `archive/<ref>/<sha>.json`, and leaves
+ * un-flagged notes in place.
+ *
+ * Round 4 audit found `promoteNotes` had zero production callers — the SDK
+ * API was wired but never invoked. This command, plus the Ralph heartbeat
+ * `notes-promote` capability, are those production callers.
+ *
+ * @module cli/commands/notes
+ */
+/**
+ * Run `squad notes promote`. Returns process exit code.
+ */
+export declare function runNotesPromote(cwd: string, args: string[]): Promise<number>;
+/**
+ * Top-level `squad notes` dispatcher.
+ */
+export declare function runNotes(cwd: string, args: string[]): Promise<void>;
+//# sourceMappingURL=notes.d.ts.map

package/dist/cli/commands/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/notes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA+HH;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFlF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAezE"}

package/dist/cli/commands/notes.js

@@ -0,0 +1,222 @@
+/**
+ * squad notes — manage squad git-notes state (Round 5, P0.3 A3).
+ *
+ * Subcommand:
+ *   promote [--ref <ref>] [--all] [--dry-run]
+ *
+ * Production caller for {@link TwoLayerBackend.promoteNotes}. Walks notes on
+ * each `refs/notes/squad/*` ref, moves notes flagged `promote_to_permanent`
+ * into the orphan layer under `promoted/<ref>/<sha>.json`, copies notes
+ * flagged `archive_on_close` under `archive/<ref>/<sha>.json`, and leaves
+ * un-flagged notes in place.
+ *
+ * Round 4 audit found `promoteNotes` had zero production callers — the SDK
+ * API was wired but never invoked. This command, plus the Ralph heartbeat
+ * `notes-promote` capability, are those production callers.
+ *
+ * @module cli/commands/notes
+ */
+import { execFileSync } from 'node:child_process';
+import * as path from 'node:path';
+import { resolveStateBackend, TwoLayerBackend } from '@bradygaster/squad-sdk';
+import { resolveSquadPaths } from '@bradygaster/squad-sdk/resolution';
+import { BOLD, RESET, DIM, GREEN, YELLOW, RED } from '../core/output.js';
+import { fatal } from '../core/errors.js';
+function parsePromoteArgs(args) {
+    const out = { all: false, dryRun: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--ref') {
+            out.ref = args[++i];
+        }
+        else if (a === '--all') {
+            out.all = true;
+        }
+        else if (a === '--dry-run') {
+            out.dryRun = true;
+        }
+        else if (a === '--help' || a === '-h') {
+            printPromoteHelp();
+            process.exit(0);
+        }
+    }
+    return out;
+}
+function printPromoteHelp() {
+    console.log(`\n${BOLD}squad notes promote${RESET} — promote/archive flagged git-notes to permanent storage\n`);
+    console.log(`Usage: squad notes promote [options]\n`);
+    console.log(`Options:`);
+    console.log(`  --ref <ref>    Restrict to a single notes ref (e.g. squad/picard)`);
+    console.log(`  --all          Promote across all refs/notes/squad/* (default)`);
+    console.log(`  --dry-run      Report what would be promoted without writing`);
+    console.log(`  --help, -h     Show this help\n`);
+    console.log(`Requires stateBackend: 'two-layer' in .squad/config.json.`);
+    console.log(`Idempotent — promoted notes are removed from source, archived notes stay in place.\n`);
+}
+/**
+ * Enumerate squad notes refs (`refs/notes/squad/*`) present in the repo.
+ * Returns short names (e.g. `squad/picard`, not `refs/notes/squad/picard`).
+ */
+function listSquadNotesRefs(repoRoot) {
+    try {
+        const out = execFileSync('git', ['for-each-ref', '--format=%(refname)', 'refs/notes/squad/'], { cwd: repoRoot, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        return out
+            .split('\n')
+            .map((l) => l.trim())
+            .filter(Boolean)
+            .map((full) => full.replace(/^refs\/notes\//, ''))
+            .filter((r) => /^squad\/[A-Za-z0-9_\-./]+$/.test(r));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Best-effort dry-run preview: list notes on a ref with their flag classification.
+ * Reuses the same parsing logic as TwoLayerBackend.promoteNotes but without writing.
+ */
+function dryRunRef(repoRoot, ref) {
+    const result = { promoted: [], archived: [], skipped: 0 };
+    let listing;
+    try {
+        listing = execFileSync('git', ['notes', `--ref=${ref}`, 'list'], { cwd: repoRoot, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    }
+    catch {
+        return result;
+    }
+    let reachable;
+    try {
+        const raw = execFileSync('git', ['rev-list', 'HEAD'], {
+            cwd: repoRoot, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        reachable = new Set(raw.split('\n').map((s) => s.trim()).filter(Boolean));
+    }
+    catch {
+        return result;
+    }
+    for (const line of listing.split('\n')) {
+        const parts = line.trim().split(/\s+/);
+        if (parts.length < 2)
+            continue;
+        const commitSha = parts[1];
+        if (!/^[a-f0-9]{40}$|^[a-f0-9]{64}$/.test(commitSha))
+            continue;
+        if (!reachable.has(commitSha))
+            continue;
+        let raw;
+        try {
+            raw = execFileSync('git', ['notes', `--ref=${ref}`, 'show', commitSha], { cwd: repoRoot, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        }
+        catch {
+            continue;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(raw);
+        }
+        catch {
+            result.skipped++;
+            continue;
+        }
+        const flags = payload;
+        const refSeg = ref.split('/').filter(Boolean).join('/');
+        if (flags?.promote_to_permanent === true) {
+            result.promoted.push(`promoted/${refSeg}/${commitSha}.json`);
+        }
+        if (flags?.archive_on_close === true) {
+            result.archived.push(`archive/${refSeg}/${commitSha}.json`);
+        }
+        if (flags?.promote_to_permanent !== true && flags?.archive_on_close !== true) {
+            result.skipped++;
+        }
+    }
+    return result;
+}
+/**
+ * Run `squad notes promote`. Returns process exit code.
+ */
+export async function runNotesPromote(cwd, args) {
+    const opts = parsePromoteArgs(args);
+    const paths = resolveSquadPaths(cwd);
+    if (!paths) {
+        fatal('No squad found. Run "squad init" first.');
+    }
+    const squadDir = paths.projectDir;
+    const repoRoot = path.resolve(squadDir, '..');
+    const backend = resolveStateBackend(squadDir, repoRoot);
+    if (!(backend instanceof TwoLayerBackend)) {
+        console.log(`${YELLOW}⚠ stateBackend is '${backend.name}', not 'two-layer'. Nothing to promote.${RESET}`);
+        console.log(`${DIM}  Run 'squad upgrade --state-backend two-layer' to enable note promotion.${RESET}`);
+        return 0;
+    }
+    // Decide which refs to process.
+    let refs;
+    if (opts.ref) {
+        refs = [opts.ref];
+    }
+    else {
+        refs = listSquadNotesRefs(repoRoot);
+        if (refs.length === 0) {
+            console.log(`${DIM}No squad notes refs found (refs/notes/squad/*). Nothing to do.${RESET}`);
+            return 0;
+        }
+    }
+    const header = opts.dryRun ? `notes promote ${DIM}(dry-run)${RESET}` : 'notes promote';
+    console.log(`\n${BOLD}${header}${RESET}\n`);
+    const rows = [];
+    let anyError = false;
+    for (const ref of refs) {
+        try {
+            const res = opts.dryRun ? dryRunRef(repoRoot, ref) : backend.promoteNotes(ref);
+            rows.push({ ref, promoted: res.promoted.length, archived: res.archived.length, skipped: res.skipped });
+        }
+        catch (err) {
+            anyError = true;
+            const msg = err instanceof Error ? err.message : String(err);
+            rows.push({ ref, promoted: 0, archived: 0, skipped: 0, error: msg });
+        }
+    }
+    const nameW = Math.max(...rows.map((r) => r.ref.length), 'Ref'.length, 5);
+    console.log(`  ${'Ref'.padEnd(nameW)}  ${'Promoted'.padStart(8)}  ${'Archived'.padStart(8)}  ${'Skipped'.padStart(7)}`);
+    console.log(`  ${'─'.repeat(nameW)}  ${'─'.repeat(8)}  ${'─'.repeat(8)}  ${'─'.repeat(7)}`);
+    let totalP = 0, totalA = 0, totalS = 0;
+    for (const r of rows) {
+        if (r.error) {
+            console.log(`  ${r.ref.padEnd(nameW)}  ${RED}error${RESET}: ${r.error}`);
+            continue;
+        }
+        totalP += r.promoted;
+        totalA += r.archived;
+        totalS += r.skipped;
+        console.log(`  ${r.ref.padEnd(nameW)}  ${String(r.promoted).padStart(8)}  ${String(r.archived).padStart(8)}  ${String(r.skipped).padStart(7)}`);
+    }
+    console.log(`  ${'─'.repeat(nameW)}  ${'─'.repeat(8)}  ${'─'.repeat(8)}  ${'─'.repeat(7)}`);
+    console.log(`  ${'TOTAL'.padEnd(nameW)}  ${String(totalP).padStart(8)}  ${String(totalA).padStart(8)}  ${String(totalS).padStart(7)}\n`);
+    if (anyError) {
+        console.log(`${RED}✗${RESET} Completed with errors (see above).`);
+        return 1;
+    }
+    console.log(`${GREEN}✓${RESET} ${opts.dryRun ? 'Dry-run complete' : 'Promotion complete'}.\n`);
+    return 0;
+}
+/**
+ * Top-level `squad notes` dispatcher.
+ */
+export async function runNotes(cwd, args) {
+    const sub = args[0];
+    if (!sub || sub === '--help' || sub === '-h' || sub === 'help') {
+        console.log(`\n${BOLD}squad notes${RESET} — manage squad git-notes state\n`);
+        console.log(`Subcommands:`);
+        console.log(`  promote      Promote/archive flagged notes to permanent orphan storage`);
+        console.log(`\nRun 'squad notes <subcommand> --help' for details.\n`);
+        return;
+    }
+    if (sub === 'promote') {
+        const code = await runNotesPromote(cwd, args.slice(1));
+        if (code !== 0)
+            process.exit(code);
+        return;
+    }
+    fatal(`Unknown 'squad notes' subcommand: ${sub}`);
+}
+//# sourceMappingURL=notes.js.map

package/dist/cli/commands/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../../src/cli/commands/notes.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/plugin.js

@@ -9,7 +9,7 @@ import { promisify } from 'node:util';
 import { TIMEOUTS, FSStorageProvider, PLUGIN_MANIFEST_FILENAMES, appendAuditEvent, createPluginInstallPlan, describePluginFile, executeLifecycleHook, isLifecycleEventName, parsePluginManifestContent, readPluginStates, removeInstalledPlugin, setPluginEnabled, sha256, switchActivePlugin, upsertInstalledPlugin, validatePluginManifest, writePluginStates, } from '@bradygaster/squad-sdk';
 import { success, warn, info, DIM, BOLD, RESET } from '../core/output.js';
 import { fatal } from '../core/errors.js';
-import { detectSquadDir } from '../core/detect-squad-dir.js';
+import { effectiveSquadDir } from '../core/effective-squad-dir.js';
 import { ghAvailable, ghAuthenticated } from '../core/gh-cli.js';
 const execFileAsync = promisify(execFile);
 // --- Main command handler ---
@@ -19,9 +19,9 @@ export async function runPlugin(dest, args) {
     if (!subCmd) {
         fatal(pluginUsage());
     }
-    const squadDirInfo = detectSquadDir(dest);
+    const { local: squadDirInfo, stateDir } = effectiveSquadDir(dest);
     const storage = new FSStorageProvider();
-    const pluginsDir = join(squadDirInfo.path, 'plugins');
+    const pluginsDir = join(stateDir, 'plugins');
     const marketplacesFile = join(pluginsDir, 'marketplaces.json');
     async function readMarketplaces() {
         if (!storage.existsSync(marketplacesFile)) {