pulseed 0.4.6 → 0.4.8

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

@@ -15,6 +15,8 @@ export declare const SoilLaneSchema: z.ZodEnum<["direct", "lexical", "dense", "h
 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;
@@ -141,8 +143,8 @@ export declare const SoilPageSchema: z.ZodObject<{
     route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "identity" | "index" | "report" | "memory" | "health" | "timeline" | "operations" | "inbox";
     checksum: string;
     relative_path: string;
-    markdown: string;
     page_id: string;
+    markdown: string;
     projected_at: string;
 }, {
     status: "candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated";
@@ -151,8 +153,8 @@ export declare const SoilPageSchema: z.ZodObject<{
     route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "identity" | "index" | "report" | "memory" | "health" | "timeline" | "operations" | "inbox";
     checksum: string;
     relative_path: string;
-    markdown: string;
     page_id: string;
+    markdown: string;
     projected_at: string;
 }>;
 export type SoilPage = z.infer<typeof SoilPageSchema>;
@@ -274,24 +276,24 @@ export declare const SoilRecordFilterSchema: z.ZodObject<{
     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;
-    goal_ids?: string[] | undefined;
-    task_ids?: string[] | 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;
-    goal_ids?: string[] | undefined;
-    task_ids?: string[] | undefined;
     source_types?: string[] | undefined;
     source_ids?: string[] | undefined;
     active_only?: boolean | undefined;
@@ -326,24 +328,24 @@ export declare const SoilSearchRequestSchema: z.ZodObject<{
         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;
-        goal_ids?: string[] | undefined;
-        task_ids?: string[] | 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;
-        goal_ids?: string[] | undefined;
-        task_ids?: string[] | undefined;
         source_types?: string[] | undefined;
         source_ids?: string[] | undefined;
         active_only?: boolean | undefined;
@@ -382,12 +384,12 @@ export declare const SoilSearchRequestSchema: z.ZodObject<{
     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;
-        goal_ids?: string[] | undefined;
-        task_ids?: string[] | undefined;
         source_types?: string[] | undefined;
         source_ids?: string[] | undefined;
         valid_at?: string | undefined;
@@ -416,12 +418,12 @@ export declare const SoilSearchRequestSchema: z.ZodObject<{
     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;
-        goal_ids?: string[] | undefined;
-        task_ids?: string[] | undefined;
         source_types?: string[] | undefined;
         source_ids?: string[] | undefined;
         active_only?: boolean | undefined;
@@ -498,24 +500,24 @@ export declare const SoilSearchResultSchema: z.ZodObject<{
             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;
-            goal_ids?: string[] | undefined;
-            task_ids?: string[] | 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;
-            goal_ids?: string[] | undefined;
-            task_ids?: string[] | undefined;
             source_types?: string[] | undefined;
             source_ids?: string[] | undefined;
             active_only?: boolean | undefined;
@@ -554,12 +556,12 @@ export declare const SoilSearchResultSchema: z.ZodObject<{
         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;
-            goal_ids?: string[] | undefined;
-            task_ids?: string[] | undefined;
             source_types?: string[] | undefined;
             source_ids?: string[] | undefined;
             valid_at?: string | undefined;
@@ -588,12 +590,12 @@ export declare const SoilSearchResultSchema: z.ZodObject<{
         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;
-            goal_ids?: string[] | undefined;
-            task_ids?: string[] | undefined;
             source_types?: string[] | undefined;
             source_ids?: string[] | undefined;
             active_only?: boolean | undefined;
@@ -662,12 +664,12 @@ export declare const SoilSearchResultSchema: z.ZodObject<{
         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;
-            goal_ids?: string[] | undefined;
-            task_ids?: string[] | undefined;
             source_types?: string[] | undefined;
             source_ids?: string[] | undefined;
             valid_at?: string | undefined;
@@ -709,12 +711,12 @@ export declare const SoilSearchResultSchema: z.ZodObject<{
         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;
-            goal_ids?: string[] | undefined;
-            task_ids?: string[] | undefined;
             source_types?: string[] | undefined;
             source_ids?: string[] | undefined;
             active_only?: boolean | undefined;
@@ -733,6 +735,243 @@ export declare const SoilSearchResultSchema: z.ZodObject<{
     };
 }>;
 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;
@@ -858,8 +1097,8 @@ export declare const SoilMutationSchema: z.ZodObject<{
         route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "identity" | "index" | "report" | "memory" | "health" | "timeline" | "operations" | "inbox";
         checksum: string;
         relative_path: string;
-        markdown: string;
         page_id: string;
+        markdown: string;
         projected_at: string;
     }, {
         status: "candidate" | "archived" | "superseded" | "rejected" | "confirmed" | "draft" | "stale" | "deprecated";
@@ -868,8 +1107,8 @@ export declare const SoilMutationSchema: z.ZodObject<{
         route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "identity" | "index" | "report" | "memory" | "health" | "timeline" | "operations" | "inbox";
         checksum: string;
         relative_path: string;
-        markdown: string;
         page_id: string;
+        markdown: string;
         projected_at: string;
     }>, "many">>;
     page_members: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -987,8 +1226,8 @@ export declare const SoilMutationSchema: z.ZodObject<{
         route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "identity" | "index" | "report" | "memory" | "health" | "timeline" | "operations" | "inbox";
         checksum: string;
         relative_path: string;
-        markdown: string;
         page_id: string;
+        markdown: string;
         projected_at: string;
     }[];
     chunks: {
@@ -1064,8 +1303,8 @@ export declare const SoilMutationSchema: z.ZodObject<{
         route: "status" | "schedule" | "goal" | "task" | "decision" | "knowledge" | "identity" | "index" | "report" | "memory" | "health" | "timeline" | "operations" | "inbox";
         checksum: string;
         relative_path: string;
-        markdown: string;
         page_id: string;
+        markdown: string;
         projected_at: string;
     }[] | undefined;
     chunks?: {

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

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

package/dist/platform/soil/contracts.js

@@ -56,6 +56,13 @@ export const SoilEdgeTypeSchema = z.enum([
 export const SoilEmbeddingEncodingSchema = z.enum(["json", "f32le"]);
 export const SoilLaneSchema = z.enum(["direct", "lexical", "dense", "hybrid", "recency", "rerank"]);
 export const SoilSortDirectionSchema = z.enum(["asc", "desc"]);
+export const SoilMemoryLifecycleStateSchema = z.enum([
+    "active",
+    "deprecated",
+    "superseded",
+    "archived",
+    "tombstoned",
+]);
 export const SoilRecordSchema = z.object({
     record_id: z.string().min(1),
     record_key: z.string().min(1),
@@ -182,6 +189,86 @@ export const SoilSearchResultSchema = z.object({
     request: SoilSearchRequestSchema,
     candidates: z.array(SoilCandidateSchema),
 });
+export const SoilContextRouteSchemaVersion = "soil-context-route-v1";
+export const SoilRetrievalTraceSchemaVersion = "soil-retrieval-trace-v1";
+export const SoilCompileMissObservationSchemaVersion = "soil-compile-miss-v1";
+export const SoilMemoryLintFindingSchemaVersion = "soil-memory-lint-finding-v1";
+export const SoilContextRouteSchema = z.object({
+    schema_version: z.literal(SoilContextRouteSchemaVersion).default(SoilContextRouteSchemaVersion),
+    route_id: z.string().min(1),
+    status: SoilMemoryLifecycleStateSchema.default("active"),
+    priority: z.number().int().default(0),
+    path_globs: z.array(z.string().min(1)).default([]),
+    goal_ids: z.array(z.string().min(1)).default([]),
+    task_categories: z.array(z.string().min(1)).default([]),
+    phases: z.array(z.string().min(1)).default([]),
+    soil_ids: z.array(z.string().min(1)).default([]),
+    record_ids: z.array(z.string().min(1)).default([]),
+    reason: z.string().min(1),
+    created_at: z.string().datetime(),
+    updated_at: z.string().datetime(),
+    source_observation_ids: z.array(z.string().min(1)).default([]),
+    last_evaluated_at: z.string().datetime().nullable().default(null),
+    last_evaluation_result: z.enum(["passed", "failed", "unknown"]).default("unknown"),
+});
+export const SoilRetrievalDecisionSchema = z.object({
+    candidate_id: z.string().min(1),
+    decision: z.enum(["admitted", "rejected", "routed"]),
+    reason: z.string().min(1),
+    score: z.number().nullable().default(null),
+    soil_id: z.string().min(1).nullable().default(null),
+    record_id: z.string().min(1).nullable().default(null),
+    route_id: z.string().min(1).nullable().default(null),
+});
+export const SoilRetrievalTraceSchema = z.object({
+    schema_version: z.literal(SoilRetrievalTraceSchemaVersion).default(SoilRetrievalTraceSchemaVersion),
+    retrieval_id: z.string().min(1),
+    timestamp: z.string().datetime(),
+    task_id: z.string().min(1).nullable().default(null),
+    goal_id: z.string().min(1).nullable().default(null),
+    phase: z.string().min(1).nullable().default(null),
+    task_category: z.string().min(1).nullable().default(null),
+    target_paths: z.array(z.string().min(1)).default([]),
+    fallback_query: z.string().min(1).nullable().default(null),
+    decisions: z.array(SoilRetrievalDecisionSchema).default([]),
+    warnings: z.array(z.string().min(1)).default([]),
+});
+export const SoilCompileMissObservationSchema = z.object({
+    schema_version: z.literal(SoilCompileMissObservationSchemaVersion).default(SoilCompileMissObservationSchemaVersion),
+    observation_id: z.string().min(1),
+    retrieval_id: z.string().min(1),
+    reason: z.enum(["no_route", "bad_route", "stale_route", "low_confidence_search", "irrelevant_context"]),
+    target_paths: z.array(z.string().min(1)).default([]),
+    route_ids: z.array(z.string().min(1)).default([]),
+    rejected_candidate_ids: z.array(z.string().min(1)).default([]),
+    created_at: z.string().datetime(),
+    notes: z.string().optional(),
+});
+export const SoilMemoryLintFindingCodeSchema = z.enum([
+    "stale_page",
+    "orphan_page",
+    "broken_source_ref",
+    "conflicting_active_record",
+    "overgrown_page",
+    "stale_route",
+    "missing_route",
+    "broken_route_target",
+    "schema_incompatible",
+]);
+export const SoilMemoryLintFindingSchema = z.object({
+    schema_version: z.literal(SoilMemoryLintFindingSchemaVersion).default(SoilMemoryLintFindingSchemaVersion),
+    finding_id: z.string().min(1),
+    code: SoilMemoryLintFindingCodeSchema,
+    severity: z.enum(["info", "warning", "error"]),
+    status: z.enum(["open", "resolved", "ignored"]).default("open"),
+    message: z.string().min(1),
+    soil_id: z.string().min(1).nullable().default(null),
+    record_id: z.string().min(1).nullable().default(null),
+    route_id: z.string().min(1).nullable().default(null),
+    source_path: z.string().min(1).nullable().default(null),
+    created_at: z.string().datetime(),
+    resolved_at: z.string().datetime().nullable().default(null),
+});
 export const SoilMutationSchema = z.object({
     records: z.array(SoilRecordSchema).default([]),
     chunks: z.array(SoilChunkSchema).default([]),