@agentskit/doc-bridge 1.4.3 → 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 (38) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/action.yml +1 -1
  3. package/dist/cli/program.js +2412 -268
  4. package/dist/cli/program.js.map +1 -1
  5. package/dist/config/index.d.ts +1 -1
  6. package/dist/config/index.js +74 -3
  7. package/dist/config/index.js.map +1 -1
  8. package/dist/{index-DhoAG9Ar.d.ts → index-Di7PkJuf.d.ts} +195 -8
  9. package/dist/index.d.ts +1942 -4
  10. package/dist/index.js +2143 -189
  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 +16 -16
  15. package/ecosystem-upstream.json +2 -2
  16. package/ecosystem.json +84 -127
  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 +67 -0
  24. package/src/discovery/documentation.ts +320 -0
  25. package/src/discovery/repository.ts +514 -0
  26. package/src/fixes/proposals.ts +165 -0
  27. package/src/index-builder/content-hash.ts +9 -2
  28. package/src/index.ts +99 -2
  29. package/src/mcp/server.ts +178 -8
  30. package/src/reconciliation/reconcile.ts +227 -0
  31. package/src/report/html.ts +74 -0
  32. package/src/rules/engine.ts +180 -0
  33. package/src/safety/repository.ts +84 -0
  34. package/src/schemas/knowledge.ts +315 -0
  35. package/src/validate.ts +24 -0
  36. package/src/version.ts +1 -1
  37. package/src/workflow/engine.ts +238 -0
  38. package/tsup.config.ts +2 -1
