@agentskit/doc-bridge 1.6.4 → 1.7.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/CHANGELOG.md +249 -0
  2. package/CONTRIBUTING.md +6 -4
  3. package/action.yml +1 -1
  4. package/dist/cli/program.js +1139 -294
  5. package/dist/cli/program.js.map +1 -1
  6. package/dist/config/index.d.ts +1 -1
  7. package/dist/config/index.js +43 -5
  8. package/dist/config/index.js.map +1 -1
  9. package/dist/index-BUL0q7s8.d.ts +660 -0
  10. package/dist/index.d.ts +817 -2134
  11. package/dist/index.js +1154 -244
  12. package/dist/index.js.map +1 -1
  13. package/docs/PRD-enterprise-hardening.md +288 -0
  14. package/docs/RELEASE.md +22 -8
  15. package/docs/adr/0001-enterprise-verification-contract.md +35 -0
  16. package/docs/agent-corpus/INDEX.md +2 -2
  17. package/docs/agent-corpus/chat.md +2 -2
  18. package/docs/agent-corpus/cli.md +2 -2
  19. package/docs/agent-corpus/conformance.md +2 -2
  20. package/docs/agent-corpus/doc-bridge.md +1 -1
  21. package/docs/agent-corpus/doctor.md +2 -2
  22. package/docs/agent-corpus/gates.md +2 -2
  23. package/docs/agent-corpus/mcp.md +2 -2
  24. package/docs/agent-corpus/memory.md +2 -2
  25. package/docs/agent-corpus/query.md +2 -2
  26. package/docs/knowledge-engine-runbook.md +30 -2
  27. package/docs/spec/analyzer-plugin-v1.md +24 -0
  28. package/docs/spec/benchmark-v1.md +36 -0
  29. package/docs/spec/config-v1.md +156 -0
  30. package/docs/validation-cycle-plan.md +255 -0
  31. package/docs/verification-harness.md +37 -4
  32. package/mcpb/manifest.json +1 -1
  33. package/package.json +68 -70
  34. package/scripts/check-ecosystem-upstream.mjs +3 -2
  35. package/scripts/report-visual-check.mjs +64 -12
  36. package/scripts/verification-harness.mjs +216 -14
  37. package/skills/doc-bridge-handoff/scripts/resolve-handoff.mjs +1 -1
  38. package/src/agents/registry-adapter.ts +31 -7
  39. package/src/cli/demo.ts +2 -2
  40. package/src/cli/program.ts +59 -16
  41. package/src/config/index.ts +2 -0
  42. package/src/config/load-config.ts +7 -1
  43. package/src/config/schema.ts +60 -2
  44. package/src/conformance/documentation-standard-v1.ts +14 -8
  45. package/src/discovery/documentation.ts +90 -23
  46. package/src/discovery/repository.ts +147 -19
  47. package/src/doctor/run-doctor.ts +2 -15
  48. package/src/federation/llms.ts +72 -20
  49. package/src/fixes/proposals.ts +4 -3
  50. package/src/index-builder/human-adapters/fumadocs.ts +1 -1
  51. package/src/index-builder/watch-index.ts +1 -1
  52. package/src/index.ts +29 -0
  53. package/src/lib/bounded-text.ts +15 -10
  54. package/src/metrics/benchmark.ts +176 -0
  55. package/src/plugins/contract.ts +89 -0
  56. package/src/reconciliation/reconcile.ts +181 -5
  57. package/src/report/html.ts +318 -88
  58. package/src/rules/engine.ts +15 -2
  59. package/src/safety/repository.ts +1 -1
  60. package/src/schemas/knowledge.ts +21 -3
  61. package/src/validate.ts +7 -1
  62. package/src/version.ts +1 -1
  63. package/src/workflow/engine.ts +65 -9
  64. package/dist/index-DudNuwI5.d.ts +0 -2060
