@vibesdotdev/cli 0.0.2 → 1.0.0-rc.2

package/dist/commands/runtime/export.descriptor.d.ts

@@ -0,0 +1,55 @@
+export declare const runtimeExportCommandDescriptor: {
+    readonly id: "runtime-export";
+    readonly kind: "cli/command";
+    readonly name: "export";
+    readonly description: "Export what this runtime holds: plugins, kinds, descriptors, loaders, scope";
+    readonly group: "runtime";
+    readonly arguments: [{
+        readonly name: "path";
+        readonly description: "Destination path; relative paths resolve against the workspace root, otherwise the declared runtime cwd (same as --output)";
+    }];
+    readonly options: [{
+        readonly flags: "-o, --output <path>";
+        readonly description: "Write to this path (relative paths resolve against the workspace root, otherwise the declared runtime cwd)";
+        readonly type: "string";
+    }, {
+        readonly flags: "-f, --format <format>";
+        readonly description: "Output format: markdown | json (default: from the output extension, else markdown)";
+        readonly type: "string";
+        readonly choices: ["markdown", "json"];
+    }, {
+        readonly flags: "-k, --kind <kind>";
+        readonly description: "Restrict the descriptor detail to one kind";
+        readonly type: "string";
+    }, {
+        readonly flags: "--no-kinds";
+        readonly description: "Omit the kind section";
+        readonly type: "boolean";
+    }, {
+        readonly flags: "--no-plugins";
+        readonly description: "Omit the plugin section";
+        readonly type: "boolean";
+    }, {
+        readonly flags: "--no-descriptors";
+        readonly description: "Omit the descriptor table, keeping the counts";
+        readonly type: "boolean";
+    }, {
+        readonly flags: "-v, --verbose";
+        readonly description: "Enable verbose logging";
+        readonly type: "boolean";
+    }];
+    readonly examples: [{
+        readonly command: "vibes runtime export RUNTIME-REFERENCE.md";
+        readonly description: "Write the full reference for this workspace";
+    }, {
+        readonly command: "vibes runtime export -f json";
+        readonly description: "Print the same facts as JSON, for something that diffs them";
+    }, {
+        readonly command: "vibes runtime export --kind tools/tool";
+        readonly description: "Report one kind and every descriptor it holds";
+    }];
+    readonly surfaces: ["cli"];
+    readonly hardware: readonly ["consumer"];
+    readonly enabled: true;
+};
+//# sourceMappingURL=export.descriptor.d.ts.map

package/dist/commands/runtime/export.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.descriptor.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/export.descriptor.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDzC,CAAC"}

package/dist/commands/runtime/export.descriptor.js

