@vibe-agent-toolkit/cli 0.2.0-rc.5 → 0.2.0-rc.7

package/dist/commands/audit.d.ts

@@ -3,8 +3,8 @@
  * Top-level command: vat audit [path]
  */
 import { type SkillPackagingConfig, type ValidationResult } from '@vibe-agent-toolkit/agent-skills';
-import { type CompatibilityResult, type EffectiveSettings } from '@vibe-agent-toolkit/claude-marketplace';
-import { type SeverityCounts } from '@vibe-agent-toolkit/schema';
+import { checkSettingsCompatibility, type CompatibilityResult, type EffectiveSettings } from '@vibe-agent-toolkit/claude-marketplace';
+import { type SeverityCounts, type ValidationIssue } from '@vibe-agent-toolkit/schema';
 import { Command } from 'commander';
 import { createLogger } from '../utils/logger.js';
 export interface AuditCommandOptions {
@@ -29,6 +29,20 @@ export interface VATProjectContext {
 /**
  * Create audit command
  * Top-level command: vat audit [path]
+ *
+ * 🔑 **Two verdicts, deliberately.** The YAML `status` describes the FINDINGS;
+ * the exit code describes whether the RUN completed. `status: error` beside exit
+ * `0` is the correct pair for a tree with errors, and both facts are worth
+ * publishing — but `status` moves with the exit code in every other command of
+ * this CLI, so this one is the exception and the help text says so out loud (see
+ * the `Output` and `Exit Codes` sections below, and `docs/audit.md`).
+ *
+ * ⚠️ Do NOT "reconcile" the two by making one follow the other. Making the exit
+ * code follow `status` turns an advisory report into a gate — the thing
+ * `vat validate` already is, and the thing this command's published contract
+ * promises it is not. Making `status` follow the exit code deletes the only
+ * machine-readable verdict a CI consumer has, and a stamped `success` over a
+ * report full of errors is a stronger falsehood than the mismatch ever was.
  */
 export declare function createAuditCommand(): Command;
 /**
@@ -120,8 +134,43 @@ export declare function auditCommand(targetPath: string | undefined, options: Au
  * degrading as narrowly as possible is the entire point.
  */
 export declare function getValidationResults(scanPath: string, recursive: boolean, options: AuditCommandOptions, logger: ReturnType<typeof createLogger>, locationRoot: string): Promise<ValidationResult[]>;
+/** What the settings check compared and what it could not — the checker's own answer, paths absolute. */
+type SettingsCheck = Awaited<ReturnType<typeof checkSettingsCompatibility>>;
+/**
+ * The `compatibility:` block when the analyzer produced no verdicts: it says
+ * so, in the document, rather than the block being absent.
+ *
+ * Reserved for a PLUGIN-WIDE failure — no valid `plugin.json`, a root that
+ * cannot be listed. A single file the analyzer cannot read, list or parse is
+ * NOT this: the analyzer names it under its own `CompatibilityResult.unchecked`
+ * and analyzes every other file, so its verdicts are over fewer files than the
+ * plugin ships and the document says which.
+ *
+ * 🚨 The analyzer throwing used to be `logger.debug` and NO block of either
+ * kind for that plugin, exit 0 — and it threw on the first file it could not
+ * read, so ONE unreadable SKILL.md (or one unlistable directory) was enough.
+ * Under `--settings` the settings check, which does not depend on the
+ * analyzer at all, never ran either. A plugin the run could not analyze was
+ * indistinguishable from one the operator never asked about.
+ */
+interface CompatibilityUnavailable {
+    analyzed: false;
+    /** The analyzer's own message, with the refused path root-relative. */
+    reason: string;
+}
+/** What the `compatibility:` block can hold. */
+type CompatibilityBlock = CompatibilityResult | CompatibilityUnavailable;
 /**
- * Run compatibility analysis on plugin results and return a map of path -> CompatibilityResult.
+ * One plugin's entry in the compat map: what each lane the operator asked for
+ * produced. The two lanes are INDEPENDENT — the settings check is present iff
+ * the run asked for `--settings`, whether or not the analyzer succeeded.
+ */
+interface PluginCompatEntry {
+    compat: CompatibilityBlock;
+    settings?: SettingsCheck;
+}
+/**
+ * Run compatibility analysis on plugin results and return a map of path -> PluginCompatEntry.
  * Non-plugin results are skipped silently.
  * When effectiveSettings is provided, also runs settings conflict detection.
  *
@@ -137,14 +186,32 @@ export declare function getValidationResults(scanPath: string, recursive: boolea
  *
  * @internal Exported for integration testing only — not part of the public CLI API.
  */
-export declare function runCompatAnalysis(results: ValidationResult[], logger: ReturnType<typeof createLogger>, locationRoot: string, effectiveSettings?: EffectiveSettings, vatContext?: VATProjectContext | null): Promise<Map<string, CompatibilityResult>>;
-declare function calculateSummary(results: ValidationResult[], startTime: number, compatMap: Map<string, CompatibilityResult> | undefined, verbose: boolean, root: string): {
-    files: (ValidationResult & {
-        compatibility?: CompatibilityResult;
-    })[];
+export declare function runCompatAnalysis(results: ValidationResult[], logger: ReturnType<typeof createLogger>, locationRoot: string, effectiveSettings?: EffectiveSettings, vatContext?: VATProjectContext | null): Promise<Map<string, PluginCompatEntry>>;
+/** A path the settings check never compared, as the report renders it. */
+interface SettingsUncheckedEntry {
+    /** Root-relative, like every other location in the document. */
+    path: string;
+    reason: string;
+}
+/** The `settings:` block as the report renders it. */
+interface SettingsBlock {
+    /** `false` when a conflict was found OR when anything went unchecked — never "fine by omission". */
+    compatible: boolean;
+    conflicts: SettingsCheck['conflicts'];
+    /** Present only when non-empty: what the check never saw, and why. */
+    unchecked?: SettingsUncheckedEntry[];
+}
+/** A file entry with the compat lanes' blocks attached. */
+type ResultWithCompat = ValidationResult & {
+    compatibility?: CompatibilityBlock;
+    settings?: SettingsBlock;
+};
+declare function calculateSummary(results: ValidationResult[], startTime: number, compatMap: Map<string, PluginCompatEntry> | undefined, verbose: boolean, root: string): {
+    files: ResultWithCompat[];
     status: string;
     summary: FileStatusCounts;
     issueCounts: SeverityCounts;
+    issues?: ValidationIssue[];
     duration: string;
     root: string;
 };

package/dist/commands/audit.d.ts.map

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