package/CHANGELOG.md CHANGED
@@ -1,5 +1,254 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.7.45
4
+
5
+ ### Patch Changes
6
+
7
+ - 9929eb0: Harden dependency resolution, filesystem and URL handling, reconciliation schema compatibility, generated-code boundaries, CI permissions, and npm publishing without long-lived npm tokens.
8
+
9
+ ## 1.7.44
10
+
11
+ - Precompute module-to-package ownership during package-scope reconciliation to reduce repeated entity scans on large repositories.
12
+
13
+ ## 1.7.43
14
+
15
+ - Add deterministic reconciliation rollups by diagnostic code and status for agent and dashboard consumption.
16
+
17
+ ## 1.7.42
18
+
19
+ - Correct package documentation health classification when aggregated relations are undocumented.
20
+ - Add regression coverage so package-level reports cannot mark affected packages as fresh.
21
+
22
+ ## 1.7.41
23
+
24
+ - Add configurable anonymized HTML report output that preserves topology and metrics without project-specific identity or evidence content.
25
+
26
+ ## 1.7.40
27
+
28
+ - Clarify that `ak-verify` is portable while verification contracts remain project-local.
29
+ - Require a project verification contract before implementation under the global agent policy.
30
+
31
+ ## 1.7.39
32
+
33
+ - Avoid recompiling the conventional agent-package path matcher for every document during reconciliation.
34
+
35
+ ## 1.7.38
36
+
37
+ - Count conventional agent documents under `packages/` and `apps/` as package coverage even when they do not declare a `humanDoc` bridge.
38
+ - Preserve configurable agent roots and keep human-document linking as a separate concern.
39
+
40
+ ## 1.7.37
41
+
42
+ - Keep package-frontmatter reconciliation linear in document size and avoid unnecessary package scans for direct entity references.
43
+
44
+ ## 1.7.36
45
+
46
+ - Link package documentation that follows the existing `apps|packages` path convention when it declares a human documentation route.
47
+
48
+ ## 1.7.35
49
+
50
+ - Reconcile existing package frontmatter (`type`, `package`, and `humanDoc`) as safe package coverage without requiring duplicate Doc Bridge declarations.
51
+
52
+ ## 1.7.34
53
+
54
+ - Resolve constant-bound dynamic import and require specifiers while keeping computed and ambiguous bindings explicitly unresolved.
55
+
56
+ ## 1.7.33
57
+
58
+ - Anchor dense architecture maps to the viewport so wide graph snapshots do not render as an empty centered strip.
59
+
60
+ ## 1.7.32
61
+
62
+ - Balance dense graph nodes into a readable grid instead of compressing deep hierarchies into a narrow vertical strip.
63
+
64
+ ## 1.7.31
65
+
66
+ - Preserve readable dense-map sizing across responsive breakpoint overrides.
67
+
68
+ ## 1.7.30
69
+
70
+ - Keep dense architecture maps readable with prioritized edge rendering, explicit total-versus-visible counts, and horizontal map exploration.
71
+
72
+ ## 1.7.29
73
+
74
+ - Add enterprise verification profiles with legal state transitions, content-addressed evidence, resumable workflow artifacts, and audited baseline replacement.
75
+ - Add explicit JS/TS coverage boundaries, versioned analyzer plugins, benchmark metrics, and bounded AgentsKit Registry proposals.
76
+ - Improve documentation/code reconciliation with document classification, package documentation status, and orphan-document findings.
77
+
78
+ ## 1.7.28
79
+
80
+ - Keep the initial large-report payload limited to package topology while preserving compact evidence indexes for insights and risk lenses.
81
+ - Preserve module counts and relation finding health in the overview without loading module/file detail chunks.
82
+
83
+ ## 1.7.27
84
+
85
+ ### Patch Changes
86
+
87
+ - Exclude test and spec modules from runtime-wiring coverage by default, with an explicit opt-in for test architecture.
88
+
89
+ ## 1.7.26
90
+
91
+ ### Patch Changes
92
+
93
+ - Report unresolved runtime wiring only when a call contains a potential target, avoiding inline-registration and no-argument false positives.
94
+
95
+ ## 1.7.25
96
+
97
+ ### Patch Changes
98
+
99
+ - Remove generic `bind` and `listen` calls from default runtime-wiring detection while keeping them configurable.
100
+
101
+ ## 1.7.24
102
+
103
+ ### Patch Changes
104
+
105
+ - Warm the browser runtime before visual timing so cold Chromium startup does not masquerade as report latency.
106
+
107
+ ## 1.7.23
108
+
109
+ ### Patch Changes
110
+
111
+ - Clarify runtime-wiring coverage so resolved static targets and unresolved indirect wiring are not conflated.
112
+
113
+ ## 1.7.22
114
+
115
+ ### Patch Changes
116
+
117
+ - Resolve configurable runtime-wiring calls when their arguments are statically imported, while preserving unresolved calls as explicit coverage gaps.
118
+
119
+ ## 1.7.21
120
+
121
+ ### Patch Changes
122
+
123
+ - Preserve explicit detection metadata for literal dynamic imports and advance the JS/TS analyzer version.
124
+
125
+ ## 1.7.20
126
+
127
+ ### Patch Changes
128
+
129
+ - Resolve literal dynamic imports as repository relations and distinguish them from unresolved non-literal loading.
130
+
131
+ ## 1.7.19
132
+
133
+ ### Patch Changes
134
+
135
+ - Keep the directory report index small by describing only the findings chunk; level and detail chunks remain addressable from the overview metadata.
136
+
137
+ ## 1.7.18
138
+
139
+ ### Patch Changes
140
+
141
+ - Encode package chunk names as an ordered list to keep the initial report metadata compact.
142
+
143
+ ## 1.7.17
144
+
145
+ ### Patch Changes
146
+
147
+ - Measure double-click application response from a window-capture listener that cannot be stopped by the report event handler.
148
+
149
+ ## 1.7.16
150
+
151
+ ### Patch Changes
152
+
153
+ - Derive evidence chunk names from existing package level metadata and compact graph payloads further.
154
+
155
+ ## 1.7.15
156
+
157
+ ### Patch Changes
158
+
159
+ - Keep module and file navigation within the selected package scope after package-level hydration.
160
+
161
+ ## 1.7.14
162
+
163
+ ### Patch Changes
164
+
165
+ - Resolve selected package chunks before their parent group chunks during report navigation.
166
+
167
+ ## 1.7.13
168
+
169
+ ### Patch Changes
170
+
171
+ - Defer report evidence payloads until a graph node is selected, keeping topology navigation compact.
172
+
173
+ ## 1.7.12
174
+
175
+ ### Patch Changes
176
+
177
+ - Keep application/group report chunks at package level and load module/file data only for the selected package.
178
+
179
+ ## 1.7.11
180
+
181
+ ### Patch Changes
182
+
183
+ - Split large report level data into on-demand group and package chunks to reduce initial navigation cost.
184
+
185
+ ## 1.7.10
186
+
187
+ ### Patch Changes
188
+
189
+ - Remove the hidden findings DOM while navigating the architecture lens to avoid unnecessary layout work.
190
+
191
+ ## 1.7.9
192
+
193
+ ### Patch Changes
194
+
195
+ - Record report render phase timings in visual evidence for actionable performance diagnosis.
196
+
197
+ ## 1.7.8
198
+
199
+ ### Patch Changes
200
+
201
+ - Cache the graph model for the active report navigation state and invalidate it after lazy data hydration.
202
+
203
+ ## 1.7.7
204
+
205
+ ### Patch Changes
206
+
207
+ - Avoid recalculating hidden findings and insight dashboards during architecture navigation.
208
+
209
+ ## 1.7.6
210
+
211
+ ### Patch Changes
212
+
213
+ - Persist browser interaction timing markers in the report DOM so visual evidence is isolated from test-runner state.
214
+
215
+ ## 1.7.5
216
+
217
+ ### Patch Changes
218
+
219
+ - Distinguish real browser gesture duration from application interaction response in visual evidence.
220
+
221
+ ## 1.7.4
222
+
223
+ ### Patch Changes
224
+
225
+ - Avoid duplicate architecture drill-down renders when a native double-click is received.
226
+
227
+ ## 1.7.3
228
+
229
+ ### Patch Changes
230
+
231
+ - Measure report render and interaction latency with a high-resolution clock.
232
+
233
+ ## 1.7.2
234
+
235
+ ### Patch Changes
236
+
237
+ - Harden verification outcomes and add measurable report interaction timings.
238
+
239
+ ## 1.7.1
240
+
241
+ ### Patch Changes
242
+
243
+ - Keep verification outcomes consistent when human approval completes a run.
244
+
245
+ ## 1.7.0
246
+
247
+ ### Minor Changes
248
+
249
+ - Add configurable package/module reconciliation scopes while preserving raw file-level evidence for architecture exploration.
250
+ - Require verification contracts to declare intent and map every outcome to executable checks.
251
+
3
252
  ## 1.6.4