@@ -0,0 +1,58 @@
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export const runtimeExportCommandDescriptor = createRuntimeAsset({
+    id: 'runtime-export',
+    kind: 'cli/command',
+    name: 'export',
+    description: 'Export what this runtime holds: plugins, kinds, descriptors, loaders, scope',
+    group: 'runtime',
+    arguments: [
+        {
+            name: 'path',
+            description: 'Destination path; relative paths resolve against the workspace root, otherwise the declared runtime cwd (same as --output)'
+        }
+    ],
+    options: [
+        {
+            flags: '-o, --output <path>',
+            description: 'Write to this path (relative paths resolve against the workspace root, otherwise the declared runtime cwd)',
+            type: 'string'
+        },
+        {
+            flags: '-f, --format <format>',
+            description: 'Output format: markdown | json (default: from the output extension, else markdown)',
+            type: 'string',
+            choices: ['markdown', 'json']
+        },
+        {
+            flags: '-k, --kind <kind>',
+            description: 'Restrict the descriptor detail to one kind',
+            type: 'string'
+        },
+        { flags: '--no-kinds', description: 'Omit the kind section', type: 'boolean' },
+        { flags: '--no-plugins', description: 'Omit the plugin section', type: 'boolean' },
+        { flags: '--no-descriptors', description: 'Omit the descriptor table, keeping the counts', type: 'boolean' },
+        {
+            flags: '-v, --verbose',
+            description: 'Enable verbose logging',
+            type: 'boolean'
+        }
+    ],
+    examples: [
+        {
+            command: 'vibes runtime export RUNTIME-REFERENCE.md',
+            description: 'Write the full reference for this workspace'
+        },
+        {
+            command: 'vibes runtime export -f json',
+            description: 'Print the same facts as JSON, for something that diffs them'
+        },
+        {
+            command: 'vibes runtime export --kind tools/tool',
+            description: 'Report one kind and every descriptor it holds'
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+});
+//# sourceMappingURL=export.descriptor.js.map

package/dist/commands/runtime/export.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.descriptor.js","sourceRoot":"","sources":["../../../src/commands/runtime/export.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,kBAAkB,CAAC;IAChE,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,6EAA6E;IAC1F,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE;QACV;YACC,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,4HAA4H;SACzI;KACD;IACD,OAAO,EAAE;QACR;YACC,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EAAE,4GAA4G;YACzH,IAAI,EAAE,QAAQ;SACd;QACD;YACC,KAAK,EAAE,uBAAuB;YAC9B,WAAW,EAAE,oFAAoF;YACjG,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;SAC7B;QACD;YACC,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EAAE,4CAA4C;YACzD,IAAI,EAAE,QAAQ;SACd;QACD,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC9E,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,yBAAyB,EAAE,IAAI,EAAE,SAAS,EAAE;QAClF,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,+CAA+C,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5G;YACC,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,wBAAwB;YACrC,IAAI,EAAE,SAAS;SACf;KACD;IACD,QAAQ,EAAE;QACT;YACC,OAAO,EAAE,2CAA2C;YACpD,WAAW,EAAE,6CAA6C;SAC1D;QACD;YACC,OAAO,EAAE,8BAA8B;YACvC,WAAW,EAAE,6DAA6D;SAC1E;QACD;YACC,OAAO,EAAE,wCAAwC;YACjD,WAAW,EAAE,+CAA+C;SAC5D;KACD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/commands/runtime/export.js

@@ -0,0 +1,28 @@
+/**
+ * `vibes runtime export [PATH]` — what this runtime actually holds.
+ *
+ * A runtime is not knowable from its source. Which plugins composed, which kinds
+ * those plugins registered, how many descriptors each kind holds, which loaders
+ * are attached and where each one came from — all of that is a property of a boot,
+ * not of a package manifest. This command reports it from the live runtime the CLI
+ * handed it, so the answer describes the process in front of you.
+ *
+ * It exports to markdown for a document a person or an agent reads, and to JSON
+ * for something that diffs. Both carry the same facts; markdown groups them the
+ * way a reader needs, JSON preserves the exact shape.
+ *
+ * Nothing here recomputes or infers. A descriptor is listed because the runtime
+ * holds it, a loader because the runtime registered it, a plugin because the
+ * runtime composed it. A kind with no descriptors is still listed: an empty
+ * catalog is evidence, not an absence.
+ *
+ * The four parts are one concern each — `schemas.ts` is what the export is,
+ * `read.ts` asks the runtime, `markdown.ts` writes the document, `write.ts` puts
+ * it on disk — and this module is the one name they are all reachable through.
+ */
+export { renderRuntimeExportMarkdown } from "./export/markdown.js";
+export { exportDescriptors, exportRuntime } from "./export/read.js";
+export { registerRuntimeExportCommand, runtimeExportOptions } from "./export/register.js";
+export { ExportDestinationSchema, RuntimeExportOptionsSchema, ScopeValueSchema } from "./export/schemas.js";
+export { resolveExportFormat, writeRuntimeExport } from "./export/write.js";
+//# sourceMappingURL=export.js.map

package/dist/commands/runtime/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/commands/runtime/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EACN,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAQhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/commands/runtime/index.d.ts

@@ -1,4 +1,4 @@
 import type { Command } from 'commander';
-import type { RuntimeContext } from '../../core/runtime/context.ts';
-export declare function registerRuntimeCommands(parent: Command, context: RuntimeContext): Promise<void>;
+import type { CommandContext } from '../../schemas/surface.ts';
+export declare function registerRuntimeCommands(parent: Command, context: CommandContext): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/commands/runtime/index.js

@@ -1,8 +1,8 @@
-import { registerRuntimeCodegenCommand } from "./codegen.js";
+import { registerRuntimeExportCommand } from "./export.js";
 export async function registerRuntimeCommands(parent, context) {
     // Create the runtime command group
     const runtimeCmd = parent.command('runtime').description('Runtime management commands');
-    // Register the codegen subcommand
-    await registerRuntimeCodegenCommand(runtimeCmd, context);
+    // Register the export subcommand
+    await registerRuntimeExportCommand(runtimeCmd, context);
 }
 //# sourceMappingURL=index.js.map

package/dist/commands/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/runtime/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,MAAe,EACf,OAAuB;IAEvB,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAC;IAExF,kCAAkC;IAClC,MAAM,6BAA6B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/runtime/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,MAAe,EACf,OAAuB;IAEvB,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAC;IAExF,iCAAiC;IACjC,MAAM,4BAA4B,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC"}

package/dist/commands/runtime/plugin.d.ts

@@ -1,2 +1,2 @@
-export declare const runtimeCliPlugin: import("@vibesdotdev/runtime").RuntimePlugin;
+export declare const runtimeCliPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/commands/runtime/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/plugin.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,8CAI3B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/commands/runtime/plugin.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,6CAI3B,CAAC"}

package/dist/commands/runtime/plugin.js

@@ -1,4 +1,4 @@
-import { createRuntimePlugin } from '@vibesdotdev/runtime';
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
 export const runtimeCliPlugin = createRuntimePlugin({
     id: 'runtime-cli',
     name: 'Runtime CLI Plugin',

package/dist/commands/runtime/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/commands/runtime/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;IACnD,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,kDAAkD;CAC/D,CAAC,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/commands/runtime/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;IACnD,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,kDAAkD;CAC/D,CAAC,CAAC"}

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

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

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

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

package/dist/commands/schemas/output.d.ts

@@ -0,0 +1,26 @@
+/** Command-output contracts: what command output reads from a runtime and the writers it resolves. */
+import * as z from 'zod/v4';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+/** What a command's output reads from the runtime it is handed. */
+export type CommandOutputRuntime = Pick<RuntimeRef, 'hasKind' | 'registerPlugin' | 'query'>;
+/** A command's text writers, resolved once from the handed runtime so status text keeps its synchronous shape. */
+export declare const CommandWritersSchema: z.ZodObject<{
+    out: z.ZodCustom<(text: string) => void, (text: string) => void>;
+    err: z.ZodCustom<(text: string) => void, (text: string) => void>;
+    log: z.ZodCustom<(line: string) => void, (line: string) => void>;
+}, z.core.$strip>;
+export type CommandWriters = z.infer<typeof CommandWritersSchema>;
+/** JSON output options and the explicit-runtime call shape command output admits. */
+export declare const OutputOptionsSchema: z.ZodObject<{
+    pretty: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type OutputOptions = z.infer<typeof OutputOptionsSchema>;
+export declare const OutputQuerySurfaceSchema: z.ZodObject<{
+    hasKind: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+    query: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
+export declare const OutputRuntimeSchema: z.ZodCustom<CommandOutputRuntime, CommandOutputRuntime>;
+export declare const OutputRuntimeFormSchema: z.ZodTuple<[z.ZodCustom<CommandOutputRuntime, CommandOutputRuntime>, z.ZodUnknown, z.ZodOptional<z.ZodObject<{
+    pretty: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>], null>;
+//# sourceMappingURL=output.d.ts.map

package/dist/commands/schemas/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/commands/schemas/output.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,mEAAmE;AACnE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,gBAAgB,GAAG,OAAO,CAAC,CAAC;AAE5F,kHAAkH;AAClH,eAAO,MAAM,oBAAoB;4BACX,MAAM,KAAK,IAAI,SAAf,MAAM,KAAK,IAAI;4BACf,MAAM,KAAK,IAAI,SAAf,MAAM,KAAK,IAAI;4BACf,MAAM,KAAK,IAAI,SAAf,MAAM,KAAK,IAAI;iBACnC,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,qFAAqF;AACrF,eAAO,MAAM,mBAAmB;;iBAA+C,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,eAAO,MAAM,wBAAwB;;;iBAA2D,CAAC;AACjG,eAAO,MAAM,mBAAmB,yDAC4D,CAAC;AAC7F,eAAO,MAAM,uBAAuB;;0BAA8E,CAAC"}

package/dist/commands/schemas/output.js

@@ -0,0 +1,14 @@
+/** Command-output contracts: what command output reads from a runtime and the writers it resolves. */
+import * as z from 'zod/v4';
+/** A command's text writers, resolved once from the handed runtime so status text keeps its synchronous shape. */
+export const CommandWritersSchema = z.object({
+    out: z.custom(value => z.function().safeParse(value).success),
+    err: z.custom(value => z.function().safeParse(value).success),
+    log: z.custom(value => z.function().safeParse(value).success)
+});
+/** JSON output options and the explicit-runtime call shape command output admits. */
+export const OutputOptionsSchema = z.object({ pretty: z.boolean().optional() });
+export const OutputQuerySurfaceSchema = z.object({ hasKind: z.function(), query: z.function() });
+export const OutputRuntimeSchema = z.custom((value) => OutputQuerySurfaceSchema.extend({ registerPlugin: z.function() }).safeParse(value).success);
+export const OutputRuntimeFormSchema = z.tuple([OutputRuntimeSchema, z.unknown(), OutputOptionsSchema.optional()]);
+//# sourceMappingURL=output.js.map

package/dist/commands/schemas/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/commands/schemas/output.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAM5B,kHAAkH;AAClH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,EAAE,CAAC,CAAC,MAAM,CAAyB,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;IACrF,GAAG,EAAE,CAAC,CAAC,MAAM,CAAyB,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;IACrF,GAAG,EAAE,CAAC,CAAC,MAAM,CAAyB,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;CACrF,CAAC,CAAC;AAGH,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAuB,CAAC,KAAK,EAAiC,EAAE,CAC1G,wBAAwB,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAC7F,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC"}

package/dist/commands/schemas/profile-environment.d.ts

@@ -0,0 +1,6 @@
+/** Profile environment command contracts. */
+/** The environment bound to this host's profile, as JSON data. */
+export interface ProfileEnvironmentSelection {
+    environment: string | null;
+}
+//# sourceMappingURL=profile-environment.d.ts.map

package/dist/commands/schemas/profile-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-environment.d.ts","sourceRoot":"","sources":["../../../src/commands/schemas/profile-environment.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,kEAAkE;AAClE,MAAM,WAAW,2BAA2B;IAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/commands/schemas/profile-environment.js

@@ -0,0 +1,3 @@
+/** Profile environment command contracts. */
+export {};
+//# sourceMappingURL=profile-environment.js.map

package/dist/commands/schemas/profile-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-environment.js","sourceRoot":"","sources":["../../../src/commands/schemas/profile-environment.ts"],"names":[],"mappings":"AAAA,6CAA6C"}

package/dist/commands/schemas/profile-list.d.ts

@@ -0,0 +1,22 @@
+/** Profile list command contracts. */
+export interface ProfileListEntry {
+    name: string;
+    environment: string | null;
+    active: boolean;
+}
+export interface ProfileListing {
+    dir: string;
+    exists: boolean;
+    active: string | undefined;
+    profiles: ProfileListEntry[];
+}
+/** The listing as JSON data: what `--json` writes and a formatter renders. */
+export interface ProfileListingData {
+    active: string | null;
+    dir: string;
+    profiles: ProfileListEntry[];
+}
+export interface ProfileListDependencies {
+    readEnvironment?: (name: string) => Promise<string | null>;
+}
+//# sourceMappingURL=profile-list.d.ts.map

package/dist/commands/schemas/profile-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-list.d.ts","sourceRoot":"","sources":["../../../src/commands/schemas/profile-list.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACvC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3D"}

package/dist/commands/schemas/profile-list.js

@@ -0,0 +1,3 @@
+/** Profile list command contracts. */
+export {};
+//# sourceMappingURL=profile-list.js.map

package/dist/commands/schemas/profile-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-list.js","sourceRoot":"","sources":["../../../src/commands/schemas/profile-list.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/dist/commands/skills/_skills.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Pure helpers for `vibes skills` — locate tracked skill mirrors under
+ * `docs/skills/`, parse their `source:` install target, and materialize them
+ * into a developer's local (gitignored) `.claude/` so the version-controlled
+ * source-of-truth can be re-installed on any machine.
+ *
+ * Mirror format (see docs/skills/README.md): each `docs/skills/<name>.md` is the
+ * original `.claude/` file verbatim with a single top-level `source:` line inserted
+ * as the first frontmatter entry. Install = strip that one line, write the rest to
+ * the recorded path — a byte-faithful round-trip with no YAML parsing of nested
+ * `arguments:` blocks.
+ *
+ * Every read and write goes through a {@link SkillsHost}: the handed runtime's
+ * filesystem kind and path mechanics (`openSkillsHost`), so the helpers stay
+ * unit-testable with any adapter and never touch the process.
+ */
+import * as z from 'zod/v4';
+import type { FileSystemAdapterInterface } from '@vibesdotdev/filesystem';
+import { type RuntimePath } from '@vibesdotdev/paths';
+import type { VibesRuntime } from '@vibesdotdev/kernel/api/runtime';
+/** The filesystem and path mechanics the skills helpers run on. */
+export interface SkillsHost {
+    readonly fs: FileSystemAdapterInterface;
+    readonly path: RuntimePath;
+}
+export declare function openSkillsHost(runtime: VibesRuntime): Promise<SkillsHost>;
+/** The `--root <dir>` option: the text given, or absent. */
+export declare const SkillsRootOptionSchema: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+/** What `parseMirror` answers. */
+export interface ParsedMirror {
+    target: string | null;
+    description: string;
+    installContent: string;
+}
+export declare const RESET = "\u001B[0m";
+export declare const BOLD = "\u001B[1m";
+export declare const GREEN = "\u001B[32m";
+export declare const YELLOW = "\u001B[33m";
+export declare const GRAY = "\u001B[90m";
+export declare const CYAN = "\u001B[36m";
+export type SkillKind = 'command' | 'skill' | 'other';
+export interface SkillMirror {
+    /** Mirror base name without `.md`, e.g. `tui-shot`. */
+    name: string;
+    /** Absolute path to the `docs/skills/<name>.md` mirror. */
+    file: string;
+    /** Repo-relative install target from the `source:` frontmatter line. */
+    target: string;
+    /** First `description:` line from the frontmatter, for listing. */
+    description: string;
+    /** Inferred from the target path. */
+    kind: SkillKind;
+}
+export type InstallAction = 'created' | 'updated' | 'unchanged' | 'skipped-exists' | 'skipped-escape' | 'no-source';
+export interface InstallResult {
+    name: string;
+    target: string;
+    action: InstallAction;
+}
+/** Walk up from `start` to the repo root (the directory containing `docs/skills`). */
+export declare function findSkillsRoot(host: SkillsHost, start: string): Promise<string | null>;
+/**
+ * Resolve the operating root: an explicit `--root <dir>` option, else the
+ * ancestor walk from `cwd`. `null` when neither yields a `docs/skills` tree —
+ * the impls project that as INVALID_INPUT. Pure (node builtins only); the
+ * caller supplies cwd so this closure stays free of the process global.
+ */
+export declare function resolveSkillsRoot(host: SkillsHost, rootOption: string | undefined, cwd: string): Promise<string | null>;
+/**
+ * True when `target` is a repo-relative path that stays inside `repoRoot`.
+ * `source:` frontmatter is version-controlled text; an absolute target or a
+ * `../` walk must never escape the repo (`join(repoRoot, '/etc/x')` IS
+ * `/etc/x` on POSIX).
+ */
+export declare function isContainedTarget(path: RuntimePath, repoRoot: string, target: string): boolean;
+/**
+ * Parse a mirror's frontmatter: pull the `source:` target + `description:`, and
+ * reconstruct the install-ready content with the (single top-level) `source:`
+ * line removed. Returns `target: null` when no frontmatter / no source line.
+ */
+export declare function parseMirror(content: string): ParsedMirror;
+/** Enumerate the tracked skill mirrors under `<repoRoot>/docs/skills/` (excludes README). */
+export declare function listSkillMirrors(host: SkillsHost, repoRoot: string): Promise<SkillMirror[]>;
+/** True when the target already exists locally with byte-identical install content. */
+export declare function isInstalledCurrent(host: SkillsHost, repoRoot: string, mirror: SkillMirror): Promise<boolean>;
+/**
+ * Materialize one mirror into its local `.claude/` target.
+ * - missing target → `created`
+ * - identical target → `unchanged` (never rewrites)
+ * - differing target → `updated` with `force`, else `skipped-exists`
+ * - target escaping `repoRoot` → `skipped-escape` (never written)
+ * `dryRun` computes the action without touching disk.
+ */
+export declare function installSkill(host: SkillsHost, repoRoot: string, mirror: SkillMirror, opts?: {
+    force?: boolean;
+    dryRun?: boolean;
+}): Promise<InstallResult>;
+//# sourceMappingURL=_skills.d.ts.map

package/dist/commands/skills/_skills.d.ts.map

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

package/dist/commands/skills/_skills.js

@@ -0,0 +1,183 @@
+/**
+ * Pure helpers for `vibes skills` — locate tracked skill mirrors under
+ * `docs/skills/`, parse their `source:` install target, and materialize them
+ * into a developer's local (gitignored) `.claude/` so the version-controlled
+ * source-of-truth can be re-installed on any machine.
+ *
+ * Mirror format (see docs/skills/README.md): each `docs/skills/<name>.md` is the
+ * original `.claude/` file verbatim with a single top-level `source:` line inserted
+ * as the first frontmatter entry. Install = strip that one line, write the rest to
+ * the recorded path — a byte-faithful round-trip with no YAML parsing of nested
+ * `arguments:` blocks.
+ *
+ * Every read and write goes through a {@link SkillsHost}: the handed runtime's
+ * filesystem kind and path mechanics (`openSkillsHost`), so the helpers stay
+ * unit-testable with any adapter and never touch the process.
+ */
+import * as z from 'zod/v4';
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem/client';
+import { getRuntimePath } from '@vibesdotdev/paths';
+export async function openSkillsHost(runtime) {
+    return { fs: await resolveFileSystemAdapter(runtime, { binding: false }), path: await getRuntimePath(runtime) };
+}
+/** A text file's contents as UTF-8. */
+async function readText(host, file) {
+    const raw = await host.fs.readFile(file, 'utf-8');
+    return raw instanceof Uint8Array ? new TextDecoder().decode(raw) : raw;
+}
+/** The `--root <dir>` option: the text given, or absent. */
+export const SkillsRootOptionSchema = z.string().optional().catch(undefined);
+// ── tiny ANSI helpers (shared by the impls; pure string constants) ───────────
+export const RESET = '\x1b[0m';
+export const BOLD = '\x1b[1m';
+export const GREEN = '\x1b[32m';
+export const YELLOW = '\x1b[33m';
+export const GRAY = '\x1b[90m';
+export const CYAN = '\x1b[36m';
+/** Walk up from `start` to the repo root (the directory containing `docs/skills`). */
+export async function findSkillsRoot(host, start) {
+    let dir = start;
+    for (;;) {
+        if (await host.fs.exists(host.path.join(dir, 'docs', 'skills')))
+            return dir;
+        const parent = host.path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * Resolve the operating root: an explicit `--root <dir>` option, else the
+ * ancestor walk from `cwd`. `null` when neither yields a `docs/skills` tree —
+ * the impls project that as INVALID_INPUT. Pure (node builtins only); the
+ * caller supplies cwd so this closure stays free of the process global.
+ */
+export async function resolveSkillsRoot(host, rootOption, cwd) {
+    const root = rootOption ?? (await findSkillsRoot(host, cwd));
+    if (!root || !(await host.fs.exists(host.path.join(root, 'docs', 'skills'))))
+        return null;
+    return root;
+}
+/**
+ * True when `target` is a repo-relative path that stays inside `repoRoot`.
+ * `source:` frontmatter is version-controlled text; an absolute target or a
+ * `../` walk must never escape the repo (`join(repoRoot, '/etc/x')` IS
+ * `/etc/x` on POSIX).
+ */
+export function isContainedTarget(path, repoRoot, target) {
+    if (path.isAbsolute(target))
+        return false;
+    const rel = path.relative(repoRoot, path.resolve(repoRoot, target));
+    return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
+}
+function inferKind(target) {
+    if (target.startsWith('.claude/commands/'))
+        return 'command';
+    if (target.startsWith('.claude/skills/'))
+        return 'skill';
+    return 'other';
+}
+/**
+ * Parse a mirror's frontmatter: pull the `source:` target + `description:`, and
+ * reconstruct the install-ready content with the (single top-level) `source:`
+ * line removed. Returns `target: null` when no frontmatter / no source line.
+ */
+export function parseMirror(content) {
+    const lines = content.split('\n');
+    if (lines[0] !== '---') {
+        return { target: null, description: '', installContent: content };
+    }
+    const close = lines.indexOf('---', 1);
+    if (close === -1) {
+        return { target: null, description: '', installContent: content };
+    }
+    let target = null;
+    let description = '';
+    const keptFrontmatter = [];
+    for (const line of lines.slice(1, close)) {
+        // Strip ONLY the top-level `source:` line (nested entries are indented).
+        const sourceMatch = line.match(/^source:\s*(.+?)\s*$/);
+        if (sourceMatch) {
+            target = sourceMatch[1];
+            continue;
+        }
+        const descMatch = line.match(/^description:\s*(.+?)\s*$/);
+        if (descMatch && !description)
+            description = descMatch[1];
+        keptFrontmatter.push(line);
+    }
+    const body = lines.slice(close + 1);
+    const installContent = ['---', ...keptFrontmatter, '---', ...body].join('\n');
+    return { target, description, installContent };
+}
+/** Enumerate the tracked skill mirrors under `<repoRoot>/docs/skills/` (excludes README). */
+export async function listSkillMirrors(host, repoRoot) {
+    const dir = host.path.join(repoRoot, 'docs', 'skills');
+    if (!(await host.fs.exists(dir)))
+        return [];
+    const mirrors = [];
+    const names = (await host.fs.list(dir)).map((entry) => entry.name).sort();
+    for (const f of names) {
+        if (!f.endsWith('.md') || f.toLowerCase() === 'readme.md')
+            continue;
+        const file = host.path.join(dir, f);
+        const { target, description } = parseMirror(await readText(host, file));
+        if (!target)
+            continue; // not a materializable mirror (no source:)
+        mirrors.push({
+            name: f.slice(0, -'.md'.length),
+            file,
+            target,
+            description,
+            kind: inferKind(target),
+        });
+    }
+    return mirrors;
+}
+/** True when the target already exists locally with byte-identical install content. */
+export async function isInstalledCurrent(host, repoRoot, mirror) {
+    if (!isContainedTarget(host.path, repoRoot, mirror.target))
+        return false;
+    const abs = host.path.join(repoRoot, mirror.target);
+    if (!(await host.fs.exists(abs)))
+        return false;
+    const { installContent } = parseMirror(await readText(host, mirror.file));
+    return (await readText(host, abs)) === installContent;
+}
+/**
+ * Materialize one mirror into its local `.claude/` target.
+ * - missing target → `created`
+ * - identical target → `unchanged` (never rewrites)
+ * - differing target → `updated` with `force`, else `skipped-exists`
+ * - target escaping `repoRoot` → `skipped-escape` (never written)
+ * `dryRun` computes the action without touching disk.
+ */
+export async function installSkill(host, repoRoot, mirror, opts = {}) {
+    const { target, installContent } = parseMirror(await readText(host, mirror.file));
+    if (!target)
+        return { name: mirror.name, target: mirror.target, action: 'no-source' };
+    if (!isContainedTarget(host.path, repoRoot, target)) {
+        return { name: mirror.name, target, action: 'skipped-escape' };
+    }
+    const abs = host.path.join(repoRoot, target);
+    const exists = await host.fs.exists(abs);
+    let action;
+    if (!exists) {
+        action = 'created';
+    }
+    else if ((await readText(host, abs)) === installContent) {
+        action = 'unchanged';
+    }
+    else if (opts.force) {
+        action = 'updated';
+    }
+    else {
+        action = 'skipped-exists';
+    }
+    if (!opts.dryRun && (action === 'created' || action === 'updated')) {
+        await host.fs.mkdir(host.path.dirname(abs), { recursive: true });
+        await host.fs.writeFile(abs, installContent);
+    }
+    return { name: mirror.name, target, action };
+}
+//# sourceMappingURL=_skills.js.map