pulseed 0.4.18 → 0.4.19

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

@@ -0,0 +1,1366 @@
+import { z } from "zod";
+export declare const SoilRecordTypeSchema: z.ZodEnum<["fact", "workflow", "preference", "observation", "decision", "state", "identity", "artifact", "reflection"]>;
+export type SoilRecordType = z.infer<typeof SoilRecordTypeSchema>;
+export declare const SoilRecordStatusSchema: z.ZodEnum<["draft", "active", "candidate", "confirmed", "stale", "superseded", "expired", "rejected", "archived", "completed", "cancelled", "deleted", "unreachable", "replaced"]>;
+export type SoilRecordStatus = z.infer<typeof SoilRecordStatusSchema>;
+export declare const SoilChunkKindSchema: z.ZodEnum<["title", "summary", "heading", "paragraph", "list", "table", "quote", "code"]>;
+export type SoilChunkKind = z.infer<typeof SoilChunkKindSchema>;
+export declare const SoilPageMemberRoleSchema: z.ZodEnum<["primary", "supporting", "summary", "evidence", "related"]>;
+export type SoilPageMemberRole = z.infer<typeof SoilPageMemberRoleSchema>;
+export declare const SoilEdgeTypeSchema: z.ZodEnum<["supports", "contradicts", "caused_by", "references", "derived_from", "related_to", "belongs_to"]>;
+export type SoilEdgeType = z.infer<typeof SoilEdgeTypeSchema>;
+export declare const SoilEmbeddingEncodingSchema: z.ZodEnum<["json", "f32le"]>;
+export type SoilEmbeddingEncoding = z.infer<typeof SoilEmbeddingEncodingSchema>;
+export declare const SoilLaneSchema: z.ZodEnum<["direct", "lexical", "dense", "hybrid", "recency", "rerank"]>;
+export type SoilLane = z.infer<typeof SoilLaneSchema>;
+export declare const SoilSortDirectionSchema: z.ZodEnum<["asc", "desc"]>;
+export type SoilSortDirection = z.infer<typeof SoilSortDirectionSchema>;
+export declare const SoilMemoryLifecycleStateSchema: z.ZodEnum<["active", "deprecated", "superseded", "archived", "tombstoned"]>;
+export type SoilMemoryLifecycleState = z.infer<typeof SoilMemoryLifecycleStateSchema>;
+export declare const SoilRecordSchema: z.ZodObject<{
+    record_id: z.ZodString;
+    record_key: z.ZodString;
+    version: z.ZodNumber;
+    record_type: z.ZodEnum<["fact", "workflow", "preference", "observation", "decision", "state", "identity", "artifact", "reflection"]>;
+    soil_id: z.ZodString;
+    title: z.ZodString;
+    summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    canonical_text: z.ZodString;
+    goal_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    task_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    status: z.ZodEnum<["draft", "active", "candidate", "confirmed", "stale", "superseded", "expired", "rejected", "archived", "completed", "cancelled", "deleted", "unreachable", "replaced"]>;
+    confidence: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    importance: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    source_reliability: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    valid_from: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    valid_to: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    supersedes_record_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    is_active: z.ZodDefault<z.ZodBoolean>;
+    source_type: z.ZodString;
+    source_id: z.ZodString;
+    metadata_json: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced";
+    confidence: number | null;
+    title: string;
+    created_at: string;
+    updated_at: string;
+    goal_id: string | null;
+    task_id: string | null;
+    summary: string | null;
+    version: number;
+    source_id: string;
+    importance: number | null;
+    valid_from: string | null;
+    valid_to: string | null;
+    source_type: string;
+    soil_id: string;
+    record_id: string;
+    record_key: string;
+    record_type: "observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact";
+    canonical_text: string;
+    source_reliability: number | null;
+    supersedes_record_id: string | null;
+    is_active: boolean;
+    metadata_json: Record<string, unknown>;
+}, {
+    status: "completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced";
+    title: string;
+    created_at: string;
+    updated_at: string;
+    version: number;
+    source_id: string;
+    source_type: string;
+    soil_id: string;
+    record_id: string;
+    record_key: string;
+    record_type: "observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact";
+    canonical_text: string;
+    confidence?: number | null | undefined;
+    goal_id?: string | null | undefined;
+    task_id?: string | null | undefined;
+    summary?: string | null | undefined;
+    importance?: number | null | undefined;
+    valid_from?: string | null | undefined;
+    valid_to?: string | null | undefined;
+    source_reliability?: number | null | undefined;
+    supersedes_record_id?: string | null | undefined;
+    is_active?: boolean | undefined;
+    metadata_json?: Record<string, unknown> | undefined;
+}>;
+export type SoilRecord = z.infer<typeof SoilRecordSchema>;
+export declare const SoilChunkSchema: z.ZodObject<{
+    chunk_id: z.ZodString;
+    record_id: z.ZodString;
+    soil_id: z.ZodString;
+    chunk_index: z.ZodNumber;
+    chunk_kind: z.ZodEnum<["title", "summary", "heading", "paragraph", "list", "table", "quote", "code"]>;
+    heading_path_json: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    chunk_text: z.ZodString;
+    token_count: z.ZodNumber;
+    checksum: z.ZodString;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    soil_id: string;
+    checksum: string;
+    chunk_id: string;
+    token_count: number;
+    record_id: string;
+    chunk_index: number;
+    chunk_kind: "code" | "title" | "summary" | "list" | "heading" | "paragraph" | "table" | "quote";
+    heading_path_json: string[];
+    chunk_text: string;
+}, {
+    created_at: string;
+    soil_id: string;
+    checksum: string;
+    chunk_id: string;
+    token_count: number;
+    record_id: string;
+    chunk_index: number;
+    chunk_kind: "code" | "title" | "summary" | "list" | "heading" | "paragraph" | "table" | "quote";
+    chunk_text: string;
+    heading_path_json?: string[] | undefined;
+}>;
+export type SoilChunk = z.infer<typeof SoilChunkSchema>;
+export declare const SoilPageSchema: z.ZodObject<{
+    page_id: z.ZodString;
+    soil_id: z.ZodString;
+    relative_path: z.ZodString;
+    route: z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox"]>;
+    kind: z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox", "overlay", "note"]>;
+    status: z.ZodEnum<["draft", "candidate", "confirmed", "stale", "superseded", "rejected", "deprecated", "archived"]>;
+    markdown: z.ZodString;
+    checksum: z.ZodString;
+    projected_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated";
+    kind: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay";
+    soil_id: string;
+    route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox";
+    checksum: string;
+    relative_path: string;
+    page_id: string;
+    markdown: string;
+    projected_at: string;
+}, {
+    status: "candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated";
+    kind: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay";
+    soil_id: string;
+    route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox";
+    checksum: string;
+    relative_path: string;
+    page_id: string;
+    markdown: string;
+    projected_at: string;
+}>;
+export type SoilPage = z.infer<typeof SoilPageSchema>;
+export declare const SoilPageMemberSchema: z.ZodObject<{
+    page_id: z.ZodString;
+    record_id: z.ZodString;
+    ordinal: z.ZodNumber;
+    role: z.ZodEnum<["primary", "supporting", "summary", "evidence", "related"]>;
+    confidence: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    confidence: number | null;
+    role: "evidence" | "summary" | "primary" | "supporting" | "related";
+    record_id: string;
+    page_id: string;
+    ordinal: number;
+}, {
+    role: "evidence" | "summary" | "primary" | "supporting" | "related";
+    record_id: string;
+    page_id: string;
+    ordinal: number;
+    confidence?: number | null | undefined;
+}>;
+export type SoilPageMember = z.infer<typeof SoilPageMemberSchema>;
+export declare const SoilEmbeddingSchema: z.ZodObject<{
+    chunk_id: z.ZodString;
+    model: z.ZodString;
+    embedding_version: z.ZodNumber;
+    encoding: z.ZodDefault<z.ZodEnum<["json", "f32le"]>>;
+    embedding: z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>]>;
+    embedded_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    encoding: "json" | "f32le";
+    model: string;
+    embedding: number[] | Uint8Array<ArrayBuffer>;
+    chunk_id: string;
+    embedding_version: number;
+    embedded_at: string;
+}, {
+    model: string;
+    embedding: number[] | Uint8Array<ArrayBuffer>;
+    chunk_id: string;
+    embedding_version: number;
+    embedded_at: string;
+    encoding?: "json" | "f32le" | undefined;
+}>;
+export type SoilEmbedding = z.infer<typeof SoilEmbeddingSchema>;
+export declare const SoilEdgeSchema: z.ZodObject<{
+    src_record_id: z.ZodString;
+    edge_type: z.ZodEnum<["supports", "contradicts", "caused_by", "references", "derived_from", "related_to", "belongs_to"]>;
+    dst_record_id: z.ZodString;
+    confidence: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    confidence: number | null;
+    src_record_id: string;
+    edge_type: "supports" | "contradicts" | "references" | "caused_by" | "derived_from" | "related_to" | "belongs_to";
+    dst_record_id: string;
+}, {
+    src_record_id: string;
+    edge_type: "supports" | "contradicts" | "references" | "caused_by" | "derived_from" | "related_to" | "belongs_to";
+    dst_record_id: string;
+    confidence?: number | null | undefined;
+}>;
+export type SoilEdge = z.infer<typeof SoilEdgeSchema>;
+export declare const SoilTombstoneSchema: z.ZodObject<{
+    record_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    record_key: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    version: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    reason: z.ZodString;
+    deleted_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    version: number | null;
+    record_id: string | null;
+    record_key: string | null;
+    deleted_at: string;
+}, {
+    reason: string;
+    deleted_at: string;
+    version?: number | null | undefined;
+    record_id?: string | null | undefined;
+    record_key?: string | null | undefined;
+}>;
+export type SoilTombstone = z.infer<typeof SoilTombstoneSchema>;
+export declare const SoilPageFilterSchema: z.ZodObject<{
+    page_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    soil_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    routes: z.ZodOptional<z.ZodArray<z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox"]>, "many">>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox", "overlay", "note"]>, "many">>;
+    page_statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["draft", "candidate", "confirmed", "stale", "superseded", "rejected", "deprecated", "archived"]>, "many">>;
+    relative_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+    page_ids?: string[] | undefined;
+    soil_ids?: string[] | undefined;
+    kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+    page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+    relative_paths?: string[] | undefined;
+}, {
+    routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+    page_ids?: string[] | undefined;
+    soil_ids?: string[] | undefined;
+    kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+    page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+    relative_paths?: string[] | undefined;
+}>;
+export type SoilPageFilter = z.infer<typeof SoilPageFilterSchema>;
+export declare const SoilRecordFilterSchema: z.ZodObject<{
+    record_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    record_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    record_types: z.ZodOptional<z.ZodArray<z.ZodEnum<["fact", "workflow", "preference", "observation", "decision", "state", "identity", "artifact", "reflection"]>, "many">>;
+    statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["draft", "active", "candidate", "confirmed", "stale", "superseded", "expired", "rejected", "archived", "completed", "cancelled", "deleted", "unreachable", "replaced"]>, "many">>;
+    goal_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    task_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    source_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    source_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    active_only: z.ZodDefault<z.ZodBoolean>;
+    valid_at: z.ZodOptional<z.ZodString>;
+    updated_after: z.ZodOptional<z.ZodString>;
+    updated_before: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    active_only: boolean;
+    goal_ids?: string[] | undefined;
+    task_ids?: string[] | undefined;
+    record_ids?: string[] | undefined;
+    record_keys?: string[] | undefined;
+    record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+    statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+    source_types?: string[] | undefined;
+    source_ids?: string[] | undefined;
+    valid_at?: string | undefined;
+    updated_after?: string | undefined;
+    updated_before?: string | undefined;
+}, {
+    goal_ids?: string[] | undefined;
+    task_ids?: string[] | undefined;
+    record_ids?: string[] | undefined;
+    record_keys?: string[] | undefined;
+    record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+    statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+    source_types?: string[] | undefined;
+    source_ids?: string[] | undefined;
+    active_only?: boolean | undefined;
+    valid_at?: string | undefined;
+    updated_after?: string | undefined;
+    updated_before?: string | undefined;
+}>;
+export type SoilRecordFilter = z.infer<typeof SoilRecordFilterSchema>;
+export type SoilRecordFilterInput = z.input<typeof SoilRecordFilterSchema>;
+export declare const SoilSearchRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    query_embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    query_embedding_model: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    lexical_top_k: z.ZodDefault<z.ZodNumber>;
+    dense_top_k: z.ZodDefault<z.ZodNumber>;
+    rerank_top_k: z.ZodDefault<z.ZodNumber>;
+    dense_candidate_record_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    direct_lookup: z.ZodDefault<z.ZodBoolean>;
+    record_filter: z.ZodDefault<z.ZodObject<{
+        record_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        record_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        record_types: z.ZodOptional<z.ZodArray<z.ZodEnum<["fact", "workflow", "preference", "observation", "decision", "state", "identity", "artifact", "reflection"]>, "many">>;
+        statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["draft", "active", "candidate", "confirmed", "stale", "superseded", "expired", "rejected", "archived", "completed", "cancelled", "deleted", "unreachable", "replaced"]>, "many">>;
+        goal_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        task_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        source_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        source_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        active_only: z.ZodDefault<z.ZodBoolean>;
+        valid_at: z.ZodOptional<z.ZodString>;
+        updated_after: z.ZodOptional<z.ZodString>;
+        updated_before: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        active_only: boolean;
+        goal_ids?: string[] | undefined;
+        task_ids?: string[] | undefined;
+        record_ids?: string[] | undefined;
+        record_keys?: string[] | undefined;
+        record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+        statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+        source_types?: string[] | undefined;
+        source_ids?: string[] | undefined;
+        valid_at?: string | undefined;
+        updated_after?: string | undefined;
+        updated_before?: string | undefined;
+    }, {
+        goal_ids?: string[] | undefined;
+        task_ids?: string[] | undefined;
+        record_ids?: string[] | undefined;
+        record_keys?: string[] | undefined;
+        record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+        statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+        source_types?: string[] | undefined;
+        source_ids?: string[] | undefined;
+        active_only?: boolean | undefined;
+        valid_at?: string | undefined;
+        updated_after?: string | undefined;
+        updated_before?: string | undefined;
+    }>>;
+    page_filter: z.ZodDefault<z.ZodObject<{
+        page_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        soil_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        routes: z.ZodOptional<z.ZodArray<z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox"]>, "many">>;
+        kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox", "overlay", "note"]>, "many">>;
+        page_statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["draft", "candidate", "confirmed", "stale", "superseded", "rejected", "deprecated", "archived"]>, "many">>;
+        relative_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+        page_ids?: string[] | undefined;
+        soil_ids?: string[] | undefined;
+        kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+        page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+        relative_paths?: string[] | undefined;
+    }, {
+        routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+        page_ids?: string[] | undefined;
+        soil_ids?: string[] | undefined;
+        kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+        page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+        relative_paths?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+    lexical_top_k: number;
+    dense_top_k: number;
+    rerank_top_k: number;
+    direct_lookup: boolean;
+    record_filter: {
+        active_only: boolean;
+        goal_ids?: string[] | undefined;
+        task_ids?: string[] | undefined;
+        record_ids?: string[] | undefined;
+        record_keys?: string[] | undefined;
+        record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+        statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+        source_types?: string[] | undefined;
+        source_ids?: string[] | undefined;
+        valid_at?: string | undefined;
+        updated_after?: string | undefined;
+        updated_before?: string | undefined;
+    };
+    page_filter: {
+        routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+        page_ids?: string[] | undefined;
+        soil_ids?: string[] | undefined;
+        kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+        page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+        relative_paths?: string[] | undefined;
+    };
+    query_embedding?: number[] | undefined;
+    query_embedding_model?: string | undefined;
+    dense_candidate_record_ids?: string[] | undefined;
+}, {
+    query: string;
+    limit?: number | undefined;
+    query_embedding?: number[] | undefined;
+    query_embedding_model?: string | undefined;
+    lexical_top_k?: number | undefined;
+    dense_top_k?: number | undefined;
+    rerank_top_k?: number | undefined;
+    dense_candidate_record_ids?: string[] | undefined;
+    direct_lookup?: boolean | undefined;
+    record_filter?: {
+        goal_ids?: string[] | undefined;
+        task_ids?: string[] | undefined;
+        record_ids?: string[] | undefined;
+        record_keys?: string[] | undefined;
+        record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+        statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+        source_types?: string[] | undefined;
+        source_ids?: string[] | undefined;
+        active_only?: boolean | undefined;
+        valid_at?: string | undefined;
+        updated_after?: string | undefined;
+        updated_before?: string | undefined;
+    } | undefined;
+    page_filter?: {
+        routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+        page_ids?: string[] | undefined;
+        soil_ids?: string[] | undefined;
+        kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+        page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+        relative_paths?: string[] | undefined;
+    } | undefined;
+}>;
+export type SoilSearchRequest = z.infer<typeof SoilSearchRequestSchema>;
+export type SoilSearchRequestInput = z.input<typeof SoilSearchRequestSchema>;
+export declare const SoilCandidateSchema: z.ZodObject<{
+    chunk_id: z.ZodString;
+    record_id: z.ZodString;
+    soil_id: z.ZodString;
+    lane: z.ZodEnum<["direct", "lexical", "dense", "hybrid", "recency", "rerank"]>;
+    rank: z.ZodNumber;
+    score: z.ZodNumber;
+    snippet: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    page_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    metadata_json: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    score: number;
+    soil_id: string;
+    chunk_id: string;
+    record_id: string;
+    metadata_json: Record<string, unknown>;
+    page_id: string | null;
+    lane: "hybrid" | "direct" | "lexical" | "dense" | "recency" | "rerank";
+    rank: number;
+    snippet: string | null;
+}, {
+    score: number;
+    soil_id: string;
+    chunk_id: string;
+    record_id: string;
+    lane: "hybrid" | "direct" | "lexical" | "dense" | "recency" | "rerank";
+    rank: number;
+    metadata_json?: Record<string, unknown> | undefined;
+    page_id?: string | null | undefined;
+    snippet?: string | null | undefined;
+}>;
+export type SoilCandidate = z.infer<typeof SoilCandidateSchema>;
+export declare const SoilSearchResultSchema: z.ZodObject<{
+    request: z.ZodObject<{
+        query: z.ZodString;
+        query_embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        query_embedding_model: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        lexical_top_k: z.ZodDefault<z.ZodNumber>;
+        dense_top_k: z.ZodDefault<z.ZodNumber>;
+        rerank_top_k: z.ZodDefault<z.ZodNumber>;
+        dense_candidate_record_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        direct_lookup: z.ZodDefault<z.ZodBoolean>;
+        record_filter: z.ZodDefault<z.ZodObject<{
+            record_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            record_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            record_types: z.ZodOptional<z.ZodArray<z.ZodEnum<["fact", "workflow", "preference", "observation", "decision", "state", "identity", "artifact", "reflection"]>, "many">>;
+            statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["draft", "active", "candidate", "confirmed", "stale", "superseded", "expired", "rejected", "archived", "completed", "cancelled", "deleted", "unreachable", "replaced"]>, "many">>;
+            goal_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            task_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            source_types: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            source_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            active_only: z.ZodDefault<z.ZodBoolean>;
+            valid_at: z.ZodOptional<z.ZodString>;
+            updated_after: z.ZodOptional<z.ZodString>;
+            updated_before: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            active_only: boolean;
+            goal_ids?: string[] | undefined;
+            task_ids?: string[] | undefined;
+            record_ids?: string[] | undefined;
+            record_keys?: string[] | undefined;
+            record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+            statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+            source_types?: string[] | undefined;
+            source_ids?: string[] | undefined;
+            valid_at?: string | undefined;
+            updated_after?: string | undefined;
+            updated_before?: string | undefined;
+        }, {
+            goal_ids?: string[] | undefined;
+            task_ids?: string[] | undefined;
+            record_ids?: string[] | undefined;
+            record_keys?: string[] | undefined;
+            record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+            statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+            source_types?: string[] | undefined;
+            source_ids?: string[] | undefined;
+            active_only?: boolean | undefined;
+            valid_at?: string | undefined;
+            updated_after?: string | undefined;
+            updated_before?: string | undefined;
+        }>>;
+        page_filter: z.ZodDefault<z.ZodObject<{
+            page_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            soil_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            routes: z.ZodOptional<z.ZodArray<z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox"]>, "many">>;
+            kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox", "overlay", "note"]>, "many">>;
+            page_statuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["draft", "candidate", "confirmed", "stale", "superseded", "rejected", "deprecated", "archived"]>, "many">>;
+            relative_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+            page_ids?: string[] | undefined;
+            soil_ids?: string[] | undefined;
+            kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+            page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+            relative_paths?: string[] | undefined;
+        }, {
+            routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+            page_ids?: string[] | undefined;
+            soil_ids?: string[] | undefined;
+            kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+            page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+            relative_paths?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        limit: number;
+        lexical_top_k: number;
+        dense_top_k: number;
+        rerank_top_k: number;
+        direct_lookup: boolean;
+        record_filter: {
+            active_only: boolean;
+            goal_ids?: string[] | undefined;
+            task_ids?: string[] | undefined;
+            record_ids?: string[] | undefined;
+            record_keys?: string[] | undefined;
+            record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+            statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+            source_types?: string[] | undefined;
+            source_ids?: string[] | undefined;
+            valid_at?: string | undefined;
+            updated_after?: string | undefined;
+            updated_before?: string | undefined;
+        };
+        page_filter: {
+            routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+            page_ids?: string[] | undefined;
+            soil_ids?: string[] | undefined;
+            kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+            page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+            relative_paths?: string[] | undefined;
+        };
+        query_embedding?: number[] | undefined;
+        query_embedding_model?: string | undefined;
+        dense_candidate_record_ids?: string[] | undefined;
+    }, {
+        query: string;
+        limit?: number | undefined;
+        query_embedding?: number[] | undefined;
+        query_embedding_model?: string | undefined;
+        lexical_top_k?: number | undefined;
+        dense_top_k?: number | undefined;
+        rerank_top_k?: number | undefined;
+        dense_candidate_record_ids?: string[] | undefined;
+        direct_lookup?: boolean | undefined;
+        record_filter?: {
+            goal_ids?: string[] | undefined;
+            task_ids?: string[] | undefined;
+            record_ids?: string[] | undefined;
+            record_keys?: string[] | undefined;
+            record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+            statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+            source_types?: string[] | undefined;
+            source_ids?: string[] | undefined;
+            active_only?: boolean | undefined;
+            valid_at?: string | undefined;
+            updated_after?: string | undefined;
+            updated_before?: string | undefined;
+        } | undefined;
+        page_filter?: {
+            routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+            page_ids?: string[] | undefined;
+            soil_ids?: string[] | undefined;
+            kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+            page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+            relative_paths?: string[] | undefined;
+        } | undefined;
+    }>;
+    candidates: z.ZodArray<z.ZodObject<{
+        chunk_id: z.ZodString;
+        record_id: z.ZodString;
+        soil_id: z.ZodString;
+        lane: z.ZodEnum<["direct", "lexical", "dense", "hybrid", "recency", "rerank"]>;
+        rank: z.ZodNumber;
+        score: z.ZodNumber;
+        snippet: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        page_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        metadata_json: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        score: number;
+        soil_id: string;
+        chunk_id: string;
+        record_id: string;
+        metadata_json: Record<string, unknown>;
+        page_id: string | null;
+        lane: "hybrid" | "direct" | "lexical" | "dense" | "recency" | "rerank";
+        rank: number;
+        snippet: string | null;
+    }, {
+        score: number;
+        soil_id: string;
+        chunk_id: string;
+        record_id: string;
+        lane: "hybrid" | "direct" | "lexical" | "dense" | "recency" | "rerank";
+        rank: number;
+        metadata_json?: Record<string, unknown> | undefined;
+        page_id?: string | null | undefined;
+        snippet?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    candidates: {
+        score: number;
+        soil_id: string;
+        chunk_id: string;
+        record_id: string;
+        metadata_json: Record<string, unknown>;
+        page_id: string | null;
+        lane: "hybrid" | "direct" | "lexical" | "dense" | "recency" | "rerank";
+        rank: number;
+        snippet: string | null;
+    }[];
+    request: {
+        query: string;
+        limit: number;
+        lexical_top_k: number;
+        dense_top_k: number;
+        rerank_top_k: number;
+        direct_lookup: boolean;
+        record_filter: {
+            active_only: boolean;
+            goal_ids?: string[] | undefined;
+            task_ids?: string[] | undefined;
+            record_ids?: string[] | undefined;
+            record_keys?: string[] | undefined;
+            record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+            statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+            source_types?: string[] | undefined;
+            source_ids?: string[] | undefined;
+            valid_at?: string | undefined;
+            updated_after?: string | undefined;
+            updated_before?: string | undefined;
+        };
+        page_filter: {
+            routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+            page_ids?: string[] | undefined;
+            soil_ids?: string[] | undefined;
+            kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+            page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+            relative_paths?: string[] | undefined;
+        };
+        query_embedding?: number[] | undefined;
+        query_embedding_model?: string | undefined;
+        dense_candidate_record_ids?: string[] | undefined;
+    };
+}, {
+    candidates: {
+        score: number;
+        soil_id: string;
+        chunk_id: string;
+        record_id: string;
+        lane: "hybrid" | "direct" | "lexical" | "dense" | "recency" | "rerank";
+        rank: number;
+        metadata_json?: Record<string, unknown> | undefined;
+        page_id?: string | null | undefined;
+        snippet?: string | null | undefined;
+    }[];
+    request: {
+        query: string;
+        limit?: number | undefined;
+        query_embedding?: number[] | undefined;
+        query_embedding_model?: string | undefined;
+        lexical_top_k?: number | undefined;
+        dense_top_k?: number | undefined;
+        rerank_top_k?: number | undefined;
+        dense_candidate_record_ids?: string[] | undefined;
+        direct_lookup?: boolean | undefined;
+        record_filter?: {
+            goal_ids?: string[] | undefined;
+            task_ids?: string[] | undefined;
+            record_ids?: string[] | undefined;
+            record_keys?: string[] | undefined;
+            record_types?: ("observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact")[] | undefined;
+            statuses?: ("completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced")[] | undefined;
+            source_types?: string[] | undefined;
+            source_ids?: string[] | undefined;
+            active_only?: boolean | undefined;
+            valid_at?: string | undefined;
+            updated_after?: string | undefined;
+            updated_before?: string | undefined;
+        } | undefined;
+        page_filter?: {
+            routes?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox")[] | undefined;
+            page_ids?: string[] | undefined;
+            soil_ids?: string[] | undefined;
+            kinds?: ("status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay")[] | undefined;
+            page_statuses?: ("candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated")[] | undefined;
+            relative_paths?: string[] | undefined;
+        } | undefined;
+    };
+}>;
+export type SoilSearchResult = z.infer<typeof SoilSearchResultSchema>;
+export declare const SoilContextRouteSchemaVersion: "soil-context-route-v1";
+export declare const SoilRetrievalTraceSchemaVersion: "soil-retrieval-trace-v1";
+export declare const SoilCompileMissObservationSchemaVersion: "soil-compile-miss-v1";
+export declare const SoilMemoryLintFindingSchemaVersion: "soil-memory-lint-finding-v1";
+export declare const SoilContextRouteSchema: z.ZodObject<{
+    schema_version: z.ZodDefault<z.ZodLiteral<"soil-context-route-v1">>;
+    route_id: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<["active", "deprecated", "superseded", "archived", "tombstoned"]>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    path_globs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    goal_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    task_categories: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    phases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    soil_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    record_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    reason: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    source_observation_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    last_evaluated_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    last_evaluation_result: z.ZodDefault<z.ZodEnum<["passed", "failed", "unknown"]>>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "archived" | "superseded" | "deprecated" | "tombstoned";
+    created_at: string;
+    updated_at: string;
+    priority: number;
+    reason: string;
+    phases: string[];
+    goal_ids: string[];
+    soil_ids: string[];
+    record_ids: string[];
+    schema_version: "soil-context-route-v1";
+    route_id: string;
+    path_globs: string[];
+    task_categories: string[];
+    source_observation_ids: string[];
+    last_evaluated_at: string | null;
+    last_evaluation_result: "unknown" | "passed" | "failed";
+}, {
+    created_at: string;
+    updated_at: string;
+    reason: string;
+    route_id: string;
+    status?: "active" | "archived" | "superseded" | "deprecated" | "tombstoned" | undefined;
+    priority?: number | undefined;
+    phases?: string[] | undefined;
+    goal_ids?: string[] | undefined;
+    soil_ids?: string[] | undefined;
+    record_ids?: string[] | undefined;
+    schema_version?: "soil-context-route-v1" | undefined;
+    path_globs?: string[] | undefined;
+    task_categories?: string[] | undefined;
+    source_observation_ids?: string[] | undefined;
+    last_evaluated_at?: string | null | undefined;
+    last_evaluation_result?: "unknown" | "passed" | "failed" | undefined;
+}>;
+export type SoilContextRoute = z.infer<typeof SoilContextRouteSchema>;
+export type SoilContextRouteInput = z.input<typeof SoilContextRouteSchema>;
+export declare const SoilRetrievalDecisionSchema: z.ZodObject<{
+    candidate_id: z.ZodString;
+    decision: z.ZodEnum<["admitted", "rejected", "routed"]>;
+    reason: z.ZodString;
+    score: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    soil_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    record_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    route_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    score: number | null;
+    reason: string;
+    decision: "rejected" | "admitted" | "routed";
+    candidate_id: string;
+    soil_id: string | null;
+    record_id: string | null;
+    route_id: string | null;
+}, {
+    reason: string;
+    decision: "rejected" | "admitted" | "routed";
+    candidate_id: string;
+    score?: number | null | undefined;
+    soil_id?: string | null | undefined;
+    record_id?: string | null | undefined;
+    route_id?: string | null | undefined;
+}>;
+export type SoilRetrievalDecision = z.infer<typeof SoilRetrievalDecisionSchema>;
+export declare const SoilRetrievalTraceSchema: z.ZodObject<{
+    schema_version: z.ZodDefault<z.ZodLiteral<"soil-retrieval-trace-v1">>;
+    retrieval_id: z.ZodString;
+    timestamp: z.ZodString;
+    task_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    goal_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    phase: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    task_category: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    target_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    fallback_query: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    decisions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        candidate_id: z.ZodString;
+        decision: z.ZodEnum<["admitted", "rejected", "routed"]>;
+        reason: z.ZodString;
+        score: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        soil_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        record_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        route_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        score: number | null;
+        reason: string;
+        decision: "rejected" | "admitted" | "routed";
+        candidate_id: string;
+        soil_id: string | null;
+        record_id: string | null;
+        route_id: string | null;
+    }, {
+        reason: string;
+        decision: "rejected" | "admitted" | "routed";
+        candidate_id: string;
+        score?: number | null | undefined;
+        soil_id?: string | null | undefined;
+        record_id?: string | null | undefined;
+        route_id?: string | null | undefined;
+    }>, "many">>;
+    warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    goal_id: string | null;
+    task_category: string | null;
+    task_id: string | null;
+    phase: string | null;
+    warnings: string[];
+    schema_version: "soil-retrieval-trace-v1";
+    retrieval_id: string;
+    target_paths: string[];
+    fallback_query: string | null;
+    decisions: {
+        score: number | null;
+        reason: string;
+        decision: "rejected" | "admitted" | "routed";
+        candidate_id: string;
+        soil_id: string | null;
+        record_id: string | null;
+        route_id: string | null;
+    }[];
+}, {
+    timestamp: string;
+    retrieval_id: string;
+    goal_id?: string | null | undefined;
+    task_category?: string | null | undefined;
+    task_id?: string | null | undefined;
+    phase?: string | null | undefined;
+    warnings?: string[] | undefined;
+    schema_version?: "soil-retrieval-trace-v1" | undefined;
+    target_paths?: string[] | undefined;
+    fallback_query?: string | null | undefined;
+    decisions?: {
+        reason: string;
+        decision: "rejected" | "admitted" | "routed";
+        candidate_id: string;
+        score?: number | null | undefined;
+        soil_id?: string | null | undefined;
+        record_id?: string | null | undefined;
+        route_id?: string | null | undefined;
+    }[] | undefined;
+}>;
+export type SoilRetrievalTrace = z.infer<typeof SoilRetrievalTraceSchema>;
+export declare const SoilCompileMissObservationSchema: z.ZodObject<{
+    schema_version: z.ZodDefault<z.ZodLiteral<"soil-compile-miss-v1">>;
+    observation_id: z.ZodString;
+    retrieval_id: z.ZodString;
+    reason: z.ZodEnum<["no_route", "bad_route", "stale_route", "low_confidence_search", "irrelevant_context"]>;
+    target_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    route_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    rejected_candidate_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    created_at: z.ZodString;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    observation_id: string;
+    reason: "no_route" | "bad_route" | "stale_route" | "low_confidence_search" | "irrelevant_context";
+    schema_version: "soil-compile-miss-v1";
+    retrieval_id: string;
+    target_paths: string[];
+    route_ids: string[];
+    rejected_candidate_ids: string[];
+    notes?: string | undefined;
+}, {
+    created_at: string;
+    observation_id: string;
+    reason: "no_route" | "bad_route" | "stale_route" | "low_confidence_search" | "irrelevant_context";
+    retrieval_id: string;
+    notes?: string | undefined;
+    schema_version?: "soil-compile-miss-v1" | undefined;
+    target_paths?: string[] | undefined;
+    route_ids?: string[] | undefined;
+    rejected_candidate_ids?: string[] | undefined;
+}>;
+export type SoilCompileMissObservation = z.infer<typeof SoilCompileMissObservationSchema>;
+export declare const SoilMemoryLintFindingCodeSchema: z.ZodEnum<["stale_page", "orphan_page", "broken_source_ref", "conflicting_active_record", "overgrown_page", "stale_route", "missing_route", "broken_route_target", "schema_incompatible"]>;
+export type SoilMemoryLintFindingCode = z.infer<typeof SoilMemoryLintFindingCodeSchema>;
+export declare const SoilMemoryLintFindingSchema: z.ZodObject<{
+    schema_version: z.ZodDefault<z.ZodLiteral<"soil-memory-lint-finding-v1">>;
+    finding_id: z.ZodString;
+    code: z.ZodEnum<["stale_page", "orphan_page", "broken_source_ref", "conflicting_active_record", "overgrown_page", "stale_route", "missing_route", "broken_route_target", "schema_incompatible"]>;
+    severity: z.ZodEnum<["info", "warning", "error"]>;
+    status: z.ZodDefault<z.ZodEnum<["open", "resolved", "ignored"]>>;
+    message: z.ZodString;
+    soil_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    record_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    route_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    source_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+    resolved_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    code: "stale_route" | "stale_page" | "orphan_page" | "broken_source_ref" | "conflicting_active_record" | "overgrown_page" | "missing_route" | "broken_route_target" | "schema_incompatible";
+    message: string;
+    status: "open" | "resolved" | "ignored";
+    created_at: string;
+    severity: "error" | "info" | "warning";
+    source_path: string | null;
+    soil_id: string | null;
+    record_id: string | null;
+    schema_version: "soil-memory-lint-finding-v1";
+    route_id: string | null;
+    finding_id: string;
+    resolved_at: string | null;
+}, {
+    code: "stale_route" | "stale_page" | "orphan_page" | "broken_source_ref" | "conflicting_active_record" | "overgrown_page" | "missing_route" | "broken_route_target" | "schema_incompatible";
+    message: string;
+    created_at: string;
+    severity: "error" | "info" | "warning";
+    finding_id: string;
+    status?: "open" | "resolved" | "ignored" | undefined;
+    source_path?: string | null | undefined;
+    soil_id?: string | null | undefined;
+    record_id?: string | null | undefined;
+    schema_version?: "soil-memory-lint-finding-v1" | undefined;
+    route_id?: string | null | undefined;
+    resolved_at?: string | null | undefined;
+}>;
+export type SoilMemoryLintFinding = z.infer<typeof SoilMemoryLintFindingSchema>;
+export declare const SoilMutationSchema: z.ZodObject<{
+    records: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        record_id: z.ZodString;
+        record_key: z.ZodString;
+        version: z.ZodNumber;
+        record_type: z.ZodEnum<["fact", "workflow", "preference", "observation", "decision", "state", "identity", "artifact", "reflection"]>;
+        soil_id: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        canonical_text: z.ZodString;
+        goal_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        task_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        status: z.ZodEnum<["draft", "active", "candidate", "confirmed", "stale", "superseded", "expired", "rejected", "archived", "completed", "cancelled", "deleted", "unreachable", "replaced"]>;
+        confidence: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        importance: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        source_reliability: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        valid_from: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        valid_to: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        supersedes_record_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        is_active: z.ZodDefault<z.ZodBoolean>;
+        source_type: z.ZodString;
+        source_id: z.ZodString;
+        metadata_json: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced";
+        confidence: number | null;
+        title: string;
+        created_at: string;
+        updated_at: string;
+        goal_id: string | null;
+        task_id: string | null;
+        summary: string | null;
+        version: number;
+        source_id: string;
+        importance: number | null;
+        valid_from: string | null;
+        valid_to: string | null;
+        source_type: string;
+        soil_id: string;
+        record_id: string;
+        record_key: string;
+        record_type: "observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact";
+        canonical_text: string;
+        source_reliability: number | null;
+        supersedes_record_id: string | null;
+        is_active: boolean;
+        metadata_json: Record<string, unknown>;
+    }, {
+        status: "completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced";
+        title: string;
+        created_at: string;
+        updated_at: string;
+        version: number;
+        source_id: string;
+        source_type: string;
+        soil_id: string;
+        record_id: string;
+        record_key: string;
+        record_type: "observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact";
+        canonical_text: string;
+        confidence?: number | null | undefined;
+        goal_id?: string | null | undefined;
+        task_id?: string | null | undefined;
+        summary?: string | null | undefined;
+        importance?: number | null | undefined;
+        valid_from?: string | null | undefined;
+        valid_to?: string | null | undefined;
+        source_reliability?: number | null | undefined;
+        supersedes_record_id?: string | null | undefined;
+        is_active?: boolean | undefined;
+        metadata_json?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    chunks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        chunk_id: z.ZodString;
+        record_id: z.ZodString;
+        soil_id: z.ZodString;
+        chunk_index: z.ZodNumber;
+        chunk_kind: z.ZodEnum<["title", "summary", "heading", "paragraph", "list", "table", "quote", "code"]>;
+        heading_path_json: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        chunk_text: z.ZodString;
+        token_count: z.ZodNumber;
+        checksum: z.ZodString;
+        created_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        created_at: string;
+        soil_id: string;
+        checksum: string;
+        chunk_id: string;
+        token_count: number;
+        record_id: string;
+        chunk_index: number;
+        chunk_kind: "code" | "title" | "summary" | "list" | "heading" | "paragraph" | "table" | "quote";
+        heading_path_json: string[];
+        chunk_text: string;
+    }, {
+        created_at: string;
+        soil_id: string;
+        checksum: string;
+        chunk_id: string;
+        token_count: number;
+        record_id: string;
+        chunk_index: number;
+        chunk_kind: "code" | "title" | "summary" | "list" | "heading" | "paragraph" | "table" | "quote";
+        chunk_text: string;
+        heading_path_json?: string[] | undefined;
+    }>, "many">>;
+    pages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        page_id: z.ZodString;
+        soil_id: z.ZodString;
+        relative_path: z.ZodString;
+        route: z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox"]>;
+        kind: z.ZodEnum<["index", "status", "health", "report", "schedule", "memory", "knowledge", "decision", "identity", "goal", "task", "timeline", "operations", "inbox", "overlay", "note"]>;
+        status: z.ZodEnum<["draft", "candidate", "confirmed", "stale", "superseded", "rejected", "deprecated", "archived"]>;
+        markdown: z.ZodString;
+        checksum: z.ZodString;
+        projected_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated";
+        kind: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay";
+        soil_id: string;
+        route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox";
+        checksum: string;
+        relative_path: string;
+        page_id: string;
+        markdown: string;
+        projected_at: string;
+    }, {
+        status: "candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated";
+        kind: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay";
+        soil_id: string;
+        route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox";
+        checksum: string;
+        relative_path: string;
+        page_id: string;
+        markdown: string;
+        projected_at: string;
+    }>, "many">>;
+    page_members: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        page_id: z.ZodString;
+        record_id: z.ZodString;
+        ordinal: z.ZodNumber;
+        role: z.ZodEnum<["primary", "supporting", "summary", "evidence", "related"]>;
+        confidence: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number | null;
+        role: "evidence" | "summary" | "primary" | "supporting" | "related";
+        record_id: string;
+        page_id: string;
+        ordinal: number;
+    }, {
+        role: "evidence" | "summary" | "primary" | "supporting" | "related";
+        record_id: string;
+        page_id: string;
+        ordinal: number;
+        confidence?: number | null | undefined;
+    }>, "many">>;
+    embeddings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        chunk_id: z.ZodString;
+        model: z.ZodString;
+        embedding_version: z.ZodNumber;
+        encoding: z.ZodDefault<z.ZodEnum<["json", "f32le"]>>;
+        embedding: z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>]>;
+        embedded_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        encoding: "json" | "f32le";
+        model: string;
+        embedding: number[] | Uint8Array<ArrayBuffer>;
+        chunk_id: string;
+        embedding_version: number;
+        embedded_at: string;
+    }, {
+        model: string;
+        embedding: number[] | Uint8Array<ArrayBuffer>;
+        chunk_id: string;
+        embedding_version: number;
+        embedded_at: string;
+        encoding?: "json" | "f32le" | undefined;
+    }>, "many">>;
+    edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        src_record_id: z.ZodString;
+        edge_type: z.ZodEnum<["supports", "contradicts", "caused_by", "references", "derived_from", "related_to", "belongs_to"]>;
+        dst_record_id: z.ZodString;
+        confidence: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number | null;
+        src_record_id: string;
+        edge_type: "supports" | "contradicts" | "references" | "caused_by" | "derived_from" | "related_to" | "belongs_to";
+        dst_record_id: string;
+    }, {
+        src_record_id: string;
+        edge_type: "supports" | "contradicts" | "references" | "caused_by" | "derived_from" | "related_to" | "belongs_to";
+        dst_record_id: string;
+        confidence?: number | null | undefined;
+    }>, "many">>;
+    tombstones: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        record_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        record_key: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        version: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        reason: z.ZodString;
+        deleted_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        reason: string;
+        version: number | null;
+        record_id: string | null;
+        record_key: string | null;
+        deleted_at: string;
+    }, {
+        reason: string;
+        deleted_at: string;
+        version?: number | null | undefined;
+        record_id?: string | null | undefined;
+        record_key?: string | null | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    edges: {
+        confidence: number | null;
+        src_record_id: string;
+        edge_type: "supports" | "contradicts" | "references" | "caused_by" | "derived_from" | "related_to" | "belongs_to";
+        dst_record_id: string;
+    }[];
+    records: {
+        status: "completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced";
+        confidence: number | null;
+        title: string;
+        created_at: string;
+        updated_at: string;
+        goal_id: string | null;
+        task_id: string | null;
+        summary: string | null;
+        version: number;
+        source_id: string;
+        importance: number | null;
+        valid_from: string | null;
+        valid_to: string | null;
+        source_type: string;
+        soil_id: string;
+        record_id: string;
+        record_key: string;
+        record_type: "observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact";
+        canonical_text: string;
+        source_reliability: number | null;
+        supersedes_record_id: string | null;
+        is_active: boolean;
+        metadata_json: Record<string, unknown>;
+    }[];
+    pages: {
+        status: "candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated";
+        kind: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay";
+        soil_id: string;
+        route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox";
+        checksum: string;
+        relative_path: string;
+        page_id: string;
+        markdown: string;
+        projected_at: string;
+    }[];
+    chunks: {
+        created_at: string;
+        soil_id: string;
+        checksum: string;
+        chunk_id: string;
+        token_count: number;
+        record_id: string;
+        chunk_index: number;
+        chunk_kind: "code" | "title" | "summary" | "list" | "heading" | "paragraph" | "table" | "quote";
+        heading_path_json: string[];
+        chunk_text: string;
+    }[];
+    page_members: {
+        confidence: number | null;
+        role: "evidence" | "summary" | "primary" | "supporting" | "related";
+        record_id: string;
+        page_id: string;
+        ordinal: number;
+    }[];
+    embeddings: {
+        encoding: "json" | "f32le";
+        model: string;
+        embedding: number[] | Uint8Array<ArrayBuffer>;
+        chunk_id: string;
+        embedding_version: number;
+        embedded_at: string;
+    }[];
+    tombstones: {
+        reason: string;
+        version: number | null;
+        record_id: string | null;
+        record_key: string | null;
+        deleted_at: string;
+    }[];
+}, {
+    edges?: {
+        src_record_id: string;
+        edge_type: "supports" | "contradicts" | "references" | "caused_by" | "derived_from" | "related_to" | "belongs_to";
+        dst_record_id: string;
+        confidence?: number | null | undefined;
+    }[] | undefined;
+    records?: {
+        status: "completed" | "candidate" | "active" | "cancelled" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "expired" | "deleted" | "unreachable" | "replaced";
+        title: string;
+        created_at: string;
+        updated_at: string;
+        version: number;
+        source_id: string;
+        source_type: string;
+        soil_id: string;
+        record_id: string;
+        record_key: string;
+        record_type: "observation" | "state" | "decision" | "identity" | "reflection" | "fact" | "preference" | "workflow" | "artifact";
+        canonical_text: string;
+        confidence?: number | null | undefined;
+        goal_id?: string | null | undefined;
+        task_id?: string | null | undefined;
+        summary?: string | null | undefined;
+        importance?: number | null | undefined;
+        valid_from?: string | null | undefined;
+        valid_to?: string | null | undefined;
+        source_reliability?: number | null | undefined;
+        supersedes_record_id?: string | null | undefined;
+        is_active?: boolean | undefined;
+        metadata_json?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    pages?: {
+        status: "candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated";
+        kind: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "note" | "health" | "timeline" | "operations" | "inbox" | "overlay";
+        soil_id: string;
+        route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "memory" | "identity" | "index" | "report" | "health" | "timeline" | "operations" | "inbox";
+        checksum: string;
+        relative_path: string;
+        page_id: string;
+        markdown: string;
+        projected_at: string;
+    }[] | undefined;
+    chunks?: {
+        created_at: string;
+        soil_id: string;
+        checksum: string;
+        chunk_id: string;
+        token_count: number;
+        record_id: string;
+        chunk_index: number;
+        chunk_kind: "code" | "title" | "summary" | "list" | "heading" | "paragraph" | "table" | "quote";
+        chunk_text: string;
+        heading_path_json?: string[] | undefined;
+    }[] | undefined;
+    page_members?: {
+        role: "evidence" | "summary" | "primary" | "supporting" | "related";
+        record_id: string;
+        page_id: string;
+        ordinal: number;
+        confidence?: number | null | undefined;
+    }[] | undefined;
+    embeddings?: {
+        model: string;
+        embedding: number[] | Uint8Array<ArrayBuffer>;
+        chunk_id: string;
+        embedding_version: number;
+        embedded_at: string;
+        encoding?: "json" | "f32le" | undefined;
+    }[] | undefined;
+    tombstones?: {
+        reason: string;
+        deleted_at: string;
+        version?: number | null | undefined;
+        record_id?: string | null | undefined;
+        record_key?: string | null | undefined;
+    }[] | undefined;
+}>;
+export type SoilMutation = z.infer<typeof SoilMutationSchema>;
+export type SoilMutationInput = z.input<typeof SoilMutationSchema>;
+export interface SoilWriteRepository {
+    applyMutation(mutation: SoilMutationInput): Promise<void>;
+    queueReindex(recordIds: string[], reason: string): Promise<void>;
+}
+export interface SoilSearchRepository {
+    loadRecords(filter?: SoilRecordFilterInput): Promise<SoilRecord[]>;
+    lookupDirect(request: SoilSearchRequestInput): Promise<SoilSearchResult>;
+    searchHybrid(request: SoilSearchRequestInput): Promise<SoilCandidate[]>;
+    searchLexical(request: SoilSearchRequestInput): Promise<SoilCandidate[]>;
+    searchDense(request: SoilSearchRequestInput): Promise<SoilCandidate[]>;
+    loadPagesForRecords(recordIds: string[]): Promise<Map<string, SoilPage[]>>;
+    loadPageMembers(pageIds: string[]): Promise<SoilPageMember[]>;
+}
+export interface SoilProjectionRepository {
+    upsertPages(pages: SoilPage[]): Promise<void>;
+    replacePageMembers(pageId: string, members: SoilPageMember[]): Promise<void>;
+}
+export interface SoilRepository extends SoilWriteRepository, SoilSearchRepository, SoilProjectionRepository {
+}
+//# sourceMappingURL=contracts.d.ts.map