4
253
 
5
254
  ### Patch Changes
package/CONTRIBUTING.md CHANGED
@@ -30,15 +30,17 @@ pnpm build
30
30
 
31
31
  ## Releases
32
32
 
33
- Use Changesets for versioned changes:
33
+ Use Changesets for versioned changes. A merged changeset on `master` starts the
34
+ version workflow, which opens a version PR and publishes the merged version
35
+ through npm Trusted Publishing (GitHub OIDC). No npm token is stored in GitHub.
34
36
 
35
37
  ```bash
36
38
  pnpm changeset
37
- pnpm version-packages
38
- pnpm release
39
39
  ```
40
40
 
41
- Do not publish from a dirty worktree.
41
+ The npm package must have a GitHub Actions trusted publisher configured for
42
+ `AgentsKit-io/doc-bridge`, workflow `changesets.yml`, and environment `npm`.
43
+ Do not publish from a dirty worktree or run `pnpm release` locally.
42
44
 
43
45
  Project decisions and maintainer responsibilities are documented in
44
46
  [GOVERNANCE.md](GOVERNANCE.md). By participating, you agree to follow the
package/action.yml CHANGED
@@ -20,7 +20,7 @@ inputs:
20
20
  package-version:
21
21
  description: Exact @agentskit/doc-bridge npm version (kept in sync with this Action release)
22
22
  required: false
23
- default: '1.6.4'
23
+ default: '1.7.45'
24
24
 
25
25
  runs:
26
26
  using: composite