@agentskit/doc-bridge 1.6.4 → 1.7.45

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 (64) hide show
  1. package/CHANGELOG.md +249 -0
  2. package/CONTRIBUTING.md +6 -4
  3. package/action.yml +1 -1
  4. package/dist/cli/program.js +1139 -294
  5. package/dist/cli/program.js.map +1 -1
  6. package/dist/config/index.d.ts +1 -1
  7. package/dist/config/index.js +43 -5
  8. package/dist/config/index.js.map +1 -1
  9. package/dist/index-BUL0q7s8.d.ts +660 -0
  10. package/dist/index.d.ts +817 -2134
  11. package/dist/index.js +1154 -244
  12. package/dist/index.js.map +1 -1
  13. package/docs/PRD-enterprise-hardening.md +288 -0
  14. package/docs/RELEASE.md +22 -8
  15. package/docs/adr/0001-enterprise-verification-contract.md +35 -0
  16. package/docs/agent-corpus/INDEX.md +2 -2
  17. package/docs/agent-corpus/chat.md +2 -2
  18. package/docs/agent-corpus/cli.md +2 -2
  19. package/docs/agent-corpus/conformance.md +2 -2
  20. package/docs/agent-corpus/doc-bridge.md +1 -1
  21. package/docs/agent-corpus/doctor.md +2 -2
  22. package/docs/agent-corpus/gates.md +2 -2
  23. package/docs/agent-corpus/mcp.md +2 -2
  24. package/docs/agent-corpus/memory.md +2 -2
  25. package/docs/agent-corpus/query.md +2 -2
  26. package/docs/knowledge-engine-runbook.md +30 -2
  27. package/docs/spec/analyzer-plugin-v1.md +24 -0
  28. package/docs/spec/benchmark-v1.md +36 -0
  29. package/docs/spec/config-v1.md +156 -0
  30. package/docs/validation-cycle-plan.md +255 -0
  31. package/docs/verification-harness.md +37 -4
  32. package/mcpb/manifest.json +1 -1
  33. package/package.json +68 -70
  34. package/scripts/check-ecosystem-upstream.mjs +3 -2
  35. package/scripts/report-visual-check.mjs +64 -12
  36. package/scripts/verification-harness.mjs +216 -14
  37. package/skills/doc-bridge-handoff/scripts/resolve-handoff.mjs +1 -1
  38. package/src/agents/registry-adapter.ts +31 -7
  39. package/src/cli/demo.ts +2 -2
  40. package/src/cli/program.ts +59 -16
  41. package/src/config/index.ts +2 -0
  42. package/src/config/load-config.ts +7 -1
  43. package/src/config/schema.ts +60 -2
  44. package/src/conformance/documentation-standard-v1.ts +14 -8
  45. package/src/discovery/documentation.ts +90 -23
  46. package/src/discovery/repository.ts +147 -19
  47. package/src/doctor/run-doctor.ts +2 -15
  48. package/src/federation/llms.ts +72 -20
  49. package/src/fixes/proposals.ts +4 -3
  50. package/src/index-builder/human-adapters/fumadocs.ts +1 -1
  51. package/src/index-builder/watch-index.ts +1 -1
  52. package/src/index.ts +29 -0
  53. package/src/lib/bounded-text.ts +15 -10
  54. package/src/metrics/benchmark.ts +176 -0
  55. package/src/plugins/contract.ts +89 -0
  56. package/src/reconciliation/reconcile.ts +181 -5
  57. package/src/report/html.ts +318 -88
  58. package/src/rules/engine.ts +15 -2
  59. package/src/safety/repository.ts +1 -1
  60. package/src/schemas/knowledge.ts +21 -3
  61. package/src/validate.ts +7 -1
  62. package/src/version.ts +1 -1
  63. package/src/workflow/engine.ts +65 -9
  64. package/dist/index-DudNuwI5.d.ts +0 -2060
