agentera 3.0.0-dev.27 → 3.0.0-dev.28

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 (133) hide show
  1. package/bundle/CHANGELOG.md +10 -0
  2. package/bundle/DESIGN.md +3 -7
  3. package/bundle/README.md +1 -4
  4. package/bundle/UPGRADE.md +33 -0
  5. package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
  6. package/bundle/references/adapters/package-registry.yaml +2 -0
  7. package/bundle/references/adapters/package-surface-characterization.md +2 -2
  8. package/bundle/references/analysis/benchmark.md +2 -9
  9. package/bundle/references/artifacts/state-storage-authority.yaml +298 -13
  10. package/bundle/references/cli/capability-instruction-structure.md +2 -2
  11. package/bundle/references/cli/hybrid-route-contract.yaml +416 -0
  12. package/bundle/references/cli/prime-consumer-compatibility.yaml +12 -11
  13. package/bundle/references/cli/routing-model.md +136 -91
  14. package/bundle/references/cli/trigger-schema-enrichment.md +50 -46
  15. package/bundle/references/cli/vocabulary.md +7 -9
  16. package/bundle/references/meta/documentation-inventory.md +1 -3
  17. package/bundle/skills/agentera/SKILL.md +50 -18
  18. package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +13 -35
  19. package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +14 -36
  20. package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +5 -34
  21. package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +6 -40
  22. package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +5 -34
  23. package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +4 -35
  24. package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +5 -37
  25. package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +8 -31
  26. package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +8 -37
  27. package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +5 -29
  28. package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +7 -47
  29. package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +7 -39
  30. package/bundle/skills/agentera/capability_schema_contract.yaml +29 -29
  31. package/bundle/skills/agentera/route-phrases.yaml +81 -0
  32. package/bundle/skills/agentera/schemas/artifacts/plan.yaml +1 -1
  33. package/dist/capabilities/discuss/instructions.js +1 -1
  34. package/dist/capabilities/discuss/instructions.js.map +1 -1
  35. package/dist/capabilities/plan/instructions.js +1 -1
  36. package/dist/capabilities/plan/instructions.js.map +1 -1
  37. package/dist/cli/capabilityContext/evidence.js +1 -1
  38. package/dist/cli/capabilityContext/evidence.js.map +1 -1
  39. package/dist/cli/commands/entityMigrate.js +7 -3
  40. package/dist/cli/commands/entityMigrate.js.map +1 -1
  41. package/dist/cli/commands/prime/briefOrientation.js +10 -3
  42. package/dist/cli/commands/prime/briefOrientation.js.map +1 -1
  43. package/dist/cli/commands/prime/collectEntityOrientation.js +64 -4
  44. package/dist/cli/commands/prime/collectEntityOrientation.js.map +1 -1
  45. package/dist/cli/commands/prime/orientationOutput.js +41 -15
  46. package/dist/cli/commands/prime/orientationOutput.js.map +1 -1
  47. package/dist/cli/commands/prime.js +4 -3
  48. package/dist/cli/commands/prime.js.map +1 -1
  49. package/dist/cli/commands/route.js +142 -0
  50. package/dist/cli/commands/route.js.map +1 -0
  51. package/dist/cli/commands/state/write.js +19 -0
  52. package/dist/cli/commands/state/write.js.map +1 -1
  53. package/dist/cli/commands/verify.js +17 -1
  54. package/dist/cli/commands/verify.js.map +1 -1
  55. package/dist/cli/dispatch/index.js +18 -0
  56. package/dist/cli/dispatch/index.js.map +1 -1
  57. package/dist/cli/errors.js +2 -2
  58. package/dist/cli/errors.js.map +1 -1
  59. package/dist/cli/help.js +20 -1
  60. package/dist/cli/help.js.map +1 -1
  61. package/dist/cli/migrationRequired.js +1 -1
  62. package/dist/cli/migrationRequired.js.map +1 -1
  63. package/dist/eval/hybridRouteEvaluation.js +156 -0
  64. package/dist/eval/hybridRouteEvaluation.js.map +1 -0
  65. package/dist/registries/capabilityContract.js +5 -20
  66. package/dist/registries/capabilityContract.js.map +1 -1
  67. package/dist/registries/hybridRoute.js +203 -0
  68. package/dist/registries/hybridRoute.js.map +1 -0
  69. package/dist/registries/hybridRouteReceipt.js +221 -0
  70. package/dist/registries/hybridRouteReceipt.js.map +1 -0
  71. package/dist/registries/triggerLoader.js +7 -43
  72. package/dist/registries/triggerLoader.js.map +1 -1
  73. package/dist/release/releaseMetadata.js +2 -0
  74. package/dist/release/releaseMetadata.js.map +1 -1
  75. package/dist/state/archiveDiscovery.js +24 -35
  76. package/dist/state/archiveDiscovery.js.map +1 -1
  77. package/dist/state/canonicalMigrationRecord.js +37 -0
  78. package/dist/state/canonicalMigrationRecord.js.map +1 -0
  79. package/dist/state/decisionEntities.js +73 -33
  80. package/dist/state/decisionEntities.js.map +1 -1
  81. package/dist/state/decisionLegacyValidation.js +31 -0
  82. package/dist/state/decisionLegacyValidation.js.map +1 -1
  83. package/dist/state/decisionMigrationProvenance.js +117 -0
  84. package/dist/state/decisionMigrationProvenance.js.map +1 -0
  85. package/dist/state/durability.js +24 -5
  86. package/dist/state/durability.js.map +1 -1
  87. package/dist/state/entityCutover.js +2 -2
  88. package/dist/state/entityCutover.js.map +1 -1
  89. package/dist/state/entityMigrationCausality.js +99 -0
  90. package/dist/state/entityMigrationCausality.js.map +1 -0
  91. package/dist/state/entityMigrationPreview.js +138 -77
  92. package/dist/state/entityMigrationPreview.js.map +1 -1
  93. package/dist/state/entityStorage.js +59 -24
  94. package/dist/state/entityStorage.js.map +1 -1
  95. package/dist/state/healthEntities.js +28 -31
  96. package/dist/state/healthEntities.js.map +1 -1
  97. package/dist/state/legacySummaryRecord.js +7 -0
  98. package/dist/state/legacySummaryRecord.js.map +1 -0
  99. package/dist/state/listCursor.js +43 -0
  100. package/dist/state/listCursor.js.map +1 -0
  101. package/dist/state/migrationSourceBinding.js +29 -0
  102. package/dist/state/migrationSourceBinding.js.map +1 -0
  103. package/dist/state/progressEntities.js +35 -59
  104. package/dist/state/progressEntities.js.map +1 -1
  105. package/dist/state/retrievalAuthority.js +10 -0
  106. package/dist/state/retrievalAuthority.js.map +1 -1
  107. package/dist/state/summaryEntityRead.js +26 -0
  108. package/dist/state/summaryEntityRead.js.map +1 -0
  109. package/dist/state/summaryMigrationProvenance.js +67 -0
  110. package/dist/state/summaryMigrationProvenance.js.map +1 -0
  111. package/dist/state/summarySourceRowAuthority.js +37 -0
  112. package/dist/state/summarySourceRowAuthority.js.map +1 -0
  113. package/dist/validate/capability.js +11 -2
  114. package/dist/validate/capability.js.map +1 -1
  115. package/package.json +2 -2
  116. package/bundle/references/analysis/analytics-boundary-proportional-2026-07-20.yaml +0 -74
  117. package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-1.json.gz +0 -0
  118. package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-2.json.gz +0 -0
  119. package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-3.json.gz +0 -0
  120. package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-1.json.gz +0 -0
  121. package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-2.json.gz +0 -0
  122. package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-3.json.gz +0 -0
  123. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-cli-route.log.gz +0 -0
  124. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-cli.log.gz +0 -0
  125. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-documentation.log.gz +0 -0
  126. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/recompute.mjs +0 -98
  127. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-1.json.gz +0 -0
  128. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-2.json.gz +0 -0
  129. package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-3.json.gz +0 -0
  130. package/bundle/references/analysis/migration-pagination-proportional-2026-07-20.yaml +0 -64
  131. package/bundle/references/analysis/verification-baseline-2026-07-20.yaml +0 -313
  132. package/bundle/references/analysis/verification-final-proof-2026-07-21.yaml +0 -340
  133. package/bundle/references/analysis/worker-policy-2026-07-21.yaml +0 -207
