@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
@@ -0,0 +1,660 @@
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>>;
7
+ exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
8
+ okf: z.ZodOptional<z.ZodObject<{
9
+ requireType: z.ZodOptional<z.ZodBoolean>;
10
+ allowedTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
11
+ }, z.core.$strict>>;
12
+ }, z.core.$strict>;
13
+ declare const HumanCorpusConfigSchema: z.ZodObject<{
14
+ plugin: z.ZodEnum<{
15
+ "plain-markdown": "plain-markdown";
16
+ fumadocs: "fumadocs";
17
+ docusaurus: "docusaurus";
18
+ mkdocs: "mkdocs";
19
+ vitepress: "vitepress";
20
+ starlight: "starlight";
21
+ nextra: "nextra";
22
+ custom: "custom";
23
+ }>;
24
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
25
+ }, z.core.$strict>;
26
+ declare const RuleIdSchema: z.ZodEnum<{
27
+ ownership: "ownership";
28
+ "documentation-quality": "documentation-quality";
29
+ "graph-undocumented-relation": "graph-undocumented-relation";
30
+ "declared-unobserved-relation": "declared-unobserved-relation";
31
+ "unresolved-reference": "unresolved-reference";
32
+ "conflicting-declaration": "conflicting-declaration";
33
+ "not-analyzed-coverage": "not-analyzed-coverage";
34
+ "stale-documentation": "stale-documentation";
35
+ "centrality-risk": "centrality-risk";
36
+ "critical-path-risk": "critical-path-risk";
37
+ freshness: "freshness";
38
+ }>;
39
+ declare const RuleSeveritySchema: z.ZodEnum<{
40
+ error: "error";
41
+ off: "off";
42
+ info: "info";
43
+ warn: "warn";
44
+ }>;
45
+ declare const RulesConfigSchema: z.ZodObject<{
46
+ mode: z.ZodOptional<z.ZodEnum<{
47
+ default: "default";
48
+ strict: "strict";
49
+ recommended: "recommended";
50
+ }>>;
51
+ severity: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
52
+ ownership: "ownership";
53
+ "documentation-quality": "documentation-quality";
54
+ "graph-undocumented-relation": "graph-undocumented-relation";
55
+ "declared-unobserved-relation": "declared-unobserved-relation";
56
+ "unresolved-reference": "unresolved-reference";
57
+ "conflicting-declaration": "conflicting-declaration";
58
+ "not-analyzed-coverage": "not-analyzed-coverage";
59
+ "stale-documentation": "stale-documentation";
60
+ "centrality-risk": "centrality-risk";
61
+ "critical-path-risk": "critical-path-risk";
62
+ freshness: "freshness";
63
+ }> & z.core.$partial, z.ZodEnum<{
64
+ error: "error";
65
+ off: "off";
66
+ info: "info";
67
+ warn: "warn";
68
+ }>>>;
69
+ ignore: z.ZodOptional<z.ZodArray<z.ZodEnum<{
70
+ ownership: "ownership";
71
+ "documentation-quality": "documentation-quality";
72
+ "graph-undocumented-relation": "graph-undocumented-relation";
73
+ "declared-unobserved-relation": "declared-unobserved-relation";
74
+ "unresolved-reference": "unresolved-reference";
75
+ "conflicting-declaration": "conflicting-declaration";
76
+ "not-analyzed-coverage": "not-analyzed-coverage";
77
+ "stale-documentation": "stale-documentation";
78
+ "centrality-risk": "centrality-risk";
79
+ "critical-path-risk": "critical-path-risk";
80
+ freshness: "freshness";
81
+ }>>>;
82
+ criticalEntities: z.ZodOptional<z.ZodArray<z.ZodString>>;
83
+ criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
84
+ warningThresholds: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
85
+ ownership: "ownership";
86
+ "documentation-quality": "documentation-quality";
87
+ "graph-undocumented-relation": "graph-undocumented-relation";
88
+ "declared-unobserved-relation": "declared-unobserved-relation";
89
+ "unresolved-reference": "unresolved-reference";
90
+ "conflicting-declaration": "conflicting-declaration";
91
+ "not-analyzed-coverage": "not-analyzed-coverage";
92
+ "stale-documentation": "stale-documentation";
93
+ "centrality-risk": "centrality-risk";
94
+ "critical-path-risk": "critical-path-risk";
95
+ freshness: "freshness";
96
+ }> & z.core.$partial, z.ZodNumber>>;
97
+ }, z.core.$strict>;
98
+ declare const ReconciliationConfigSchema: z.ZodObject<{
99
+ scope: z.ZodOptional<z.ZodEnum<{
100
+ file: "file";
101
+ module: "module";
102
+ package: "package";
103
+ }>>;
104
+ requiredRelationKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
105
+ requiredRelationTargets: z.ZodOptional<z.ZodEnum<{
106
+ all: "all";
107
+ internal: "internal";
108
+ }>>;
109
+ includeOrphanedDocuments: z.ZodOptional<z.ZodBoolean>;
110
+ }, z.core.$strict>;
111
+ declare const WorkflowConfigSchema: z.ZodObject<{
112
+ stateDir: z.ZodOptional<z.ZodString>;
113
+ }, z.core.$strict>;
114
+ declare const RepositorySafetyConfigSchema: z.ZodObject<{
115
+ exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
116
+ maxFiles: z.ZodOptional<z.ZodNumber>;
117
+ maxBytes: z.ZodOptional<z.ZodNumber>;
118
+ maxTimeMs: z.ZodOptional<z.ZodNumber>;
119
+ maxMemoryMb: z.ZodOptional<z.ZodNumber>;
120
+ redactSecrets: z.ZodOptional<z.ZodBoolean>;
121
+ }, z.core.$strict>;
122
+ declare const ReportConfigSchema: z.ZodObject<{
123
+ privacy: z.ZodOptional<z.ZodEnum<{
124
+ private: "private";
125
+ anonymized: "anonymized";
126
+ }>>;
127
+ }, z.core.$strict>;
128
+ declare const EcosystemContractEvidenceSchema: z.ZodObject<{
129
+ manifest: z.ZodString;
130
+ claims: z.ZodString;
131
+ productId: z.ZodString;
132
+ }, z.core.$strict>;
133
+ declare const DocumentationStandardRuleIdSchema: z.ZodEnum<{
134
+ "human-docs": "human-docs";
135
+ "llms-and-raw-source": "llms-and-raw-source";
136
+ "agent-handoffs": "agent-handoffs";
137
+ contribution: "contribution";
138
+ metadata: "metadata";
139
+ "cross-links": "cross-links";
140
+ "tested-quickstarts": "tested-quickstarts";
141
+ "visual-explanations": "visual-explanations";
142
+ "structured-diagrams": "structured-diagrams";
143
+ }>;
144
+ declare const DocumentationStandardV1ConfigSchema: z.ZodObject<{
145
+ rawSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
146
+ contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
147
+ metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
148
+ path: z.ZodString;
149
+ contains: z.ZodArray<z.ZodString>;
150
+ }, z.core.$strict>>>;
151
+ links: z.ZodOptional<z.ZodArray<z.ZodObject<{
152
+ url: z.ZodString;
153
+ paths: z.ZodArray<z.ZodString>;
154
+ }, z.core.$strict>>>;
155
+ quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
156
+ id: z.ZodString;
157
+ doc: z.ZodString;
158
+ test: z.ZodString;
159
+ command: z.ZodString;
160
+ testContains: z.ZodArray<z.ZodString>;
161
+ }, z.core.$strict>>>;
162
+ visuals: z.ZodOptional<z.ZodArray<z.ZodString>>;
163
+ diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
164
+ path: z.ZodString;
165
+ contains: z.ZodArray<z.ZodString>;
166
+ }, z.core.$strict>>>;
167
+ ecosystemContract: z.ZodOptional<z.ZodObject<{
168
+ manifest: z.ZodString;
169
+ claims: z.ZodString;
170
+ productId: z.ZodString;
171
+ }, z.core.$strict>>;
172
+ exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
173
+ ruleId: z.ZodEnum<{
174
+ "human-docs": "human-docs";
175
+ "llms-and-raw-source": "llms-and-raw-source";
176
+ "agent-handoffs": "agent-handoffs";
177
+ contribution: "contribution";
178
+ metadata: "metadata";
179
+ "cross-links": "cross-links";
180
+ "tested-quickstarts": "tested-quickstarts";
181
+ "visual-explanations": "visual-explanations";
182
+ "structured-diagrams": "structured-diagrams";
183
+ }>;
184
+ reason: z.ZodString;
185
+ approvedBy: z.ZodString;
186
+ trackingUrl: z.ZodString;
187
+ }, z.core.$strict>>>;
188
+ }, z.core.$strict>;
189
+ declare const ConformanceConfigSchema: z.ZodObject<{
190
+ documentationStandardV1: z.ZodOptional<z.ZodObject<{
191
+ rawSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
192
+ contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
193
+ metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
194
+ path: z.ZodString;
195
+ contains: z.ZodArray<z.ZodString>;
196
+ }, z.core.$strict>>>;
197
+ links: z.ZodOptional<z.ZodArray<z.ZodObject<{
198
+ url: z.ZodString;
199
+ paths: z.ZodArray<z.ZodString>;
200
+ }, z.core.$strict>>>;
201
+ quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
202
+ id: z.ZodString;
203
+ doc: z.ZodString;
204
+ test: z.ZodString;
205
+ command: z.ZodString;
206
+ testContains: z.ZodArray<z.ZodString>;
207
+ }, z.core.$strict>>>;
208
+ visuals: z.ZodOptional<z.ZodArray<z.ZodString>>;
209
+ diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
210
+ path: z.ZodString;
211
+ contains: z.ZodArray<z.ZodString>;
212
+ }, z.core.$strict>>>;
213
+ ecosystemContract: z.ZodOptional<z.ZodObject<{
214
+ manifest: z.ZodString;
215
+ claims: z.ZodString;
216
+ productId: z.ZodString;
217
+ }, z.core.$strict>>;
218
+ exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
219
+ ruleId: z.ZodEnum<{
220
+ "human-docs": "human-docs";
221
+ "llms-and-raw-source": "llms-and-raw-source";
222
+ "agent-handoffs": "agent-handoffs";
223
+ contribution: "contribution";
224
+ metadata: "metadata";
225
+ "cross-links": "cross-links";
226
+ "tested-quickstarts": "tested-quickstarts";
227
+ "visual-explanations": "visual-explanations";
228
+ "structured-diagrams": "structured-diagrams";
229
+ }>;
230
+ reason: z.ZodString;
231
+ approvedBy: z.ZodString;
232
+ trackingUrl: z.ZodString;
233
+ }, z.core.$strict>>>;
234
+ }, z.core.$strict>>;
235
+ }, z.core.$strict>;
236
+ declare const DocBridgeConfigV1Schema: z.ZodObject<{
237
+ schemaVersion: z.ZodLiteral<1>;
238
+ project: z.ZodOptional<z.ZodObject<{
239
+ name: z.ZodOptional<z.ZodString>;
240
+ root: z.ZodOptional<z.ZodString>;
241
+ }, z.core.$strict>>;
242
+ corpus: z.ZodObject<{
243
+ agent: z.ZodObject<{
244
+ root: z.ZodString;
245
+ index: z.ZodOptional<z.ZodString>;
246
+ include: z.ZodOptional<z.ZodArray<z.ZodString>>;
247
+ exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
248
+ okf: z.ZodOptional<z.ZodObject<{
249
+ requireType: z.ZodOptional<z.ZodBoolean>;
250
+ allowedTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
251
+ }, z.core.$strict>>;
252
+ }, z.core.$strict>;
253
+ human: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
254
+ plugin: z.ZodEnum<{
255
+ "plain-markdown": "plain-markdown";
256
+ fumadocs: "fumadocs";
257
+ docusaurus: "docusaurus";
258
+ mkdocs: "mkdocs";
259
+ vitepress: "vitepress";
260
+ starlight: "starlight";
261
+ nextra: "nextra";
262
+ custom: "custom";
263
+ }>;
264
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
265
+ }, z.core.$strict>, z.ZodArray<z.ZodObject<{
266
+ plugin: z.ZodEnum<{
267
+ "plain-markdown": "plain-markdown";
268
+ fumadocs: "fumadocs";
269
+ docusaurus: "docusaurus";
270
+ mkdocs: "mkdocs";
271
+ vitepress: "vitepress";
272
+ starlight: "starlight";
273
+ nextra: "nextra";
274
+ custom: "custom";
275
+ }>;
276
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
277
+ }, z.core.$strict>>]>>;
278
+ }, z.core.$strict>;
279
+ index: z.ZodOptional<z.ZodObject<{
280
+ outFile: z.ZodOptional<z.ZodString>;
281
+ llmsTxt: z.ZodOptional<z.ZodObject<{
282
+ enabled: z.ZodOptional<z.ZodBoolean>;
283
+ outFile: z.ZodOptional<z.ZodString>;
284
+ preamble: z.ZodOptional<z.ZodString>;
285
+ urlPrefix: z.ZodOptional<z.ZodString>;
286
+ pathPrefix: z.ZodOptional<z.ZodString>;
287
+ }, z.core.$strict>>;
288
+ capabilities: z.ZodOptional<z.ZodObject<{
289
+ enabled: z.ZodOptional<z.ZodBoolean>;
290
+ outFile: z.ZodOptional<z.ZodString>;
291
+ }, z.core.$strict>>;
292
+ contentHash: z.ZodOptional<z.ZodLiteral<"sha256-normalized-v1">>;
293
+ }, z.core.$strict>>;
294
+ routing: z.ZodOptional<z.ZodObject<{
295
+ plugin: z.ZodOptional<z.ZodEnum<{
296
+ custom: "custom";
297
+ "pnpm-monorepo": "pnpm-monorepo";
298
+ "npm-workspaces": "npm-workspaces";
299
+ "yarn-workspaces": "yarn-workspaces";
300
+ nx: "nx";
301
+ "pattern-files": "pattern-files";
302
+ }>>;
303
+ options: z.ZodOptional<z.ZodObject<{
304
+ packages: z.ZodOptional<z.ZodArray<z.ZodString>>;
305
+ ownershipFromCorpus: z.ZodOptional<z.ZodBoolean>;
306
+ ownership: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
307
+ path: z.ZodString;
308
+ group: z.ZodOptional<z.ZodString>;
309
+ layer: z.ZodOptional<z.ZodString>;
310
+ purpose: z.ZodOptional<z.ZodString>;
311
+ checks: z.ZodOptional<z.ZodArray<z.ZodString>>;
312
+ agentDoc: z.ZodOptional<z.ZodString>;
313
+ humanDoc: z.ZodOptional<z.ZodString>;
314
+ }, z.core.$strict>>>;
315
+ intents: z.ZodOptional<z.ZodArray<z.ZodObject<{
316
+ id: z.ZodString;
317
+ title: z.ZodString;
318
+ paths: z.ZodArray<z.ZodString>;
319
+ }, z.core.$strict>>>;
320
+ changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
321
+ id: z.ZodString;
322
+ title: z.ZodString;
323
+ startHere: z.ZodString;
324
+ relatedPackages: z.ZodOptional<z.ZodArray<z.ZodString>>;
325
+ }, z.core.$strict>>>;
326
+ }, z.core.$strict>>;
327
+ }, z.core.$strict>>;
328
+ gates: z.ZodOptional<z.ZodObject<{
329
+ preset: z.ZodOptional<z.ZodEnum<{
330
+ minimal: "minimal";
331
+ standard: "standard";
332
+ strict: "strict";
333
+ playbook: "playbook";
334
+ }>>;
335
+ include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
336
+ "index-freshness": "index-freshness";
337
+ "human-guide-links": "human-guide-links";
338
+ "link-rot": "link-rot";
339
+ "okf-type": "okf-type";
340
+ "docs-style": "docs-style";
341
+ "routing-currency": "routing-currency";
342
+ "bootstrap-size": "bootstrap-size";
343
+ "documentation-standard-v1": "documentation-standard-v1";
344
+ }>>>;
345
+ exclude: z.ZodOptional<z.ZodArray<z.ZodEnum<{
346
+ "index-freshness": "index-freshness";
347
+ "human-guide-links": "human-guide-links";
348
+ "link-rot": "link-rot";
349
+ "okf-type": "okf-type";
350
+ "docs-style": "docs-style";
351
+ "routing-currency": "routing-currency";
352
+ "bootstrap-size": "bootstrap-size";
353
+ "documentation-standard-v1": "documentation-standard-v1";
354
+ }>>>;
355
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
356
+ }, z.core.$strict>>;
357
+ reconciliation: z.ZodOptional<z.ZodObject<{
358
+ scope: z.ZodOptional<z.ZodEnum<{
359
+ file: "file";
360
+ module: "module";
361
+ package: "package";
362
+ }>>;
363
+ requiredRelationKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
364
+ requiredRelationTargets: z.ZodOptional<z.ZodEnum<{
365
+ all: "all";
366
+ internal: "internal";
367
+ }>>;
368
+ includeOrphanedDocuments: z.ZodOptional<z.ZodBoolean>;
369
+ }, z.core.$strict>>;
370
+ analysis: z.ZodOptional<z.ZodObject<{
371
+ plugins: z.ZodOptional<z.ZodArray<z.ZodObject<{
372
+ id: z.ZodString;
373
+ enabled: z.ZodOptional<z.ZodBoolean>;
374
+ order: z.ZodOptional<z.ZodNumber>;
375
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
376
+ reason: z.ZodOptional<z.ZodString>;
377
+ }, z.core.$strict>>>;
378
+ jsTs: z.ZodOptional<z.ZodObject<{
379
+ runtimeWiringMethods: z.ZodOptional<z.ZodArray<z.ZodString>>;
380
+ runtimeWiringAdapters: z.ZodOptional<z.ZodArray<z.ZodObject<{
381
+ id: z.ZodString;
382
+ methods: z.ZodArray<z.ZodString>;
383
+ }, z.core.$strict>>>;
384
+ includeTestRuntimeWiring: z.ZodOptional<z.ZodBoolean>;
385
+ }, z.core.$strict>>;
386
+ }, z.core.$strict>>;
387
+ rules: z.ZodOptional<z.ZodObject<{
388
+ mode: z.ZodOptional<z.ZodEnum<{
389
+ default: "default";
390
+ strict: "strict";
391
+ recommended: "recommended";
392
+ }>>;
393
+ severity: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
394
+ ownership: "ownership";
395
+ "documentation-quality": "documentation-quality";
396
+ "graph-undocumented-relation": "graph-undocumented-relation";
397
+ "declared-unobserved-relation": "declared-unobserved-relation";
398
+ "unresolved-reference": "unresolved-reference";
399
+ "conflicting-declaration": "conflicting-declaration";
400
+ "not-analyzed-coverage": "not-analyzed-coverage";
401
+ "stale-documentation": "stale-documentation";
402
+ "centrality-risk": "centrality-risk";
403
+ "critical-path-risk": "critical-path-risk";
404
+ freshness: "freshness";
405
+ }> & z.core.$partial, z.ZodEnum<{
406
+ error: "error";
407
+ off: "off";
408
+ info: "info";
409
+ warn: "warn";
410
+ }>>>;
411
+ ignore: z.ZodOptional<z.ZodArray<z.ZodEnum<{
412
+ ownership: "ownership";
413
+ "documentation-quality": "documentation-quality";
414
+ "graph-undocumented-relation": "graph-undocumented-relation";
415
+ "declared-unobserved-relation": "declared-unobserved-relation";
416
+ "unresolved-reference": "unresolved-reference";
417
+ "conflicting-declaration": "conflicting-declaration";
418
+ "not-analyzed-coverage": "not-analyzed-coverage";
419
+ "stale-documentation": "stale-documentation";
420
+ "centrality-risk": "centrality-risk";
421
+ "critical-path-risk": "critical-path-risk";
422
+ freshness: "freshness";
423
+ }>>>;
424
+ criticalEntities: z.ZodOptional<z.ZodArray<z.ZodString>>;
425
+ criticalPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
426
+ warningThresholds: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
427
+ ownership: "ownership";
428
+ "documentation-quality": "documentation-quality";
429
+ "graph-undocumented-relation": "graph-undocumented-relation";
430
+ "declared-unobserved-relation": "declared-unobserved-relation";
431
+ "unresolved-reference": "unresolved-reference";
432
+ "conflicting-declaration": "conflicting-declaration";
433
+ "not-analyzed-coverage": "not-analyzed-coverage";
434
+ "stale-documentation": "stale-documentation";
435
+ "centrality-risk": "centrality-risk";
436
+ "critical-path-risk": "critical-path-risk";
437
+ freshness: "freshness";
438
+ }> & z.core.$partial, z.ZodNumber>>;
439
+ }, z.core.$strict>>;
440
+ workflow: z.ZodOptional<z.ZodObject<{
441
+ stateDir: z.ZodOptional<z.ZodString>;
442
+ }, z.core.$strict>>;
443
+ safety: z.ZodOptional<z.ZodObject<{
444
+ exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
445
+ maxFiles: z.ZodOptional<z.ZodNumber>;
446
+ maxBytes: z.ZodOptional<z.ZodNumber>;
447
+ maxTimeMs: z.ZodOptional<z.ZodNumber>;
448
+ maxMemoryMb: z.ZodOptional<z.ZodNumber>;
449
+ redactSecrets: z.ZodOptional<z.ZodBoolean>;
450
+ }, z.core.$strict>>;
451
+ report: z.ZodOptional<z.ZodObject<{
452
+ privacy: z.ZodOptional<z.ZodEnum<{
453
+ private: "private";
454
+ anonymized: "anonymized";
455
+ }>>;
456
+ }, z.core.$strict>>;
457
+ surfaces: z.ZodOptional<z.ZodObject<{
458
+ cli: z.ZodOptional<z.ZodObject<{
459
+ bin: z.ZodOptional<z.ZodString>;
460
+ defaultFormat: z.ZodOptional<z.ZodEnum<{
461
+ json: "json";
462
+ text: "text";
463
+ }>>;
464
+ }, z.core.$strict>>;
465
+ mcp: z.ZodOptional<z.ZodObject<{
466
+ enabled: z.ZodOptional<z.ZodBoolean>;
467
+ tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
468
+ "handoff.resolve": "handoff.resolve";
469
+ "doc.search": "doc.search";
470
+ "doc.get": "doc.get";
471
+ "gate.status": "gate.status";
472
+ "playbook.pattern.get": "playbook.pattern.get";
473
+ "retriever.query": "retriever.query";
474
+ "memory.classify": "memory.classify";
475
+ "memory.promoteDraft": "memory.promoteDraft";
476
+ "registry.topology": "registry.topology";
477
+ "docbridge.snapshot": "docbridge.snapshot";
478
+ "docbridge.report": "docbridge.report";
479
+ "docbridge.diagnostics": "docbridge.diagnostics";
480
+ "docbridge.relations": "docbridge.relations";
481
+ "docbridge.run": "docbridge.run";
482
+ "docbridge.proposals": "docbridge.proposals";
483
+ }>>>;
484
+ transport: z.ZodOptional<z.ZodEnum<{
485
+ stdio: "stdio";
486
+ http: "http";
487
+ }>>;
488
+ http: z.ZodOptional<z.ZodObject<{
489
+ port: z.ZodOptional<z.ZodNumber>;
490
+ path: z.ZodOptional<z.ZodString>;
491
+ }, z.core.$strict>>;
492
+ }, z.core.$strict>>;
493
+ }, z.core.$strict>>;
494
+ intelligence: z.ZodOptional<z.ZodObject<{
495
+ enabled: z.ZodOptional<z.ZodBoolean>;
496
+ adapter: z.ZodOptional<z.ZodObject<{
497
+ provider: z.ZodEnum<{
498
+ custom: "custom";
499
+ openai: "openai";
500
+ anthropic: "anthropic";
501
+ ollama: "ollama";
502
+ openrouter: "openrouter";
503
+ }>;
504
+ model: z.ZodOptional<z.ZodString>;
505
+ apiKeyEnv: z.ZodOptional<z.ZodString>;
506
+ baseUrl: z.ZodOptional<z.ZodString>;
507
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
508
+ }, z.core.$strict>>;
509
+ chat: z.ZodOptional<z.ZodObject<{
510
+ enabled: z.ZodOptional<z.ZodBoolean>;
511
+ sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
512
+ agent: "agent";
513
+ human: "human";
514
+ federation: "federation";
515
+ }>>>;
516
+ handoffFirst: z.ZodOptional<z.ZodBoolean>;
517
+ }, z.core.$strict>>;
518
+ retriever: z.ZodOptional<z.ZodObject<{
519
+ enabled: z.ZodOptional<z.ZodBoolean>;
520
+ mode: z.ZodOptional<z.ZodEnum<{
521
+ local: "local";
522
+ remote: "remote";
523
+ bm25: "bm25";
524
+ "agentskit-rag": "agentskit-rag";
525
+ }>>;
526
+ embedModel: z.ZodOptional<z.ZodString>;
527
+ chunkSize: z.ZodOptional<z.ZodNumber>;
528
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
529
+ }, z.core.$strict>>;
530
+ memory: z.ZodOptional<z.ZodObject<{
531
+ enabled: z.ZodOptional<z.ZodBoolean>;
532
+ adapters: z.ZodOptional<z.ZodArray<z.ZodEnum<{
533
+ "playbook-memory": "playbook-memory";
534
+ "cursor-rules": "cursor-rules";
535
+ "session-export": "session-export";
536
+ "bootstrap-delta": "bootstrap-delta";
537
+ }>>>;
538
+ ingestDir: z.ZodOptional<z.ZodString>;
539
+ classify: z.ZodOptional<z.ZodBoolean>;
540
+ promote: z.ZodOptional<z.ZodObject<{
541
+ enabled: z.ZodOptional<z.ZodBoolean>;
542
+ targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
543
+ agent: "agent";
544
+ human: "human";
545
+ "agents-md": "agents-md";
546
+ }>>>;
547
+ requireApproval: z.ZodOptional<z.ZodBoolean>;
548
+ }, z.core.$strict>>;
549
+ }, z.core.$strict>>;
550
+ runtime: z.ZodOptional<z.ZodEnum<{
551
+ custom: "custom";
552
+ agentskit: "agentskit";
553
+ }>>;
554
+ runtimeModule: z.ZodOptional<z.ZodString>;
555
+ registry: z.ZodOptional<z.ZodObject<{
556
+ enabled: z.ZodOptional<z.ZodBoolean>;
557
+ agentId: z.ZodOptional<z.ZodString>;
558
+ agentRoot: z.ZodOptional<z.ZodString>;
559
+ runnerModule: z.ZodOptional<z.ZodString>;
560
+ deterministic: z.ZodOptional<z.ZodBoolean>;
561
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
562
+ maxTokens: z.ZodOptional<z.ZodNumber>;
563
+ maxResponseBytes: z.ZodOptional<z.ZodNumber>;
564
+ maxConcurrency: z.ZodOptional<z.ZodNumber>;
565
+ }, z.core.$strict>>;
566
+ }, z.core.$strict>>;
567
+ federation: z.ZodOptional<z.ZodObject<{
568
+ enabled: z.ZodOptional<z.ZodBoolean>;
569
+ sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
570
+ id: z.ZodString;
571
+ llmsTxt: z.ZodOptional<z.ZodString>;
572
+ rawBaseUrl: z.ZodOptional<z.ZodString>;
573
+ includeInRetriever: z.ZodOptional<z.ZodBoolean>;
574
+ includeInChat: z.ZodOptional<z.ZodBoolean>;
575
+ }, z.core.$strict>>>;
576
+ }, z.core.$strict>>;
577
+ conformance: z.ZodOptional<z.ZodObject<{
578
+ documentationStandardV1: z.ZodOptional<z.ZodObject<{
579
+ rawSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
580
+ contributionPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
581
+ metadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
582
+ path: z.ZodString;
583
+ contains: z.ZodArray<z.ZodString>;
584
+ }, z.core.$strict>>>;
585
+ links: z.ZodOptional<z.ZodArray<z.ZodObject<{
586
+ url: z.ZodString;
587
+ paths: z.ZodArray<z.ZodString>;
588
+ }, z.core.$strict>>>;
589
+ quickstarts: z.ZodOptional<z.ZodArray<z.ZodObject<{
590
+ id: z.ZodString;
591
+ doc: z.ZodString;
592
+ test: z.ZodString;
593
+ command: z.ZodString;
594
+ testContains: z.ZodArray<z.ZodString>;
595
+ }, z.core.$strict>>>;
596
+ visuals: z.ZodOptional<z.ZodArray<z.ZodString>>;
597
+ diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
598
+ path: z.ZodString;
599
+ contains: z.ZodArray<z.ZodString>;
600
+ }, z.core.$strict>>>;
601
+ ecosystemContract: z.ZodOptional<z.ZodObject<{
602
+ manifest: z.ZodString;
603
+ claims: z.ZodString;
604
+ productId: z.ZodString;
605
+ }, z.core.$strict>>;
606
+ exceptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
607
+ ruleId: z.ZodEnum<{
608
+ "human-docs": "human-docs";
609
+ "llms-and-raw-source": "llms-and-raw-source";
610
+ "agent-handoffs": "agent-handoffs";
611
+ contribution: "contribution";
612
+ metadata: "metadata";
613
+ "cross-links": "cross-links";
614
+ "tested-quickstarts": "tested-quickstarts";
615
+ "visual-explanations": "visual-explanations";
616
+ "structured-diagrams": "structured-diagrams";
617
+ }>;
618
+ reason: z.ZodString;
619
+ approvedBy: z.ZodString;
620
+ trackingUrl: z.ZodString;
621
+ }, z.core.$strict>>>;
622
+ }, z.core.$strict>>;
623
+ }, z.core.$strict>>;
624
+ }, z.core.$strict>;
625
+ type DocBridgeConfigV1 = z.infer<typeof DocBridgeConfigV1Schema>;
626
+ type AgentCorpusConfig = z.infer<typeof AgentCorpusConfigSchema>;
627
+ type DocumentationStandardV1Config = z.infer<typeof DocumentationStandardV1ConfigSchema>;
628
+ type DocumentationStandardRuleId = z.infer<typeof DocumentationStandardRuleIdSchema>;
629
+ type ReconciliationConfig = z.infer<typeof ReconciliationConfigSchema>;
630
+ type RuleId = z.infer<typeof RuleIdSchema>;
631
+ type RuleSeverity = z.infer<typeof RuleSeveritySchema>;
632
+ type RulesConfig = z.infer<typeof RulesConfigSchema>;
633
+ type WorkflowConfig = z.infer<typeof WorkflowConfigSchema>;
634
+ type RepositorySafetyConfig = z.infer<typeof RepositorySafetyConfigSchema>;
635
+ type ReportConfig = z.infer<typeof ReportConfigSchema>;
636
+
637
+ /** Type-safe config helper for `doc-bridge.config.ts`. */
638
+ declare const defineConfig: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
639
+
640
+ declare const applyConfigDefaults: (config: DocBridgeConfigV1) => DocBridgeConfigV1;
641
+
642
+ type LoadConfigOptions = {
643
+ readonly cwd?: string;
644
+ readonly explicitPath?: string;
645
+ };
646
+ type LoadConfigResult = {
647
+ readonly config: DocBridgeConfigV1;
648
+ readonly path: string;
649
+ };
650
+ declare class ConfigNotFoundError extends Error {
651
+ readonly cwd: string;
652
+ constructor(cwd: string);
653
+ }
654
+ /** v0.1 — static JS/TS config, JSON config files, and package.json#docBridge. */
655
+ declare const loadConfig: (opts?: LoadConfigOptions) => LoadConfigResult;
656
+ declare const resolveProjectRoot: (start?: string) => string;
657
+ /** Project root for a loaded config file path (directory of the config). */
658
+ declare const projectRootFromConfigPath: (configFilePath: string, projectRootField?: string) => string;
659
+
660
+ 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 };