@pleri/olam-cli 0.1.145 → 0.1.146

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

@@ -0,0 +1,14 @@
+/**
+ * olam skills doctor — diagnostic + auto-repair for the skills surface.
+ *
+ *   olam skills doctor                  # print report; interactive prompts
+ *                                       # per issue when TTY
+ *   olam skills doctor --auto-fix       # apply every repair without prompt
+ *   olam skills doctor --check-only     # exit 1 on any issue; never modify
+ *                                       # state (read-only health probe)
+ *
+ * Mirrors `olam kg doctor`'s shape; per OQ12 [assumed].
+ */
+import type { Command } from 'commander';
+export declare function registerSkillsDoctor(program: Command): void;
+//# sourceMappingURL=skills-doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-doctor.d.ts","sourceRoot":"","sources":["../../src/commands/skills-doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgDzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6E3D"}

package/dist/commands/skills-doctor.js

@@ -0,0 +1,126 @@
+/**
+ * olam skills doctor — diagnostic + auto-repair for the skills surface.
+ *
+ *   olam skills doctor                  # print report; interactive prompts
+ *                                       # per issue when TTY
+ *   olam skills doctor --auto-fix       # apply every repair without prompt
+ *   olam skills doctor --check-only     # exit 1 on any issue; never modify
+ *                                       # state (read-only health probe)
+ *
+ * Mirrors `olam kg doctor`'s shape; per OQ12 [assumed].
+ */
+import * as readline from 'node:readline';
+import pc from 'picocolors';
+import { runAllDoctorChecks, } from '@olam/core/src/skill-sources/index.js';
+import { printError, printHeader, printSuccess, printWarning } from '../output.js';
+function asMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function defaultDoctorPrompt(question) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(question, (a) => {
+            rl.close();
+            resolve(a);
+        });
+    });
+}
+async function confirmRepair(check) {
+    const testFn = globalThis.__olamTestDoctorPrompt;
+    const prompt = testFn ?? (() => defaultDoctorPrompt(`Apply repair for "${check.name}"? [y/N] `));
+    const answer = (await prompt()).trim().toLowerCase();
+    return answer === 'y' || answer === 'yes';
+}
+function printCheck(check) {
+    if (check.healthy) {
+        console.log(`  ${pc.green('✓')} ${pc.bold(check.name.padEnd(22))} ${pc.dim(check.description)}`);
+        if (check.details && check.details.length > 0) {
+            for (const d of check.details)
+                console.log(`      ${pc.dim(d)}`);
+        }
+    }
+    else {
+        console.log(`  ${pc.red('✗')} ${pc.bold(check.name.padEnd(22))} ${pc.yellow(check.issue ?? 'unhealthy')}`);
+        console.log(`      ${pc.dim(check.description)}`);
+        if (check.details) {
+            for (const d of check.details.slice(0, 10))
+                console.log(`      ${pc.dim('· ' + d)}`);
+            if (check.details.length > 10)
+                console.log(`      ${pc.dim(`… and ${check.details.length - 10} more`)}`);
+        }
+    }
+}
+export function registerSkillsDoctor(program) {
+    const skills = program.commands.find((c) => c.name() === 'skills') ??
+        program.command('skills').description('Manage skill sources and synchronization');
+    skills
+        .command('doctor')
+        .description('Diagnose 4 corruption classes; auto-repair available with --auto-fix')
+        .option('--auto-fix', 'Apply each repair without prompting')
+        .option('--check-only', 'Report issues + exit non-zero without modifying state')
+        .action(async (opts) => {
+        if (opts.autoFix && opts.checkOnly) {
+            printError('--auto-fix and --check-only are mutually exclusive');
+            process.exitCode = 1;
+            return;
+        }
+        printHeader('skills doctor');
+        let checks;
+        try {
+            checks = runAllDoctorChecks();
+        }
+        catch (err) {
+            printError(`doctor checks crashed: ${asMessage(err)}`);
+            process.exitCode = 1;
+            return;
+        }
+        for (const c of checks)
+            printCheck(c);
+        const unhealthy = checks.filter((c) => !c.healthy);
+        if (unhealthy.length === 0) {
+            console.log();
+            printSuccess('all 4 checks PASS');
+            return;
+        }
+        console.log();
+        printWarning(`${unhealthy.length} of ${checks.length} check(s) report issues`);
+        if (opts.checkOnly) {
+            console.log(pc.dim('(--check-only — exiting without repair)'));
+            process.exitCode = 1;
+            return;
+        }
+        let repaired = 0;
+        let skipped = 0;
+        for (const check of unhealthy) {
+            if (!check.repair) {
+                console.log(pc.dim(`  (no auto-repair for ${check.name} — operator-attention required)`));
+                skipped += 1;
+                continue;
+            }
+            const shouldRepair = opts.autoFix ? true : await confirmRepair(check);
+            if (!shouldRepair) {
+                console.log(pc.dim(`  skipped: ${check.name}`));
+                skipped += 1;
+                continue;
+            }
+            try {
+                await check.repair();
+                console.log(pc.green(`  repaired: ${check.name}`));
+                repaired += 1;
+            }
+            catch (err) {
+                printError(`  repair failed for ${check.name}: ${asMessage(err)}`);
+                skipped += 1;
+            }
+        }
+        console.log();
+        if (skipped > 0) {
+            printWarning(`repaired ${repaired}; skipped ${skipped}. Re-run doctor to verify.`);
+            process.exitCode = skipped > 0 ? 1 : 0;
+        }
+        else {
+            printSuccess(`repaired ${repaired} issue(s). Re-run doctor to verify.`);
+        }
+    });
+}
+//# sourceMappingURL=skills-doctor.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * `olam skills install-hook [--scope project|user]` — install the
+ * SessionStart hook that runs `olam skills sync --quiet` on every
+ * Claude Code session start.
+ *
+ * `olam skills uninstall-hook [--scope project|user]` — surgical
+ * sentinel-matched removal.
+ *
+ * Mirrors `olam kg install-hook` / `olam kg uninstall-hook` shape:
+ *   - `--scope project` (default) → <cwd>/.claude/settings.json
+ *   - `--scope user`              → ~/.claude/settings.json
+ *
+ * Idempotent install via OLAM_SKILLS_HOOK_SENTINEL substring-match.
+ * Surgical uninstall: only entries whose command contains the sentinel
+ * are dropped; user-authored hooks are preserved.
+ */
+import type { Command } from 'commander';
+export declare function registerSkillsHook(program: Command): void;
+//# sourceMappingURL=skills-hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-hook.d.ts","sourceRoot":"","sources":["../../src/commands/skills-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuEzD"}

