kibi-cli 0.16.1 → 0.18.1

package/dist/public/operations/specs/check.js

@@ -2,7 +2,7 @@ import { executeCheck } from "../check-executor.js";
 export const checkSpec = {
     name: "kb_check",
     cliName: "check",
-    description: "Run KB validation rules and return violations. Use before or after mutations, and after meaningful source edits with impact options to surface symbol granularity and semantic-review diagnostics. Do not use for point lookups. No write side effects. Prefer explicit rules for faster iteration; omit rules for final full validation plus full-KB qualityDiagnostics review.",
+    description: "Run KB validation rules and return violations. Use before or after mutations, and after meaningful source edits with impact options to surface symbol granularity and semantic-review diagnostics. Do not use for point lookups. No write side effects. Prefer explicit rules for faster iteration; omit rules for final full validation plus full-KB qualityDiagnostics review, including telemetry acceptance when .kb/usage.log exists.",
     businessInputSchema: {
         type: "object",
         properties: {
@@ -23,10 +23,13 @@ export const checkSpec = {
                         "strict-req-fact-pairing",
                         "predicate-verifiability",
                         "logic-coverage",
+                        "rule-safety",
+                        "rule-verifiability",
+                        "semantic-completeness",
                         "query-plan-safety",
                     ],
                 },
-                description: "Optional rule subset. Allowed: must-priority-coverage, symbol-coverage, symbol-traceability, no-dangling-refs, no-cycles, required-fields, deprecated-adr-no-successor, domain-contradictions, strict-fact-shape, strict-req-fact-pairing, predicate-verifiability, logic-coverage, query-plan-safety. If omitted, server runs all rules plus the full-KB qualityDiagnostics audit scan; if supplied, server preserves scoped validation and skips the full-KB advisory scan.",
+                description: "Optional rule subset. Allowed: must-priority-coverage, symbol-coverage, symbol-traceability, no-dangling-refs, no-cycles, required-fields, deprecated-adr-no-successor, domain-contradictions, strict-fact-shape, strict-req-fact-pairing, predicate-verifiability, logic-coverage, rule-safety, rule-verifiability, semantic-completeness, query-plan-safety. If omitted, server runs all rules plus the full-KB qualityDiagnostics audit scan, including usage telemetry acceptance when evidence exists; if supplied, server preserves scoped validation and skips the full-KB advisory scan.",
             },
             sourceFiles: {
                 type: "array",

package/dist/public/operations/specs/discovery.d.ts

@@ -82,7 +82,7 @@ export declare const searchSpec: {
 export declare const statusSpec: {
     readonly name: "kb_status";
     readonly cliName: "status";
-    readonly description: "Report current branch, snapshot, and freshness metadata for the attached KB. Read-only status inspection with no mutation side effects.";
+    readonly description: "Report current branch, KB snapshot and freshness metadata, plus the deterministic workspace snapshot used to validate execution receipts. Read-only status inspection with no mutation side effects.";
     readonly businessInputSchema: {
         readonly type: "object";
         readonly properties: {};

package/dist/public/operations/specs/discovery.js

@@ -90,7 +90,7 @@ export const searchSpec = {
 export const statusSpec = {
     name: "kb_status",
     cliName: "status",
-    description: "Report current branch, snapshot, and freshness metadata for the attached KB. Read-only status inspection with no mutation side effects.",
+    description: "Report current branch, KB snapshot and freshness metadata, plus the deterministic workspace snapshot used to validate execution receipts. Read-only status inspection with no mutation side effects.",
     businessInputSchema: { type: "object", properties: {} },
     requiresProlog: true,
     effects: ["kb-read", "workspace-read"],

package/dist/public/operations/specs/modeling.d.ts

@@ -59,6 +59,22 @@ export declare const modelRequirementSpec: {
                 readonly uniqueItems: true;
                 readonly description: "Existing requirement logic_claims values. The returned requirement update merges the new atomic claim key into this manifest instead of replacing prior claims.";
             };
+            readonly requirementId: {
+                readonly type: "string";
+                readonly description: "Optional existing requirement ID to receive the requires_rule relationship.";
+            };
+            readonly claimKey: {
+                readonly type: "string";
+                readonly description: "Optional advisor-issued claim key for the exact proposition represented by logic.";
+            };
+            readonly claimText: {
+                readonly type: "string";
+                readonly description: "Optional exact proposition text represented by logic; defaults to text.";
+            };
+            readonly logic: {
+                readonly type: "object";
+                readonly description: "Optional typed kibi.logic.v1 IR. Kibi validates and canonicalizes it into a rule fact; raw Prolog is rejected.";
+            };
         };
     };
     readonly requiresProlog: true;
@@ -68,7 +84,7 @@ export declare const modelRequirementSpec: {
 export declare const suggestPredicatesSpec: {
     readonly name: "kb_suggest_predicates";
     readonly cliName: "suggest-predicates";
-    readonly description: "Suggest ontology predicate schemas for prose requirements before agents write facts. Read-only guidance returns ranked candidates, a safe predicate-fact applyPlan, a separate requires_predicate relationshipPlan when a requirement ID is supplied, or an explicit ontology-gap observation when no predicate fits.";
+    readonly description: "Suggest ontology predicate schemas for prose requirements before agents write facts. Read-only guidance returns ranked candidates, an applicable predicate-fact plan only when every ordered argument is bound, a separate requires_predicate relationship plan when a requirement ID is supplied, or an explicit ontology-gap observation when no predicate fits.";
     readonly businessInputSchema: {
         readonly type: "object";
         readonly required: readonly ["text"];
@@ -108,6 +124,24 @@ export declare const suggestPredicatesSpec: {
                 readonly default: true;
                 readonly description: "Whether to include existing KB fact_kind=predicate_schema facts alongside Kibi's built-in predicate catalog. Default: true.";
             };
+            readonly schemaId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "Optional exact reviewed predicate schema ID. When supplied, Kibi selects that schema instead of lexical rank order and fails closed if it is unavailable.";
+            };
+            readonly argumentBindings: {
+                readonly type: "object";
+                readonly additionalProperties: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly description: "Optional exact predicate argument values keyed by a candidate schema's argument_names. Required before applying a candidate whose binding_status is incomplete; Kibi never substitutes guessed values for unbound arguments.";
+            };
+            readonly polarityHint: {
+                readonly type: "string";
+                readonly enum: readonly ["assert", "deny"];
+                readonly description: "Optional reviewed polarity override for claims whose surface negation does not express predicate denial. Use only after reviewing the selected schema and full claim scope.";
+            };
             readonly existingLogicClaims: {
                 readonly type: "array";
                 readonly items: {

package/dist/public/operations/specs/modeling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modeling.d.ts","sourceRoot":"","sources":["../../../../src/public/operations/specs/modeling.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,uBAAuB,EACxB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAGL,wBAAwB,EACzB,MAAM,oDAAoD,CAAC;AAG5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEhC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkEjC,CAAC"}
+{"version":3,"file":"modeling.d.ts","sourceRoot":"","sources":["../../../../src/public/operations/specs/modeling.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,uBAAuB,EACxB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAGL,wBAAwB,EACzB,MAAM,oDAAoD,CAAC;AAG5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6FhC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFjC,CAAC"}

package/dist/public/operations/specs/modeling.js

@@ -54,6 +54,22 @@ export const modelRequirementSpec = {
                 uniqueItems: true,
                 description: "Existing requirement logic_claims values. The returned requirement update merges the new atomic claim key into this manifest instead of replacing prior claims.",
             },
+            requirementId: {
+                type: "string",
+                description: "Optional existing requirement ID to receive the requires_rule relationship.",
+            },
+            claimKey: {
+                type: "string",
+                description: "Optional advisor-issued claim key for the exact proposition represented by logic.",
+            },
+            claimText: {
+                type: "string",
+                description: "Optional exact proposition text represented by logic; defaults to text.",
+            },
+            logic: {
+                type: "object",
+                description: "Optional typed kibi.logic.v1 IR. Kibi validates and canonicalizes it into a rule fact; raw Prolog is rejected.",
+            },
         },
     },
     requiresProlog: true,
@@ -63,7 +79,7 @@ export const modelRequirementSpec = {
 export const suggestPredicatesSpec = {
     name: "kb_suggest_predicates",
     cliName: "suggest-predicates",
-    description: "Suggest ontology predicate schemas for prose requirements before agents write facts. Read-only guidance returns ranked candidates, a safe predicate-fact applyPlan, a separate requires_predicate relationshipPlan when a requirement ID is supplied, or an explicit ontology-gap observation when no predicate fits.",
+    description: "Suggest ontology predicate schemas for prose requirements before agents write facts. Read-only guidance returns ranked candidates, an applicable predicate-fact plan only when every ordered argument is bound, a separate requires_predicate relationship plan when a requirement ID is supplied, or an explicit ontology-gap observation when no predicate fits.",
     businessInputSchema: {
         type: "object",
         required: ["text"],
@@ -103,6 +119,21 @@ export const suggestPredicatesSpec = {
                 default: true,
                 description: "Whether to include existing KB fact_kind=predicate_schema facts alongside Kibi's built-in predicate catalog. Default: true.",
             },
+            schemaId: {
+                type: "string",
+                minLength: 1,
+                description: "Optional exact reviewed predicate schema ID. When supplied, Kibi selects that schema instead of lexical rank order and fails closed if it is unavailable.",
+            },
+            argumentBindings: {
+                type: "object",
+                additionalProperties: { type: "string", minLength: 1 },
+                description: "Optional exact predicate argument values keyed by a candidate schema's argument_names. Required before applying a candidate whose binding_status is incomplete; Kibi never substitutes guessed values for unbound arguments.",
+            },
+            polarityHint: {
+                type: "string",
+                enum: ["assert", "deny"],
+                description: "Optional reviewed polarity override for claims whose surface negation does not express predicate denial. Use only after reviewing the selected schema and full claim scope.",
+            },
             existingLogicClaims: {
                 type: "array",
                 items: { type: "string", pattern: "^CLAIM-[A-F0-9]{16}$" },

package/dist/public/operations/specs/mutation-schemas.d.ts

@@ -45,6 +45,10 @@ export declare const ENTITY_PROPERTIES_SCHEMA: {
             readonly type: "string";
             readonly description: "Optional text anchor/reference. Example: 'requirements.md#L40'.";
         };
+        readonly semantic_text: {
+            readonly type: "string";
+            readonly description: "Requirement-only authored prose used for semantic inventory hashes and UTF-8 spans. Keep text_ref available for independent document or code evidence.";
+        };
         readonly logic_claims: {
             readonly type: "array";
             readonly minItems: 1;
@@ -55,6 +59,30 @@ export declare const ENTITY_PROPERTIES_SCHEMA: {
             };
             readonly description: "Requirement-only manifest of every atomic normative claim key returned by kb_semantic_advisor. A requirement is logic-complete only when every key is grounded by a linked property_value or predicate fact with the same claim_key.";
         };
+        readonly semantic_clauses: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly description: "Optional complete atomic decomposition used by kb_semantic_advisor and proposition-complete ingestion. Preserve it when automatic sentence splitting needs a reviewed override.";
+        };
+        readonly semantic_inventory_version: {
+            readonly type: "string";
+            readonly const: "kibi.semantic-inventory.v1";
+            readonly description: "Requirement-only proposition ledger contract version returned by kb_semantic_advisor.";
+        };
+        readonly semantic_source_field: {
+            readonly type: "string";
+            readonly enum: readonly ["semantic_text", "text_ref", "title"];
+            readonly description: "Requirement field whose exact UTF-8 bytes anchor semantic_inventory spans.";
+        };
+        readonly semantic_source_hash: {
+            readonly type: "string";
+            readonly pattern: "^[a-f0-9]{64}$";
+            readonly description: "SHA-256 of the exact semantic source text returned in the advisor inventory contract.";
+        };
         readonly sourceFile: {
             readonly type: "string";
             readonly description: "Optional code source file for symbol entities. Example: 'src/auth/login.ts'.";
@@ -79,9 +107,69 @@ export declare const ENTITY_PROPERTIES_SCHEMA: {
             readonly enum: readonly ["internal", "consumer"];
             readonly description: "Optional typed verification perspective for test entities. Example: 'consumer'.";
         };
+        readonly verification_receipts: {
+            readonly type: "array";
+            readonly maxItems: 50;
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["version", "receipt_id", "test_id", "runner", "command", "scope", "outcome", "code_snapshot", "environment_hash", "started_at", "finished_at", "artifact_digest"];
+                readonly properties: {
+                    readonly version: {
+                        readonly type: "string";
+                        readonly const: "kibi.verification-receipt.v1";
+                    };
+                    readonly receipt_id: {
+                        readonly type: "string";
+                        readonly pattern: "^VR-[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$";
+                    };
+                    readonly test_id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly runner: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly command: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly scope: {
+                        readonly type: "string";
+                        readonly enum: readonly ["unit", "integration", "end_to_end"];
+                    };
+                    readonly outcome: {
+                        readonly type: "string";
+                        readonly enum: readonly ["passed", "failed", "errored", "cancelled", "skipped"];
+                    };
+                    readonly code_snapshot: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-f0-9]{64}$";
+                    };
+                    readonly environment_hash: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-f0-9]{64}$";
+                    };
+                    readonly started_at: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly finished_at: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly artifact_digest: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-f0-9]{64}$";
+                    };
+                };
+                readonly additionalProperties: false;
+            };
+            readonly description: "Append-only test execution evidence. Proof accepts only the newest valid passed receipt bound to the current code snapshot and within the seven-day freshness window.";
+        };
         readonly fact_kind: {
             readonly type: "string";
-            readonly enum: readonly ["subject", "property_value", "observation", "meta", "predicate_schema", "predicate"];
+            readonly enum: readonly ["subject", "property_value", "observation", "meta", "predicate_schema", "predicate", "rule_schema", "rule"];
             readonly description: "Optional fact lane kind for fact entities. Strict lane uses 'subject' and 'property_value'; context lane uses 'observation' or 'meta'; ontology lane uses 'predicate_schema' or 'predicate'. Use kb_model_requirement or kb_suggest_predicates when starting from prose.";
         };
         readonly subject_key: {
@@ -203,8 +291,50 @@ export declare const ENTITY_PROPERTIES_SCHEMA: {
             };
             readonly description: "Optional ground-term examples for a predicate schema.";
         };
+        readonly semantic_inventory: {
+            readonly type: "array";
+            readonly description: "Requirement proposition ledger returned by kb_semantic_advisor; preserve entries while modeling each assertive span.";
+            readonly items: {
+                readonly type: "object";
+            };
+        };
+        readonly rule_ir: {
+            readonly type: "object";
+            readonly description: "Schema-validated kibi.logic.v1 rule IR. It is persisted as data and never executed as caller-supplied Prolog.";
+        };
+        readonly rule_hash: {
+            readonly type: "string";
+            readonly description: "Deterministic hash of canonical rule_ir.";
+        };
+        readonly rule_schema_id: {
+            readonly type: "string";
+            readonly description: "Rule schema fact ID used to validate this rule.";
+        };
+        readonly rule_name: {
+            readonly type: "string";
+            readonly description: "Stable rule schema name.";
+        };
+        readonly semantic_key: {
+            readonly type: "string";
+            readonly description: "Canonical semantic identity of the normalized logical model.";
+        };
+        readonly claim_span_start: {
+            readonly type: "integer";
+            readonly minimum: 0;
+        };
+        readonly claim_span_end: {
+            readonly type: "integer";
+            readonly minimum: 0;
+        };
     };
-    readonly allOf: readonly [Record<string, unknown>];
+    readonly allOf: readonly [Record<string, unknown>, {
+        readonly if: {
+            readonly required: readonly ["verification_receipts"];
+        };
+        readonly then: {
+            readonly required: readonly ["verification_scope"];
+        };
+    }];
     readonly required: readonly ["title", "status"];
 };
 export declare const RELATIONSHIPS_SCHEMA: {
@@ -216,7 +346,7 @@ export declare const RELATIONSHIPS_SCHEMA: {
         readonly properties: {
             readonly type: {
                 readonly type: "string";
-                readonly enum: readonly ["depends_on", "specified_by", "verified_by", "validates", "implements", "covered_by", "executable_for", "constrained_by", "constrains", "requires_property", "requires_predicate", "guards", "publishes", "consumes", "supersedes", "relates_to"];
+                readonly enum: readonly ["depends_on", "specified_by", "verified_by", "validates", "implements", "covered_by", "executable_for", "constrained_by", "constrains", "requires_property", "requires_predicate", "requires_rule", "guards", "publishes", "consumes", "supersedes", "relates_to"];
                 readonly description: "Relationship type enum. Use only supported values. Direction semantics follow KB model (e.g., implements symbol->req, verified_by req/scenario->test, executable_for symbol->test).";
             };
             readonly from: {

package/dist/public/operations/specs/mutation-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutation-schemas.d.ts","sourceRoot":"","sources":["../../../../src/public/operations/specs/mutation-schemas.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,gFASf,CAAC;AAYX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsO3B,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;CA0CvB,CAAC"}
+{"version":3,"file":"mutation-schemas.d.ts","sourceRoot":"","sources":["../../../../src/public/operations/specs/mutation-schemas.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,gFASf,CAAC;AAYX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+S3B,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;CA2CvB,CAAC"}

package/dist/public/operations/specs/mutation-schemas.js

@@ -1,3 +1,4 @@
+import { VERIFICATION_RECEIPT_SCHEMA } from "../../verification-receipt.js";
 export const ENTITY_TYPES = [
     "req",
     "scenario",
@@ -59,6 +60,10 @@ export const ENTITY_PROPERTIES_SCHEMA = {
             type: "string",
             description: "Optional text anchor/reference. Example: 'requirements.md#L40'.",
         },
+        semantic_text: {
+            type: "string",
+            description: "Requirement-only authored prose used for semantic inventory hashes and UTF-8 spans. Keep text_ref available for independent document or code evidence.",
+        },
         logic_claims: {
             type: "array",
             minItems: 1,
@@ -66,6 +71,27 @@ export const ENTITY_PROPERTIES_SCHEMA = {
             items: { type: "string", pattern: "^CLAIM-[A-F0-9]{16}$" },
             description: "Requirement-only manifest of every atomic normative claim key returned by kb_semantic_advisor. A requirement is logic-complete only when every key is grounded by a linked property_value or predicate fact with the same claim_key.",
         },
+        semantic_clauses: {
+            type: "array",
+            minItems: 1,
+            items: { type: "string", minLength: 1 },
+            description: "Optional complete atomic decomposition used by kb_semantic_advisor and proposition-complete ingestion. Preserve it when automatic sentence splitting needs a reviewed override.",
+        },
+        semantic_inventory_version: {
+            type: "string",
+            const: "kibi.semantic-inventory.v1",
+            description: "Requirement-only proposition ledger contract version returned by kb_semantic_advisor.",
+        },
+        semantic_source_field: {
+            type: "string",
+            enum: ["semantic_text", "text_ref", "title"],
+            description: "Requirement field whose exact UTF-8 bytes anchor semantic_inventory spans.",
+        },
+        semantic_source_hash: {
+            type: "string",
+            pattern: "^[a-f0-9]{64}$",
+            description: "SHA-256 of the exact semantic source text returned in the advisor inventory contract.",
+        },
         sourceFile: {
             type: "string",
             description: "Optional code source file for symbol entities. Example: 'src/auth/login.ts'.",
@@ -102,6 +128,12 @@ export const ENTITY_PROPERTIES_SCHEMA = {
             enum: ["internal", "consumer"],
             description: "Optional typed verification perspective for test entities. Example: 'consumer'.",
         },
+        verification_receipts: {
+            type: "array",
+            maxItems: 50,
+            items: VERIFICATION_RECEIPT_SCHEMA,
+            description: "Append-only test execution evidence. Proof accepts only the newest valid passed receipt bound to the current code snapshot and within the seven-day freshness window.",
+        },
         fact_kind: {
             type: "string",
             enum: [
@@ -111,6 +143,8 @@ export const ENTITY_PROPERTIES_SCHEMA = {
                 "meta",
                 "predicate_schema",
                 "predicate",
+                "rule_schema",
+                "rule",
             ],
             description: "Optional fact lane kind for fact entities. Strict lane uses 'subject' and 'property_value'; context lane uses 'observation' or 'meta'; ontology lane uses 'predicate_schema' or 'predicate'. Use kb_model_requirement or kb_suggest_predicates when starting from prose.",
         },
@@ -221,8 +255,39 @@ export const ENTITY_PROPERTIES_SCHEMA = {
             items: { type: "string" },
             description: "Optional ground-term examples for a predicate schema.",
         },
+        semantic_inventory: {
+            type: "array",
+            description: "Requirement proposition ledger returned by kb_semantic_advisor; preserve entries while modeling each assertive span.",
+            items: { type: "object" },
+        },
+        rule_ir: {
+            type: "object",
+            description: "Schema-validated kibi.logic.v1 rule IR. It is persisted as data and never executed as caller-supplied Prolog.",
+        },
+        rule_hash: {
+            type: "string",
+            description: "Deterministic hash of canonical rule_ir.",
+        },
+        rule_schema_id: {
+            type: "string",
+            description: "Rule schema fact ID used to validate this rule.",
+        },
+        rule_name: { type: "string", description: "Stable rule schema name." },
+        semantic_key: {
+            type: "string",
+            description: "Canonical semantic identity of the normalized logical model.",
+        },
+        claim_span_start: { type: "integer", minimum: 0 },
+        claim_span_end: { type: "integer", minimum: 0 },
     },
-    allOf: [CLAIM_PROVENANCE_CONDITIONAL],
+    allOf: [
+        CLAIM_PROVENANCE_CONDITIONAL,
+        {
+            if: { required: ["verification_receipts"] },
+            // biome-ignore lint/suspicious/noThenProperty: JSON Schema conditional keyword.
+            then: { required: ["verification_scope"] },
+        },
+    ],
     required: ["title", "status"],
 };
 export const RELATIONSHIPS_SCHEMA = {
@@ -246,6 +311,7 @@ export const RELATIONSHIPS_SCHEMA = {
                     "constrains",
                     "requires_property",
                     "requires_predicate",
+                    "requires_rule",
                     "guards",
                     "publishes",
                     "consumes",

package/dist/public/operations/specs/reporting.d.ts

@@ -1,3 +1,5 @@
+import { type LegacyMigrationPlan } from "../legacy-migration-plan.js";
+import { type RepairPlan } from "../repair-plan.js";
 import type { OperationContext } from "../runtime-types.js";
 import type { OperationResult } from "../types.js";
 export type FindGapsInput = {
@@ -21,10 +23,17 @@ export type CoverageInput = {
     readonly includeTransitive?: boolean;
     readonly limit?: number;
     readonly offset?: number;
+    readonly includeMigrationPreview?: boolean;
+    readonly migrationLimit?: number;
+    readonly migrationOffset?: number;
+    readonly migrationPredicateLimit?: number;
+    readonly migrationPredicateMinScore?: number;
 };
 export type CoveragePayload = {
     readonly summary: Readonly<Record<string, number>>;
     readonly rows: readonly Readonly<Record<string, unknown>>[];
+    readonly repairPlan?: RepairPlan;
+    readonly legacyMigrationPlan?: LegacyMigrationPlan;
     readonly meta?: Readonly<Record<string, unknown>>;
 };
 export type GraphInput = {
@@ -93,7 +102,7 @@ export declare function executeCoverage(input: CoverageInput, context: Operation
 export declare const coverageSpec: {
     readonly name: "kb_coverage";
     readonly cliName: "coverage";
-    readonly description: "Generate curated coverage reports for requirements, symbols, or grouped types. Read-only reporting with no mutation side effects.";
+    readonly description: "Generate curated structural coverage and conservative end-to-end requirement proof reports for requirements, symbols, or grouped types. Requirement reports include a deterministic, dependency-ordered, read-only repair plan; optional legacy migration previews reconstruct authored proposition inventories and rank exact schema candidates without producing executable writes. Paginated plans identify incomplete scope. Requirement rows keep coverageStatus separate from proofStatus and require fresh snapshot-bound E2E receipts before proof. No mutation side effects.";
     readonly businessInputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -124,6 +133,38 @@ export declare const coverageSpec: {
                 readonly type: "integer";
                 readonly default: 0;
             };
+            readonly includeMigrationPreview: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "Opt in to a deterministic, read-only kibi.legacy-migration-plan.v1 preview for ready semantic-inventory repair batches.";
+            };
+            readonly migrationLimit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 10;
+                readonly default: 1;
+                readonly description: "Maximum requirement migration batches to preview. Defaults to one review batch.";
+            };
+            readonly migrationOffset: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly default: 0;
+                readonly description: "Zero-based offset into ready semantic-inventory batches.";
+            };
+            readonly migrationPredicateLimit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 20;
+                readonly default: 5;
+                readonly description: "Maximum exact predicate-schema candidates retained per assertive proposition.";
+            };
+            readonly migrationPredicateMinScore: {
+                readonly type: "number";
+                readonly minimum: 0;
+                readonly maximum: 1;
+                readonly default: 0.35;
+                readonly description: "Minimum deterministic predicate-schema rank score retained in migration previews.";
+            };
         };
     };
     readonly requiresProlog: true;

package/dist/public/operations/specs/reporting.d.ts.map

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