@vibe-agent-toolkit/cli 0.2.0-rc.11 → 0.2.0-rc.12

package/dist/commands/agent/install.js

@@ -4,114 +4,84 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { loadAgentManifest } from '@vibe-agent-toolkit/agent-config';
-import { ExitCode } from '@vibe-agent-toolkit/schema';
-import { copyDirectory, isPathAbsentError, safePath } from '@vibe-agent-toolkit/utils';
+import { buildReport, toFindings } from '@vibe-agent-toolkit/schema';
+import { applyTreePlan, classifyFsFault, everywhere, isPathAbsentError, pathPresent, planTreeChanges, safePath } from '@vibe-agent-toolkit/utils';
 import { resolveAgentPath } from '../../utils/agent-discovery.js';
-import { handleCommandError } from '../../utils/command-error.js';
+import { CommandRefusalError, refusalCodeOf } from '../../utils/command-refusal.js';
+import { endWithRefusal, endWithReport, leftoverIssue, NOTHING_FINISHED } from '../../utils/document-writer.js';
+import { occupiedRefusal, skillOwnership } from '../../utils/install-plan.js';
 import { createLogger } from '../../utils/logger.js';
 import { validateAndGetScopeLocation } from '../../utils/scope-locations.js';
 import { agentInstallPath } from './install-path.js';
+/** `vat agent install` has no `--strict`, and its only findings are leftovers (warnings): the gate is fixed. */
+const GATE = { strict: false };
 /**
- * Install agent command
+ * Install agent command.
+ *
+ * The install is ONE tree-change plan: the copy, or the `--dev` link, is staged
+ * beside the install and swapped in whole, so a refused run leaves any previous
+ * install exactly as it was — every refusal publishes NOTHING_FINISHED, and
+ * that is the truth. A previous install the swap parked and the OS would not
+ * let VAT remove is a warning naming it, on a run that finished.
  */
 export async function installAgent(agentName, options) {
     const logger = createLogger(options.debug ? { debug: true } : {});
     const startTime = Date.now();
+    let installed;
     try {
-        const { runtime = 'agent-skill', scope = 'user', dev = false, force = false } = options;
-        // Windows check for dev mode
-        if (dev && process.platform === 'win32') {
-            throw new Error('--dev (symlink) not supported on Windows.\n' +
-                'Use copy mode (omit --dev) or WSL for development.');
-        }
-        // Validate scope and get target location
-        const targetLocation = validateAndGetScopeLocation(runtime, scope);
-        // Refused by name before anything is examined — before the agent is even
-        // looked up: with `--force` this path is `rm -rf`'d, and the positional is
-        // the one thing on it the user typed.
-        const installPath = agentInstallPath(targetLocation, agentName);
-        // Find built skill
-        const builtSkillPath = await findBuiltSkill(agentName, runtime, logger);
-        // Ensure target directory exists
-        await fs.mkdir(targetLocation, { recursive: true });
-        // Check if already installed.
-        //
-        // `lstat`, not `access`: `access` FOLLOWS symlinks, so a dangling dev-mode
-        // link — precisely what `build:clean` orphans by deleting `dist/` under a
-        // previous `--dev` install — answered ENOENT here. That fell into the catch
-        // below as "not installed", which skipped the `--force` removal and left the
-        // link in place for `fs.symlink` to reject with EEXIST. `--force` was inert
-        // against the one state it most needed to clear. `lstat` stats the link
-        // itself, so the entry is seen whether or not its target still exists.
-        try {
-            await fs.lstat(installPath);
-            if (!force) {
-                logger.error(`\n${agentName} already installed at ${installPath}\n` +
-                    `Use --force to overwrite\n`);
-                process.exit(ExitCode.ERROR);
-            }
-            // Remove existing if force flag is set
-            await fs.rm(installPath, { recursive: true, force: true });
-        }
-        catch (error) {
-            // Not installed: continue. Only an ABSENCE means that — a refused `lstat`
-            // (the scope dir the OS will not let us into) or a failed `rm` used to
-            // land here too, read as "not installed", and the install then tripped
-            // over whatever was actually there.
-            if (!isPathAbsentError(error))
-                throw error;
-        }
-        if (dev) {
-            await linkForDevelopment(builtSkillPath, installPath);
-            logger.info(`✓ Symlinked ${agentName} to ${installPath} (dev mode)`);
-            logger.info(`  Rebuild agent to see changes immediately`);
-        }
-        else {
-            // Copy for production
-            await copyDirectory(builtSkillPath, installPath);
-            logger.info(`✓ Installed ${agentName} to ${installPath}`);
-        }
-        const duration = Date.now() - startTime;
-        logger.debug(`Install completed in ${duration}ms`);
-        process.exit(ExitCode.OK);
+        installed = await install(agentName, options, logger);
     }
     catch (error) {
-        handleCommandError(error, logger, startTime, 'Install');
+        return endWithRefusal('agent install', refusalCodeOf(error), error, 'yaml', GATE, NOTHING_FINISHED);
     }
+    logger.debug(`Install completed in ${Date.now() - startTime}ms`);
+    const { data, leftovers } = installed;
+    endWithReport('agent install', buildReport({ examined: 1, findings: toFindings([...leftovers]), data, gate: GATE, durationMs: Date.now() - startTime }), 'yaml');
 }
