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

package/dist/commands/claude/marketplace/validate.d.ts

@@ -8,33 +8,46 @@
  * - README.md should exist (warning)
  * - CHANGELOG.md should exist (warning)
  */
-import { type SeverityCounts, type ValidationIssue } from '@vibe-agent-toolkit/agent-schema';
 import { type ValidationResult } from '@vibe-agent-toolkit/agent-skills';
+import { calculateValidationStatus, type ValidationIssue } from '@vibe-agent-toolkit/schema';
 import { Command } from 'commander';
 import { type FindingCountSummary } from '../../../utils/issue-rendering.js';
 import { createLogger } from '../../../utils/logger.js';
+import { type PhaseOutcome } from '../../phase-utils.js';
+interface MarketplaceValidateOptions {
+    debug?: boolean;
+    /** Show all inspected assets, including those without issues (per-issue detail). */
+    verbose?: boolean;
+}
+/** One manifest entry with a relative-path `source`, as the manifest wrote it. */
+export interface LocalPluginSource {
+    name: string;
+    source: string;
+}
+/** One declared local plugin the run validated, keyed by the entry it satisfies. */
+export interface LocalPluginResult extends LocalPluginSource {
+    result: ValidationResult;
+}
 /** Every finding the command reports, all anchored at one marketplace root. */
 export interface MarketplaceFindings {
     marketplaceResult: ValidationResult;
     /** Empty when the manifest failed: the run bails before reaching plugins. */
-    pluginResults: ValidationResult[];
+    pluginResults: LocalPluginResult[];
+    /** `plugins/*` directories no declared source resolved to, relative to the root. */
+    undeclared: string[];
+    /**
+     * Paths INSIDE a validated plugin the walk refused to open because their
+     * real path lies outside the root (a `skills/` link, a skill dir link, a
+     * `SKILL.md` or `plugin.json` link pointing out), relative to the root.
+     * Empty when the manifest failed: the run never reached a plugin.
+     */
+    refused: string[];
     /**
      * Manifest, required-file, plugin and skill issues, in report order, with
      * every severity already resolved against the governing project's
      * `validation.severity` map.
      */
     issues: ValidationIssue[];
-    /**
-     * The run's overall status — the value the command's exit code is derived
-     * from (`error` → 1, otherwise 0), and the status `vat verify` reads back as
-     * this phase's status.
-     *
-     * Computed here rather than by the caller so it cannot be derived from a
-     * different issue set than the one reported. A promote-to-`error` override
-     * that moved a severity without moving this would be half-wired: the finding
-     * would read `error` while the run still exited 0.
-     */
-    status: 'success' | 'warning' | 'error';
 }
 /**
  * Run every validator this command reports on, each anchored at
@@ -54,10 +67,13 @@ export interface MarketplaceFindings {
  *
  * Severity resolution is likewise INSIDE this function rather than a step the
  * command adds after it. Its absence is the whole defect this addressed, and a
- * command-body step is one a caller can forget: with it here, `status`, the
- * exit code, the flat `issues` list and `plugins[].issues` all derive from a
- * single resolved set, and the smallest testable entry point is the one that
- * includes the filter.
+ * command-body step is one a caller can forget: with it here, the flat `issues`
+ * list and `plugins[].issues` derive from a single resolved set, and the
+ * smallest testable entry point is the one that includes the filter. The run's
+ * `status` — and with it the exit code — is derived one step later, in
+ * {@link buildMarketplaceValidateReport}, from the issues the document actually
+ * publishes: that is where the run-integrity refusal is added, and a status
+ * computed here would not see it.
  *
  * Exported so that contract is testable against a real marketplace without a
  * CLI spawn; the command adds only the exit code and the emission.
@@ -69,7 +85,6 @@ export interface MarketplaceFindings {
 export declare function collectMarketplaceFindings(marketplacePath: string, logger: ReturnType<typeof createLogger>): Promise<MarketplaceFindings>;
 /** Everything the emitted report is built from. */
 export interface MarketplaceValidateReportInput {
-    status: 'success' | 'warning' | 'error';
     /**
      * The marketplace directory: the ONE base every reported `path` AND every
      * issue `location` is relative to.
@@ -84,10 +99,29 @@ export interface MarketplaceValidateReportInput {
      */
     root: string;
     marketplace: ValidationResult['metadata'];
-    pluginResults: readonly ValidationResult[];
+    /**
+     * One entry per DECLARED local plugin the run validated, each naming the
+     * manifest entry it satisfies. Compared against `marketplace.localPluginSources`
+     * by the builder: a declared source with no entry here did not resolve.
+     */
+    pluginResults: readonly LocalPluginResult[];
+    /** `plugins/*` directories no declared source resolved to; listed, never graded. */
+    undeclared: readonly string[];
+    /**
+     * Root-relative paths inside a validated plugin the walk refused to open
+     * because their real path lies outside the root. Required, not optional: a
+     * caller that cannot say is a caller whose walk may have left the root
+     * unrecorded, and the builder turns a non-empty list into the run-integrity
+     * refusal.
+     */
+    refused: readonly string[];
     issues: readonly ValidationIssue[];
-    issueCounts: SeverityCounts;
-    summary: string;
+    /**
+     * The manifest's own summary, present iff the run bailed on the manifest. A
+     * bailed run reports WHY it stopped; a completed run reports what it found,
+     * and the builder writes that counts line itself.
+     */
+    bailSummary?: string;
     duration: string;
     /**
      * Publish the flat per-issue list instead of the per-location summary.
@@ -133,6 +167,23 @@ export declare function summarizeIssuesByLocation(issues: readonly ValidationIss
  * is therefore only as true as its inputs — see `root` above — and is enforced
  * against a real marketplace in `payload-path-coordinates.test.ts`, not here.
  */
-export declare function buildMarketplaceValidateReport(input: MarketplaceValidateReportInput): Record<string, unknown>;
+export declare function buildMarketplaceValidateReport(input: MarketplaceValidateReportInput): MarketplaceValidateReport;
+/** The document `vat claude marketplace validate` publishes. */
+export interface MarketplaceValidateReport extends Record<string, unknown> {
+    status: ReturnType<typeof calculateValidationStatus>;
+    pluginsValidated: number;
+}
+/**
+ * Validate a marketplace and hand back its document and exit code, printing
+ * nothing on stdout.
+ *
+ * The phase entry point for `vat verify`, which runs this once per configured
+ * marketplace IN ITS OWN PROCESS. Progress and findings still go to stderr as
+ * they always did; only the decision of where the document lands moves to the
+ * caller — stdout for a command-line run, `phases[].report` for an orchestrated
+ * one.
+ */
+export declare function runMarketplaceValidatePhase(targetPath: string | undefined, options: MarketplaceValidateOptions): Promise<PhaseOutcome>;
 export declare function createMarketplaceValidateCommand(): Command;
+export {};
 //# sourceMappingURL=validate.d.ts.map

package/dist/commands/claude/marketplace/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/commands/claude/marketplace/validate.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAKH,OAAO,EAGL,KAAK,cAAc,EAEnB,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAEhG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAiKxD,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,6EAA6E;IAC7E,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC;;;;OAIG;IACH,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B;;;;;;;;;OASG;IACH,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,0BAA0B,CAC9C,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GACtC,OAAO,CAAC,mBAAmB,CAAC,CAqC9B;AAED,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1C,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,WAAW,EAAE,cAAc,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgBD,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG;IACvD,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,eAAe,EAAE,GACjC,oBAAoB,EAAE,CAiBxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,8BAA8B,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;AA4CD,wBAAgB,gCAAgC,IAAI,OAAO,CAqC1D"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/commands/claude/marketplace/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,yBAAyB,EAIzB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAEhG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAExE,UAAU,0BAA0B;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA6GD,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAyQD,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,6EAA6E;IAC7E,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,oFAAoF;IACpF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,0BAA0B,CAC9C,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GACtC,OAAO,CAAC,mBAAmB,CAAC,CAqC9B;AAED,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1C;;;;OAIG;IACH,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,oFAAoF;IACpF,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;;;;OAMG;IACH,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgBD,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG;IACvD,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,eAAe,EAAE,GACjC,oBAAoB,EAAE,CAiBxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,8BAA8B,GACpC,yBAAyB,CAiD3B;AAED,gEAAgE;AAChE,MAAM,WAAW,yBAA0B,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxE,MAAM,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;IACrD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAmFD;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,YAAY,CAAC,CAsCvB;AAWD,wBAAgB,gCAAgC,IAAI,OAAO,CAwD1D"}