@vibe-agent-toolkit/cli 0.2.0-rc.10 → 0.2.0-rc.12

package/dist/utils/optional-backend.js

@@ -21,12 +21,8 @@
  * error naming the package to install, and nothing more — the point is that
  * the failure is readable, not that it is survivable.
  */
-// Deliberately NOT `commands/rag/command-helpers.js`, which is where the rest
-// of the rag lane's shared helpers live: that module statically imports
-// `@vibe-agent-toolkit/rag-lancedb`, so reaching for its `handleCommandError`
-// here would load the very backend this file exists to defer.
-import { ExitCode } from '@vibe-agent-toolkit/schema';
-import { writeYamlOutput } from './output.js';
+import { CommandRefusalError } from './command-refusal.js';
+import { endWithRefusal, NOTHING_FINISHED } from './document-writer.js';
 /**
  * Node's code for "the module is genuinely not installed".
  *
@@ -52,34 +48,22 @@ export function isModuleMissing(error) {
         && error.code === MODULE_NOT_FOUND);
 }
 /**
- * Report an uninstalled backend and exit, in the shape every other command
- * failure takes.
+ * The refusal for an uninstalled backend: `BACKEND_UNAVAILABLE`, exit **2** — a
+ * fact about the installation, not about the user's corpus, and a caller
+ * scripting `vat` must be able to tell those apart from the exit code alone.
  *
- * Exit code **2** — a system error, not a validation failure. An absent
- * optional package is a fact about the installation rather than about the
- * user's corpus, and a caller scripting `vat` must be able to tell those apart
- * from the exit code alone.
- *
- * Exported for the backends that are not selected by a Commander action —
- * {@link lazyAction} is the shape most take, but a store chosen by an
- * environment variable is loaded from inside a command rather than in place of
- * one, and it must fail the same way.
+ * Returned, not thrown and not written, so the verb that needed the backend
+ * publishes it in its own shape: {@link lazyAction} ends through the writer, and
+ * a store chosen from inside a command (the projection store) throws it into
+ * that command's catch.
  *
  * @param backend - What to name and how to install it
- * @returns Never; the process exits
+ * @returns The coded refusal; its message names the package and the install command
  */
