vigiles 9.0.0 → 10.0.0

package/dist/audit-report.d.ts

@@ -14,13 +14,22 @@
 import { type AuditScore } from "./audit-score.js";
 import { type Recommendation } from "./optimize.js";
 import type { AdoptabilityResult } from "./adoptability.js";
-import type { ScanReport } from "./scan.js";
+import type { ScanReport, MarketplaceInfo } from "./scan.js";
+import type { PluginScore } from "./leaderboard.js";
 /** The current schema version. Bump only on a BREAKING change to the shape. */
 export declare const AUDIT_SCHEMA_VERSION = 1;
 export interface AuditReportMeta {
     /** Wire-format version — consumers gate on this. */
     readonly schemaVersion: typeof AUDIT_SCHEMA_VERSION;
     readonly tool: "vigiles";
+    /**
+     * Discriminates the three `audit --json` shapes a consumer may receive:
+     * `audit` (one plugin → {@link AuditReport}), `leaderboard` (a marketplace /
+     * multiple dirs → {@link LeaderboardReport}), `marketplace` (a curated,
+     * all-external marketplace → {@link MarketplaceReport}). Always present so the
+     * JSON is self-describing.
+     */
+    readonly kind: "audit";
     /** The vigiles version that produced the report. */
     readonly vigilesVersion: string;
     /** The detected/selected harness (`claude-code`, `codex`, …). */
@@ -39,6 +48,29 @@ export interface AuditInventory {
     readonly mcp: boolean;
     readonly untested: number;
 }
+/**
+ * A surface (skill / subagent / instruction file) that EXISTS but doesn't yet
+ * have a `.spec.ts` — so it can be adopted into a typed spec. The report can't
+ * write files (it's a browser app), so it EMITS the exact CLI command instead.
+ */
+export interface AdoptableSurface {
+    /** The repo-relative path of the surface (e.g. `skills/foo/SKILL.md`). */
+    readonly path: string;
+    /** The exact command that adopts this one surface. */
+    readonly command: string;
+}
+/**
+ * The adoptable-surfaces list + the "create all" command — the data the report's
+ * "Create spec" / "Create all specs" affordances copy to the clipboard. Present
+ * only when there's at least one un-spec'd surface; the CLI computes the surface
+ * paths (the layout-aware `discoverAdoptableSurfaces`) and passes them in, so the
+ * pure builder stays adapter-agnostic.
+ */
+export interface Adoptable {
+    readonly surfaces: readonly AdoptableSurface[];
+    /** The one command that adopts every surface at once. */
+    readonly createAllCommand: string;
+}
 /**
  * The full audit, as the dashboard / CI / HTML all consume it. Self-describing
  * and versioned; additive-only within a `schemaVersion`.
@@ -56,10 +88,24 @@ export interface AuditReport {
      * Additive/optional, so the schema version is unchanged.
      */
     readonly adoptability?: AdoptabilityResult;
+    /**
+     * The surfaces that exist but aren't spec-managed yet, each with the command
+     * that adopts it, plus a "create all" command. Drives the report's "Create
+     * spec" / "Create all specs" command-emit buttons. Present only when there's
+     * at least one adoptable surface. Additive/optional — schema version unchanged.
+     */
+    readonly adoptable?: Adoptable;
 }
 export interface BuildAuditReportOptions {
     readonly harness: string;
     readonly vigilesVersion: string;
+    /**
+     * The repo-relative paths of surfaces that exist but have no `.spec.ts` yet,
+     * computed by the CLI's layout-aware `discoverAdoptableSurfaces` (so the pure
+     * builder stays adapter-agnostic — it only formats the commands). Omit/empty
+     * when there's nothing to adopt.
+     */
+    readonly adoptableSurfaces?: readonly string[];
 }
 /**
  * Assemble the versioned {@link AuditReport} from a scan report — pure, no clock.
@@ -67,4 +113,51 @@ export interface BuildAuditReportOptions {
  * HTML-embedded form omits it so the rendered file stays deterministic.
  */
 export declare function buildAuditReport(report: ScanReport, opts: BuildAuditReportOptions): AuditReport;
