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

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

package/dist/commands/agent/installed.js

@@ -2,103 +2,115 @@
  * List installed agents command
  */
 import fs from 'node:fs/promises';
-import { ExitCode } from '@vibe-agent-toolkit/schema';
-import { isPathAbsentError, safePath } from '@vibe-agent-toolkit/utils';
-import yaml from 'yaml';
-import { handleCommandError } from '../../utils/command-error.js';
+import { materializeIssue } from '@vibe-agent-toolkit/agent-skills';
+import { buildReport, toFindings } from '@vibe-agent-toolkit/schema';
+import { isPathAbsentError, isTreeChangeResidue, safePath, toForwardSlash } from '@vibe-agent-toolkit/utils';
+import { CommandRefusalError, refusalCodeOf } from '../../utils/command-refusal.js';
+import { endWithRefusal, endWithReport, NOTHING_FINISHED } from '../../utils/document-writer.js';
 import { createLogger } from '../../utils/logger.js';
-import { SCOPE_LOCATIONS } from '../../utils/scope-locations.js';
+import { knownScopeRuntimes, scopeLocationsFor } from '../../utils/scope-locations.js';
+/** `vat agent installed` has no `--strict`; an unreadable scope is a warning: the gate is fixed. */
+const GATE = { strict: false };
+/** The `--scope` value that scans every scope the runtime has. */
+const ALL_SCOPES = 'all';
 /**
  * List installed agents command
  */
 export async function installedCommand(options) {
     const logger = createLogger(options.debug ? { debug: true } : {});
     const startTime = Date.now();
+    let report;
     try {
-        const { runtime = 'agent-skill', scope = 'all' } = options;
-        const scopeLocations = SCOPE_LOCATIONS[runtime];
-        if (!scopeLocations) {
-            throw new Error(`Runtime '${runtime}' not implemented`);
-        }
-        // Determine which scopes to scan
-        const scopesToScan = scope === 'all' ? Object.keys(scopeLocations) : [scope];
-        const skills = await scanForInstalledSkills(scopeLocations, scopesToScan);
-        if (skills.length === 0) {
-            logger.info('No installed skills found');
-            const duration = Date.now() - startTime;
-            logger.debug(`List completed in ${duration}ms`);
-            // Output YAML for programmatic parsing
-            const output = {
-                status: 'success',
-                skills: [],
-                scanned: scopesToScan,
-                duration,
-            };
-            console.log(yaml.stringify(output));
-            process.exit(ExitCode.OK);
-            return;
-        }
-        // Output to stderr (human-readable)
-        logger.info('\nInstalled Skills:\n');
-        for (const skill of skills) {
-            const typeIndicator = skill.type === 'symlink' ? '→' : '✓';
-            logger.info(`  ${typeIndicator} ${skill.name} (${skill.scope})`);
-            if (skill.type === 'symlink') {
-                logger.info(`    ${skill.path}`);
-            }
-        }
-        logger.info('');
-        const duration = Date.now() - startTime;
-        logger.debug(`List completed in ${duration}ms`);
-        // Output YAML to stdout for programmatic parsing
-        const output = {
-            status: 'success',
-            skills: skills.map((s) => ({
-                name: s.name,
-                scope: s.scope,
-                type: s.type,
-                path: s.path,
-            })),
-            scanned: scopesToScan,
-            duration,
-        };
-        console.log(yaml.stringify(output));
-        process.exit(ExitCode.OK);
+        const { runtime = 'agent-skill', scope = ALL_SCOPES } = options;
+        const scopeLocations = requireScopeLocations(runtime);
+        const scopesToScan = scopesFor(scope, scopeLocations);
+        const { skills, unreadable } = await scanForInstalledSkills(scopeLocations, scopesToScan);
+        logInstalledSkills(skills, logger);
+        report = buildReport({
+            examined: scopesToScan.length,
+            findings: toFindings(unreadable),
+            data: { scanned: scopesToScan, skills },
+            gate: GATE,
+            durationMs: Date.now() - startTime,
+        });
     }
     catch (error) {
-        handleCommandError(error, logger, startTime, 'Installed');
+        endWithRefusal('agent installed', refusalCodeOf(error), error, 'yaml', GATE, NOTHING_FINISHED);
+    }
+    endWithReport('agent installed', report, 'yaml');
+}
+/** The scope directories of `runtime`, or the invocation's mistake. */
+function requireScopeLocations(runtime) {
+    const scopeLocations = scopeLocationsFor(runtime);
+    if (!scopeLocations) {
+        throw new CommandRefusalError('USAGE_INVALID', `Unknown runtime '${runtime}' (known: ${knownScopeRuntimes().join(', ')})`);
+    }
+    return scopeLocations;
+}
+/** The scopes `--scope` names, or the invocation's mistake. */
+function scopesFor(scope, scopeLocations) {
+    const known = Object.keys(scopeLocations);
+    if (scope === ALL_SCOPES)
+        return known;
+    if (!known.includes(scope)) {
+        throw new CommandRefusalError('USAGE_INVALID', `Unknown scope '${scope}' (known: ${[ALL_SCOPES, ...known].join(', ')})`);
+    }
+    return [scope];
+}
+/** The human listing, on stderr. */
+function logInstalledSkills(skills, logger) {
+    if (skills.length === 0) {
+        logger.info('No installed skills found');
+        return;
+    }
+    logger.info('\nInstalled Skills:\n');
+    for (const skill of skills) {
+        logger.info(`  ${skill.type === 'symlink' ? '→' : '✓'} ${skill.name} (${skill.scope})`);
+        if (skill.type === 'symlink')
+            logger.info(`    ${skill.path}`);
     }
+    logger.info('');
 }
 /**
- * Scan locations for installed skills
+ * Scan locations for installed skills. A scope directory the OS will not list
+ * is a `SCAN_PATH_UNREADABLE` warning, and the other scopes are still listed.
  */
 async function scanForInstalledSkills(scopeLocations, scopesToScan) {
     const skills = [];
-    for (const currentScope of scopesToScan) {
+    const unreadable = [];
+    // At most three read-only listings: read together, folded in scope order.
+    const listings = await Promise.all(scopesToScan.map(async (currentScope) => {
         const location = scopeLocations[currentScope];
-        if (!location)
+        return { currentScope, location, listing: location ? await listScopeLocation(location) : null };
+    }));
+    for (const { currentScope, location, listing } of listings) {
+        if (!location || listing === null)
             continue;
-        const entries = await listScopeLocation(location);
-        if (entries === null)
+        if (!Array.isArray(listing)) {
+            unreadable.push(unlistableScopeFinding(currentScope, location, listing.errno));
             continue;
-        for (const entry of entries) {
-            if (!entry.isDirectory() && !entry.isSymbolicLink())
-                continue;
-            const skillPath = safePath.join(location, entry.name);
-            const stats = await fs.lstat(skillPath);
-            const isSymlink = stats.isSymbolicLink();
-            skills.push({
-                name: entry.name,
-                scope: currentScope,
-                type: isSymlink ? 'symlink' : 'installed',
-                path: skillPath,
-            });
         }
+        skills.push(...installedSkillsIn(listing, currentScope, location));
     }
-    return skills;
+    return { skills, unreadable };
+}
+/**
+ * The installs in one scope's listing: each directory, or link, directly under
+ * it — never the staged copy an interrupted install left beside one.
+ */
+function installedSkillsIn(listing, scope, location) {
+    return listing
+        .filter((entry) => (entry.isDirectory() || entry.isSymbolicLink()) && !isTreeChangeResidue(entry.name))
+        .map((entry) => ({
+        name: entry.name,
+        scope,
+        type: entry.isSymbolicLink() ? 'symlink' : 'directory',
+        path: safePath.join(location, entry.name),
+    }));
 }
 /**
- * The entries of one scope location, or `null` when there is no such directory.
+ * The entries of one scope location; `null` when there is no such directory;
+ * the errno when the OS refuses to list it.
  *
  * Only an ABSENCE is `null`. A scope directory the OS refuses to list is not an
  * empty one, and reading it as empty would list fewer installs than there are.
@@ -110,7 +122,24 @@ async function listScopeLocation(location) {
     catch (error) {
         if (isPathAbsentError(error))
             return null;
-        throw error;
+        return { errno: error.code ?? 'unknown error' };
     }
 }
+/**
+ * The warning for a scope directory the listing could not read: the list is
+ * then a floor. A finding's `location` is relative, and this document has no
+ * one root — the scopes live under the Claude config dir and under the working
+ * directory — so it is the scope directory's last two segments
+ * (`.claude/skills` by default). Two scopes can read the same location, so
+ * `field` is the scope name; the detail adds the full path.
+ */
+function unlistableScopeFinding(scope, location, errno) {
+    const where = toForwardSlash(safePath.relative(safePath.resolve(location, '..', '..'), location));
+    return materializeIssue('SCAN_PATH_UNREADABLE', {
+        location: where,
+        // Two scopes can share these segments: the scope says which.
+        field: scope,
+        detail: `${scope} scope ${toForwardSlash(location)}: listing was refused with ${errno}; any skill installed beneath it is missing from this list`,
+    });
+}
 //# sourceMappingURL=installed.js.map

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

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

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

@@ -0,0 +1,128 @@
+/**
+ * The document `vat agent list` 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 search paths scanned. An absent search path is scanned
+ * and empty; one the OS will not list, and an agent manifest it will not read,
+ * is a `SCAN_PATH_UNREADABLE` warning finding — the listing is then a floor —
+ * and every readable search path is 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 list`, and the remedy when it is zero. */
+export declare const AGENT_LIST_EXAMINED: ExaminedDeclaration;
+declare const AgentListDataSchema: z.ZodObject<{
+    /** The directory the search paths resolve against (the working directory): the only absolute path. */
+    root: z.ZodString;
+    agents: z.ZodArray<z.ZodObject<{
+        /** `metadata.name` from the agent's manifest. */
+        name: z.ZodString;
+        /** `metadata.version` from the agent's manifest. */
+        version: z.ZodNullable<z.ZodString>;
+        /** The agent directory, relative to `root`. */
+        path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        path: string;
+        version: string | null;
+    }, {
+        name: string;
+        path: string;
+        version: string | null;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    root: string;
+    agents: {
+        name: string;
+        path: string;
+        version: string | null;
+    }[];
+}, {
+    root: string;
+    agents: {
+        name: string;
+        path: string;
+        version: string | null;
+    }[];
+}>;
+export type AgentListData = z.infer<typeof AgentListDataSchema>;
+/** The document this command publishes. */
+export declare const AGENT_LIST_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    /** The directory the search paths resolve against (the working directory): the only absolute path. */
+    root: z.ZodString;
+    agents: z.ZodArray<z.ZodObject<{
+        /** `metadata.name` from the agent's manifest. */
+        name: z.ZodString;
+        /** `metadata.version` from the agent's manifest. */
+        version: z.ZodNullable<z.ZodString>;
+        /** The agent directory, relative to `root`. */
+        path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        path: string;
+        version: string | null;
+    }, {
+        name: string;
+        path: string;
+        version: string | null;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    root: string;
+    agents: {
+        name: string;
+        path: string;
+        version: string | null;
+    }[];
+}, {
+    root: string;
+    agents: {
+        name: string;
+        path: string;
+        version: string | null;
+    }[];
+}>, 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 AgentListReport = Report<AgentListData>;
+export {};
+//# sourceMappingURL=list-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-schema.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/list-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,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAE,mBAGjC,CAAC;AAEF,QAAA,MAAM,mBAAmB;IACvB,sGAAsG;;;QAGpG,iDAAiD;;QAEjD,oDAAoD;;QAEpD,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;EAGxC,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,2CAA2C;AAC3C,eAAO,MAAM,wBAAwB;IAfnC,sGAAsG;;;QAGpG,iDAAiD;;QAEjD,oDAAoD;;QAEpD,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAQqC,CAAC;AAEzF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * The document `vat agent list` 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 search paths scanned. An absent search path is scanned
+ * and empty; one the OS will not list, and an agent manifest it will not read,
+ * is a `SCAN_PATH_UNREADABLE` warning finding — the listing is then a floor —
+ * and every readable search path is still listed.
+ */
+import { FindingSchema, reportSchema } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+/** What `examined` counts for `vat agent list`, and the remedy when it is zero. */
+export const AGENT_LIST_EXAMINED = {
+    unit: 'search paths scanned',
+    whenZero: 'No agent search path was scanned, which is a defect in VAT — report it with the output of vat agent list --debug.',
+};
+const AgentListDataSchema = z.object({
+    /** The directory the search paths resolve against (the working directory): the only absolute path. */
+    root: z.string(),
+    agents: z.array(z.object({
+        /** `metadata.name` from the agent's manifest. */
+        name: z.string(),
+        /** `metadata.version` from the agent's manifest. */
+        version: z.string().nullable(),
+        /** The agent directory, relative to `root`. */
+        path: z.string(),
+    }).strict()),
+}).strict();
+/** The document this command publishes. */
+export const AGENT_LIST_REPORT_SCHEMA = reportSchema(AgentListDataSchema, FindingSchema);
+//# sourceMappingURL=list-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-schema.js","sourceRoot":"","sources":["../../../src/commands/agent/list-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,mFAAmF;AACnF,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,mHAAmH;CAC9H,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,sGAAsG;IACtG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACvB,iDAAiD;QACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,oDAAoD;QACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,+CAA+C;QAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC,CAAC,MAAM,EAAE,CAAC;CACb,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC"}

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

@@ -2,18 +2,19 @@
  * Agent list command - discovers and lists all agents
  */
 import { type DiscoveredAgent } from '../../utils/agent-discovery.js';
+import type { AgentListData } from './list-schema.js';
 export interface ListCommandOptions {
     debug?: boolean;
 }
 /**
- * Build the agent-list payload.
+ * Build the agent-list `data`.
  *
  * Pure, so the payload's shape — including the fact that `path` is root-relative
  * — is under unit test rather than only under a CLI spawn. `root` is stated
  * once and is the only absolute path in the document; without it a relative
  * `path` is unresolvable, and with absolute paths the payload names the machine
- * it ran on.
+ * it ran on. No `manifestPath`: it is derivable.
  */
-export declare function buildAgentListOutput(agents: readonly DiscoveredAgent[], root: string, durationMs: number): Record<string, unknown>;
+export declare function buildAgentListData(agents: readonly DiscoveredAgent[], root: string): AgentListData;
 export declare function listCommand(options: ListCommandOptions): Promise<void>;
 //# sourceMappingURL=list.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAMtF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B5E"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAoC,KAAK,eAAe,EAA4B,MAAM,gCAAgC,CAAC;AAMlI,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,kBAAkB,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAGlG;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B5E"}

package/dist/commands/agent/list.js

@@ -1,61 +1,74 @@
 /**
  * Agent list command - discovers and lists all agents
  */
-import { ExitCode } from '@vibe-agent-toolkit/schema';
-import { safePath } from '@vibe-agent-toolkit/utils';
-import { discoverAgents } from '../../utils/agent-discovery.js';
-import { handleCommandError } from '../../utils/command-error.js';
+import { materializeIssue } from '@vibe-agent-toolkit/agent-skills';
+import { buildReport, toFindings } from '@vibe-agent-toolkit/schema';
+import { safePath, toForwardSlash } from '@vibe-agent-toolkit/utils';
+import { AGENT_SEARCH_PATHS, surveyAgents } from '../../utils/agent-discovery.js';
+import { refusalCodeOf } from '../../utils/command-refusal.js';
+import { endWithRefusal, endWithReport, NOTHING_FINISHED } from '../../utils/document-writer.js';
 import { createLogger } from '../../utils/logger.js';
-import { writeYamlOutput } from '../../utils/output.js';
 import { relativizePathEntries } from '../../utils/relativize-paths.js';
+/** `vat agent list` has no `--strict`; an unreadable search path is a warning: the gate is fixed. */
+const GATE = { strict: false };
 /**
- * Build the agent-list payload.
+ * Build the agent-list `data`.
  *
  * Pure, so the payload's shape — including the fact that `path` is root-relative
  * — is under unit test rather than only under a CLI spawn. `root` is stated
  * once and is the only absolute path in the document; without it a relative
  * `path` is unresolvable, and with absolute paths the payload names the machine
- * it ran on.
+ * it ran on. No `manifestPath`: it is derivable.
  */
-export function buildAgentListOutput(agents, root, durationMs) {
-    const reported = agents.map(agent => ({
-        name: agent.name,
-        version: agent.version,
-        path: agent.path,
-    }));
-    return {
-        status: 'success',
-        root,
-        agents: relativizePathEntries(reported, root),
-        count: agents.length,
-        duration: `${durationMs}ms`,
-    };
+export function buildAgentListData(agents, root) {
+    const reported = agents.map(agent => ({ name: agent.name, version: agent.version, path: agent.path }));
+    return { root, agents: relativizePathEntries(reported, root) };
 }
 export async function listCommand(options) {
     const logger = createLogger(options.debug ? { debug: true } : {});
     const startTime = Date.now();
+    let report;
     try {
-        logger.debug('Discovering agents...');
-        logger.debug(`Search paths: packages/vat-development-agents/agents, agents, .`);
-        const agents = await discoverAgents();
-        // `discoverAgents` resolves its search paths against cwd, so cwd — not a
+        logger.debug(`Search paths: ${AGENT_SEARCH_PATHS.join(', ')}`);
+        const { agents, unreadable } = await surveyAgents();
+        // `surveyAgents` resolves its search paths against cwd, so cwd — not a
         // config/git projectRoot — is the honest base for what it found.
         const root = safePath.resolve(process.cwd());
-        const output = buildAgentListOutput(agents, root, Date.now() - startTime);
-        writeYamlOutput(output);
-        if (agents.length === 0) {
-            logger.info('No agents discovered');
-        }
-        else {
-            logger.info(`Found ${agents.length} agent(s):`);
-            for (const agent of output['agents']) {
-                logger.info(`  ${agent.name} (${agent.version}) - ${agent.path}`);
-            }
-        }
-        process.exit(ExitCode.OK);
+        const data = buildAgentListData(agents, root);
+        logAgents(data, logger);
+        report = buildReport({
+            examined: AGENT_SEARCH_PATHS.length,
+            findings: toFindings(unreadable.map(gap => unreadablePathFinding(gap, root))),
+            data,
+            gate: GATE,
+            durationMs: Date.now() - startTime,
+        });
     }
     catch (error) {
-        handleCommandError(error, logger, startTime, 'AgentList');
+        return endWithRefusal('agent list', refusalCodeOf(error), error, 'yaml', GATE, NOTHING_FINISHED);
     }
+    endWithReport('agent list', report, 'yaml');
+}
+/** The human listing, on stderr. */
+function logAgents(data, logger) {
+    if (data.agents.length === 0) {
+        logger.info('No agents discovered');
+        return;
+    }
+    logger.info(`Found ${data.agents.length} agent(s):`);
+    for (const agent of data.agents) {
+        logger.info(`  ${agent.name} (${agent.version ?? 'no version'}) - ${agent.path}`);
+    }
+}
+/**
+ * The warning for a path discovery could not read: the listing is then a
+ * floor. Located relative to `root`, with the errno in the detail.
+ */
+function unreadablePathFinding(gap, root) {
+    const where = toForwardSlash(safePath.relative(root, gap.path)) || '.';
+    return materializeIssue('SCAN_PATH_UNREADABLE', {
+        location: where,
+        detail: `${where}: read was refused with ${gap.errno}; any agent beneath it is missing from this list`,
+    });
 }
 //# sourceMappingURL=list.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/agent/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,EAAE,cAAc,EAAwB,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAaxE;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAkC,EAClC,IAAY,EACZ,UAAkB;IAElB,MAAM,QAAQ,GAAoB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,IAAI;QACJ,MAAM,EAAE,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC7C,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,QAAQ,EAAE,GAAG,UAAU,IAAI;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,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,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QAEhF,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;QAEtC,yEAAyE;QACzE,iEAAiE;QACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QAE1E,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;YAChD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAoB,EAAE,CAAC;gBACxD,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,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,WAAW,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/agent/list.ts"],"names":[],"mappings":"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"}