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

package/dist/commands/rag/index-command.d.ts

@@ -3,72 +3,61 @@
  */
 import type { IndexResult } from '@vibe-agent-toolkit/rag';
 import type { UnreadableResource } from '@vibe-agent-toolkit/resources';
+import { type ValidationIssue } from '@vibe-agent-toolkit/schema';
+import type { RagIndexReport } from './index-schema.js';
 interface IndexOptions {
     db?: string;
     debug?: boolean;
 }
 /**
- * What an index run is allowed to report, and the exit code that agrees with it.
+ * The provider's per-resource failures, as findings located at each resource's
+ * path.
  *
- * `partial` is spelled the way `vat cache clear` spells it (see
- * `../cache/clear.ts` — `status: 'success' | 'partial'`, exiting
- * `partial ? 1 : 0`): a command that finished, published a complete report, and
- * did not do all of what was asked. The vocabulary is deliberately the sibling's
- * rather than a new one.
+ * The provider names a failure by the registry id; the operator needs the file,
+ * so the id is mapped back through `locations` — and kept as the location when
+ * the registry never mapped it, which only a provider inventing ids could cause.
  *
- * Exit 1, not 2. This command family documents `1 - reported/expected failure`
- * and `2 - system error` (`vat claude budget`, and the `Exit Codes:` block on
- * every `vat rag` subcommand). A run that indexed most of a corpus and named the
- * resources it dropped is a REPORTED outcome — the report on stdout is complete
- * and parseable. 2 belongs to a command that could not run at all, which here is
- * the `handleCommandError` path below.
+ * @param errors - `IndexResult['errors']`, absent when nothing failed
+ * @param locations - Registry id → the resource's path relative to the crawl root
+ * @returns One `RAG_DOCUMENT_INDEX_FAILED` issue per failure
  */
-export interface IndexOutcome {
-    status: 'success' | 'partial';
-    exitCode: 0 | 1;
-}
-/**
- * Derive the reported status and exit code from what indexing actually did.
- *
- * This existed as a hardcoded `status: 'success'` next to an unconditional
- * `process.exit(0)`, so a run that failed a fifth of its corpus told the user —
- * and any CI step parsing it — that everything was fine, while the dropped
- * documents were simply unsearchable. A status field that cannot express failure
- * is the defect; the particular failures it hid are incidental, and
- * `indexResources` can fail a resource for any reason (unreadable file,
- * embedding-provider error, provider unavailable).
- *
- * `errors` is optional on `IndexResult`'s schema, so a provider MAY omit it;
- * `LanceDBRAGProvider` never does (it always carries `errors: []` when nothing
- * failed). Both shapes are success here, because the schema allows both.
- *
- * @param indexResult - The result of the indexing run (only `errors` is read)
- * @returns The status to publish and the exit code that agrees with it
- */
-export declare function indexOutcome(indexResult: Pick<IndexResult, 'errors'>): IndexOutcome;
-/** One entry of `IndexResult['errors']`. */
-type IndexError = NonNullable<IndexResult['errors']>[number];
+export declare function providerIndexIssues(errors: IndexResult['errors'], locations: ReadonlyMap<string, string>): ValidationIssue[];
 /**
- * The resources the crawl enumerated but could not read, as index errors.
+ * The resources the crawl enumerated but could not read, as findings.
  *
  * Such a file never reaches `indexResources`: the crawl reads and parses every
  * file itself, so an unreadable one is dropped before the provider sees it. It
  * is therefore in none of the provider's counters and not in its `errors` —
  * the registry keeps the reconciliation log (`getUnreadableResources()`), and
- * this command did not read it, so a corpus with a document missing from the
- * index was reported `status: success`, exit 0, on both crawl lanes. Folding
- * the log into the same `errors` list the provider's failures land in is what
- * lets one status and one exit code cover "did not index everything asked".
- *
- * The id is the path relative to the crawl root: the registry never assigned
- * one (it could not read the file to), and the relative path is what an
- * operator needs to find it.
+ * without reading it a corpus with a document missing from the index was
+ * reported clean. It is the same finding as a provider failure: the document
+ * is not in the index.
  *
  * @param unreadable - The registry's read-failure log
  * @param crawlRoot - The directory the crawl was rooted at
- * @returns One error per unreadable file, in the order the crawl met them
+ * @returns One issue per unreadable file, in the order the crawl met them
+ */
+export declare function unreadableIndexIssues(unreadable: readonly UnreadableResource[], crawlRoot: string): ValidationIssue[];
+/** What {@link buildIndexReport} needs from a finished run. */
+interface IndexReportInput {
+    /** Resources submitted: every file the crawl enumerated, read or not. */
+    examined: number;
+    /** The counters only: the failures arrive as `issues`, already located. */
+    result: Pick<IndexResult, 'resourcesIndexed' | 'resourcesSkipped' | 'resourcesEmpty' | 'resourcesUpdated' | 'chunksCreated' | 'chunksDeleted'>;
+    /** Every document the index does not hold, from both sources. */
+    issues: readonly ValidationIssue[];
+    durationMs: number;
+}
+/**
+ * The report for a finished index run.
+ *
+ * The status is DERIVED from the findings, never asserted: this used to be a
+ * hardcoded `status: 'success'` beside an unconditional `process.exit(0)`, so a
+ * run that failed a fifth of its corpus told the user — and any CI step parsing
+ * it — that everything was fine. A dropped document is an error finding (exit
+ * 1): the run finished, and the counters report everything that did land.
  */
