pulseed 0.4.4 → 0.4.7

package/dist/platform/soil/frontmatter.js.map

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

package/dist/platform/soil/health.d.ts

@@ -0,0 +1,35 @@
+import { type SoilCompileMissObservation, type SoilContextRouteInput, type SoilMemoryLintFinding } from "./contracts.js";
+export interface SoilCompileMissBucket {
+    key: string;
+    count: number;
+    reason: SoilCompileMissObservation["reason"];
+    targetPath: string | null;
+    routeIds: string[];
+}
+export interface SoilMemoryHealthSnapshot {
+    generatedAt: string;
+    rootDir: string;
+    totalPages: number;
+    findingCount: number;
+    errorCount: number;
+    warningCount: number;
+    compileMissCount: number;
+    compileMissBuckets: SoilCompileMissBucket[];
+    findings: SoilMemoryLintFinding[];
+}
+export interface SoilRouteHealthResult {
+    routes: SoilContextRouteInput[];
+    deprecatedRouteIds: string[];
+}
+export declare function aggregateCompileMisses(observations: SoilCompileMissObservation[]): SoilCompileMissBucket[];
+export declare function inspectSoilMemoryHealth(input: {
+    rootDir?: string;
+    compileMissObservations?: SoilCompileMissObservation[];
+    clock?: () => Date;
+}): Promise<SoilMemoryHealthSnapshot>;
+export declare function applySoilRouteHealth(input: {
+    routes: SoilContextRouteInput[];
+    findings: SoilMemoryLintFinding[];
+    now?: () => Date;
+}): SoilRouteHealthResult;
+//# sourceMappingURL=health.d.ts.map

package/dist/platform/soil/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/platform/soil/health.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAE3B,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;IAC5C,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AA4DD,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,0BAA0B,EAAE,GAAG,qBAAqB,EAAE,CAoB1G;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAmBpC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,GAAG,qBAAqB,CAgCxB"}

package/dist/platform/soil/health.js

