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

package/dist/commands/okf/validate.js

@@ -9,43 +9,11 @@
  */
 import { dirname } from 'node:path';
 import { okfBundleRuns, parseConfigFile, validateOkfBundle, } from '@vibe-agent-toolkit/resources';
-import { buildReport, exitCodeForSeverityCounts, reportSchema } from '@vibe-agent-toolkit/schema';
-import { findConfigFile, issueLocation, safePath } from '@vibe-agent-toolkit/utils';
-import { z } from 'zod';
-import { handleReportCommandError } from '../../utils/command-error.js';
-import { createLogger } from '../../utils/logger.js';
-import { writeStructuredOutput } from '../../utils/output.js';
-/** One checked bundle's `data` row: what was read, never the findings (those are the envelope's). */
-export const OkfBundleSummarySchema = z.object({
-    /** The `okf.bundles.<name>` key. */
-    bundle: z.string(),
-    /** The root as the config file wrote it — never the resolved absolute path. */
-    root: z.string(),
-    /** Every non-reserved `.md` beneath the root, bundle-relative and sorted. */
-    conceptDocuments: z.array(z.string()),
-    /** Every `index.md` / `log.md` beneath the root, bundle-relative and sorted. */
-    reservedDocuments: z.array(z.string()),
-    /** What the root `index.md` declares, when it declares a well-formed one. Reported, never obeyed. */
-    declaredOkfVersion: z.string().optional(),
-}).strict();
-export const OkfValidateDataSchema = z.object({
-    bundles: z.array(OkfBundleSummarySchema),
-    /**
-     * Present only when there was nothing to check, and says what to declare or
-     * which root to look at.
-     *
-     * 🪤 The command used to print `status: passed`, `bundles: []`, exit 0 when a
-     * project declared no `okf.bundles` at all — a report indistinguishable from
-     * a bundle read in full and found conformant, so a mistyped key
-     * (`okf.bundle:`, `okf.Bundles:`) read as a clean bill of health. The
-     * envelope's REQUIRED `examined` now says `0` in that case, and this sentence
-     * says why. The exit code stays 0: nothing failed, and failing a build for a
-     * feature the project never opted into would be worse.
-     */
-    notice: z.string().optional(),
-}).strict();
-/** The document this command publishes. */
-export const OKF_VALIDATE_REPORT_SCHEMA = reportSchema(OkfValidateDataSchema);
+import { buildReport, withDurationMs } from '@vibe-agent-toolkit/schema';
+import { findConfigFile, issueLocation, mapConcurrentFailingInOrder, safePath } from '@vibe-agent-toolkit/utils';
+import { CommandRefusalError, refusalCodeOf } from '../../utils/command-refusal.js';
+import { endWithRefusal, endWithReport, NOTHING_FINISHED } from '../../utils/document-writer.js';
+import { relativeLocationOrUndefined } from '../../utils/relativize-paths.js';
 /**
  * The bundles whose root was read successfully and held not one markdown file.
  *
@@ -105,11 +73,16 @@ const NO_BUNDLES_NOTICE = 'No OKF bundles are declared, so nothing was checked.
  * @returns The published finding
  */
 function toFinding(finding, root, projectRoot) {
+    const document = safePath.join(root, finding.document);
+    // A bundle root on another drive than the project (an absolute or package
+    // root) has no project-relative spelling: the finding names the document in
+    // its message and carries no `location`, rather than killing the document.
+    const location = relativeLocationOrUndefined(issueLocation(document, projectRoot));
     return {
         code: finding.code,
         severity: finding.severity,
-        message: finding.message,
-        location: issueLocation(safePath.join(root, finding.document), projectRoot),
+        message: location === undefined ? `${finding.message} (${document})` : finding.message,
+        ...(location === undefined ? {} : { location }),
         ...(finding.link === undefined ? {} : { link: finding.link }),
         ...(finding.line === undefined ? {} : { line: finding.line }),
     };
@@ -130,8 +103,12 @@ export function summarizeOkfBundles(checked, projectRoot) {
     const bundles = checked.map((entry) => entry.report);
     const findings = checked.flatMap((entry) => entry.report.findings.map((finding) => toFinding(finding, entry.root, projectRoot)));
     const examined = bundles.reduce((sum, report) => sum + report.conceptDocuments.length + report.reservedDocuments.length, 0);
+    // A run that examined nothing is refused by the writer, from the registry's
+    // declared denominator; `notice` says which case it was.
     const notice = noticeFor(bundles);
     return buildReport({
+        // `vat okf validate` offers no `--strict`: warnings never fail it.
+        gate: { strict: false },
         examined,
         findings,
         data: {
@@ -146,6 +123,31 @@ export function summarizeOkfBundles(checked, projectRoot) {
         },
     });
 }
+/** The resources lane's code for a bundle root the OS would not list. */
+const ROOT_UNREADABLE = 'OKF_BUNDLE_ROOT_UNREADABLE';
+/**
+ * The refusal a run with an unreadable bundle root ends on: `INPUT_UNREADABLE`,
+ * as a directory the OS will not list is in every verb, publishing what every
+ * other bundle finished. The resources lane reports the root as that bundle's
+ * finding so one bad root cannot discard the rest; this is where it becomes
+ * the run's refusal, and the finished work is what the rest keeps.
+ *
+ * @param report - The assembled report
+ * @returns The refusal, or nothing when every root was read
+ */
+export function unreadableRootRefusal(report) {
+    const unreadable = report.findings.filter((finding) => finding.code === ROOT_UNREADABLE);
+    if (unreadable.length === 0)
+        return undefined;
+    return {
+        message: unreadable.map((finding) => finding.message).join('\n'),
+        finished: {
+            examined: report.examined,
+            findings: report.findings.filter((finding) => finding.code !== ROOT_UNREADABLE),
+            data: report.data,
+        },
+    };
+}
 /**
  * Check every selected bundle and assemble the report.
  *
@@ -157,34 +159,43 @@ export function summarizeOkfBundles(checked, projectRoot) {
 export async function okfValidateReport(bundleArg, options) {
     const configPath = findConfigFile(process.cwd());
     if (!configPath) {
-        throw new Error('No vibe-agent-toolkit.config.yaml found. Run from a project directory.');
+        throw new CommandRefusalError('CONFIG_INVALID', 'No vibe-agent-toolkit.config.yaml found. Run from a project directory.');
     }
+    // A config the OS will not read throws a classified `source` fault, one that does not
+    // parse or validate `CONFIG_LOAD`, and an undeclared bundle argument
+    // `OKF_UNKNOWN_BUNDLE` — each a coded refusal the
+    // catch reads. Anything else thrown here is VAT's defect and surfaces as one.
     const config = await parseConfigFile(configPath);
     const projectRoot = dirname(configPath);
     const runs = okfBundleRuns(config.okf, projectRoot, {
         ...(bundleArg !== undefined && { bundle: bundleArg }),
         ...(options.specVersion !== undefined && { specVersion: options.specVersion }),
     });
-    const checked = [];
-    for (const run of runs) {
-        checked.push({ report: await validateOkfBundle(run), root: run.root });
-    }
+    // Independent read-only bundles: validated together, summarized in declaration order.
+    const checked = await mapConcurrentFailingInOrder(runs, async (run) => ({ report: await validateOkfBundle(run), root: run.root }));
     return summarizeOkfBundles(checked, projectRoot);
 }
 /** Action handler for `vat okf validate [bundle]`. */
 export async function okfValidateCommand(bundleArg, options) {
-    const logger = createLogger(options.debug === true ? { debug: true } : {});
     const startTime = Date.now();
+    const format = options.format ?? 'yaml';
+    // What finished before a refusal — read by the catch, so an unreadable root
+    // still publishes every other bundle's findings.
+    let finished = NOTHING_FINISHED;
     try {
-        const report = { ...(await okfValidateReport(bundleArg, options)), durationMs: Date.now() - startTime };
-        writeStructuredOutput(report, options.format);
-        // Read from the counts the report PUBLISHES, not from the status word: an
-        // adopter who promotes or lowers a bundle's severity then gates on exactly
-        // the number a reader can see.
-        process.exit(exitCodeForSeverityCounts(report.summary));
+        const report = withDurationMs(await okfValidateReport(bundleArg, options), Date.now() - startTime);
+        const refusal = unreadableRootRefusal(report);
+        if (refusal !== undefined) {
+            finished = refusal.finished;
+            throw new CommandRefusalError('INPUT_UNREADABLE', refusal.message);
+        }
+        // The code derives from the report the writer PUBLISHED: an adopter who
+        // promotes or lowers a bundle's severity gates on exactly what a reader sees.
+        endWithReport('okf validate', report, format);
     }
     catch (error) {
-        handleReportCommandError(error, logger, startTime, 'OKF validate', options.format);
+        // `vat okf validate` offers no `--strict`: warnings never fail it.
+        endWithRefusal('okf validate', refusalCodeOf(error), error, format, { strict: false }, finished);
     }
 }
 //# sourceMappingURL=validate.js.map

package/dist/commands/okf/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/commands/okf/validate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/commands/okf/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,GAGlB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAgB,MAAM,4BAA4B,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,2BAA2B,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEjH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAqB,MAAM,gCAAgC,CAAC;AACpH,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAkB9E;;;;;;;;;;;;;;;GAeG;AACH,SAAS,cAAc,CAAC,OAAmC;IACzD,OAAO,OAAO;SACX,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC5B,MAAM,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;QACpC,MAAM,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,CACxC;SACA,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,OAA0B;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,OAAO,GAAG,KAAK,qDAAqD,OAAO,sIAAsI,CAAC;AACpN,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,OAAmC;IACpD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACnD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjE,CAAC;AAED,MAAM,iBAAiB,GACrB,2OAA2O,CAAC;AAE9O;;;;;;;;;;GAUG;AACH,SAAS,SAAS,CAAC,OAAmB,EAAE,IAAY,EAAE,WAAmB;IACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvD,0EAA0E;IAC1E,4EAA4E;IAC5E,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,2BAA2B,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IACnF,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;QACtF,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAoC,EACpC,WAAmB;IAEnB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACzC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CACpF,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAC7B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,EACvF,CAAC,CACF,CAAC;IACF,4EAA4E;IAC5E,yDAAyD;IACzD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAElC,OAAO,WAAW,CAAkB;QAClC,mEAAmE;QACnE,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QACvB,QAAQ;QACR,QAAQ;QACR,IAAI,EAAE;YACJ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAChC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;gBAC3C,GAAG,CAAC,MAAM,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC;aACtG,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;SAC5C;KACF,CAAC,CAAC;AACL,CAAC;AAED,yEAAyE;AACzE,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAyB;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;IACzF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAChE,QAAQ,EAAE;YACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC;YAC/E,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA6B,EAC7B,OAA2B;IAE3B,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,wEAAwE,CAAC,CAAC;IAC5H,CAAC;IAED,sFAAsF;IACtF,qEAAqE;IACrE,kDAAkD;IAClD,8EAA8E;IAC9E,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE;QAClD,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;KAC/E,CAAC,CAAC;IAEH,sFAAsF;IACtF,MAAM,OAAO,GAAuB,MAAM,2BAA2B,CACnE,IAAI,EACJ,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAC1E,CAAC;IAEF,OAAO,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAA6B,EAC7B,OAA2B;IAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IACxC,4EAA4E;IAC5E,iDAAiD;IACjD,IAAI,QAAQ,GAAG,gBAAgB,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QACnG,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YAC5B,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,CAAC;QACD,wEAAwE;QACxE,8EAA8E;QAC9E,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mEAAmE;QACnE,cAAc,CAAC,cAAc,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnG,CAAC;AACH,CAAC"}

package/dist/commands/orchestrator-schema.d.ts

@@ -0,0 +1,419 @@
+/**
+ * The document `vat build`, `vat validate` and `vat verify` publish, apart from
+ * the commands.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * commands import the writer that imports the registry: a schema declared in a
+ * command module itself would be an import cycle, read before it is initialised.
+ *
+ * 🔑 **One envelope over every phase.** `findings` is every phase's findings,
+ * flat and with their `location` unchanged; `examined` is the sum of the
+ * phases' own `examined`; `data.phases` carries each phase's status, count,
+ * summary and its own `data` — which that phase's registered schema describes,
+ * so this schema holds it as `unknown` rather than keeping a second copy of
+ * five shapes. `runPhase` holds each phase's report to that schema before the
+ * fold. A phase that did not finish carries its own `error`, and the
+ * orchestrator's envelope is then `error` / `RUN_INCOMPLETE` over the phases
+ * that did.
+ *
+ * `vat verify`'s `packaged-content` phase is no verb of its own, so its report
+ * schema — the published contract for its `data` — is declared here.
+ */
+import { z } from 'zod';
+import type { ExaminedDeclaration } from '../utils/run-integrity.js';
+/**
+ * What `examined` counts for an orchestrator, and the remedy when it is zero.
+ *
+ * The sum of the phases' own denominators — files, skills, bundles, plugins —
+ * so the unit is "whatever each phase examined". This judges the run in which
+ * no phase ran, or none had anything to examine. A CONFIGURED phase that
+ * examined nothing is refused before the fold, by its own declaration
+ * (`phaseVerdict` in `phase-utils.ts`), so a healthy phase beside it hides nothing.
+ */
+export declare const ORCHESTRATOR_EXAMINED: ExaminedDeclaration;
+/** One phase of the run, as the orchestrator folds it. */
+declare const PhaseEntrySchema: z.ZodObject<{
+    /** The phase's name, e.g. `skills`, `marketplace:<name>`, `packaged-content`. */
+    name: z.ZodString;
+    /** The phase's own envelope status. */
+    status: z.ZodEnum<["ok", "findings", "error"]>;
+    /** What the phase examined, in its own unit. */
+    examined: z.ZodNumber;
+    /** The phase's findings, by severity — the findings themselves are on the envelope. */
+    summary: z.ZodObject<{
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+        info: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        info: number;
+        errors: number;
+        warnings: number;
+    }, {
+        info: number;
+        errors: number;
+        warnings: number;
+    }>;
+    /** Why the phase did not finish, when it did not. */
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodEnum<["USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED", ...("USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED")[]]>;
+        message: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+        message: string;
+    }, {
+        code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+        message: string;
+    }>>;
+    /** The phase's own `data`, as its own registered schema describes it. */
+    data: z.ZodUnknown;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    status: "error" | "ok" | "findings";
+    summary: {
+        info: number;
+        errors: number;
+        warnings: number;
+    };
+    examined: number;
+    error?: {
+        code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+        message: string;
+    } | undefined;
+    data?: unknown;
+}, {
+    name: string;
+    status: "error" | "ok" | "findings";
+    summary: {
+        info: number;
+        errors: number;
+        warnings: number;
+    };
+    examined: number;
+    error?: {
+        code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+        message: string;
+    } | undefined;
+    data?: unknown;
+}>;
+declare const OrchestratorDataSchema: z.ZodObject<{
+    /** Every phase that ran, finished or not, in execution order. */
+    phases: z.ZodArray<z.ZodObject<{
+        /** The phase's name, e.g. `skills`, `marketplace:<name>`, `packaged-content`. */
+        name: z.ZodString;
+        /** The phase's own envelope status. */
+        status: z.ZodEnum<["ok", "findings", "error"]>;
+        /** What the phase examined, in its own unit. */
+        examined: z.ZodNumber;
+        /** The phase's findings, by severity — the findings themselves are on the envelope. */
+        summary: z.ZodObject<{
+            errors: z.ZodNumber;
+            warnings: z.ZodNumber;
+            info: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }>;
+        /** Why the phase did not finish, when it did not. */
+        error: z.ZodOptional<z.ZodObject<{
+            code: z.ZodEnum<["USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED", ...("USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED")[]]>;
+            message: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        }, {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        }>>;
+        /** The phase's own `data`, as its own registered schema describes it. */
+        data: z.ZodUnknown;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        status: "error" | "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        examined: number;
+        error?: {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        } | undefined;
+        data?: unknown;
+    }, {
+        name: string;
+        status: "error" | "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        examined: number;
+        error?: {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        } | undefined;
+        data?: unknown;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    phases: {
+        name: string;
+        status: "error" | "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        examined: number;
+        error?: {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        } | undefined;
+        data?: unknown;
+    }[];
+}, {
+    phases: {
+        name: string;
+        status: "error" | "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        examined: number;
+        error?: {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        } | undefined;
+        data?: unknown;
+    }[];
+}>;
+export type OrchestratorPhaseEntry = z.infer<typeof PhaseEntrySchema>;
+export type OrchestratorData = z.infer<typeof OrchestratorDataSchema>;
+/** The document the three orchestrators publish. */
+export declare const ORCHESTRATOR_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    /** Every phase that ran, finished or not, in execution order. */
+    phases: z.ZodArray<z.ZodObject<{
+        /** The phase's name, e.g. `skills`, `marketplace:<name>`, `packaged-content`. */
+        name: z.ZodString;
+        /** The phase's own envelope status. */
+        status: z.ZodEnum<["ok", "findings", "error"]>;
+        /** What the phase examined, in its own unit. */
+        examined: z.ZodNumber;
+        /** The phase's findings, by severity — the findings themselves are on the envelope. */
+        summary: z.ZodObject<{
+            errors: z.ZodNumber;
+            warnings: z.ZodNumber;
+            info: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }>;
+        /** Why the phase did not finish, when it did not. */
+        error: z.ZodOptional<z.ZodObject<{
+            code: z.ZodEnum<["USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED", ...("USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED")[]]>;
+            message: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        }, {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        }>>;
+        /** The phase's own `data`, as its own registered schema describes it. */
+        data: z.ZodUnknown;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        status: "error" | "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        examined: number;
+        error?: {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        } | undefined;
+        data?: unknown;
+    }, {
+        name: string;
+        status: "error" | "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        examined: number;
+        error?: {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        } | undefined;
+        data?: unknown;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    phases: {
+        name: string;
+        status: "error" | "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        examined: number;
+        error?: {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        } | undefined;
+        data?: unknown;
+    }[];
+}, {
+    phases: {
+        name: string;
+        status: "error" | "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        examined: number;
+        error?: {
+            code: "USAGE_INVALID" | "CONFIG_INVALID" | "INPUT_UNREADABLE" | "BACKEND_UNAVAILABLE" | "EXTERNAL_API_FAILED" | "NOT_IMPLEMENTED" | "RUN_INCOMPLETE" | "INTERNAL_ERROR" | "RESOURCE_CHECK_BROKEN" | "ARD_NOT_CONFIGURED" | "ARD_DERIVATION_FAILED";
+            message: string;
+        } | undefined;
+        data?: unknown;
+    }[];
+}>, z.ZodObject<Omit<{
+    code: z.ZodString;
+    severity: z.ZodEnum<["error", "warning", "info", "ignore"]>;
+    message: z.ZodString;
+    location: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    line: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    fix: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodString>;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, "severity"> & {
+    severity: z.ZodEnum<["error", "warning", "info"]>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}>>;
+/**
+ * `vat verify`'s `packaged-content` phase `data`: what the crawl should have
+ * found. What it DID crawl is the phase's own `examined` (the built bundles on
+ * disk), so it is not repeated here.
+ */
+declare const PackagedContentDataSchema: z.ZodObject<{
+    /** Bundles `vat build` produces for the skills this run discovered. */
+    bundlesExpected: z.ZodNumber;
+    /** Discovered skills that are in place (`publish: false`, not plugin-local): no bundle is expected. */
+    bundlesInPlace: z.ZodNumber;
+    /** Expected bundles absent from `dist/`, project-relative. Non-empty means the phase is not a verdict. */
+    bundlesMissing: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    bundlesExpected: number;
+    bundlesInPlace: number;
+    bundlesMissing: string[];
+}, {
+    bundlesExpected: number;
+    bundlesInPlace: number;
+    bundlesMissing: string[];
+}>;
+export type PackagedContentData = z.infer<typeof PackagedContentDataSchema>;
+/**
+ * What `examined` counts for `vat verify`'s `packaged-content` phase, and the remedy when it is
+ * zero. `vat verify` exists to check the BUILT tree: a phase that crawled none of it is not a
+ * verdict on it.
+ */
+export declare const PACKAGED_CONTENT_EXAMINED: ExaminedDeclaration;
+/** The report `vat verify`'s `packaged-content` phase hands back. */
+export declare const PACKAGED_CONTENT_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    /** Bundles `vat build` produces for the skills this run discovered. */
+    bundlesExpected: z.ZodNumber;
+    /** Discovered skills that are in place (`publish: false`, not plugin-local): no bundle is expected. */
+    bundlesInPlace: z.ZodNumber;
+    /** Expected bundles absent from `dist/`, project-relative. Non-empty means the phase is not a verdict. */
+    bundlesMissing: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    bundlesExpected: number;
+    bundlesInPlace: number;
+    bundlesMissing: string[];
+}, {
+    bundlesExpected: number;
+    bundlesInPlace: number;
+    bundlesMissing: string[];
+}>, z.ZodObject<Omit<{
+    code: z.ZodString;
+    severity: z.ZodEnum<["error", "warning", "info", "ignore"]>;
+    message: z.ZodString;
+    location: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    line: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    fix: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodString>;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, "severity"> & {
+    severity: z.ZodEnum<["error", "warning", "info"]>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}>>;
+export {};
+//# sourceMappingURL=orchestrator-schema.d.ts.map

package/dist/commands/orchestrator-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-schema.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAQnC,CAAC;AAEF,0DAA0D;AAC1D,QAAA,MAAM,gBAAgB;IACpB,iFAAiF;;IAEjF,uCAAuC;;IAEvC,gDAAgD;;IAEhD,uFAAuF;;;;;;;;;;;;;;IAEvF,qDAAqD;;;;;;;;;;;IAErD,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhE,CAAC;AAEZ,QAAA,MAAM,sBAAsB;IAC1B,iEAAiE;;QAfjE,iFAAiF;;QAEjF,uCAAuC;;QAEvC,gDAAgD;;QAEhD,uFAAuF;;;;;;;;;;;;;;QAEvF,qDAAqD;;;;;;;;;;;QAErD,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOhE,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,oDAAoD;AACpD,eAAO,MAAM,0BAA0B;IATrC,iEAAiE;;QAfjE,iFAAiF;;QAEjF,uCAAuC;;QAEvC,gDAAgD;;QAEhD,uFAAuF;;;;;;;;;;;;;;QAEvF,qDAAqD;;;;;;;;;;;QAErD,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAckB,CAAC;AAE9F;;;;GAIG;AACH,QAAA,MAAM,yBAAyB;IAC7B,uEAAuE;;IAEvE,uGAAuG;;IAEvG,0GAA0G;;;;;;;;;;EAEjG,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,mBAOvC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,8BAA8B;IAzBzC,uEAAuE;;IAEvE,uGAAuG;;IAEvG,0GAA0G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqBR,CAAC"}