@pleri/olam-cli 0.1.145 → 0.1.147

package/dist/commands/skills-migrate-hooks-back.js

@@ -0,0 +1,83 @@
+/**
+ * `olam skills migrate-hooks-back` — reverse Phase B B1 meta-hook
+ * injection by restoring `~/.claude/settings.json` from a snapshot
+ * written by `writeMetaHooksSnapshot` (engine writes one before every
+ * injection that has a non-empty delta).
+ *
+ *   olam skills migrate-hooks-back [--snapshot <path>]
+ *
+ * Without `--snapshot`: consumes the most-recent
+ * `meta-hooks-*.json` in `~/.olam/state/migration-snapshots/`.
+ * With `--snapshot`: uses the named file explicitly.
+ *
+ * Output: prints settings.json path + snapshot path + summary
+ * (restored / file-removed when snapshot represents pre-existence
+ * absence) + exits 0 on success.
+ */
+import * as path from 'node:path';
+import { findLatestMetaHooksSnapshot, readMetaHooksSnapshot, restoreSettingsFromSnapshot, migrationSnapshotsDir, META_HOOKS_SNAPSHOT_PREFIX, } from '@olam/core/src/skill-sources/meta-hooks-migration-snapshot.js';
+import { claudeSettingsPath } from '@olam/core/src/skill-sources/index.js';
+import { printError, printInfo, printSuccess } from '../output.js';
+function asMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export function registerSkillsMigrateHooksBack(program) {
+    const skills = program.commands.find((c) => c.name() === 'skills') ??
+        program.command('skills').description('Manage skill sources and synchronization');
+    skills
+        .command('migrate-hooks-back')
+        .description('Reverse olam-meta hook injection by restoring ~/.claude/settings.json from a B5 snapshot')
+        .option('--snapshot <path>', 'Use a specific snapshot file (default: most recent meta-hooks-*.json)')
+        .action((opts) => {
+        try {
+            const snapshotPath = opts.snapshot ?? findLatestMetaHooksSnapshot();
+            if (!snapshotPath) {
+                printError('No meta-hooks-* snapshot found in ~/.olam/state/migration-snapshots/. ' +
+                    'Engine writes one before every injection that mutates settings.json; ' +
+                    'if none exist, no reversible injection has happened yet.');
+                process.exitCode = 1;
+                return;
+            }
+            // CP3 HIGH-2 fix: when --snapshot is operator-supplied, the path
+            // must (a) resolve inside ~/.olam/state/migration-snapshots/ and
+            // (b) have the canonical `meta-hooks-` prefix. Without this
+            // guard, an attacker (or accidental --snapshot /tmp/foo.json)
+            // could supply an arbitrary JSON file → restoreSettingsFromSnapshot
+            // would blindly write that JSON to ~/.claude/settings.json,
+            // installing operator-attacker-chosen hook blocks.
+            if (opts.snapshot) {
+                const resolved = path.resolve(opts.snapshot);
+                const allowedDir = path.resolve(migrationSnapshotsDir());
+                if (!resolved.startsWith(allowedDir + path.sep)) {
+                    printError(`--snapshot path must be inside ${allowedDir} (got "${resolved}"). ` +
+                        `Refusing to restore from an arbitrary path — settings.json would land operator-chosen content.`);
+                    process.exitCode = 1;
+                    return;
+                }
+                const basename = path.basename(resolved);
+                if (!basename.startsWith(META_HOOKS_SNAPSHOT_PREFIX)) {
+                    printError(`--snapshot filename must start with "${META_HOOKS_SNAPSHOT_PREFIX}" (got "${basename}"). ` +
+                        `Cross-namespace snapshots (atlas-toolbox-*) are not valid restore targets for olam-meta hooks.`);
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            printInfo('snapshot', snapshotPath);
+            const snapshot = readMetaHooksSnapshot(snapshotPath);
+            printInfo('takenAt', snapshot.takenAt);
+            const settingsFile = claudeSettingsPath();
+            restoreSettingsFromSnapshot(snapshot, settingsFile);
+            if (snapshot.originalSettings === null) {
+                printSuccess(`removed ${settingsFile} (no settings.json existed pre-injection)`);
+            }
+            else {
+                printSuccess(`restored ${settingsFile} to pre-injection state`);
+            }
+        }
+        catch (err) {
+            printError(asMessage(err));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=skills-migrate-hooks-back.js.map

package/dist/commands/skills-migrate-hooks-back.js.map

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

package/dist/commands/skills-migrate-hooks.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `olam skills migrate-hooks` — forward strip of atlas-toolbox-shipped
+ * olam-meta hook entries (Phase C C2).
+ *
+ *   olam skills migrate-hooks [--dry-run]
+ *
+ * Detects PreToolUse/PostToolUse matcher entries in ~/.claude/settings.json
+ * whose `command` strings reference one of the agentmemory-classifier
+ * scripts AND do NOT carry an olam-meta sentinel — i.e. atlas-toolbox-
+ * shipped entries from the pre-Phase-B world. Strips them; writes a
+ * pre-strip snapshot via the B5 primitive so the operator can undo via
+ * `olam skills migrate-hooks-back`.
+ *
+ * Order of operations (snapshot first, mutation after, audit-log last):
+ *   1. acquire settings-json lock (A4 — serializes against concurrent sync)
+ *   2. read settings.json (return early if absent — nothing to strip)
+ *   3. findStripCandidates(settings)
+ *      - empty list → no-op + summary + exit 0
+ *   4. --dry-run → print summary + exit 0 (no snapshot, no mutation)
+ *   5. writeMetaHooksSnapshot(settings) — same prefix as B5, so
+ *      `migrate-hooks-back` consumes it identically
+ *   6. applyStrip(settings, candidates) → next settings.json
+ *   7. atomic write via temp+rename
+ *   8. appendTrustAudit({action: 'meta-hook-stripped', count, ...})
+ *      — operator-visible append-only audit trail
+ *   9. print summary
+ *
+ * Idempotent: re-running on already-stripped settings.json is a no-op
+ * (findStripCandidates returns []).
+ *
+ * Reversibility: forward-fix-only. Audit-log entry is append-only by
+ * contract; settings.json mutation is reversible via B5 snapshot.
+ */
+import type { Command } from 'commander';
+import { AGENTMEMORY_SCRIPT_PATTERNS, OLAM_META_SENTINELS_GUARDED, findStripCandidates, applyStrip, type StripCandidate } from '@olam/core/src/skill-sync/atlas-hook-strip.js';
+/** Stable command name — referenced by tests. */
+export declare const MIGRATE_HOOKS_COMMAND = "migrate-hooks";
+export { AGENTMEMORY_SCRIPT_PATTERNS, OLAM_META_SENTINELS_GUARDED, findStripCandidates, applyStrip, type StripCandidate, };
+export declare function registerSkillsMigrateHooks(program: Command): void;
+//# sourceMappingURL=skills-migrate-hooks.d.ts.map

package/dist/commands/skills-migrate-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-migrate-hooks.d.ts","sourceRoot":"","sources":["../../src/commands/skills-migrate-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,EACnB,UAAU,EAEV,KAAK,cAAc,EACpB,MAAM,+CAA+C,CAAC;AAGvD,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAMrD,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,EACnB,UAAU,EACV,KAAK,cAAc,GACpB,CAAC;AAmEF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+EjE"}

package/dist/commands/skills-migrate-hooks.js

@@ -0,0 +1,178 @@
+/**
+ * `olam skills migrate-hooks` — forward strip of atlas-toolbox-shipped
+ * olam-meta hook entries (Phase C C2).
+ *
+ *   olam skills migrate-hooks [--dry-run]
+ *
+ * Detects PreToolUse/PostToolUse matcher entries in ~/.claude/settings.json
+ * whose `command` strings reference one of the agentmemory-classifier
+ * scripts AND do NOT carry an olam-meta sentinel — i.e. atlas-toolbox-
+ * shipped entries from the pre-Phase-B world. Strips them; writes a
+ * pre-strip snapshot via the B5 primitive so the operator can undo via
+ * `olam skills migrate-hooks-back`.
+ *
+ * Order of operations (snapshot first, mutation after, audit-log last):
+ *   1. acquire settings-json lock (A4 — serializes against concurrent sync)
+ *   2. read settings.json (return early if absent — nothing to strip)
+ *   3. findStripCandidates(settings)
+ *      - empty list → no-op + summary + exit 0
+ *   4. --dry-run → print summary + exit 0 (no snapshot, no mutation)
+ *   5. writeMetaHooksSnapshot(settings) — same prefix as B5, so
+ *      `migrate-hooks-back` consumes it identically
+ *   6. applyStrip(settings, candidates) → next settings.json
+ *   7. atomic write via temp+rename
+ *   8. appendTrustAudit({action: 'meta-hook-stripped', count, ...})
+ *      — operator-visible append-only audit trail
+ *   9. print summary
+ *
+ * Idempotent: re-running on already-stripped settings.json is a no-op
+ * (findStripCandidates returns []).
+ *
+ * Reversibility: forward-fix-only. Audit-log entry is append-only by
+ * contract; settings.json mutation is reversible via B5 snapshot.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import pc from 'picocolors';
+import { claudeSettingsPath } from '@olam/core/src/skill-sources/index.js';
+import { withSettingsJsonLock } from '@olam/core/src/skill-sync/settings-json-lock.js';
+import { writeMetaHooksSnapshot } from '@olam/core/src/skill-sources/meta-hooks-migration-snapshot.js';
+import { appendTrustAudit } from '@olam/core/src/skill-sources/trust-audit-log.js';
+import { AGENTMEMORY_SCRIPT_PATTERNS, OLAM_META_SENTINELS_GUARDED, findStripCandidates, applyStrip, } from '@olam/core/src/skill-sync/atlas-hook-strip.js';
+import { printError, printInfo, printSuccess, printWarning } from '../output.js';
+/** Stable command name — referenced by tests. */
+export const MIGRATE_HOOKS_COMMAND = 'migrate-hooks';
+// Re-export the pure strip helpers so the C2 test imports stay anchored
+// on the CLI module surface (paths used by operators); the C3 engine
+// imports the same names directly from `@olam/core/src/skill-sync/
+// atlas-hook-strip.js` to avoid a CLI → core back-edge.
+export { AGENTMEMORY_SCRIPT_PATTERNS, OLAM_META_SENTINELS_GUARDED, findStripCandidates, applyStrip, };
+/**
+ * True iff any hook command in settings.json contains an olam-meta
+ * sentinel. Used by the migrate-hooks command to warn when stripping
+ * atlas-shipped entries would leave NO olam-managed agentmemory hooks
+ * behind (per Phase C CP3 follow-up MEDIUM #3).
+ */
+function settingsHasOlamMetaSentinel(settings) {
+    for (const stage of ['PreToolUse', 'PostToolUse']) {
+        const matchers = settings.hooks?.[stage];
+        if (!Array.isArray(matchers))
+            continue;
+        for (const matcher of matchers) {
+            const inner = Array.isArray(matcher.hooks) ? matcher.hooks : [];
+            for (const h of inner) {
+                const cmd = h?.command;
+                if (typeof cmd !== 'string')
+                    continue;
+                for (const sentinel of OLAM_META_SENTINELS_GUARDED) {
+                    if (cmd.includes(sentinel))
+                        return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+function readSettings(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    if (raw.trim().length === 0)
+        return {};
+    return JSON.parse(raw);
+}
+function writeSettings(filePath, settings) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmp = `${filePath}.tmp-migrate-hooks-${process.pid}-${Date.now()}`;
+    fs.writeFileSync(tmp, JSON.stringify(settings, null, 2) + '\n');
+    fs.renameSync(tmp, filePath);
+}
+function printSummary(candidates, opts) {
+    if (candidates.length === 0) {
+        printInfo(MIGRATE_HOOKS_COMMAND, 'no atlas-toolbox-shipped agentmemory hooks found in settings.json — nothing to migrate');
+        return;
+    }
+    const verb = opts.dryRun ? 'would strip' : 'stripped';
+    console.log(pc.bold(`${verb} ${candidates.length} atlas-toolbox-shipped agentmemory hook entry(ies):`));
+    for (const c of candidates) {
+        const matcher = c.matcher ?? '*';
+        const cmdPreview = c.command.length > 120 ? `${c.command.slice(0, 117)}...` : c.command;
+        console.log(`  ${pc.dim(`[${c.stage}]`)} matcher=${pc.cyan(matcher)} pattern=${pc.yellow(c.matchedPattern)}`);
+        console.log(`    ${pc.dim(cmdPreview)}`);
+    }
+    if (opts.snapshotPath) {
+        console.log();
+        printInfo('snapshot', opts.snapshotPath);
+        printInfo('reverse', `run \`olam skills migrate-hooks-back\` (or \`migrate-hooks-back --snapshot <path>\`) to restore the pre-strip settings.json`);
+    }
+}
+function asMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export function registerSkillsMigrateHooks(program) {
+    const skills = program.commands.find((c) => c.name() === 'skills') ??
+        program.command('skills').description('Manage skill sources and synchronization');
+    skills
+        .command(MIGRATE_HOOKS_COMMAND)
+        .description('Strip atlas-toolbox-shipped agentmemory hook entries from ~/.claude/settings.json (forward migration; reverse via migrate-hooks-back)')
+        .option('--dry-run', 'Show what would be stripped without mutating settings.json or writing a snapshot')
+        .action(async (opts) => {
+        try {
+            await withSettingsJsonLock(async () => {
+                const settingsFile = claudeSettingsPath();
+                const settings = readSettings(settingsFile);
+                if (settings === null) {
+                    printInfo(MIGRATE_HOOKS_COMMAND, `${settingsFile} does not exist — nothing to migrate`);
+                    return;
+                }
+                const candidates = findStripCandidates(settings);
+                if (opts.dryRun) {
+                    printSummary(candidates, { dryRun: true });
+                    return;
+                }
+                if (candidates.length === 0) {
+                    printSummary(candidates, { dryRun: false });
+                    return;
+                }
+                // CP3 follow-up (Phase C adversarial review MEDIUM #3):
+                // when stripping would leave NO olam-meta sentinel-bound
+                // entries in settings.json, agentmemory recall/classify
+                // dies entirely. The likely-but-not-guaranteed cause:
+                // operator has been running `olam skills sync
+                // --meta-hooks=never` (declined olam ownership) and now
+                // ran migrate-hooks not realising it strips
+                // unconditionally. Warn loudly — don't gate (the operator
+                // who explicitly typed the command unambiguously asked
+                // for the strip; --force ceremony would be hostile), but
+                // the consequence MUST be visible.
+                const hasOlamMetaSentinel = settingsHasOlamMetaSentinel(settings);
+                if (!hasOlamMetaSentinel) {
+                    printWarning(`stripping ${candidates.length} atlas-toolbox-shipped agentmemory entry(ies) WITHOUT any olam-meta sentinel-bound block present in settings.json. ` +
+                        `After the strip, agentmemory recall/classify will NOT fire from this settings.json. ` +
+                        `If unintended, reverse with \`olam skills migrate-hooks-back\` and re-sync with \`olam skills sync\` (default mode injects olam-meta blocks when memory-bridge is running).`);
+                }
+                // Snapshot BEFORE mutation. Reuses B5 prefix so
+                // migrate-hooks-back picks it up identically.
+                const snapshotPath = writeMetaHooksSnapshot(settings);
+                const { nextSettings, removedCount } = applyStrip(settings, candidates);
+                writeSettings(settingsFile, nextSettings);
+                // Audit-log AFTER the write — entry records what landed,
+                // not what was planned. T6 mitigation.
+                appendTrustAudit({
+                    gitUrl: 'internal:olam-meta-hooks',
+                    action: 'meta-hook-stripped',
+                    trustMethod: 'none',
+                    sourceId: 'atlas-toolbox',
+                    note: `removed ${removedCount} agentmemory hook entry(ies); snapshot at ${snapshotPath}`,
+                });
+                printSummary(candidates, { dryRun: false, snapshotPath });
+                printSuccess(`stripped ${removedCount} atlas-toolbox-shipped agentmemory hook entry(ies) from ${settingsFile}`);
+            }, { reason: `cli:${MIGRATE_HOOKS_COMMAND}` });
+        }
+        catch (err) {
+            printError(asMessage(err));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=skills-migrate-hooks.js.map

package/dist/commands/skills-migrate-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-migrate-hooks.js","sourceRoot":"","sources":["../../src/commands/skills-migrate-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+DAA+D,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AACnF,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,EACnB,UAAU,GAGX,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjF,iDAAiD;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAErD,wEAAwE;AACxE,qEAAqE;AACrE,mEAAmE;AACnE,wDAAwD;AACxD,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,mBAAmB,EACnB,UAAU,GAEX,CAAC;AAEF;;;;;GAKG;AACH,SAAS,2BAA2B,CAAC,QAAuB;IAC1D,KAAK,MAAM,KAAK,IAAI,CAAC,YAAY,EAAE,aAAa,CAAU,EAAE,CAAC;QAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAG,CAAC,EAAE,OAAO,CAAC;gBACvB,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,SAAS;gBACtC,KAAK,MAAM,QAAQ,IAAI,2BAA2B,EAAE,CAAC;oBACnD,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;wBAAE,OAAO,IAAI,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;AAC1C,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,QAAuB;IAC9D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,GAAG,QAAQ,sBAAsB,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACzE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,YAAY,CACnB,UAA4B,EAC5B,IAAgD;IAEhD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,qBAAqB,EAAE,wFAAwF,CAAC,CAAC;QAC3H,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,MAAM,qDAAqD,CAAC,CAAC,CAAC;IACxG,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC;QACjC,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAC9G,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,SAAS,CAAC,SAAS,EAAE,6HAA6H,CAAC,CAAC;IACtJ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,MAAM,MAAM,GACV,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC;QACnD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,0CAA0C,CAAC,CAAC;IAEpF,MAAM;SACH,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,uIAAuI,CAAC;SACpJ,MAAM,CAAC,WAAW,EAAE,kFAAkF,CAAC;SACvG,MAAM,CAAC,KAAK,EAAE,IAA0B,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,oBAAoB,CACxB,KAAK,IAAI,EAAE;gBACT,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAC;gBAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC5C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtB,SAAS,CACP,qBAAqB,EACrB,GAAG,YAAY,sCAAsC,CACtD,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBACjD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,YAAY,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC3C,OAAO;gBACT,CAAC;gBACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5B,YAAY,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC5C,OAAO;gBACT,CAAC;gBAED,wDAAwD;gBACxD,yDAAyD;gBACzD,wDAAwD;gBACxD,sDAAsD;gBACtD,8CAA8C;gBAC9C,wDAAwD;gBACxD,4CAA4C;gBAC5C,0DAA0D;gBAC1D,uDAAuD;gBACvD,yDAAyD;gBACzD,mCAAmC;gBACnC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;gBAClE,IAAI,CAAC,mBAAmB,EAAE,CAAC;oBACzB,YAAY,CACV,aAAa,UAAU,CAAC,MAAM,qHAAqH;wBACjJ,sFAAsF;wBACtF,6KAA6K,CAChL,CAAC;gBACJ,CAAC;gBAED,gDAAgD;gBAChD,8CAA8C;gBAC9C,MAAM,YAAY,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;gBAEtD,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBACxE,aAAa,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;gBAE1C,yDAAyD;gBACzD,uCAAuC;gBACvC,gBAAgB,CAAC;oBACf,MAAM,EAAE,0BAA0B;oBAClC,MAAM,EAAE,oBAAoB;oBAC5B,WAAW,EAAE,MAAM;oBACnB,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,WAAW,YAAY,6CAA6C,YAAY,EAAE;iBACzF,CAAC,CAAC;gBAEH,YAAY,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC1D,YAAY,CAAC,YAAY,YAAY,2DAA2D,YAAY,EAAE,CAAC,CAAC;YAClH,CAAC,EACD,EAAE,MAAM,EAAE,OAAO,qBAAqB,EAAE,EAAE,CAC3C,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/skills-migrate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `olam skills migrate-from-toolbox` — convert an existing toolbox-shaped
+ * skill source (e.g. atlas-toolbox, grain/ai-skills) installation to
+ * olam-managed skill distribution.
+ *
+ * Order of operations (atomic in spirit — snapshot first, mutations after):
+ *   1. detectToolboxState({ toolboxPath }) → MigrationSnapshot (or no-op when nothing detected)
+ *   2. writeMigrationSnapshot() → ~/.olam/state/migration-snapshots/<namespace>-<ISO>.json
+ *   3. addSkillSource() + cloneSkillSource() → register the toolbox as an olam source
+ *   4. uninstall legacy toolbox SessionStart hook entries (entries whose command
+ *      references the toolbox repo path OR `./scripts/sync.sh`)
+ *   5. install the olam-skills SessionStart hook (via mergeHomeSettingsJson)
+ *   6. run `olam skills sync` to deploy artifacts under olam management
+ *
+ * Idempotent: re-running on an already-migrated host detects the olam
+ * hook sentinel and no-ops with an informative message.
+ */
+import type { Command } from 'commander';
+/** Stable command identifier — referenced by tests to keep them rename-resilient. */
+export declare const MIGRATE_FROM_TOOLBOX_COMMAND = "migrate-from-toolbox";
+interface ToolboxHookSurgeryResult {
+    readonly removed: number;
+}
+/**
+ * Surgically remove SessionStart hook entries that reference the toolbox
+ * repo path OR call `./scripts/sync.sh` (legacy atlas-toolbox sync entry —
+ * harmless no-op against non-atlas toolboxes). Leaves olam-skills entries
+ * and unrelated user hooks intact.
+ */
+declare function uninstallLegacyToolboxSessionStartHook(filePath: string, toolboxPath: string | undefined): ToolboxHookSurgeryResult;
+export declare function registerSkillsMigrate(program: Command): void;
+export { uninstallLegacyToolboxSessionStartHook };
+//# sourceMappingURL=skills-migrate.d.ts.map

package/dist/commands/skills-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-migrate.d.ts","sourceRoot":"","sources":["../../src/commands/skills-migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,qFAAqF;AACrF,eAAO,MAAM,4BAA4B,yBAAyB,CAAC;AAgBnE,UAAU,wBAAwB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,iBAAS,sCAAsC,CAC7C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,wBAAwB,CAuC1B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8I5D;AAGD,OAAO,EAAE,sCAAsC,EAAE,CAAC"}

package/dist/commands/skills-migrate.js

@@ -0,0 +1,216 @@
+/**
+ * `olam skills migrate-from-toolbox` — convert an existing toolbox-shaped
+ * skill source (e.g. atlas-toolbox, grain/ai-skills) installation to
+ * olam-managed skill distribution.
+ *
+ * Order of operations (atomic in spirit — snapshot first, mutations after):
+ *   1. detectToolboxState({ toolboxPath }) → MigrationSnapshot (or no-op when nothing detected)
+ *   2. writeMigrationSnapshot() → ~/.olam/state/migration-snapshots/<namespace>-<ISO>.json
+ *   3. addSkillSource() + cloneSkillSource() → register the toolbox as an olam source
+ *   4. uninstall legacy toolbox SessionStart hook entries (entries whose command
+ *      references the toolbox repo path OR `./scripts/sync.sh`)
+ *   5. install the olam-skills SessionStart hook (via mergeHomeSettingsJson)
+ *   6. run `olam skills sync` to deploy artifacts under olam management
+ *
+ * Idempotent: re-running on an already-migrated host detects the olam
+ * hook sentinel and no-ops with an informative message.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { addSkillSource, cloneSkillSource, detectToolboxState, writeMigrationSnapshot, OLAM_SKILLS_HOOK_SENTINEL, buildSkillsHookEntry, OLAM_SKILLS_HOOK_STAGE, syncSkills, } from '@olam/core/src/skill-sources/index.js';
+import { mergeHomeSettingsJson } from '@olam/core/src/world/merge-settings.js';
+import { claudeSettingsPath } from '@olam/core/src/skill-sources/index.js';
+import { printError, printInfo, printSuccess, printWarning } from '../output.js';
+/** Stable command identifier — referenced by tests to keep them rename-resilient. */
+export const MIGRATE_FROM_TOOLBOX_COMMAND = 'migrate-from-toolbox';
+function asMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function isOlamSkillsHookPresent(filePath) {
+    if (!fs.existsSync(filePath))
+        return false;
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return raw.includes(OLAM_SKILLS_HOOK_SENTINEL);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Surgically remove SessionStart hook entries that reference the toolbox
+ * repo path OR call `./scripts/sync.sh` (legacy atlas-toolbox sync entry —
+ * harmless no-op against non-atlas toolboxes). Leaves olam-skills entries
+ * and unrelated user hooks intact.
+ */
+function uninstallLegacyToolboxSessionStartHook(filePath, toolboxPath) {
+    if (!fs.existsSync(filePath))
+        return { removed: 0 };
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const settings = raw.trim() ? JSON.parse(raw) : {};
+    const ss = settings?.hooks?.SessionStart;
+    if (!Array.isArray(ss))
+        return { removed: 0 };
+    let removed = 0;
+    const filteredMatchers = [];
+    for (const matcher of ss) {
+        const innerHooks = Array.isArray(matcher?.hooks) ? matcher.hooks : [];
+        const keptInner = innerHooks.filter((h) => {
+            if (typeof h?.command !== 'string')
+                return true;
+            // Identify legacy-toolbox-shape entries by command content.
+            const looksLegacyToolbox = h.command.includes('./scripts/sync.sh') ||
+                (toolboxPath !== undefined && h.command.includes(toolboxPath));
+            // Never remove olam-skills entries here — install-skills-hook handles those.
+            const isOlam = h.command.includes(OLAM_SKILLS_HOOK_SENTINEL);
+            if (looksLegacyToolbox && !isOlam) {
+                removed += 1;
+                return false;
+            }
+            return true;
+        });
+        if (keptInner.length === 0 && innerHooks.length > 0)
+            continue;
+        if (keptInner.length === innerHooks.length)
+            filteredMatchers.push(matcher);
+        else
+            filteredMatchers.push({ ...matcher, hooks: keptInner });
+    }
+    if (removed === 0)
+        return { removed: 0 };
+    const next = { ...settings, hooks: { ...settings.hooks, SessionStart: filteredMatchers } };
+    if (filteredMatchers.length === 0) {
+        const otherStages = Object.keys(next.hooks ?? {}).filter((k) => k !== 'SessionStart');
+        if (otherStages.length === 0)
+            delete next.hooks;
+        else
+            delete next.hooks.SessionStart;
+    }
+    fs.writeFileSync(filePath, JSON.stringify(next, null, 2) + '\n');
+    return { removed };
+}
+export function registerSkillsMigrate(program) {
+    const skills = program.commands.find((c) => c.name() === 'skills') ??
+        program.command('skills').description('Manage skill sources and synchronization');
+    skills
+        .command(MIGRATE_FROM_TOOLBOX_COMMAND)
+        .description('Convert an existing toolbox-shaped skill source (atlas-toolbox, grain/ai-skills, etc.) to olam-managed skill distribution')
+        .option('--path <path>', 'Absolute path to the source toolbox repo (e.g. /repos/atlas-toolbox, /repos/grain/ai-skills)')
+        .option('--namespace <name>', 'Source-identifying namespace used for the snapshot filename + default source name (default: basename of --path)')
+        .option('--source-name <name>', 'Display name for the registered olam source (default: --namespace)')
+        .option('--branch <branch>', 'Branch to track on the source', 'master')
+        .option('--scope <scope>', 'install-hook scope: project (default) or user', 'project')
+        .option('--no-clone', 'Skip clone step (register source state only — useful for tests)')
+        .action(async (opts) => {
+        // Idempotency: if olam-skills sentinel already present, no-op.
+        const settingsFile = claudeSettingsPath();
+        if (isOlamSkillsHookPresent(settingsFile)) {
+            printInfo(MIGRATE_FROM_TOOLBOX_COMMAND, `already migrated (olam-skills hook sentinel present in ${settingsFile})`);
+            return;
+        }
+        if (!opts.path) {
+            printError('--path <path> is required (absolute path to the source toolbox repo, e.g. /repos/atlas-toolbox)');
+            process.exitCode = 1;
+            return;
+        }
+        const toolboxPath = opts.path;
+        const namespace = opts.namespace ?? path.basename(toolboxPath);
+        const sourceName = opts.sourceName ?? namespace;
+        // 1. Detect.
+        const snapshot = detectToolboxState({ toolboxPath, namespace });
+        if (!snapshot) {
+            printInfo(MIGRATE_FROM_TOOLBOX_COMMAND, `no toolbox state detected at ${toolboxPath} (no ~/.claude/.atlas-user, no symlinks pointing at this path, no SessionStart hook block — nothing to migrate)`);
+            return;
+        }
+        // 2. Snapshot (ALWAYS — before any mutation).
+        let snapshotPath;
+        try {
+            snapshotPath = writeMigrationSnapshot(snapshot);
+            printInfo('snapshot', snapshotPath);
+        }
+        catch (err) {
+            printError(`snapshot write failed: ${asMessage(err)}`);
+            process.exitCode = 1;
+            return;
+        }
+        // 3. Register source + clone.
+        // `trustMethod: 'internal'` — migrate-from is an operator-explicit
+        // command (operator typed it). Bypasses the interactive trust
+        // gate but is structurally audit-logged via addSkillSource()
+        // itself; the trust-audit log records the bypass.
+        try {
+            const entry = addSkillSource({
+                name: sourceName,
+                gitUrl: toolboxPath,
+                branch: opts.branch,
+                trustMethod: 'internal',
+            });
+            printInfo('registered source', `${entry.name} (${entry.id})`);
+            if (opts.clone !== false) {
+                const cloneResult = cloneSkillSource({
+                    gitUrl: entry.gitUrl,
+                    branch: entry.branch,
+                    id: entry.id,
+                });
+                printInfo('cloned to', cloneResult.clonePath);
+            }
+            else {
+                printInfo('clone skipped', '--no-clone passed');
+            }
+        }
+        catch (err) {
+            printError(`source registration failed: ${asMessage(err)}`);
+            printInfo('snapshot preserved', snapshotPath);
+            process.exitCode = 1;
+            return;
+        }
+        // 4. Uninstall legacy toolbox SessionStart hook.
+        try {
+            const surgery = uninstallLegacyToolboxSessionStartHook(settingsFile, toolboxPath);
+            if (surgery.removed > 0) {
+                printInfo('legacy hook', `removed ${surgery.removed} entry(ies) from ${settingsFile}`);
+            }
+            else {
+                printInfo('legacy hook', 'no legacy-toolbox-shape SessionStart hook entries found');
+            }
+        }
+        catch (err) {
+            printWarning(`legacy hook removal failed: ${asMessage(err)}; proceeding`);
+        }
+        // 5. Install olam-skills hook.
+        const scope = opts.scope === 'user' ? 'user' : 'project';
+        const olamHookPath = scope === 'user' ? settingsFile : path.join(process.cwd(), '.claude', 'settings.json');
+        try {
+            fs.mkdirSync(path.dirname(olamHookPath), { recursive: true });
+            const result = mergeHomeSettingsJson(olamHookPath, {
+                ensureHook: {
+                    stage: OLAM_SKILLS_HOOK_STAGE,
+                    sentinel: OLAM_SKILLS_HOOK_SENTINEL,
+                    entry: buildSkillsHookEntry(),
+                },
+            });
+            printInfo('olam hook', `${result.status} at ${olamHookPath}`);
+        }
+        catch (err) {
+            printError(`olam hook install failed: ${asMessage(err)}`);
+            printInfo('snapshot preserved', snapshotPath);
+            process.exitCode = 1;
+            return;
+        }
+        // 6. Sync.
+        try {
+            const summary = await syncSkills({ atlasUser: snapshot.atlasUser });
+            printSuccess(`migrated — synced ${summary.sourceCount} source(s), deployed ${summary.deploy?.linked ?? 0} symlink(s)`);
+            printInfo('snapshot', snapshotPath);
+            printInfo('reverse', `run \`olam skills migrate-back-to-toolbox --path ${toolboxPath}\` to restore the original state`);
+        }
+        catch (err) {
+            printError(`sync failed: ${asMessage(err)}`);
+            printInfo('snapshot preserved', snapshotPath);
+            process.exitCode = 1;
+        }
+    });
+}
+// Export internal helper for tests + reverse-migration consumers.
+export { uninstallLegacyToolboxSessionStartHook };
+//# sourceMappingURL=skills-migrate.js.map

package/dist/commands/skills-migrate.js.map

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

package/dist/commands/skills-onboard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * olam skills onboard — fresh-install umbrella that composes the 3-step
+ * recipe into one operator-friendly verb.
+ *
+ *   olam skills onboard --name <n> --git-url <url> [--branch main]
+ *                       [--trust] [--scope project|user]
+ *
+ * Pipeline:
+ *   1. addSkillSource({ trustMethod: 'flag' }) — `--trust` is the only
+ *      sanctioned trust method here. Onboard is non-interactive by
+ *      design (it composes 4 steps; an interactive picker mid-pipeline
+ *      would be confusing). Operators who want the picker should run
+ *      `olam skills source add` directly.
+ *   2. cloneSkillSource(...) — register + clone.
+ *   3. installSkillsHookToFile(...) at --scope (default project).
+ *   4. syncSkills() — first sync.
+ *   5. Print a single success summary covering all 4 steps.
+ *
+ * Failure rollback: any failure AFTER step 1 (clone, hook install,
+ * sync) unwinds the registered source so the operator can re-try
+ * cleanly. Each step appends an audit row so the trust-coverage gate
+ * stays accurate even when the umbrella partially fails.
+ */
+import type { Command } from 'commander';
+export declare function registerSkillsOnboard(program: Command): void;
+//# sourceMappingURL=skills-onboard.d.ts.map

package/dist/commands/skills-onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-onboard.d.ts","sourceRoot":"","sources":["../../src/commands/skills-onboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0M5D"}