@agentskit/doc-bridge 1.4.1 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/action.yml +1 -1
  3. package/dist/cli/program.js +2461 -274
  4. package/dist/cli/program.js.map +1 -1
  5. package/dist/config/index.d.ts +1 -1
  6. package/dist/config/index.js +77 -4
  7. package/dist/config/index.js.map +1 -1
  8. package/dist/{index-DAeq_OIi.d.ts → index-Di7PkJuf.d.ts} +209 -8
  9. package/dist/index.d.ts +1942 -4
  10. package/dist/index.js +2190 -193
  11. package/dist/index.js.map +1 -1
  12. package/docs/PRD-doc-bridge-knowledge-engine.md +338 -0
  13. package/docs/knowledge-engine-runbook.md +44 -0
  14. package/ecosystem-claims.json +19 -19
  15. package/ecosystem-upstream.json +2 -2
  16. package/ecosystem.json +117 -109
  17. package/mcpb/manifest.json +25 -1
  18. package/package.json +2 -2
  19. package/skills/doc-bridge-handoff/scripts/resolve-handoff.mjs +1 -1
  20. package/src/agents/registry-adapter.ts +97 -0
  21. package/src/cli/program.ts +285 -3
  22. package/src/config/defaults.ts +14 -1
  23. package/src/config/schema.ts +69 -0
  24. package/src/conformance/ecosystem-contract.ts +6 -3
  25. package/src/discovery/documentation.ts +320 -0
  26. package/src/discovery/repository.ts +514 -0
  27. package/src/fixes/proposals.ts +165 -0
  28. package/src/index-builder/content-hash.ts +9 -2
  29. package/src/index-builder/human-adapters/plain-markdown.ts +17 -1
  30. package/src/index-builder/llms-txt.ts +22 -2
  31. package/src/index-builder/scan-corpus.ts +17 -1
  32. package/src/index.ts +99 -2
  33. package/src/mcp/server.ts +178 -8
  34. package/src/reconciliation/reconcile.ts +227 -0
  35. package/src/report/html.ts +74 -0
  36. package/src/rules/engine.ts +180 -0
  37. package/src/safety/repository.ts +84 -0
  38. package/src/schemas/knowledge.ts +315 -0
  39. package/src/validate.ts +24 -0
  40. package/src/version.ts +1 -1
  41. package/src/workflow/engine.ts +238 -0
  42. package/tsup.config.ts +2 -1
package/dist/{index-DAeq_OIi.d.ts → index-Di7PkJuf.d.ts} RENAMED
@@ -44,6 +44,59 @@ declare const HumanCorpusConfigSchema: z.ZodObject<{
44
44
  plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
45
45
  options?: Record<string, unknown> | undefined;
46
46
  }>;
