@pleri/olam-cli 0.1.144 → 0.1.146

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

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