-/**
- * Symlink a built bundle into place for `--dev`, failing legibly where the OS
- * refuses.
- *
- * ⚠️ **This is POSIX-only in practice, and not by anything written here.**
- * `installAgent` refuses `dev` on win32 before this is reachable, naming WSL
- * and copy mode. So Windows never gets this far, and any Windows-specific
- * handling added here would be dead code — an earlier revision added exactly
- * that, relabelling a `SeCreateSymbolicLinkPrivilege` EPERM that cannot occur.
- * If `--dev` is ever to work on Windows, the change belongs at that guard (a
- * junction takes no elevation, as `dev-tools/src/link-workspace-packages.ts`
- * already does), not in this catch.
- *
- * Deliberately does NOT fall back to copying. `--dev` exists so a rebuild is
- * picked up live; a copy that reported success would leave someone editing
- * sources and wondering why nothing changes — a silent wrong answer in place of
- * a loud, correct refusal.
- *
- * @param builtSkillPath - Absolute path to the built bundle
- * @param installPath - Where the link should be created
- * @throws When the link cannot be created, naming the remedy
- */
-async function linkForDevelopment(builtSkillPath, installPath) {
-    try {
-        // eslint-disable-next-line local/no-bare-symlink-in-tests -- eyes open: win32 is refused by the guard in `installAgent` before this runs, so the Windows privilege hazard the rule names cannot be reached here.
-        await fs.symlink(builtSkillPath, installPath, 'dir');
+/** The install itself; every throw carries the refusal code of its cause. */
+async function install(agentName, options, logger) {
+    const { runtime = 'agent-skill', scope = 'user', dev = false, force = false } = options;
+    // `--dev` stages a symlink, and Windows gives one only with a privilege. Refused here, before
+    // anything is examined, naming WSL and copy mode; should `--dev` ever work on Windows, a junction
+    // (no privilege, as `dev-tools/src/link-workspace-packages.ts` makes) is the way. Never a silent
+    // copy instead: `--dev` exists so a rebuild is picked up live.
+    if (dev && process.platform === 'win32') {
+        throw new CommandRefusalError('NOT_IMPLEMENTED', '--dev (symlink) not supported on Windows.\n' +
+            'Use copy mode (omit --dev) or WSL for development.');
     }
-    catch (error) {
-        const detail = error instanceof Error ? error.message : String(error);
-        throw new Error(`Could not create the dev-mode symlink at ${installPath}: ${detail}\n` +
-            `Re-run with --force to replace whatever is already at ${installPath}, ` +
-            'or install without --dev to copy the bundle instead of linking it.');
+    const targetLocation = validateAndGetScopeLocation(runtime, scope);
+    // Refused by name before anything is examined — before the agent is even
+    // looked up: with `--force` whatever is at this path is replaced, and the
+    // positional is the one thing on it the user typed.
+    const installPath = agentInstallPath(targetLocation, agentName);
+    const builtSkillPath = await findBuiltSkill(agentName, runtime, logger);
+    // Without `--force` the install path must be free (absent, or an empty directory): a previous
+    // install, or a dangling `--dev` link `build:clean` orphaned, is refused before anything is
+    // written. The plan makes ~/.claude/skills when absent and removes it again on a refusal. A copy
+    // follows only links inside the bundle and gives each directory the bundle's mode with the
+    // owner's rwx kept (the primitive's copy policy): a read-only bundle never becomes an install
+    // nothing can remove.
+    const plan = await planTreeChanges([{
+            op: 'replace',
+            dest: installPath,
+            ownership: skillOwnership(force),
+            fill: dev ? { from: 'link', target: builtSkillPath } : { from: 'copy', source: builtSkillPath, side: 'source', links: 'follow-contained' },
+            label: `agent ${agentName}`,
+        }]).catch((error) => {
+        throw occupiedRefusal(error);
+    });
+    const { warnings } = await applyTreePlan(plan);
+    if (dev) {
+        logger.info(`✓ Symlinked ${agentName} to ${installPath} (dev mode)`);
+        logger.info(`  Rebuild agent to see changes immediately`);
     }
+    else {
+        logger.info(`✓ Installed ${agentName} to ${installPath}`);
+    }
+    return {
+        data: { agent: agentName, installPath, symlink: dev },
+        leftovers: warnings.map(({ message, path }) => leftoverIssue(message, path)),
+    };
 }
 /**
  * Find built skill bundle
@@ -125,22 +95,23 @@ async function findBuiltSkill(agentName, runtime, logger) {
     // Runtime-specific bundle location
     const runtimeDir = runtime === 'agent-skill' ? 'skill' : runtime;
     const builtPath = safePath.join(packageRoot, 'dist', 'vat-bundles', runtimeDir, manifest.metadata.name);
-    try {
-        await fs.access(builtPath);
-        return builtPath;
-    }
-    catch {
-        throw new Error(`Built skill not found at ${builtPath}\n` +
-            `Run: vat agent build ${agentName} --runtime ${runtime}`);
+    // Only an absence is "not built"; a probe the OS refuses is its own INPUT_UNREADABLE.
+    if (!pathPresent(builtPath, { follow: packageRoot }, everywhere('source'), 'probe')) {
+        throw new CommandRefusalError('INPUT_UNREADABLE', `Built skill not found at ${builtPath}\n` +
+            `Run: vat agent build ${agentName} --target ${runtimeDir}`);
     }
+    return builtPath;
 }
 /**
  * Find the agent package root (directory containing package.json)
  */
-async function findAgentPackageRoot(manifestPath) {
-    let currentDir = path.dirname(safePath.resolve(manifestPath));
+function findAgentPackageRoot(manifestPath) {
     // Walk up until we find a package.json or hit the filesystem root
-    while (currentDir !== path.dirname(currentDir)) {
+    const climb = async (currentDir) => {
+        if (currentDir === path.dirname(currentDir)) {
+            throw new CommandRefusalError('USAGE_INVALID', `Could not find package.json for agent at ${manifestPath}. ` +
+                `Agent must be within an npm package to install.`);
+        }
         const packageJsonPath = safePath.join(currentDir, 'package.json');
         try {
             await fs.access(packageJsonPath);
@@ -148,13 +119,12 @@ async function findAgentPackageRoot(manifestPath) {
         }
         catch (error) {
             // No manifest at this level: climb. A refused ancestor is not "no
-            // manifest" and stays loud.
+            // manifest": the input's refusal.
             if (!isPathAbsentError(error))
-                throw error;
-            currentDir = path.dirname(currentDir);
+                throw classifyFsFault(error, { side: 'source', origin: 'content', action: 'look for the package around the agent', path: packageJsonPath });
         }
-    }
-    throw new Error(`Could not find package.json for agent at ${manifestPath}. ` +
-        `Agent must be within an npm package to install.`);
+        return climb(path.dirname(currentDir));
+    };
+    return climb(path.dirname(safePath.resolve(manifestPath)));
 }
 //# sourceMappingURL=install.js.map

package/dist/commands/agent/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/agent/install.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAUrD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,OAAuB;IAEvB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,GAAG,aAAa,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QAExF,6BAA6B;QAC7B,IAAI,GAAG,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,6CAA6C;gBAC3C,oDAAoD,CACvD,CAAC;QACJ,CAAC;QAED,yCAAyC;QACzC,MAAM,cAAc,GAAG,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEnE,yEAAyE;QACzE,2EAA2E;QAC3E,sCAAsC;QACtC,MAAM,WAAW,GAAG,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAEhE,mBAAmB;QACnB,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAExE,iCAAiC;QACjC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,8BAA8B;QAC9B,EAAE;QACF,2EAA2E;QAC3E,0EAA0E;QAC1E,4EAA4E;QAC5E,6EAA6E;QAC7E,4EAA4E;QAC5E,wEAAwE;QACxE,uEAAuE;QACvE,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,CACV,KAAK,SAAS,yBAAyB,WAAW,IAAI;oBACpD,4BAA4B,CAC/B,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YACD,uCAAuC;YACvC,MAAM,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,uEAAuE;YACvE,uEAAuE;YACvE,oCAAoC;YACpC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;QAC7C,CAAC;QAED,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,kBAAkB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,eAAe,SAAS,OAAO,WAAW,aAAa,CAAC,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,sBAAsB;YACtB,MAAM,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,eAAe,SAAS,OAAO,WAAW,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,wBAAwB,QAAQ,IAAI,CAAC,CAAC;QAEnD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,KAAK,UAAU,kBAAkB,CAAC,cAAsB,EAAE,WAAmB;IAC3E,IAAI,CAAC;QACH,iNAAiN;QACjN,MAAM,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,KAAK,CACb,4CAA4C,WAAW,KAAK,MAAM,IAAI;YACpE,yDAAyD,WAAW,IAAI;YACxE,oEAAoE,CACvE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,SAAiB,EACjB,OAAe,EACf,MAAuC;IAEvC,qBAAqB;IACrB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEpD,qDAAqD;IACrD,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,cAAc,IAAI,SAAS,CAAC,CAAC;IAErF,mCAAmC;IACnC,MAAM,UAAU,GAAG,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAC7B,WAAW,EACX,MAAM,EACN,aAAa,EACb,UAAU,EACV,QAAQ,CAAC,QAAQ,CAAC,IAAI,CACvB,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,4BAA4B,SAAS,IAAI;YACvC,wBAAwB,SAAS,cAAc,OAAO,EAAE,CAC3D,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,oBAAoB,CAAC,YAAoB;IACtD,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAE9D,kEAAkE;IAClE,OAAO,UAAU,KAAK,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACjC,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kEAAkE;YAClE,4BAA4B;YAC5B,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YAC3C,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,4CAA4C,YAAY,IAAI;QAC1D,iDAAiD,CACpD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/agent/install.ts"],"names":[],"mappings":"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"}

package/dist/commands/agent/installed-schema.d.ts

@@ -0,0 +1,140 @@
+/**
+ * The document `vat agent installed` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes).
+ *
+ * `examined` counts the scopes scanned. A scope whose directory is absent is
+ * scanned and empty; one the OS will not list is a `SCAN_PATH_UNREADABLE`
+ * warning finding at that directory — the listing is then a floor, not the
+ * answer — and the other scopes are still listed.
+ */
+import { type Report } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+import type { ExaminedDeclaration } from '../../utils/run-integrity.js';
+/** What `examined` counts for `vat agent installed`, and the remedy when it is zero. */
+export declare const AGENT_INSTALLED_EXAMINED: ExaminedDeclaration;
+declare const AgentInstalledDataSchema: z.ZodObject<{
+    /** The scopes scanned, in scan order. */
+    scanned: z.ZodArray<z.ZodString, "many">;
+    skills: z.ZodArray<z.ZodObject<{
+        /** The installed skill's directory name. */
+        name: z.ZodString;
+        /** The scope it was found in. */
+        scope: z.ZodString;
+        /** `symlink` for a `--dev` install, `directory` for a copied one. */
+        type: z.ZodEnum<["symlink", "directory"]>;
+        /** Where it is installed. */
+        path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        path: string;
+        type: "directory" | "symlink";
+        scope: string;
+    }, {
+        name: string;
+        path: string;
+        type: "directory" | "symlink";
+        scope: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    skills: {
+        name: string;
+        path: string;
+        type: "directory" | "symlink";
+        scope: string;
+    }[];
+    scanned: string[];
+}, {
+    skills: {
+        name: string;
+        path: string;
+        type: "directory" | "symlink";
+        scope: string;
+    }[];
+    scanned: string[];
+}>;
+export type AgentInstalledData = z.infer<typeof AgentInstalledDataSchema>;
+/** The document this command publishes. */
+export declare const AGENT_INSTALLED_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    /** The scopes scanned, in scan order. */
+    scanned: z.ZodArray<z.ZodString, "many">;
+    skills: z.ZodArray<z.ZodObject<{
+        /** The installed skill's directory name. */
+        name: z.ZodString;
+        /** The scope it was found in. */
+        scope: z.ZodString;
+        /** `symlink` for a `--dev` install, `directory` for a copied one. */
+        type: z.ZodEnum<["symlink", "directory"]>;
+        /** Where it is installed. */
+        path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        path: string;
+        type: "directory" | "symlink";
+        scope: string;
+    }, {
+        name: string;
+        path: string;
+        type: "directory" | "symlink";
+        scope: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    skills: {
+        name: string;
+        path: string;
+        type: "directory" | "symlink";
+        scope: string;
+    }[];
+    scanned: string[];
+}, {
+    skills: {
+        name: string;
+        path: string;
+        type: "directory" | "symlink";
+        scope: string;
+    }[];
+    scanned: string[];
+}>, z.ZodObject<Omit<{
+    code: z.ZodString;
+    severity: z.ZodEnum<["error", "warning", "info", "ignore"]>;
+    message: z.ZodString;
+    location: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    line: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    fix: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodString>;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, "severity"> & {
+    severity: z.ZodEnum<["error", "warning", "info"]>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}>>;
+export type AgentInstalledReport = Report<AgentInstalledData>;
+export {};
+//# sourceMappingURL=installed-schema.d.ts.map

package/dist/commands/agent/installed-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-schema.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/installed-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,wFAAwF;AACxF,eAAO,MAAM,wBAAwB,EAAE,mBAGtC,CAAC;AAEF,QAAA,MAAM,wBAAwB;IAC5B,yCAAyC;;;QAGvC,4CAA4C;;QAE5C,iCAAiC;;QAEjC,qEAAqE;;QAErE,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGtB,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,2CAA2C;AAC3C,eAAO,MAAM,6BAA6B;IAjBxC,yCAAyC;;;QAGvC,4CAA4C;;QAE5C,iCAAiC;;QAEjC,qEAAqE;;QAErE,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAQiE,CAAC;AAEnG,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/commands/agent/installed-schema.js

@@ -0,0 +1,36 @@
+/**
+ * The document `vat agent installed` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes).
+ *
+ * `examined` counts the scopes scanned. A scope whose directory is absent is
+ * scanned and empty; one the OS will not list is a `SCAN_PATH_UNREADABLE`
+ * warning finding at that directory — the listing is then a floor, not the
+ * answer — and the other scopes are still listed.
+ */
+import { FindingSchema, reportSchema } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+/** What `examined` counts for `vat agent installed`, and the remedy when it is zero. */
+export const AGENT_INSTALLED_EXAMINED = {
+    unit: 'scopes scanned',
+    whenZero: 'No install scope was scanned, which is a defect in VAT — report it with the output of vat agent installed --debug.',
+};
+const AgentInstalledDataSchema = z.object({
+    /** The scopes scanned, in scan order. */
+    scanned: z.array(z.string()),
+    skills: z.array(z.object({
+        /** The installed skill's directory name. */
+        name: z.string(),
+        /** The scope it was found in. */
+        scope: z.string(),
+        /** `symlink` for a `--dev` install, `directory` for a copied one. */
+        type: z.enum(['symlink', 'directory']),
+        /** Where it is installed. */
+        path: z.string(),
+    }).strict()),
+}).strict();
+/** The document this command publishes. */
+export const AGENT_INSTALLED_REPORT_SCHEMA = reportSchema(AgentInstalledDataSchema, FindingSchema);
+//# sourceMappingURL=installed-schema.js.map

package/dist/commands/agent/installed-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-schema.js","sourceRoot":"","sources":["../../../src/commands/agent/installed-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAe,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,wFAAwF;AACxF,MAAM,CAAC,MAAM,wBAAwB,GAAwB;IAC3D,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,oHAAoH;CAC/H,CAAC;AAEF,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,yCAAyC;IACzC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACvB,4CAA4C;QAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,iCAAiC;QACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,qEAAqE;QACrE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtC,6BAA6B;QAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC,CAAC,MAAM,EAAE,CAAC;CACb,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAC"}

package/dist/commands/agent/installed.d.ts

@@ -2,7 +2,7 @@
  * List installed agents command
  */
 export interface InstalledCommandOptions {
-    scope?: 'user' | 'project' | 'all';
+    scope?: string;
     runtime?: string;
     debug?: boolean;
 }

package/dist/commands/agent/installed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installed.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/installed.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoEtF"}
+{"version":3,"file":"installed.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/installed.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAUD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBtF"}