@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.3

package/dist/cli/commands/tools.run.command.impl.js

@@ -0,0 +1,272 @@
+/**
+ * `vibes tools run` implementation — surface over @vibesdotdev/tools.
+ * The feature-prefixed filename pairs with its globally unique descriptor stem.
+ * Project-local `.vibes/tools` come from the boot's discovery pass (reported by
+ * localToolsOf).
+ * Resolves tool ids the same way as inspect (local: aliases, query+assets).
+ */
+import * as z from 'zod/v4';
+import { requestCLIExit } from '@vibesdotdev/cli/providers';
+import { CapabilityError, isCapabilityError } from '@vibesdotdev/kernel';
+import { JsonObjectSchema, JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { toolPurposeAllows } from '@vibesdotdev/tools/kinds/tool';
+import { invokeTool } from '@vibesdotdev/tools/execution/invoke';
+import { ToolInputValidationError, validateToolInput } from '@vibesdotdev/tools/execution/input-validation';
+import { emitLocalToolsNotices, localToolsOf } from '@vibesdotdev/tools/local/node/ensure-local-tools';
+import { extractExExampleFromMcpDescription } from '@vibesdotdev/tools/local/extract-ex-example';
+import * as yaml from 'yaml';
+import { attempt, attemptSync } from "../../shared/attempt.js";
+import { openCommandOutput } from "../shared/command-io.js";
+import { parseCommandInput } from "../shared/command-input.js";
+import { listRegisteredToolIds, resolveRegisteredTool, suggestSimilarToolIds } from "./resolve-tool.js";
+import { parseRequestedToolPurpose } from "./requested-purpose.js";
+import { RunArgsSchema, RunOptionsSchema } from "./schemas/tools-run.js";
+import { callerFromRuntimeScope, invokeToolAsCaller } from '@vibesdotdev/tools/execution';
+// Re-export for unit tests that imported from this module.
+export { extractExExampleFromMcpDescription };
+const COMMAND = 'tools run';
+/** The text of a thrown tool failure that crossed a package boundary without `instanceof` holding. */
+const CrossedValidationFailureSchema = z.looseObject({
+    name: z.literal('ToolInputValidationError'),
+    issues: z.array(z.looseObject({
+        path: z.array(z.union([z.string(), z.number()])).optional().catch(undefined),
+        message: z.string().optional().catch(undefined)
+    }))
+});
+/** What a tool answers on a run: the shapes `outputResult` prints. */
+const ContentResultSchema = z.looseObject({ content: JsonValueSchema });
+/** The `--input` JSON: any JSON value, handed to the tool's own input validation. */
+const JsonInputSchema = JsonValueSchema;
+/** The caller a run is made as; the tools execution package owns it (`@vibesdotdev/tools/execution`). */
+export { callerFromRuntimeScope };
+/**
+ * stderr lines when `--purpose` and a purpose-locked tool disagree; null when
+ * the tool may run. The CLI declares the purpose `tools run --purpose` names
+ * at boot (rc02-rc03 C7), so on the CLI the two agree; a host that declared
+ * another purpose (an embedding host that calls this command) is refused
+ * rather than re-declared. Pure for unit tests.
+ */
+export function toolPurposeRefusal(toolId, descriptor, requested, hostPurpose) {
+    const locked = (descriptor.purpose ?? []).join(', ');
+    if (!toolPurposeAllows(descriptor, requested)) {
+        return [
+            `Tool "${toolId}" is locked to purpose(s) ${locked}; the requested purpose "${requested}" does not unlock it.`
+        ];
+    }
+    if (!toolPurposeAllows(descriptor, hostPurpose)) {
+        return [
+            `Tool "${toolId}" is locked to purpose(s) ${locked}; this host declares purpose "${hostPurpose}".`,
+            'Nothing re-declares a running host. Run it as `vibes tools run --purpose <p>`, which declares that purpose at boot, or from a host that declares one of those purposes (for example the MCP server).'
+        ];
+    }
+    return null;
+}
+/**
+ * stderr lines when a tool ID is not registered. Project-local tools are
+ * whatever the boot's discovery pass registered from `.vibes/tools`; a
+ * discovery failure already failed the boot, so there is none to report here.
+ */
+export function toolNotFoundMessages(toolId, opts = {}) {
+    const messages = [`Tool not found: ${toolId}`, 'Run "vibes tools list" to see available tools.'];
+    const catalog = [...(opts.catalogIds ?? []), ...(opts.local?.toolIds ?? [])];
+    const suggestions = suggestSimilarToolIds(toolId, catalog);
+    if (suggestions.length > 0) {
+        messages.push(`Did you mean: ${suggestions.join(', ')}?`);
+    }
+    if (opts.local?.status === 'loaded') {
+        messages.push(`Discovered ${opts.local.toolIds.length} local tool(s) in .vibes/tools; "${toolId}" was not among them.`);
+    }
+    return messages;
+}
+/**
+ * Human-facing stderr lines for a failed tools run.
+ * Validation failures list issues + inspect/dry-run recovery (end-user DX).
+ * Pure for unit tests — no process.exit.
+ */
+export function formatToolRunFailureMessages(failure, opts) {
+    const toolId = opts.toolId;
+    const lines = [];
+    if (failure instanceof ToolInputValidationError) {
+        lines.push(`Tool input validation failed for "${toolId}":`);
+        for (const issue of failure.issues) {
+            const where = issue.path.length > 0 ? issue.path.join('.') : '<root>';
+            lines.push(`  - ${where}: ${issue.message}`);
+        }
+        if (failure.issues.length === 0) {
+            lines.push(`  - ${failure.message}`);
+        }
+        lines.push(`Inspect schema: vibes tools inspect ${toolId}`);
+        lines.push(`Preview without running: vibes tools run ${toolId} --dry-run --input '{"…"}'`);
+        return lines;
+    }
+    // Structural match when the failure crossed package boundaries without instanceof.
+    const crossed = CrossedValidationFailureSchema.safeParse(failure);
+    if (crossed.success) {
+        lines.push(`Tool input validation failed for "${toolId}":`);
+        for (const issue of crossed.data.issues) {
+            const path = issue.path ? issue.path.join('.') : '<root>';
+            lines.push(`  - ${path || '<root>'}: ${issue.message ?? 'Invalid input'}`);
+        }
+        lines.push(`Inspect schema: vibes tools inspect ${toolId}`);
+        lines.push(`Preview without running: vibes tools run ${toolId} --dry-run --input '{"…"}'`);
+        return lines;
+    }
+    lines.push(`Tool execution failed: ${failure instanceof Error ? failure.message : failure.description}`);
+    const hint = isCapabilityError(failure) ? failure.recoveryHint : undefined;
+    if (hint)
+        lines.push(`Hint: ${hint}`);
+    return lines;
+}
+/**
+ * What a failed run prints on stdout for a machine reader: with `--format json`, the refusal's
+ * typed facts as the runtime's CapabilityError envelope (an untyped failure as its value-free
+ * INTERNAL form), so a caller in another process keeps its reason and details; otherwise nothing.
+ */
+export function toolRunRefusalDocument(failure, format) {
+    return format === 'json' ? JSON.stringify(CapabilityError.from(failure).toEnvelope(), null, 2) : undefined;
+}
+/**
+ * When the user omitted --input and the descriptor schema rejects `{}`,
+ * emit a pre-flight message before invoke (clearer than a raw validation dump).
+ * Pure — returns null when empty input is valid or no schema is declared.
+ * Ex: examples come from shared extractExExampleFromMcpDescription (feature package).
+ */
+export function formatEmptyInputPreflightMessages(opts) {
+    const inputSchema = opts.descriptor.schemas?.input;
+    if (inputSchema == null)
+        return null;
+    const result = validateToolInput(opts.runtime, inputSchema, {});
+    if (result.ok)
+        return null;
+    const example = extractExExampleFromMcpDescription(opts.descriptor.mcpDescription) ?? '{"action":"…","…":"…"}';
+    return [
+        `Tool "${opts.toolId}" requires input — no --input was provided.`,
+        `Example: vibes tools run ${opts.toolId} --input '${example}'`,
+        `Inspect schema: vibes tools inspect ${opts.toolId}`,
+        `Preview: vibes tools run ${opts.toolId} --dry-run --input '${example}'`
+    ];
+}
+export default {
+    async execute(rawArgs, rawOptions, context) {
+        const { toolId } = parseCommandInput(RunArgsSchema, rawArgs, COMMAND);
+        const options = parseCommandInput(RunOptionsSchema, rawOptions, COMMAND);
+        const runtime = context.runtime;
+        const out = await openCommandOutput(runtime);
+        // The requested purpose is this call's argument (`scope-invalid` for an
+        // unknown one); the host's declared scope is never patched.
+        const purpose = parseRequestedToolPurpose(options.purpose);
+        const local = localToolsOf(runtime);
+        emitLocalToolsNotices(local);
+        const resolved = resolveRegisteredTool(runtime, toolId);
+        if (!resolved || resolved.source !== 'tools/tool') {
+            // ai/tool is inspect-visible but not invokable via tools/tool invoke path.
+            const catalogIds = [...listRegisteredToolIds(runtime), ...local.toolIds];
+            for (const line of toolNotFoundMessages(toolId, { local, catalogIds })) {
+                out.errorLine(line);
+            }
+            if (resolved?.source === 'ai/tool') {
+                out.errorLine(`Note: "${resolved.id}" is registered as ai/tool (custom), not tools/tool — vibes tools run only invokes tools/tool.`);
+            }
+            requestCLIExit(1);
+        }
+        const toolDesc = resolved.descriptor;
+        const resolvedId = resolved.id;
+        if (resolved.aliased) {
+            out.errorLine(`Resolved "${toolId}" → "${resolvedId}"`);
+        }
+        if (purpose) {
+            const refusal = toolPurposeRefusal(resolvedId, toolDesc, purpose, runtime.declaredScope.purpose);
+            if (refusal) {
+                for (const line of refusal)
+                    out.errorLine(line);
+                requestCLIExit(1);
+            }
+        }
+        let input = {};
+        if (options.input) {
+            const parsed = attemptSync(() => JsonInputSchema.parse(JSON.parse(options.input ?? '')));
+            if (parsed.ok) {
+                input = parsed.value;
+            }
+            else {
+                if (!(parsed.failure instanceof SyntaxError))
+                    throw parsed.failure;
+                out.errorLine('Invalid JSON input. Use: --input \'{"key": "value"}\'');
+                out.errorLine(`Tip: vibes tools inspect ${resolvedId}  # shows input schema`);
+                out.errorLine(`     vibes tools run ${resolvedId} --dry-run --input '{…}'`);
+                requestCLIExit(1);
+            }
+        }
+        if (options.dryRun) {
+            const { systemToolSchemaToJsonSchema } = await import('@vibesdotdev/tools/schemas/system-tools');
+            out.line(`Tool: ${resolvedId}`);
+            out.line(`Description: ${toolDesc.description ?? 'No description'}`);
+            if (toolDesc.mcpDescription && toolDesc.mcpDescription.length > 0) {
+                out.line(`MCP description: ${toolDesc.mcpDescription}`);
+            }
+            out.line(`Input: ${JSON.stringify(input, null, 2)}`);
+            if (toolDesc.schemas?.input) {
+                const projected = systemToolSchemaToJsonSchema(toolDesc.schemas.input);
+                out.line(`Expected Schema: ${JSON.stringify(projected ?? {}, null, 2)}`);
+                if (projected && projected['x-vibes-schema-degraded'] === true) {
+                    out.errorLine('⚠ Schema projection degraded — constraints may be incomplete. Inspect the tool descriptor source.');
+                }
+            }
+            else {
+                out.line('Expected Schema: (none declared — open object)');
+            }
+            return;
+        }
+        // Pre-flight: empty --input against a required schema → clear next step
+        // before invoke (uses same validateToolInput as the invoke boundary).
+        const omittedInput = options.input === undefined;
+        if (omittedInput && toolDesc.schemas?.input) {
+            const preflight = formatEmptyInputPreflightMessages({
+                runtime,
+                toolId: resolvedId,
+                descriptor: toolDesc
+            });
+            if (preflight) {
+                for (const line of preflight)
+                    out.errorLine(line);
+                requestCLIExit(1);
+            }
+        }
+        const run = await attempt(() => invokeToolAsCaller(runtime, {
+            toolId: resolvedId, input, callId: `cli_run_${Date.now()}_${crypto.randomUUID()}`, loggerId: 'tools:cli:run',
+            session: options.session, participant: options.participant, agent: options.agent,
+            metadata: options.metadata === undefined ? undefined : JsonObjectSchema.parse(JSON.parse(options.metadata))
+        }));
+        if (!run.ok) {
+            for (const line of formatToolRunFailureMessages(run.failure, { toolId: resolvedId })) {
+                out.errorLine(line);
+            }
+            const refusal = toolRunRefusalDocument(run.failure, options.format);
+            if (refusal !== undefined)
+                out.line(refusal);
+            requestCLIExit(1);
+        }
+        out.line(formatResult(run.value, options.format ?? 'raw'));
+    }
+};
+/** A tool's answer as the text a run prints in `format`. */
+function formatResult(data, format) {
+    switch (format) {
+        case 'json':
+            return JSON.stringify(data, null, 2);
+        case 'yaml':
+            return yaml.stringify(data);
+        case 'raw': {
+            const text = z.string().safeParse(data);
+            if (text.success)
+                return text.data;
+            const content = ContentResultSchema.safeParse(data);
+            if (content.success) {
+                const body = z.string().safeParse(content.data.content);
+                return body.success ? body.data : JSON.stringify(content.data.content, null, 2);
+            }
+            return JSON.stringify(data, null, 2);
+        }
+    }
+}
+//# sourceMappingURL=tools.run.command.impl.js.map

package/dist/cli/commands/tools.run.command.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.run.command.impl.js","sourceRoot":"","sources":["../../../src/cli/commands/tools.run.command.impl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EACN,eAAe,EACf,iBAAiB,EAIjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAkB,MAAM,kCAAkC,CAAC;AAErG,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EACjB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACN,qBAAqB,EACrB,YAAY,EAEZ,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EAErB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAiC,MAAM,wBAAwB,CAAC;AACxG,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAE1F,2DAA2D;AAC3D,OAAO,EAAE,kCAAkC,EAAE,CAAC;AAE9C,MAAM,OAAO,GAAG,WAAW,CAAC;AAI5B,sGAAsG;AACtG,MAAM,8BAA8B,GAAG,CAAC,CAAC,WAAW,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,WAAW,CAAC;QACb,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;KAC/C,CAAC,CACF;CACD,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;AAExE,qFAAqF;AACrF,MAAM,eAAe,GAAG,eAAe,CAAC;AAMxC,yGAAyG;AACzG,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CACjC,MAAc,EACd,UAAsE,EACtE,SAAyB,EACzB,WAA2B;IAE3B,MAAM,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC;QAC/C,OAAO;YACN,SAAS,MAAM,6BAA6B,MAAM,4BAA4B,SAAS,uBAAuB;SAC9G,CAAC;IACH,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;QACjD,OAAO;YACN,SAAS,MAAM,6BAA6B,MAAM,iCAAiC,WAAW,IAAI;YAClG,sMAAsM;SACtM,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CACnC,MAAc,EACd,OAII,EAAE;IAEN,MAAM,QAAQ,GAAG,CAAC,mBAAmB,MAAM,EAAE,EAAE,gDAAgD,CAAC,CAAC;IAEjG,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CACZ,cAAc,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,oCAAoC,MAAM,uBAAuB,CACxG,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAsB,EAAE,IAAwB;IAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,OAAO,YAAY,wBAAwB,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,qCAAqC,MAAM,IAAI,CAAC,CAAC;QAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,4CAA4C,MAAM,4BAA4B,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC;IACd,CAAC;IAED,mFAAmF;IACnF,MAAM,OAAO,GAAG,8BAA8B,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,qCAAqC,MAAM,IAAI,CAAC,CAAC;QAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,4CAA4C,MAAM,4BAA4B,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,0BAA0B,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACzG,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAsB,EAAE,MAA4B;IAC1F,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,IAKjD;IACA,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC;IACnD,IAAI,WAAW,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,OAAO,GACZ,kCAAkC,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,wBAAwB,CAAC;IAChG,OAAO;QACN,SAAS,IAAI,CAAC,MAAM,6CAA6C;QACjE,4BAA4B,IAAI,CAAC,MAAM,aAAa,OAAO,GAAG;QAC9D,uCAAuC,IAAI,CAAC,MAAM,EAAE;QACpD,4BAA4B,IAAI,CAAC,MAAM,uBAAuB,OAAO,GAAG;KACxE,CAAC;AACH,CAAC;AAED,eAAe;IACd,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,UAAsB,EAAE,OAAuB;QAC9E,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,iBAAiB,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC7C,wEAAwE;QACxE,4DAA4D;QAC5D,MAAM,OAAO,GAAG,yBAAyB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE3D,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACpC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAE7B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACnD,2EAA2E;YAC3E,MAAM,UAAU,GAAG,CAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;YACzE,KAAK,MAAM,IAAI,IAAI,oBAAoB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;gBACxE,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YACD,IAAI,QAAQ,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;gBACpC,GAAG,CAAC,SAAS,CACZ,UAAU,QAAQ,CAAC,EAAE,gGAAgG,CACrH,CAAC;YACH,CAAC;YACD,cAAc,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC;QACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,GAAG,CAAC,SAAS,CAAC,aAAa,MAAM,QAAQ,UAAU,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACjG,IAAI,OAAO,EAAE,CAAC;gBACb,KAAK,MAAM,IAAI,IAAI,OAAO;oBAAE,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAChD,cAAc,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;QACF,CAAC;QAED,IAAI,KAAK,GAAc,EAAE,CAAC;QAE1B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACzF,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACP,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,WAAW,CAAC;oBAAE,MAAM,MAAM,CAAC,OAAO,CAAC;gBACnE,GAAG,CAAC,SAAS,CAAC,uDAAuD,CAAC,CAAC;gBACvE,GAAG,CAAC,SAAS,CAAC,4BAA4B,UAAU,wBAAwB,CAAC,CAAC;gBAC9E,GAAG,CAAC,SAAS,CAAC,wBAAwB,UAAU,0BAA0B,CAAC,CAAC;gBAC5E,cAAc,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;QACF,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,EAAE,4BAA4B,EAAE,GACrC,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAC;YACzD,GAAG,CAAC,IAAI,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,WAAW,IAAI,gBAAgB,EAAE,CAAC,CAAC;YACrE,IAAI,QAAQ,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACrD,IAAI,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;gBAC7B,MAAM,SAAS,GAAG,4BAA4B,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACvE,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBACzE,IAAI,SAAS,IAAI,SAAS,CAAC,yBAAyB,CAAC,KAAK,IAAI,EAAE,CAAC;oBAChE,GAAG,CAAC,SAAS,CACZ,mGAAmG,CACnG,CAAC;gBACH,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAC5D,CAAC;YACD,OAAO;QACR,CAAC;QAED,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC;QACjD,IAAI,YAAY,IAAI,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,iCAAiC,CAAC;gBACnD,OAAO;gBACP,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,QAAQ;aACpB,CAAC,CAAC;YACH,IAAI,SAAS,EAAE,CAAC;gBACf,KAAK,MAAM,IAAI,IAAI,SAAS;oBAAE,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAClD,cAAc,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;QACF,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAY,OAAO,EAAE;YACtE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,eAAe;YAC5G,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;YAChF,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;SAC3G,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACb,KAAK,MAAM,IAAI,IAAI,4BAA4B,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;gBACtF,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACpE,IAAI,OAAO,KAAK,SAAS;gBAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7C,cAAc,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;CACD,CAAC;AAEF,4DAA4D;AAC5D,SAAS,YAAY,CAAC,IAAe,EAAE,MAA+B;IACrE,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,MAAM;YACV,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtC,KAAK,MAAM;YACV,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,KAAK,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC;YACnC,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACxD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACjF,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/cli/dev.descriptor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Dev CLI Group Descriptor
+ *
+ * Root group for development tools and utilities.
+ */
+import type { CLIGroupAssetDescriptor } from '@vibesdotdev/cli/schemas/descriptors';
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=dev.descriptor.d.ts.map

package/dist/cli/dev.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/dev.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,QAAA,MAAM,UAAU,EAAE,uBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/dev.descriptor.js

@@ -0,0 +1,16 @@
+/**
+ * Dev CLI Group Descriptor
+ *
+ * Root group for development tools and utilities.
+ */
+const descriptor = {
+    kind: 'cli/group',
+    id: 'dev',
+    name: 'dev',
+    description: 'Development tools and utilities',
+    surfaces: ['cli'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=dev.descriptor.js.map

package/dist/cli/dev.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.descriptor.js","sourceRoot":"","sources":["../../src/cli/dev.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,iCAAiC;IAC9C,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logging/cli.logger.descriptor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI Logger Descriptor
+ */
+import type { LoggerDescriptor } from '@vibesdotdev/logging';
+declare const descriptor: LoggerDescriptor;
+export default descriptor;
+//# sourceMappingURL=cli.logger.descriptor.d.ts.map

package/dist/cli/logging/cli.logger.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.logger.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/logging/cli.logger.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,QAAA,MAAM,UAAU,EAAE,gBAOjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/logging/cli.logger.descriptor.js

@@ -0,0 +1,13 @@
+/**
+ * CLI Logger Descriptor
+ */
+const descriptor = {
+    kind: 'logging/logger',
+    id: 'cli',
+    namespace: 'cli',
+    runtime: 'cli',
+    sinks: ['console'],
+    level: 'info'
+};
+export default descriptor;
+//# sourceMappingURL=cli.logger.descriptor.js.map

package/dist/cli/logging/cli.logger.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.logger.descriptor.js","sourceRoot":"","sources":["../../../src/cli/logging/cli.logger.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,GAAqB;IACpC,IAAI,EAAE,gBAAgB;IACtB,EAAE,EAAE,KAAK;IACT,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/schemas/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CLI Schemas
+ */
+export interface RunOptions {
+    input?: string;
+    format?: 'json' | 'yaml' | 'raw';
+    dryRun?: boolean;
+}
+export interface InitOptions {
+    example?: boolean;
+}
+export interface ListOptions {
+    category?: string;
+    /** Only project tools from .vibes/tools (tools list --local). */
+    localOnly?: boolean;
+    scope?: string;
+    json?: boolean;
+}
+export interface ScanOptions {
+    load?: boolean;
+    json?: boolean;
+    /** Exit non-zero / throw when any descriptor file failed to load. */
+    strict?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAGD,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/cli/schemas/index.js

@@ -0,0 +1,5 @@
+/**
+ * CLI Schemas
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/cli/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli/shared/command-input.d.ts

@@ -0,0 +1,4 @@
+import * as z from 'zod/v4';
+/** Parse a command's arguments or options with its schema; refuse typed. */
+export declare function parseCommandInput<Schema extends z.ZodType, Input>(schema: Schema, input: Input, command: string): z.output<Schema>;
+//# sourceMappingURL=command-input.d.ts.map

package/dist/cli/shared/command-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-input.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/command-input.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAQ5B,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAUlI"}

package/dist/cli/shared/command-input.js

@@ -0,0 +1,29 @@
+/**
+ * A tools command's arguments and options are untrusted input from the CLI
+ * surface. Every command reads them once, through `parseCommandInput`: a bad
+ * shape, a throwing getter or a trapping Proxy all end as one typed refusal,
+ * `INVALID_INPUT` `command-input-invalid`, naming the command and the
+ * offending fields (never their values).
+ */
+import { parseUntrusted } from '@vibesdotdev/filesystem/core';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+/** The issue paths a Zod failure names; any other cause names the whole input. */
+function failingFields(cause) {
+    if (!(cause instanceof z.ZodError))
+        return ['(input)'];
+    return [...new Set(cause.issues.map((issue) => issue.path.join('.') || '(input)'))];
+}
+/** Parse a command's arguments or options with its schema; refuse typed. */
+export function parseCommandInput(schema, input, command) {
+    return parseUntrusted(schema, input, (cause) => {
+        const fields = failingFields(cause);
+        return new CapabilityError(`${command}: invalid arguments or options (${fields.join(', ')}).`, 'INVALID_INPUT', {
+            reason: 'command-input-invalid',
+            retryable: false,
+            details: { command, fields },
+            cause
+        });
+    });
+}
+//# sourceMappingURL=command-input.js.map

package/dist/cli/shared/command-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-input.js","sourceRoot":"","sources":["../../../src/cli/shared/command-input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,kFAAkF;AAClF,SAAS,aAAa,CAAC,KAAY;IAClC,IAAI,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAkC,MAAc,EAAE,KAAY,EAAE,OAAe;IAC/G,OAAO,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,IAAI,eAAe,CAAC,GAAG,OAAO,mCAAmC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE;YAC/G,MAAM,EAAE,uBAAuB;YAC/B,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;YAC5B,KAAK;SACL,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/cli/shared/command-io.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Where a `vibes tools` command writes what it reports.
+ *
+ * Output goes through the handed runtime's selected host text output
+ * (`runtime/stdio`), never the process console: results on stdout,
+ * diagnostics on stderr. A host without text output refuses `UNAVAILABLE`
+ * `stdio-unavailable` before the command writes.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+export interface CommandOutput {
+    /** `text` and a newline on stdout; with no text, an empty line. */
+    line(text?: string): void;
+    /** `text` and a newline on stderr: a diagnostic, never a result. */
+    errorLine(text: string): void;
+}
+/** Resolve the handed runtime's host text output for one command run. */
+export declare function openCommandOutput(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>): Promise<CommandOutput>;
+//# sourceMappingURL=command-io.d.ts.map

package/dist/cli/shared/command-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-io.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/command-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC7B,mEAAmE;IACnE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,yEAAyE;AACzE,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAM9G"}

package/dist/cli/shared/command-io.js

@@ -0,0 +1,18 @@
+/**
+ * Where a `vibes tools` command writes what it reports.
+ *
+ * Output goes through the handed runtime's selected host text output
+ * (`runtime/stdio`), never the process console: results on stdout,
+ * diagnostics on stderr. A host without text output refuses `UNAVAILABLE`
+ * `stdio-unavailable` before the command writes.
+ */
+import { getRuntimeStdio } from '@vibesdotdev/kernel';
+/** Resolve the handed runtime's host text output for one command run. */
+export async function openCommandOutput(runtime) {
+    const stdio = await getRuntimeStdio(runtime);
+    return {
+        line: (text = '') => stdio.write('stdout', `${text}\n`),
+        errorLine: (text) => stdio.write('stderr', `${text}\n`)
+    };
+}
+//# sourceMappingURL=command-io.js.map

package/dist/cli/shared/command-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-io.js","sourceRoot":"","sources":["../../../src/cli/shared/command-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AASvE,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA8C;IACrF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO;QACN,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC;QACvD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC;KACvD,CAAC;AACH,CAAC"}

package/dist/cli/tools-group.descriptor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tools CLI Group Descriptor
+ *
+ * Root group for `vibes tools *` commands. Lives in the canonical
+ * in-package `{feature}/cli` export.
+ */
+import type { CLIGroupAssetDescriptor } from '@vibesdotdev/cli/schemas/descriptors';
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=tools-group.descriptor.d.ts.map

package/dist/cli/tools-group.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-group.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/tools-group.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,QAAA,MAAM,UAAU,EAAE,uBASjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/tools-group.descriptor.js

@@ -0,0 +1,18 @@
+/**
+ * Tools CLI Group Descriptor
+ *
+ * Root group for `vibes tools *` commands. Lives in the canonical
+ * in-package `{feature}/cli` export.
+ */
+const descriptor = {
+    kind: 'cli/group',
+    id: 'tools',
+    name: 'tools',
+    description: 'Manage tool descriptors',
+    surfaces: ['cli'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true,
+    order: 50
+};
+export default descriptor;
+//# sourceMappingURL=tools-group.descriptor.js.map

package/dist/cli/tools-group.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-group.descriptor.js","sourceRoot":"","sources":["../../src/cli/tools-group.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,yBAAyB;IACtC,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,EAAE;CACT,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/tools.cli.descriptors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Residual `vibes dev` CLI descriptors (pure metadata, no impl).
+ *
+ * Primary `vibes tools` catalog (list/inspect/run/scan/init/export/agents)
+ * lives in `@vibesdotdev/tools/cli`. Work CLI descriptors live in
+ * `@vibesdotdev/projects/work/cli`.
+ *
+ * These are PURE metadata (no impl, no Node/Bun). Two plugins compose this array:
+ *   - `tools.cli.plugin`            - residual CLI surface + lazy impl loaders
+ *   - `tools.cli.descriptors.plugin` - descriptors only, registerable in any
+ *                                     scope so web/cloud can ENUMERATE residual
+ *                                     commands without importing impls.
+ */
+/** Residual `vibes dev` catalog for cross-scope enumeration. */
+export declare const toolsCliDescriptors: readonly [import("@vibesdotdev/cli-contracts/descriptors").CLIGroupAssetDescriptor, import("@vibesdotdev/kernel").CLIGroupAssetDescriptor, import("@vibesdotdev/kernel").CLICommandAssetDescriptor, import("@vibesdotdev/cli-contracts/descriptors").CLIGroupAssetDescriptor, import("@vibesdotdev/cli-contracts/descriptors").CLICommandAssetDescriptor];
+//# sourceMappingURL=tools.cli.descriptors.d.ts.map

package/dist/cli/tools.cli.descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.cli.descriptors.d.ts","sourceRoot":"","sources":["../../src/cli/tools.cli.descriptors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,2VAMtB,CAAC"}

package/dist/cli/tools.cli.descriptors.js

@@ -0,0 +1,29 @@
+/**
+ * Residual `vibes dev` CLI descriptors (pure metadata, no impl).
+ *
+ * Primary `vibes tools` catalog (list/inspect/run/scan/init/export/agents)
+ * lives in `@vibesdotdev/tools/cli`. Work CLI descriptors live in
+ * `@vibesdotdev/projects/work/cli`.
+ *
+ * These are PURE metadata (no impl, no Node/Bun). Two plugins compose this array:
+ *   - `tools.cli.plugin`            - residual CLI surface + lazy impl loaders
+ *   - `tools.cli.descriptors.plugin` - descriptors only, registerable in any
+ *                                     scope so web/cloud can ENUMERATE residual
+ *                                     commands without importing impls.
+ */
+// Dev top-level group + code sub-groups
+import devGroup from "./dev.descriptor.js";
+import devCodeDepsGroup from "./code/deps/dev.code.deps.cli-group.descriptor.js";
+import depsAnalyze from "./code/deps/deps.analyze.cli-command.descriptor.js";
+// Dev audit sub-group + commands
+import devAuditGroup from "./audit-ledger/dev.audit.cli-group.descriptor.js";
+import devAuditLedger from "./audit-ledger/dev.audit.ledger.cli-command.descriptor.js";
+/** Residual `vibes dev` catalog for cross-scope enumeration. */
+export const toolsCliDescriptors = [
+    devGroup,
+    devCodeDepsGroup,
+    depsAnalyze,
+    devAuditGroup,
+    devAuditLedger
+];
+//# sourceMappingURL=tools.cli.descriptors.js.map

package/dist/cli/tools.cli.descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.cli.descriptors.js","sourceRoot":"","sources":["../../src/cli/tools.cli.descriptors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wCAAwC;AACxC,OAAO,QAAQ,MAAM,qBAAqB,CAAC;AAC3C,OAAO,gBAAgB,MAAM,mDAAmD,CAAC;AACjF,OAAO,WAAW,MAAM,oDAAoD,CAAC;AAE7E,iCAAiC;AACjC,OAAO,aAAa,MAAM,kDAAkD,CAAC;AAC7E,OAAO,cAAc,MAAM,2DAA2D,CAAC;AAEvF,gEAAgE;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,QAAQ;IACR,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,cAAc;CACL,CAAC"}

package/dist/cli/tools.cli.descriptors.plugin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tools CLI Descriptors Plugin - descriptor-only, scope-safe.
+ *
+ * Registers the `vibes dev` / `vibes tools` / `vibes work` cli/group + cli/command
+ * DESCRIPTORS with NO impl loaders. Unlike `tools.cli.plugin` (the executable CLI
+ * surface, CLI scope only), this plugin imports zero command implementations, so
+ * it is safe to compose into a web/cloud/worker runtime purely to make the CLI
+ * command catalog enumerable cross-scope:
+ *
+ *   runtime.query('cli/command').descriptors()  // the full command list
+ *   runtime.query('cli/group').descriptors()
+ *
+ * Depends on `cli-kinds` (`@vibesdotdev/cli/kinds`) for the kind registration -
+ * compose that plugin first. In a CLI runtime the kinds come from `cli.plugin`
+ * and you load `tools.cli.plugin` instead; do not load both descriptor plugins in
+ * the same runtime.
+ */
+declare const _default: import("@vibesdotdev/kernel").RuntimePlugin;
+export default _default;
+//# sourceMappingURL=tools.cli.descriptors.plugin.d.ts.map

package/dist/cli/tools.cli.descriptors.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.cli.descriptors.plugin.d.ts","sourceRoot":"","sources":["../../src/cli/tools.cli.descriptors.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;;AAKH,wBAMG"}