@@ -0,0 +1,126 @@
+import { randomUUID } from "node:crypto";
+import { SoilMemoryLintFindingSchema, } from "./contracts.js";
+import { SoilDoctor } from "./doctor.js";
+function nowIso(clock) {
+    return (clock?.() ?? new Date()).toISOString();
+}
+function doctorFindingCode(finding) {
+    switch (finding.code) {
+        case "missing-source-path":
+            return "broken_source_ref";
+        case "duplicate-soil-id":
+            return "conflicting_active_record";
+        case "missing-required-page":
+            return "orphan_page";
+        case "invalid-frontmatter":
+        case "checksum-mismatch":
+        case "watermark-mismatch":
+        case "index-checksum-mismatch":
+        case "index-page-count-mismatch":
+        case "typed-store-projection-gap":
+            return "stale_page";
+        case "missing-index":
+        case "unsafe-path":
+        case "typed-store-unreadable":
+            return "schema_incompatible";
+    }
+}
+function findingSeverity(finding) {
+    return finding.severity === "error" ? "error" : "warning";
+}
+function toMemoryLintFinding(finding, generatedAt) {
+    return SoilMemoryLintFindingSchema.parse({
+        finding_id: `soil-doctor:${finding.code}:${finding.soilId ?? finding.relativePath}`,
+        code: doctorFindingCode(finding),
+        severity: findingSeverity(finding),
+        message: finding.message,
+        soil_id: finding.soilId ?? null,
+        source_path: finding.absolutePath,
+        created_at: generatedAt,
+    });
+}
+function compileMissFinding(observation) {
+    const code = observation.reason === "bad_route" || observation.reason === "stale_route"
+        ? "stale_route"
+        : "missing_route";
+    return SoilMemoryLintFindingSchema.parse({
+        finding_id: `compile-miss:${observation.observation_id}`,
+        code,
+        severity: observation.reason === "low_confidence_search" ? "warning" : "info",
+        message: observation.notes ?? `Compile miss: ${observation.reason}`,
+        route_id: observation.route_ids[0] ?? null,
+        source_path: observation.target_paths[0] ?? null,
+        created_at: observation.created_at,
+    });
+}
+export function aggregateCompileMisses(observations) {
+    const buckets = new Map();
+    for (const observation of observations) {
+        const targetPath = observation.target_paths[0] ?? null;
+        const routeIds = observation.route_ids;
+        const key = `${observation.reason}:${targetPath ?? "global"}:${routeIds.join(",")}`;
+        const existing = buckets.get(key);
+        if (existing) {
+            existing.count += 1;
+            continue;
+        }
+        buckets.set(key, {
+            key,
+            count: 1,
+            reason: observation.reason,
+            targetPath,
+            routeIds,
+        });
+    }
+    return [...buckets.values()].sort((left, right) => right.count - left.count || left.key.localeCompare(right.key));
+}
+export async function inspectSoilMemoryHealth(input) {
+    const generatedAt = nowIso(input.clock);
+    const report = await SoilDoctor.create({ rootDir: input.rootDir }).inspect();
+    const compileMissObservations = input.compileMissObservations ?? [];
+    const findings = [
+        ...report.findings.map((finding) => toMemoryLintFinding(finding, generatedAt)),
+        ...compileMissObservations.map((observation) => compileMissFinding(observation)),
+    ];
+    return {
+        generatedAt,
+        rootDir: report.rootDir,
+        totalPages: report.totalPages,
+        findingCount: findings.length,
+        errorCount: findings.filter((finding) => finding.severity === "error").length,
+        warningCount: findings.filter((finding) => finding.severity === "warning").length,
+        compileMissCount: compileMissObservations.length,
+        compileMissBuckets: aggregateCompileMisses(compileMissObservations),
+        findings,
+    };
+}
+export function applySoilRouteHealth(input) {
+    const generatedAt = nowIso(input.now);
+    const unhealthyRouteIds = new Set(input.findings
+        .filter((finding) => finding.route_id !== null &&
+        finding.status === "open" &&
+        finding.severity === "error" &&
+        (finding.code === "broken_route_target" || finding.code === "stale_route"))
+        .map((finding) => finding.route_id));
+    if (unhealthyRouteIds.size === 0) {
+        return { routes: input.routes, deprecatedRouteIds: [] };
+    }
+    const deprecatedRouteIds = [];
+    const routes = input.routes.map((route) => {
+        if (!unhealthyRouteIds.has(route.route_id) || (route.status ?? "active") !== "active") {
+            return route;
+        }
+        deprecatedRouteIds.push(route.route_id);
+        return {
+            ...route,
+            status: "deprecated",
+            updated_at: generatedAt,
+            source_observation_ids: [
+                ...(route.source_observation_ids ?? []),
+                `route-health:${randomUUID()}`,
+            ],
+        };
+    });
+    return { routes, deprecatedRouteIds };
+}
+//# sourceMappingURL=health.js.map

