@agentskit/doc-bridge 1.4.3 → 1.5.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DocBridgeConfigV1, a as DocumentationStandardRuleId } from './index-DhoAG9Ar.js';
-export { A as AgentCorpusConfig, C as ConfigNotFoundError, b as DocBridgeConfigV1Schema, c as DocumentationStandardRuleIdSchema, d as DocumentationStandardV1Config, e as DocumentationStandardV1ConfigSchema, E as EcosystemContractEvidenceSchema, L as LoadConfigOptions, f as LoadConfigResult, g as applyConfigDefaults, h as defineConfig, l as loadConfig, p as projectRootFromConfigPath, r as resolveProjectRoot } from './index-DhoAG9Ar.js';
+import { D as DocBridgeConfigV1, R as RulesConfig, a as RuleId, b as RuleSeverity, c as DocumentationStandardRuleId } from './index-Di7PkJuf.js';
+export { A as AgentCorpusConfig, C as ConfigNotFoundError, d as DocBridgeConfigV1Schema, e as DocumentationStandardRuleIdSchema, f as DocumentationStandardV1Config, g as DocumentationStandardV1ConfigSchema, E as EcosystemContractEvidenceSchema, L as LoadConfigOptions, h as LoadConfigResult, i as RepositorySafetyConfig, j as RepositorySafetyConfigSchema, k as RuleIdSchema, l as RuleSeveritySchema, m as RulesConfigSchema, W as WorkflowConfig, n as WorkflowConfigSchema, o as applyConfigDefaults, p as defineConfig, q as loadConfig, r as projectRootFromConfigPath, s as resolveProjectRoot } from './index-Di7PkJuf.js';
 import { z } from 'zod';
 
 declare const HANDOFF_SCHEMA_VERSION: 1;
@@ -1374,6 +1374,1649 @@ declare const DocBridgeJsonSchemas: {
     };
 };
 
