@agentskit/doc-bridge 1.6.3 → 1.7.44

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 +249 -0
  2. package/action.yml +1 -1
  3. package/dist/cli/program.js +793 -137
  4. package/dist/cli/program.js.map +1 -1
  5. package/dist/config/index.d.ts +1 -1
  6. package/dist/config/index.js +38 -2
  7. package/dist/config/index.js.map +1 -1
  8. package/dist/{index-DudNuwI5.d.ts → index-C2PCQSrB.d.ts} +216 -25
  9. package/dist/index.d.ts +837 -67
  10. package/dist/index.js +858 -127
  11. package/dist/index.js.map +1 -1
  12. package/docs/PRD-enterprise-hardening.md +288 -0
  13. package/docs/adr/0001-enterprise-verification-contract.md +35 -0
  14. package/docs/knowledge-engine-runbook.md +18 -2
  15. package/docs/spec/analyzer-plugin-v1.md +24 -0
  16. package/docs/spec/benchmark-v1.md +30 -0
  17. package/docs/spec/config-v1.md +111 -0
  18. package/docs/validation-cycle-plan.md +236 -0
  19. package/docs/verification-harness.md +33 -4
  20. package/mcpb/manifest.json +1 -1
  21. package/package.json +1 -1
  22. package/scripts/report-visual-check.mjs +63 -17
  23. package/scripts/verification-harness.mjs +216 -13
  24. package/skills/doc-bridge-handoff/scripts/resolve-handoff.mjs +1 -1
  25. package/src/agents/registry-adapter.ts +31 -7
  26. package/src/cli/program.ts +44 -11
  27. package/src/config/index.ts +2 -0
  28. package/src/config/schema.ts +56 -0
  29. package/src/discovery/documentation.ts +46 -5
  30. package/src/discovery/repository.ts +95 -16
  31. package/src/index.ts +29 -0
  32. package/src/metrics/benchmark.ts +176 -0
  33. package/src/plugins/contract.ts +89 -0
  34. package/src/reconciliation/reconcile.ts +137 -3
  35. package/src/report/html.ts +302 -78
  36. package/src/schemas/knowledge.ts +16 -1
  37. package/src/version.ts +1 -1
  38. package/src/workflow/engine.ts +65 -9
@@ -69,12 +69,19 @@ declare const RulesConfigSchema: z.ZodObject<{
69
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
70
  }>;
71
71
  declare const ReconciliationConfigSchema: z.ZodObject<{
72
+ /** Semantic comparison level. Raw discovery always keeps file-level relations. */
73
+ scope: z.ZodOptional<z.ZodEnum<["file", "module", "package"]>>;
72
74
  /** Relation kinds that must have documentation declarations. Omit to require all observed kinds; [] disables this signal. */
73
75
  requiredRelationKinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
76
+ includeOrphanedDocuments: z.ZodOptional<z.ZodBoolean>;
74
77
  }, "strict", z.ZodTypeAny, {
78
+ scope?: "file" | "module" | "package" | undefined;
75
79
  requiredRelationKinds?: string[] | undefined;
80
+ includeOrphanedDocuments?: boolean | undefined;
76
81
  }, {
82
+ scope?: "file" | "module" | "package" | undefined;
77
83
  requiredRelationKinds?: string[] | undefined;
84
+ includeOrphanedDocuments?: boolean | undefined;
78
85
  }>;