+/**
+ * The versioned envelope for a `audit --json` run over MULTIPLE plugins (a
+ * marketplace expanded into its members, or several dirs) — the leaderboard.
+ * Shares the same `meta.schemaVersion`/`tool`/`kind` self-description as
+ * {@link AuditReport} so every `audit --json` shape is a versioned object, never
+ * a bare array. `kind:"leaderboard"` is the discriminant; `plugins` carries the
+ * ranked per-plugin scores.
+ */
+export interface LeaderboardReport {
+    readonly meta: {
+        readonly schemaVersion: typeof AUDIT_SCHEMA_VERSION;
+        readonly tool: "vigiles";
+        readonly kind: "leaderboard";
+        readonly vigilesVersion: string;
+        /** The marketplace / parent dir that was expanded and ranked. */
+        readonly dir: string;
+        readonly generatedAt?: string;
+    };
+    readonly plugins: readonly PluginScore[];
+}
+/** Assemble the versioned {@link LeaderboardReport} — pure, no clock. */
+export declare function buildLeaderboardReport(plugins: readonly PluginScore[], opts: {
+    vigilesVersion: string;
+    dir: string;
+}): LeaderboardReport;
+/**
+ * The versioned envelope for a `audit --json` run on a CURATED marketplace whose
+ * members are all external (git/url, nothing on disk to scan). Wraps the
+ * {@link MarketplaceInfo} inventory so this path, too, emits a versioned object
+ * rather than a raw, unversioned struct. `kind:"marketplace"` is the discriminant.
+ */
+export interface MarketplaceReport {
+    readonly meta: {
+        readonly schemaVersion: typeof AUDIT_SCHEMA_VERSION;
+        readonly tool: "vigiles";
+        readonly kind: "marketplace";
+        readonly vigilesVersion: string;
+        readonly dir: string;
+        readonly generatedAt?: string;
+    };
+    readonly marketplace: MarketplaceInfo;
+}
+/** Assemble the versioned {@link MarketplaceReport} — pure, no clock. */
+export declare function buildMarketplaceReport(marketplace: MarketplaceInfo, opts: {
+    vigilesVersion: string;
+    dir: string;
+}): MarketplaceReport;
 //# sourceMappingURL=audit-report.d.ts.map

package/dist/audit-report.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AUDIT_SCHEMA_VERSION = void 0;
 exports.buildAuditReport = buildAuditReport;
+exports.buildLeaderboardReport = buildLeaderboardReport;
+exports.buildMarketplaceReport = buildMarketplaceReport;
 /**
  * The `AuditReport` — the versioned JSON contract that IS the audit's product
  * boundary. Everything renders FROM it: the local self-contained HTML report,
@@ -19,16 +21,37 @@ const audit_score_js_1 = require("./audit-score.js");
 const optimize_js_1 = require("./optimize.js");
 /** The current schema version. Bump only on a BREAKING change to the shape. */
 exports.AUDIT_SCHEMA_VERSION = 1;
+/** The one command that adopts every un-spec'd surface (bare `init`). */
+const CREATE_ALL_COMMAND = "npx vigiles init";
+/** The command that adopts ONE surface at a given repo-relative path. */
+function adoptCommand(path) {
+    return `npx vigiles init --target=${path}`;
+}
+/**
+ * Build the {@link Adoptable} payload from the layout-aware surface paths — pure,
+ * just formats the per-surface + create-all commands. Returns `undefined` when
+ * there's nothing to adopt (so the field stays absent).
+ */
+function buildAdoptable(surfaces) {
+    if (!surfaces || surfaces.length === 0)
+        return undefined;
+    return {
+        surfaces: surfaces.map((path) => ({ path, command: adoptCommand(path) })),
+        createAllCommand: CREATE_ALL_COMMAND,
+    };
+}
 /**
  * Assemble the versioned {@link AuditReport} from a scan report — pure, no clock.
  * The CLI attaches `meta.generatedAt` when it writes the JSON artifact; the
  * HTML-embedded form omits it so the rendered file stays deterministic.
  */
 function buildAuditReport(report, opts) {
+    const adoptable = buildAdoptable(opts.adoptableSurfaces);
     return {
         meta: {
             schemaVersion: exports.AUDIT_SCHEMA_VERSION,
             tool: "vigiles",
+            kind: "audit",
             vigilesVersion: opts.vigilesVersion,
             harness: opts.harness,
             dir: report.dir,
@@ -46,6 +69,33 @@ function buildAuditReport(report, opts) {
             mcp: report.mcp,
             untested: report.untested,
         },
+        ...(adoptable ? { adoptable } : {}),
+    };
+}
+/** Assemble the versioned {@link LeaderboardReport} — pure, no clock. */
+function buildLeaderboardReport(plugins, opts) {
+    return {
+        meta: {
+            schemaVersion: exports.AUDIT_SCHEMA_VERSION,
+            tool: "vigiles",
+            kind: "leaderboard",
+            vigilesVersion: opts.vigilesVersion,
+            dir: opts.dir,
+        },
+        plugins,
+    };
+}
+/** Assemble the versioned {@link MarketplaceReport} — pure, no clock. */
+function buildMarketplaceReport(marketplace, opts) {
+    return {
+        meta: {
+            schemaVersion: exports.AUDIT_SCHEMA_VERSION,
+            tool: "vigiles",
+            kind: "marketplace",
+            vigilesVersion: opts.vigilesVersion,
+            dir: opts.dir,
+        },
+        marketplace,
     };
 }
 //# sourceMappingURL=audit-report.js.map