+declare const KNOWLEDGE_SCHEMA_VERSION: 1;
+declare const KNOWLEDGE_CONTENT_HASH_ALGO: "sha256-normalized-v1";
+declare const ProvenanceSchema: z.ZodEnum<["observed", "declared", "proposed"]>;
+type Provenance = z.infer<typeof ProvenanceSchema>;
+declare const FindingStatusSchema: z.ZodEnum<["confirmed", "undocumented", "stale-or-unverified", "conflict", "unresolved", "not-analyzed"]>;
+type FindingStatus = z.infer<typeof FindingStatusSchema>;
+declare const DiagnosticSeveritySchema: z.ZodEnum<["off", "info", "warn", "error"]>;
+type DiagnosticSeverity = z.infer<typeof DiagnosticSeveritySchema>;
+declare const EvidenceSourceSchema: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+declare const EvidenceSchema: z.ZodEffects<z.ZodObject<{
+    source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+    path: z.ZodString;
+    lineStart: z.ZodOptional<z.ZodNumber>;
+    lineEnd: z.ZodOptional<z.ZodNumber>;
+    contentHash: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    source: "code" | "agent" | "configuration" | "documentation" | "derived";
+    contentHash?: string | undefined;
+    lineStart?: number | undefined;
+    lineEnd?: number | undefined;
+    context?: string | undefined;
+}, {
+    path: string;
+    source: "code" | "agent" | "configuration" | "documentation" | "derived";
+    contentHash?: string | undefined;
+    lineStart?: number | undefined;
+    lineEnd?: number | undefined;
+    context?: string | undefined;
+}>, {
+    path: string;
+    source: "code" | "agent" | "configuration" | "documentation" | "derived";
+    contentHash?: string | undefined;
+    lineStart?: number | undefined;
+    lineEnd?: number | undefined;
+    context?: string | undefined;
+}, {
+    path: string;
+    source: "code" | "agent" | "configuration" | "documentation" | "derived";
+    contentHash?: string | undefined;
+    lineStart?: number | undefined;
+    lineEnd?: number | undefined;
+    context?: string | undefined;
+}>;
+type Evidence = z.infer<typeof EvidenceSchema>;
+declare const CoverageSchema: z.ZodObject<{
+    analyzer: z.ZodString;
+    scope: z.ZodString;
+    status: z.ZodEnum<["complete", "partial", "not-analyzed"]>;
+    reason: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+        path: z.ZodString;
+        lineStart: z.ZodOptional<z.ZodNumber>;
+        lineEnd: z.ZodOptional<z.ZodNumber>;
+        contentHash: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    status: "partial" | "not-analyzed" | "complete";
+    analyzer: string;
+    scope: string;
+    reason?: string | undefined;
+    evidence?: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[] | undefined;
+}, {
+    status: "partial" | "not-analyzed" | "complete";
+    analyzer: string;
+    scope: string;
+    reason?: string | undefined;
+    evidence?: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[] | undefined;
+}>;
+declare const ProjectIdentitySchema: z.ZodObject<{
+    name: z.ZodString;
+    root: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    root?: string | undefined;
+}, {
+    name: string;
+    root?: string | undefined;
+}>;
+declare const EntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    name: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    provenance: z.ZodEnum<["observed", "declared", "proposed"]>;
+    evidence: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+        path: z.ZodString;
+        lineStart: z.ZodOptional<z.ZodNumber>;
+        lineEnd: z.ZodOptional<z.ZodNumber>;
+        contentHash: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, "many">;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    kind: string;
+    evidence: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[];
+    provenance: "observed" | "declared" | "proposed";
+    path?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    aliases?: string[] | undefined;
+}, {
+    id: string;
+    name: string;
+    kind: string;
+    evidence: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[];
+    provenance: "observed" | "declared" | "proposed";
+    path?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    aliases?: string[] | undefined;
+}>;
+type KnowledgeEntity = z.infer<typeof EntitySchema>;
+declare const RelationSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    from: z.ZodString;
+    to: z.ZodString;
+    discriminator: z.ZodOptional<z.ZodString>;
+    provenance: z.ZodEnum<["observed", "declared", "proposed"]>;
+    evidence: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+        path: z.ZodString;
+        lineStart: z.ZodOptional<z.ZodNumber>;
+        lineEnd: z.ZodOptional<z.ZodNumber>;
+        contentHash: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, "many">;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    kind: string;
+    evidence: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[];
+    provenance: "observed" | "declared" | "proposed";
+    from: string;
+    to: string;
+    metadata?: Record<string, unknown> | undefined;
+    discriminator?: string | undefined;
+}, {
+    id: string;
+    kind: string;
+    evidence: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[];
+    provenance: "observed" | "declared" | "proposed";
+    from: string;
+    to: string;
+    metadata?: Record<string, unknown> | undefined;
+    discriminator?: string | undefined;
+}>;
+type KnowledgeRelation = z.infer<typeof RelationSchema>;
+declare const DiscoverySnapshotV1Schema: z.ZodEffects<z.ZodObject<{
+    entities: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        name: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        provenance: z.ZodEnum<["observed", "declared", "proposed"]>;
+        evidence: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+            path: z.ZodString;
+            lineStart: z.ZodOptional<z.ZodNumber>;
+            lineEnd: z.ZodOptional<z.ZodNumber>;
+            contentHash: z.ZodOptional<z.ZodString>;
+            context: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }>, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }>, "many">;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        aliases?: string[] | undefined;
+    }, {
+        id: string;
+        name: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        aliases?: string[] | undefined;
+    }>, "many">;
+    relations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        from: z.ZodString;
+        to: z.ZodString;
+        discriminator: z.ZodOptional<z.ZodString>;
+        provenance: z.ZodEnum<["observed", "declared", "proposed"]>;
+        evidence: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+            path: z.ZodString;
+            lineStart: z.ZodOptional<z.ZodNumber>;
+            lineEnd: z.ZodOptional<z.ZodNumber>;
+            contentHash: z.ZodOptional<z.ZodString>;
+            context: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }>, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }>, "many">;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        from: string;
+        to: string;
+        metadata?: Record<string, unknown> | undefined;
+        discriminator?: string | undefined;
+    }, {
+        id: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        from: string;
+        to: string;
+        metadata?: Record<string, unknown> | undefined;
+        discriminator?: string | undefined;
+    }>, "many">;
+    coverage: z.ZodArray<z.ZodObject<{
+        analyzer: z.ZodString;
+        scope: z.ZodString;
+        status: z.ZodEnum<["complete", "partial", "not-analyzed"]>;
+        reason: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+            source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+            path: z.ZodString;
+            lineStart: z.ZodOptional<z.ZodNumber>;
+            lineEnd: z.ZodOptional<z.ZodNumber>;
+            contentHash: z.ZodOptional<z.ZodString>;
+            context: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }>, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        status: "partial" | "not-analyzed" | "complete";
+        analyzer: string;
+        scope: string;
+        reason?: string | undefined;
+        evidence?: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[] | undefined;
+    }, {
+        status: "partial" | "not-analyzed" | "complete";
+        analyzer: string;
+        scope: string;
+        reason?: string | undefined;
+        evidence?: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[] | undefined;
+    }>, "many">;
+    schemaVersion: z.ZodLiteral<1>;
+    contentHash: z.ZodString;
+    contentHashAlgo: z.ZodLiteral<"sha256-normalized-v1">;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        root: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        root?: string | undefined;
+    }, {
+        name: string;
+        root?: string | undefined;
+    }>;
+    sourceRevision: z.ZodString;
+    sourceRevisionKind: z.ZodEnum<["git", "content"]>;
+    configurationHash: z.ZodString;
+    pipelineVersion: z.ZodString;
+    analyzerVersions: z.ZodRecord<z.ZodString, z.ZodString>;
+    type: z.ZodLiteral<"discovery-snapshot">;
+}, "strict", z.ZodTypeAny, {
+    type: "discovery-snapshot";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    entities: {
+        id: string;
+        name: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        aliases?: string[] | undefined;
+    }[];
+    relations: {
+        id: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        from: string;
+        to: string;
+        metadata?: Record<string, unknown> | undefined;
+        discriminator?: string | undefined;
+    }[];
+    coverage: {
+        status: "partial" | "not-analyzed" | "complete";
+        analyzer: string;
+        scope: string;
+        reason?: string | undefined;
+        evidence?: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[] | undefined;
+    }[];
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+}, {
+    type: "discovery-snapshot";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    entities: {
+        id: string;
+        name: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        aliases?: string[] | undefined;
+    }[];
+    relations: {
+        id: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        from: string;
+        to: string;
+        metadata?: Record<string, unknown> | undefined;
+        discriminator?: string | undefined;
+    }[];
+    coverage: {
+        status: "partial" | "not-analyzed" | "complete";
+        analyzer: string;
+        scope: string;
+        reason?: string | undefined;
+        evidence?: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[] | undefined;
+    }[];
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+}>, {
+    type: "discovery-snapshot";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    entities: {
+        id: string;
+        name: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        aliases?: string[] | undefined;
+    }[];
+    relations: {
+        id: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        from: string;
+        to: string;
+        metadata?: Record<string, unknown> | undefined;
+        discriminator?: string | undefined;
+    }[];
+    coverage: {
+        status: "partial" | "not-analyzed" | "complete";
+        analyzer: string;
+        scope: string;
+        reason?: string | undefined;
+        evidence?: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[] | undefined;
+    }[];
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+}, {
+    type: "discovery-snapshot";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    entities: {
+        id: string;
+        name: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        path?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        aliases?: string[] | undefined;
+    }[];
+    relations: {
+        id: string;
+        kind: string;
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        provenance: "observed" | "declared" | "proposed";
+        from: string;
+        to: string;
+        metadata?: Record<string, unknown> | undefined;
+        discriminator?: string | undefined;
+    }[];
+    coverage: {
+        status: "partial" | "not-analyzed" | "complete";
+        analyzer: string;
+        scope: string;
+        reason?: string | undefined;
+        evidence?: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[] | undefined;
+    }[];
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+}>;
+type DiscoverySnapshotV1 = z.infer<typeof DiscoverySnapshotV1Schema>;
+declare const DiagnosticSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+    status: z.ZodEnum<["confirmed", "undocumented", "stale-or-unverified", "conflict", "unresolved", "not-analyzed"]>;
+    severity: z.ZodEnum<["off", "info", "warn", "error"]>;
+    message: z.ZodString;
+    evidence: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+        path: z.ZodString;
+        lineStart: z.ZodOptional<z.ZodNumber>;
+        lineEnd: z.ZodOptional<z.ZodNumber>;
+        contentHash: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, "many">;
+    entityIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    relationIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    remediation: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    status: "confirmed" | "undocumented" | "stale-or-unverified" | "conflict" | "unresolved" | "not-analyzed";
+    id: string;
+    severity: "off" | "info" | "warn" | "error";
+    evidence: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[];
+    entityIds?: string[] | undefined;
+    relationIds?: string[] | undefined;
+    remediation?: string | undefined;
+}, {
+    code: string;
+    message: string;
+    status: "confirmed" | "undocumented" | "stale-or-unverified" | "conflict" | "unresolved" | "not-analyzed";
+    id: string;
+    severity: "off" | "info" | "warn" | "error";
+    evidence: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[];
+    entityIds?: string[] | undefined;
+    relationIds?: string[] | undefined;
+    remediation?: string | undefined;
+}>;
+type KnowledgeDiagnostic = z.infer<typeof DiagnosticSchema>;
+declare const ReconciliationReportV1Schema: z.ZodObject<{
+    snapshotHash: z.ZodString;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        code: z.ZodString;
+        status: z.ZodEnum<["confirmed", "undocumented", "stale-or-unverified", "conflict", "unresolved", "not-analyzed"]>;
+        severity: z.ZodEnum<["off", "info", "warn", "error"]>;
+        message: z.ZodString;
+        evidence: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+            path: z.ZodString;
+            lineStart: z.ZodOptional<z.ZodNumber>;
+            lineEnd: z.ZodOptional<z.ZodNumber>;
+            contentHash: z.ZodOptional<z.ZodString>;
+            context: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }>, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }, {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }>, "many">;
+        entityIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        relationIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        remediation: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        status: "confirmed" | "undocumented" | "stale-or-unverified" | "conflict" | "unresolved" | "not-analyzed";
+        id: string;
+        severity: "off" | "info" | "warn" | "error";
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        entityIds?: string[] | undefined;
+        relationIds?: string[] | undefined;
+        remediation?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        status: "confirmed" | "undocumented" | "stale-or-unverified" | "conflict" | "unresolved" | "not-analyzed";
+        id: string;
+        severity: "off" | "info" | "warn" | "error";
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        entityIds?: string[] | undefined;
+        relationIds?: string[] | undefined;
+        remediation?: string | undefined;
+    }>, "many">;
+    summary: z.ZodObject<{
+        entityCount: z.ZodNumber;
+        relationCount: z.ZodNumber;
+        diagnosticCount: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        entityCount: number;
+        relationCount: number;
+        diagnosticCount: number;
+    }, {
+        entityCount: number;
+        relationCount: number;
+        diagnosticCount: number;
+    }>;
+    schemaVersion: z.ZodLiteral<1>;
+    contentHash: z.ZodString;
+    contentHashAlgo: z.ZodLiteral<"sha256-normalized-v1">;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        root: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        root?: string | undefined;
+    }, {
+        name: string;
+        root?: string | undefined;
+    }>;
+    sourceRevision: z.ZodString;
+    sourceRevisionKind: z.ZodEnum<["git", "content"]>;
+    configurationHash: z.ZodString;
+    pipelineVersion: z.ZodString;
+    analyzerVersions: z.ZodRecord<z.ZodString, z.ZodString>;
+    type: z.ZodLiteral<"reconciliation-report">;
+}, "strict", z.ZodTypeAny, {
+    type: "reconciliation-report";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    summary: {
+        entityCount: number;
+        relationCount: number;
+        diagnosticCount: number;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    snapshotHash: string;
+    diagnostics: {
+        code: string;
+        message: string;
+        status: "confirmed" | "undocumented" | "stale-or-unverified" | "conflict" | "unresolved" | "not-analyzed";
+        id: string;
+        severity: "off" | "info" | "warn" | "error";
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        entityIds?: string[] | undefined;
+        relationIds?: string[] | undefined;
+        remediation?: string | undefined;
+    }[];
+}, {
+    type: "reconciliation-report";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    summary: {
+        entityCount: number;
+        relationCount: number;
+        diagnosticCount: number;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    snapshotHash: string;
+    diagnostics: {
+        code: string;
+        message: string;
+        status: "confirmed" | "undocumented" | "stale-or-unverified" | "conflict" | "unresolved" | "not-analyzed";
+        id: string;
+        severity: "off" | "info" | "warn" | "error";
+        evidence: {
+            path: string;
+            source: "code" | "agent" | "configuration" | "documentation" | "derived";
+            contentHash?: string | undefined;
+            lineStart?: number | undefined;
+            lineEnd?: number | undefined;
+            context?: string | undefined;
+        }[];
+        entityIds?: string[] | undefined;
+        relationIds?: string[] | undefined;
+        remediation?: string | undefined;
+    }[];
+}>;
+type ReconciliationReportV1 = z.infer<typeof ReconciliationReportV1Schema>;
+declare const WorkflowStateSchema: z.ZodEnum<["created", "discovering", "analyzed", "compared", "awaiting-agent", "proposed", "awaiting-approval", "validating", "delivered", "failed", "cancelled", "stale", "superseded"]>;
+type WorkflowState = z.infer<typeof WorkflowStateSchema>;
+declare const WorkflowStepSchema: z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodEnum<["pending", "running", "completed", "failed", "skipped"]>;
+    inputHash: z.ZodString;
+    outputHash: z.ZodOptional<z.ZodString>;
+    artifactRefs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    status: "failed" | "pending" | "running" | "completed" | "skipped";
+    name: string;
+    inputHash: string;
+    outputHash?: string | undefined;
+    artifactRefs?: string[] | undefined;
+}, {
+    status: "failed" | "pending" | "running" | "completed" | "skipped";
+    name: string;
+    inputHash: string;
+    outputHash?: string | undefined;
+    artifactRefs?: string[] | undefined;
+}>;
+declare const WorkflowTransitionSchema: z.ZodObject<{
+    from: z.ZodNullable<z.ZodEnum<["created", "discovering", "analyzed", "compared", "awaiting-agent", "proposed", "awaiting-approval", "validating", "delivered", "failed", "cancelled", "stale", "superseded"]>>;
+    to: z.ZodEnum<["created", "discovering", "analyzed", "compared", "awaiting-agent", "proposed", "awaiting-approval", "validating", "delivered", "failed", "cancelled", "stale", "superseded"]>;
+    at: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    at: string;
+    from: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded" | null;
+    to: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded";
+    reason?: string | undefined;
+}, {
+    at: string;
+    from: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded" | null;
+    to: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded";
+    reason?: string | undefined;
+}>;
+declare const WorkflowRunV1Schema: z.ZodObject<{
+    runId: z.ZodString;
+    state: z.ZodEnum<["created", "discovering", "analyzed", "compared", "awaiting-agent", "proposed", "awaiting-approval", "validating", "delivered", "failed", "cancelled", "stale", "superseded"]>;
+    steps: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodEnum<["pending", "running", "completed", "failed", "skipped"]>;
+        inputHash: z.ZodString;
+        outputHash: z.ZodOptional<z.ZodString>;
+        artifactRefs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        status: "failed" | "pending" | "running" | "completed" | "skipped";
+        name: string;
+        inputHash: string;
+        outputHash?: string | undefined;
+        artifactRefs?: string[] | undefined;
+    }, {
+        status: "failed" | "pending" | "running" | "completed" | "skipped";
+        name: string;
+        inputHash: string;
+        outputHash?: string | undefined;
+        artifactRefs?: string[] | undefined;
+    }>, "many">;
+    transitions: z.ZodArray<z.ZodObject<{
+        from: z.ZodNullable<z.ZodEnum<["created", "discovering", "analyzed", "compared", "awaiting-agent", "proposed", "awaiting-approval", "validating", "delivered", "failed", "cancelled", "stale", "superseded"]>>;
+        to: z.ZodEnum<["created", "discovering", "analyzed", "compared", "awaiting-agent", "proposed", "awaiting-approval", "validating", "delivered", "failed", "cancelled", "stale", "superseded"]>;
+        at: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        at: string;
+        from: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded" | null;
+        to: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded";
+        reason?: string | undefined;
+    }, {
+        at: string;
+        from: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded" | null;
+        to: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded";
+        reason?: string | undefined;
+    }>, "many">;
+    artifactRefs: z.ZodArray<z.ZodString, "many">;
+    schemaVersion: z.ZodLiteral<1>;
+    contentHash: z.ZodString;
+    contentHashAlgo: z.ZodLiteral<"sha256-normalized-v1">;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        root: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        root?: string | undefined;
+    }, {
+        name: string;
+        root?: string | undefined;
+    }>;
+    sourceRevision: z.ZodString;
+    sourceRevisionKind: z.ZodEnum<["git", "content"]>;
+    configurationHash: z.ZodString;
+    pipelineVersion: z.ZodString;
+    analyzerVersions: z.ZodRecord<z.ZodString, z.ZodString>;
+    type: z.ZodLiteral<"workflow-run">;
+}, "strict", z.ZodTypeAny, {
+    type: "workflow-run";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    artifactRefs: string[];
+    runId: string;
+    state: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded";
+    steps: {
+        status: "failed" | "pending" | "running" | "completed" | "skipped";
+        name: string;
+        inputHash: string;
+        outputHash?: string | undefined;
+        artifactRefs?: string[] | undefined;
+    }[];
+    transitions: {
+        at: string;
+        from: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded" | null;
+        to: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded";
+        reason?: string | undefined;
+    }[];
+}, {
+    type: "workflow-run";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    artifactRefs: string[];
+    runId: string;
+    state: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded";
+    steps: {
+        status: "failed" | "pending" | "running" | "completed" | "skipped";
+        name: string;
+        inputHash: string;
+        outputHash?: string | undefined;
+        artifactRefs?: string[] | undefined;
+    }[];
+    transitions: {
+        at: string;
+        from: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded" | null;
+        to: "proposed" | "created" | "discovering" | "analyzed" | "compared" | "awaiting-agent" | "awaiting-approval" | "validating" | "delivered" | "failed" | "cancelled" | "stale" | "superseded";
+        reason?: string | undefined;
+    }[];
+}>;
+type WorkflowRunV1 = z.infer<typeof WorkflowRunV1Schema>;
+declare const ProposalOriginSchema: z.ZodEffects<z.ZodObject<{
+    kind: z.ZodEnum<["registry-agent", "manual", "deterministic"]>;
+    id: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    kind: "manual" | "registry-agent" | "deterministic";
+    capabilities?: string[] | undefined;
+    id?: string | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
+    version?: string | undefined;
+}, {
+    kind: "manual" | "registry-agent" | "deterministic";
+    capabilities?: string[] | undefined;
+    id?: string | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
+    version?: string | undefined;
+}>, {
+    kind: "manual" | "registry-agent" | "deterministic";
+    capabilities?: string[] | undefined;
+    id?: string | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
+    version?: string | undefined;
+}, {
+    kind: "manual" | "registry-agent" | "deterministic";
+    capabilities?: string[] | undefined;
+    id?: string | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
+    version?: string | undefined;
+}>;
+declare const AgentProposalV1Schema: z.ZodObject<{
+    proposalId: z.ZodString;
+    baseSnapshotHash: z.ZodString;
+    baseReportHash: z.ZodString;
+    relatedDiagnosticIds: z.ZodArray<z.ZodString, "many">;
+    rationale: z.ZodString;
+    confidence: z.ZodNumber;
+    evidence: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        source: z.ZodEnum<["code", "configuration", "documentation", "agent", "derived"]>;
+        path: z.ZodString;
+        lineStart: z.ZodOptional<z.ZodNumber>;
+        lineEnd: z.ZodOptional<z.ZodNumber>;
+        contentHash: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }, {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }>, "many">;
+    intendedChanges: z.ZodArray<z.ZodString, "many">;
+    origin: z.ZodEffects<z.ZodObject<{
+        kind: z.ZodEnum<["registry-agent", "manual", "deterministic"]>;
+        id: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "manual" | "registry-agent" | "deterministic";
+        capabilities?: string[] | undefined;
+        id?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        version?: string | undefined;
+    }, {
+        kind: "manual" | "registry-agent" | "deterministic";
+        capabilities?: string[] | undefined;
+        id?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        version?: string | undefined;
+    }>, {
+        kind: "manual" | "registry-agent" | "deterministic";
+        capabilities?: string[] | undefined;
+        id?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        version?: string | undefined;
+    }, {
+        kind: "manual" | "registry-agent" | "deterministic";
+        capabilities?: string[] | undefined;
+        id?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        version?: string | undefined;
+    }>;
+    checks: z.ZodArray<z.ZodString, "many">;
+    schemaVersion: z.ZodLiteral<1>;
+    contentHash: z.ZodString;
+    contentHashAlgo: z.ZodLiteral<"sha256-normalized-v1">;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        root: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        root?: string | undefined;
+    }, {
+        name: string;
+        root?: string | undefined;
+    }>;
+    sourceRevision: z.ZodString;
+    sourceRevisionKind: z.ZodEnum<["git", "content"]>;
+    configurationHash: z.ZodString;
+    pipelineVersion: z.ZodString;
+    analyzerVersions: z.ZodRecord<z.ZodString, z.ZodString>;
+    type: z.ZodLiteral<"agent-proposal">;
+}, "strict", z.ZodTypeAny, {
+    type: "agent-proposal";
+    contentHash: string;
+    checks: string[];
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    confidence: number;
+    evidence: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[];
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    proposalId: string;
+    baseSnapshotHash: string;
+    baseReportHash: string;
+    relatedDiagnosticIds: string[];
+    rationale: string;
+    intendedChanges: string[];
+    origin: {
+        kind: "manual" | "registry-agent" | "deterministic";
+        capabilities?: string[] | undefined;
+        id?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        version?: string | undefined;
+    };
+}, {
+    type: "agent-proposal";
+    contentHash: string;
+    checks: string[];
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    confidence: number;
+    evidence: {
+        path: string;
+        source: "code" | "agent" | "configuration" | "documentation" | "derived";
+        contentHash?: string | undefined;
+        lineStart?: number | undefined;
+        lineEnd?: number | undefined;
+        context?: string | undefined;
+    }[];
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    proposalId: string;
+    baseSnapshotHash: string;
+    baseReportHash: string;
+    relatedDiagnosticIds: string[];
+    rationale: string;
+    intendedChanges: string[];
+    origin: {
+        kind: "manual" | "registry-agent" | "deterministic";
+        capabilities?: string[] | undefined;
+        id?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        version?: string | undefined;
+    };
+}>;
+type AgentProposalV1 = z.infer<typeof AgentProposalV1Schema>;
+declare const FixProposalStatusSchema: z.ZodEnum<["proposed", "approved", "rejected", "stale", "applied", "failed"]>;
+declare const AffectedFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    contentHash: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    contentHash: string;
+}, {
+    path: string;
+    contentHash: string;
+}>;
+declare const FixChangeSchema: z.ZodObject<{
+    path: z.ZodString;
+    before: z.ZodString;
+    after: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    before: string;
+    after: string;
+}, {
+    path: string;
+    before: string;
+    after: string;
+}>;
+type FixChange = z.infer<typeof FixChangeSchema>;
+declare const FixProposalV1Schema: z.ZodEffects<z.ZodObject<{
+    proposalId: z.ZodString;
+    baseRevision: z.ZodString;
+    affectedFiles: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        contentHash: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        contentHash: string;
+    }, {
+        path: string;
+        contentHash: string;
+    }>, "many">;
+    changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        before: z.ZodString;
+        after: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        before: string;
+        after: string;
+    }, {
+        path: string;
+        before: string;
+        after: string;
+    }>, "many">>;
+    preconditions: z.ZodArray<z.ZodString, "many">;
+    diff: z.ZodString;
+    postconditions: z.ZodArray<z.ZodString, "many">;
+    approval: z.ZodOptional<z.ZodObject<{
+        proposalHash: z.ZodString;
+        approvedAt: z.ZodString;
+        approvedBy: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        approvedBy: string;
+        proposalHash: string;
+        approvedAt: string;
+    }, {
+        approvedBy: string;
+        proposalHash: string;
+        approvedAt: string;
+    }>>;
+    status: z.ZodEnum<["proposed", "approved", "rejected", "stale", "applied", "failed"]>;
+    schemaVersion: z.ZodLiteral<1>;
+    contentHash: z.ZodString;
+    contentHashAlgo: z.ZodLiteral<"sha256-normalized-v1">;
+    project: z.ZodObject<{
+        name: z.ZodString;
+        root: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        root?: string | undefined;
+    }, {
+        name: string;
+        root?: string | undefined;
+    }>;
+    sourceRevision: z.ZodString;
+    sourceRevisionKind: z.ZodEnum<["git", "content"]>;
+    configurationHash: z.ZodString;
+    pipelineVersion: z.ZodString;
+    analyzerVersions: z.ZodRecord<z.ZodString, z.ZodString>;
+    type: z.ZodLiteral<"fix-proposal">;
+}, "strict", z.ZodTypeAny, {
+    type: "fix-proposal";
+    status: "proposed" | "failed" | "stale" | "approved" | "rejected" | "applied";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    proposalId: string;
+    baseRevision: string;
+    affectedFiles: {
+        path: string;
+        contentHash: string;
+    }[];
+    preconditions: string[];
+    diff: string;
+    postconditions: string[];
+    changes?: {
+        path: string;
+        before: string;
+        after: string;
+    }[] | undefined;
+    approval?: {
+        approvedBy: string;
+        proposalHash: string;
+        approvedAt: string;
+    } | undefined;
+}, {
+    type: "fix-proposal";
+    status: "proposed" | "failed" | "stale" | "approved" | "rejected" | "applied";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    proposalId: string;
+    baseRevision: string;
+    affectedFiles: {
+        path: string;
+        contentHash: string;
+    }[];
+    preconditions: string[];
+    diff: string;
+    postconditions: string[];
+    changes?: {
+        path: string;
+        before: string;
+        after: string;
+    }[] | undefined;
+    approval?: {
+        approvedBy: string;
+        proposalHash: string;
+        approvedAt: string;
+    } | undefined;
+}>, {
+    type: "fix-proposal";
+    status: "proposed" | "failed" | "stale" | "approved" | "rejected" | "applied";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    proposalId: string;
+    baseRevision: string;
+    affectedFiles: {
+        path: string;
+        contentHash: string;
+    }[];
+    preconditions: string[];
+    diff: string;
+    postconditions: string[];
+    changes?: {
+        path: string;
+        before: string;
+        after: string;
+    }[] | undefined;
+    approval?: {
+        approvedBy: string;
+        proposalHash: string;
+        approvedAt: string;
+    } | undefined;
+}, {
+    type: "fix-proposal";
+    status: "proposed" | "failed" | "stale" | "approved" | "rejected" | "applied";
+    contentHash: string;
+    schemaVersion: 1;
+    project: {
+        name: string;
+        root?: string | undefined;
+    };
+    contentHashAlgo: "sha256-normalized-v1";
+    sourceRevision: string;
+    sourceRevisionKind: "git" | "content";
+    configurationHash: string;
+    pipelineVersion: string;
+    analyzerVersions: Record<string, string>;
+    proposalId: string;
+    baseRevision: string;
+    affectedFiles: {
+        path: string;
+        contentHash: string;
+    }[];
+    preconditions: string[];
+    diff: string;
+    postconditions: string[];
+    changes?: {
+        path: string;
+        before: string;
+        after: string;
+    }[] | undefined;
+    approval?: {
+        approvedBy: string;
+        proposalHash: string;
+        approvedAt: string;
+    } | undefined;
+}>;
+type FixProposalV1 = z.infer<typeof FixProposalV1Schema>;
+type KnowledgeArtifactV1 = DiscoverySnapshotV1 | ReconciliationReportV1 | WorkflowRunV1 | AgentProposalV1 | FixProposalV1;
+
 type ParseIssue = {
     readonly path: string;
     readonly message: string;
@@ -1390,6 +3033,11 @@ declare const parseAgentHandoff: (input: unknown) => AgentHandoffV1;
 declare const parseAgentSearch: (input: unknown) => AgentSearchV1;
 declare const parseDocBridgeIndex: (input: unknown) => DocBridgeIndexV1;
 declare const parseMemoryCandidate: (input: unknown) => MemoryCandidateV1;
+declare const parseDiscoverySnapshot: (input: unknown) => DiscoverySnapshotV1;
+declare const parseReconciliationReport: (input: unknown) => ReconciliationReportV1;
+declare const parseWorkflowRun: (input: unknown) => WorkflowRunV1;
+declare const parseAgentProposal: (input: unknown) => AgentProposalV1;
+declare const parseFixProposal: (input: unknown) => FixProposalV1;
 declare const parseDocBridgeConfig: (input: unknown) => DocBridgeConfigV1;
 
 type BuildIndexOptions = {
@@ -1405,6 +3053,188 @@ type BuildIndexResult = {
 };
 declare const buildDocBridgeIndex: (opts: BuildIndexOptions) => BuildIndexResult;
 
+type DiscoveryOptions = {
+    readonly root?: string;
+    readonly config?: DocBridgeConfigV1;
+    readonly maxFiles?: number;
+    readonly maxBytes?: number;
+};
+declare const discoverRepository: (opts?: DiscoveryOptions) => DiscoverySnapshotV1;
+
+declare const DEFAULT_SAFETY_EXCLUDES: readonly ["**/.git/**", "**/node_modules/**", "**/dist/**", "**/build/**", "**/coverage/**", "**/.doc-bridge/**", "**/.env", "**/.env.*", "**/*secret*", "**/*credential*", "**/*.pem", "**/*.key"];
+type SafeWalkOptions = {
+    readonly extensions?: readonly string[];
+    readonly exclude?: readonly string[];
+    readonly maxFiles?: number;
+    readonly maxBytes?: number;
+    readonly maxTimeMs?: number;
+    readonly maxMemoryMb?: number;
+};
+type SafeWalkResult = {
+    readonly files: readonly string[];
+    readonly incomplete: boolean;
+    readonly reason?: string;
+};
+declare const containedPath: (root: string, candidate: string) => string | undefined;
+declare const safeWalkFiles: (root: string, options?: SafeWalkOptions) => SafeWalkResult;
+declare const redactSecrets: (value: string) => string;
+declare const redactValue: (value: unknown) => unknown;
+
+declare const DEFAULT_REGISTRY_AGENT_ID = "ecosystem-doc-bridge-corpus-scanner";
+declare const RegistryAgentMetadataSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    capabilities: string[];
+    id: string;
+    version: string;
+    provider?: string | undefined;
+    model?: string | undefined;
+}, {
+    id: string;
+    version: string;
+    capabilities?: string[] | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
+}>;
+type RegistryAgentMetadata = z.infer<typeof RegistryAgentMetadataSchema> & {
+    readonly root: string;
+};
+type RegistryAgentContext = {
+    readonly snapshot: DiscoverySnapshotV1;
+    readonly report: ReconciliationReportV1;
+    readonly evidence: readonly ReconciliationReportV1['diagnostics'][number]['evidence'][number][];
+    readonly capabilities: readonly ['snapshot.read', 'evidence.read', 'proposal.write'];
+    readonly network: false;
+    readonly shell: false;
+};
+type RegistryAgentRunner = (context: RegistryAgentContext) => Promise<unknown> | unknown;
+type RegistryAgentAdapter = {
+    readonly metadata: RegistryAgentMetadata;
+    readonly run: (snapshot: DiscoverySnapshotV1, report: ReconciliationReportV1, evidence?: readonly RegistryAgentContext['evidence'][number][]) => Promise<AgentProposalV1>;
+};
+declare const loadRegistryAgentRunner: (root: string, config: DocBridgeConfigV1) => Promise<RegistryAgentRunner>;
+declare const loadRegistryAgentMetadata: (root: string, config: DocBridgeConfigV1) => RegistryAgentMetadata;
+declare const createRegistryAgentAdapter: (root: string, config: DocBridgeConfigV1, runner: RegistryAgentRunner) => RegistryAgentAdapter;
+declare const persistRegistryAgentProposal: (stateDir: string, proposal: AgentProposalV1) => string;
+
+type DocumentationDiagnostic = {
+    readonly code: string;
+    readonly message: string;
+    readonly path: string;
+    readonly evidence: Evidence;
+};
+type DocumentationDeclarationInput = {
+    readonly path: string;
+    readonly content: string;
+};
+type DocumentationDeclarationOptions = {
+    readonly snapshot: Pick<DiscoverySnapshotV1, 'entities'>;
+    readonly documentId?: string;
+};
+type DocumentationDeclarationResult = {
+    readonly hasDocbridge: boolean;
+    readonly entities: readonly KnowledgeEntity[];
+    readonly relations: readonly KnowledgeRelation[];
+    readonly diagnostics: readonly DocumentationDiagnostic[];
+};
+type DocumentationAnalysisResult = {
+    readonly snapshot: DiscoverySnapshotV1;
+    readonly diagnostics: readonly DocumentationDiagnostic[];
+};
+declare const parseDocumentationDeclarations: (input: DocumentationDeclarationInput, options: DocumentationDeclarationOptions) => DocumentationDeclarationResult;
+declare const applyDocumentationDeclarations: (snapshot: DiscoverySnapshotV1, documents: readonly DocumentationDeclarationInput[]) => DocumentationAnalysisResult;
+
+declare const reconcileKnowledge: (observed: DiscoverySnapshotV1, declared: DiscoverySnapshotV1) => ReconciliationReportV1;
+
+type OfflineReportInput = {
+    readonly snapshot: DiscoverySnapshotV1;
+    readonly report: ReconciliationReportV1;
+};
+type OfflineReportOptions = {
+    readonly includeSnippets?: boolean;
+};
+declare const renderOfflineReport: (input: unknown, options?: OfflineReportOptions) => string;
+
+type FixProposalOptions = {
+    readonly baseRevision: string;
+    readonly configurationHash: string;
+    readonly projectName?: string;
+    readonly toolVersion?: string;
+};
+type FixApplyOptions = {
+    readonly currentRevision?: string;
+    readonly verify?: (changedPaths: readonly string[]) => void;
+};
+declare const createMarkdownLinkFixProposal: (root: string, options: FixProposalOptions) => FixProposalV1 | undefined;
+declare const createArtifactNormalizationProposal: (root: string, artifactPath: string, options: FixProposalOptions) => FixProposalV1 | undefined;
+declare const approveFixProposal: (proposalInput: unknown, approvedBy: string, approvedAt?: string) => FixProposalV1;
+declare const applyFixProposal: (root: string, proposalInput: unknown, options?: FixApplyOptions) => FixProposalV1;
+
+declare const WORKFLOW_STAGES: readonly ["collect", "normalize", "reconcile", "evaluate", "report"];
+type WorkflowStage = (typeof WORKFLOW_STAGES)[number];
+type WorkflowStageContext = {
+    readonly root: string;
+    readonly stage: WorkflowStage;
+    readonly input: unknown;
+    readonly previousOutput: unknown;
+};
+type WorkflowStageHandler = (context: WorkflowStageContext) => unknown;
+type WorkflowOptions = {
+    readonly root: string;
+    readonly stateDir?: string;
+    readonly sourceRevision: string;
+    readonly configurationHash: string;
+    readonly toolVersion?: string;
+    readonly runId?: string;
+    readonly stage?: WorkflowStage | 'all';
+    readonly inputs?: Partial<Record<WorkflowStage, unknown>>;
+    readonly handlers: Partial<Record<WorkflowStage, WorkflowStageHandler>>;
+};
+type WorkflowExecutionResult = {
+    readonly run: WorkflowRunV1;
+    readonly stateDir: string;
+    readonly reusedStages: readonly WorkflowStage[];
+};
+declare const runWorkflow: (options: WorkflowOptions) => WorkflowExecutionResult;
+declare const loadWorkflowManifest: (stateDir: string) => WorkflowRunV1;
+declare const loadWorkflowStepOutput: (stateDir: string, stage: WorkflowStage) => unknown;
+
+type RuleMode = 'default' | 'recommended' | 'strict';
+type RuleEngineOptions = {
+    readonly config?: RulesConfig;
+    readonly preset?: RuleMode;
+    readonly severity?: Partial<Record<RuleId, RuleSeverity>>;
+    readonly ignore?: readonly RuleId[];
+    readonly criticalEntities?: readonly string[];
+    readonly criticalPaths?: readonly string[];
+    readonly warningThresholds?: Partial<Record<RuleId, number>>;
+};
+type RuleFinding = {
+    readonly id: string;
+    readonly ruleId: RuleId;
+    readonly code: string;
+    readonly status: ReconciliationReportV1['diagnostics'][number]['status'];
+    readonly severity: RuleSeverity;
+    readonly message: string;
+    readonly evidence: ReconciliationReportV1['diagnostics'][number]['evidence'];
+    readonly entityIds?: readonly string[];
+    readonly relationIds?: readonly string[];
+    readonly remediation?: string;
+    readonly sourceDiagnosticCode?: string;
+};
+type RuleEvaluationResult = {
+    readonly mode: RuleMode;
+    readonly findings: readonly RuleFinding[];
+    readonly exitCode: 0 | 1;
+};
+declare const evaluateRules: (report: ReconciliationReportV1, options?: RuleEngineOptions) => RuleEvaluationResult;
+declare const parseRuleId: (value: string) => RuleId;
+declare const parseRuleSeverity: (value: string) => RuleSeverity;
+
 /**
  * Canonical AgentsKit ecosystem section for llms.txt (and similar machine indexes).
  *
@@ -1653,8 +3483,112 @@ declare const MCP_TOOLS: readonly [{
         readonly type: "object";
         readonly properties: {};
     };
+}, {
+    readonly name: "docbridge.snapshot";
+    readonly title: "Read the latest discovery snapshot";
+    readonly description: "Read the bounded canonical repository snapshot from the latest workflow run.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly runId: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "docbridge.report";
+    readonly title: "Read the latest reconciliation report";
+    readonly description: "Read the canonical reconciliation report from the latest workflow run.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly runId: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "docbridge.diagnostics";
+    readonly title: "Read reconciliation diagnostics";
+    readonly description: "Read bounded diagnostics from the latest canonical reconciliation report.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly status: {
+                readonly type: "string";
+            };
+            readonly severity: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "docbridge.relations";
+    readonly title: "Read architecture relations";
+    readonly description: "Read bounded observed and declared relations from the latest canonical snapshot.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly kind: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+    };
+}, {
+    readonly name: "docbridge.run";
+    readonly title: "Read workflow state";
+    readonly description: "Read the latest resumable workflow state and artifact references.";
+    readonly annotations: {
+        readonly readOnlyHint: true;
+    };
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "docbridge.proposals";
+    readonly title: "Read or approve proposals";
+    readonly description: "Create, inspect, approve and apply deterministic proposals through the shared human-gated workflow.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "propose-links", "propose-normalize", "suggest", "approve", "apply"];
+            };
+            readonly proposalHash: {
+                readonly type: "string";
+            };
+            readonly artifactPath: {
+                readonly type: "string";
+            };
+            readonly approvedBy: {
+                readonly type: "string";
+            };
+            readonly proposal: {
+                readonly type: "object";
+            };
+        };
+    };
 }];
 declare const handleMcpRequest: (ctx: McpContext, request: JsonRpcRequest) => unknown;
+type StdioFraming = 'content-length' | 'json-line';
+declare const respondMcpRequest: (ctx: McpContext, request: JsonRpcRequest, framing: StdioFraming) => Promise<void>;
 declare const startMcpStdioServer: (ctx: McpContext) => void;
 
 type McpInstallTarget = 'cursor' | 'claude';
@@ -1775,7 +3709,11 @@ declare const defaultPromotionDraftPath: (root: string) => string;
 declare const writePromotionDraft: (root: string, draft: MemoryPromotionDraft, path?: string) => string;
 declare const promoteMemoryToGithubPr: (root: string, draft: MemoryPromotionDraft, options?: GithubPrOptions) => GithubPrResult;
 
+declare const canonicalJsonV1: (payload: unknown) => string;
 declare const sha256NormalizedV1: (payload: unknown) => string;
+declare const contentHashForArtifactV1: <T extends {
+    readonly contentHash: string;
+}>(artifact: T) => string;
 
 declare class IndexNotFoundError extends Error {
     readonly path: string;
@@ -1845,7 +3783,7 @@ declare const chunksFromMarkdown: (property: string, raw: string, sourceUrl: str
 declare const loadFederatedChunks: (root: string, config: DocBridgeConfigV1, options?: FederatedRetrieverOptions) => Promise<DocBridgeRetrievedChunk[]>;
 declare const retrieveHybridChunks: (root: string, config: DocBridgeConfigV1, index: DocBridgeIndexV1, query: string, options?: FederatedRetrieverOptions) => Promise<DocBridgeRetrievedChunk[]>;
 
-declare const PACKAGE_VERSION = "1.4.3";
+declare const PACKAGE_VERSION = "1.5.0";
 
 type FrontmatterValue = string | boolean | readonly string[];
 type FrontmatterData = Record<string, FrontmatterValue>;
@@ -1962,4 +3900,4 @@ declare const docBridgePatternPayload: () => {
     cli: "ak-docs";
 };
 
-export { AgentHandoffLegacySchema, type AgentHandoffV1, AgentHandoffV1JsonSchema, AgentHandoffV1Schema, type AgentSearchV1, AgentSearchV1Schema, type BuildIndexOptions, type BuildIndexResult, DOCUMENTATION_STANDARD_V1_ID, DOCUMENTATION_STANDARD_V1_STATUS, DOC_BRIDGE_PATTERN_ID, DOC_BRIDGE_PATTERN_META, DocBridgeConfigV1, type DocBridgeIndexV1, DocBridgeIndexV1JsonSchema, DocBridgeIndexV1Schema, DocBridgeJsonSchemas, type DocBridgeRetrievedChunk, type DocBridgeRetriever, type DocBridgeRetrieverOptions, type DoctorBadgeMetrics, type DoctorCoverage, type DoctorIssue, type DoctorReport, type DocumentationConformanceReportV1, type DocumentationStandardEvidence, type DocumentationStandardRemediation, DocumentationStandardRuleId, type DocumentationStandardRuleLevel, type DocumentationStandardRuleResult, type DocumentationStandardRuleStatus, type EcosystemLlmsProduct, type FederatedRetrieverOptions, type FetchText, type FormatEcosystemLlmsBlockOptions, type GateId, type GateResult, type GateRunResult, type GithubPrOptions, type GithubPrResult, HANDOFF_SCHEMA_VERSION, type HandoffBridge, HandoffBridgeSchema, type HandoffTarget, type HandoffTargetType, HandoffTargetTypeSchema, type HumanDocMap, type HumanDocRecord, INDEX_SCHEMA_VERSION, IndexNotFoundError, type KnowledgeEntry, KnowledgeEntrySchema, MCP_TOOLS, MEMORY_CANDIDATE_SCHEMA_VERSION, type McpInstallResult, type McpInstallTarget, type MemoryCandidateV1, MemoryCandidateV1JsonSchema, MemoryCandidateV1Schema, type MemoryClassification, type MemoryPromotionDraft, type MemoryRoute, PACKAGE_VERSION, type ParseIssue, type ParseResult, PeerMissingError, type QueryKind, type QueryRequest, type QueryResult, type SafetyFinding, type SearchMatch, type WatchIndexOptions, buildDocBridgeIndex, buildLookup, chunksFromMarkdown, classifyMemoryCandidates, collectPackages, createDocBridgeRag, createDocBridgeRetriever, defaultPromotionDraftPath, discoverNxProjects, docBridgePatternMarkdown, docBridgePatternPayload, doctorBadgeMetrics, draftMemoryPromotion, formatDoctorBadgeJson, formatDoctorBadgeMarkdown, formatDoctorText, formatDocumentationStandardText, formatEcosystemLlmsBlock, formatEcosystemLlmsSection, handleMcpRequest, indexFilePath, ingestAgentMemory, ingestCursorRules, ingestMemoryCandidates, installMcpConfig, layer1InstallHint, loadDocBridgeIndex, loadFederatedChunks, mcpSnippet, normalizeAgentHandoff, parseAgentHandoff, parseAgentSearch, parseDocBridgeConfig, parseDocBridgeIndex, parseLlmsTxtLinks, parseMemoryCandidate, promoteMemoryToGithubPr, resolveGateIds, resolveRoot, retrieveDocBridgeChunks, retrieveHybridChunks, runChatOnce, runDoctor, runDocumentationStandardV1, runGate, runGates, runQuery, safeParseAgentHandoff, scanHumanDocRecords, scanHumanDocs, scanMemorySafety, searchIndex, sha256NormalizedV1, startInkChat, startMcpStdioServer, watchDocBridgeIndex, writePromotionDraft };
+export { AffectedFileSchema, AgentHandoffLegacySchema, type AgentHandoffV1, AgentHandoffV1JsonSchema, AgentHandoffV1Schema, type AgentProposalV1, AgentProposalV1Schema, type AgentSearchV1, AgentSearchV1Schema, type BuildIndexOptions, type BuildIndexResult, CoverageSchema, DEFAULT_REGISTRY_AGENT_ID, DEFAULT_SAFETY_EXCLUDES, DOCUMENTATION_STANDARD_V1_ID, DOCUMENTATION_STANDARD_V1_STATUS, DOC_BRIDGE_PATTERN_ID, DOC_BRIDGE_PATTERN_META, type DiagnosticSeverity, DiagnosticSeveritySchema, type DiscoveryOptions, type DiscoverySnapshotV1, DiscoverySnapshotV1Schema, DocBridgeConfigV1, type DocBridgeIndexV1, DocBridgeIndexV1JsonSchema, DocBridgeIndexV1Schema, DocBridgeJsonSchemas, type DocBridgeRetrievedChunk, type DocBridgeRetriever, type DocBridgeRetrieverOptions, type DoctorBadgeMetrics, type DoctorCoverage, type DoctorIssue, type DoctorReport, type DocumentationAnalysisResult, type DocumentationConformanceReportV1, type DocumentationDeclarationInput, type DocumentationDeclarationOptions, type DocumentationDeclarationResult, type DocumentationDiagnostic, type DocumentationStandardEvidence, type DocumentationStandardRemediation, DocumentationStandardRuleId, type DocumentationStandardRuleLevel, type DocumentationStandardRuleResult, type DocumentationStandardRuleStatus, type EcosystemLlmsProduct, EntitySchema, type Evidence, EvidenceSchema, EvidenceSourceSchema, type FederatedRetrieverOptions, type FetchText, type FindingStatus, FindingStatusSchema, type FixApplyOptions, type FixChange, FixChangeSchema, type FixProposalOptions, FixProposalStatusSchema, type FixProposalV1, FixProposalV1Schema, type FormatEcosystemLlmsBlockOptions, type GateId, type GateResult, type GateRunResult, type GithubPrOptions, type GithubPrResult, HANDOFF_SCHEMA_VERSION, type HandoffBridge, HandoffBridgeSchema, type HandoffTarget, type HandoffTargetType, HandoffTargetTypeSchema, type HumanDocMap, type HumanDocRecord, INDEX_SCHEMA_VERSION, IndexNotFoundError, KNOWLEDGE_CONTENT_HASH_ALGO, KNOWLEDGE_SCHEMA_VERSION, type KnowledgeArtifactV1, type KnowledgeDiagnostic, type KnowledgeEntity, type KnowledgeEntry, KnowledgeEntrySchema, type KnowledgeRelation, MCP_TOOLS, MEMORY_CANDIDATE_SCHEMA_VERSION, type McpInstallResult, type McpInstallTarget, type MemoryCandidateV1, MemoryCandidateV1JsonSchema, MemoryCandidateV1Schema, type MemoryClassification, type MemoryPromotionDraft, type MemoryRoute, type OfflineReportInput, type OfflineReportOptions, PACKAGE_VERSION, type ParseIssue, type ParseResult, PeerMissingError, ProjectIdentitySchema, ProposalOriginSchema, type Provenance, ProvenanceSchema, type QueryKind, type QueryRequest, type QueryResult, type ReconciliationReportV1, ReconciliationReportV1Schema, type RegistryAgentAdapter, type RegistryAgentContext, type RegistryAgentMetadata, type RegistryAgentRunner, RelationSchema, type RuleEngineOptions, type RuleEvaluationResult, type RuleFinding, RuleId, type RuleMode, RuleSeverity, RulesConfig, type SafeWalkOptions, type SafeWalkResult, type SafetyFinding, type SearchMatch, WORKFLOW_STAGES, type WatchIndexOptions, type WorkflowExecutionResult, type WorkflowOptions, type WorkflowRunV1, WorkflowRunV1Schema, type WorkflowStage, type WorkflowStageContext, type WorkflowStageHandler, type WorkflowState, WorkflowStateSchema, WorkflowStepSchema, WorkflowTransitionSchema, applyDocumentationDeclarations, applyFixProposal, approveFixProposal, buildDocBridgeIndex, buildLookup, canonicalJsonV1, chunksFromMarkdown, classifyMemoryCandidates, collectPackages, containedPath, contentHashForArtifactV1, createArtifactNormalizationProposal, createDocBridgeRag, createDocBridgeRetriever, createMarkdownLinkFixProposal, createRegistryAgentAdapter, defaultPromotionDraftPath, discoverNxProjects, discoverRepository, docBridgePatternMarkdown, docBridgePatternPayload, doctorBadgeMetrics, draftMemoryPromotion, evaluateRules, formatDoctorBadgeJson, formatDoctorBadgeMarkdown, formatDoctorText, formatDocumentationStandardText, formatEcosystemLlmsBlock, formatEcosystemLlmsSection, handleMcpRequest, indexFilePath, ingestAgentMemory, ingestCursorRules, ingestMemoryCandidates, installMcpConfig, layer1InstallHint, loadDocBridgeIndex, loadFederatedChunks, loadRegistryAgentMetadata, loadRegistryAgentRunner, loadWorkflowManifest, loadWorkflowStepOutput, mcpSnippet, normalizeAgentHandoff, parseAgentHandoff, parseAgentProposal, parseAgentSearch, parseDiscoverySnapshot, parseDocBridgeConfig, parseDocBridgeIndex, parseDocumentationDeclarations, parseFixProposal, parseLlmsTxtLinks, parseMemoryCandidate, parseReconciliationReport, parseRuleId, parseRuleSeverity, parseWorkflowRun, persistRegistryAgentProposal, promoteMemoryToGithubPr, reconcileKnowledge, redactSecrets, redactValue, renderOfflineReport, resolveGateIds, resolveRoot, respondMcpRequest, retrieveDocBridgeChunks, retrieveHybridChunks, runChatOnce, runDoctor, runDocumentationStandardV1, runGate, runGates, runQuery, runWorkflow, safeParseAgentHandoff, safeWalkFiles, scanHumanDocRecords, scanHumanDocs, scanMemorySafety, searchIndex, sha256NormalizedV1, startInkChat, startMcpStdioServer, watchDocBridgeIndex, writePromotionDraft };