79
86
  declare const WorkflowConfigSchema: z.ZodObject<{
80
87
  stateDir: z.ZodOptional<z.ZodString>;
@@ -105,6 +112,14 @@ declare const RepositorySafetyConfigSchema: z.ZodObject<{
105
112
  maxMemoryMb?: number | undefined;
106
113
  redactSecrets?: boolean | undefined;
107
114
  }>;
115
+ declare const ReportConfigSchema: z.ZodObject<{
116
+ /** Public report privacy mode. Private is the default; anonymized preserves topology without project identity. */
117
+ privacy: z.ZodOptional<z.ZodEnum<["private", "anonymized"]>>;
118
+ }, "strict", z.ZodTypeAny, {
119
+ privacy?: "private" | "anonymized" | undefined;
120
+ }, {
121
+ privacy?: "private" | "anonymized" | undefined;
122
+ }>;
108
123
  declare const EcosystemContractEvidenceSchema: z.ZodObject<{
109
124
  manifest: z.ZodString;
110
125
  claims: z.ZodString;
@@ -191,13 +206,13 @@ declare const DocumentationStandardV1ConfigSchema: z.ZodEffects<z.ZodObject<{
191
206
  approvedBy: z.ZodString;
192
207
  trackingUrl: z.ZodString;
193
208
  }, "strict", z.ZodTypeAny, {
194
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
195
209
  reason: string;
210
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
196
211
  approvedBy: string;
197
212
  trackingUrl: string;
198
213
  }, {
199
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
200
214
  reason: string;
215
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
201
216
  approvedBy: string;
202
217
  trackingUrl: string;
203
218
  }>, "many">>;
@@ -230,8 +245,8 @@ declare const DocumentationStandardV1ConfigSchema: z.ZodEffects<z.ZodObject<{
230
245
  productId: string;
231
246
  } | undefined;
232
247
  exceptions?: {
233
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
234
248
  reason: string;
249
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
235
250
  approvedBy: string;
236
251
  trackingUrl: string;
237
252
  }[] | undefined;
@@ -264,8 +279,8 @@ declare const DocumentationStandardV1ConfigSchema: z.ZodEffects<z.ZodObject<{
264
279
  productId: string;
265
280
  } | undefined;
266
281
  exceptions?: {
267
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
268
282
  reason: string;
283
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
269
284
  approvedBy: string;
270
285
  trackingUrl: string;
271
286
  }[] | undefined;
@@ -298,8 +313,8 @@ declare const DocumentationStandardV1ConfigSchema: z.ZodEffects<z.ZodObject<{
298
313
  productId: string;
299
314
  } | undefined;
300
315
  exceptions?: {
301
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
302
316
  reason: string;
317
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
303
318
  approvedBy: string;
304
319
  trackingUrl: string;
305
320
  }[] | undefined;
@@ -332,8 +347,8 @@ declare const DocumentationStandardV1ConfigSchema: z.ZodEffects<z.ZodObject<{
332
347
  productId: string;
333
348
  } | undefined;
334
349
  exceptions?: {
335
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
336
350
  reason: string;
351
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
337
352
  approvedBy: string;
338
353
  trackingUrl: string;
339
354
  }[] | undefined;
@@ -411,13 +426,13 @@ declare const ConformanceConfigSchema: z.ZodObject<{
411
426
  approvedBy: z.ZodString;
412
427
  trackingUrl: z.ZodString;
413
428
  }, "strict", z.ZodTypeAny, {
414
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
415
429
  reason: string;
430
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
416
431
  approvedBy: string;
417
432
  trackingUrl: string;
418
433
  }, {
419
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
420
434
  reason: string;
435
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
421
436
  approvedBy: string;
422
437
  trackingUrl: string;
423
438
  }>, "many">>;
@@ -450,8 +465,8 @@ declare const ConformanceConfigSchema: z.ZodObject<{
450
465
  productId: string;
451
466
  } | undefined;
452
467
  exceptions?: {
453
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
454
468
  reason: string;
469
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
455
470
  approvedBy: string;
456
471
  trackingUrl: string;
457
472
  }[] | undefined;
@@ -484,8 +499,8 @@ declare const ConformanceConfigSchema: z.ZodObject<{
484
499
  productId: string;
485
500
  } | undefined;
486
501
  exceptions?: {
487
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
488
502
  reason: string;
503
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
489
504
  approvedBy: string;
490
505
  trackingUrl: string;
491
506
  }[] | undefined;
@@ -518,8 +533,8 @@ declare const ConformanceConfigSchema: z.ZodObject<{
518
533
  productId: string;
519
534
  } | undefined;
520
535
  exceptions?: {
521
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
522
536
  reason: string;
537
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
523
538
  approvedBy: string;
524
539
  trackingUrl: string;
525
540
  }[] | undefined;
@@ -552,8 +567,8 @@ declare const ConformanceConfigSchema: z.ZodObject<{
552
567
  productId: string;
553
568
  } | undefined;
554
569
  exceptions?: {
555
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
556
570
  reason: string;
571
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
557
572
  approvedBy: string;
558
573
  trackingUrl: string;
559
574
  }[] | undefined;
@@ -588,8 +603,8 @@ declare const ConformanceConfigSchema: z.ZodObject<{
588
603
  productId: string;
589
604
  } | undefined;
590
605
  exceptions?: {
591
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
592
606
  reason: string;
607
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
593
608
  approvedBy: string;
594
609
  trackingUrl: string;
595
610
  }[] | undefined;
@@ -624,8 +639,8 @@ declare const ConformanceConfigSchema: z.ZodObject<{
624
639
  productId: string;
625
640
  } | undefined;
626
641
  exceptions?: {
627
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
628
642
  reason: string;
643
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
629
644
  approvedBy: string;
630
645
  trackingUrl: string;
631
646
  }[] | undefined;
@@ -973,12 +988,100 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
973
988
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
974
989
  }>>;
975
990
  reconciliation: z.ZodOptional<z.ZodObject<{
991
+ /** Semantic comparison level. Raw discovery always keeps file-level relations. */
992
+ scope: z.ZodOptional<z.ZodEnum<["file", "module", "package"]>>;
976
993
  /** Relation kinds that must have documentation declarations. Omit to require all observed kinds; [] disables this signal. */
977
994
  requiredRelationKinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
995
+ includeOrphanedDocuments: z.ZodOptional<z.ZodBoolean>;
978
996
  }, "strict", z.ZodTypeAny, {
997
+ scope?: "file" | "module" | "package" | undefined;
979
998
  requiredRelationKinds?: string[] | undefined;
999
+ includeOrphanedDocuments?: boolean | undefined;
980
1000
  }, {
1001
+ scope?: "file" | "module" | "package" | undefined;
981
1002
  requiredRelationKinds?: string[] | undefined;
1003
+ includeOrphanedDocuments?: boolean | undefined;
1004
+ }>>;
1005
+ analysis: z.ZodOptional<z.ZodObject<{
1006
+ plugins: z.ZodOptional<z.ZodArray<z.ZodObject<{
1007
+ id: z.ZodString;
1008
+ enabled: z.ZodOptional<z.ZodBoolean>;
1009
+ order: z.ZodOptional<z.ZodNumber>;
1010
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1011
+ reason: z.ZodOptional<z.ZodString>;
1012
+ }, "strict", z.ZodTypeAny, {
1013
+ id: string;
1014
+ options?: Record<string, unknown> | undefined;
1015
+ enabled?: boolean | undefined;
1016
+ order?: number | undefined;
1017
+ reason?: string | undefined;
1018
+ }, {
1019
+ id: string;
1020
+ options?: Record<string, unknown> | undefined;
1021
+ enabled?: boolean | undefined;
1022
+ order?: number | undefined;
1023
+ reason?: string | undefined;
1024
+ }>, "many">>;
1025
+ jsTs: z.ZodOptional<z.ZodObject<{
1026
+ runtimeWiringMethods: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1027
+ runtimeWiringAdapters: z.ZodOptional<z.ZodArray<z.ZodObject<{
1028
+ id: z.ZodString;
1029
+ methods: z.ZodArray<z.ZodString, "many">;
1030
+ }, "strict", z.ZodTypeAny, {
1031
+ id: string;
1032
+ methods: string[];
1033
+ }, {
1034
+ id: string;
1035
+ methods: string[];
1036
+ }>, "many">>;
1037
+ includeTestRuntimeWiring: z.ZodOptional<z.ZodBoolean>;
1038
+ }, "strict", z.ZodTypeAny, {
1039
+ runtimeWiringMethods?: string[] | undefined;
1040
+ runtimeWiringAdapters?: {
1041
+ id: string;
1042
+ methods: string[];
1043
+ }[] | undefined;
1044
+ includeTestRuntimeWiring?: boolean | undefined;
1045
+ }, {
1046
+ runtimeWiringMethods?: string[] | undefined;
1047
+ runtimeWiringAdapters?: {
1048
+ id: string;
1049
+ methods: string[];
1050
+ }[] | undefined;
1051
+ includeTestRuntimeWiring?: boolean | undefined;
1052
+ }>>;
1053
+ }, "strict", z.ZodTypeAny, {
1054
+ plugins?: {
1055
+ id: string;
1056
+ options?: Record<string, unknown> | undefined;
1057
+ enabled?: boolean | undefined;
1058
+ order?: number | undefined;
1059
+ reason?: string | undefined;
1060
+ }[] | undefined;
1061
+ jsTs?: {
1062
+ runtimeWiringMethods?: string[] | undefined;
1063
+ runtimeWiringAdapters?: {
1064
+ id: string;
1065
+ methods: string[];
1066
+ }[] | undefined;
1067
+ includeTestRuntimeWiring?: boolean | undefined;
1068
+ } | undefined;
1069
+ }, {
1070
+ plugins?: {
1071
+ id: string;
1072
+ options?: Record<string, unknown> | undefined;
1073
+ enabled?: boolean | undefined;
1074
+ order?: number | undefined;
1075
+ reason?: string | undefined;
1076
+ }[] | undefined;
1077
+ jsTs?: {
1078
+ runtimeWiringMethods?: string[] | undefined;
1079
+ runtimeWiringAdapters?: {
1080
+ id: string;
1081
+ methods: string[];
1082
+ }[] | undefined;
1083
+ includeTestRuntimeWiring?: boolean | undefined;
1084
+ } | undefined;
982
1085
  }>>;
983
1086
  rules: z.ZodOptional<z.ZodObject<{
984
1087
  mode: z.ZodOptional<z.ZodEnum<["default", "recommended", "strict"]>>;
@@ -1031,6 +1134,14 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1031
1134
  maxMemoryMb?: number | undefined;
1032
1135
  redactSecrets?: boolean | undefined;
1033
1136
  }>>;
1137
+ report: z.ZodOptional<z.ZodObject<{
1138
+ /** Public report privacy mode. Private is the default; anonymized preserves topology without project identity. */
1139
+ privacy: z.ZodOptional<z.ZodEnum<["private", "anonymized"]>>;
1140
+ }, "strict", z.ZodTypeAny, {
1141
+ privacy?: "private" | "anonymized" | undefined;
1142
+ }, {
1143
+ privacy?: "private" | "anonymized" | undefined;
1144
+ }>>;
1034
1145
  surfaces: z.ZodOptional<z.ZodObject<{
1035
1146
  cli: z.ZodOptional<z.ZodObject<{
1036
1147
  bin: z.ZodOptional<z.ZodString>;
@@ -1201,16 +1312,31 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1201
1312
  agentId: z.ZodOptional<z.ZodString>;
1202
1313
  agentRoot: z.ZodOptional<z.ZodString>;
1203
1314
  runnerModule: z.ZodOptional<z.ZodString>;
1315
+ deterministic: z.ZodOptional<z.ZodBoolean>;
1316
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
1317
+ maxTokens: z.ZodOptional<z.ZodNumber>;
1318
+ maxResponseBytes: z.ZodOptional<z.ZodNumber>;
1319
+ maxConcurrency: z.ZodOptional<z.ZodNumber>;
1204
1320
  }, "strict", z.ZodTypeAny, {
1205
1321
  enabled?: boolean | undefined;
1206
1322
  agentId?: string | undefined;
1207
1323
  agentRoot?: string | undefined;
1208
1324
  runnerModule?: string | undefined;
1325
+ deterministic?: boolean | undefined;
1326
+ timeoutMs?: number | undefined;
1327
+ maxTokens?: number | undefined;
1328
+ maxResponseBytes?: number | undefined;
1329
+ maxConcurrency?: number | undefined;
1209
1330
  }, {
1210
1331
  enabled?: boolean | undefined;
1211
1332
  agentId?: string | undefined;
1212
1333
  agentRoot?: string | undefined;
1213
1334
  runnerModule?: string | undefined;
1335
+ deterministic?: boolean | undefined;
1336
+ timeoutMs?: number | undefined;
1337
+ maxTokens?: number | undefined;
1338
+ maxResponseBytes?: number | undefined;
1339
+ maxConcurrency?: number | undefined;
1214
1340
  }>>;
1215
1341
  }, "strict", z.ZodTypeAny, {
1216
1342
  enabled?: boolean | undefined;
@@ -1251,6 +1377,11 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1251
1377
  agentId?: string | undefined;
1252
1378
  agentRoot?: string | undefined;
1253
1379
  runnerModule?: string | undefined;
1380
+ deterministic?: boolean | undefined;
1381
+ timeoutMs?: number | undefined;
1382
+ maxTokens?: number | undefined;
1383
+ maxResponseBytes?: number | undefined;
1384
+ maxConcurrency?: number | undefined;
1254
1385
  } | undefined;
1255
1386
  }, {
1256
1387
  enabled?: boolean | undefined;
@@ -1291,6 +1422,11 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1291
1422
  agentId?: string | undefined;
1292
1423
  agentRoot?: string | undefined;
1293
1424
  runnerModule?: string | undefined;
1425
+ deterministic?: boolean | undefined;
1426
+ timeoutMs?: number | undefined;
1427
+ maxTokens?: number | undefined;
1428
+ maxResponseBytes?: number | undefined;
1429
+ maxConcurrency?: number | undefined;
1294
1430
  } | undefined;