-export declare function unreadableIndexErrors(unreadable: readonly UnreadableResource[], crawlRoot: string): IndexError[];
+export declare function buildIndexReport(input: IndexReportInput): RagIndexReport;
 export declare function indexCommand(pathArg: string | undefined, options: IndexOptions): Promise<void>;
 export {};
 //# sourceMappingURL=index-command.d.ts.map

package/dist/commands/rag/index-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-command.d.ts","sourceRoot":"","sources":["../../../src/commands/rag/index-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAWxE,UAAU,YAAY;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,YAAY,CAMnF;AAED,4CAA4C;AAC5C,KAAK,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,SAAS,EAAE,MAAM,GAChB,UAAU,EAAE,CAKd;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAuEf"}
+{"version":3,"file":"index-command.d.ts","sourceRoot":"","sources":["../../../src/commands/rag/index-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAW3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,UAAU,YAAY;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC7B,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,eAAe,EAAE,CAEnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,SAAS,EAAE,MAAM,GAChB,eAAe,EAAE,CAKnB;AAED,+DAA+D;AAC/D,UAAU,gBAAgB;IACxB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,GAAG,eAAe,CAAC,CAAC;IAC/I,iEAAiE;IACjE,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,CAgBxE;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CA6Df"}

package/dist/commands/rag/index-command.js

@@ -2,67 +2,93 @@
  * RAG index command - index markdown resources into vector database
  */
 import { LanceDBRAGProvider } from '@vibe-agent-toolkit/rag-lancedb';
-import { ExitCode } from '@vibe-agent-toolkit/schema';
+import { buildReport, toFindings } from '@vibe-agent-toolkit/schema';
 import { safePath, toForwardSlash } from '@vibe-agent-toolkit/utils';
+import { refusalCodeOf } from '../../utils/command-refusal.js';
+import { endWithRefusal, endWithReport, NOTHING_FINISHED } from '../../utils/document-writer.js';
 import { createLogger } from '../../utils/logger.js';
-import { writeYamlOutput } from '../../utils/output.js';
-import { projectRootOrNull } from '../../utils/project-root-policy.js';
+import { assertReadableDirectoryArgument, projectRootOrNull } from '../../utils/project-root-policy.js';
+import { requireWritableDatabase } from '../../utils/rag-database.js';
 import { loadResourcesWithConfig } from '../../utils/resource-loader.js';
-import { formatDuration, handleCommandError, resolveDbPath } from './command-helpers.js';
+import { RAG_GATE, resolveDbPath } from './command-helpers.js';
+const RAG_DOCUMENT_INDEX_FAILED = 'RAG_DOCUMENT_INDEX_FAILED';
+/** One document the index does not hold, as its finding. */
+function notIndexedIssue(location, reason) {
+    return {
+        code: RAG_DOCUMENT_INDEX_FAILED,
+        severity: 'error',
+        message: `${location} is not in the index, so its content is not searchable: ${reason}`,
+        location,
+    };
+}
 /**
- * Derive the reported status and exit code from what indexing actually did.
- *
- * This existed as a hardcoded `status: 'success'` next to an unconditional
- * `process.exit(0)`, so a run that failed a fifth of its corpus told the user —
- * and any CI step parsing it — that everything was fine, while the dropped
- * documents were simply unsearchable. A status field that cannot express failure
- * is the defect; the particular failures it hid are incidental, and
- * `indexResources` can fail a resource for any reason (unreadable file,
- * embedding-provider error, provider unavailable).
+ * The provider's per-resource failures, as findings located at each resource's
+ * path.
  *
- * `errors` is optional on `IndexResult`'s schema, so a provider MAY omit it;
- * `LanceDBRAGProvider` never does (it always carries `errors: []` when nothing
- * failed). Both shapes are success here, because the schema allows both.
+ * The provider names a failure by the registry id; the operator needs the file,
+ * so the id is mapped back through `locations` — and kept as the location when
+ * the registry never mapped it, which only a provider inventing ids could cause.
  *
- * @param indexResult - The result of the indexing run (only `errors` is read)
- * @returns The status to publish and the exit code that agrees with it
+ * @param errors - `IndexResult['errors']`, absent when nothing failed
+ * @param locations - Registry id → the resource's path relative to the crawl root
+ * @returns One `RAG_DOCUMENT_INDEX_FAILED` issue per failure
  */
-export function indexOutcome(indexResult) {
-    const failed = indexResult.errors?.length ?? 0;
-    return failed > 0
-        ? { status: 'partial', exitCode: ExitCode.FINDINGS }
-        : { status: 'success', exitCode: ExitCode.OK };
+export function providerIndexIssues(errors, locations) {
+    return (errors ?? []).map((entry) => notIndexedIssue(locations.get(entry.resourceId) ?? entry.resourceId, entry.error));
 }
 /**
- * The resources the crawl enumerated but could not read, as index errors.
+ * The resources the crawl enumerated but could not read, as findings.
  *
  * Such a file never reaches `indexResources`: the crawl reads and parses every
  * file itself, so an unreadable one is dropped before the provider sees it. It
  * is therefore in none of the provider's counters and not in its `errors` —
  * the registry keeps the reconciliation log (`getUnreadableResources()`), and
- * this command did not read it, so a corpus with a document missing from the
- * index was reported `status: success`, exit 0, on both crawl lanes. Folding
- * the log into the same `errors` list the provider's failures land in is what
- * lets one status and one exit code cover "did not index everything asked".
- *
- * The id is the path relative to the crawl root: the registry never assigned
- * one (it could not read the file to), and the relative path is what an
- * operator needs to find it.
+ * without reading it a corpus with a document missing from the index was
+ * reported clean. It is the same finding as a provider failure: the document
+ * is not in the index.
  *
  * @param unreadable - The registry's read-failure log
  * @param crawlRoot - The directory the crawl was rooted at
- * @returns One error per unreadable file, in the order the crawl met them
+ * @returns One issue per unreadable file, in the order the crawl met them
+ */
+export function unreadableIndexIssues(unreadable, crawlRoot) {
+    return unreadable.map((entry) => notIndexedIssue(toForwardSlash(safePath.relative(crawlRoot, entry.filePath)), `enumerated by the crawl but could not be read: ${entry.reason}`));
+}
+/**
+ * The report for a finished index run.
+ *
+ * The status is DERIVED from the findings, never asserted: this used to be a
+ * hardcoded `status: 'success'` beside an unconditional `process.exit(0)`, so a
+ * run that failed a fifth of its corpus told the user — and any CI step parsing
+ * it — that everything was fine. A dropped document is an error finding (exit
+ * 1): the run finished, and the counters report everything that did land.
  */
-export function unreadableIndexErrors(unreadable, crawlRoot) {
-    return unreadable.map((entry) => ({
-        resourceId: toForwardSlash(safePath.relative(crawlRoot, entry.filePath)),
-        error: `Enumerated by the crawl but could not be read, so it is not in the index: ${entry.reason}`,
-    }));
+export function buildIndexReport(input) {
+    const { result } = input;
+    return buildReport({
+        examined: input.examined,
+        findings: toFindings([...input.issues]),
+        data: {
+            resourcesIndexed: result.resourcesIndexed,
+            resourcesSkipped: result.resourcesSkipped,
+            resourcesEmpty: result.resourcesEmpty,
+            resourcesUpdated: result.resourcesUpdated,
+            chunksCreated: result.chunksCreated,
+            chunksDeleted: result.chunksDeleted,
+        },
+        gate: RAG_GATE,
+        durationMs: input.durationMs,
+    });
 }
 export async function indexCommand(pathArg, options) {
     const logger = createLogger({ debug: options.debug ?? false });
     const startTime = Date.now();
+    let report;
     try {
+        // The path is the root to crawl: one that names nothing, or that the OS
+        // will not list, refuses before any database is opened.
+        if (pathArg !== undefined)
+            assertReadableDirectoryArgument(pathArg);
         // Resolve projectRoot at the CLI boundary.
         // `vat rag index` uses `tolerate null` (spec §7) — rag config-loading
         // produces its own error if config is required.
@@ -77,47 +103,36 @@ export async function indexCommand(pathArg, options) {
         const { registry } = await loadResourcesWithConfig(pathArg, crawlRoot, logger);
         const allResources = registry.getAllResources();
         // The declared population is the admitted one PLUS what the crawl could not
-        // read; the second half is reported below, not dropped — see `unreadableIndexErrors`.
-        const unreadable = unreadableIndexErrors(registry.getUnreadableResources(), crawlRoot);
+        // read; the second half is reported below, not dropped — see `unreadableIndexIssues`.
+        const unreadable = unreadableIndexIssues(registry.getUnreadableResources(), crawlRoot);
         logger.debug(`Found ${allResources.length} resources to index (${unreadable.length} enumerated but unreadable)`);
-        for (const entry of unreadable) {
+        for (const issue of unreadable) {
             // On stderr as well, the way the provider reports its own per-resource
             // failures, so a caller reading only the exit code still sees the name.
-            logger.warn(`[vat-rag] Failed to index resource '${entry.resourceId}': ${entry.error}`);
+            logger.warn(`[vat-rag] ${issue.message}`);
         }
+        requireWritableDatabase(dbPath, options.db !== undefined && options.db !== '');
         // Create RAG provider in admin mode (readonly: false)
         const ragProvider = await LanceDBRAGProvider.create({
             dbPath,
             readonly: false,
         });
-        // Index all resources
         const indexResult = await ragProvider.indexResources(allResources);
-        // Close provider
         await ragProvider.close();
-        const duration = Date.now() - startTime;
-        // One list for both kinds of failure — the provider's and the crawl's.
-        const errors = [...unreadable, ...(indexResult.errors ?? [])];
-        // Status is DERIVED, never asserted: see `indexOutcome`.
-        const outcome = indexOutcome({ errors });
-        // Output results as YAML
-        writeYamlOutput({
-            status: outcome.status,
-            resourcesIndexed: indexResult.resourcesIndexed,
-            resourcesSkipped: indexResult.resourcesSkipped,
-            resourcesEmpty: indexResult.resourcesEmpty,
-            resourcesUpdated: indexResult.resourcesUpdated,
-            chunksCreated: indexResult.chunksCreated,
-            chunksDeleted: indexResult.chunksDeleted,
-            duration: formatDuration(duration),
-            ...(errors.length > 0 ? { errors } : {}),
+        const locations = new Map(allResources.map((resource) => [
+            resource.id,
+            toForwardSlash(safePath.relative(crawlRoot, resource.filePath)),
+        ]));
+        report = buildIndexReport({
+            examined: allResources.length + unreadable.length,
+            result: indexResult,
+            issues: [...unreadable, ...providerIndexIssues(indexResult.errors, locations)],
+            durationMs: Date.now() - startTime,
         });
-        // The report is published FIRST and the failure signalled after, so a
-        // partial run still hands the operator the `errors` list naming exactly
-        // which resources are missing from the database.
-        process.exit(outcome.exitCode);
     }
     catch (error) {
-        handleCommandError(error, logger, startTime, 'Index');
+        return endWithRefusal('rag index', refusalCodeOf(error), error, 'yaml', RAG_GATE, NOTHING_FINISHED);
     }
+    endWithReport('rag index', report, 'yaml');
 }
 //# sourceMappingURL=index-command.js.map

package/dist/commands/rag/index-command.js.map

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

package/dist/commands/rag/index-schema.d.ts

@@ -0,0 +1,107 @@
+/**
+ * The document `vat rag index` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes) — and because the registry loads at startup,
+ * so this file must not import `@vibe-agent-toolkit/rag` or `rag-lancedb` (the
+ * optional backend) at runtime.
+ *
+ * `examined` counts the resources submitted: every markdown file the crawl
+ * enumerated, read or not. Each one the index does not hold — a file the crawl
+ * could not read, or one the provider failed to chunk or embed — is a
+ * `RAG_DOCUMENT_INDEX_FAILED` finding (error, exit 1) located at its path; the
+ * counters still report everything that did land.
+ */
+import { type Report } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+import type { ExaminedDeclaration } from '../../utils/run-integrity.js';
+/** What `examined` counts for `vat rag index`, and the remedy when it is zero. */
+export declare const RAG_INDEX_EXAMINED: ExaminedDeclaration;
+declare const RagIndexDataSchema: z.ZodObject<{
+    resourcesIndexed: z.ZodNumber;
+    resourcesSkipped: z.ZodNumber;
+    resourcesEmpty: z.ZodNumber;
+    resourcesUpdated: z.ZodNumber;
+    chunksCreated: z.ZodNumber;
+    chunksDeleted: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    resourcesIndexed: number;
+    resourcesSkipped: number;
+    resourcesEmpty: number;
+    resourcesUpdated: number;
+    chunksCreated: number;
+    chunksDeleted: number;
+}, {
+    resourcesIndexed: number;
+    resourcesSkipped: number;
+    resourcesEmpty: number;
+    resourcesUpdated: number;
+    chunksCreated: number;
+    chunksDeleted: number;
+}>;
+export type RagIndexData = z.infer<typeof RagIndexDataSchema>;
+/** The document this command publishes. */
+export declare const RAG_INDEX_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    resourcesIndexed: z.ZodNumber;
+    resourcesSkipped: z.ZodNumber;
+    resourcesEmpty: z.ZodNumber;
+    resourcesUpdated: z.ZodNumber;
+    chunksCreated: z.ZodNumber;
+    chunksDeleted: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    resourcesIndexed: number;
+    resourcesSkipped: number;
+    resourcesEmpty: number;
+    resourcesUpdated: number;
+    chunksCreated: number;
+    chunksDeleted: number;
+}, {
+    resourcesIndexed: number;
+    resourcesSkipped: number;
+    resourcesEmpty: number;
+    resourcesUpdated: number;
+    chunksCreated: number;
+    chunksDeleted: number;
+}>, 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 type RagIndexReport = Report<RagIndexData>;
+export {};
+//# sourceMappingURL=index-schema.d.ts.map

package/dist/commands/rag/index-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-schema.d.ts","sourceRoot":"","sources":["../../../src/commands/rag/index-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,EAAE,mBAGhC,CAAC;AAIF,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAOb,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAkD,CAAC;AAEvF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC"}

package/dist/commands/rag/index-schema.js

@@ -0,0 +1,34 @@
+/**
+ * The document `vat rag index` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes) — and because the registry loads at startup,
+ * so this file must not import `@vibe-agent-toolkit/rag` or `rag-lancedb` (the
+ * optional backend) at runtime.
+ *
+ * `examined` counts the resources submitted: every markdown file the crawl
+ * enumerated, read or not. Each one the index does not hold — a file the crawl
+ * could not read, or one the provider failed to chunk or embed — is a
+ * `RAG_DOCUMENT_INDEX_FAILED` finding (error, exit 1) located at its path; the
+ * counters still report everything that did land.
+ */
+import { FindingSchema, reportSchema } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+/** What `examined` counts for `vat rag index`, and the remedy when it is zero. */
+export const RAG_INDEX_EXAMINED = {
+    unit: 'resources submitted',
+    whenZero: 'No markdown file was found to index: check the path argument, or the resources include/exclude patterns in vibe-agent-toolkit.config.yaml.',
+};
+const count = z.number().int().nonnegative();
+const RagIndexDataSchema = z.object({
+    resourcesIndexed: count,
+    resourcesSkipped: count,
+    resourcesEmpty: count,
+    resourcesUpdated: count,
+    chunksCreated: count,
+    chunksDeleted: count,
+}).strict();
+/** The document this command publishes. */
+export const RAG_INDEX_REPORT_SCHEMA = reportSchema(RagIndexDataSchema, FindingSchema);
+//# sourceMappingURL=index-schema.js.map

package/dist/commands/rag/index-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-schema.js","sourceRoot":"","sources":["../../../src/commands/rag/index-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAe,MAAM,4BAA4B,CAAC;AACtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,4IAA4I;CACvJ,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAE7C,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,cAAc,EAAE,KAAK;IACrB,gBAAgB,EAAE,KAAK;IACvB,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,KAAK;CACrB,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/rag/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,wBAAgB,gBAAgB,IAAI,OAAO,CA0M1C;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/rag/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,wBAAgB,gBAAgB,IAAI,OAAO,CAyP1C;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}