package/dist/platform/soil/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/platform/soil/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,2BAA2B,GAK5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAC;AA2BjE,SAAS,MAAM,CAAC,KAAkB;IAChC,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA0B;IACnD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,qBAAqB;YACxB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,uBAAuB;YAC1B,OAAO,aAAa,CAAC;QACvB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,mBAAmB,CAAC;QACzB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,yBAAyB,CAAC;QAC/B,KAAK,2BAA2B,CAAC;QACjC,KAAK,4BAA4B;YAC/B,OAAO,YAAY,CAAC;QACtB,KAAK,eAAe,CAAC;QACrB,KAAK,aAAa,CAAC;QACnB,KAAK,wBAAwB;YAC3B,OAAO,qBAAqB,CAAC;IACjC,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAA0B;IACjD,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA0B,EAAE,WAAmB;IAC1E,OAAO,2BAA2B,CAAC,KAAK,CAAC;QACvC,UAAU,EAAE,eAAe,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE;QACnF,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;QAChC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC/B,WAAW,EAAE,OAAO,CAAC,YAAY;QACjC,UAAU,EAAE,WAAW;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAuC;IACjE,MAAM,IAAI,GACR,WAAW,CAAC,MAAM,KAAK,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,aAAa;QACxE,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,eAAe,CAAC;IACtB,OAAO,2BAA2B,CAAC,KAAK,CAAC;QACvC,UAAU,EAAE,gBAAgB,WAAW,CAAC,cAAc,EAAE;QACxD,IAAI;QACJ,QAAQ,EAAE,WAAW,CAAC,MAAM,KAAK,uBAAuB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QAC7E,OAAO,EAAE,WAAW,CAAC,KAAK,IAAI,iBAAiB,WAAW,CAAC,MAAM,EAAE;QACnE,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI;QAC1C,WAAW,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI;QAChD,UAAU,EAAE,WAAW,CAAC,UAAU;KACnC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,YAA0C;IAC/E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiC,CAAC;IACzD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACvD,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,MAAM,IAAI,UAAU,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;YACf,GAAG;YACH,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,WAAW,CAAC,MAAM;YAC1B,UAAU;YACV,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACpH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAI7C;IACC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7E,MAAM,uBAAuB,GAAG,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC;IACpE,MAAM,QAAQ,GAAG;QACf,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC9E,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;KACjF,CAAC;IACF,OAAO;QACL,WAAW;QACX,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;QAC7E,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;QACjF,gBAAgB,EAAE,uBAAuB,CAAC,MAAM;QAChD,kBAAkB,EAAE,sBAAsB,CAAC,uBAAuB,CAAC;QACnE,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAIpC;IACC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC/B,KAAK,CAAC,QAAQ;SACX,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAClB,OAAO,CAAC,QAAQ,KAAK,IAAI;QACzB,OAAO,CAAC,MAAM,KAAK,MAAM;QACzB,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC5B,CAAC,OAAO,CAAC,IAAI,KAAK,qBAAqB,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,CAAC,CAC3E;SACA,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAkB,CAAC,CAChD,CAAC;IACF,IAAI,iBAAiB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;YACtF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO;YACL,GAAG,KAAK;YACR,MAAM,EAAE,YAAqB;YAC7B,UAAU,EAAE,WAAW;YACvB,sBAAsB,EAAE;gBACtB,GAAG,CAAC,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC;gBACvC,gBAAgB,UAAU,EAAE,EAAE;aAC/B;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;AACxC,CAAC"}