1295
1431
  }>>;
1296
1432
  federation: z.ZodOptional<z.ZodObject<{
@@ -1406,13 +1542,13 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1406
1542
  approvedBy: z.ZodString;
1407
1543
  trackingUrl: z.ZodString;
1408
1544
  }, "strict", z.ZodTypeAny, {
1409
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1410
1545
  reason: string;
1546
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1411
1547
  approvedBy: string;
1412
1548
  trackingUrl: string;
1413
1549
  }, {
1414
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1415
1550
  reason: string;
1551
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1416
1552
  approvedBy: string;
1417
1553
  trackingUrl: string;
1418
1554
  }>, "many">>;
@@ -1445,8 +1581,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1445
1581
  productId: string;
1446
1582
  } | undefined;
1447
1583
  exceptions?: {
1448
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1449
1584
  reason: string;
1585
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1450
1586
  approvedBy: string;
1451
1587
  trackingUrl: string;
1452
1588
  }[] | undefined;
@@ -1479,8 +1615,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1479
1615
  productId: string;
1480
1616
  } | undefined;
1481
1617
  exceptions?: {
1482
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1483
1618
  reason: string;
1619
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1484
1620
  approvedBy: string;
1485
1621
  trackingUrl: string;
1486
1622
  }[] | undefined;
