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

package/dist/commands/resources/check.js.map

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

package/dist/commands/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAK5C,wBAAgB,sBAAsB,IAAI,OAAO,CA+PhD;AAED,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AA8B5C,wBAAgB,sBAAsB,IAAI,OAAO,CAkgBhD;AAED,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC"}

package/dist/commands/resources/index.js

@@ -2,8 +2,30 @@
  * Resources command group
  */
 import { Command, Option } from 'commander';
+import { checkCommand } from './check.js';
+import { queryCommand } from './query.js';
 import { scanCommand } from './scan.js';
 import { validateCommand } from './validate.js';
+/** What every subcommand's `--debug` flag says it does. */
+const DEBUG_HELP = 'Enable debug logging';
+/** The two serializations `scan` and `query` offer of one document. */
+const OUTPUT_YAML = 'yaml';
+const OUTPUT_JSON = 'json';
+/**
+ * The `--format` option `scan` and `query` share.
+ *
+ * A factory rather than a shared instance: Commander mutates an `Option` as it
+ * is added, so one object handed to two commands is one object two commands
+ * disagree about. `validate` deliberately does NOT use this — it offers a third
+ * format, `text`, which is a different question.
+ *
+ * @returns A fresh option for one command
+ */
+function yamlOrJsonFormat() {
+    return new Option('--format <format>', 'Output format: yaml (default) or json')
+        .choices([OUTPUT_YAML, OUTPUT_JSON])
+        .default(OUTPUT_YAML);
+}
 export function createResourcesCommand() {
     const resources = new Command('resources');
     resources
@@ -19,13 +41,10 @@ Configuration:
     resources
         .command('scan [path]')
         .description('Discover markdown resources in directory')
-        .option('--debug', 'Enable debug logging')
+        .option('--debug', DEBUG_HELP)
         .option('--verbose', 'Show full file list with details')
         .option('--collection <id>', 'Filter by collection ID')
-        .addOption(new Option('--format <format>', 'Output format: yaml (default) or json').choices([
-        'yaml',
-        'json',
-    ]).default('yaml'))
+        .addOption(yamlOrJsonFormat())
         .action(scanCommand)
         .addHelpText('after', `
 Description:
@@ -59,11 +78,263 @@ Examples:
   $ vat resources scan docs/                    # Scan all *.md under docs/
   $ vat resources scan --verbose                # Include full file details
   $ vat resources scan --collection guides      # Only scan guides collection
+`);
+    resources
+        .command('query <sql> [path]')
+        .description('Run one read-only SQL statement against the resource projection')
+        .option('--debug', DEBUG_HELP)
+        .option('--param <values...>', 'Values bound in order to the ? placeholders in the statement')
+        .addOption(yamlOrJsonFormat())
+        .action(queryCommand)
+        .addHelpText('after', `
+Description:
+  Populates this tree's resource projection and runs ONE read-only SQL
+  statement against it. Answers questions no command reports a field for --
+  which files carry which headings, what links at what, which paths were
+  refused and why.
+
+  One tree, one answer. The statement always runs against an in-memory
+  database holding THIS tree's projection and nothing else. A selected
+  projection store makes the population cheap and is never queried -- it is
+  one database per VAT release shared by every root on the machine.
+
+The corpus is the TRACKED TREE, not your configured resource set:
+  The projection holds every file git tracks (plus untracked, non-ignored
+  work). .gitignore IS honoured -- nothing under node_modules reaches it.
+  resources.include and resources.exclude are NOT: they scope vat resources
+  scan and vat resources validate, and the projection ignores them.
+
+  Measured on one adopter: scan reported 1,473 files and the projection held
+  11,685 members, including 142 rows under a path that config excluded.
+
+  That is what a projection IS -- the tree, not a view of it -- and it is what
+  makes a query able to ask about files no collection claims. But it means a
+  WHERE clause is the only thing narrowing your statement. Write the exclusion
+  into the SQL:
+
+    SELECT path FROM resource_realizations
+     WHERE path NOT LIKE 'docs/architecture/adrs/archive/%'
+
+One query, and read-only:
+  The statement must BE a query -- its first significant token has to be
+  SELECT, WITH or VALUES. Anything else (ATTACH, PRAGMA, DELETE, EXPLAIN) is
+  refused before it reaches SQLite. That is a gate on statement KIND and
+  deliberately not an inspection of your SQL; EXPLAIN is excluded even though
+  it is side-effect free, because admitting a prefix keyword would mean
+  deciding safety by looking PAST the first token.
+
+  Read-only-ness stays the engine's job: the connection is put into PRAGMA
+  query_only, so a write is refused by SQLite rather than by pattern-matching.
+
+  One statement only -- SQLite compiles the first and discards the rest WITHOUT
+  error, so trailing text would be silently ignored. A comment after the
+  terminating semicolon is fine ('SELECT 1;  -- see ADR-14').
+
+Output Fields:
+  status, root, rowCount, durationSecs
+  population: 'derived' or 'store' -- whether the rows were built this run or
+              read from the projection store. Reported because it cannot be
+              inferred: a correct hit and a correct re-derivation produce
+              identical rows
+  populationSecs:
+              What that population cost. The store's whole job is to make it
+              cheap, so this is the number that says whether it did
+  rows:       The selected rows, exactly as SQLite holds them -- a boolean as
+              0/1, a date and a JSON column as text. Values are NOT decoded,
+              because decoding needs a table spec and arbitrary SQL has none
+
+Exit Codes:
+  0 - The statement ran  |  2 - The statement was refused, or the crawl failed
+
+Requirements:
+  projectRoot: optional (falls back to cwd with a warning)
+  config:      optional (uses defaults if absent)
+
+Examples:
+  $ vat resources query 'SELECT path FROM resource_realizations LIMIT 5'
+  $ vat resources query 'SELECT COUNT(*) AS n FROM blobs'
+  $ vat resources query 'SELECT * FROM blob_conditions'      # what was refused
+  $ vat resources query 'SELECT target FROM blob_references WHERE kind = ?' --param markdown-link
+`);
+    resources
+        .command('check [path]')
+        .description('Run the project\'s declared SQL assertions over its resource projection')
+        .option('--debug', DEBUG_HELP)
+        .option('--check <name>', 'Run only this check, by its key in resources.checks')
+        .option('--budget <seconds>', 'Kill the run if it goes this long without completing a unit of work'
+        + ' (default: 300; 0 removes the bound and can then hang forever)')
+        .addOption(
+    // Hidden because it is not an operator's flag: it is how a supervising
+    // parent tells the child it spawned to do the work rather than spawn one
+    // of its own, and where to append its progress. Documenting it would
+    // invite adopters to depend on a file whose only contract is the
+    // `.strict()` schema the same build reads it with.
+    new Option('--cost-log <path>', 'Internal: append per-unit progress here').hideHelp())
+        .addOption(yamlOrJsonFormat())
+        .action(checkCommand)
+        .addHelpText('after', `
+Description:
+  Runs every assertion declared under \`resources.checks\` in
+  vibe-agent-toolkit.config.yaml against the same projection \`vat resources
+  query\` reads, and fails the run when any error-severity check is violated.
+
+  A query answers a question once. This runs the questions a project decided
+  were worth asking every time.
+
+Declaring a check:
+  resources:
+    checks:
+      orphan-skills:
+        description: Every SKILL.md must be referenced by a plugin
+        sql: SELECT path FROM resource_realizations WHERE ...
+        severity: error        # optional; error is the default
+
+  The statement selects the VIOLATIONS -- zero rows is a pass. Each returned
+  row becomes one finding, and its columns are that finding's evidence; a
+  selected \`path\` column anchors the finding to the file.
+
+  Findings are ordinary validation issues with the code CUSTOM:<name>, so
+  resources.validation.severity can downgrade or ignore one you inherited.
+
+  A check's SQL runs through the same surface as vat resources query, so
+  the same rule applies: it must be a query, beginning SELECT, WITH or VALUES.
+  A comment after the terminating semicolon is accepted.
+
+A check that cannot run FAILS:
+  A renamed column breaks a check's SQL. That is reported as an error naming
+  the check and listing the columns the projection actually has -- never
+  skipped, because a check that stopped running looks exactly like one that
+  passed.
+
+  That report carries the code RESOURCE_CHECK_BROKEN, and NO
+  resources.validation.severity entry can silence it -- the config schema
+  refuses it as a severity key. Downgrade or ignore the CHECK all you like;
+  you cannot downgrade the news that it stopped checking.
+
+Checks run over the TRACKED TREE, not your configured resource set:
+  resources.include and resources.exclude scope vat resources scan and vat
+  resources validate. They do NOT scope the projection, so they do not scope
+  a check. .gitignore IS honoured -- nothing under node_modules reaches it --
+  but a path you excluded in config is still in the corpus and a check will
+  fire on it.
+
+  Measured on one adopter: scan reported 1,473 files while the same tree's
+  projection held 11,685 members, 142 of them under a config-excluded archive
+  directory. A correct "every ADR carries frontmatter" check produced a real
+  false finding on a frozen historical file nobody intends to fix.
+
+  Narrow the check itself -- a WHERE clause is the only scope it has:
+
+    sql: |
+      SELECT path FROM resource_realizations
+       WHERE path LIKE 'docs/architecture/adrs/%'
+         AND path NOT LIKE 'docs/architecture/adrs/archive/%'
+
+A check with NOTHING TO RUN OVER fails the same way:
+  Zero findings is the pass condition, so a run whose projection enumerated no
+  members passed every check while asserting nothing. If checks ran and
+  membersEnumerated is 0, that is reported as RESOURCE_CHECK_BROKEN at error
+  and the run fails. Usual causes: a broad .gitignore pattern, a shallow or
+  sparse CI checkout, or a root that resolved somewhere other than intended.
+  Declaring no checks at all is different -- that stays a warning and exit 0.
+
+A run that HANGS is killed and reported, not waited on:
+  A check's SQL is adopter-authored and unbounded -- an accidental cross join
+  or a WITH RECURSIVE that never terminates runs forever, and nothing inside
+  the process can stop it (the query is synchronous and holds the event loop).
+  So the work runs in a child process and --budget <seconds> bounds it.
+
+  The budget is time WITHOUT PROGRESS, not total runtime: the clock resets
+  every time the run finishes a unit (the population, then each check, then
+  once more when the checks are done and the document is being built). So a
+  large repository with many rules is never at risk while its rules keep
+  finishing. Default 300.
+
+  That per-unit property holds for the CHECKS. It does NOT hold for the
+  population, which reports progress only when it FINISHES -- so for that one
+  unit the budget is a total bound, and a population slower than the budget is
+  killed however healthily it is working. Most of it is one uninterruptible
+  parse stage, so the default is set well above every tree anyone has measured
+  rather than pretending to instrument it. Two MEASURED trees, for scale, and
+  neither of them is yours: VAT's own repository is ~1.2s warm and 33-35s with
+  a cold parse cache; a 9,992-file adopter tree is ~5s warm and 16.5s cold. On
+  a tree much larger than that with a cold parse cache, raise the bound.
+
+  An interrupted run NEVER exits 0 and never looks like a pass. There are two
+  ways to be interrupted and they are reported differently:
+
+    Killed by the budget -- exit 1, status: error, and a RESOURCE_CHECK_BROKEN
+    finding naming the check that was in flight and the bound that was blown.
+
+    Died -- the child ran out of memory materialising a result set (Node aborts
+    with SIGABRT), or something outside killed it (a runner's OOM killer sends
+    SIGKILL, a step timeout or a cancelled job sends SIGTERM), or it crashed in
+    native code (SIGSEGV), or it could not be started at all. Also exit 1,
+    status: error, RESOURCE_CHECK_BROKEN -- naming what ended it, with the
+    remedy that ending actually earns, and saying plainly that raising --budget
+    is not it.
+
+  Either way the checks that COMPLETED keep their entry under checks (including
+  rows), but their individual violations are NOT in issues -- the progress the
+  child records is costs, not findings. Read that issue list as incomplete.
+
+  Interrupted before the population finished, there is no projection and no
+  honest document: that is an operator error (exit 2) saying which of the two
+  happened.
+
+  --budget cannot be combined with --cost-log (exit 2): --cost-log means the
+  work runs in this process, where the budget could not be enforced.
+
+  --budget 0 removes the bound and runs everything in this process. Nothing
+  will then stop a runaway statement. It has to be written exactly 0: an empty
+  --budget, and any other value that PARSES to zero (1e-400 underflows, -0 is
+  negative zero), are refused rather than read as 0 -- an unset shell variable
+  must not silently remove the bound.
+  Ctrl-C still works at a keyboard, because this command installs no signal
+  handler -- do not add one, a process blocked in synchronous SQLite survives
+  SIGINT once a handler exists.
+
+Output Fields:
+  status, root, population, populationSecs, checksRun, membersEnumerated,
+  issueCounts, durationSecs, checks
+  checksRun: How many checks ran. Read it: no findings from four checks and no
+             findings from NO checks are otherwise the same document
+  membersEnumerated:
+             How many members the projection enumerated -- the corpus the
+             checks ran AGAINST, where checksRun is how many rules ran. Four
+             checks over 8,000 files and four over 0 are otherwise the same
+             document, and only one of them is a gate. It counts the TRACKED
+             TREE and not your configured resource set, so it is legitimately
+             far larger than scan's filesScanned -- see the section above
+  checks:    What each check COST -- {name, durationSecs, rows} per check, or
+             {name, durationSecs, broken} for one whose statement threw. rows
+             is what the statement SELECTED, and it is a memory signal: rows
+             are fully materialised. It is not a finding count -- a severity
+             override of 'ignore' drops findings the statement still selected,
+             so sum(rows) and issueCounts legitimately disagree
+  populationSecs:
+             What the shared population cost. It is NOT charged to any check:
+             every check's durationSecs is its own statement and nothing else,
+             so this is the term that reconciles them against durationSecs
+  issues:    One row per violation ({code, severity, message, path?})
+
+Exit Codes:
+  0 - No error-severity findings
+  1 - At least one (a violation, a broken check, an empty corpus, a run killed
+      for making no progress within --budget, or a run whose child DIED)
+  2 - System error, an unknown --check name, an unusable --budget (an empty
+      one, one that means zero without being written 0, or one passed with
+      --cost-log), or a run interrupted before its population completed
+
+Examples:
+  $ vat resources check
+  $ vat resources check --check orphan-skills
+  $ vat resources check --budget 60
 `);
     resources
         .command('validate [path]')
         .description('Validate markdown resources (link integrity, anchors)')
-        .option('--debug', 'Enable debug logging')
+        .option('--debug', DEBUG_HELP)
         .option('-v, --verbose', 'Show all scanned resources, including those without issues')
         .option('--frontmatter-schema <path>', 'Validate frontmatter against JSON Schema file (.json or .yaml)')
         .option('--validation-mode <mode>', 'Validation mode for schemas: strict (default) or permissive', 'strict')

package/dist/commands/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/resources/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,UAAU,sBAAsB;IACpC,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3C,SAAS;SACN,WAAW,CAAC,oEAAoE,CAAC;SACjF,WAAW,CAAC,KAAK,CAAC,CAAC,uDAAuD;SAC1E,WAAW,CACV,OAAO,EACP;;;;;;CAML,CACI,CAAC;IAEJ,SAAS;SACN,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;SACzC,MAAM,CAAC,WAAW,EAAE,kCAAkC,CAAC;SACvD,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,SAAS,CACR,IAAI,MAAM,CAAC,mBAAmB,EAAE,uCAAuC,CAAC,CAAC,OAAO,CAAC;QAC/E,MAAM;QACN,MAAM;KACP,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CACnB;SACA,MAAM,CAAC,WAAW,CAAC;SACnB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCL,CACI,CAAC;IAEJ,SAAS;SACN,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;SACzC,MAAM,CAAC,eAAe,EAAE,4DAA4D,CAAC;SACrF,MAAM,CAAC,6BAA6B,EAAE,gEAAgE,CAAC;SACvG,MAAM,CAAC,0BAA0B,EAAE,6DAA6D,EAAE,QAAQ,CAAC;SAC3G,MAAM,CAAC,mBAAmB,EAAE,8CAA8C,EAAE,MAAM,CAAC;SACnF,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,MAAM,CAAC,uBAAuB,EAAE,yDAAyD,CAAC;SAC1F,MAAM,CAAC,sBAAsB,EAAE,8HAA8H,CAAC;SAC9J,MAAM,CAAC,YAAY,EAAE,0HAA0H,CAAC;SAChJ,MAAM,CAAC,8BAA8B,EAAE,0FAA0F,CAAC;SAClI,MAAM,CAAC,eAAe,CAAC;SACvB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwKL,CACI,CAAC;IAEJ,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/resources/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/resources/query.d.ts

@@ -0,0 +1,89 @@
+/**
+ * `vat resources query` — ask the resource projection a read-only SQL question.
+ *
+ * ## Why a query verb at all, when `scan` already reports counts
+ *
+ * `vat resources scan` answers the questions its payload was written for, and
+ * nothing else. The projection holds twelve tables — realizations, references,
+ * sections, conditions, provenance — and every question about them that nobody
+ * anticipated currently has no answer short of writing a new command. This verb
+ * is the general case: one statement, the rows it selects, no new field.
+ *
+ * ## 🔑 One tree, one answer — and that is now a property, not a promise
+ *
+ * The SQL always runs against a per-run in-memory database holding this tree's
+ * projection and nothing else. A selected projection store makes the POPULATION
+ * cheap and is never queried, because it is one database per VAT release shared
+ * by every root on the machine — querying it answered from other repositories,
+ * with a two-file corpus reporting 5,779 rows instead of 3.
+ * `utils/projection-query.ts`'s header carries the measurement and the reasoning.
+ *
+ * ## 🔑 The document says where its rows came from, and that is the cache tell
+ *
+ * `population` reports whether the projection was **derived** this run or read
+ * from the **store**. It has to be reported, because it cannot be inferred: a
+ * correct hit and a correct re-derivation produce byte-identical rows, so "did
+ * the cache work" is otherwise unfalsifiable — this repository's most repeated
+ * failure. The signal is real rather than declarative: a store hit
+ * short-circuits `populate()` before the builder exists, so no contributor runs
+ * and no timing record is filed. An empty record list IS the hit.
+ *
+ * `populationSecs` sits beside it and says what that origin was worth — the wall
+ * time of the setup both this verb and `vat resources check` pay before either
+ * runs a statement. Measured as that field on this repository with the parse
+ * cache warm: 1.16-1.18 s derived against 0.29-0.31 s served. Without it the
+ * tell is a label a reader has to trust; with it the saving is a number they can
+ * check, and a per-statement cost published elsewhere has something to be read
+ * against. `utils/projection-query.ts` states exactly which work the span covers
+ * and why its start line is load-bearing.
+ *
+ * ## What this verb does NOT do
+ *
+ * It does not decode. Rows come back exactly as SQLite holds them — a boolean as
+ * `0`/`1`, a date and a JSON column as text — because decoding needs a table
+ * spec and arbitrary SQL has none. `SqlQueryableStore.query`'s docstring is the
+ * authority on why.
+ */
+import { type ProjectionProvenance } from '../../utils/projection-query.js';
+interface QueryOptions {
+    debug?: boolean;
+    /** Bound in order, for every `?` in the statement. */
+    param?: string[];
+    /** `yaml` (default) or `json`. Same document either way. */
+    format?: string;
+}
+/** What one query run produced, and what produced it. */
+interface QueryOutcome extends ProjectionProvenance {
+    rows: readonly Record<string, unknown>[];
+}
+export interface ProjectionQueryPayloadInput extends QueryOutcome {
+    /** The stated root the query was asked about. */
+    root: string;
+    durationMs: number;
+}
+/**
+ * Build the query payload.
+ *
+ * Pure: no file system, no clock, no `process.exit` — the same contract
+ * `buildScanOutputData` follows, and for the same reason: it keeps the
+ * document's shape, field names included, under unit test rather than only
+ * under a CLI spawn.
+ *
+ * `rowCount` is stated beside `rows` rather than left for the consumer to
+ * count, because the two answer different questions once a caller pipes the
+ * document somewhere: a truncated read still carries the true total.
+ *
+ * @param input - The rows and the provenance of the run that produced them
+ * @returns The document to serialize
+ */
+export declare function buildProjectionQueryOutputData(input: ProjectionQueryPayloadInput): Record<string, unknown>;
+/**
+ * Run one read-only SQL statement against this tree's resource projection.
+ *
+ * @param sql - The statement
+ * @param pathArg - The corpus root, or omitted for the current directory
+ * @param options - Parsed command-line options
+ */
+export declare function queryCommand(sql: string, pathArg: string | undefined, options: QueryOptions): Promise<void>;
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/resources/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAOH,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AAEzC,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,UAAU,YAAa,SAAQ,oBAAoB;IACjD,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA4B,SAAQ,YAAY;IAC/D,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAe1G;AAiCD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/commands/resources/query.js

@@ -0,0 +1,146 @@
+/**
+ * `vat resources query` — ask the resource projection a read-only SQL question.
+ *
+ * ## Why a query verb at all, when `scan` already reports counts
+ *
+ * `vat resources scan` answers the questions its payload was written for, and
+ * nothing else. The projection holds twelve tables — realizations, references,
+ * sections, conditions, provenance — and every question about them that nobody
+ * anticipated currently has no answer short of writing a new command. This verb
+ * is the general case: one statement, the rows it selects, no new field.
+ *
+ * ## 🔑 One tree, one answer — and that is now a property, not a promise
+ *
+ * The SQL always runs against a per-run in-memory database holding this tree's
+ * projection and nothing else. A selected projection store makes the POPULATION
+ * cheap and is never queried, because it is one database per VAT release shared
+ * by every root on the machine — querying it answered from other repositories,
+ * with a two-file corpus reporting 5,779 rows instead of 3.
+ * `utils/projection-query.ts`'s header carries the measurement and the reasoning.
+ *
+ * ## 🔑 The document says where its rows came from, and that is the cache tell
+ *
+ * `population` reports whether the projection was **derived** this run or read
+ * from the **store**. It has to be reported, because it cannot be inferred: a
+ * correct hit and a correct re-derivation produce byte-identical rows, so "did
+ * the cache work" is otherwise unfalsifiable — this repository's most repeated
+ * failure. The signal is real rather than declarative: a store hit
+ * short-circuits `populate()` before the builder exists, so no contributor runs
+ * and no timing record is filed. An empty record list IS the hit.
+ *
+ * `populationSecs` sits beside it and says what that origin was worth — the wall
+ * time of the setup both this verb and `vat resources check` pay before either
+ * runs a statement. Measured as that field on this repository with the parse
+ * cache warm: 1.16-1.18 s derived against 0.29-0.31 s served. Without it the
+ * tell is a label a reader has to trust; with it the saving is a number they can
+ * check, and a per-statement cost published elsewhere has something to be read
+ * against. `utils/projection-query.ts` states exactly which work the span covers
+ * and why its start line is load-bearing.
+ *
+ * ## What this verb does NOT do
+ *
+ * It does not decode. Rows come back exactly as SQLite holds them — a boolean as
+ * `0`/`1`, a date and a JSON column as text — because decoding needs a table
+ * spec and arbitrary SQL has none. `SqlQueryableStore.query`'s docstring is the
+ * authority on why.
+ */
+import { handleCommandError } from '../../utils/command-error.js';
+import { formatDurationSecs } from '../../utils/duration.js';
+import { createLogger } from '../../utils/logger.js';
+import { writeJsonOutput, writeYamlOutput } from '../../utils/output.js';
+import { projectRootOrLoudCwd } from '../../utils/project-root-policy.js';
+import { withQueriedProjection, } from '../../utils/projection-query.js';
+/**
+ * Build the query payload.
+ *
+ * Pure: no file system, no clock, no `process.exit` — the same contract
+ * `buildScanOutputData` follows, and for the same reason: it keeps the
+ * document's shape, field names included, under unit test rather than only
+ * under a CLI spawn.
+ *
+ * `rowCount` is stated beside `rows` rather than left for the consumer to
+ * count, because the two answer different questions once a caller pipes the
+ * document somewhere: a truncated read still carries the true total.
+ *
+ * @param input - The rows and the provenance of the run that produced them
+ * @returns The document to serialize
+ */
+export function buildProjectionQueryOutputData(input) {
+    return {
+        status: 'success',
+        // Stated once, and the only absolute path in the document.
+        root: input.root,
+        // The cache tell — see the header.
+        population: input.population,
+        // Immediately after the origin, because the two are one statement: served
+        // or derived, and what that was worth. Separated they read as two unrelated
+        // numbers in a list.
+        populationSecs: formatDurationSecs(input.populationMs),
+        rowCount: input.rows.length,
+        durationSecs: formatDurationSecs(input.durationMs),
+        rows: input.rows,
+    };
+}
+/**
+ * Populate the tree and run the caller's one statement against it.
+ *
+ * Thin by design: everything that is not "one statement, all its rows" —
+ * population, store selection, the ephemeral fallback, the cache tell and the
+ * legible-failure wrapper — is shared with `vat resources check` in
+ * {@link withQueriedProjection}, so the two verbs cannot drift into answering
+ * about different corpora.
+ *
+ * @param options - The run
+ * @param options.root - Absolute corpus root
+ * @param options.sql - The single read-only statement
+ * @param options.parameters - Bound in order, for every `?`
+ * @param options.logger - Where blob-stage refusals are reported
+ * @returns The rows and the provenance of the population behind them
+ */
+async function runProjectionQuery(options) {
+    const { root, sql, parameters, logger } = options;
+    // The statement is compiled against the empty schema first, so a typo'd
+    // column costs milliseconds instead of a full population.
+    return withQueriedProjection({ root, logger, preflight: [sql] }, (ask, provenance) => ({
+        rows: ask(sql, ...parameters),
+        ...provenance,
+    }));
+}
+/**
+ * Run one read-only SQL statement against this tree's resource projection.
+ *
+ * @param sql - The statement
+ * @param pathArg - The corpus root, or omitted for the current directory
+ * @param options - Parsed command-line options
+ */
+export async function queryCommand(sql, pathArg, options) {
+    const logger = createLogger({ debug: options.debug ?? false });
+    const startTime = Date.now();
+    try {
+        // Resolved at the CLI boundary, like every other command — the loud-cwd
+        // policy is where root discovery belongs.
+        const projectRoot = projectRootOrLoudCwd(pathArg ?? process.cwd(), logger);
+        const outcome = await runProjectionQuery({
+            root: projectRoot,
+            sql,
+            parameters: options.param ?? [],
+            logger,
+        });
+        const payload = buildProjectionQueryOutputData({
+            ...outcome,
+            root: projectRoot,
+            durationMs: Date.now() - startTime,
+        });
+        if (options.format === 'json') {
+            writeJsonOutput(payload);
+        }
+        else {
+            writeYamlOutput(payload);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        handleCommandError(error, logger, startTime, 'Query', options.format);
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/resources/query.js.map

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

package/dist/commands/resources/scan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/scan.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAOrE,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAIjG,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,KAAK,mBAAmB,GAAG;IAAE,QAAQ,CAAC,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAA;CAAE,CAAC;AAE5E;;;;;;GAMG;AACH,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;;;;;;OAQG;IACH,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IACnE,OAAO,EAAE,OAAO,CAAC;CAClB;AAaD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BpF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAyDf"}
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/scan.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAQrE,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEjG,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,KAAK,mBAAmB,GAAG;IAAE,QAAQ,CAAC,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAA;CAAE,CAAC;AAE5E;;;;;;GAMG;AACH,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IACnC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;;;;;;OAQG;IACH,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IACnE,OAAO,EAAE,OAAO,CAAC;CAClB;AAaD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BpF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAyDf"}

package/dist/commands/resources/scan.js

@@ -1,13 +1,13 @@
 /**
  * Resources scan command - discover markdown resources
  */
+import { handleCommandError } from '../../utils/command-error.js';
 import { formatDurationSecs } from '../../utils/duration.js';
 import { createLogger } from '../../utils/logger.js';
 import { writeJsonOutput, writeYamlOutput } from '../../utils/output.js';
 import { projectRootOrLoudCwd } from '../../utils/project-root-policy.js';
 import { relativizePathEntries } from '../../utils/relativize-paths.js';
 import { loadResourcesWithConfig } from '../../utils/resource-loader.js';
-import { handleCommandError } from './command-helpers.js';
 /** Total headings in a tree, counting every nested level. */
 function countHeadings(headings) {
     let count = headings.length;
@@ -102,7 +102,7 @@ export async function scanCommand(pathArg, options) {
         process.exit(0);
     }
     catch (error) {
-        handleCommandError(error, logger, startTime, 'Scan');
+        handleCommandError(error, logger, startTime, 'Scan', options.format);
     }
 }
 //# sourceMappingURL=scan.js.map