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

package/dist/cli/commands/memory.js

@@ -0,0 +1,304 @@
+import { FSStorageProvider, LocalMemoryStore, } from '@bradygaster/squad-sdk';
+import fs from 'node:fs';
+import path from 'node:path';
+const REAL_COPILOT_UNAVAILABLE_REASON = 'Real Copilot Memory API unavailable: no concrete callable API was found in installed @github/copilot SDK/tooling. Squad will not fake provider=copilot; use hostInjectedCopilotAdapter only when a host supplies a client.';
+const MEMORY_DIAGNOSTIC_LEVELS = {
+    none: 0,
+    error: 1,
+    info: 2,
+    debug: 3,
+};
+function readFlag(args, name) {
+    const equalsPrefix = `${name}=`;
+    const equalsValue = args.find(arg => arg.startsWith(equalsPrefix));
+    if (equalsValue)
+        return equalsValue.slice(equalsPrefix.length);
+    const index = args.indexOf(name);
+    return index >= 0 ? args[index + 1] : undefined;
+}
+function readContent(args) {
+    const content = readFlag(args, '--content');
+    if (content)
+        return content;
+    return args.filter(arg => !arg.startsWith('--')).slice(1).join(' ');
+}
+function parseClass(value) {
+    if (!value)
+        return undefined;
+    const normalized = value.toUpperCase();
+    if (['TRANSIENT', 'LOCAL', 'DECISION', 'POLICY', 'COPILOT_MEMORY', 'FORBIDDEN'].includes(normalized)) {
+        return normalized;
+    }
+    throw new Error(`Unknown memory class: ${value}`);
+}
+function parseLoadGuidance(value) {
+    if (!value)
+        return undefined;
+    const normalized = value.trim().replace(/^\[|\]$/g, '').toUpperCase();
+    if (['ALWAYS', 'ON-DEMAND', 'ARCHIVE', 'NEVER'].includes(normalized)) {
+        return normalized;
+    }
+    throw new Error(`Unknown load guidance: ${value}`);
+}
+function parseBoolean(value, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    if (['true', '1', 'yes', 'on'].includes(value.toLowerCase()))
+        return true;
+    if (['false', '0', 'no', 'off'].includes(value.toLowerCase()))
+        return false;
+    throw new Error(`Expected boolean value, got: ${value}`);
+}
+function parseLogLevel(value) {
+    if (!value)
+        return 'none';
+    const normalized = value.toLowerCase();
+    if (normalized === 'none' || normalized === 'silent' || normalized === 'off')
+        return 'none';
+    if (normalized === 'error')
+        return 'error';
+    if (normalized === 'info')
+        return 'info';
+    if (normalized === 'debug' || normalized === 'verbose' || normalized === 'all')
+        return 'debug';
+    throw new Error(`Unknown memory log level: ${value}. Expected none|error|info|debug.`);
+}
+function readConfiguredLogLevel(projectRoot) {
+    const configPath = path.join(projectRoot, '.squad', 'config.json');
+    if (!fs.existsSync(configPath))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    const logLevel = parsed.memory?.logLevel;
+    return typeof logLevel === 'string' ? parseLogLevel(logLevel) : undefined;
+}
+function parseDiagnostics(projectRoot, args) {
+    const filtered = [];
+    let logLevel;
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (arg === '--verbose' || arg === '-v') {
+            logLevel ??= 'debug';
+            continue;
+        }
+        if (arg === '--log-level') {
+            logLevel = parseLogLevel(args[index + 1]);
+            index++;
+            continue;
+        }
+        if (arg.startsWith('--log-level=')) {
+            logLevel = parseLogLevel(arg.slice('--log-level='.length));
+            continue;
+        }
+        filtered.push(arg);
+    }
+    return {
+        args: filtered,
+        logLevel: logLevel ?? (process.env['SQUAD_MEMORY_LOG_LEVEL'] !== undefined
+            ? parseLogLevel(process.env['SQUAD_MEMORY_LOG_LEVEL'])
+            : readConfiguredLogLevel(projectRoot) ?? 'none'),
+    };
+}
+function createMemoryDiagnostics(logLevel) {
+    const emit = (level, event, data = {}) => {
+        if (MEMORY_DIAGNOSTIC_LEVELS[logLevel] < MEMORY_DIAGNOSTIC_LEVELS[level])
+            return;
+        const details = Object.entries(data)
+            .filter(([, value]) => value !== undefined)
+            .map(([key, value]) => `${key}=${value}`)
+            .join(' ');
+        console.error(`[memory:${level}] ${event}${details ? ` ${details}` : ''}`);
+    };
+    return {
+        error: (event, data) => emit('error', event, data),
+        info: (event, data) => emit('info', event, data),
+        debug: (event, data) => emit('debug', event, data),
+    };
+}
+export async function runMemoryCommand(projectRoot, args) {
+    const diagnosticsConfig = parseDiagnostics(projectRoot, args);
+    const commandArgs = diagnosticsConfig.args;
+    const diagnostics = createMemoryDiagnostics(diagnosticsConfig.logLevel);
+    const operation = commandArgs[0] ?? 'help';
+    const startedAt = Date.now();
+    const store = new LocalMemoryStore(new FSStorageProvider(), projectRoot);
+    const providerStore = store;
+    diagnostics.info('command.start', { command: operation, projectRoot });
+    try {
+        if (operation === 'classify') {
+            const content = readContent(commandArgs);
+            const loadGuidance = parseLoadGuidance(readFlag(commandArgs, '--load-guidance'));
+            const requestedClass = parseClass(readFlag(commandArgs, '--class'));
+            diagnostics.debug('classify.request', { contentLength: content.length, requestedClass, loadGuidance });
+            const classification = await store.classify({
+                content,
+                requestedClass,
+                metadata: loadGuidance ? { loadGuidance } : undefined,
+            });
+            diagnostics.info('classify.complete', {
+                class: classification.class,
+                allowed: classification.allowed,
+                destination: classification.destination,
+                loadGuidance: classification.loadGuidance,
+                elapsedMs: Date.now() - startedAt,
+            });
+            console.log(JSON.stringify(classification, null, 2));
+            return;
+        }
+        if (operation === 'write') {
+            const content = readContent(commandArgs);
+            const loadGuidance = parseLoadGuidance(readFlag(commandArgs, '--load-guidance'));
+            const requestedClass = parseClass(readFlag(commandArgs, '--class'));
+            diagnostics.debug('write.request', {
+                contentLength: content.length,
+                requestedClass,
+                loadGuidance,
+                titleProvided: readFlag(commandArgs, '--title') !== undefined,
+                authorProvided: readFlag(commandArgs, '--author') !== undefined,
+                approved: commandArgs.includes('--approved'),
+            });
+            const result = await store.write({
+                content,
+                title: readFlag(commandArgs, '--title'),
+                author: readFlag(commandArgs, '--author'),
+                requestedClass,
+                approved: commandArgs.includes('--approved'),
+                metadata: loadGuidance ? { loadGuidance } : undefined,
+            });
+            diagnostics.info('write.complete', {
+                stored: result.stored,
+                class: result.classification.class,
+                provider: result.classification.class === 'COPILOT_MEMORY' ? 'hostInjectedCopilotAdapter' : 'local',
+                loadGuidance: result.classification.loadGuidance,
+                path: result.path,
+                elapsedMs: Date.now() - startedAt,
+            });
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        if (operation === 'search') {
+            const query = readFlag(commandArgs, '--query') ?? commandArgs.slice(1).join(' ');
+            diagnostics.debug('search.request', { queryLength: query.length });
+            const results = await store.search(query);
+            diagnostics.info('search.complete', {
+                count: results.length,
+                providers: [...new Set(results.map(result => result.provider ?? 'local'))].join(',') || 'none',
+                elapsedMs: Date.now() - startedAt,
+            });
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        if (operation === 'promote') {
+            const id = commandArgs[1];
+            const targetClass = parseClass(readFlag(commandArgs, '--class'));
+            if (!id || !targetClass || targetClass === 'FORBIDDEN' || targetClass === 'TRANSIENT') {
+                throw new Error('Usage: squad memory promote <id> --class LOCAL|DECISION|POLICY|COPILOT_MEMORY');
+            }
+            diagnostics.debug('promote.request', { id, targetClass, actorProvided: readFlag(commandArgs, '--actor') !== undefined });
+            const result = await store.promote(id, targetClass, readFlag(commandArgs, '--actor'));
+            diagnostics.info('promote.complete', {
+                id,
+                stored: result.stored,
+                class: result.classification.class,
+                path: result.path,
+                elapsedMs: Date.now() - startedAt,
+            });
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        if (operation === 'delete') {
+            const id = commandArgs[1];
+            if (!id)
+                throw new Error('Usage: squad memory delete <id>');
+            diagnostics.debug('delete.request', { id, actorProvided: readFlag(commandArgs, '--actor') !== undefined });
+            const deleted = await store.delete(id, readFlag(commandArgs, '--actor'));
+            diagnostics.info('delete.complete', { id, deleted, elapsedMs: Date.now() - startedAt });
+            console.log(JSON.stringify({ deleted }, null, 2));
+            return;
+        }
+        if (operation === 'audit') {
+            const audit = await store.auditLog();
+            diagnostics.info('audit.complete', { count: audit.length, elapsedMs: Date.now() - startedAt });
+            console.log(JSON.stringify(audit, null, 2));
+            return;
+        }
+        if (operation === 'provider' || operation === 'providers' || operation === 'status') {
+            if (readFlag(commandArgs, '--provider') === 'copilot' || commandArgs.includes('--default-copilot')) {
+                throw new Error(REAL_COPILOT_UNAVAILABLE_REASON);
+            }
+            if (commandArgs.includes('--enable-host-injected-copilot-adapter') || commandArgs.includes('--enable-copilot')) {
+                const requireApproval = parseBoolean(readFlag(commandArgs, '--require-approval'), true);
+                diagnostics.debug('provider.configure.request', {
+                    enabled: true,
+                    requireApproval,
+                    defaultProvider: commandArgs.includes('--default-host-injected-copilot-adapter') ? 'hostInjectedCopilotAdapter' : undefined,
+                });
+                const config = await providerStore.configureHostInjectedCopilotAdapter({
+                    enabled: true,
+                    requireApproval,
+                    defaultProvider: commandArgs.includes('--default-host-injected-copilot-adapter')
+                        ? 'hostInjectedCopilotAdapter'
+                        : undefined,
+                    actor: readFlag(commandArgs, '--actor'),
+                });
+                diagnostics.info('provider.configure.complete', {
+                    defaultProvider: config.defaultProvider,
+                    hostInjectedCopilotAdapterEnabled: config.externalProviders.hostInjectedCopilotAdapter.enabled,
+                    requireApproval: config.externalProviders.hostInjectedCopilotAdapter.requireApproval,
+                    elapsedMs: Date.now() - startedAt,
+                });
+                console.log(JSON.stringify(config, null, 2));
+                return;
+            }
+            if (commandArgs.includes('--disable-host-injected-copilot-adapter') || commandArgs.includes('--disable-copilot')) {
+                diagnostics.debug('provider.configure.request', { enabled: false, defaultProvider: 'local' });
+                const config = await providerStore.configureHostInjectedCopilotAdapter({
+                    enabled: false,
+                    defaultProvider: 'local',
+                    actor: readFlag(commandArgs, '--actor'),
+                });
+                diagnostics.info('provider.configure.complete', {
+                    defaultProvider: config.defaultProvider,
+                    hostInjectedCopilotAdapterEnabled: config.externalProviders.hostInjectedCopilotAdapter.enabled,
+                    elapsedMs: Date.now() - startedAt,
+                });
+                console.log(JSON.stringify(config, null, 2));
+                return;
+            }
+            const status = await providerStore.providerStatus();
+            diagnostics.info('provider.status.complete', {
+                defaultProvider: status.defaultProvider,
+                realCopilotConfigured: status.realCopilotMemory.configured,
+                hostInjectedCopilotAdapterConfigured: status.hostInjectedCopilotAdapter.configured,
+                hostInjectedCopilotAdapterClientAvailable: status.hostInjectedCopilotAdapter.clientAvailable,
+                elapsedMs: Date.now() - startedAt,
+            });
+            console.log(JSON.stringify(status, null, 2));
+            return;
+        }
+        diagnostics.info('help.complete', { elapsedMs: Date.now() - startedAt });
+        console.log([
+            'Usage: squad memory <classify|write|search|promote|delete|audit|provider>',
+            '  write --content "..." --class LOCAL --title "..." --author scribe [--load-guidance ALWAYS|ON-DEMAND|ARCHIVE|NEVER]',
+            '  search --query "testing strategy"',
+            '  provider [--enable-host-injected-copilot-adapter|--disable-host-injected-copilot-adapter] [--require-approval true|false]',
+            '  provider --provider copilot fails unless a real Copilot Memory API module is present.',
+            '  diagnostics: --log-level none|error|info|debug, --verbose, SQUAD_MEMORY_LOG_LEVEL, or .squad/config.json memory.logLevel (stderr; never logs raw memory content or search text).',
+            'hostInjectedCopilotAdapter is not real provider=copilot persistence; enabling config alone never fakes remote memory.',
+        ].join('\n'));
+    }
+    catch (error) {
+        diagnostics.error('command.error', {
+            command: operation,
+            message: error instanceof Error ? error.message : String(error),
+            elapsedMs: Date.now() - startedAt,
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=memory.js.map

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

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

package/dist/cli/commands/migrate-backend.d.ts

@@ -1,16 +1,47 @@
 /**
- * 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).
  */
+/** Best-effort: ensure the squad-state orphan branch exists. Returns true on success. */
+export declare function ensureOrphanBranch(dest: string): boolean;
 /**
  * Migrate the state backend for an existing squad project.
- * Only local → orphan/two-layer is supported.
+ *
+ * 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 declare function migrateStateBackend(dest: string, target: string): Promise<void>;
+/**
+ * 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 declare function liftInitMutableStateOntoOrphan(dest: string): string[];
 //# sourceMappingURL=migrate-backend.d.ts.map

package/dist/cli/commands/migrate-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate-backend.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/migrate-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqErF"}
+{"version":3,"file":"migrate-backend.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/migrate-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAsBH,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA4BxD;AA8FD;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgHrF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBrE"}