@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.
- package/CHANGELOG.md +249 -0
- package/action.yml +1 -1
- package/dist/cli/program.js +793 -137
- package/dist/cli/program.js.map +1 -1
- package/dist/config/index.d.ts +1 -1
- package/dist/config/index.js +38 -2
- package/dist/config/index.js.map +1 -1
- package/dist/{index-DudNuwI5.d.ts → index-C2PCQSrB.d.ts} +216 -25
- package/dist/index.d.ts +837 -67
- package/dist/index.js +858 -127
- package/dist/index.js.map +1 -1
- package/docs/PRD-enterprise-hardening.md +288 -0
- package/docs/adr/0001-enterprise-verification-contract.md +35 -0
- package/docs/knowledge-engine-runbook.md +18 -2
- package/docs/spec/analyzer-plugin-v1.md +24 -0
- package/docs/spec/benchmark-v1.md +30 -0
- package/docs/spec/config-v1.md +111 -0
- package/docs/validation-cycle-plan.md +236 -0
- package/docs/verification-harness.md +33 -4
- package/mcpb/manifest.json +1 -1
- package/package.json +1 -1
- package/scripts/report-visual-check.mjs +63 -17
- package/scripts/verification-harness.mjs +216 -13
- package/skills/doc-bridge-handoff/scripts/resolve-handoff.mjs +1 -1
- package/src/agents/registry-adapter.ts +31 -7
- package/src/cli/program.ts +44 -11
- package/src/config/index.ts +2 -0
- package/src/config/schema.ts +56 -0
- package/src/discovery/documentation.ts +46 -5
- package/src/discovery/repository.ts +95 -16
- package/src/index.ts +29 -0
- package/src/metrics/benchmark.ts +176 -0
- package/src/plugins/contract.ts +89 -0
- package/src/reconciliation/reconcile.ts +137 -3
- package/src/report/html.ts +302 -78
- package/src/schemas/knowledge.ts +16 -1
- package/src/version.ts +1 -1
- 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
|
|
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 };
|