@@ -1513,8 +1649,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1513
1649
  productId: string;
1514
1650
  } | undefined;
1515
1651
  exceptions?: {
1516
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1517
1652
  reason: string;
1653
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1518
1654
  approvedBy: string;
1519
1655
  trackingUrl: string;
1520
1656
  }[] | undefined;
@@ -1547,8 +1683,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1547
1683
  productId: string;
1548
1684
  } | undefined;
1549
1685
  exceptions?: {
1550
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1551
1686
  reason: string;
1687
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1552
1688
  approvedBy: string;
1553
1689
  trackingUrl: string;
1554
1690
  }[] | undefined;
@@ -1583,8 +1719,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1583
1719
  productId: string;
1584
1720
  } | undefined;
1585
1721
  exceptions?: {
1586
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1587
1722
  reason: string;
1723
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1588
1724
  approvedBy: string;
1589
1725
  trackingUrl: string;
1590
1726
  }[] | undefined;
@@ -1619,8 +1755,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1619
1755
  productId: string;
1620
1756
  } | undefined;
1621
1757
  exceptions?: {
1622
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1623
1758
  reason: string;
1759
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1624
1760
  approvedBy: string;
1625
1761
  trackingUrl: string;
1626
1762
  }[] | undefined;
@@ -1710,7 +1846,26 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1710
1846
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
1711
1847
  } | undefined;