-export function reportMissingBackend(backend) {
-    const install = `npm install ${backend.packageName}`;
-    process.stderr.write(`${backend.feature} is an optional feature and its backend is not installed.\n`
-        + `\nInstall it with:  ${install}\n`
-        + '\nIt ships separately because it carries a platform-native binary that every\n'
-        + 'other vat command would otherwise download and load.\n');
-    writeYamlOutput({
-        status: 'error',
-        error: `${backend.feature} backend not installed: ${backend.packageName}`,
-        fix: install,
-    });
-    process.exit(ExitCode.ERROR);
+export function missingBackendError(backend) {
+    return new CommandRefusalError('BACKEND_UNAVAILABLE', `${backend.feature} is an optional feature and its backend is not installed. `
+        + `Install it with: npm install ${backend.packageName} — it ships separately because it carries `
+        + 'a platform-native binary that every other vat command would otherwise download and load.');
 }
 /**
  * Bind a Commander action that loads its implementation on first invocation.
@@ -90,16 +74,21 @@ export function reportMissingBackend(backend) {
  * stay eagerly available, which is exactly why the split is at the action
  * rather than at the command.
  *
+ * An absent backend ends the run through the writer as `verb`'s
+ * `BACKEND_UNAVAILABLE` refusal — every leaf behind this seam is a report verb
+ * with no `--format` and no `--strict`, so the document is YAML and the gate fixed.
+ *
+ * @param verb - The report verb the action is, for the refusal document
  * @param backend - What to name in the error when the import fails to resolve
  * @param load - Imports the module and returns the handler out of it
  * @returns A Commander action that loads, then delegates
  *
  * @example
  * ```typescript
- * .action(lazyAction(RAG_BACKEND, async () => (await import('./index-command.js')).indexCommand))
+ * .action(lazyAction('rag index', RAG_BACKEND, async () => (await import('./index-command.js')).indexCommand))
  * ```
  */
-export function lazyAction(backend, load) {
+export function lazyAction(verb, backend, load) {
     return async (...args) => {
         let handler;
         try {
@@ -109,7 +98,7 @@ export function lazyAction(backend, load) {
             if (!isModuleMissing(error)) {
                 throw error;
             }
-            reportMissingBackend(backend);
+            endWithRefusal(verb, 'BACKEND_UNAVAILABLE', missingBackendError(backend), 'yaml', { strict: false }, NOTHING_FINISHED);
         }
         await handler(...args);
     };

package/dist/utils/optional-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"optional-backend.js","sourceRoot":"","sources":["../../src/utils/optional-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAC9E,8DAA8D;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;WACtB,KAAK,KAAK,IAAI;WACd,MAAM,IAAI,KAAK;WACd,KAA4B,CAAC,IAAI,KAAK,gBAAgB,CAC3D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,MAAM,OAAO,GAAG,eAAe,OAAO,CAAC,WAAW,EAAE,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,OAAO,CAAC,OAAO,6DAA6D;UAC7E,uBAAuB,OAAO,IAAI;UAClC,gFAAgF;UAChF,wDAAwD,CAC3D,CAAC;IACF,eAAe,CAAC;QACd,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,GAAG,OAAO,CAAC,OAAO,2BAA2B,OAAO,CAAC,WAAW,EAAE;QACzE,GAAG,EAAE,OAAO;KACb,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CACxB,OAAwB,EACxB,IAA+C;IAE/C,OAAO,KAAK,EAAE,GAAG,IAAU,EAAiB,EAAE;QAC5C,IAAI,OAA0C,CAAC;QAC/C,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"optional-backend.js","sourceRoot":"","sources":["../../src/utils/optional-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AASH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;WACtB,KAAK,KAAK,IAAI;WACd,MAAM,IAAI,KAAK;WACd,KAA4B,CAAC,IAAI,KAAK,gBAAgB,CAC3D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAwB;IAC1D,OAAO,IAAI,mBAAmB,CAC5B,qBAAqB,EACrB,GAAG,OAAO,CAAC,OAAO,4DAA4D;UAC5E,gCAAgC,OAAO,CAAC,WAAW,4CAA4C;UAC/F,0FAA0F,CAC7F,CAAC;AACJ,CAAC;AAUD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,UAAU,CACxB,IAAgB,EAChB,OAAwB,EACxB,IAA+C;IAE/C,OAAO,KAAK,EAAE,GAAG,IAAU,EAAiB,EAAE;QAC5C,IAAI,OAA0C,CAAC;QAC/C,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,cAAc,CAAC,IAAI,EAAE,qBAAqB,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;QACzH,CAAC;QACD,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/output.d.ts

@@ -57,51 +57,13 @@ export interface WriteAllSyncOptions {
  */
 export declare function writeAllSync(write: SyncWriter, buffer: Buffer, options?: WriteAllSyncOptions): void;
 /**
- * Write a single YAML document to stdout, opened with `---`.
+ * The one YAML rendering of a published document — on stdout and in a file
+ * artifact alike, so the same data never serializes two ways.
  *
- * There is deliberately NO trailing marker. `---` OPENS a document in YAML; the
- * end-of-document marker is `...`. Emitting `---` at the end therefore opened a
- * second, empty document, so every command's stdout was a two-document stream and
- * a plain `YAML.parse()` threw `Source contains multiple documents` — on output
- * this CLI documents as "YAML summary → stdout (for programmatic parsing)".
- *
- * The repo's own test helper had already been written around it: `executeCli…`
- * calls `parseAllDocuments(...)` and takes `docs[0]`, with a comment saying "to
- * handle document markers". That workaround is what kept the defect invisible —
- * every consumer that did the obvious thing instead got an exception.
- *
- * Dropping the trailer also makes this agree with the seven hand-rolled emit
- * sites elsewhere in the CLI, none of which ever wrote one.
- *
- * @param data - Data to serialize as YAML
- */
-export declare function writeYamlOutput(data: unknown): void;
-/**
- * Write a single JSON document to stdout.
- *
- * The sibling of {@link writeYamlOutput}, for the same payloads, and it exists
- * because a consumer that has to parse YAML needs a YAML parser: JSON is the
- * format every language reads without one. `vat resources validate` already
- * offers `--format json` for exactly this reason; a scan document that could
- * only be had as YAML made the population it reports the harder of the two to
- * consume programmatically, which is backwards.
- *
- * Written the same way as its YAML sibling, and the comment there applies
- * verbatim: the ordinary stream write keeps this summary behind any
- * human-readable progress already buffered on the same channel.
- *
- * @param data - Data to serialize as JSON
- */
-export declare function writeJsonOutput(data: unknown): void;
-/**
- * Write one structured document in the format a `--format` option selected:
- * `json` → {@link writeJsonOutput}; anything else (including an absent option)
- * → {@link writeYamlOutput}, the CLI's default document format.
- *
- * @param data - The document
- * @param format - The selected format (`json`, or anything else for YAML)
+ * @param data - Data to serialize
+ * @returns The YAML text, without a document marker
  */
-export declare function writeStructuredOutput(data: unknown, format: string | undefined): void;
+export declare function renderYamlDocument(data: unknown): string;
 /**
  * Write a test-format finding to stderr.
  *

package/dist/utils/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKrD;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAoCpF,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,IAAI,CA+BN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAWnD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMrF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKrD;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAoCpF,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,IAAI,CA+BN;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN"}

package/dist/utils/output.js

@@ -3,6 +3,7 @@
  * YAML output on stdout, logs on stderr
  */
 import { writeSync } from 'node:fs';
+import { isWouldBlockError } from '@vibe-agent-toolkit/utils';
 import * as yaml from 'yaml';
 /**
  * Write `content` to stdout SYNCHRONOUSLY, in a loop until every byte is handed
@@ -97,7 +98,7 @@ export function writeAllSync(write, buffer, options = {}) {
             // A non-blocking pipe whose buffer is momentarily full raises EAGAIN; a
             // reader that is draining will free space, so retry. Anything else is a
             // genuine write failure.
-            if (error.code !== 'EAGAIN')
+            if (!isWouldBlockError(error))
                 throw error;
             consecutiveRetries++;
             if (consecutiveRetries > maxRetries) {
@@ -108,70 +109,14 @@ export function writeAllSync(write, buffer, options = {}) {
     }
 }
 /**
- * Write a single YAML document to stdout, opened with `---`.
+ * The one YAML rendering of a published document — on stdout and in a file
+ * artifact alike, so the same data never serializes two ways.
  *
- * There is deliberately NO trailing marker. `---` OPENS a document in YAML; the
- * end-of-document marker is `...`. Emitting `---` at the end therefore opened a
- * second, empty document, so every command's stdout was a two-document stream and
- * a plain `YAML.parse()` threw `Source contains multiple documents` — on output
- * this CLI documents as "YAML summary → stdout (for programmatic parsing)".
- *
- * The repo's own test helper had already been written around it: `executeCli…`
- * calls `parseAllDocuments(...)` and takes `docs[0]`, with a comment saying "to
- * handle document markers". That workaround is what kept the defect invisible —
- * every consumer that did the obvious thing instead got an exception.
- *
- * Dropping the trailer also makes this agree with the seven hand-rolled emit
- * sites elsewhere in the CLI, none of which ever wrote one.
- *
- * @param data - Data to serialize as YAML
+ * @param data - Data to serialize
+ * @returns The YAML text, without a document marker
  */
-export function writeYamlOutput(data) {
-    // Deliberately the ordinary stream write, NOT writeStdoutSync: this summary
-    // follows human-readable progress output written via console.log, and a
-    // synchronous fd-1 write would jump ahead of anything still buffered there.
-    // Completeness is guaranteed instead by makeStdioBlocking() at startup, which
-    // makes BOTH channels synchronous and keeps them in order.
-    process.stdout.write(`---\n${yaml.stringify(data, {
-        indent: 2,
-        lineWidth: 120,
-        aliasDuplicateObjects: false,
-    })}`);
-}
-/**
- * Write a single JSON document to stdout.
- *
- * The sibling of {@link writeYamlOutput}, for the same payloads, and it exists
- * because a consumer that has to parse YAML needs a YAML parser: JSON is the
- * format every language reads without one. `vat resources validate` already
- * offers `--format json` for exactly this reason; a scan document that could
- * only be had as YAML made the population it reports the harder of the two to
- * consume programmatically, which is backwards.
- *
- * Written the same way as its YAML sibling, and the comment there applies
- * verbatim: the ordinary stream write keeps this summary behind any
- * human-readable progress already buffered on the same channel.
- *
- * @param data - Data to serialize as JSON
- */
-export function writeJsonOutput(data) {
-    process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
-}
-/**
- * Write one structured document in the format a `--format` option selected:
- * `json` → {@link writeJsonOutput}; anything else (including an absent option)
- * → {@link writeYamlOutput}, the CLI's default document format.
- *
- * @param data - The document
- * @param format - The selected format (`json`, or anything else for YAML)
- */
-export function writeStructuredOutput(data, format) {
-    if (format === 'json') {
-        writeJsonOutput(data);
-    }
-    else {
-        writeYamlOutput(data);
-    }
+export function renderYamlDocument(data) {
+    return yaml.stringify(data, { indent: 2, lineWidth: 120, aliasDuplicateObjects: false });
 }
 /**
  * Write a test-format finding to stderr.

package/dist/utils/output.js.map

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

package/dist/utils/package-json.d.ts

@@ -15,10 +15,9 @@
 /**
  * The parsed manifest, or `undefined` when there is none at `pkgPath`.
  *
- * @throws {Error} naming the file when it exists but is not a JSON object;
- *   the parse error is the `cause`.
- * @throws whatever the filesystem threw for anything that is not an absence
- *   (a refusal stays a refusal).
+ * @throws {CommandRefusalError} `INPUT_UNREADABLE` naming the file when it
+ *   exists but is not a JSON object (the parse error is the `cause`), or when
+ *   the OS refused the read (a refusal stays a refusal, never an absence).
  */
 export declare function readPackageJsonOrAbsent(pkgPath: string): Record<string, unknown> | undefined;
 //# sourceMappingURL=package-json.d.ts.map

package/dist/utils/package-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../src/utils/package-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAoB5F"}
+{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../src/utils/package-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAoB5F"}

package/dist/utils/package-json.js

@@ -13,14 +13,14 @@
  * already broken; the reader's job is to say so, not to proceed around it.
  */
 import { readFileSync } from 'node:fs';
-import { isPathAbsentError } from '@vibe-agent-toolkit/utils';
+import { classifyFsFault, isPathAbsentError } from '@vibe-agent-toolkit/utils';
+import { CommandRefusalError } from './command-refusal.js';
 /**
  * The parsed manifest, or `undefined` when there is none at `pkgPath`.
  *
- * @throws {Error} naming the file when it exists but is not a JSON object;
- *   the parse error is the `cause`.
- * @throws whatever the filesystem threw for anything that is not an absence
- *   (a refusal stays a refusal).
+ * @throws {CommandRefusalError} `INPUT_UNREADABLE` naming the file when it
+ *   exists but is not a JSON object (the parse error is the `cause`), or when
+ *   the OS refused the read (a refusal stays a refusal, never an absence).
  */
 export function readPackageJsonOrAbsent(pkgPath) {
     let raw;
@@ -30,7 +30,7 @@ export function readPackageJsonOrAbsent(pkgPath) {
     catch (error) {
         if (isPathAbsentError(error))
             return undefined;
-        throw error;
+        throw classifyFsFault(error, { side: 'source', origin: 'content', action: 'read package.json', path: pkgPath });
     }
     let parsed;
     try {
@@ -39,10 +39,10 @@ export function readPackageJsonOrAbsent(pkgPath) {
     catch (error) {
         if (!(error instanceof SyntaxError))
             throw error;
-        throw new Error(`${pkgPath} is not valid JSON: ${error.message}`, { cause: error });
+        throw new CommandRefusalError('INPUT_UNREADABLE', `${pkgPath} is not valid JSON: ${error.message}`, { cause: error });
     }
     if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
-        throw new Error(`${pkgPath} is not a JSON object, so it is not a package manifest`);
+        throw new CommandRefusalError('INPUT_UNREADABLE', `${pkgPath} is not a JSON object, so it is not a package manifest`);
     }
     return parsed;
 }

package/dist/utils/package-json.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../src/utils/package-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC;YAAE,MAAM,KAAK,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,uBAAuB,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,wDAAwD,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../src/utils/package-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,MAAM,eAAe,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAClH,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC;YAAE,MAAM,KAAK,CAAC;QACjD,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,GAAG,OAAO,uBAAuB,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACxH,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,GAAG,OAAO,wDAAwD,CAAC,CAAC;IACxH,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC"}

package/dist/utils/population-wiring.d.ts

@@ -1,64 +1,57 @@
 /**
- * The three arguments every CLI lane hands a projection population builder the
- * same way: the blob-stage observer, the ignore oracle, and the run's store.
+ * The one entry by which a CLI lane populates a tree from its rows: it hands the
+ * builder the ignore oracle, the run's store and the declared collections the
+ * same way every time, and reports what the population refused. The report is
+ * inside the only exported entry, so a lane cannot build a population it forgets
+ * to report.
  *
  * ## Why this is CLI code and not `resources` code
  *
- * Nothing here decides anything about a projection. The observer's whole body is
- * `describeBlobRefusals` — owned by `@vibe-agent-toolkit/resources` — routed to a
- * {@link Logger}, which is a CLI type no other package has; the two spreads exist
- * only because `exactOptionalPropertyTypes` makes "absent" and "present and
- * undefined" different arguments. That is command plumbing, in the same family as
- * `projection-store.ts` next door, so it stays inside the package the CLI-stays-
- * dumb rule allows it in.
+ * Nothing here decides anything about a projection. The report's whole body is
+ * `describeBlobRefusals` — owned by `@vibe-agent-toolkit/resources` — routed to
+ * a {@link Logger}, which is a CLI type no other package has; the
+ * spreads exist only because `exactOptionalPropertyTypes` makes "absent" and
+ * "present and undefined" different arguments. That is command plumbing, in the
+ * same family as `projection-store.ts` next door.
  *
- * ## The observer is the reason this is shared rather than retyped
+ * ## Why the report reads the projection, not the run
  *
- * `buildInventoryPopulation` and `buildClaudeContextPopulation` both REQUIRE
- * `onBlobPopulation` — a caller with nothing to do with the counts must name
- * `DISCARD_BLOB_POPULATION` rather than leave it off — because a tree whose every
- * document was declined as binary otherwise populates as empty and reports
- * success. Two hand-written copies of the reporting half is two places for that
- * report to quietly become a no-op.
+ * A store hit derives nothing. A report built from what this process derived
+ * vanished on the warm run, so `vat resources check` was silent about a binary
+ * `vat resources validate` had just stored a refusal for.
  */
-import { type BlobPopulationReport, type CollectionConfig, type PopulationCache } from '@vibe-agent-toolkit/resources';
+import { type BlobRefusalRows, type CollectionConfig, type PopulationCache } from '@vibe-agent-toolkit/resources';
 import type { GitTracker } from '@vibe-agent-toolkit/utils/git';
 import type { Logger } from './logger.js';
 /**
- * The population arguments {@link populationWiring} supplies.
+ * The population arguments {@link populateAndReport} supplies.
  *
  * Spread into a builder's options object, so the three optional inputs are
  * optional in the `exactOptionalPropertyTypes` sense — omitted entirely when
  * they are absent, never present-and-undefined.
  */
 export interface PopulationWiring {
-    onBlobPopulation: (report: BlobPopulationReport) => void;
     gitTracker?: GitTracker | undefined;
     cache?: PopulationCache | undefined;
     collections?: Readonly<Record<string, CollectionConfig>> | undefined;
 }
 /**
- * Wire one population's blob-stage observer, ignore oracle and store.
+ * Populate one tree through `build`, then report its refused content to
+ * **stderr** (callers write a parseable document to stdout), named by
+ * `population` because one command can build two — the resources lane and the
+ * claude-context lens.
  *
- * `describeBlobRefusals` returns undefined on a run that refused nothing, so a
- * clean population stays exactly as quiet as it was — which is the only thing
- * that keeps the line worth reading when it does appear.
- *
- * ⚠️ The refusals go to `logger.warn`, i.e. **stderr**. Both callers write a
- * parseable document to stdout, and a diagnostic in the middle of it breaks every
- * consumer.
- *
- * @param logger - Where blob-stage refusals are reported
- * @param gitTracker - The ignore oracle, or undefined when there is none. Not
- *   cosmetic: `resource_realizations.gitignored` is filled only when a tracker
- *   was supplied, so its absence decides whether a consumer can TELL which
- *   members were ignored
- * @param cache - The run's projection store, or undefined to re-derive
- * @param root - The project root, from which the run's declared `mimeType`
- *   routing is READ rather than passed. See {@link collectionsOption}
- * @returns The options to spread into the population builder's argument
+ * @param options - The run: `root`, `cache`, `logger`, and the `population` name
+ * @param build - Builds the population from the wiring this entry supplies
+ * @param refusalRowsOf - The rows the report reads, from a derive or a hit alike
+ * @returns Whatever `build` returned
  */
-export declare function populationWiring(logger: Logger, gitTracker: GitTracker | undefined, cache: PopulationCache | undefined, root: string): PopulationWiring;
+export declare function populateAndReport<R>(options: {
+    root: string;
+    cache: PopulationCache | undefined;
+    logger: Logger;
+    population: string;
+}, build: (wiring: PopulationWiring) => Promise<R>, refusalRowsOf: (result: R) => BlobRefusalRows): Promise<R>;
 /**
  * The project's collection declarations at `root`, or undefined for a project
  * that declares none.

package/dist/utils/population-wiring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"population-wiring.d.ts","sourceRoot":"","sources":["../../src/utils/population-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACzD,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,GAAG,SAAS,CAAC;CACtE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,GACX,gBAAgB,CAUlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX;IAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;CAAE,CAG9D"}
+{"version":3,"file":"population-wiring.d.ts","sourceRoot":"","sources":["../../src/utils/population-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAKhE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,GAAG,SAAS,CAAC;CACtE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACjG,KAAK,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,EAC/C,aAAa,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,eAAe,GAC5C,OAAO,CAAC,CAAC,CAAC,CAOZ;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX;IAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;CAAE,CAG9D"}

package/dist/utils/population-wiring.js

@@ -1,40 +1,51 @@
 /**
- * The three arguments every CLI lane hands a projection population builder the
- * same way: the blob-stage observer, the ignore oracle, and the run's store.
+ * The one entry by which a CLI lane populates a tree from its rows: it hands the
+ * builder the ignore oracle, the run's store and the declared collections the
+ * same way every time, and reports what the population refused. The report is
+ * inside the only exported entry, so a lane cannot build a population it forgets
+ * to report.
  *
  * ## Why this is CLI code and not `resources` code
  *
- * Nothing here decides anything about a projection. The observer's whole body is
- * `describeBlobRefusals` — owned by `@vibe-agent-toolkit/resources` — routed to a
- * {@link Logger}, which is a CLI type no other package has; the two spreads exist
- * only because `exactOptionalPropertyTypes` makes "absent" and "present and
- * undefined" different arguments. That is command plumbing, in the same family as
- * `projection-store.ts` next door, so it stays inside the package the CLI-stays-
- * dumb rule allows it in.
+ * Nothing here decides anything about a projection. The report's whole body is
+ * `describeBlobRefusals` — owned by `@vibe-agent-toolkit/resources` — routed to
+ * a {@link Logger}, which is a CLI type no other package has; the
+ * spreads exist only because `exactOptionalPropertyTypes` makes "absent" and
+ * "present and undefined" different arguments. That is command plumbing, in the
+ * same family as `projection-store.ts` next door.
  *
- * ## The observer is the reason this is shared rather than retyped
+ * ## Why the report reads the projection, not the run
  *
- * `buildInventoryPopulation` and `buildClaudeContextPopulation` both REQUIRE
- * `onBlobPopulation` — a caller with nothing to do with the counts must name
- * `DISCARD_BLOB_POPULATION` rather than leave it off — because a tree whose every
- * document was declined as binary otherwise populates as empty and reports
- * success. Two hand-written copies of the reporting half is two places for that
- * report to quietly become a no-op.
+ * A store hit derives nothing. A report built from what this process derived
+ * vanished on the warm run, so `vat resources check` was silent about a binary
+ * `vat resources validate` had just stored a refusal for.
  */
 import { describeBlobRefusals, } from '@vibe-agent-toolkit/resources';
+import { gitTrackerForProjectRoot } from '../commands/audit/distributed-tree.js';
 import { loadConfigCached } from './config-loader.js';
 /**
- * Wire one population's blob-stage observer, ignore oracle and store.
+ * Populate one tree through `build`, then report its refused content to
+ * **stderr** (callers write a parseable document to stdout), named by
+ * `population` because one command can build two — the resources lane and the
+ * claude-context lens.
  *
- * `describeBlobRefusals` returns undefined on a run that refused nothing, so a
- * clean population stays exactly as quiet as it was — which is the only thing
- * that keeps the line worth reading when it does appear.
- *
- * ⚠️ The refusals go to `logger.warn`, i.e. **stderr**. Both callers write a
- * parseable document to stdout, and a diagnostic in the middle of it breaks every
- * consumer.
+ * @param options - The run: `root`, `cache`, `logger`, and the `population` name
+ * @param build - Builds the population from the wiring this entry supplies
+ * @param refusalRowsOf - The rows the report reads, from a derive or a hit alike
+ * @returns Whatever `build` returned
+ */
+export async function populateAndReport(options, build, refusalRowsOf) {
+    const { root, cache, logger, population } = options;
+    const gitTracker = await gitTrackerForProjectRoot(root);
+    const result = await build(populationWiring(gitTracker, cache, root));
+    const refusals = describeBlobRefusals(refusalRowsOf(result));
+    if (refusals !== undefined)
+        logger.warn(`${population} population: ${refusals}`);
+    return result;
+}
+/**
+ * Wire one population's ignore oracle, store and declared collections.
  *
- * @param logger - Where blob-stage refusals are reported
  * @param gitTracker - The ignore oracle, or undefined when there is none. Not
  *   cosmetic: `resource_realizations.gitignored` is filled only when a tracker
  *   was supplied, so its absence decides whether a consumer can TELL which
@@ -44,13 +55,8 @@ import { loadConfigCached } from './config-loader.js';
  *   routing is READ rather than passed. See {@link collectionsOption}
  * @returns The options to spread into the population builder's argument
  */
-export function populationWiring(logger, gitTracker, cache, root) {
+function populationWiring(gitTracker, cache, root) {
     return {
-        onBlobPopulation: (report) => {
-            const refusals = describeBlobRefusals(report);
-            if (refusals !== undefined)
-                logger.warn(refusals);
-        },
         ...(gitTracker !== undefined && { gitTracker }),
         ...(cache !== undefined && { cache }),
         ...collectionsOption(root),
@@ -92,7 +98,7 @@ export function populationWiring(logger, gitTracker, cache, root) {
  *   `resources.collections` in it
  */
 export function collectionsOption(root) {
-    const collections = loadConfigCached(root)?.resources?.collections;
+    const collections = loadConfigCached(root, 'source')?.resources?.collections;
     return collections === undefined ? {} : { collections };
 }
 //# sourceMappingURL=population-wiring.js.map

package/dist/utils/population-wiring.js.map

@@ -1 +1 @@
-{"version":3,"file":"population-wiring.js","sourceRoot":"","sources":["../../src/utils/population-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,oBAAoB,GAIrB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAiBtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,UAAkC,EAClC,KAAkC,EAClC,IAAY;IAEZ,OAAO;QACL,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,QAAQ,KAAK,SAAS;gBAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;QACD,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;QAC/C,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;QACrC,GAAG,iBAAiB,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY;IAEZ,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC;IACnE,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"population-wiring.js","sourceRoot":"","sources":["../../src/utils/population-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,oBAAoB,GAIrB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAgBtD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiG,EACjG,KAA+C,EAC/C,aAA6C;IAE7C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,gBAAgB,QAAQ,EAAE,CAAC,CAAC;IACjF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,gBAAgB,CACvB,UAAkC,EAClC,KAAkC,EAClC,IAAY;IAEZ,OAAO;QACL,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;QAC/C,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;QACrC,GAAG,iBAAiB,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY;IAEZ,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC;IAC7E,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC"}