@@ -1,207 +0,0 @@
1
- schemaVersion: agentera.workerPolicyBenchmark.v1
2
- status: selected
3
- captured: 2026-07-21
4
-
5
- runner:
6
- baseline_reference: references/analysis/verification-baseline-2026-07-20.yaml
7
- name: local-16-logical-cpu-node22
8
- plan_label: named 16-core Node 22 runner
9
- plan_label_mapping: >-
10
- "16-core" means the 16 logical scheduling CPUs reported by nproc and
11
- os.cpus(), not physical cores. The named runner is an AMD Ryzen 7 9800X3D
12
- with 8 physical cores and 16 threads, running Linux 7.1.4-1-cachyos,
13
- Node v22.23.1, and pnpm 10.30.3. This preserves the historical baseline's
14
- terminology without claiming 16 physical cores.
15
-
16
- method:
17
- command: pnpm run test:source
18
- working_directory: packages/cli
19
- selection: >-
20
- Each candidate was supplied only through VITEST_MAX_WORKERS, after which
21
- the source owner selected its complete inventory through verify-lane.mjs.
22
- No file filters, retries, reporter overrides, or concurrent invocations
23
- were used.
24
- protocol: >-
25
- Run one unretained warmup followed immediately by three retained runs for
26
- each safe candidate, serially in ascending worker order. Record Bash
27
- process wall time and Vitest's reported duration, file count, and test
28
- count. The shell emitted comma decimal separators; table values normalize
29
- them to decimal points.
30
- reproduction: >-
31
- From packages/cli, for each workers value and phase in warmup sample-1
32
- sample-2 sample-3, run: TIMEFORMAT="workers=$workers phase=$phase
33
- wall_seconds=%3R"; time env VITEST_MAX_WORKERS="$workers" pnpm run
34
- test:source. Run candidates serially; retain only the three samples after
35
- each warmup.
36
- pass_conditions:
37
- - source command exits zero
38
- - 193 test files pass and 2365 tests pass with one declared Darwin skip
39
- - no test exceeds the configured 30000 ms timeout
40
- - no retry, shared-output failure, or generated-output race is reported
41
-
42
- candidates:
43
- - workers: 6
44
- warmup:
45
- wall_seconds: 66.085
46
- vitest_duration_seconds: 64.47
47
- retained:
48
- - wall_seconds: 55.297
49
- vitest_duration_seconds: 54.30
50
- - wall_seconds: 50.028
51
- vitest_duration_seconds: 49.09
52
- - wall_seconds: 49.322
53
- vitest_duration_seconds: 48.38
54
- median:
55
- wall_seconds: 50.028
56
- vitest_duration_seconds: 49.09
57
- result: pass
58
- - workers: 8
59
- warmup:
60
- wall_seconds: 43.899
61
- vitest_duration_seconds: 42.94
62
- retained:
63
- - wall_seconds: 43.968
64
- vitest_duration_seconds: 43.03
65
- - wall_seconds: 43.598
66
- vitest_duration_seconds: 42.66
67
- - wall_seconds: 43.926
68
- vitest_duration_seconds: 42.99
69
- median:
70
- wall_seconds: 43.926
71
- vitest_duration_seconds: 42.99
72
- result: pass
73
-
74
- selection:
75
- precedence:
76
- - VITEST_MAX_WORKERS explicit numeric override
77
- - AGENTERA_VITEST_RUNNER_POLICY=local-16-logical-cpu-node22
78
- - unmeasured fallback
79
- measured_local:
80
- selector: AGENTERA_VITEST_RUNNER_POLICY=local-16-logical-cpu-node22
81
- workers: 8
82
- evidence_status: measured
83
- rationale: >-
84
- Eight is the faster of the two safe, repeatably passing candidates: its
85
- 43.926-second retained median is 6.102 seconds (12.197 percent) below the
86
- six-worker median. It is also the plan's stated maximum safe candidate.
87
- It is selected only through the named runner-policy selector, never from
88
- CPU count or host fingerprinting.
89
- unmeasured_fallback:
90
- selector: AGENTERA_VITEST_RUNNER_POLICY=unmeasured or no recognized selector
91
- workers: 4
92
- evidence_status: unmeasured_pending_benchmark
93
- evidence: >-
94
- references/analysis/verification-baseline-2026-07-20.yaml retains only
95
- the named local runner's measurements and requires each CI runner to be
96
- benchmarked. No retained GitHub-hosted runner measurement is available.
97
- rationale: >-
98
- Four workers is a conservative bounded fallback, not a GitHub-hosted
99
- runner measurement. Every CI runner needs its own retained benchmark
100
- before a tuned policy may replace it.
101
- explicit_override:
102
- selector: VITEST_MAX_WORKERS=<Vitest-supported worker count>
103
- evidence_status: operator_selected
104
- rationale: >-
105
- This takes precedence over runner policy and is not presented as a
106
- benchmarked setting unless separately measured and recorded.
107
- historical_baseline: >-
108
- The preserved four-worker baseline is 81.466 seconds median at source
109
- revision af9cf773 (references/analysis/verification-baseline-2026-07-20.yaml).
110
- Its 191 files and 2230 tests differ from this checkout's 193 files and
111
- 2365 tests, so it provides historical context rather than a like-for-like
112
- speedup calculation.
113
- unsafe_upper_bound: >-
114
- Twelve workers previously failed under contention. It was not rerun and
115
- is not a supported candidate, a selection target, or evidence superseded
116
- by this measurement.
117
-
118
- superseded_confirmation:
119
- command: pnpm run test:source
120
- environment: VITEST_MAX_WORKERS unset; previous global default selected eight workers
121
- consecutive_runs:
122
- - wall_seconds: 43.869
123
- vitest_duration_seconds: 42.90
124
- files_passed: 194
125
- tests_passed: 2366
126
- tests_skipped: 1
127
- - wall_seconds: 43.972
128
- vitest_duration_seconds: 43.02
129
- files_passed: 194
130
- tests_passed: 2366
131
- tests_skipped: 1
132
- - wall_seconds: 44.210
133
- vitest_duration_seconds: 43.27
134
- files_passed: 194
135
- tests_passed: 2366
136
- tests_skipped: 1
137
- result: >-
138
- These three serial source runs passed without timeout, retry, shared-output
139
- race, or generated-output failure, but they predate the runner-specific
140
- correction and must not be treated as evidence for the selector below.
141
-
142
- corrected_final_confirmation:
143
- command: pnpm run test:source
144
- environment: AGENTERA_VITEST_RUNNER_POLICY=local-16-logical-cpu-node22; VITEST_MAX_WORKERS unset
145
- consecutive_runs:
146
- - wall_seconds: 43.508
147
- vitest_duration_seconds: 42.56
148
- files_passed: 194
149
- tests_passed: 2369
150
- tests_skipped: 1
151
- - wall_seconds: 43.806
152
- vitest_duration_seconds: 42.85
153
- files_passed: 194
154
- tests_passed: 2369
155
- tests_skipped: 1
156
- - wall_seconds: 43.330
157
- vitest_duration_seconds: 42.39
158
- files_passed: 194
159
- tests_passed: 2369
160
- tests_skipped: 1
161
- result: >-
162
- All three serial runs selected the named measured-local policy and passed
163
- without timeout, retry, shared-output race, or generated-output failure.
164
-
165
- unmeasured_path_verification:
166
- environment: AGENTERA_VITEST_RUNNER_POLICY=unmeasured
167
- runner: local-16-logical-cpu-node22
168
- workers: 4
169
- wall_seconds: 71.296
170
- vitest_duration_seconds: 70.34
171
- files_passed: 194
172
- tests_passed: 2369
173
- tests_skipped: 1
174
- interpretation: >-
175
- This is one local integration check of the unmeasured selector, not a
176
- GitHub-hosted benchmark or evidence that CI can be tuned to four workers.
177
-
178
- policy_composition:
179
- authority: references/analysis/verification-policy.yaml
180
- verification: >-
181
- laneOwnership.test.ts requires the exact Task 2 policy compositions:
182
- targeted/precommit/fast/local=[source], merge=[source, package],
183
- scheduled=[source, stress, performance], and
184
- release=[source, stress, performance, package]. verify-lane validates
185
- exactly one primary owner per inventory file before composing a policy.
186
- precommit: >-
187
- scripts/precommit-vitest.sh routes ordinary staged source work to source
188
- and conservative authority surfaces to release; it delegates composition
189
- to verify-lane rather than declaring a second owner policy.
190
- ci: >-
191
- .github/workflows/ci.yml explicitly supplies
192
- AGENTERA_VITEST_RUNNER_POLICY=unmeasured to source verification. This
193
- selects the four-worker pending-benchmark fallback; it does not claim a
194
- GitHub-hosted measurement. CI separately invokes source and package
195
- owners; stress and performance remain scheduled/release policy owners.
196
- No new composition or owner was added for worker selection.
197
-
198
- caveats:
199
- - >-
200
- references/analysis/verification-final-proof-2026-07-21.yaml reran the
201
- classified final tree on this selector after measured fixture deduplication.
202
- All owner and policy evidence passed; the 42.908-second source median is
203
- 47.330 percent below the historical four-worker baseline and satisfies the
204
- 45-second task limit.
205
- - Decisions retrieval was degraded to 5 of 50 records; missing detail was not reconstructed.
206
- - Satisfaction records remain unavailable for llavvlpcmb and djmjbmruyk.
207
- - Vision and profile state were absent from the original build context; no approval was inferred.