1712
1848
  reconciliation?: {
1849
+ scope?: "file" | "module" | "package" | undefined;
1713
1850
  requiredRelationKinds?: string[] | undefined;
1851
+ includeOrphanedDocuments?: boolean | undefined;
1852
+ } | undefined;
1853
+ analysis?: {
1854
+ plugins?: {
1855
+ id: string;
1856
+ options?: Record<string, unknown> | undefined;
1857
+ enabled?: boolean | undefined;
1858
+ order?: number | undefined;
1859
+ reason?: string | undefined;
1860
+ }[] | undefined;
1861
+ jsTs?: {
1862
+ runtimeWiringMethods?: string[] | undefined;
1863
+ runtimeWiringAdapters?: {
1864
+ id: string;
1865
+ methods: string[];
1866
+ }[] | undefined;
1867
+ includeTestRuntimeWiring?: boolean | undefined;
1868
+ } | undefined;
1714
1869
  } | undefined;
1715
1870
  rules?: {
1716
1871
  mode?: "strict" | "default" | "recommended" | undefined;
@@ -1731,6 +1886,9 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1731
1886
  maxMemoryMb?: number | undefined;
1732
1887
  redactSecrets?: boolean | undefined;
1733
1888
  } | undefined;
1889
+ report?: {
1890
+ privacy?: "private" | "anonymized" | undefined;
1891
+ } | undefined;
1734
1892
  surfaces?: {
1735
1893
  cli?: {
1736
1894
  bin?: string | undefined;
@@ -1785,6 +1943,11 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1785
1943
  agentId?: string | undefined;
1786
1944
  agentRoot?: string | undefined;
1787
1945
  runnerModule?: string | undefined;
1946
+ deterministic?: boolean | undefined;
1947
+ timeoutMs?: number | undefined;
1948
+ maxTokens?: number | undefined;
1949
+ maxResponseBytes?: number | undefined;
1950
+ maxConcurrency?: number | undefined;
1788
1951
  } | undefined;
1789
1952
  } | undefined;
