@vibesdotdev/cli 0.0.2 → 1.0.0-rc.3

package/dist/commands/skills/_skills.js.map

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

package/dist/commands/skills/skills-group.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLIGroupAssetDescriptor } from '../../schemas/descriptors.ts';
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=skills-group.descriptor.d.ts.map

package/dist/commands/skills/skills-group.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-group.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/skills-group.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,QAAA,MAAM,UAAU,EAAE,uBASjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/skills/skills-group.descriptor.js

@@ -0,0 +1,12 @@
+const descriptor = {
+    kind: 'cli/group',
+    id: 'skills',
+    name: 'skills',
+    description: 'Install the tracked skill library (docs/skills/) into your local .claude/',
+    order: 110,
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=skills-group.descriptor.js.map

package/dist/commands/skills/skills-group.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-group.descriptor.js","sourceRoot":"","sources":["../../../src/commands/skills/skills-group.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,2EAA2E;IACxF,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/skills/skills.install.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLICommandAssetDescriptor } from '../../schemas/descriptors.ts';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=skills.install.descriptor.d.ts.map

package/dist/commands/skills/skills.install.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.install.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/skills.install.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE9E,QAAA,MAAM,UAAU,EAAE,yBAkCjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/skills/skills.install.descriptor.js

@@ -0,0 +1,37 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'skills.install',
+    name: 'install',
+    description: 'Materialize tracked skills (docs/skills/) into your local .claude/ commands and skills',
+    group: 'skills',
+    arguments: [
+        { name: 'name', description: 'Install only this skill (default: all)', required: false }
+    ],
+    options: [
+        { flags: '--force', description: 'Overwrite a locally-modified target (default: skip it)' },
+        { flags: '--dry-run', description: 'Show what would be installed without writing' },
+        { flags: '--root <dir>', description: 'Repo root to operate on (default: search up from cwd)' }
+    ],
+    examples: [
+        {
+            command: 'vibes skills install',
+            description: 'Install every tracked skill into the local .claude/',
+            expectExit: 0
+        },
+        {
+            command: 'vibes skills install tui-shot',
+            description: 'Install just the tui-shot skill',
+            expectExit: 0
+        },
+        {
+            command: 'vibes skills install --dry-run',
+            description: 'Preview the install plan without touching disk',
+            expectExit: 0
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=skills.install.descriptor.js.map

package/dist/commands/skills/skills.install.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.install.descriptor.js","sourceRoot":"","sources":["../../../src/commands/skills/skills.install.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,wFAAwF;IACrG,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE;QACV,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,wCAAwC,EAAE,QAAQ,EAAE,KAAK,EAAE;KACxF;IACD,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,wDAAwD,EAAE;QAC3F,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,8CAA8C,EAAE;QACnF,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,uDAAuD,EAAE;KAC/F;IACD,QAAQ,EAAE;QACT;YACC,OAAO,EAAE,sBAAsB;YAC/B,WAAW,EAAE,qDAAqD;YAClE,UAAU,EAAE,CAAC;SACb;QACD;YACC,OAAO,EAAE,+BAA+B;YACxC,WAAW,EAAE,iCAAiC;YAC9C,UAAU,EAAE,CAAC;SACb;QACD;YACC,OAAO,EAAE,gCAAgC;YACzC,WAAW,EAAE,gDAAgD;YAC7D,UAAU,EAAE,CAAC;SACb;KACD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/skills/skills.install.impl.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `vibes skills install [name]` — materialize the version-controlled skill
+ * library (docs/skills/) into the developer's local, gitignored `.claude/`
+ * commands and skills. Round-trips byte-faithfully via the `source:` frontmatter
+ * line (see docs/skills/README.md and ./_skills.ts).
+ */
+import type { CommandContext, CommandOptions } from '../../schemas/surface';
+declare const _default: {
+    execute(args: CommandOptions, opts: CommandOptions, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=skills.install.impl.d.ts.map

package/dist/commands/skills/skills.install.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.install.impl.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/skills.install.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;;kBA0BvD,cAAc,QAAQ,cAAc,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AADlG,wBAqDE"}

package/dist/commands/skills/skills.install.impl.js

@@ -0,0 +1,65 @@
+/**
+ * `vibes skills install [name]` — materialize the version-controlled skill
+ * library (docs/skills/) into the developer's local, gitignored `.claude/`
+ * commands and skills. Round-trips byte-faithfully via the `source:` frontmatter
+ * line (see docs/skills/README.md and ./_skills.ts).
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { writeJson, writeStdoutLine } from "../../commands/output.js";
+import { resolveSkillsRoot, listSkillMirrors, installSkill, openSkillsHost, SkillsRootOptionSchema, BOLD, RESET, GREEN, YELLOW, GRAY } from "./_skills.js";
+const ACTION_LABEL = {
+    created: `${GREEN}created${RESET}`,
+    updated: `${GREEN}updated${RESET}`,
+    unchanged: `${GRAY}unchanged${RESET}`,
+    'skipped-exists': `${YELLOW}skipped (local edits — use --force)${RESET}`,
+    'skipped-escape': `${YELLOW}skipped (source: escapes repo root)${RESET}`,
+    'no-source': `${YELLOW}skipped (no source:)${RESET}`
+};
+export default {
+    async execute(args, opts, context) {
+        const cwd = context.runtime.localEnvironment.getCwd?.();
+        if (!cwd) {
+            throw new CapabilityError('No working directory available.', 'INVALID_INPUT', {
+                recoveryHint: 'The host environment did not provide a working directory.'
+            });
+        }
+        const host = await openSkillsHost(context.runtime);
+        const root = await resolveSkillsRoot(host, SkillsRootOptionSchema.parse(opts.root), cwd);
+        if (root === null) {
+            throw new CapabilityError('No docs/skills/ found.', 'INVALID_INPUT', {
+                recoveryHint: 'Run from inside the repo, or pass --root <dir>.'
+            });
+        }
+        const force = opts.force === true;
+        const dryRun = opts.dryRun === true;
+        const only = z.string().optional().catch(undefined).parse(args.name);
+        let mirrors = await listSkillMirrors(host, root);
+        if (only) {
+            mirrors = mirrors.filter((m) => m.name === only);
+            if (mirrors.length === 0) {
+                throw new CapabilityError(`Unknown skill "${only}".`, 'INVALID_INPUT', {
+                    recoveryHint: 'Run `vibes skills list` to see what is available.'
+                });
+            }
+        }
+        const results = [];
+        for (const m of mirrors)
+            results.push(await installSkill(host, root, m, { force, dryRun }));
+        if (opts.format === 'json') {
+            await writeJson(context.runtime, { root, dryRun, force, results });
+            return;
+        }
+        const lines = ['', `${BOLD}vibes skills install${RESET}${dryRun ? `  ${GRAY}(dry run)${RESET}` : ''}`, '─'.repeat(60)];
+        for (const r of results) {
+            lines.push(`  ${ACTION_LABEL[r.action]}  ${r.name}  ${GRAY}→ ${r.target}${RESET}`);
+        }
+        const changed = results.filter((r) => r.action === 'created' || r.action === 'updated').length;
+        const skipped = results.filter((r) => r.action === 'skipped-exists').length;
+        lines.push('', `${GRAY}${dryRun ? 'Would change' : 'Changed'} ${changed} of ${results.length}` +
+            (skipped ? `; ${skipped} skipped (local edits — re-run with --force).` : '.') +
+            `${RESET}`, '');
+        await writeStdoutLine(context.runtime, lines.join('\n'));
+    }
+};
+//# sourceMappingURL=skills.install.impl.js.map

package/dist/commands/skills/skills.install.impl.js.map

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

package/dist/commands/skills/skills.list.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLICommandAssetDescriptor } from '../../schemas/descriptors.ts';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=skills.list.descriptor.d.ts.map

package/dist/commands/skills/skills.list.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.list.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/skills.list.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE9E,QAAA,MAAM,UAAU,EAAE,yBAoBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/skills/skills.list.descriptor.js

@@ -0,0 +1,23 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'skills.list',
+    name: 'list',
+    description: 'List the tracked skills under docs/skills/ and whether each is installed locally',
+    group: 'skills',
+    arguments: [],
+    options: [
+        { flags: '--root <dir>', description: 'Repo root to operate on (default: search up from cwd)' }
+    ],
+    examples: [
+        {
+            command: 'vibes skills list',
+            description: 'Show every tracked skill mirror with its install target and status',
+            expectExit: 0
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=skills.list.descriptor.js.map

package/dist/commands/skills/skills.list.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.list.descriptor.js","sourceRoot":"","sources":["../../../src/commands/skills/skills.list.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,kFAAkF;IAC/F,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,EAAE;IACb,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,uDAAuD,EAAE;KAC/F;IACD,QAAQ,EAAE;QACT;YACC,OAAO,EAAE,mBAAmB;YAC5B,WAAW,EAAE,oEAAoE;YACjF,UAAU,EAAE,CAAC;SACb;KACD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/commands/skills/skills.list.impl.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `vibes skills list` — enumerate the tracked skill mirrors under docs/skills/
+ * and report whether each is installed locally (and whether the local copy has
+ * drifted from the tracked source).
+ */
+import type { CommandContext, CommandOptions } from '../../schemas/surface';
+declare const _default: {
+    execute(_args: CommandOptions, opts: CommandOptions, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=skills.list.impl.d.ts.map

package/dist/commands/skills/skills.list.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.list.impl.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/skills.list.impl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;;mBAqDtD,cAAc,QAAQ,cAAc,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AADnG,wBAkCE"}

package/dist/commands/skills/skills.list.impl.js

@@ -0,0 +1,69 @@
+/**
+ * `vibes skills list` — enumerate the tracked skill mirrors under docs/skills/
+ * and report whether each is installed locally (and whether the local copy has
+ * drifted from the tracked source).
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { writeJson, writeStdoutLine } from "../../commands/output.js";
+import { resolveSkillsRoot, listSkillMirrors, isInstalledCurrent, isContainedTarget, openSkillsHost, SkillsRootOptionSchema, BOLD, RESET, GREEN, YELLOW, GRAY, CYAN } from "./_skills.js";
+async function statusOf(host, root, mirror) {
+    if (!isContainedTarget(host.path, root, mirror.target))
+        return 'missing';
+    if (!(await host.fs.exists(host.path.join(root, mirror.target))))
+        return 'missing';
+    return (await isInstalledCurrent(host, root, mirror)) ? 'installed' : 'drifted';
+}
+async function renderListing(host, mirrors, root) {
+    const lines = ['', `${BOLD}Tracked skills (docs/skills/)${RESET}`, '─'.repeat(60)];
+    if (mirrors.length === 0) {
+        lines.push(`  ${GRAY}No skill mirrors found.${RESET}`, '');
+        return lines.join('\n');
+    }
+    for (const m of mirrors) {
+        const st = await statusOf(host, root, m);
+        const badge = st === 'installed'
+            ? `${GREEN}✓ installed${RESET}`
+            : st === 'drifted'
+                ? `${YELLOW}✎ drifted${RESET}`
+                : `${GRAY}· not installed${RESET}`;
+        lines.push(`  ${CYAN}${m.name}${RESET}  ${GRAY}[${m.kind}]${RESET}  ${badge}`);
+        if (m.description)
+            lines.push(`      ${GRAY}${m.description}${RESET}`);
+    }
+    lines.push('', `${GRAY}Install with: vibes skills install [name]  (--force to overwrite drifted)${RESET}`, '');
+    return lines.join('\n');
+}
+export default {
+    async execute(_args, opts, context) {
+        const cwd = context.runtime.localEnvironment.getCwd?.();
+        if (!cwd) {
+            throw new CapabilityError('No working directory available.', 'INVALID_INPUT', {
+                recoveryHint: 'The host environment did not provide a working directory.'
+            });
+        }
+        const host = await openSkillsHost(context.runtime);
+        const root = await resolveSkillsRoot(host, SkillsRootOptionSchema.parse(opts.root), cwd);
+        if (root === null) {
+            throw new CapabilityError('No docs/skills/ found.', 'INVALID_INPUT', {
+                recoveryHint: 'Run from inside the repo, or pass --root <dir>.'
+            });
+        }
+        const mirrors = await listSkillMirrors(host, root);
+        if (opts.format === 'json') {
+            const listing = [];
+            for (const m of mirrors) {
+                listing.push({
+                    name: m.name,
+                    kind: m.kind,
+                    target: m.target,
+                    description: m.description,
+                    status: await statusOf(host, root, m)
+                });
+            }
+            await writeJson(context.runtime, listing);
+            return;
+        }
+        await writeStdoutLine(context.runtime, await renderListing(host, mirrors, root));
+    }
+};
+//# sourceMappingURL=skills.list.impl.js.map

package/dist/commands/skills/skills.list.impl.js.map

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

package/dist/core/runtime/shared/context.d.ts

@@ -1,33 +1,33 @@
+import type { CliRuntimeContext } from '@vibesdotdev/cli-contracts/context';
+export type { CliRuntimeContext } from '@vibesdotdev/cli-contracts/context';
 /**
  * CLI Runtime Context Loader
  *
  * Convenience accessor for the standard CLI runtime context bundle —
  * the live `cli/ui` + `cli/logger` (with a fallback) + optional
- * `pm/client` resolved from the active `VibesRuntime`. Command
- * implementations should call this once at the top of `execute()` to
- * obtain the surfaces they need rather than calling
- * `runtime.context()` for each one.
+ * `pm/client` — resolved from the runtime the command was handed
+ * (`CommandContext.runtime`, the third argument of `execute`). Command
+ * implementations call this once at the top of `execute()` to obtain the
+ * surfaces they need rather than calling `runtime.context()` for each one.
  *
- * Canonical home per RUNTIME-FIRST-MODULES.md (`packages/cli` owns
+ * There is no ambient command context: `execute(args, options, context)`
+ * receives its own `CommandContext`, so overlapping commands and runtimes
+ * stay isolated by the argument, not by async-local state.
+ *
+ * Canonical home per RUNTIME-FIRST-MODULES.md (`cli` owns
  * "the helpers that make runtime-discovered commands usable in shells").
  * Feature packages (bridge, expert, etc.) import from
- * `@vibesdotdev/cli/core/runtime/shared/context` rather than
+ * `@vibesdotdev/cli/cli/runtime/shared/context` rather than
  * maintaining per-package copies.
  */
-import type { LoggerContext, UIContext } from '../../../providers.ts';
-type IProcessManager = unknown;
-export interface CliRuntimeContext {
-    ui: UIContext;
-    logger: LoggerContext;
-    pm?: IProcessManager;
-}
+import type { VibesRuntime } from '@vibesdotdev/kernel';
 /**
- * Resolve the standard CLI runtime context bundle.
+ * Resolve the standard CLI runtime context bundle from `runtime`, the runtime
+ * the command was handed.
  *
  * Throws if `cli/ui` is unavailable (every CLI command needs it).
  * Falls back to a logging-namespace-scoped logger if `cli/logger`
  * isn't registered. Returns `pm` only when `pm/client` is registered.
  */
-export declare function loadCliRuntimeContext(): Promise<CliRuntimeContext>;
-export {};
+export declare function loadCliRuntimeContext(runtime: VibesRuntime): Promise<CliRuntimeContext>;
 //# sourceMappingURL=context.d.ts.map

package/dist/core/runtime/shared/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/core/runtime/shared/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACtE,KAAK,eAAe,GAAG,OAAO,CAAC;AA2B/B,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,CAAC,EAAE,eAAe,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAMxE"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/core/runtime/shared/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAwBxD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAK7F"}

package/dist/core/runtime/shared/context.js

@@ -1,51 +1,36 @@
-/**
- * CLI Runtime Context Loader
- *
- * Convenience accessor for the standard CLI runtime context bundle —
- * the live `cli/ui` + `cli/logger` (with a fallback) + optional
- * `pm/client` resolved from the active `VibesRuntime`. Command
- * implementations should call this once at the top of `execute()` to
- * obtain the surfaces they need rather than calling
- * `runtime.context()` for each one.
- *
- * Canonical home per RUNTIME-FIRST-MODULES.md (`packages/cli` owns
- * "the helpers that make runtime-discovered commands usable in shells").
- * Feature packages (bridge, expert, etc.) import from
- * `@vibesdotdev/cli/core/runtime/shared/context` rather than
- * maintaining per-package copies.
- */
-import { getVibesRuntime } from '@vibesdotdev/runtime';
 import { getLogger } from '@vibesdotdev/logging';
-function fallbackLogger() {
-    const logger = getLogger('cli:runtime-context');
+import { CliLogMetaSchema } from "../../../boot/providers.js";
+/** The logging-namespace logger, with metadata normalized exactly as the `cli/logger` provider does. */
+function fallbackLogger(runtime) {
+    const logger = getLogger('cli:runtime-context', runtime);
     return {
-        info: (message, meta) => logger.info(message, meta),
-        warn: (message, meta) => logger.warn(message, meta),
-        error: (message, meta) => logger.error(message, meta),
-        debug: (message, meta) => logger.debug(message, meta)
+        info: (message, meta) => logger.info(message, CliLogMetaSchema.parse(meta)),
+        warn: (message, meta) => logger.warn(message, CliLogMetaSchema.parse(meta)),
+        error: (message, meta) => logger.error(message, CliLogMetaSchema.parse(meta)),
+        debug: (message, meta) => logger.debug(message, CliLogMetaSchema.parse(meta))
     };
 }
-async function optionalContext(id) {
-    const runtime = getVibesRuntime();
-    try {
-        return await runtime.context(id);
-    }
-    catch {
+/**
+ * A context this runtime may not register: absent only when no provider is
+ * registered for it. A registered provider that fails propagates its error.
+ */
+async function optionalContext(runtime, id) {
+    if (!runtime.hasContext(id))
         return undefined;
-    }
+    return runtime.context(id);
 }
 /**
- * Resolve the standard CLI runtime context bundle.
+ * Resolve the standard CLI runtime context bundle from `runtime`, the runtime
+ * the command was handed.
  *
  * Throws if `cli/ui` is unavailable (every CLI command needs it).
  * Falls back to a logging-namespace-scoped logger if `cli/logger`
  * isn't registered. Returns `pm` only when `pm/client` is registered.
  */
-export async function loadCliRuntimeContext() {
-    const runtime = getVibesRuntime();
+export async function loadCliRuntimeContext(runtime) {
     const ui = await runtime.context('cli/ui');
-    const logger = (await optionalContext('cli/logger')) ?? fallbackLogger();
-    const pm = await optionalContext('pm/client');
+    const logger = (await optionalContext(runtime, 'cli/logger')) ?? fallbackLogger(runtime);
+    const pm = await optionalContext(runtime, 'pm/client');
     return { ui, logger, pm };
 }
 //# sourceMappingURL=context.js.map

package/dist/core/runtime/shared/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/core/runtime/shared/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,SAAS,cAAc;IACtB,MAAM,MAAM,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAChD,OAAO;QACN,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE,CACzC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAA+B,CAAC;QACtD,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE,CACzC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAA+B,CAAC;QACtD,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE,CAC1C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAA+B,CAAC;QACvD,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE,CAC1C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAA+B,CAAC;KACvD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAI,EAAU;IAC3C,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAClC,IAAI,CAAC;QACJ,OAAO,MAAM,OAAO,CAAC,OAAO,CAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IAC1C,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAY,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,CAAC,MAAM,eAAe,CAAgB,YAAY,CAAC,CAAC,IAAI,cAAc,EAAE,CAAC;IACxF,MAAM,EAAE,GAAG,MAAM,eAAe,CAAkB,WAAW,CAAC,CAAC;IAC/D,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/core/runtime/shared/context.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAsC,MAAM,4BAA4B,CAAC;AAElG,wGAAwG;AACxG,SAAS,cAAc,CAAC,OAAqB;IAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACzD,OAAO;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3E,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3E,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7E,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;KAC7E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,eAAe,CAAI,OAAqB,EAAE,EAAU;IAClE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,OAAO,CAAC,OAAO,CAAI,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAqB;IAChE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAY,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,CAAC,MAAM,eAAe,CAAgB,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IACxG,MAAM,EAAE,GAAG,MAAM,eAAe,CAAU,OAAO,EAAE,WAAW,CAAC,CAAC;IAChE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC3B,CAAC"}

package/dist/core/runtime/shared/options.d.ts

@@ -1,20 +1,6 @@
-/**
- * CLI Option Parsers
- *
- * Pure helpers for normalizing the `Record<string, unknown>` shape that
- * Commander.js / our descriptor-driven CLI surface delivers to command
- * handlers. Every parser returns `undefined` for empty/invalid input so
- * callers can apply their own defaulting.
- *
- * Canonical home for option parsing per RUNTIME-FIRST-MODULES.md
- * (`packages/cli` owns "the helpers that make runtime-discovered
- * commands usable in shells"). Feature packages (bridge, expert, etc.)
- * import from `@vibesdotdev/cli/core/runtime/shared/options` rather
- * than maintaining per-package copies.
- */
-export declare function readString(value: unknown): string | undefined;
-export declare function readBoolean(value: unknown): boolean | undefined;
-export declare function readNumber(value: unknown): number | undefined;
-export declare function readStringArray(value: unknown): string[] | undefined;
-export declare function splitCsv(value: unknown): string[] | undefined;
+export declare function readString<Input>(value: Input): string | undefined;
+export declare function readBoolean<Input>(value: Input): boolean | undefined;
+export declare function readNumber<Input>(value: Input): number | undefined;
+export declare function readStringArray<Input>(value: Input): string[] | undefined;
+export declare function splitCsv<Input>(value: Input): string[] | undefined;
 //# sourceMappingURL=options.d.ts.map

package/dist/core/runtime/shared/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/core/runtime/shared/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI7D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAO/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAO7D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAUpE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAQ7D"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/core/runtime/shared/options.ts"],"names":[],"mappings":"AAiGA,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,CAEpE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,SAAS,CAEzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,SAAS,CAElE"}