@@ -1,2060 +0,0 @@
1
- import { z } from 'zod';
2
-
3
- declare const AgentCorpusConfigSchema: z.ZodObject<{
4
- root: z.ZodString;
5
- index: z.ZodOptional<z.ZodString>;
6
- include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7
- exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
8
- okf: z.ZodOptional<z.ZodObject<{
9
- requireType: z.ZodOptional<z.ZodBoolean>;
10
- allowedTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
11
- }, "strict", z.ZodTypeAny, {
12
- requireType?: boolean | undefined;
13
- allowedTypes?: string[] | undefined;
14
- }, {
15
- requireType?: boolean | undefined;
16
- allowedTypes?: string[] | undefined;
17
- }>>;
18
- }, "strict", z.ZodTypeAny, {
19
- root: string;
20
- index?: string | undefined;
21
- include?: string[] | undefined;
22
- exclude?: string[] | undefined;
23
- okf?: {
24
- requireType?: boolean | undefined;
25
- allowedTypes?: string[] | undefined;
26
- } | undefined;
27
- }, {
28
- root: string;
29
- index?: string | undefined;
30
- include?: string[] | undefined;
31
- exclude?: string[] | undefined;
32
- okf?: {
33
- requireType?: boolean | undefined;
34
- allowedTypes?: string[] | undefined;
35
- } | undefined;
36
- }>;
37
- declare const HumanCorpusConfigSchema: z.ZodObject<{
38
- plugin: z.ZodEnum<["plain-markdown", "fumadocs", "docusaurus", "mkdocs", "vitepress", "starlight", "nextra", "custom"]>;
39
- options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
40
- }, "strict", z.ZodTypeAny, {
41
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
42
- options?: Record<string, unknown> | undefined;
43
- }, {
44
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
45
- options?: Record<string, unknown> | undefined;
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 ReconciliationConfigSchema: z.ZodObject<{
72
- /** Relation kinds that must have documentation declarations. Omit to require all observed kinds; [] disables this signal. */
73
- requiredRelationKinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
74
- }, "strict", z.ZodTypeAny, {
75
- requiredRelationKinds?: string[] | undefined;
76
- }, {
77
- requiredRelationKinds?: string[] | undefined;
78
- }>;
79
- declare const WorkflowConfigSchema: z.ZodObject<{
80
- stateDir: z.ZodOptional<z.ZodString>;
81
- }, "strict", z.ZodTypeAny, {
82
- stateDir?: string | undefined;
83
- }, {
84
- stateDir?: string | undefined;
85
- }>;
86
- declare const RepositorySafetyConfigSchema: z.ZodObject<{
87
- exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
88
- maxFiles: z.ZodOptional<z.ZodNumber>;
89
- maxBytes: z.ZodOptional<z.ZodNumber>;
90
- maxTimeMs: z.ZodOptional<z.ZodNumber>;
91
- maxMemoryMb: z.ZodOptional<z.ZodNumber>;
92
- redactSecrets: z.ZodOptional<z.ZodBoolean>;
93
- }, "strict", z.ZodTypeAny, {
94
- exclude?: string[] | undefined;
95
- maxFiles?: number | undefined;
96
- maxBytes?: number | undefined;
97
- maxTimeMs?: number | undefined;
98
- maxMemoryMb?: number | undefined;
99
- redactSecrets?: boolean | undefined;
100
- }, {
101
- exclude?: string[] | undefined;
102
- maxFiles?: number | undefined;
103
- maxBytes?: number | undefined;
104
- maxTimeMs?: number | undefined;
105
- maxMemoryMb?: number | undefined;
106
- redactSecrets?: boolean | undefined;
107
- }>;
108
- declare const EcosystemContractEvidenceSchema: z.ZodObject<{
109
- manifest: z.ZodString;
110
- claims: z.ZodString;
111
- productId: z.ZodString;
112
- }, "strict", z.ZodTypeAny, {
113
- manifest: string;
114
- claims: string;
115
- productId: string;
116
- }, {
117
- manifest: string;
118
- claims: string;
119
- productId: string;
120
- }>;
121
- declare const DocumentationStandardRuleIdSchema: z.ZodEnum<["human-docs", "llms-and-raw-source", "agent-handoffs", "contribution", "metadata", "cross-links", "tested-quickstarts", "visual-explanations", "structured-diagrams"]>;
122
- declare const DocumentationStandardV1ConfigSchema: z.ZodEffects<z.ZodObject<{
123
- rawSources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
124
- contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
125
- metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
126
- path: z.ZodString;
127
- contains: z.ZodArray<z.ZodString, "many">;
128
- }, "strict", z.ZodTypeAny, {
129
- path: string;
130
- contains: string[];
131
- }, {
132
- path: string;
133
- contains: string[];
134
- }>, "many">>;
135
- links: z.ZodOptional<z.ZodArray<z.ZodObject<{
136
- url: z.ZodString;
137
- paths: z.ZodArray<z.ZodString, "many">;
138
- }, "strict", z.ZodTypeAny, {
139
- paths: string[];
140
- url: string;
141
- }, {
142
- paths: string[];
143
- url: string;
144
- }>, "many">>;
145
- quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
146
- id: z.ZodString;
147
- doc: z.ZodString;
148
- test: z.ZodString;
149
- command: z.ZodString;
150
- testContains: z.ZodArray<z.ZodString, "many">;
151
- }, "strict", z.ZodTypeAny, {
152
- id: string;
153
- doc: string;
154
- test: string;
155
- command: string;
156
- testContains: string[];
157
- }, {
158
- id: string;
159
- doc: string;
160
- test: string;
161
- command: string;
162
- testContains: string[];
163
- }>, "many">>;
164
- visuals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
165
- diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
166
- path: z.ZodString;
167
- contains: z.ZodArray<z.ZodString, "many">;
168
- }, "strict", z.ZodTypeAny, {
169
- path: string;
170
- contains: string[];
171
- }, {
172
- path: string;
173
- contains: string[];
174
- }>, "many">>;
175
- ecosystemContract: z.ZodOptional<z.ZodObject<{
176
- manifest: z.ZodString;
177
- claims: z.ZodString;
178
- productId: z.ZodString;
179
- }, "strict", z.ZodTypeAny, {
180
- manifest: string;
181
- claims: string;
182
- productId: string;
183
- }, {
184
- manifest: string;
185
- claims: string;
186
- productId: string;
187
- }>>;
188
- exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
189
- ruleId: z.ZodEnum<["human-docs", "llms-and-raw-source", "agent-handoffs", "contribution", "metadata", "cross-links", "tested-quickstarts", "visual-explanations", "structured-diagrams"]>;
190
- reason: z.ZodString;
191
- approvedBy: z.ZodString;
192
- trackingUrl: z.ZodString;
193
- }, "strict", z.ZodTypeAny, {
194
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
195
- reason: string;
196
- approvedBy: string;
197
- trackingUrl: string;
198
- }, {
199
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
200
- reason: string;
201
- approvedBy: string;
202
- trackingUrl: string;
203
- }>, "many">>;
204
- }, "strict", z.ZodTypeAny, {
205
- metadata?: {
206
- path: string;
207
- contains: string[];
208
- }[] | undefined;
209
- rawSources?: string[] | undefined;
210
- contributionPaths?: string[] | undefined;
211
- links?: {
212
- paths: string[];
213
- url: string;
214
- }[] | undefined;
215
- quickstarts?: {
216
- id: string;
217
- doc: string;
218
- test: string;
219
- command: string;
220
- testContains: string[];
221
- }[] | undefined;
222
- visuals?: string[] | undefined;
223
- diagrams?: {
224
- path: string;
225
- contains: string[];
226
- }[] | undefined;
227
- ecosystemContract?: {
228
- manifest: string;
229
- claims: string;
230
- productId: string;
231
- } | undefined;
232
- exceptions?: {
233
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
234
- reason: string;
235
- approvedBy: string;
236
- trackingUrl: string;
237
- }[] | undefined;
238
- }, {
239
- metadata?: {
240
- path: string;
241
- contains: string[];
242
- }[] | undefined;
243
- rawSources?: string[] | undefined;
244
- contributionPaths?: string[] | undefined;
245
- links?: {
246
- paths: string[];
247
- url: string;
248
- }[] | undefined;
249
- quickstarts?: {
250
- id: string;
251
- doc: string;
252
- test: string;
253
- command: string;
254
- testContains: string[];
255
- }[] | undefined;
256
- visuals?: string[] | undefined;
257
- diagrams?: {
258
- path: string;
259
- contains: string[];
260
- }[] | undefined;
261
- ecosystemContract?: {
262
- manifest: string;
263
- claims: string;
264
- productId: string;
265
- } | undefined;
266
- exceptions?: {
267
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
268
- reason: string;
269
- approvedBy: string;
270
- trackingUrl: string;
271
- }[] | undefined;
272
- }>, {
273
- metadata?: {
274
- path: string;
275
- contains: string[];
276
- }[] | undefined;
277
- rawSources?: string[] | undefined;
278
- contributionPaths?: string[] | undefined;
279
- links?: {
280
- paths: string[];
281
- url: string;
282
- }[] | undefined;
283
- quickstarts?: {
284
- id: string;
285
- doc: string;
286
- test: string;
287
- command: string;
288
- testContains: string[];
289
- }[] | undefined;
290
- visuals?: string[] | undefined;
291
- diagrams?: {
292
- path: string;
293
- contains: string[];
294
- }[] | undefined;
295
- ecosystemContract?: {
296
- manifest: string;
297
- claims: string;
298
- productId: string;
299
- } | undefined;
300
- exceptions?: {
301
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
302
- reason: string;
303
- approvedBy: string;
304
- trackingUrl: string;
305
- }[] | undefined;
306
- }, {
307
- metadata?: {
308
- path: string;
309
- contains: string[];
310
- }[] | undefined;
311
- rawSources?: string[] | undefined;
312
- contributionPaths?: string[] | undefined;
313
- links?: {
314
- paths: string[];
315
- url: string;
316
- }[] | undefined;
317
- quickstarts?: {
318
- id: string;
319
- doc: string;
320
- test: string;
321
- command: string;
322
- testContains: string[];
323
- }[] | undefined;
324
- visuals?: string[] | undefined;
325
- diagrams?: {
326
- path: string;
327
- contains: string[];
328
- }[] | undefined;
329
- ecosystemContract?: {
330
- manifest: string;
331
- claims: string;
332
- productId: string;
333
- } | undefined;
334
- exceptions?: {
335
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
336
- reason: string;
337
- approvedBy: string;
338
- trackingUrl: string;
339
- }[] | undefined;
340
- }>;
341
- declare const ConformanceConfigSchema: z.ZodObject<{
342
- documentationStandardV1: z.ZodOptional<z.ZodEffects<z.ZodObject<{
343
- rawSources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
344
- contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
345
- metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
346
- path: z.ZodString;
347
- contains: z.ZodArray<z.ZodString, "many">;
348
- }, "strict", z.ZodTypeAny, {
349
- path: string;
350
- contains: string[];
351
- }, {
352
- path: string;
353
- contains: string[];
354
- }>, "many">>;
355
- links: z.ZodOptional<z.ZodArray<z.ZodObject<{
356
- url: z.ZodString;
357
- paths: z.ZodArray<z.ZodString, "many">;
358
- }, "strict", z.ZodTypeAny, {
359
- paths: string[];
360
- url: string;
361
- }, {
362
- paths: string[];
363
- url: string;
364
- }>, "many">>;
365
- quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
366
- id: z.ZodString;
367
- doc: z.ZodString;
368
- test: z.ZodString;
369
- command: z.ZodString;
370
- testContains: z.ZodArray<z.ZodString, "many">;
371
- }, "strict", z.ZodTypeAny, {
372
- id: string;
373
- doc: string;
374
- test: string;
375
- command: string;
376
- testContains: string[];
377
- }, {
378
- id: string;
379
- doc: string;
380
- test: string;
381
- command: string;
382
- testContains: string[];
383
- }>, "many">>;
384
- visuals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
385
- diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
386
- path: z.ZodString;
387
- contains: z.ZodArray<z.ZodString, "many">;
388
- }, "strict", z.ZodTypeAny, {
389
- path: string;
390
- contains: string[];
391
- }, {
392
- path: string;
393
- contains: string[];
394
- }>, "many">>;
395
- ecosystemContract: z.ZodOptional<z.ZodObject<{
396
- manifest: z.ZodString;
397
- claims: z.ZodString;
398
- productId: z.ZodString;
399
- }, "strict", z.ZodTypeAny, {
400
- manifest: string;
401
- claims: string;
402
- productId: string;
403
- }, {
404
- manifest: string;
405
- claims: string;
406
- productId: string;
407
- }>>;
408
- exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
409
- ruleId: z.ZodEnum<["human-docs", "llms-and-raw-source", "agent-handoffs", "contribution", "metadata", "cross-links", "tested-quickstarts", "visual-explanations", "structured-diagrams"]>;
410
- reason: z.ZodString;
411
- approvedBy: z.ZodString;
412
- trackingUrl: z.ZodString;
413
- }, "strict", z.ZodTypeAny, {
414
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
415
- reason: string;
416
- approvedBy: string;
417
- trackingUrl: string;
418
- }, {
419
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
420
- reason: string;
421
- approvedBy: string;
422
- trackingUrl: string;
423
- }>, "many">>;
424
- }, "strict", z.ZodTypeAny, {
425
- metadata?: {
426
- path: string;
427
- contains: string[];
428
- }[] | undefined;
429
- rawSources?: string[] | undefined;
430
- contributionPaths?: string[] | undefined;
431
- links?: {
432
- paths: string[];
433
- url: string;
434
- }[] | undefined;
435
- quickstarts?: {
436
- id: string;
437
- doc: string;
438
- test: string;
439
- command: string;
440
- testContains: string[];
441
- }[] | undefined;
442
- visuals?: string[] | undefined;
443
- diagrams?: {
444
- path: string;
445
- contains: string[];
446
- }[] | undefined;
447
- ecosystemContract?: {
448
- manifest: string;
449
- claims: string;
450
- productId: string;
451
- } | undefined;
452
- exceptions?: {
453
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
454
- reason: string;
455
- approvedBy: string;
456
- trackingUrl: string;
457
- }[] | undefined;
458
- }, {
459
- metadata?: {
460
- path: string;
461
- contains: string[];
462
- }[] | undefined;
463
- rawSources?: string[] | undefined;
464
- contributionPaths?: string[] | undefined;
465
- links?: {
466
- paths: string[];
467
- url: string;
468
- }[] | undefined;
469
- quickstarts?: {
470
- id: string;
471
- doc: string;
472
- test: string;
473
- command: string;
474
- testContains: string[];
475
- }[] | undefined;
476
- visuals?: string[] | undefined;
477
- diagrams?: {
478
- path: string;
479
- contains: string[];
480
- }[] | undefined;
481
- ecosystemContract?: {
482
- manifest: string;
483
- claims: string;
484
- productId: string;
485
- } | undefined;
486
- exceptions?: {
487
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
488
- reason: string;
489
- approvedBy: string;
490
- trackingUrl: string;
491
- }[] | undefined;
492
- }>, {
493
- metadata?: {
494
- path: string;
495
- contains: string[];
496
- }[] | undefined;
497
- rawSources?: string[] | undefined;
498
- contributionPaths?: string[] | undefined;
499
- links?: {
500
- paths: string[];
501
- url: string;
502
- }[] | undefined;
503
- quickstarts?: {
504
- id: string;
505
- doc: string;
506
- test: string;
507
- command: string;
508
- testContains: string[];
509
- }[] | undefined;
510
- visuals?: string[] | undefined;
511
- diagrams?: {
512
- path: string;
513
- contains: string[];
514
- }[] | undefined;
515
- ecosystemContract?: {
516
- manifest: string;
517
- claims: string;
518
- productId: string;
519
- } | undefined;
520
- exceptions?: {
521
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
522
- reason: string;
523
- approvedBy: string;
524
- trackingUrl: string;
525
- }[] | undefined;
526
- }, {
527
- metadata?: {
528
- path: string;
529
- contains: string[];
530
- }[] | undefined;
531
- rawSources?: string[] | undefined;
532
- contributionPaths?: string[] | undefined;
533
- links?: {
534
- paths: string[];
535
- url: string;
536
- }[] | undefined;
537
- quickstarts?: {
538
- id: string;
539
- doc: string;
540
- test: string;
541
- command: string;
542
- testContains: string[];
543
- }[] | undefined;
544
- visuals?: string[] | undefined;
545
- diagrams?: {
546
- path: string;
547
- contains: string[];
548
- }[] | undefined;
549
- ecosystemContract?: {
550
- manifest: string;
551
- claims: string;
552
- productId: string;
553
- } | undefined;
554
- exceptions?: {
555
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
556
- reason: string;
557
- approvedBy: string;
558
- trackingUrl: string;
559
- }[] | undefined;
560
- }>>;
561
- }, "strict", z.ZodTypeAny, {
562
- documentationStandardV1?: {
563
- metadata?: {
564
- path: string;
565
- contains: string[];
566
- }[] | undefined;
567
- rawSources?: string[] | undefined;
568
- contributionPaths?: string[] | undefined;
569
- links?: {
570
- paths: string[];
571
- url: string;
572
- }[] | undefined;
573
- quickstarts?: {
574
- id: string;
575
- doc: string;
576
- test: string;
577
- command: string;
578
- testContains: string[];
579
- }[] | undefined;
580
- visuals?: string[] | undefined;
581
- diagrams?: {
582
- path: string;
583
- contains: string[];
584
- }[] | undefined;
585
- ecosystemContract?: {
586
- manifest: string;
587
- claims: string;
588
- productId: string;
589
- } | undefined;
590
- exceptions?: {
591
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
592
- reason: string;
593
- approvedBy: string;
594
- trackingUrl: string;
595
- }[] | undefined;
596
- } | undefined;
597
- }, {
598
- documentationStandardV1?: {
599
- metadata?: {
600
- path: string;
601
- contains: string[];
602
- }[] | undefined;
603
- rawSources?: string[] | undefined;
604
- contributionPaths?: string[] | undefined;
605
- links?: {
606
- paths: string[];
607
- url: string;
608
- }[] | undefined;
609
- quickstarts?: {
610
- id: string;
611
- doc: string;
612
- test: string;
613
- command: string;
614
- testContains: string[];
615
- }[] | undefined;
616
- visuals?: string[] | undefined;
617
- diagrams?: {
618
- path: string;
619
- contains: string[];
620
- }[] | undefined;
621
- ecosystemContract?: {
622
- manifest: string;
623
- claims: string;
624
- productId: string;
625
- } | undefined;
626
- exceptions?: {
627
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
628
- reason: string;
629
- approvedBy: string;
630
- trackingUrl: string;
631
- }[] | undefined;
632
- } | undefined;
633
- }>;
634
- declare const DocBridgeConfigV1Schema: z.ZodObject<{
635
- schemaVersion: z.ZodLiteral<1>;
636
- project: z.ZodOptional<z.ZodObject<{
637
- name: z.ZodOptional<z.ZodString>;
638
- root: z.ZodOptional<z.ZodString>;
639
- }, "strict", z.ZodTypeAny, {
640
- root?: string | undefined;
641
- name?: string | undefined;
642
- }, {
643
- root?: string | undefined;
644
- name?: string | undefined;
645
- }>>;
646
- corpus: z.ZodObject<{
647
- agent: z.ZodObject<{
648
- root: z.ZodString;
649
- index: z.ZodOptional<z.ZodString>;
650
- include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
651
- exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
652
- okf: z.ZodOptional<z.ZodObject<{
653
- requireType: z.ZodOptional<z.ZodBoolean>;
654
- allowedTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
655
- }, "strict", z.ZodTypeAny, {
656
- requireType?: boolean | undefined;
657
- allowedTypes?: string[] | undefined;
658
- }, {
659
- requireType?: boolean | undefined;
660
- allowedTypes?: string[] | undefined;
661
- }>>;
662
- }, "strict", z.ZodTypeAny, {
663
- root: string;
664
- index?: string | undefined;
665
- include?: string[] | undefined;
666
- exclude?: string[] | undefined;
667
- okf?: {
668
- requireType?: boolean | undefined;
669
- allowedTypes?: string[] | undefined;
670
- } | undefined;
671
- }, {
672
- root: string;
673
- index?: string | undefined;
674
- include?: string[] | undefined;
675
- exclude?: string[] | undefined;
676
- okf?: {
677
- requireType?: boolean | undefined;
678
- allowedTypes?: string[] | undefined;
679
- } | undefined;
680
- }>;
681
- human: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
682
- plugin: z.ZodEnum<["plain-markdown", "fumadocs", "docusaurus", "mkdocs", "vitepress", "starlight", "nextra", "custom"]>;
683
- options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
684
- }, "strict", z.ZodTypeAny, {
685
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
686
- options?: Record<string, unknown> | undefined;
687
- }, {
688
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
689
- options?: Record<string, unknown> | undefined;
690
- }>, z.ZodArray<z.ZodObject<{
691
- plugin: z.ZodEnum<["plain-markdown", "fumadocs", "docusaurus", "mkdocs", "vitepress", "starlight", "nextra", "custom"]>;
692
- options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
693
- }, "strict", z.ZodTypeAny, {
694
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
695
- options?: Record<string, unknown> | undefined;
696
- }, {
697
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
698
- options?: Record<string, unknown> | undefined;
699
- }>, "many">]>>;
700
- }, "strict", z.ZodTypeAny, {
701
- agent: {
702
- root: string;
703
- index?: string | undefined;
704
- include?: string[] | undefined;
705
- exclude?: string[] | undefined;
706
- okf?: {
707
- requireType?: boolean | undefined;
708
- allowedTypes?: string[] | undefined;
709
- } | undefined;
710
- };
711
- human?: {
712
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
713
- options?: Record<string, unknown> | undefined;
714
- } | {
715
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
716
- options?: Record<string, unknown> | undefined;
717
- }[] | undefined;
718
- }, {
719
- agent: {
720
- root: string;
721
- index?: string | undefined;
722
- include?: string[] | undefined;
723
- exclude?: string[] | undefined;
724
- okf?: {
725
- requireType?: boolean | undefined;
726
- allowedTypes?: string[] | undefined;
727
- } | undefined;
728
- };
729
- human?: {
730
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
731
- options?: Record<string, unknown> | undefined;
732
- } | {
733
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
734
- options?: Record<string, unknown> | undefined;
735
- }[] | undefined;
736
- }>;
737
- index: z.ZodOptional<z.ZodObject<{
738
- outFile: z.ZodOptional<z.ZodString>;
739
- llmsTxt: z.ZodOptional<z.ZodObject<{
740
- enabled: z.ZodOptional<z.ZodBoolean>;
741
- outFile: z.ZodOptional<z.ZodString>;
742
- preamble: z.ZodOptional<z.ZodString>;
743
- urlPrefix: z.ZodOptional<z.ZodString>;
744
- pathPrefix: z.ZodOptional<z.ZodString>;
745
- }, "strict", z.ZodTypeAny, {
746
- outFile?: string | undefined;
747
- enabled?: boolean | undefined;
748
- preamble?: string | undefined;
749
- urlPrefix?: string | undefined;
750
- pathPrefix?: string | undefined;
751
- }, {
752
- outFile?: string | undefined;
753
- enabled?: boolean | undefined;
754
- preamble?: string | undefined;
755
- urlPrefix?: string | undefined;
756
- pathPrefix?: string | undefined;
757
- }>>;
758
- capabilities: z.ZodOptional<z.ZodObject<{
759
- enabled: z.ZodOptional<z.ZodBoolean>;
760
- outFile: z.ZodOptional<z.ZodString>;
761
- }, "strict", z.ZodTypeAny, {
762
- outFile?: string | undefined;
763
- enabled?: boolean | undefined;
764
- }, {
765
- outFile?: string | undefined;
766
- enabled?: boolean | undefined;
767
- }>>;
768
- contentHash: z.ZodOptional<z.ZodLiteral<"sha256-normalized-v1">>;
769
- }, "strict", z.ZodTypeAny, {
770
- outFile?: string | undefined;
771
- llmsTxt?: {
772
- outFile?: string | undefined;
773
- enabled?: boolean | undefined;
774
- preamble?: string | undefined;
775
- urlPrefix?: string | undefined;
776
- pathPrefix?: string | undefined;
777
- } | undefined;
778
- capabilities?: {
779
- outFile?: string | undefined;
780
- enabled?: boolean | undefined;
781
- } | undefined;
782
- contentHash?: "sha256-normalized-v1" | undefined;
783
- }, {
784
- outFile?: string | undefined;
785
- llmsTxt?: {
786
- outFile?: string | undefined;
787
- enabled?: boolean | undefined;
788
- preamble?: string | undefined;
789
- urlPrefix?: string | undefined;
790
- pathPrefix?: string | undefined;
791
- } | undefined;
792
- capabilities?: {
793
- outFile?: string | undefined;
794
- enabled?: boolean | undefined;
795
- } | undefined;
796
- contentHash?: "sha256-normalized-v1" | undefined;
797
- }>>;
798
- routing: z.ZodOptional<z.ZodObject<{
799
- plugin: z.ZodOptional<z.ZodEnum<["pnpm-monorepo", "npm-workspaces", "yarn-workspaces", "nx", "pattern-files", "custom"]>>;
800
- options: z.ZodOptional<z.ZodObject<{
801
- packages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
802
- /** Infer ownership from corpus paths/frontmatter (default true). */
803
- ownershipFromCorpus: z.ZodOptional<z.ZodBoolean>;
804
- ownership: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
805
- path: z.ZodString;
806
- group: z.ZodOptional<z.ZodString>;
807
- layer: z.ZodOptional<z.ZodString>;
808
- purpose: z.ZodOptional<z.ZodString>;
809
- checks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
810
- agentDoc: z.ZodOptional<z.ZodString>;
811
- humanDoc: z.ZodOptional<z.ZodString>;
812
- }, "strict", z.ZodTypeAny, {
813
- path: string;
814
- group?: string | undefined;
815
- layer?: string | undefined;
816
- purpose?: string | undefined;
817
- checks?: string[] | undefined;
818
- agentDoc?: string | undefined;
819
- humanDoc?: string | undefined;
820
- }, {
821
- path: string;
822
- group?: string | undefined;
823
- layer?: string | undefined;
824
- purpose?: string | undefined;
825
- checks?: string[] | undefined;
826
- agentDoc?: string | undefined;
827
- humanDoc?: string | undefined;
828
- }>>>;
829
- intents: z.ZodOptional<z.ZodArray<z.ZodObject<{
830
- id: z.ZodString;
831
- title: z.ZodString;
832
- paths: z.ZodArray<z.ZodString, "many">;
833
- }, "strict", z.ZodTypeAny, {
834
- id: string;
835
- title: string;
836
- paths: string[];
837
- }, {
838
- id: string;
839
- title: string;
840
- paths: string[];
841
- }>, "many">>;
842
- changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
843
- id: z.ZodString;
844
- title: z.ZodString;
845
- startHere: z.ZodString;
846
- relatedPackages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
847
- }, "strict", z.ZodTypeAny, {
848
- id: string;
849
- title: string;
850
- startHere: string;
851
- relatedPackages?: string[] | undefined;
852
- }, {
853
- id: string;
854
- title: string;
855
- startHere: string;
856
- relatedPackages?: string[] | undefined;
857
- }>, "many">>;
858
- }, "strict", z.ZodTypeAny, {
859
- packages?: string[] | undefined;
860
- ownershipFromCorpus?: boolean | undefined;
861
- ownership?: Record<string, {
862
- path: string;
863
- group?: string | undefined;
864
- layer?: string | undefined;
865
- purpose?: string | undefined;
866
- checks?: string[] | undefined;
867
- agentDoc?: string | undefined;
868
- humanDoc?: string | undefined;
869
- }> | undefined;
870
- intents?: {
871
- id: string;
872
- title: string;
873
- paths: string[];
874
- }[] | undefined;
875
- changes?: {
876
- id: string;
877
- title: string;
878
- startHere: string;
879
- relatedPackages?: string[] | undefined;
880
- }[] | undefined;
881
- }, {
882
- packages?: string[] | undefined;
883
- ownershipFromCorpus?: boolean | undefined;
884
- ownership?: Record<string, {
885
- path: string;
886
- group?: string | undefined;
887
- layer?: string | undefined;
888
- purpose?: string | undefined;
889
- checks?: string[] | undefined;
890
- agentDoc?: string | undefined;
891
- humanDoc?: string | undefined;
892
- }> | undefined;
893
- intents?: {
894
- id: string;
895
- title: string;
896
- paths: string[];
897
- }[] | undefined;
898
- changes?: {
899
- id: string;
900
- title: string;
901
- startHere: string;
902
- relatedPackages?: string[] | undefined;
903
- }[] | undefined;
904
- }>>;
905
- }, "strict", z.ZodTypeAny, {
906
- options?: {
907
- packages?: string[] | undefined;
908
- ownershipFromCorpus?: boolean | undefined;
909
- ownership?: Record<string, {
910
- path: string;
911
- group?: string | undefined;
912
- layer?: string | undefined;
913
- purpose?: string | undefined;
914
- checks?: string[] | undefined;
915
- agentDoc?: string | undefined;
916
- humanDoc?: string | undefined;
917
- }> | undefined;
918
- intents?: {
919
- id: string;
920
- title: string;
921
- paths: string[];
922
- }[] | undefined;
923
- changes?: {
924
- id: string;
925
- title: string;
926
- startHere: string;
927
- relatedPackages?: string[] | undefined;
928
- }[] | undefined;
929
- } | undefined;
930
- plugin?: "custom" | "pnpm-monorepo" | "npm-workspaces" | "yarn-workspaces" | "nx" | "pattern-files" | undefined;
931
- }, {
932
- options?: {
933
- packages?: string[] | undefined;
934
- ownershipFromCorpus?: boolean | undefined;
935
- ownership?: Record<string, {
936
- path: string;
937
- group?: string | undefined;
938
- layer?: string | undefined;
939
- purpose?: string | undefined;
940
- checks?: string[] | undefined;
941
- agentDoc?: string | undefined;
942
- humanDoc?: string | undefined;
943
- }> | undefined;
944
- intents?: {
945
- id: string;
946
- title: string;
947
- paths: string[];
948
- }[] | undefined;
949
- changes?: {
950
- id: string;
951
- title: string;
952
- startHere: string;
953
- relatedPackages?: string[] | undefined;
954
- }[] | undefined;
955
- } | undefined;
956
- plugin?: "custom" | "pnpm-monorepo" | "npm-workspaces" | "yarn-workspaces" | "nx" | "pattern-files" | undefined;
957
- }>>;
958
- gates: z.ZodOptional<z.ZodObject<{
959
- /** minimal: freshness · standard: + human links · strict: + okf-type · playbook: freshness + okf soft style */
960
- preset: z.ZodOptional<z.ZodEnum<["minimal", "standard", "strict", "playbook"]>>;
961
- include: z.ZodOptional<z.ZodArray<z.ZodEnum<["index-freshness", "human-guide-links", "link-rot", "okf-type", "docs-style", "routing-currency", "bootstrap-size", "documentation-standard-v1"]>, "many">>;
962
- exclude: z.ZodOptional<z.ZodArray<z.ZodEnum<["index-freshness", "human-guide-links", "link-rot", "okf-type", "docs-style", "routing-currency", "bootstrap-size", "documentation-standard-v1"]>, "many">>;
963
- options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
964
- }, "strict", z.ZodTypeAny, {
965
- options?: Record<string, unknown> | undefined;
966
- include?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
967
- exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
968
- preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
969
- }, {
970
- options?: Record<string, unknown> | undefined;
971
- include?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
972
- exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
973
- preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
974
- }>>;
975
- reconciliation: z.ZodOptional<z.ZodObject<{
976
- /** Relation kinds that must have documentation declarations. Omit to require all observed kinds; [] disables this signal. */
977
- requiredRelationKinds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
978
- }, "strict", z.ZodTypeAny, {
979
- requiredRelationKinds?: string[] | undefined;
980
- }, {
981
- requiredRelationKinds?: string[] | undefined;
982
- }>>;
983
- rules: z.ZodOptional<z.ZodObject<{
984
- mode: z.ZodOptional<z.ZodEnum<["default", "recommended", "strict"]>>;
985
- 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"]>>>;
986
- 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">>;
987
- criticalEntities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
988
- criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
989
- 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>>;
990
- }, "strict", z.ZodTypeAny, {
991
- mode?: "strict" | "default" | "recommended" | undefined;
992
- 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;
993
- 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;
994
- criticalEntities?: string[] | undefined;
995
- criticalPaths?: string[] | undefined;
996
- 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;
997
- }, {
998
- mode?: "strict" | "default" | "recommended" | undefined;
999
- 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;
1000
- 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;
1001
- criticalEntities?: string[] | undefined;
1002
- criticalPaths?: string[] | undefined;
1003
- 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;
1004
- }>>;
1005
- workflow: z.ZodOptional<z.ZodObject<{
1006
- stateDir: z.ZodOptional<z.ZodString>;
1007
- }, "strict", z.ZodTypeAny, {
1008
- stateDir?: string | undefined;
1009
- }, {
1010
- stateDir?: string | undefined;
1011
- }>>;
1012
- safety: z.ZodOptional<z.ZodObject<{
1013
- exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1014
- maxFiles: z.ZodOptional<z.ZodNumber>;
1015
- maxBytes: z.ZodOptional<z.ZodNumber>;
1016
- maxTimeMs: z.ZodOptional<z.ZodNumber>;
1017
- maxMemoryMb: z.ZodOptional<z.ZodNumber>;
1018
- redactSecrets: z.ZodOptional<z.ZodBoolean>;
1019
- }, "strict", z.ZodTypeAny, {
1020
- exclude?: string[] | undefined;
1021
- maxFiles?: number | undefined;
1022
- maxBytes?: number | undefined;
1023
- maxTimeMs?: number | undefined;
1024
- maxMemoryMb?: number | undefined;
1025
- redactSecrets?: boolean | undefined;
1026
- }, {
1027
- exclude?: string[] | undefined;
1028
- maxFiles?: number | undefined;
1029
- maxBytes?: number | undefined;
1030
- maxTimeMs?: number | undefined;
1031
- maxMemoryMb?: number | undefined;
1032
- redactSecrets?: boolean | undefined;
1033
- }>>;
1034
- surfaces: z.ZodOptional<z.ZodObject<{
1035
- cli: z.ZodOptional<z.ZodObject<{
1036
- bin: z.ZodOptional<z.ZodString>;
1037
- defaultFormat: z.ZodOptional<z.ZodEnum<["json", "text"]>>;
1038
- }, "strict", z.ZodTypeAny, {
1039
- bin?: string | undefined;
1040
- defaultFormat?: "json" | "text" | undefined;
1041
- }, {
1042
- bin?: string | undefined;
1043
- defaultFormat?: "json" | "text" | undefined;
1044
- }>>;
1045
- mcp: z.ZodOptional<z.ZodObject<{
1046
- enabled: z.ZodOptional<z.ZodBoolean>;
1047
- 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">>;
1048
- transport: z.ZodOptional<z.ZodEnum<["stdio", "http"]>>;
1049
- http: z.ZodOptional<z.ZodObject<{
1050
- port: z.ZodOptional<z.ZodNumber>;
1051
- path: z.ZodOptional<z.ZodString>;
1052
- }, "strict", z.ZodTypeAny, {
1053
- path?: string | undefined;
1054
- port?: number | undefined;
1055
- }, {
1056
- path?: string | undefined;
1057
- port?: number | undefined;
1058
- }>>;
1059
- }, "strict", z.ZodTypeAny, {
1060
- enabled?: boolean | undefined;
1061
- 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;
1062
- http?: {
1063
- path?: string | undefined;
1064
- port?: number | undefined;
1065
- } | undefined;
1066
- transport?: "stdio" | "http" | undefined;
1067
- }, {
1068
- enabled?: boolean | undefined;
1069
- 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;
1070
- http?: {
1071
- path?: string | undefined;
1072
- port?: number | undefined;
1073
- } | undefined;
1074
- transport?: "stdio" | "http" | undefined;
1075
- }>>;
1076
- }, "strict", z.ZodTypeAny, {
1077
- cli?: {
1078
- bin?: string | undefined;
1079
- defaultFormat?: "json" | "text" | undefined;
1080
- } | undefined;
1081
- mcp?: {
1082
- enabled?: boolean | undefined;
1083
- 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;
1084
- http?: {
1085
- path?: string | undefined;
1086
- port?: number | undefined;
1087
- } | undefined;
1088
- transport?: "stdio" | "http" | undefined;
1089
- } | undefined;
1090
- }, {
1091
- cli?: {
1092
- bin?: string | undefined;
1093
- defaultFormat?: "json" | "text" | undefined;
1094
- } | undefined;
1095
- mcp?: {
1096
- enabled?: boolean | undefined;
1097
- 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;
1098
- http?: {
1099
- path?: string | undefined;
1100
- port?: number | undefined;
1101
- } | undefined;
1102
- transport?: "stdio" | "http" | undefined;
1103
- } | undefined;
1104
- }>>;
1105
- intelligence: z.ZodOptional<z.ZodObject<{
1106
- enabled: z.ZodOptional<z.ZodBoolean>;
1107
- adapter: z.ZodOptional<z.ZodObject<{
1108
- provider: z.ZodEnum<["openai", "anthropic", "ollama", "openrouter", "custom"]>;
1109
- model: z.ZodOptional<z.ZodString>;
1110
- apiKeyEnv: z.ZodOptional<z.ZodString>;
1111
- baseUrl: z.ZodOptional<z.ZodString>;
1112
- options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1113
- }, "strict", z.ZodTypeAny, {
1114
- provider: "custom" | "openai" | "anthropic" | "ollama" | "openrouter";
1115
- options?: Record<string, unknown> | undefined;
1116
- model?: string | undefined;
1117
- apiKeyEnv?: string | undefined;
1118
- baseUrl?: string | undefined;
1119
- }, {
1120
- provider: "custom" | "openai" | "anthropic" | "ollama" | "openrouter";
1121
- options?: Record<string, unknown> | undefined;
1122
- model?: string | undefined;
1123
- apiKeyEnv?: string | undefined;
1124
- baseUrl?: string | undefined;
1125
- }>>;
1126
- chat: z.ZodOptional<z.ZodObject<{
1127
- enabled: z.ZodOptional<z.ZodBoolean>;
1128
- sources: z.ZodOptional<z.ZodArray<z.ZodEnum<["agent", "human", "federation"]>, "many">>;
1129
- handoffFirst: z.ZodOptional<z.ZodBoolean>;
1130
- }, "strict", z.ZodTypeAny, {
1131
- enabled?: boolean | undefined;
1132
- sources?: ("agent" | "human" | "federation")[] | undefined;
1133
- handoffFirst?: boolean | undefined;
1134
- }, {
1135
- enabled?: boolean | undefined;
1136
- sources?: ("agent" | "human" | "federation")[] | undefined;
1137
- handoffFirst?: boolean | undefined;
1138
- }>>;
1139
- retriever: z.ZodOptional<z.ZodObject<{
1140
- enabled: z.ZodOptional<z.ZodBoolean>;
1141
- mode: z.ZodOptional<z.ZodEnum<["local", "remote", "bm25", "agentskit-rag"]>>;
1142
- embedModel: z.ZodOptional<z.ZodString>;
1143
- chunkSize: z.ZodOptional<z.ZodNumber>;
1144
- options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1145
- }, "strict", z.ZodTypeAny, {
1146
- options?: Record<string, unknown> | undefined;
1147
- enabled?: boolean | undefined;
1148
- mode?: "local" | "remote" | "bm25" | "agentskit-rag" | undefined;
1149
- embedModel?: string | undefined;
1150
- chunkSize?: number | undefined;
1151
- }, {
1152
- options?: Record<string, unknown> | undefined;
1153
- enabled?: boolean | undefined;
1154
- mode?: "local" | "remote" | "bm25" | "agentskit-rag" | undefined;
1155
- embedModel?: string | undefined;
1156
- chunkSize?: number | undefined;
1157
- }>>;
1158
- memory: z.ZodOptional<z.ZodObject<{
1159
- enabled: z.ZodOptional<z.ZodBoolean>;
1160
- adapters: z.ZodOptional<z.ZodArray<z.ZodEnum<["playbook-memory", "cursor-rules", "session-export", "bootstrap-delta"]>, "many">>;
1161
- ingestDir: z.ZodOptional<z.ZodString>;
1162
- classify: z.ZodOptional<z.ZodBoolean>;
1163
- promote: z.ZodOptional<z.ZodObject<{
1164
- enabled: z.ZodOptional<z.ZodBoolean>;
1165
- targets: z.ZodOptional<z.ZodArray<z.ZodEnum<["agent", "human", "agents-md"]>, "many">>;
1166
- requireApproval: z.ZodOptional<z.ZodBoolean>;
1167
- }, "strict", z.ZodTypeAny, {
1168
- enabled?: boolean | undefined;
1169
- targets?: ("agent" | "human" | "agents-md")[] | undefined;
1170
- requireApproval?: boolean | undefined;
1171
- }, {
1172
- enabled?: boolean | undefined;
1173
- targets?: ("agent" | "human" | "agents-md")[] | undefined;
1174
- requireApproval?: boolean | undefined;
1175
- }>>;
1176
- }, "strict", z.ZodTypeAny, {
1177
- enabled?: boolean | undefined;
1178
- adapters?: ("playbook-memory" | "cursor-rules" | "session-export" | "bootstrap-delta")[] | undefined;
1179
- ingestDir?: string | undefined;
1180
- classify?: boolean | undefined;
1181
- promote?: {
1182
- enabled?: boolean | undefined;
1183
- targets?: ("agent" | "human" | "agents-md")[] | undefined;
1184
- requireApproval?: boolean | undefined;
1185
- } | undefined;
1186
- }, {
1187
- enabled?: boolean | undefined;
1188
- adapters?: ("playbook-memory" | "cursor-rules" | "session-export" | "bootstrap-delta")[] | undefined;
1189
- ingestDir?: string | undefined;
1190
- classify?: boolean | undefined;
1191
- promote?: {
1192
- enabled?: boolean | undefined;
1193
- targets?: ("agent" | "human" | "agents-md")[] | undefined;
1194
- requireApproval?: boolean | undefined;
1195
- } | undefined;
1196
- }>>;
1197
- runtime: z.ZodOptional<z.ZodEnum<["agentskit", "custom"]>>;
1198
- runtimeModule: z.ZodOptional<z.ZodString>;
1199
- registry: z.ZodOptional<z.ZodObject<{
1200
- enabled: z.ZodOptional<z.ZodBoolean>;
1201
- agentId: z.ZodOptional<z.ZodString>;
1202
- agentRoot: z.ZodOptional<z.ZodString>;
1203
- runnerModule: z.ZodOptional<z.ZodString>;
1204
- }, "strict", z.ZodTypeAny, {
1205
- enabled?: boolean | undefined;
1206
- agentId?: string | undefined;
1207
- agentRoot?: string | undefined;
1208
- runnerModule?: string | undefined;
1209
- }, {
1210
- enabled?: boolean | undefined;
1211
- agentId?: string | undefined;
1212
- agentRoot?: string | undefined;
1213
- runnerModule?: string | undefined;
1214
- }>>;
1215
- }, "strict", z.ZodTypeAny, {
1216
- enabled?: boolean | undefined;
1217
- adapter?: {
1218
- provider: "custom" | "openai" | "anthropic" | "ollama" | "openrouter";
1219
- options?: Record<string, unknown> | undefined;
1220
- model?: string | undefined;
1221
- apiKeyEnv?: string | undefined;
1222
- baseUrl?: string | undefined;
1223
- } | undefined;
1224
- chat?: {
1225
- enabled?: boolean | undefined;
1226
- sources?: ("agent" | "human" | "federation")[] | undefined;
1227
- handoffFirst?: boolean | undefined;
1228
- } | undefined;
1229
- retriever?: {
1230
- options?: Record<string, unknown> | undefined;
1231
- enabled?: boolean | undefined;
1232
- mode?: "local" | "remote" | "bm25" | "agentskit-rag" | undefined;
1233
- embedModel?: string | undefined;
1234
- chunkSize?: number | undefined;
1235
- } | undefined;
1236
- memory?: {
1237
- enabled?: boolean | undefined;
1238
- adapters?: ("playbook-memory" | "cursor-rules" | "session-export" | "bootstrap-delta")[] | undefined;
1239
- ingestDir?: string | undefined;
1240
- classify?: boolean | undefined;
1241
- promote?: {
1242
- enabled?: boolean | undefined;
1243
- targets?: ("agent" | "human" | "agents-md")[] | undefined;
1244
- requireApproval?: boolean | undefined;
1245
- } | undefined;
1246
- } | undefined;
1247
- runtime?: "custom" | "agentskit" | undefined;
1248
- runtimeModule?: string | undefined;
1249
- registry?: {
1250
- enabled?: boolean | undefined;
1251
- agentId?: string | undefined;
1252
- agentRoot?: string | undefined;
1253
- runnerModule?: string | undefined;
1254
- } | undefined;
1255
- }, {
1256
- enabled?: boolean | undefined;
1257
- adapter?: {
1258
- provider: "custom" | "openai" | "anthropic" | "ollama" | "openrouter";
1259
- options?: Record<string, unknown> | undefined;
1260
- model?: string | undefined;
1261
- apiKeyEnv?: string | undefined;
1262
- baseUrl?: string | undefined;
1263
- } | undefined;
1264
- chat?: {
1265
- enabled?: boolean | undefined;
1266
- sources?: ("agent" | "human" | "federation")[] | undefined;
1267
- handoffFirst?: boolean | undefined;
1268
- } | undefined;
1269
- retriever?: {
1270
- options?: Record<string, unknown> | undefined;
1271
- enabled?: boolean | undefined;
1272
- mode?: "local" | "remote" | "bm25" | "agentskit-rag" | undefined;
1273
- embedModel?: string | undefined;
1274
- chunkSize?: number | undefined;
1275
- } | undefined;
1276
- memory?: {
1277
- enabled?: boolean | undefined;
1278
- adapters?: ("playbook-memory" | "cursor-rules" | "session-export" | "bootstrap-delta")[] | undefined;
1279
- ingestDir?: string | undefined;
1280
- classify?: boolean | undefined;
1281
- promote?: {
1282
- enabled?: boolean | undefined;
1283
- targets?: ("agent" | "human" | "agents-md")[] | undefined;
1284
- requireApproval?: boolean | undefined;
1285
- } | undefined;
1286
- } | undefined;
1287
- runtime?: "custom" | "agentskit" | undefined;
1288
- runtimeModule?: string | undefined;
1289
- registry?: {
1290
- enabled?: boolean | undefined;
1291
- agentId?: string | undefined;
1292
- agentRoot?: string | undefined;
1293
- runnerModule?: string | undefined;
1294
- } | undefined;
1295
- }>>;
1296
- federation: z.ZodOptional<z.ZodObject<{
1297
- enabled: z.ZodOptional<z.ZodBoolean>;
1298
- sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
1299
- id: z.ZodString;
1300
- llmsTxt: z.ZodOptional<z.ZodString>;
1301
- rawBaseUrl: z.ZodOptional<z.ZodString>;
1302
- includeInRetriever: z.ZodOptional<z.ZodBoolean>;
1303
- includeInChat: z.ZodOptional<z.ZodBoolean>;
1304
- }, "strict", z.ZodTypeAny, {
1305
- id: string;
1306
- llmsTxt?: string | undefined;
1307
- rawBaseUrl?: string | undefined;
1308
- includeInRetriever?: boolean | undefined;
1309
- includeInChat?: boolean | undefined;
1310
- }, {
1311
- id: string;
1312
- llmsTxt?: string | undefined;
1313
- rawBaseUrl?: string | undefined;
1314
- includeInRetriever?: boolean | undefined;
1315
- includeInChat?: boolean | undefined;
1316
- }>, "many">>;
1317
- }, "strict", z.ZodTypeAny, {
1318
- enabled?: boolean | undefined;
1319
- sources?: {
1320
- id: string;
1321
- llmsTxt?: string | undefined;
1322
- rawBaseUrl?: string | undefined;
1323
- includeInRetriever?: boolean | undefined;
1324
- includeInChat?: boolean | undefined;
1325
- }[] | undefined;
1326
- }, {
1327
- enabled?: boolean | undefined;
1328
- sources?: {
1329
- id: string;
1330
- llmsTxt?: string | undefined;
1331
- rawBaseUrl?: string | undefined;
1332
- includeInRetriever?: boolean | undefined;
1333
- includeInChat?: boolean | undefined;
1334
- }[] | undefined;
1335
- }>>;
1336
- conformance: z.ZodOptional<z.ZodObject<{
1337
- documentationStandardV1: z.ZodOptional<z.ZodEffects<z.ZodObject<{
1338
- rawSources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1339
- contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1340
- metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
1341
- path: z.ZodString;
1342
- contains: z.ZodArray<z.ZodString, "many">;
1343
- }, "strict", z.ZodTypeAny, {
1344
- path: string;
1345
- contains: string[];
1346
- }, {
1347
- path: string;
1348
- contains: string[];
1349
- }>, "many">>;
1350
- links: z.ZodOptional<z.ZodArray<z.ZodObject<{
1351
- url: z.ZodString;
1352
- paths: z.ZodArray<z.ZodString, "many">;
1353
- }, "strict", z.ZodTypeAny, {
1354
- paths: string[];
1355
- url: string;
1356
- }, {
1357
- paths: string[];
1358
- url: string;
1359
- }>, "many">>;
1360
- quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
1361
- id: z.ZodString;
1362
- doc: z.ZodString;
1363
- test: z.ZodString;
1364
- command: z.ZodString;
1365
- testContains: z.ZodArray<z.ZodString, "many">;
1366
- }, "strict", z.ZodTypeAny, {
1367
- id: string;
1368
- doc: string;
1369
- test: string;
1370
- command: string;
1371
- testContains: string[];
1372
- }, {
1373
- id: string;
1374
- doc: string;
1375
- test: string;
1376
- command: string;
1377
- testContains: string[];
1378
- }>, "many">>;
1379
- visuals: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1380
- diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
1381
- path: z.ZodString;
1382
- contains: z.ZodArray<z.ZodString, "many">;
1383
- }, "strict", z.ZodTypeAny, {
1384
- path: string;
1385
- contains: string[];
1386
- }, {
1387
- path: string;
1388
- contains: string[];
1389
- }>, "many">>;
1390
- ecosystemContract: z.ZodOptional<z.ZodObject<{
1391
- manifest: z.ZodString;
1392
- claims: z.ZodString;
1393
- productId: z.ZodString;
1394
- }, "strict", z.ZodTypeAny, {
1395
- manifest: string;
1396
- claims: string;
1397
- productId: string;
1398
- }, {
1399
- manifest: string;
1400
- claims: string;
1401
- productId: string;
1402
- }>>;
1403
- exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
1404
- ruleId: z.ZodEnum<["human-docs", "llms-and-raw-source", "agent-handoffs", "contribution", "metadata", "cross-links", "tested-quickstarts", "visual-explanations", "structured-diagrams"]>;
1405
- reason: z.ZodString;
1406
- approvedBy: z.ZodString;
1407
- trackingUrl: z.ZodString;
1408
- }, "strict", z.ZodTypeAny, {
1409
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1410
- reason: string;
1411
- approvedBy: string;
1412
- trackingUrl: string;
1413
- }, {
1414
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1415
- reason: string;
1416
- approvedBy: string;
1417
- trackingUrl: string;
1418
- }>, "many">>;
1419
- }, "strict", z.ZodTypeAny, {
1420
- metadata?: {
1421
- path: string;
1422
- contains: string[];
1423
- }[] | undefined;
1424
- rawSources?: string[] | undefined;
1425
- contributionPaths?: string[] | undefined;
1426
- links?: {
1427
- paths: string[];
1428
- url: string;
1429
- }[] | undefined;
1430
- quickstarts?: {
1431
- id: string;
1432
- doc: string;
1433
- test: string;
1434
- command: string;
1435
- testContains: string[];
1436
- }[] | undefined;
1437
- visuals?: string[] | undefined;
1438
- diagrams?: {
1439
- path: string;
1440
- contains: string[];
1441
- }[] | undefined;
1442
- ecosystemContract?: {
1443
- manifest: string;
1444
- claims: string;
1445
- productId: string;
1446
- } | undefined;
1447
- exceptions?: {
1448
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1449
- reason: string;
1450
- approvedBy: string;
1451
- trackingUrl: string;
1452
- }[] | undefined;
1453
- }, {
1454
- metadata?: {
1455
- path: string;
1456
- contains: string[];
1457
- }[] | undefined;
1458
- rawSources?: string[] | undefined;
1459
- contributionPaths?: string[] | undefined;
1460
- links?: {
1461
- paths: string[];
1462
- url: string;
1463
- }[] | undefined;
1464
- quickstarts?: {
1465
- id: string;
1466
- doc: string;
1467
- test: string;
1468
- command: string;
1469
- testContains: string[];
1470
- }[] | undefined;
1471
- visuals?: string[] | undefined;
1472
- diagrams?: {
1473
- path: string;
1474
- contains: string[];
1475
- }[] | undefined;
1476
- ecosystemContract?: {
1477
- manifest: string;
1478
- claims: string;
1479
- productId: string;
1480
- } | undefined;
1481
- exceptions?: {
1482
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1483
- reason: string;
1484
- approvedBy: string;
1485
- trackingUrl: string;
1486
- }[] | undefined;
1487
- }>, {
1488
- metadata?: {
1489
- path: string;
1490
- contains: string[];
1491
- }[] | undefined;
1492
- rawSources?: string[] | undefined;
1493
- contributionPaths?: string[] | undefined;
1494
- links?: {
1495
- paths: string[];
1496
- url: string;
1497
- }[] | undefined;
1498
- quickstarts?: {
1499
- id: string;
1500
- doc: string;
1501
- test: string;
1502
- command: string;
1503
- testContains: string[];
1504
- }[] | undefined;
1505
- visuals?: string[] | undefined;
1506
- diagrams?: {
1507
- path: string;
1508
- contains: string[];
1509
- }[] | undefined;
1510
- ecosystemContract?: {
1511
- manifest: string;
1512
- claims: string;
1513
- productId: string;
1514
- } | undefined;
1515
- exceptions?: {
1516
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1517
- reason: string;
1518
- approvedBy: string;
1519
- trackingUrl: string;
1520
- }[] | undefined;
1521
- }, {
1522
- metadata?: {
1523
- path: string;
1524
- contains: string[];
1525
- }[] | undefined;
1526
- rawSources?: string[] | undefined;
1527
- contributionPaths?: string[] | undefined;
1528
- links?: {
1529
- paths: string[];
1530
- url: string;
1531
- }[] | undefined;
1532
- quickstarts?: {
1533
- id: string;
1534
- doc: string;
1535
- test: string;
1536
- command: string;
1537
- testContains: string[];
1538
- }[] | undefined;
1539
- visuals?: string[] | undefined;
1540
- diagrams?: {
1541
- path: string;
1542
- contains: string[];
1543
- }[] | undefined;
1544
- ecosystemContract?: {
1545
- manifest: string;
1546
- claims: string;
1547
- productId: string;
1548
- } | undefined;
1549
- exceptions?: {
1550
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1551
- reason: string;
1552
- approvedBy: string;
1553
- trackingUrl: string;
1554
- }[] | undefined;
1555
- }>>;
1556
- }, "strict", z.ZodTypeAny, {
1557
- documentationStandardV1?: {
1558
- metadata?: {
1559
- path: string;
1560
- contains: string[];
1561
- }[] | undefined;
1562
- rawSources?: string[] | undefined;
1563
- contributionPaths?: string[] | undefined;
1564
- links?: {
1565
- paths: string[];
1566
- url: string;
1567
- }[] | undefined;
1568
- quickstarts?: {
1569
- id: string;
1570
- doc: string;
1571
- test: string;
1572
- command: string;
1573
- testContains: string[];
1574
- }[] | undefined;
1575
- visuals?: string[] | undefined;
1576
- diagrams?: {
1577
- path: string;
1578
- contains: string[];
1579
- }[] | undefined;
1580
- ecosystemContract?: {
1581
- manifest: string;
1582
- claims: string;
1583
- productId: string;
1584
- } | undefined;
1585
- exceptions?: {
1586
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1587
- reason: string;
1588
- approvedBy: string;
1589
- trackingUrl: string;
1590
- }[] | undefined;
1591
- } | undefined;
1592
- }, {
1593
- documentationStandardV1?: {
1594
- metadata?: {
1595
- path: string;
1596
- contains: string[];
1597
- }[] | undefined;
1598
- rawSources?: string[] | undefined;
1599
- contributionPaths?: string[] | undefined;
1600
- links?: {
1601
- paths: string[];
1602
- url: string;
1603
- }[] | undefined;
1604
- quickstarts?: {
1605
- id: string;
1606
- doc: string;
1607
- test: string;
1608
- command: string;
1609
- testContains: string[];
1610
- }[] | undefined;
1611
- visuals?: string[] | undefined;
1612
- diagrams?: {
1613
- path: string;
1614
- contains: string[];
1615
- }[] | undefined;
1616
- ecosystemContract?: {
1617
- manifest: string;
1618
- claims: string;
1619
- productId: string;
1620
- } | undefined;
1621
- exceptions?: {
1622
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1623
- reason: string;
1624
- approvedBy: string;
1625
- trackingUrl: string;
1626
- }[] | undefined;
1627
- } | undefined;
1628
- }>>;
1629
- }, "strict", z.ZodTypeAny, {
1630
- schemaVersion: 1;
1631
- corpus: {
1632
- agent: {
1633
- root: string;
1634
- index?: string | undefined;
1635
- include?: string[] | undefined;
1636
- exclude?: string[] | undefined;
1637
- okf?: {
1638
- requireType?: boolean | undefined;
1639
- allowedTypes?: string[] | undefined;
1640
- } | undefined;
1641
- };
1642
- human?: {
1643
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
1644
- options?: Record<string, unknown> | undefined;
1645
- } | {
1646
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
1647
- options?: Record<string, unknown> | undefined;
1648
- }[] | undefined;
1649
- };
1650
- index?: {
1651
- outFile?: string | undefined;
1652
- llmsTxt?: {
1653
- outFile?: string | undefined;
1654
- enabled?: boolean | undefined;
1655
- preamble?: string | undefined;
1656
- urlPrefix?: string | undefined;
1657
- pathPrefix?: string | undefined;
1658
- } | undefined;
1659
- capabilities?: {
1660
- outFile?: string | undefined;
1661
- enabled?: boolean | undefined;
1662
- } | undefined;
1663
- contentHash?: "sha256-normalized-v1" | undefined;
1664
- } | undefined;
1665
- federation?: {
1666
- enabled?: boolean | undefined;
1667
- sources?: {
1668
- id: string;
1669
- llmsTxt?: string | undefined;
1670
- rawBaseUrl?: string | undefined;
1671
- includeInRetriever?: boolean | undefined;
1672
- includeInChat?: boolean | undefined;
1673
- }[] | undefined;
1674
- } | undefined;
1675
- project?: {
1676
- root?: string | undefined;
1677
- name?: string | undefined;
1678
- } | undefined;
1679
- routing?: {
1680
- options?: {
1681
- packages?: string[] | undefined;
1682
- ownershipFromCorpus?: boolean | undefined;
1683
- ownership?: Record<string, {
1684
- path: string;
1685
- group?: string | undefined;
1686
- layer?: string | undefined;
1687
- purpose?: string | undefined;
1688
- checks?: string[] | undefined;
1689
- agentDoc?: string | undefined;
1690
- humanDoc?: string | undefined;
1691
- }> | undefined;
1692
- intents?: {
1693
- id: string;
1694
- title: string;
1695
- paths: string[];
1696
- }[] | undefined;
1697
- changes?: {
1698
- id: string;
1699
- title: string;
1700
- startHere: string;
1701
- relatedPackages?: string[] | undefined;
1702
- }[] | undefined;
1703
- } | undefined;
1704
- plugin?: "custom" | "pnpm-monorepo" | "npm-workspaces" | "yarn-workspaces" | "nx" | "pattern-files" | undefined;
1705
- } | undefined;
1706
- gates?: {
1707
- options?: Record<string, unknown> | undefined;
1708
- include?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
1709
- exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
1710
- preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
1711
- } | undefined;
1712
- reconciliation?: {
1713
- requiredRelationKinds?: string[] | undefined;
1714
- } | undefined;
1715
- rules?: {
1716
- mode?: "strict" | "default" | "recommended" | undefined;
1717
- 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;
1718
- 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;
1719
- criticalEntities?: string[] | undefined;
1720
- criticalPaths?: string[] | undefined;
1721
- 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;
1722
- } | undefined;
1723
- workflow?: {
1724
- stateDir?: string | undefined;
1725
- } | undefined;
1726
- safety?: {
1727
- exclude?: string[] | undefined;
1728
- maxFiles?: number | undefined;
1729
- maxBytes?: number | undefined;
1730
- maxTimeMs?: number | undefined;
1731
- maxMemoryMb?: number | undefined;
1732
- redactSecrets?: boolean | undefined;
1733
- } | undefined;
1734
- surfaces?: {
1735
- cli?: {
1736
- bin?: string | undefined;
1737
- defaultFormat?: "json" | "text" | undefined;
1738
- } | undefined;
1739
- mcp?: {
1740
- enabled?: boolean | undefined;
1741
- 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
- http?: {
1743
- path?: string | undefined;
1744
- port?: number | undefined;
1745
- } | undefined;
1746
- transport?: "stdio" | "http" | undefined;
1747
- } | undefined;
1748
- } | undefined;
1749
- intelligence?: {
1750
- enabled?: boolean | undefined;
1751
- adapter?: {
1752
- provider: "custom" | "openai" | "anthropic" | "ollama" | "openrouter";
1753
- options?: Record<string, unknown> | undefined;
1754
- model?: string | undefined;
1755
- apiKeyEnv?: string | undefined;
1756
- baseUrl?: string | undefined;
1757
- } | undefined;
1758
- chat?: {
1759
- enabled?: boolean | undefined;
1760
- sources?: ("agent" | "human" | "federation")[] | undefined;
1761
- handoffFirst?: boolean | undefined;
1762
- } | undefined;
1763
- retriever?: {
1764
- options?: Record<string, unknown> | undefined;
1765
- enabled?: boolean | undefined;
1766
- mode?: "local" | "remote" | "bm25" | "agentskit-rag" | undefined;
1767
- embedModel?: string | undefined;
1768
- chunkSize?: number | undefined;
1769
- } | undefined;
1770
- memory?: {
1771
- enabled?: boolean | undefined;
1772
- adapters?: ("playbook-memory" | "cursor-rules" | "session-export" | "bootstrap-delta")[] | undefined;
1773
- ingestDir?: string | undefined;
1774
- classify?: boolean | undefined;
1775
- promote?: {
1776
- enabled?: boolean | undefined;
1777
- targets?: ("agent" | "human" | "agents-md")[] | undefined;
1778
- requireApproval?: boolean | undefined;
1779
- } | undefined;
1780
- } | undefined;
1781
- runtime?: "custom" | "agentskit" | undefined;
1782
- runtimeModule?: string | undefined;
1783
- registry?: {
1784
- enabled?: boolean | undefined;
1785
- agentId?: string | undefined;
1786
- agentRoot?: string | undefined;
1787
- runnerModule?: string | undefined;
1788
- } | undefined;
1789
- } | undefined;
1790
- conformance?: {
1791
- documentationStandardV1?: {
1792
- metadata?: {
1793
- path: string;
1794
- contains: string[];
1795
- }[] | undefined;
1796
- rawSources?: string[] | undefined;
1797
- contributionPaths?: string[] | undefined;
1798
- links?: {
1799
- paths: string[];
1800
- url: string;
1801
- }[] | undefined;
1802
- quickstarts?: {
1803
- id: string;
1804
- doc: string;
1805
- test: string;
1806
- command: string;
1807
- testContains: string[];
1808
- }[] | undefined;
1809
- visuals?: string[] | undefined;
1810
- diagrams?: {
1811
- path: string;
1812
- contains: string[];
1813
- }[] | undefined;
1814
- ecosystemContract?: {
1815
- manifest: string;
1816
- claims: string;
1817
- productId: string;
1818
- } | undefined;
1819
- exceptions?: {
1820
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
1821
- reason: string;
1822
- approvedBy: string;
1823
- trackingUrl: string;
1824
- }[] | undefined;
1825
- } | undefined;
1826
- } | undefined;
1827
- }, {
1828
- schemaVersion: 1;
1829
- corpus: {
1830
- agent: {
1831
- root: string;
1832
- index?: string | undefined;
1833
- include?: string[] | undefined;
1834
- exclude?: string[] | undefined;
1835
- okf?: {
1836
- requireType?: boolean | undefined;
1837
- allowedTypes?: string[] | undefined;
1838
- } | undefined;
1839
- };
1840
- human?: {
1841
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
1842
- options?: Record<string, unknown> | undefined;
1843
- } | {
1844
- plugin: "plain-markdown" | "fumadocs" | "docusaurus" | "mkdocs" | "vitepress" | "starlight" | "nextra" | "custom";
1845
- options?: Record<string, unknown> | undefined;
1846
- }[] | undefined;
1847
- };
1848
- index?: {
1849
- outFile?: string | undefined;
1850
- llmsTxt?: {
1851
- outFile?: string | undefined;
1852
- enabled?: boolean | undefined;
1853
- preamble?: string | undefined;
1854
- urlPrefix?: string | undefined;
1855
- pathPrefix?: string | undefined;
1856
- } | undefined;
1857
- capabilities?: {
1858
- outFile?: string | undefined;
1859
- enabled?: boolean | undefined;
1860
- } | undefined;
1861
- contentHash?: "sha256-normalized-v1" | undefined;
1862
- } | undefined;
1863
- federation?: {
1864
- enabled?: boolean | undefined;
1865
- sources?: {
1866
- id: string;
1867
- llmsTxt?: string | undefined;
1868
- rawBaseUrl?: string | undefined;
1869
- includeInRetriever?: boolean | undefined;
1870
- includeInChat?: boolean | undefined;
1871
- }[] | undefined;
1872
- } | undefined;
1873
- project?: {
1874
- root?: string | undefined;
1875
- name?: string | undefined;
1876
- } | undefined;
1877
- routing?: {
1878
- options?: {
1879
- packages?: string[] | undefined;
1880
- ownershipFromCorpus?: boolean | undefined;
1881
- ownership?: Record<string, {
1882
- path: string;
1883
- group?: string | undefined;
1884
- layer?: string | undefined;
1885
- purpose?: string | undefined;
1886
- checks?: string[] | undefined;
1887
- agentDoc?: string | undefined;
1888
- humanDoc?: string | undefined;
1889
- }> | undefined;
1890
- intents?: {
1891
- id: string;
1892
- title: string;
1893
- paths: string[];
1894
- }[] | undefined;
1895
- changes?: {
1896
- id: string;
1897
- title: string;
1898
- startHere: string;
1899
- relatedPackages?: string[] | undefined;
1900
- }[] | undefined;
1901
- } | undefined;
1902
- plugin?: "custom" | "pnpm-monorepo" | "npm-workspaces" | "yarn-workspaces" | "nx" | "pattern-files" | undefined;
1903
- } | undefined;
1904
- gates?: {
1905
- options?: Record<string, unknown> | undefined;
1906
- include?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
1907
- exclude?: ("index-freshness" | "human-guide-links" | "link-rot" | "okf-type" | "docs-style" | "routing-currency" | "bootstrap-size" | "documentation-standard-v1")[] | undefined;
1908
- preset?: "strict" | "minimal" | "standard" | "playbook" | undefined;
1909
- } | undefined;
1910
- reconciliation?: {
1911
- requiredRelationKinds?: string[] | undefined;
1912
- } | undefined;
1913
- rules?: {
1914
- mode?: "strict" | "default" | "recommended" | undefined;
1915
- 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;
1916
- 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;
1917
- criticalEntities?: string[] | undefined;
1918
- criticalPaths?: string[] | undefined;
1919
- 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;
1920
- } | undefined;
1921
- workflow?: {
1922
- stateDir?: string | undefined;
1923
- } | undefined;
1924
- safety?: {
1925
- exclude?: string[] | undefined;
1926
- maxFiles?: number | undefined;
1927
- maxBytes?: number | undefined;
1928
- maxTimeMs?: number | undefined;
1929
- maxMemoryMb?: number | undefined;
1930
- redactSecrets?: boolean | undefined;
1931
- } | undefined;
1932
- surfaces?: {
1933
- cli?: {
1934
- bin?: string | undefined;
1935
- defaultFormat?: "json" | "text" | undefined;
1936
- } | undefined;
1937
- mcp?: {
1938
- enabled?: boolean | undefined;
1939
- 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;
1940
- http?: {
1941
- path?: string | undefined;
1942
- port?: number | undefined;
1943
- } | undefined;
1944
- transport?: "stdio" | "http" | undefined;
1945
- } | undefined;
1946
- } | undefined;
1947
- intelligence?: {
1948
- enabled?: boolean | undefined;
1949
- adapter?: {
1950
- provider: "custom" | "openai" | "anthropic" | "ollama" | "openrouter";
1951
- options?: Record<string, unknown> | undefined;
1952
- model?: string | undefined;
1953
- apiKeyEnv?: string | undefined;
1954
- baseUrl?: string | undefined;
1955
- } | undefined;
1956
- chat?: {
1957
- enabled?: boolean | undefined;
1958
- sources?: ("agent" | "human" | "federation")[] | undefined;
1959
- handoffFirst?: boolean | undefined;
1960
- } | undefined;
1961
- retriever?: {
1962
- options?: Record<string, unknown> | undefined;
1963
- enabled?: boolean | undefined;
1964
- mode?: "local" | "remote" | "bm25" | "agentskit-rag" | undefined;
1965
- embedModel?: string | undefined;
1966
- chunkSize?: number | undefined;
1967
- } | undefined;
1968
- memory?: {
1969
- enabled?: boolean | undefined;
1970
- adapters?: ("playbook-memory" | "cursor-rules" | "session-export" | "bootstrap-delta")[] | undefined;
1971
- ingestDir?: string | undefined;
1972
- classify?: boolean | undefined;
1973
- promote?: {
1974
- enabled?: boolean | undefined;
1975
- targets?: ("agent" | "human" | "agents-md")[] | undefined;
1976
- requireApproval?: boolean | undefined;
1977
- } | undefined;
1978
- } | undefined;
1979
- runtime?: "custom" | "agentskit" | undefined;
1980
- runtimeModule?: string | undefined;
1981
- registry?: {
1982
- enabled?: boolean | undefined;
1983
- agentId?: string | undefined;
1984
- agentRoot?: string | undefined;
1985
- runnerModule?: string | undefined;
1986
- } | undefined;
1987
- } | undefined;
1988
- conformance?: {
1989
- documentationStandardV1?: {
1990
- metadata?: {
1991
- path: string;
1992
- contains: string[];
1993
- }[] | undefined;
1994
- rawSources?: string[] | undefined;
1995
- contributionPaths?: string[] | undefined;
1996
- links?: {
1997
- paths: string[];
1998
- url: string;
1999
- }[] | undefined;
2000
- quickstarts?: {
2001
- id: string;
2002
- doc: string;
2003
- test: string;
2004
- command: string;
2005
- testContains: string[];
2006
- }[] | undefined;
2007
- visuals?: string[] | undefined;
2008
- diagrams?: {
2009
- path: string;
2010
- contains: string[];
2011
- }[] | undefined;
2012
- ecosystemContract?: {
2013
- manifest: string;
2014
- claims: string;
2015
- productId: string;
2016
- } | undefined;
2017
- exceptions?: {
2018
- ruleId: "human-docs" | "llms-and-raw-source" | "agent-handoffs" | "contribution" | "metadata" | "cross-links" | "tested-quickstarts" | "visual-explanations" | "structured-diagrams";
2019
- reason: string;
2020
- approvedBy: string;
2021
- trackingUrl: string;
2022
- }[] | undefined;
2023
- } | undefined;
2024
- } | undefined;
2025
- }>;
2026
- type DocBridgeConfigV1 = z.infer<typeof DocBridgeConfigV1Schema>;
2027
- type AgentCorpusConfig = z.infer<typeof AgentCorpusConfigSchema>;
2028
- type DocumentationStandardV1Config = z.infer<typeof DocumentationStandardV1ConfigSchema>;
2029
- type DocumentationStandardRuleId = z.infer<typeof DocumentationStandardRuleIdSchema>;
2030
- type ReconciliationConfig = z.infer<typeof ReconciliationConfigSchema>;
2031
- type RuleId = z.infer<typeof RuleIdSchema>;
2032
- type RuleSeverity = z.infer<typeof RuleSeveritySchema>;
2033
- type RulesConfig = z.infer<typeof RulesConfigSchema>;
2034
- type WorkflowConfig = z.infer<typeof WorkflowConfigSchema>;
2035
- type RepositorySafetyConfig = z.infer<typeof RepositorySafetyConfigSchema>;
2036
-
2037
- /** Type-safe config helper for `doc-bridge.config.ts`. */
2038
- declare const defineConfig: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
2039
-
2040
- declare const applyConfigDefaults: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
2041
-
2042
- type LoadConfigOptions = {
2043
- readonly cwd?: string;
2044
- readonly explicitPath?: string;
2045
- };
2046
- type LoadConfigResult = {
2047
- readonly config: DocBridgeConfigV1;
2048
- readonly path: string;
2049
- };
2050
- declare class ConfigNotFoundError extends Error {
2051
- readonly cwd: string;
2052
- constructor(cwd: string);
2053
- }
2054
- /** v0.1 — static JS/TS config, JSON config files, and package.json#docBridge. */
2055
- declare const loadConfig: (opts?: LoadConfigOptions) => LoadConfigResult;
2056
- declare const resolveProjectRoot: (start?: string) => string;
2057
- /** Project root for a loaded config file path (directory of the config). */
2058
- declare const projectRootFromConfigPath: (configFilePath: string, projectRootField?: string) => string;
2059
-
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 };