47
+ declare const RuleIdSchema: z.ZodEnum<["documentation-quality", "graph-undocumented-relation", "declared-unobserved-relation", "unresolved-reference", "conflicting-declaration", "not-analyzed-coverage", "stale-documentation", "centrality-risk", "critical-path-risk", "freshness", "ownership"]>;
48
+ declare const RuleSeveritySchema: z.ZodEnum<["off", "info", "warn", "error"]>;
49
+ declare const RulesConfigSchema: z.ZodObject<{
50
+ mode: z.ZodOptional<z.ZodEnum<["default", "recommended", "strict"]>>;
51
+ severity: z.ZodOptional<z.ZodRecord<z.ZodEnum<["documentation-quality", "graph-undocumented-relation", "declared-unobserved-relation", "unresolved-reference", "conflicting-declaration", "not-analyzed-coverage", "stale-documentation", "centrality-risk", "critical-path-risk", "freshness", "ownership"]>, z.ZodEnum<["off", "info", "warn", "error"]>>>;
52
+ ignore: z.ZodOptional<z.ZodArray<z.ZodEnum<["documentation-quality", "graph-undocumented-relation", "declared-unobserved-relation", "unresolved-reference", "conflicting-declaration", "not-analyzed-coverage", "stale-documentation", "centrality-risk", "critical-path-risk", "freshness", "ownership"]>, "many">>;
53
+ criticalEntities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
54
+ criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
55
+ warningThresholds: z.ZodOptional<z.ZodRecord<z.ZodEnum<["documentation-quality", "graph-undocumented-relation", "declared-unobserved-relation", "unresolved-reference", "conflicting-declaration", "not-analyzed-coverage", "stale-documentation", "centrality-risk", "critical-path-risk", "freshness", "ownership"]>, z.ZodNumber>>;
56
+ }, "strict", z.ZodTypeAny, {
57
+ mode?: "strict" | "default" | "recommended" | undefined;
58
+ severity?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", "off" | "info" | "warn" | "error">> | undefined;
59
+ ignore?: ("ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness")[] | undefined;
60
+ criticalEntities?: string[] | undefined;
61
+ criticalPaths?: string[] | undefined;
62
+ warningThresholds?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", number>> | undefined;
63
+ }, {
64
+ mode?: "strict" | "default" | "recommended" | undefined;
65
+ severity?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", "off" | "info" | "warn" | "error">> | undefined;
66
+ ignore?: ("ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness")[] | undefined;
67
+ criticalEntities?: string[] | undefined;
68
+ criticalPaths?: string[] | undefined;
69
+ warningThresholds?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", number>> | undefined;
70
+ }>;
71
+ declare const WorkflowConfigSchema: z.ZodObject<{
72
+ stateDir: z.ZodOptional<z.ZodString>;
73
+ }, "strict", z.ZodTypeAny, {
74
+ stateDir?: string | undefined;
75
+ }, {
76
+ stateDir?: string | undefined;
77
+ }>;
78
+ declare const RepositorySafetyConfigSchema: z.ZodObject<{
79
+ exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
80
+ maxFiles: z.ZodOptional<z.ZodNumber>;
81
+ maxBytes: z.ZodOptional<z.ZodNumber>;
82
+ maxTimeMs: z.ZodOptional<z.ZodNumber>;
83
+ maxMemoryMb: z.ZodOptional<z.ZodNumber>;
84
+ redactSecrets: z.ZodOptional<z.ZodBoolean>;
85
+ }, "strict", z.ZodTypeAny, {
86
+ exclude?: string[] | undefined;
87
+ maxFiles?: number | undefined;
88
+ maxBytes?: number | undefined;
89
+ maxTimeMs?: number | undefined;
90
+ maxMemoryMb?: number | undefined;
91
+ redactSecrets?: boolean | undefined;
92
+ }, {
93
+ exclude?: string[] | undefined;
94
+ maxFiles?: number | undefined;
95
+ maxBytes?: number | undefined;
96
+ maxTimeMs?: number | undefined;
97
+ maxMemoryMb?: number | undefined;
98
+ redactSecrets?: boolean | undefined;
99
+ }>;
47
100
  declare const EcosystemContractEvidenceSchema: z.ZodObject<{
48
101
  manifest: z.ZodString;
49
102
  claims: z.ZodString;
@@ -679,14 +732,20 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
679
732
  enabled: z.ZodOptional<z.ZodBoolean>;
680
733
  outFile: z.ZodOptional<z.ZodString>;
681
734
  preamble: z.ZodOptional<z.ZodString>;
735
+ urlPrefix: z.ZodOptional<z.ZodString>;
736
+ pathPrefix: z.ZodOptional<z.ZodString>;
682
737
  }, "strict", z.ZodTypeAny, {
683
738
  outFile?: string | undefined;
684
739
  enabled?: boolean | undefined;
685
740
  preamble?: string | undefined;
741
+ urlPrefix?: string | undefined;
742
+ pathPrefix?: string | undefined;
686
743
  }, {
687
744
  outFile?: string | undefined;
688
745
  enabled?: boolean | undefined;
689
746
  preamble?: string | undefined;
747
+ urlPrefix?: string | undefined;
748
+ pathPrefix?: string | undefined;
690
749
  }>>;