1790
1953
  conformance?: {
@@ -1817,8 +1980,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1817
1980
  productId: string;
1818
1981
  } | undefined;
1819
1982
  exceptions?: {
1820
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1821
1983
  reason: string;
1984
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1822
1985
  approvedBy: string;
1823
1986
  trackingUrl: string;
1824
1987
  }[] | undefined;
@@ -1908,7 +2071,26 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1908
2071
  preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
1909
2072
  } | undefined;
1910
2073
  reconciliation?: {
2074
+ scope?: "file" | "module" | "package" | undefined;
1911
2075
  requiredRelationKinds?: string[] | undefined;
2076
+ includeOrphanedDocuments?: boolean | undefined;
2077
+ } | undefined;
2078
+ analysis?: {
2079
+ plugins?: {
2080
+ id: string;
2081
+ options?: Record<string, unknown> | undefined;
2082
+ enabled?: boolean | undefined;
2083
+ order?: number | undefined;
2084
+ reason?: string | undefined;
2085
+ }[] | undefined;
2086
+ jsTs?: {
2087
+ runtimeWiringMethods?: string[] | undefined;
2088
+ runtimeWiringAdapters?: {
2089
+ id: string;
2090
+ methods: string[];
2091
+ }[] | undefined;
2092
+ includeTestRuntimeWiring?: boolean | undefined;
2093
+ } | undefined;
1912
2094
  } | undefined;
1913
2095
  rules?: {
1914
2096
  mode?: "strict" | "default" | "recommended" | undefined;
@@ -1929,6 +2111,9 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1929
2111
  maxMemoryMb?: number | undefined;
1930
2112
  redactSecrets?: boolean | undefined;
1931
2113
  } | undefined;
2114
+ report?: {
2115
+ privacy?: "private" | "anonymized" | undefined;
2116
+ } | undefined;
1932
2117
  surfaces?: {
1933
2118
  cli?: {
1934
2119
  bin?: string | undefined;
@@ -1983,6 +2168,11 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
1983
2168
  agentId?: string | undefined;
1984
2169
  agentRoot?: string | undefined;
1985
2170
  runnerModule?: string | undefined;
2171
+ deterministic?: boolean | undefined;
2172
+ timeoutMs?: number | undefined;
2173
+ maxTokens?: number | undefined;
2174
+ maxResponseBytes?: number | undefined;
2175
+ maxConcurrency?: number | undefined;
1986
2176
  } | undefined;
1987
2177
  } | undefined;
1988
2178
  conformance?: {
@@ -2015,8 +2205,8 @@ declare const DocBridgeConfigV1Schema: z.ZodObject<{
2015
2205
  productId: string;
2016
2206
  } | undefined;
2017
2207
  exceptions?: {
2018
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
2019
2208
  reason: string;
2209
+ ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
2020
2210
  approvedBy: string;
2021
2211
  trackingUrl: string;
2022
2212
  }[] | undefined;
@@ -2033,6 +2223,7 @@ type RuleSeverity = z.infer<typeof RuleSeveritySchema>;
2033
2223
  type RulesConfig = z.infer<typeof RulesConfigSchema>;
2034
2224
  type WorkflowConfig = z.infer<typeof WorkflowConfigSchema>;
2035
2225
  type RepositorySafetyConfig = z.infer<typeof RepositorySafetyConfigSchema>;
2226
+ type ReportConfig = z.infer<typeof ReportConfigSchema>;
2036
2227
 
2037
2228
  /** Type-safe config helper for `doc-bridge.config.ts`. */
2038
2229
  declare const defineConfig: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
@@ -2057,4 +2248,4 @@ declare const resolveProjectRoot: (start?: string) => string;
2057
2248
  /** Project root for a loaded config file path (directory of the config). */
2058
2249
  declare const projectRootFromConfigPath: (configFilePath: string, projectRootField?: string) => string;
2059
2250
 
2060
- 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, type ReconciliationConfig as v, ReconciliationConfigSchema as w };
2251
+ 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 ReportConfig as i, ReportConfigSchema as j, type RepositorySafetyConfig as k, RepositorySafetyConfigSchema as l, RuleIdSchema as m, RuleSeveritySchema as n, RulesConfigSchema as o, WorkflowConfigSchema as p, applyConfigDefaults as q, defineConfig as r, loadConfig as s, projectRootFromConfigPath as t, resolveProjectRoot as u, AgentCorpusConfigSchema as v, ConformanceConfigSchema as w, type ReconciliationConfig as x, ReconciliationConfigSchema as y };