@agentskit/doc-bridge 1.7.44 → 1.9.0

package/dist/index-Beor6Yhi.d.ts

@@ -0,0 +1,792 @@
+import { z } from 'zod';
+
+declare const AgentCorpusConfigSchema: z.ZodObject<{
+    root: z.ZodString;
+    index: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    okf: z.ZodOptional<z.ZodObject<{
+        requireType: z.ZodOptional<z.ZodBoolean>;
+        allowedTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const HumanCorpusConfigSchema: z.ZodObject<{
+    plugin: z.ZodEnum<{
+        "plain-markdown": "plain-markdown";
+        fumadocs: "fumadocs";
+        docusaurus: "docusaurus";
+        mkdocs: "mkdocs";
+        vitepress: "vitepress";
+        starlight: "starlight";
+        nextra: "nextra";
+        custom: "custom";
+    }>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+declare const RuleIdSchema: z.ZodEnum<{
+    ownership: "ownership";
+    "documentation-quality": "documentation-quality";
+    "graph-undocumented-relation": "graph-undocumented-relation";
+    "declared-unobserved-relation": "declared-unobserved-relation";
+    "unresolved-reference": "unresolved-reference";
+    "conflicting-declaration": "conflicting-declaration";
+    "not-analyzed-coverage": "not-analyzed-coverage";
+    "stale-documentation": "stale-documentation";
+    "centrality-risk": "centrality-risk";
+    "critical-path-risk": "critical-path-risk";
+    freshness: "freshness";
+}>;
+declare const RuleSeveritySchema: z.ZodEnum<{
+    error: "error";
+    off: "off";
+    info: "info";
+    warn: "warn";
+}>;
+declare const RulesConfigSchema: z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        strict: "strict";
+        recommended: "recommended";
+    }>>;
+    severity: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        ownership: "ownership";
+        "documentation-quality": "documentation-quality";
+        "graph-undocumented-relation": "graph-undocumented-relation";
+        "declared-unobserved-relation": "declared-unobserved-relation";
+        "unresolved-reference": "unresolved-reference";
+        "conflicting-declaration": "conflicting-declaration";
+        "not-analyzed-coverage": "not-analyzed-coverage";
+        "stale-documentation": "stale-documentation";
+        "centrality-risk": "centrality-risk";
+        "critical-path-risk": "critical-path-risk";
+        freshness: "freshness";
+    }> & z.core.$partial, z.ZodEnum<{
+        error: "error";
+        off: "off";
+        info: "info";
+        warn: "warn";
+    }>>>;
+    ignore: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        ownership: "ownership";
+        "documentation-quality": "documentation-quality";
+        "graph-undocumented-relation": "graph-undocumented-relation";
+        "declared-unobserved-relation": "declared-unobserved-relation";
+        "unresolved-reference": "unresolved-reference";
+        "conflicting-declaration": "conflicting-declaration";
+        "not-analyzed-coverage": "not-analyzed-coverage";
+        "stale-documentation": "stale-documentation";
+        "centrality-risk": "centrality-risk";
+        "critical-path-risk": "critical-path-risk";
+        freshness: "freshness";
+    }>>>;
+    criticalEntities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    warningThresholds: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        ownership: "ownership";
+        "documentation-quality": "documentation-quality";
+        "graph-undocumented-relation": "graph-undocumented-relation";
+        "declared-unobserved-relation": "declared-unobserved-relation";
+        "unresolved-reference": "unresolved-reference";
+        "conflicting-declaration": "conflicting-declaration";
+        "not-analyzed-coverage": "not-analyzed-coverage";
+        "stale-documentation": "stale-documentation";
+        "centrality-risk": "centrality-risk";
+        "critical-path-risk": "critical-path-risk";
+        freshness: "freshness";
+    }> & z.core.$partial, z.ZodNumber>>;
+}, z.core.$strict>;
+declare const ReconciliationConfigSchema: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        module: "module";
+        area: "area";
+        package: "package";
+    }>>;
+    requiredRelationKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredRelationTargets: z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        internal: "internal";
+    }>>;
+    includeOrphanedDocuments: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const DocumentationAuditConfigSchema: z.ZodObject<{
+    criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    generatedPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    minWords: z.ZodOptional<z.ZodNumber>;
+    requiredSections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requireExamples: z.ZodOptional<z.ZodBoolean>;
+    exactDuplicates: z.ZodOptional<z.ZodBoolean>;
+    defaultTier: z.ZodOptional<z.ZodEnum<{
+        "tier-0": "tier-0";
+        "tier-1": "tier-1";
+        "tier-2": "tier-2";
+    }>>;
+    tierRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pattern: z.ZodString;
+        tier: z.ZodEnum<{
+            "tier-0": "tier-0";
+            "tier-1": "tier-1";
+            "tier-2": "tier-2";
+        }>;
+        critical: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    requiredCriticalMetadata: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        owner: "owner";
+        lifecycle: "lifecycle";
+        sourceOfTruth: "sourceOfTruth";
+        validationPath: "validationPath";
+    }>>>;
+}, z.core.$strict>;
+declare const WorkflowConfigSchema: z.ZodObject<{
+    stateDir: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const RepositorySafetyConfigSchema: z.ZodObject<{
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxFiles: z.ZodOptional<z.ZodNumber>;
+    maxBytes: z.ZodOptional<z.ZodNumber>;
+    maxTimeMs: z.ZodOptional<z.ZodNumber>;
+    maxMemoryMb: z.ZodOptional<z.ZodNumber>;
+    redactSecrets: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+declare const ReportConfigSchema: z.ZodObject<{
+    privacy: z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        anonymized: "anonymized";
+    }>>;
+}, z.core.$strict>;
+declare const EcosystemContractEvidenceSchema: z.ZodObject<{
+    manifest: z.ZodString;
+    claims: z.ZodString;
+    productId: z.ZodString;
+}, z.core.$strict>;
+declare const DocumentationStandardRuleIdSchema: z.ZodEnum<{
+    "human-docs": "human-docs";
+    "llms-and-raw-source": "llms-and-raw-source";
+    "agent-handoffs": "agent-handoffs";
+    contribution: "contribution";
+    metadata: "metadata";
+    "cross-links": "cross-links";
+    "tested-quickstarts": "tested-quickstarts";
+    "visual-explanations": "visual-explanations";
+    "structured-diagrams": "structured-diagrams";
+}>;
+declare const DocumentationStandardV1ConfigSchema: z.ZodObject<{
+    rawSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        contains: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        paths: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        doc: z.ZodString;
+        test: z.ZodString;
+        command: z.ZodString;
+        testContains: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    visuals: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        contains: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    ecosystemContract: z.ZodOptional<z.ZodObject<{
+        manifest: z.ZodString;
+        claims: z.ZodString;
+        productId: z.ZodString;
+    }, z.core.$strict>>;
+    exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ruleId: z.ZodEnum<{
+            "human-docs": "human-docs";
+            "llms-and-raw-source": "llms-and-raw-source";
+            "agent-handoffs": "agent-handoffs";
+            contribution: "contribution";
+            metadata: "metadata";
+            "cross-links": "cross-links";
+            "tested-quickstarts": "tested-quickstarts";
+            "visual-explanations": "visual-explanations";
+            "structured-diagrams": "structured-diagrams";
+        }>;
+        reason: z.ZodString;
+        approvedBy: z.ZodString;
+        trackingUrl: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * Retrieval tuning. Weights and parameters are configuration rather than code so a repository can
+ * change what its agents find first without a release, and so the change is recorded in the index.
+ */
+declare const RetrievalConfigSchema: z.ZodObject<{
+    corpus: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    weights: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    params: z.ZodOptional<z.ZodObject<{
+        k1: z.ZodOptional<z.ZodNumber>;
+        b: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    benchmark: z.ZodOptional<z.ZodObject<{
+        suite: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const ConformanceConfigSchema: z.ZodObject<{
+    documentationStandardV1: z.ZodOptional<z.ZodObject<{
+        rawSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            contains: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            paths: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>>;
+        quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            doc: z.ZodString;
+            test: z.ZodString;
+            command: z.ZodString;
+            testContains: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>>;
+        visuals: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            contains: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>>;
+        ecosystemContract: z.ZodOptional<z.ZodObject<{
+            manifest: z.ZodString;
+            claims: z.ZodString;
+            productId: z.ZodString;
+        }, z.core.$strict>>;
+        exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            ruleId: z.ZodEnum<{
+                "human-docs": "human-docs";
+                "llms-and-raw-source": "llms-and-raw-source";
+                "agent-handoffs": "agent-handoffs";
+                contribution: "contribution";
+                metadata: "metadata";
+                "cross-links": "cross-links";
+                "tested-quickstarts": "tested-quickstarts";
+                "visual-explanations": "visual-explanations";
+                "structured-diagrams": "structured-diagrams";
+            }>;
+            reason: z.ZodString;
+            approvedBy: z.ZodString;
+            trackingUrl: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const DocBridgeConfigV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    project: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        root: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    corpus: z.ZodObject<{
+        agent: z.ZodObject<{
+            root: z.ZodString;
+            index: z.ZodOptional<z.ZodString>;
+            include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            okf: z.ZodOptional<z.ZodObject<{
+                requireType: z.ZodOptional<z.ZodBoolean>;
+                allowedTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        human: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            plugin: z.ZodEnum<{
+                "plain-markdown": "plain-markdown";
+                fumadocs: "fumadocs";
+                docusaurus: "docusaurus";
+                mkdocs: "mkdocs";
+                vitepress: "vitepress";
+                starlight: "starlight";
+                nextra: "nextra";
+                custom: "custom";
+            }>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>, z.ZodArray<z.ZodObject<{
+            plugin: z.ZodEnum<{
+                "plain-markdown": "plain-markdown";
+                fumadocs: "fumadocs";
+                docusaurus: "docusaurus";
+                mkdocs: "mkdocs";
+                vitepress: "vitepress";
+                starlight: "starlight";
+                nextra: "nextra";
+                custom: "custom";
+            }>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>]>>;
+    }, z.core.$strict>;
+    index: z.ZodOptional<z.ZodObject<{
+        outFile: z.ZodOptional<z.ZodString>;
+        llmsTxt: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            outFile: z.ZodOptional<z.ZodString>;
+            preamble: z.ZodOptional<z.ZodString>;
+            urlPrefix: z.ZodOptional<z.ZodString>;
+            pathPrefix: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        capabilities: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            outFile: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        contentHash: z.ZodOptional<z.ZodLiteral<"sha256-normalized-v1">>;
+    }, z.core.$strict>>;
+    routing: z.ZodOptional<z.ZodObject<{
+        plugin: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            "pnpm-monorepo": "pnpm-monorepo";
+            "npm-workspaces": "npm-workspaces";
+            "yarn-workspaces": "yarn-workspaces";
+            nx: "nx";
+            "pattern-files": "pattern-files";
+        }>>;
+        options: z.ZodOptional<z.ZodObject<{
+            packages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            ownershipFromCorpus: z.ZodOptional<z.ZodBoolean>;
+            ownership: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                path: z.ZodString;
+                group: z.ZodOptional<z.ZodString>;
+                layer: z.ZodOptional<z.ZodString>;
+                purpose: z.ZodOptional<z.ZodString>;
+                checks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                agentDoc: z.ZodOptional<z.ZodString>;
+                humanDoc: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            intents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                paths: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+            changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                startHere: z.ZodString;
+                relatedPackages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    gates: z.ZodOptional<z.ZodObject<{
+        preset: z.ZodOptional<z.ZodEnum<{
+            minimal: "minimal";
+            standard: "standard";
+            strict: "strict";
+            playbook: "playbook";
+        }>>;
+        include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "index-freshness": "index-freshness";
+            "human-guide-links": "human-guide-links";
+            "link-rot": "link-rot";
+            "okf-type": "okf-type";
+            "docs-style": "docs-style";
+            "routing-currency": "routing-currency";
+            "bootstrap-size": "bootstrap-size";
+            "documentation-standard-v1": "documentation-standard-v1";
+        }>>>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            "index-freshness": "index-freshness";
+            "human-guide-links": "human-guide-links";
+            "link-rot": "link-rot";
+            "okf-type": "okf-type";
+            "docs-style": "docs-style";
+            "routing-currency": "routing-currency";
+            "bootstrap-size": "bootstrap-size";
+            "documentation-standard-v1": "documentation-standard-v1";
+        }>>>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>;
+    reconciliation: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            module: "module";
+            area: "area";
+            package: "package";
+        }>>;
+        requiredRelationKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requiredRelationTargets: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            internal: "internal";
+        }>>;
+        includeOrphanedDocuments: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    audit: z.ZodOptional<z.ZodObject<{
+        documentation: z.ZodOptional<z.ZodObject<{
+            criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            generatedPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            minWords: z.ZodOptional<z.ZodNumber>;
+            requiredSections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requireExamples: z.ZodOptional<z.ZodBoolean>;
+            exactDuplicates: z.ZodOptional<z.ZodBoolean>;
+            defaultTier: z.ZodOptional<z.ZodEnum<{
+                "tier-0": "tier-0";
+                "tier-1": "tier-1";
+                "tier-2": "tier-2";
+            }>>;
+            tierRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                pattern: z.ZodString;
+                tier: z.ZodEnum<{
+                    "tier-0": "tier-0";
+                    "tier-1": "tier-1";
+                    "tier-2": "tier-2";
+                }>;
+                critical: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            requiredCriticalMetadata: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                owner: "owner";
+                lifecycle: "lifecycle";
+                sourceOfTruth: "sourceOfTruth";
+                validationPath: "validationPath";
+            }>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    analysis: z.ZodOptional<z.ZodObject<{
+        plugins: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            order: z.ZodOptional<z.ZodNumber>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        jsTs: z.ZodOptional<z.ZodObject<{
+            runtimeWiringMethods: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            runtimeWiringAdapters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                methods: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+            includeTestRuntimeWiring: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        areas: z.ZodOptional<z.ZodObject<{
+            depth: z.ZodOptional<z.ZodNumber>;
+            roots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    rules: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            strict: "strict";
+            recommended: "recommended";
+        }>>;
+        severity: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            ownership: "ownership";
+            "documentation-quality": "documentation-quality";
+            "graph-undocumented-relation": "graph-undocumented-relation";
+            "declared-unobserved-relation": "declared-unobserved-relation";
+            "unresolved-reference": "unresolved-reference";
+            "conflicting-declaration": "conflicting-declaration";
+            "not-analyzed-coverage": "not-analyzed-coverage";
+            "stale-documentation": "stale-documentation";
+            "centrality-risk": "centrality-risk";
+            "critical-path-risk": "critical-path-risk";
+            freshness: "freshness";
+        }> & z.core.$partial, z.ZodEnum<{
+            error: "error";
+            off: "off";
+            info: "info";
+            warn: "warn";
+        }>>>;
+        ignore: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            ownership: "ownership";
+            "documentation-quality": "documentation-quality";
+            "graph-undocumented-relation": "graph-undocumented-relation";
+            "declared-unobserved-relation": "declared-unobserved-relation";
+            "unresolved-reference": "unresolved-reference";
+            "conflicting-declaration": "conflicting-declaration";
+            "not-analyzed-coverage": "not-analyzed-coverage";
+            "stale-documentation": "stale-documentation";
+            "centrality-risk": "centrality-risk";
+            "critical-path-risk": "critical-path-risk";
+            freshness: "freshness";
+        }>>>;
+        criticalEntities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        warningThresholds: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            ownership: "ownership";
+            "documentation-quality": "documentation-quality";
+            "graph-undocumented-relation": "graph-undocumented-relation";
+            "declared-unobserved-relation": "declared-unobserved-relation";
+            "unresolved-reference": "unresolved-reference";
+            "conflicting-declaration": "conflicting-declaration";
+            "not-analyzed-coverage": "not-analyzed-coverage";
+            "stale-documentation": "stale-documentation";
+            "centrality-risk": "centrality-risk";
+            "critical-path-risk": "critical-path-risk";
+            freshness: "freshness";
+        }> & z.core.$partial, z.ZodNumber>>;
+    }, z.core.$strict>>;
+    workflow: z.ZodOptional<z.ZodObject<{
+        stateDir: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    safety: z.ZodOptional<z.ZodObject<{
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxFiles: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        maxTimeMs: z.ZodOptional<z.ZodNumber>;
+        maxMemoryMb: z.ZodOptional<z.ZodNumber>;
+        redactSecrets: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    report: z.ZodOptional<z.ZodObject<{
+        privacy: z.ZodOptional<z.ZodEnum<{
+            private: "private";
+            anonymized: "anonymized";
+        }>>;
+    }, z.core.$strict>>;
+    surfaces: z.ZodOptional<z.ZodObject<{
+        cli: z.ZodOptional<z.ZodObject<{
+            bin: z.ZodOptional<z.ZodString>;
+            defaultFormat: z.ZodOptional<z.ZodEnum<{
+                json: "json";
+                text: "text";
+            }>>;
+        }, z.core.$strict>>;
+        mcp: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "handoff.resolve": "handoff.resolve";
+                "doc.search": "doc.search";
+                "doc.get": "doc.get";
+                "gate.status": "gate.status";
+                "playbook.pattern.get": "playbook.pattern.get";
+                "retriever.query": "retriever.query";
+                "memory.classify": "memory.classify";
+                "memory.promoteDraft": "memory.promoteDraft";
+                "registry.topology": "registry.topology";
+                "docbridge.snapshot": "docbridge.snapshot";
+                "docbridge.report": "docbridge.report";
+                "docbridge.diagnostics": "docbridge.diagnostics";
+                "docbridge.relations": "docbridge.relations";
+                "docbridge.run": "docbridge.run";
+                "docbridge.proposals": "docbridge.proposals";
+                "knowledge.search": "knowledge.search";
+                "knowledge.lookup": "knowledge.lookup";
+            }>>>;
+            transport: z.ZodOptional<z.ZodEnum<{
+                stdio: "stdio";
+                http: "http";
+            }>>;
+            http: z.ZodOptional<z.ZodObject<{
+                port: z.ZodOptional<z.ZodNumber>;
+                path: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    intelligence: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        adapter: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodEnum<{
+                custom: "custom";
+                openai: "openai";
+                anthropic: "anthropic";
+                ollama: "ollama";
+                openrouter: "openrouter";
+            }>;
+            model: z.ZodOptional<z.ZodString>;
+            apiKeyEnv: z.ZodOptional<z.ZodString>;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>;
+        chat: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                agent: "agent";
+                human: "human";
+                federation: "federation";
+            }>>>;
+            handoffFirst: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        retriever: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            mode: z.ZodOptional<z.ZodEnum<{
+                local: "local";
+                remote: "remote";
+                bm25: "bm25";
+                "agentskit-rag": "agentskit-rag";
+            }>>;
+            embedModel: z.ZodOptional<z.ZodString>;
+            chunkSize: z.ZodOptional<z.ZodNumber>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>;
+        memory: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            adapters: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                "playbook-memory": "playbook-memory";
+                "cursor-rules": "cursor-rules";
+                "session-export": "session-export";
+                "bootstrap-delta": "bootstrap-delta";
+            }>>>;
+            ingestDir: z.ZodOptional<z.ZodString>;
+            classify: z.ZodOptional<z.ZodBoolean>;
+            promote: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    agent: "agent";
+                    human: "human";
+                    "agents-md": "agents-md";
+                }>>>;
+                requireApproval: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        runtime: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            agentskit: "agentskit";
+        }>>;
+        runtimeModule: z.ZodOptional<z.ZodString>;
+        registry: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            agentId: z.ZodOptional<z.ZodString>;
+            agentRoot: z.ZodOptional<z.ZodString>;
+            runnerModule: z.ZodOptional<z.ZodString>;
+            cli: z.ZodOptional<z.ZodObject<{
+                command: z.ZodString;
+                args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            deterministic: z.ZodOptional<z.ZodBoolean>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxInputBytes: z.ZodOptional<z.ZodNumber>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+            maxResponseBytes: z.ZodOptional<z.ZodNumber>;
+            maxConcurrency: z.ZodOptional<z.ZodNumber>;
+            maxPackBytes: z.ZodOptional<z.ZodNumber>;
+            roles: z.ZodOptional<z.ZodObject<{
+                curator: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    agentId: z.ZodOptional<z.ZodString>;
+                    promptVersion: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                reviewer: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    agentId: z.ZodOptional<z.ZodString>;
+                    promptVersion: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                adjudicator: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    agentId: z.ZodOptional<z.ZodString>;
+                    promptVersion: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    federation: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            llmsTxt: z.ZodOptional<z.ZodString>;
+            rawBaseUrl: z.ZodOptional<z.ZodString>;
+            includeInRetriever: z.ZodOptional<z.ZodBoolean>;
+            includeInChat: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    conformance: z.ZodOptional<z.ZodObject<{
+        documentationStandardV1: z.ZodOptional<z.ZodObject<{
+            rawSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                contains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                url: z.ZodString;
+                paths: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+            quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                doc: z.ZodString;
+                test: z.ZodString;
+                command: z.ZodString;
+                testContains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+            visuals: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                contains: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+            ecosystemContract: z.ZodOptional<z.ZodObject<{
+                manifest: z.ZodString;
+                claims: z.ZodString;
+                productId: z.ZodString;
+            }, z.core.$strict>>;
+            exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                ruleId: z.ZodEnum<{
+                    "human-docs": "human-docs";
+                    "llms-and-raw-source": "llms-and-raw-source";
+                    "agent-handoffs": "agent-handoffs";
+                    contribution: "contribution";
+                    metadata: "metadata";
+                    "cross-links": "cross-links";
+                    "tested-quickstarts": "tested-quickstarts";
+                    "visual-explanations": "visual-explanations";
+                    "structured-diagrams": "structured-diagrams";
+                }>;
+                reason: z.ZodString;
+                approvedBy: z.ZodString;
+                trackingUrl: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    retrieval: z.ZodOptional<z.ZodObject<{
+        corpus: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        weights: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        params: z.ZodOptional<z.ZodObject<{
+            k1: z.ZodOptional<z.ZodNumber>;
+            b: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        benchmark: z.ZodOptional<z.ZodObject<{
+            suite: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    render: z.ZodOptional<z.ZodObject<{
+        templates: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            ownership: "ownership";
+            area: "area";
+            "llms.txt": "llms.txt";
+            "change-digest": "change-digest";
+            "overlay-review": "overlay-review";
+        }> & z.core.$partial, z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type DocBridgeConfigV1 = z.infer<typeof DocBridgeConfigV1Schema>;
+type AgentCorpusConfig = z.infer<typeof AgentCorpusConfigSchema>;
+type DocumentationStandardV1Config = z.infer<typeof DocumentationStandardV1ConfigSchema>;
+type DocumentationStandardRuleId = z.infer<typeof DocumentationStandardRuleIdSchema>;
+type ReconciliationConfig = z.infer<typeof ReconciliationConfigSchema>;
+type DocumentationAuditConfig = z.infer<typeof DocumentationAuditConfigSchema>;
+type RuleId = z.infer<typeof RuleIdSchema>;
+type RuleSeverity = z.infer<typeof RuleSeveritySchema>;
+type RulesConfig = z.infer<typeof RulesConfigSchema>;
+type WorkflowConfig = z.infer<typeof WorkflowConfigSchema>;
+type RepositorySafetyConfig = z.infer<typeof RepositorySafetyConfigSchema>;
+type ReportConfig = z.infer<typeof ReportConfigSchema>;
+type RetrievalConfig = z.infer<typeof RetrievalConfigSchema>;
+
+/** Type-safe config helper for `doc-bridge.config.ts`. */
+declare const defineConfig: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
+
+declare const applyConfigDefaults: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
+
+type LoadConfigOptions = {
+    readonly cwd?: string;
+    readonly explicitPath?: string;
+};
+type LoadConfigResult = {
+    readonly config: DocBridgeConfigV1;
+    readonly path: string;
+};
+declare class ConfigNotFoundError extends Error {
+    readonly cwd: string;
+    constructor(cwd: string);
+}
+/** v0.1 — static JS/TS config, JSON config files, and package.json#docBridge. */
+declare const loadConfig: (opts?: LoadConfigOptions) => LoadConfigResult;
+declare const resolveProjectRoot: (start?: string) => string;
+/** Project root for a loaded config file path (directory of the config). */
+declare const projectRootFromConfigPath: (configFilePath: string, projectRootField?: string) => string;
+
+export { type AgentCorpusConfig as A, ReconciliationConfigSchema as B, ConfigNotFoundError as C, type DocBridgeConfigV1 as D, EcosystemContractEvidenceSchema as E, type RetrievalConfig as F, RetrievalConfigSchema as G, HumanCorpusConfigSchema as H, type LoadConfigOptions as L, type RulesConfig as R, type WorkflowConfig as W, type DocumentationAuditConfig as a, type RuleId as b, type RuleSeverity as c, type DocumentationStandardRuleId as d, DocBridgeConfigV1Schema as e, DocumentationAuditConfigSchema as f, DocumentationStandardRuleIdSchema as g, type DocumentationStandardV1Config as h, DocumentationStandardV1ConfigSchema as i, type LoadConfigResult as j, type ReportConfig as k, ReportConfigSchema as l, type RepositorySafetyConfig as m, RepositorySafetyConfigSchema as n, RuleIdSchema as o, RuleSeveritySchema as p, RulesConfigSchema as q, WorkflowConfigSchema as r, applyConfigDefaults as s, defineConfig as t, loadConfig as u, projectRootFromConfigPath as v, resolveProjectRoot as w, AgentCorpusConfigSchema as x, ConformanceConfigSchema as y, type ReconciliationConfig as z };