package/dist/commands/skills-hook.js

@@ -0,0 +1,99 @@
+/**
+ * `olam skills install-hook [--scope project|user]` — install the
+ * SessionStart hook that runs `olam skills sync --quiet` on every
+ * Claude Code session start.
+ *
+ * `olam skills uninstall-hook [--scope project|user]` — surgical
+ * sentinel-matched removal.
+ *
+ * Mirrors `olam kg install-hook` / `olam kg uninstall-hook` shape:
+ *   - `--scope project` (default) → <cwd>/.claude/settings.json
+ *   - `--scope user`              → ~/.claude/settings.json
+ *
+ * Idempotent install via OLAM_SKILLS_HOOK_SENTINEL substring-match.
+ * Surgical uninstall: only entries whose command contains the sentinel
+ * are dropped; user-authored hooks are preserved.
+ */
+import { installSkillsHookToFile, skillsHookSettingsPathFor, uninstallSkillsHookFromFile, } from '@olam/core/src/skill-sources/index.js';
+import * as fs from 'node:fs';
+import { printError, printInfo, printSuccess, printWarning } from '../output.js';
+function backup(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = `${filePath}.olam-bak.${ts}`;
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+export function registerSkillsHook(program) {
+    const skills = program.commands.find((c) => c.name() === 'skills') ??
+        program.command('skills').description('Manage skill sources and synchronization');
+    skills
+        .command('install-hook')
+        .description('Install the SessionStart hook that runs `olam skills sync --quiet` on session start')
+        .option('--scope <scope>', 'project (default; <cwd>/.claude/settings.json) or user (~/.claude/settings.json)', 'project')
+        .action((opts) => {
+        const scope = opts.scope === 'user' ? 'user' : 'project';
+        const filePath = skillsHookSettingsPathFor(scope);
+        try {
+            const result = installSkillsHookToFile(filePath);
+            switch (result.status) {
+                case 'installed':
+                    printSuccess(`olam-skills SessionStart hook installed (${scope} scope)`);
+                    printInfo('settings', filePath);
+                    if (result.backupPath)
+                        printInfo('backup', result.backupPath);
+                    printInfo('next', 'open a new Claude Code session; `olam skills sync --quiet` will run on start');
+                    return;
+                case 'already-present':
+                    printInfo('olam-skills hook', `already installed at ${filePath}`);
+                    return;
+                case 'no-op':
+                    printWarning(`no change made to ${filePath}`);
+                    return;
+            }
+        }
+        catch (err) {
+            printError(`install-hook failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    });
+    skills
+        .command('uninstall-hook')
+        .description('Remove the olam-skills SessionStart hook from settings.json (sentinel-matched; surgical)')
+        .option('--scope <scope>', 'project (default) or user', 'project')
+        .action((opts) => {
+        const scope = opts.scope === 'user' ? 'user' : 'project';
+        const filePath = skillsHookSettingsPathFor(scope);
+        const backupPath = backup(filePath);
+        try {
+            const result = uninstallSkillsHookFromFile(filePath);
+            switch (result.status) {
+                case 'removed':
+                    printSuccess(`olam-skills SessionStart hook removed from ${filePath}`);
+                    if (backupPath)
+                        printInfo('backup', backupPath);
+                    return;
+                case 'not-found':
+                    printInfo('olam-skills hook', `not found in ${filePath} — already uninstalled`);
+                    if (backupPath) {
+                        try {
+                            fs.unlinkSync(backupPath);
+                        }
+                        catch { /* best-effort */ }
+                    }
+                    return;
+                case 'no-settings':
+                    printInfo('olam-skills hook', `no settings.json at ${filePath} — nothing to remove`);
+                    return;
+            }
+        }
+        catch (err) {
+            printError(`uninstall-hook failed: ${err instanceof Error ? err.message : String(err)}`);
+            if (backupPath)
+                printInfo('backup', `settings.json preserved at ${backupPath}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=skills-hook.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * `olam skills migrate-back-to-toolbox` — reverse the migration performed
+ * by `migrate-from-toolbox`, consuming the pre-migration snapshot written
+ * at ~/.olam/state/migration-snapshots/<namespace>-<ISO>.json.
+ *
+ * Reverse order of migrate-from-toolbox operations:
+ *   1. resolve snapshot (latest matching --path / --namespace / --snapshot)
+ *   2. uninstall olam-skills SessionStart hook (sentinel-matched)
+ *   3. delete olam-managed symlinks under ~/.claude/ (any symlink whose
+ *      target lives under ~/.olam/state/skill-sources/<id>/)
+ *   4. restore the original SessionStart hook block from snapshot
+ *   5. restore the toolbox-managed symlinks from snapshot
+ *   6. restore ~/.claude/.atlas-user from snapshot (atlas-shape only)
+ *   7. unless --keep-source: remove the toolbox olam source registration
+ *      (skill-sources slice + clone dir)
+ */
+import type { Command } from 'commander';
+/** Stable command identifier — referenced by tests to keep them rename-resilient. */
+export declare const MIGRATE_BACK_TO_TOOLBOX_COMMAND = "migrate-back-to-toolbox";
+export declare function registerSkillsMigrateBack(program: Command): void;
+//# sourceMappingURL=skills-migrate-back.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills-migrate-back.d.ts","sourceRoot":"","sources":["../../src/commands/skills-migrate-back.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,qFAAqF;AACrF,eAAO,MAAM,+BAA+B,4BAA4B,CAAC;AAiGzE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoHhE"}

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

@@ -0,0 +1,222 @@
+/**
+ * `olam skills migrate-back-to-toolbox` — reverse the migration performed
+ * by `migrate-from-toolbox`, consuming the pre-migration snapshot written
+ * at ~/.olam/state/migration-snapshots/<namespace>-<ISO>.json.
+ *
+ * Reverse order of migrate-from-toolbox operations:
+ *   1. resolve snapshot (latest matching --path / --namespace / --snapshot)
+ *   2. uninstall olam-skills SessionStart hook (sentinel-matched)
+ *   3. delete olam-managed symlinks under ~/.claude/ (any symlink whose
+ *      target lives under ~/.olam/state/skill-sources/<id>/)
+ *   4. restore the original SessionStart hook block from snapshot
+ *   5. restore the toolbox-managed symlinks from snapshot
+ *   6. restore ~/.claude/.atlas-user from snapshot (atlas-shape only)
+ *   7. unless --keep-source: remove the toolbox olam source registration
+ *      (skill-sources slice + clone dir)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readLatestMigrationSnapshot, readMigrationSnapshotFromPath, uninstallSkillsHookFromFile, claudeSettingsPath, listSkillSources, removeSkillSource, removeSkillSourceClone, skillSourceClonePath, } 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_BACK_TO_TOOLBOX_COMMAND = 'migrate-back-to-toolbox';
+function asMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function claudeDirInternal() {
+    const override = process.env['OLAM_CLAUDE_DIR'];
+    if (override && override.length > 0)
+        return override;
+    return path.join(process.env['HOME'] ?? '', '.claude');
+}
+function restoreSessionStartFromSnapshot(filePath, originalSessionStartHook) {
+    if (!originalSessionStartHook || originalSessionStartHook.length === 0) {
+        return { restored: false };
+    }
+    let settings;
+    if (fs.existsSync(filePath)) {
+        try {
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            settings = raw.trim() ? JSON.parse(raw) : {};
+        }
+        catch {
+            settings = {};
+        }
+    }
+    else {
+        settings = {};
+    }
+    // Replace SessionStart entirely with snapshot's array (we uninstalled olam
+    // entries already; this restores the original state byte-for-byte).
+    const hooks = (settings.hooks && typeof settings.hooks === 'object') ? settings.hooks : {};
+    const next = {
+        ...settings,
+        hooks: {
+            ...hooks,
+            SessionStart: originalSessionStartHook,
+        },
+    };
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(next, null, 2) + '\n');
+    return { restored: true };
+}
+function removeOlamManagedSymlinks() {
+    const claude = claudeDirInternal();
+    const sources = listSkillSources();
+    const olamClonePaths = sources.map((s) => skillSourceClonePath(s.id));
+    let removed = 0;
+    for (const bucket of ['skills', 'agents', 'scripts', 'rules', 'commands']) {
+        const dir = path.join(claude, bucket);
+        if (!fs.existsSync(dir))
+            continue;
+        for (const name of fs.readdirSync(dir)) {
+            const linkPath = path.join(dir, name);
+            try {
+                const stat = fs.lstatSync(linkPath);
+                if (!stat.isSymbolicLink())
+                    continue;
+                const target = fs.readlinkSync(linkPath);
+                if (olamClonePaths.some((cp) => target.startsWith(cp))) {
+                    fs.unlinkSync(linkPath);
+                    removed += 1;
+                }
+            }
+            catch {
+                // best-effort
+            }
+        }
+    }
+    return removed;
+}
+function restoreToolboxSymlinks(symlinks) {
+    let restored = 0;
+    for (const { link, target } of symlinks) {
+        try {
+            fs.mkdirSync(path.dirname(link), { recursive: true });
+            if (fs.existsSync(link) || (() => { try {
+                fs.lstatSync(link);
+                return true;
+            }
+            catch {
+                return false;
+            } })()) {
+                fs.unlinkSync(link);
+            }
+            fs.symlinkSync(target, link);
+            restored += 1;
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return restored;
+}
+function restoreAtlasUserMarker(atlasUser) {
+    if (!atlasUser)
+        return false;
+    const file = path.join(claudeDirInternal(), '.atlas-user');
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, atlasUser);
+    return true;
+}
+export function registerSkillsMigrateBack(program) {
+    const skills = program.commands.find((c) => c.name() === 'skills') ??
+        program.command('skills').description('Manage skill sources and synchronization');
+    skills
+        .command(MIGRATE_BACK_TO_TOOLBOX_COMMAND)
+        .description('Reverse migrate-from-toolbox using the pre-migration snapshot')
+        .option('--path <path>', 'Absolute path of the original toolbox repo (filters to the snapshot taken for this source)')
+        .option('--namespace <name>', 'Filter snapshots by namespace (e.g. atlas-toolbox, ai-skills)')
+        .option('--snapshot <path>', 'Use a specific snapshot file (default: most recent matching snapshot)')
+        .option('--keep-source', 'Preserve the toolbox olam source registration (default: remove)')
+        .action((opts) => {
+        // 1. Resolve snapshot.
+        let snapshotPath;
+        let snapshot;
+        try {
+            if (opts.snapshot) {
+                snapshotPath = path.resolve(opts.snapshot);
+                if (!fs.existsSync(snapshotPath)) {
+                    printError(`snapshot not found at ${snapshotPath}`);
+                    process.exitCode = 1;
+                    return;
+                }
+                snapshot = readMigrationSnapshotFromPath(snapshotPath);
+            }
+            else {
+                const filterNamespace = opts.namespace ?? (opts.path ? path.basename(opts.path) : undefined);
+                const latest = readLatestMigrationSnapshot({ namespace: filterNamespace });
+                if (!latest) {
+                    const where = filterNamespace ? ` for namespace "${filterNamespace}"` : '';
+                    printError(`no migration snapshot found${where}. Did you run \`olam skills migrate-from-toolbox\` first?`);
+                    process.exitCode = 1;
+                    return;
+                }
+                snapshotPath = latest.path;
+                snapshot = latest.snapshot;
+            }
+        }
+        catch (err) {
+            printError(`could not read snapshot: ${asMessage(err)}`);
+            process.exitCode = 1;
+            return;
+        }
+        // If --path was supplied as an additional sanity check, warn on mismatch
+        // but proceed (the snapshot is authoritative about what to restore).
+        if (opts.path && snapshot.atlasToolboxRepoPath && opts.path !== snapshot.atlasToolboxRepoPath) {
+            printWarning(`--path ${opts.path} differs from snapshot's recorded path ${snapshot.atlasToolboxRepoPath}; proceeding with snapshot's path`);
+        }
+        printInfo('snapshot', snapshotPath);
+        // 2. Uninstall olam-skills hook.
+        try {
+            const settingsFile = claudeSettingsPath();
+            const r = uninstallSkillsHookFromFile(settingsFile);
+            printInfo('olam hook', r.status);
+        }
+        catch (err) {
+            printWarning(`olam hook uninstall failed: ${asMessage(err)}; proceeding`);
+        }
+        // 3. Remove olam-managed symlinks BEFORE removing the source
+        //    registration (we need source paths to identify them).
+        const olamSymlinksRemoved = removeOlamManagedSymlinks();
+        printInfo('olam symlinks removed', String(olamSymlinksRemoved));
+        // 4. Restore original SessionStart hook block.
+        try {
+            const r = restoreSessionStartFromSnapshot(claudeSettingsPath(), snapshot.originalSessionStartHook);
+            printInfo('original hook', r.restored ? 'restored' : 'no original hook in snapshot');
+        }
+        catch (err) {
+            printWarning(`original hook restore failed: ${asMessage(err)}; proceeding`);
+        }
+        // 5. Restore toolbox symlinks.
+        const restored = restoreToolboxSymlinks(snapshot.atlasManagedSymlinks ?? []);
+        printInfo('toolbox symlinks restored', String(restored));
+        // 6. Restore .atlas-user marker (atlas-toolbox-shape only; no-op for non-atlas sources).
+        const atlasUserRestored = restoreAtlasUserMarker(snapshot.atlasUser);
+        if (atlasUserRestored)
+            printInfo('atlas-user', `restored ("${snapshot.atlasUser}")`);
+        // 7. Remove olam source registration (unless --keep-source).
+        if (!opts.keepSource) {
+            try {
+                const sources = listSkillSources();
+                const target = snapshot.atlasToolboxRepoPath;
+                const namespace = snapshot.namespace;
+                for (const s of sources) {
+                    if (s.gitUrl === target || (namespace && s.name === namespace)) {
+                        removeSkillSourceClone(s.id);
+                        removeSkillSource(s.id);
+                        printInfo('olam source removed', `${s.name} (${s.id})`);
+                    }
+                }
+            }
+            catch (err) {
+                printWarning(`source removal failed: ${asMessage(err)}; proceeding`);
+            }
+        }
+        else {
+            printInfo('olam source', '--keep-source: preserved');
+        }
+        printSuccess(`migrated back — toolbox state restored from snapshot taken at ${snapshot.takenAt}`);
+    });
+}
+//# sourceMappingURL=skills-migrate-back.js.map

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

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

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"}