691
750
  capabilities: z.ZodOptional<z.ZodObject<{
692
751
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -705,6 +764,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
705
764
  outFile?: string | undefined;
706
765
  enabled?: boolean | undefined;
707
766
  preamble?: string | undefined;
767
+ urlPrefix?: string | undefined;
768
+ pathPrefix?: string | undefined;
708
769
  } | undefined;
709
770
  capabilities?: {
710
771
  outFile?: string | undefined;
@@ -717,6 +778,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
717
778
  outFile?: string | undefined;
718
779
  enabled?: boolean | undefined;
719
780
  preamble?: string | undefined;
781
+ urlPrefix?: string | undefined;
782
+ pathPrefix?: string | undefined;
720
783
  } | undefined;
721
784
  capabilities?: {
722
785
  outFile?: string | undefined;
@@ -901,6 +964,57 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
901
964
  exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
902
965
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
903
966
  }>>;
967
+ rules: z.ZodOptional<z.ZodObject<{
968
+ mode: z.ZodOptional<z.ZodEnum<["default", "recommended", "strict"]>>;
969
+ severity: z.ZodOptional<z.ZodRecord<z.ZodEnum<["documentation-quality", "graph-undocumented-relation", "declared-unobserved-relation", "unresolved-reference", "conflicting-declaration", "not-analyzed-coverage", "stale-documentation", "centrality-risk", "critical-path-risk", "freshness", "ownership"]>, z.ZodEnum<["off", "info", "warn", "error"]>>>;
970
+ ignore: z.ZodOptional<z.ZodArray<z.ZodEnum<["documentation-quality", "graph-undocumented-relation", "declared-unobserved-relation", "unresolved-reference", "conflicting-declaration", "not-analyzed-coverage", "stale-documentation", "centrality-risk", "critical-path-risk", "freshness", "ownership"]>, "many">>;
971
+ criticalEntities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
972
+ criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
973
+ warningThresholds: z.ZodOptional<z.ZodRecord<z.ZodEnum<["documentation-quality", "graph-undocumented-relation", "declared-unobserved-relation", "unresolved-reference", "conflicting-declaration", "not-analyzed-coverage", "stale-documentation", "centrality-risk", "critical-path-risk", "freshness", "ownership"]>, z.ZodNumber>>;
974
+ }, "strict", z.ZodTypeAny, {
975
+ mode?: "strict" | "default" | "recommended" | undefined;
976
+ severity?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", "off" | "info" | "warn" | "error">> | undefined;
977
+ ignore?: ("ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness")[] | undefined;
978
+ criticalEntities?: string[] | undefined;
979
+ criticalPaths?: string[] | undefined;
980
+ warningThresholds?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", number>> | undefined;
981
+ }, {
982
+ mode?: "strict" | "default" | "recommended" | undefined;
983
+ severity?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", "off" | "info" | "warn" | "error">> | undefined;
984
+ ignore?: ("ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness")[] | undefined;
985
+ criticalEntities?: string[] | undefined;
986
+ criticalPaths?: string[] | undefined;
987
+ warningThresholds?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", number>> | undefined;
988
+ }>>;
989
+ workflow: z.ZodOptional<z.ZodObject<{
990
+ stateDir: z.ZodOptional<z.ZodString>;
991
+ }, "strict", z.ZodTypeAny, {
992
+ stateDir?: string | undefined;
993
+ }, {
994
+ stateDir?: string | undefined;
995
+ }>>;
996
+ safety: z.ZodOptional<z.ZodObject<{
997
+ exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
998
+ maxFiles: z.ZodOptional<z.ZodNumber>;
999
+ maxBytes: z.ZodOptional<z.ZodNumber>;
1000
+ maxTimeMs: z.ZodOptional<z.ZodNumber>;
1001
+ maxMemoryMb: z.ZodOptional<z.ZodNumber>;
1002
+ redactSecrets: z.ZodOptional<z.ZodBoolean>;
1003
+ }, "strict", z.ZodTypeAny, {
1004
+ exclude?: string[] | undefined;
1005
+ maxFiles?: number | undefined;
1006
+ maxBytes?: number | undefined;
1007
+ maxTimeMs?: number | undefined;
1008
+ maxMemoryMb?: number | undefined;
1009
+ redactSecrets?: boolean | undefined;
1010
+ }, {
1011
+ exclude?: string[] | undefined;
1012
+ maxFiles?: number | undefined;
1013
+ maxBytes?: number | undefined;
1014
+ maxTimeMs?: number | undefined;
1015
+ maxMemoryMb?: number | undefined;
1016
+ redactSecrets?: boolean | undefined;
1017
+ }>>;
904
1018
  surfaces: z.ZodOptional<z.ZodObject<{
905
1019
  cli: z.ZodOptional<z.ZodObject<{
906
1020
  bin: z.ZodOptional<z.ZodString>;
@@ -914,7 +1028,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
914
1028
  }>>;
915
1029
  mcp: z.ZodOptional<z.ZodObject<{
916
1030
  enabled: z.ZodOptional<z.ZodBoolean>;
917
- tools: z.ZodOptional<z.ZodArray<z.ZodEnum<["handoff.resolve", "doc.search", "doc.get", "gate.status", "playbook.pattern.get", "retriever.query", "memory.classify", "memory.promoteDraft", "registry.topology"]>, "many">>;
1031
+ tools: z.ZodOptional<z.ZodArray<z.ZodEnum<["handoff.resolve", "doc.search", "doc.get", "gate.status", "playbook.pattern.get", "retriever.query", "memory.classify", "memory.promoteDraft", "registry.topology", "docbridge.snapshot", "docbridge.report", "docbridge.diagnostics", "docbridge.relations", "docbridge.run", "docbridge.proposals"]>, "many">>;
918
1032
  transport: z.ZodOptional<z.ZodEnum<["stdio", "http"]>>;
919
1033
  http: z.ZodOptional<z.ZodObject<{
920
1034
  port: z.ZodOptional<z.ZodNumber>;
@@ -928,7 +1042,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
928
1042
  }>>;
929
1043
  }, "strict", z.ZodTypeAny, {
930
1044
  enabled?: boolean | undefined;
931
- tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology")[] | undefined;
1045
+ tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology" | "docbridge.snapshot" | "docbridge.report" | "docbridge.diagnostics" | "docbridge.relations" | "docbridge.run" | "docbridge.proposals")[] | undefined;
932
1046
  http?: {
933
1047
  path?: string | undefined;
934
1048
  port?: number | undefined;
@@ -936,7 +1050,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
936
1050
  transport?: "stdio" | "http" | undefined;
937
1051
  }, {
938
1052
  enabled?: boolean | undefined;
939
- tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology")[] | undefined;
1053
+ tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology" | "docbridge.snapshot" | "docbridge.report" | "docbridge.diagnostics" | "docbridge.relations" | "docbridge.run" | "docbridge.proposals")[] | undefined;
940
1054
  http?: {
941
1055
  path?: string | undefined;
942
1056
  port?: number | undefined;
@@ -950,7 +1064,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
950
1064
  } | undefined;
951
1065
  mcp?: {
952
1066
  enabled?: boolean | undefined;
953
- tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology")[] | undefined;
1067
+ tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology" | "docbridge.snapshot" | "docbridge.report" | "docbridge.diagnostics" | "docbridge.relations" | "docbridge.run" | "docbridge.proposals")[] | undefined;
954
1068
  http?: {
955
1069
  path?: string | undefined;
956
1070
  port?: number | undefined;
@@ -964,7 +1078,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
964
1078
  } | undefined;
965
1079
  mcp?: {
966
1080
  enabled?: boolean | undefined;
967
- tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology")[] | undefined;
1081
+ tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology" | "docbridge.snapshot" | "docbridge.report" | "docbridge.diagnostics" | "docbridge.relations" | "docbridge.run" | "docbridge.proposals")[] | undefined;
968
1082
  http?: {
969
1083
  path?: string | undefined;
970
1084
  port?: number | undefined;
@@ -1066,6 +1180,22 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1066
1180
  }>>;
1067
1181
  runtime: z.ZodOptional<z.ZodEnum<["agentskit", "custom"]>>;
1068
1182
  runtimeModule: z.ZodOptional<z.ZodString>;
1183
+ registry: z.ZodOptional<z.ZodObject<{
1184
+ enabled: z.ZodOptional<z.ZodBoolean>;
1185
+ agentId: z.ZodOptional<z.ZodString>;
1186
+ agentRoot: z.ZodOptional<z.ZodString>;
1187
+ runnerModule: z.ZodOptional<z.ZodString>;
1188
+ }, "strict", z.ZodTypeAny, {
1189
+ enabled?: boolean | undefined;
1190
+ agentId?: string | undefined;
1191
+ agentRoot?: string | undefined;
1192
+ runnerModule?: string | undefined;
1193
+ }, {
1194
+ enabled?: boolean | undefined;
1195
+ agentId?: string | undefined;
1196
+ agentRoot?: string | undefined;
1197
+ runnerModule?: string | undefined;
1198
+ }>>;
1069
1199
  }, "strict", z.ZodTypeAny, {
1070
1200
  enabled?: boolean | undefined;
1071
1201
  adapter?: {
@@ -1100,6 +1230,12 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1100
1230
  } | undefined;
1101
1231
  runtime?: "custom" | "agentskit" | undefined;
1102
1232
  runtimeModule?: string | undefined;
1233
+ registry?: {
1234
+ enabled?: boolean | undefined;
1235
+ agentId?: string | undefined;
1236
+ agentRoot?: string | undefined;
1237
+ runnerModule?: string | undefined;
1238
+ } | undefined;
1103
1239
  }, {
1104
1240
  enabled?: boolean | undefined;
1105
1241
  adapter?: {
@@ -1134,6 +1270,12 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1134
1270
  } | undefined;
1135
1271
  runtime?: "custom" | "agentskit" | undefined;
1136
1272
  runtimeModule?: string | undefined;
1273
+ registry?: {
1274
+ enabled?: boolean | undefined;
1275
+ agentId?: string | undefined;
1276
+ agentRoot?: string | undefined;
1277
+ runnerModule?: string | undefined;
1278
+ } | undefined;
1137
1279
  }>>;
1138
1280
  federation: z.ZodOptional<z.ZodObject<{
1139
1281
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -1495,6 +1637,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1495
1637
  outFile?: string | undefined;
1496
1638
  enabled?: boolean | undefined;
1497
1639
  preamble?: string | undefined;
1640
+ urlPrefix?: string | undefined;
1641
+ pathPrefix?: string | undefined;
1498
1642
  } | undefined;
1499
1643
  capabilities?: {
1500
1644
  outFile?: string | undefined;
@@ -1549,6 +1693,25 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1549
1693
  exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
1550
1694
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
1551
1695
  } | undefined;
1696
+ rules?: {
1697
+ mode?: "strict" | "default" | "recommended" | undefined;
1698
+ severity?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", "off" | "info" | "warn" | "error">> | undefined;
1699
+ ignore?: ("ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness")[] | undefined;
1700
+ criticalEntities?: string[] | undefined;
1701
+ criticalPaths?: string[] | undefined;
1702
+ warningThresholds?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", number>> | undefined;
1703
+ } | undefined;
1704
+ workflow?: {
1705
+ stateDir?: string | undefined;
1706
+ } | undefined;
1707
+ safety?: {
1708
+ exclude?: string[] | undefined;
1709
+ maxFiles?: number | undefined;
1710
+ maxBytes?: number | undefined;
1711
+ maxTimeMs?: number | undefined;
1712
+ maxMemoryMb?: number | undefined;
1713
+ redactSecrets?: boolean | undefined;
1714
+ } | undefined;
1552
1715
  surfaces?: {
1553
1716
  cli?: {
1554
1717
  bin?: string | undefined;
@@ -1556,7 +1719,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1556
1719
  } | undefined;
1557
1720
  mcp?: {
1558
1721
  enabled?: boolean | undefined;
1559
- tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology")[] | undefined;
1722
+ tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology" | "docbridge.snapshot" | "docbridge.report" | "docbridge.diagnostics" | "docbridge.relations" | "docbridge.run" | "docbridge.proposals")[] | undefined;
1560
1723
  http?: {
1561
1724
  path?: string | undefined;
1562
1725
  port?: number | undefined;
@@ -1598,6 +1761,12 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1598
1761
  } | undefined;
1599
1762
  runtime?: "custom" | "agentskit" | undefined;
1600
1763
  runtimeModule?: string | undefined;
1764
+ registry?: {
1765
+ enabled?: boolean | undefined;
1766
+ agentId?: string | undefined;
1767
+ agentRoot?: string | undefined;
1768
+ runnerModule?: string | undefined;
1769
+ } | undefined;
1601
1770
  } | undefined;
1602
1771
  conformance?: {
1603
1772
  documentationStandardV1?: {
@@ -1663,6 +1832,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1663
1832
  outFile?: string | undefined;
1664
1833
  enabled?: boolean | undefined;
1665
1834
  preamble?: string | undefined;
1835
+ urlPrefix?: string | undefined;
1836
+ pathPrefix?: string | undefined;
1666
1837
  } | undefined;
1667
1838
  capabilities?: {
1668
1839
  outFile?: string | undefined;
@@ -1717,6 +1888,25 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1717
1888
  exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
1718
1889
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
1719
1890
  } | undefined;
1891
+ rules?: {
1892
+ mode?: "strict" | "default" | "recommended" | undefined;
1893
+ severity?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", "off" | "info" | "warn" | "error">> | undefined;
1894
+ ignore?: ("ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness")[] | undefined;
1895
+ criticalEntities?: string[] | undefined;
1896
+ criticalPaths?: string[] | undefined;
1897
+ warningThresholds?: Partial<Record<"ownership" | "documentation-quality" | "graph-undocumented-relation" | "declared-unobserved-relation" | "unresolved-reference" | "conflicting-declaration" | "not-analyzed-coverage" | "stale-documentation" | "centrality-risk" | "critical-path-risk" | "freshness", number>> | undefined;
1898
+ } | undefined;
1899
+ workflow?: {
1900
+ stateDir?: string | undefined;
1901
+ } | undefined;
1902
+ safety?: {
1903
+ exclude?: string[] | undefined;
1904
+ maxFiles?: number | undefined;
1905
+ maxBytes?: number | undefined;
1906
+ maxTimeMs?: number | undefined;
1907
+ maxMemoryMb?: number | undefined;
1908
+ redactSecrets?: boolean | undefined;
1909
+ } | undefined;
1720
1910
  surfaces?: {
1721
1911
  cli?: {
1722
1912
  bin?: string | undefined;
@@ -1724,7 +1914,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1724
1914
  } | undefined;
1725
1915
  mcp?: {
1726
1916
  enabled?: boolean | undefined;
1727
- tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology")[] | undefined;
1917
+ tools?: ("handoff.resolve" | "doc.search" | "doc.get" | "gate.status" | "playbook.pattern.get" | "retriever.query" | "memory.classify" | "memory.promoteDraft" | "registry.topology" | "docbridge.snapshot" | "docbridge.report" | "docbridge.diagnostics" | "docbridge.relations" | "docbridge.run" | "docbridge.proposals")[] | undefined;
1728
1918
  http?: {
1729
1919
  path?: string | undefined;
1730
1920
  port?: number | undefined;
@@ -1766,6 +1956,12 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1766
1956
  } | undefined;
1767
1957
  runtime?: "custom" | "agentskit" | undefined;
1768
1958
  runtimeModule?: string | undefined;
1959
+ registry?: {
1960
+ enabled?: boolean | undefined;
1961
+ agentId?: string | undefined;
1962
+ agentRoot?: string | undefined;
1963
+ runnerModule?: string | undefined;
1964
+ } | undefined;
1769
1965
  } | undefined;
1770
1966
  conformance?: {
1771
1967
  documentationStandardV1?: {
@@ -1809,6 +2005,11 @@ type DocBridgeConfigV1 = z.infer<typeof DocBridgeConfigV1Schema>;
1809
2005
  type AgentCorpusConfig = z.infer<typeof AgentCorpusConfigSchema>;
1810
2006
  type DocumentationStandardV1Config = z.infer<typeof DocumentationStandardV1ConfigSchema>;
1811
2007
  type DocumentationStandardRuleId = z.infer<typeof DocumentationStandardRuleIdSchema>;
2008
+ type RuleId = z.infer<typeof RuleIdSchema>;
2009
+ type RuleSeverity = z.infer<typeof RuleSeveritySchema>;
2010
+ type RulesConfig = z.infer<typeof RulesConfigSchema>;
2011
+ type WorkflowConfig = z.infer<typeof WorkflowConfigSchema>;
2012
+ type RepositorySafetyConfig = z.infer<typeof RepositorySafetyConfigSchema>;
1812
2013
 
1813
2014
  /** Type-safe config helper for `doc-bridge.config.ts`. */
1814
2015
  declare const defineConfig: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
@@ -1833,4 +2034,4 @@ declare const resolveProjectRoot: (start?: string) => string;
1833
2034
  /** Project root for a loaded config file path (directory of the config). */
1834
2035
  declare const projectRootFromConfigPath: (configFilePath: string, projectRootField?: string) => string;
1835
2036
 
1836
- export { type AgentCorpusConfig as A, ConfigNotFoundError as C, type DocBridgeConfigV1 as D, EcosystemContractEvidenceSchema as E, HumanCorpusConfigSchema as H, type LoadConfigOptions as L, type DocumentationStandardRuleId as a, DocBridgeConfigV1Schema as b, DocumentationStandardRuleIdSchema as c, type DocumentationStandardV1Config as d, DocumentationStandardV1ConfigSchema as e, type LoadConfigResult as f, applyConfigDefaults as g, defineConfig as h, AgentCorpusConfigSchema as i, ConformanceConfigSchema as j, loadConfig as l, projectRootFromConfigPath as p, resolveProjectRoot as r };
2037
+ export { type AgentCorpusConfig as A, ConfigNotFoundError as C, type DocBridgeConfigV1 as D, EcosystemContractEvidenceSchema as E, HumanCorpusConfigSchema as H, type LoadConfigOptions as L, type RulesConfig as R, type WorkflowConfig as W, type RuleId as a, type RuleSeverity as b, type DocumentationStandardRuleId as c, DocBridgeConfigV1Schema as d, DocumentationStandardRuleIdSchema as e, type DocumentationStandardV1Config as f, DocumentationStandardV1ConfigSchema as g, type LoadConfigResult as h, type RepositorySafetyConfig as i, RepositorySafetyConfigSchema as j, RuleIdSchema as k, RuleSeveritySchema as l, RulesConfigSchema as m, WorkflowConfigSchema as n, applyConfigDefaults as o, defineConfig as p, loadConfig as q, projectRootFromConfigPath as r, resolveProjectRoot as s, AgentCorpusConfigSchema as t, ConformanceConfigSchema as u };