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

package/schemas/resources-check.json

@@ -0,0 +1,229 @@
+{
+  "$ref": "#/definitions/resources-check",
+  "definitions": {
+    "resources-check": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "ok",
+            "findings",
+            "error"
+          ]
+        },
+        "examined": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "findings": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              },
+              "location": {
+                "type": "string"
+              },
+              "line": {
+                "type": "integer",
+                "exclusiveMinimum": 0
+              },
+              "field": {
+                "type": "string"
+              },
+              "link": {
+                "type": "string"
+              },
+              "fix": {
+                "type": "string"
+              },
+              "reference": {
+                "type": "string"
+              },
+              "suggestion": {
+                "type": "string"
+              },
+              "severity": {
+                "type": "string",
+                "enum": [
+                  "error",
+                  "warning",
+                  "info"
+                ]
+              },
+              "column": {
+                "type": "integer",
+                "exclusiveMinimum": 0
+              }
+            },
+            "required": [
+              "code",
+              "message",
+              "severity"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "summary": {
+          "type": "object",
+          "properties": {
+            "errors": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "warnings": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "info": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "errors",
+            "warnings",
+            "info"
+          ],
+          "additionalProperties": false
+        },
+        "durationMs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "error": {
+          "type": "string"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "root": {
+                  "type": "string"
+                },
+                "population": {
+                  "type": "string",
+                  "enum": [
+                    "derived",
+                    "store"
+                  ]
+                },
+                "populationSecs": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "lensSecs": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "lensesEvaluated": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "boundsStatement": {
+                  "type": "string"
+                },
+                "limits": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "string"
+                      },
+                      "direction": {
+                        "type": "string",
+                        "enum": [
+                          "over-report",
+                          "under-report",
+                          "scope",
+                          "assumption"
+                        ]
+                      },
+                      "statement": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "id",
+                      "direction",
+                      "statement"
+                    ],
+                    "additionalProperties": false
+                  }
+                },
+                "checksRun": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "checks": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "name": {
+                        "type": "string"
+                      },
+                      "durationSecs": {
+                        "type": "number",
+                        "minimum": 0
+                      },
+                      "rows": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      "broken": {
+                        "type": "boolean",
+                        "const": true
+                      },
+                      "builtin": {
+                        "type": "boolean",
+                        "const": true
+                      }
+                    },
+                    "required": [
+                      "name",
+                      "durationSecs"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "root",
+                "population",
+                "populationSecs",
+                "lensSecs",
+                "lensesEvaluated",
+                "checksRun",
+                "checks"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "status",
+        "examined",
+        "findings",
+        "summary",
+        "data"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/schemas/skill-review.json

@@ -0,0 +1,230 @@
+{
+  "$ref": "#/definitions/skill-review",
+  "definitions": {
+    "skill-review": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "ok",
+            "findings",
+            "error"
+          ]
+        },
+        "examined": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "findings": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "code": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              },
+              "location": {
+                "type": "string"
+              },
+              "line": {
+                "type": "integer",
+                "exclusiveMinimum": 0
+              },
+              "field": {
+                "type": "string"
+              },
+              "link": {
+                "type": "string"
+              },
+              "fix": {
+                "type": "string"
+              },
+              "reference": {
+                "type": "string"
+              },
+              "suggestion": {
+                "type": "string"
+              },
+              "severity": {
+                "type": "string",
+                "enum": [
+                  "error",
+                  "warning",
+                  "info"
+                ]
+              },
+              "column": {
+                "type": "integer",
+                "exclusiveMinimum": 0
+              }
+            },
+            "required": [
+              "code",
+              "message",
+              "severity"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "summary": {
+          "type": "object",
+          "properties": {
+            "errors": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "warnings": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "info": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "errors",
+            "warnings",
+            "info"
+          ],
+          "additionalProperties": false
+        },
+        "durationMs": {
+          "type": "number",
+          "minimum": 0
+        },
+        "error": {
+          "type": "string"
+        },
+        "data": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "skill": {
+                  "type": "string"
+                },
+                "source": {
+                  "type": "string"
+                },
+                "metadata": {
+                  "type": "object",
+                  "properties": {
+                    "skillLines": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "totalLines": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "fileCount": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "directFileCount": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "maxLinkDepth": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "excludedReferenceCount": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "excludedReferences": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "path": {
+                            "type": "string"
+                          },
+                          "reason": {
+                            "type": "string"
+                          },
+                          "matchedPattern": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "path",
+                          "reason"
+                        ],
+                        "additionalProperties": false
+                      }
+                    }
+                  },
+                  "required": [
+                    "skillLines",
+                    "totalLines",
+                    "fileCount",
+                    "directFileCount",
+                    "maxLinkDepth",
+                    "excludedReferenceCount",
+                    "excludedReferences"
+                  ],
+                  "additionalProperties": false
+                },
+                "sections": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "section": {
+                        "type": "string"
+                      },
+                      "codes": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "manual": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "required": [
+                      "section",
+                      "codes",
+                      "manual"
+                    ],
+                    "additionalProperties": false
+                  }
+                }
+              },
+              "required": [
+                "skill",
+                "source",
+                "metadata",
+                "sections"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "status",
+        "examined",
+        "findings",
+        "summary",
+        "data"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/commands/claude/budget.d.ts

@@ -1,170 +0,0 @@
-/**
- * `vat claude budget [paths...]` — is the always-loaded context at a working
- * location over its budget?
- *
- * ## Why this is a command and not a check inside `vat resources validate`
- *
- * It used to be one: default-on, with a `--no-context-budget` opt-out. That is
- * gone, in both directions — `vat resources validate` has no knowledge of the
- * budget at all any more, not a flag, not a default. The ruling behind the move
- * is short: *a validation run must not emit findings nobody asked for.* An
- * `info` finding attached to a lane people run for link and anchor errors is a
- * finding they scroll past, and a check people scroll past is a check they
- * eventually silence.
- *
- * ## The sibling split: `context` QUERIES, `budget` CHECKS
- *
- * `vat claude context` answers a question and
- * never gates — totals, admissions, the declared limits, no verdict, always
- * exit 0. This command is the other half of that pair: it applies a THRESHOLD,
- * produces findings with severities an adopter can configure, and lets an
- * adopter who promotes the code to `error` fail their build with it. Two verbs
- * because they are two acts, and folding a verdict into the query would make
- * the query's number a number people learn to stop reading.
- *
- * ## Everything below is orchestration — deliberately
- *
- * Which directories exist, what each pays, and whether that is over budget are
- * all decided in `@vibe-agent-toolkit/resources` (`buildClaudeContextPopulation`
- * and `sweepAlwaysLoadedBudgets`); the wording and grouping of the findings in
- * `utils/context-budget-issues.ts`; severity resolution in the two shared
- * filters every other lane runs. This module populates one tree, calls them in
- * order, and renders. It decides nothing about context loading of its own,
- * which is the CLI-stays-dumb rule applied to the lane where the temptation is
- * strongest.
- *
- * ⛔ The threshold is never re-spelled here. It is a MEASURED quantity that
- * lives beside the detector (`DEFAULT_ALWAYS_LOADED_CONTEXT_TOKENS`), and a
- * literal in this package would be a second source of truth that nothing
- * compares.
- *
- * ## The stated bounds ride ONCE on the REPORT, in every format
- *
- * The sibling query publishes 23 stated limits; this command applies a threshold
- * to the same measurement, so it publishes {@link ALWAYS_LOADED_BUDGET_LIMITS}
- * and {@link CLAUDE_CONTEXT_BOUNDS_STATEMENT} beside its verdict — the half that
- * GATES is the half whose bounds a reader most needs. Both are imported, never
- * restated: the sentence is domain content owned beside the list it frames.
- *
- * ⛔ They belong to the REPORT, never to a finding. A per-finding copy is the
- * defect this lane already shipped once on the query side, and it is invisible to
- * any assertion that checks presence rather than counting occurrences.
- */
-import { type BudgetSweep, type StatedLimit } from '@vibe-agent-toolkit/resources';
-import { type SeverityCounts, type ValidationIssue } from '@vibe-agent-toolkit/schema';
-import { Command } from 'commander';
-/** How the report is rendered. `text` is for a person; the other two are for a program. */
-export type BudgetOutputFormat = 'text' | 'yaml' | 'json';
-/** Flags `vat claude budget` accepts. */
-export interface ClaudeBudgetOptions {
-    format?: BudgetOutputFormat;
-    debug?: boolean;
-}
-/**
- * The report one run emits.
- *
- * The three sweep counters ride beside the findings and describe the WHOLE
- * tree, not the scope: a scope narrows what is reported, never what was
- * measured. Publishing them is what keeps an empty `findings` legible — "9
- * chains checked, none over budget" and "nothing was checked" are different
- * answers and must not render identically.
- */
-export interface BudgetReport {
-    readonly root: string;
-    /** The budget every chain was measured against, in tokens. */
-    readonly threshold: number;
-    /** The root-relative directories asked about. `''` is the whole tree. */
-    readonly scope: readonly string[];
-    /** Requested paths that named no working location — see `scopeSweepToPaths`. */
-    readonly unmatchedScope: readonly string[];
-    readonly status: 'success' | 'warning' | 'error';
-    readonly issueCounts: SeverityCounts;
-    /** Working locations the sweep evaluated, across the whole tree. */
-    readonly workingLocations: number;
-    /** Distinct instruction chains among them — the queries the sweep really issued. */
-    readonly distinctChains: number;
-    /** Locations whose representative the projection never realized. Counted, never zeroed. */
-    readonly skippedUnknownLocations: number;
-    /**
-     * One finding per over-budget chain — plus, ahead of them, the run-integrity
-     * refusal when part of what was asked about was never measured. See
-     * {@link buildReport}: the second kind is DERIVED here rather than passed in,
-     * so no report can carry an unmatched path and a clean status.
-     */
-    readonly findings: readonly ValidationIssue[];
-    /**
-     * What this verdict does not settle, in either direction. Stated ONCE.
-     *
-     * ⛔ On the report beside `threshold`, never on a finding. These bound the
-     * MEASUREMENT METHOD, not any one chain — a finding carrying its own copy
-     * reads as though that chain had caveats of its own, and repeated across a
-     * sweep it is pure byte-identical duplication.
-     */
-    readonly boundsStatement: string;
-    /** The signed over/under-report bounds on the method. Stated ONCE. */
-    readonly limits: readonly StatedLimit[];
-}
-/**
- * Create the `vat claude budget [paths...]` command.
- *
- * @returns The configured Commander command
- */
-export declare function createBudgetCommand(): Command;
-/**
- * Action handler for `vat claude budget [paths...]`.
- *
- * @param pathArgs - Directories to check; empty means the whole tree
- * @param options - The command's flags
- */
-export declare function claudeBudgetCommand(pathArgs: readonly string[], options: ClaudeBudgetOptions): Promise<void>;
-/** Everything {@link buildReport} needs, bundled past the lint gate's parameter ceiling. */
-export interface ReportInput {
-    readonly root: string;
-    readonly threshold: number;
-    readonly scope: readonly string[];
-    readonly sweep: BudgetSweep;
-    readonly scoped: {
-        readonly unmatchedScope: readonly string[];
-    };
-    /** The BUDGET findings only. The run-integrity refusal is derived, not passed. */
-    readonly findings: readonly ValidationIssue[];
-}
-/**
- * Assemble the report from the run's parts.
- *
- * ⛔ The counters come from the UNSCOPED sweep. They answer "what was measured",
- * and a scope changes only what is reported — sourcing them from the narrowed
- * view would let `vat claude budget docs` claim the tree has one chain.
- *
- * ⛔ This is the ONE place the stated bounds enter the machine-readable output,
- * and keeping it a single assignment is what makes "stated once" structural
- * rather than a habit: there is no per-finding site left where a copy could be
- * reintroduced. They are attached unconditionally — a run that flagged nothing
- * used the same method, and a reader acting on "within budget" needs them most.
- *
- * ⛔ Exported so it can be TESTED. What has to be pinned is a COUNT — that the
- * block appears exactly once across a MULTI-finding report — and a presence
- * check passes identically with a copy per finding.
- *
- * ⛔ The run-integrity refusal is DERIVED here from `scoped.unmatchedScope`
- * rather than assembled by the caller, which is what makes "a run that checked
- * nothing never reports success" unrepresentable instead of merely observed:
- * there is no pipeline step left in which a later edit could drop it. See
- * {@link nothingCheckedFindings}.
- *
- * @param input - The run's parts
- * @returns The report, ready to serialize
- */
-export declare function buildReport(input: ReportInput): BudgetReport;
-/**
- * Render the report for a person.
- *
- * ⛔ Exported so the "stated once" property can be pinned in TEXT as well as in
- * json. The two renderings are separate code paths and this lane has already
- * shipped a defect where they disagreed while each looked right alone.
- *
- * @param report - The report
- * @returns The text rendering, newline-terminated
- */
-export declare function renderReportText(report: BudgetReport): string;
-//# sourceMappingURL=budget.d.ts.map

package/dist/commands/claude/budget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/commands/claude/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAuB5C,2FAA2F;AAC3F,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1D,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,oFAAoF;IACpF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2FAA2F;IAC3F,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C;;;;;;;OAOG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAuE7C;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAChE,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAmB5D;AAsID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAY7D"}