package/dist/{index-DhoAG9Ar.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;
@@ -911,6 +964,57 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
911
964
  exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
912
965
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
913
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
+ }>>;
914
1018
  surfaces: z.ZodOptional<z.ZodObject<{
915
1019
  cli: z.ZodOptional<z.ZodObject<{
916
1020
  bin: z.ZodOptional<z.ZodString>;
@@ -924,7 +1028,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
924
1028
  }>>;
925
1029
  mcp: z.ZodOptional<z.ZodObject<{
926
1030
  enabled: z.ZodOptional<z.ZodBoolean>;
927
- 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">>;
928
1032
  transport: z.ZodOptional<z.ZodEnum<["stdio", "http"]>>;
929
1033
  http: z.ZodOptional<z.ZodObject<{
930
1034
  port: z.ZodOptional<z.ZodNumber>;
@@ -938,7 +1042,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
938
1042
  }>>;
939
1043
  }, "strict", z.ZodTypeAny, {
940
1044
  enabled?: boolean | undefined;
941
- 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;
942
1046
  http?: {
943
1047
  path?: string | undefined;
944
1048
  port?: number | undefined;
@@ -946,7 +1050,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
946
1050
  transport?: "stdio" | "http" | undefined;
947
1051
  }, {
948
1052
  enabled?: boolean | undefined;
949
- 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;
950
1054
  http?: {
951
1055
  path?: string | undefined;
952
1056
  port?: number | undefined;
@@ -960,7 +1064,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
960
1064
  } | undefined;
961
1065
  mcp?: {
962
1066
  enabled?: boolean | undefined;
963
- 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;
964
1068
  http?: {
965
1069
  path?: string | undefined;
966
1070
  port?: number | undefined;
@@ -974,7 +1078,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
974
1078
  } | undefined;
975
1079
  mcp?: {
976
1080
  enabled?: boolean | undefined;
977
- 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;
978
1082
  http?: {
979
1083
  path?: string | undefined;
980
1084
  port?: number | undefined;
@@ -1076,6 +1180,22 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1076
1180
  }>>;
1077
1181
  runtime: z.ZodOptional<z.ZodEnum<["agentskit", "custom"]>>;
1078
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
+ }>>;
1079
1199
  }, "strict", z.ZodTypeAny, {
1080
1200
  enabled?: boolean | undefined;
1081
1201
  adapter?: {
@@ -1110,6 +1230,12 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1110
1230
  } | undefined;
1111
1231
  runtime?: "custom" | "agentskit" | undefined;
1112
1232
  runtimeModule?: string | undefined;
1233
+ registry?: {
1234
+ enabled?: boolean | undefined;
1235
+ agentId?: string | undefined;
1236
+ agentRoot?: string | undefined;
1237
+ runnerModule?: string | undefined;
1238
+ } | undefined;
1113
1239
  }, {
1114
1240
  enabled?: boolean | undefined;
1115
1241
  adapter?: {
@@ -1144,6 +1270,12 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1144
1270
  } | undefined;
1145
1271
  runtime?: "custom" | "agentskit" | undefined;
1146
1272
  runtimeModule?: string | undefined;
1273
+ registry?: {
1274
+ enabled?: boolean | undefined;
1275
+ agentId?: string | undefined;
1276
+ agentRoot?: string | undefined;
1277
+ runnerModule?: string | undefined;
1278
+ } | undefined;
1147
1279
  }>>;
1148
1280
  federation: z.ZodOptional<z.ZodObject<{
1149
1281
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -1561,6 +1693,25 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1561
1693
  exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
1562
1694
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
1563
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;
1564
1715
  surfaces?: {
1565
1716
  cli?: {
1566
1717
  bin?: string | undefined;
@@ -1568,7 +1719,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1568
1719
  } | undefined;
1569
1720
  mcp?: {
1570
1721
  enabled?: boolean | undefined;
1571
- 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;
1572
1723
  http?: {
1573
1724
  path?: string | undefined;
1574
1725
  port?: number | undefined;
@@ -1610,6 +1761,12 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1610
1761
  } | undefined;
1611
1762
  runtime?: "custom" | "agentskit" | undefined;
1612
1763
  runtimeModule?: string | undefined;
1764
+ registry?: {
1765
+ enabled?: boolean | undefined;
1766
+ agentId?: string | undefined;
1767
+ agentRoot?: string | undefined;
1768
+ runnerModule?: string | undefined;
1769
+ } | undefined;
1613
1770
  } | undefined;
1614
1771
  conformance?: {
1615
1772
  documentationStandardV1?: {
@@ -1731,6 +1888,25 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1731
1888
  exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
1732
1889
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
1733
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;
1734
1910
  surfaces?: {
1735
1911
  cli?: {
1736
1912
  bin?: string | undefined;
@@ -1738,7 +1914,7 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1738
1914
  } | undefined;
1739
1915
  mcp?: {
1740
1916
  enabled?: boolean | undefined;
1741
- 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;
1742
1918
  http?: {
1743
1919
  path?: string | undefined;
1744
1920
  port?: number | undefined;
@@ -1780,6 +1956,12 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1780
1956
  } | undefined;
1781
1957
  runtime?: "custom" | "agentskit" | undefined;
1782
1958
  runtimeModule?: string | undefined;
1959
+ registry?: {
1960
+ enabled?: boolean | undefined;
1961
+ agentId?: string | undefined;
1962
+ agentRoot?: string | undefined;
1963
+ runnerModule?: string | undefined;
1964
+ } | undefined;
1783
1965
  } | undefined;
1784
1966
  conformance?: {
1785
1967
  documentationStandardV1?: {
@@ -1823,6 +2005,11 @@ type DocBridgeConfigV1 = z.infer<typeof DocBridgeConfigV1Schema>;
1823
2005
  type AgentCorpusConfig = z.infer<typeof AgentCorpusConfigSchema>;
1824
2006
  type DocumentationStandardV1Config = z.infer<typeof DocumentationStandardV1ConfigSchema>;
1825
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>;
1826
2013
 
1827
2014
  /** Type-safe config helper for `doc-bridge.config.ts`. */
1828
2015
  declare const defineConfig: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
@@ -1847,4 +2034,4 @@ declare const resolveProjectRoot: (start?: string) => string;
1847
2034
  /** Project root for a loaded config file path (directory of the config). */
1848
2035
  declare const projectRootFromConfigPath: (configFilePath: string, projectRootField?: string) => string;
1849
2036
 
1850
- 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 };