package/dist/platform/soil/importer.d.ts

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import { type SoilConfigInput } from "./config.js";
+export declare const SoilOverlayStatusSchema: z.ZodEnum<["candidate", "approved", "rejected", "superseded"]>;
+export type SoilOverlayStatus = z.infer<typeof SoilOverlayStatusSchema>;
+export declare const SoilOverlayCandidateSchema: z.ZodObject<{
+    overlay_id: z.ZodString;
+    status: z.ZodEnum<["candidate", "approved", "rejected", "superseded"]>;
+    soil_id: z.ZodString;
+    relative_path: z.ZodString;
+    target_ref: z.ZodString;
+    content: z.ZodString;
+    content_hash: z.ZodString;
+    detected_at: z.ZodString;
+    updated_at: z.ZodString;
+    decision_note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "candidate" | "superseded" | "rejected" | "approved";
+    updated_at: string;
+    content: string;
+    detected_at: string;
+    overlay_id: string;
+    target_ref: string;
+    soil_id: string;
+    relative_path: string;
+    content_hash: string;
+    decision_note?: string | undefined;
+}, {
+    status: "candidate" | "superseded" | "rejected" | "approved";
+    updated_at: string;
+    content: string;
+    detected_at: string;
+    overlay_id: string;
+    target_ref: string;
+    soil_id: string;
+    relative_path: string;
+    content_hash: string;
+    decision_note?: string | undefined;
+}>;
+export type SoilOverlayCandidate = z.infer<typeof SoilOverlayCandidateSchema>;
+export declare const SoilOverlayQueueSchema: z.ZodObject<{
+    version: z.ZodLiteral<"soil-overlay-queue-v1">;
+    updated_at: z.ZodString;
+    overlays: z.ZodArray<z.ZodObject<{
+        overlay_id: z.ZodString;
+        status: z.ZodEnum<["candidate", "approved", "rejected", "superseded"]>;
+        soil_id: z.ZodString;
+        relative_path: z.ZodString;
+        target_ref: z.ZodString;
+        content: z.ZodString;
+        content_hash: z.ZodString;
+        detected_at: z.ZodString;
+        updated_at: z.ZodString;
+        decision_note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "candidate" | "superseded" | "rejected" | "approved";
+        updated_at: string;
+        content: string;
+        detected_at: string;
+        overlay_id: string;
+        target_ref: string;
+        soil_id: string;
+        relative_path: string;
+        content_hash: string;
+        decision_note?: string | undefined;
+    }, {
+        status: "candidate" | "superseded" | "rejected" | "approved";
+        updated_at: string;
+        content: string;
+        detected_at: string;
+        overlay_id: string;
+        target_ref: string;
+        soil_id: string;
+        relative_path: string;
+        content_hash: string;
+        decision_note?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    updated_at: string;
+    version: "soil-overlay-queue-v1";
+    overlays: {
+        status: "candidate" | "superseded" | "rejected" | "approved";
+        updated_at: string;
+        content: string;
+        detected_at: string;
+        overlay_id: string;
+        target_ref: string;
+        soil_id: string;
+        relative_path: string;
+        content_hash: string;
+        decision_note?: string | undefined;
+    }[];
+}, {
+    updated_at: string;
+    version: "soil-overlay-queue-v1";
+    overlays: {
+        status: "candidate" | "superseded" | "rejected" | "approved";
+        updated_at: string;
+        content: string;
+        detected_at: string;
+        overlay_id: string;
+        target_ref: string;
+        soil_id: string;
+        relative_path: string;
+        content_hash: string;
+        decision_note?: string | undefined;
+    }[];
+}>;
+export type SoilOverlayQueue = z.infer<typeof SoilOverlayQueueSchema>;
+export interface SoilImportOptions {
+    clock?: () => Date;
+}
+export declare function loadSoilOverlayQueue(configInput?: SoilConfigInput): Promise<SoilOverlayQueue>;
+export declare function scanSoilOverlays(configInput?: SoilConfigInput, options?: SoilImportOptions): Promise<SoilOverlayCandidate[]>;
+export declare function scanAndStoreSoilOverlays(configInput?: SoilConfigInput, options?: SoilImportOptions): Promise<SoilOverlayQueue>;
+export declare function updateSoilOverlayStatus(overlayId: string, status: SoilOverlayStatus, configInput?: SoilConfigInput, options?: SoilImportOptions & {
+    decisionNote?: string;
+}): Promise<SoilOverlayQueue>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/platform/soil/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../src/platform/soil/importer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAQrE,eAAO,MAAM,uBAAuB,gEAA8D,CAAC;AACnG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAoCD,wBAAsB,oBAAoB,CAAC,WAAW,GAAE,eAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAOvG;AAED,wBAAsB,gBAAgB,CACpC,WAAW,GAAE,eAAoB,EACjC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAuBjC;AAED,wBAAsB,wBAAwB,CAC5C,WAAW,GAAE,eAAoB,EACjC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA0B3B;AAED,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,iBAAiB,EACzB,WAAW,GAAE,eAAoB,EACjC,OAAO,GAAE,iBAAiB,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1D,OAAO,CAAC,gBAAgB,CAAC,CA2B3B"}

package/dist/platform/soil/importer.js

@@ -0,0 +1,145 @@
+import * as path from "node:path";
+import { z } from "zod";
+import { computeSoilChecksum } from "./checksum.js";
+import { createSoilConfig } from "./config.js";
+import { readJsonFileOrNull, writeJsonFileAtomic } from "../../base/utils/json-io.js";
+import { loadSoilManifest } from "./retriever.js";
+const OVERLAY_BEGIN = "<!-- soil:overlay-begin -->";
+const OVERLAY_END = "<!-- soil:overlay-end -->";
+const OVERLAY_QUEUE_FILE = "overlay-queue.json";
+export const SoilOverlayStatusSchema = z.enum(["candidate", "approved", "rejected", "superseded"]);
+export const SoilOverlayCandidateSchema = z.object({
+    overlay_id: z.string().min(1),
+    status: SoilOverlayStatusSchema,
+    soil_id: z.string().min(1),
+    relative_path: z.string().min(1),
+    target_ref: z.string().min(1),
+    content: z.string(),
+    content_hash: z.string().min(1),
+    detected_at: z.string().datetime(),
+    updated_at: z.string().datetime(),
+    decision_note: z.string().optional(),
+});
+export const SoilOverlayQueueSchema = z.object({
+    version: z.literal("soil-overlay-queue-v1"),
+    updated_at: z.string().datetime(),
+    overlays: z.array(SoilOverlayCandidateSchema),
+});
+function nowIso(clock) {
+    return (clock?.() ?? new Date()).toISOString();
+}
+function overlayQueuePath(rootDir) {
+    return path.join(rootDir, ".index", OVERLAY_QUEUE_FILE);
+}
+function overlayId(relativePath, index, content) {
+    return computeSoilChecksum({ relativePath, index, content }).replace(/^sha256:/, "overlay-");
+}
+function extractOverlayBlocks(body) {
+    const blocks = [];
+    let cursor = 0;
+    while (cursor < body.length) {
+        const begin = body.indexOf(OVERLAY_BEGIN, cursor);
+        if (begin < 0) {
+            break;
+        }
+        const contentStart = begin + OVERLAY_BEGIN.length;
+        const end = body.indexOf(OVERLAY_END, contentStart);
+        if (end < 0) {
+            break;
+        }
+        const content = body.slice(contentStart, end).trim();
+        if (content) {
+            blocks.push({ index: blocks.length, content });
+        }
+        cursor = end + OVERLAY_END.length;
+    }
+    return blocks;
+}
+export async function loadSoilOverlayQueue(configInput = {}) {
+    const config = createSoilConfig(configInput);
+    const raw = await readJsonFileOrNull(overlayQueuePath(config.rootDir));
+    const parsed = SoilOverlayQueueSchema.safeParse(raw);
+    return parsed.success
+        ? parsed.data
+        : { version: "soil-overlay-queue-v1", updated_at: new Date(0).toISOString(), overlays: [] };
+}
+export async function scanSoilOverlays(configInput = {}, options = {}) {
+    const config = createSoilConfig(configInput);
+    const detectedAt = nowIso(options.clock);
+    const manifest = await loadSoilManifest({ rootDir: config.rootDir, indexPath: config.indexPath });
+    const overlays = [];
+    for (const page of manifest.pages) {
+        const blocks = extractOverlayBlocks(page.body);
+        for (const block of blocks) {
+            const contentHash = computeSoilChecksum(block.content);
+            overlays.push(SoilOverlayCandidateSchema.parse({
+                overlay_id: overlayId(page.relativePath, block.index, block.content),
+                status: "candidate",
+                soil_id: page.soilId,
+                relative_path: page.relativePath,
+                target_ref: `${page.soilId}#overlay-${block.index}`,
+                content: block.content,
+                content_hash: contentHash,
+                detected_at: detectedAt,
+                updated_at: detectedAt,
+            }));
+        }
+    }
+    return overlays;
+}
+export async function scanAndStoreSoilOverlays(configInput = {}, options = {}) {
+    const config = createSoilConfig(configInput);
+    const now = nowIso(options.clock);
+    const existing = await loadSoilOverlayQueue(config);
+    const existingById = new Map(existing.overlays.map((overlay) => [overlay.overlay_id, overlay]));
+    const detected = await scanSoilOverlays(config, options);
+    const merged = detected.map((overlay) => {
+        const previous = existingById.get(overlay.overlay_id);
+        if (!previous) {
+            return overlay;
+        }
+        return SoilOverlayCandidateSchema.parse({
+            ...overlay,
+            status: previous.status,
+            detected_at: previous.detected_at,
+            updated_at: previous.updated_at,
+            decision_note: previous.decision_note,
+        });
+    });
+    const queue = SoilOverlayQueueSchema.parse({
+        version: "soil-overlay-queue-v1",
+        updated_at: now,
+        overlays: merged,
+    });
+    await writeJsonFileAtomic(overlayQueuePath(config.rootDir), queue);
+    return queue;
+}
+export async function updateSoilOverlayStatus(overlayId, status, configInput = {}, options = {}) {
+    const config = createSoilConfig(configInput);
+    const queue = await loadSoilOverlayQueue(config);
+    const now = nowIso(options.clock);
+    let found = false;
+    const overlays = queue.overlays.map((overlay) => {
+        if (overlay.overlay_id !== overlayId) {
+            return overlay;
+        }
+        found = true;
+        return SoilOverlayCandidateSchema.parse({
+            ...overlay,
+            status,
+            updated_at: now,
+            decision_note: options.decisionNote ?? overlay.decision_note,
+        });
+    });
+    if (!found) {
+        throw new Error(`Soil overlay not found: ${overlayId}`);
+    }
+    const next = SoilOverlayQueueSchema.parse({
+        version: "soil-overlay-queue-v1",
+        updated_at: now,
+        overlays,
+    });
+    await writeJsonFileAtomic(overlayQueuePath(config.rootDir), next);
+    return next;
+}
+//# sourceMappingURL=importer.js.map

package/dist/platform/soil/importer.js.map

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

package/dist/platform/soil/index-store.d.ts

@@ -0,0 +1,89 @@
+import { type SoilConfigInput } from "./config.js";
+import { type SoilPageStore } from "./retriever.js";
+import { type SoilGenerationWatermark, type SoilManualOverlay, type SoilSourceRef, type SoilSourceTruth } from "./types.js";
+export declare const SOIL_INDEX_STORAGE_FORMAT: "file-json-v1";
+export interface SoilIndexChunkSnapshot {
+    chunk_id: string;
+    soil_id: string;
+    relative_path: string;
+    absolute_path: string;
+    chunk_type: "heading" | "paragraph";
+    heading_path: string[];
+    heading?: string;
+    position: number;
+    text: string;
+    token_count: number;
+}
+export interface SoilIndexPageSnapshot {
+    soil_id: string;
+    relative_path: string;
+    absolute_path: string;
+    title: string;
+    kind: string;
+    route: string;
+    status: string;
+    source: string;
+    version: string;
+    created_at: string;
+    updated_at: string;
+    generated_at: string;
+    summary?: string;
+    source_refs: SoilSourceRef[];
+    generation_watermark: SoilGenerationWatermark;
+    stale: boolean;
+    manual_overlay: SoilManualOverlay;
+    source_truth?: SoilSourceTruth;
+    page_format_version?: string;
+    checksum?: string;
+    chunk_count: number;
+}
+export interface SoilIndexRetrievalRun {
+    query: string;
+    limit: number;
+    generated_at: string;
+    hit_count: number;
+}
+export interface SoilIndexSnapshot {
+    storage: typeof SOIL_INDEX_STORAGE_FORMAT;
+    root_dir: string;
+    index_path: string;
+    generated_at: string;
+    source_manifest_checksum: string;
+    page_count: number;
+    chunk_count: number;
+    pages: SoilIndexPageSnapshot[];
+    chunks: SoilIndexChunkSnapshot[];
+    retrieval_runs: SoilIndexRetrievalRun[];
+}
+export interface SoilIndexQueryHit {
+    soil_id: string;
+    relative_path: string;
+    absolute_path: string;
+    title: string;
+    kind: string;
+    route: string;
+    status: string;
+    summary?: string;
+    score: number;
+    snippet: string;
+    chunk_count: number;
+    checksum?: string;
+}
+export interface SoilIndexBuildOptions {
+    clock?: () => Date;
+    store?: SoilPageStore;
+}
+export interface SoilIndexFreshnessReport {
+    fresh: boolean;
+    reason: "missing-index" | "manifest-checksum-mismatch" | "page-count-mismatch" | "fresh";
+    indexPath: string;
+    indexedManifestChecksum?: string;
+    currentManifestChecksum?: string;
+    indexedPageCount?: number;
+    currentPageCount?: number;
+}
+export declare function rebuildSoilIndex(configInput?: SoilConfigInput, options?: SoilIndexBuildOptions): Promise<SoilIndexSnapshot>;
+export declare function loadSoilIndexSnapshot(configInput?: SoilConfigInput): Promise<SoilIndexSnapshot | null>;
+export declare function checkSoilIndexFresh(configInput?: SoilConfigInput, options?: Pick<SoilIndexBuildOptions, "store">): Promise<SoilIndexFreshnessReport>;
+export declare function querySoilIndexSnapshot(query: string, limit?: number, configInput?: SoilConfigInput): Promise<SoilIndexQueryHit[]>;
+//# sourceMappingURL=index-store.d.ts.map

package/dist/platform/soil/index-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-store.d.ts","sourceRoot":"","sources":["../../../src/platform/soil/index-store.ts"],"names":[],"mappings":"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"}