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