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.
- package/bundle/CHANGELOG.md +10 -0
- package/bundle/DESIGN.md +3 -7
- package/bundle/README.md +1 -4
- package/bundle/UPGRADE.md +33 -0
- package/bundle/fixtures/routing/hybrid-corpus.yaml +154 -0
- package/bundle/references/adapters/package-registry.yaml +2 -0
- package/bundle/references/adapters/package-surface-characterization.md +2 -2
- package/bundle/references/analysis/benchmark.md +2 -9
- package/bundle/references/artifacts/state-storage-authority.yaml +298 -13
- package/bundle/references/cli/capability-instruction-structure.md +2 -2
- package/bundle/references/cli/hybrid-route-contract.yaml +416 -0
- package/bundle/references/cli/prime-consumer-compatibility.yaml +12 -11
- package/bundle/references/cli/routing-model.md +136 -91
- package/bundle/references/cli/trigger-schema-enrichment.md +50 -46
- package/bundle/references/cli/vocabulary.md +7 -9
- package/bundle/references/meta/documentation-inventory.md +1 -3
- package/bundle/skills/agentera/SKILL.md +50 -18
- package/bundle/skills/agentera/capabilities/audit/schemas/triggers.yaml +13 -35
- package/bundle/skills/agentera/capabilities/build/schemas/triggers.yaml +14 -36
- package/bundle/skills/agentera/capabilities/design/schemas/triggers.yaml +5 -34
- package/bundle/skills/agentera/capabilities/discuss/schemas/triggers.yaml +6 -40
- package/bundle/skills/agentera/capabilities/document/schemas/triggers.yaml +5 -34
- package/bundle/skills/agentera/capabilities/optimize/schemas/triggers.yaml +4 -35
- package/bundle/skills/agentera/capabilities/orchestrate/schemas/triggers.yaml +5 -37
- package/bundle/skills/agentera/capabilities/plan/schemas/triggers.yaml +8 -31
- package/bundle/skills/agentera/capabilities/profile/schemas/triggers.yaml +8 -37
- package/bundle/skills/agentera/capabilities/research/schemas/triggers.yaml +5 -29
- package/bundle/skills/agentera/capabilities/status/schemas/triggers.yaml +7 -47
- package/bundle/skills/agentera/capabilities/vision/schemas/triggers.yaml +7 -39
- package/bundle/skills/agentera/capability_schema_contract.yaml +29 -29
- package/bundle/skills/agentera/route-phrases.yaml +81 -0
- package/bundle/skills/agentera/schemas/artifacts/plan.yaml +1 -1
- package/dist/capabilities/discuss/instructions.js +1 -1
- package/dist/capabilities/discuss/instructions.js.map +1 -1
- package/dist/capabilities/plan/instructions.js +1 -1
- package/dist/capabilities/plan/instructions.js.map +1 -1
- package/dist/cli/capabilityContext/evidence.js +1 -1
- package/dist/cli/capabilityContext/evidence.js.map +1 -1
- package/dist/cli/commands/entityMigrate.js +7 -3
- package/dist/cli/commands/entityMigrate.js.map +1 -1
- package/dist/cli/commands/prime/briefOrientation.js +10 -3
- package/dist/cli/commands/prime/briefOrientation.js.map +1 -1
- package/dist/cli/commands/prime/collectEntityOrientation.js +64 -4
- package/dist/cli/commands/prime/collectEntityOrientation.js.map +1 -1
- package/dist/cli/commands/prime/orientationOutput.js +41 -15
- package/dist/cli/commands/prime/orientationOutput.js.map +1 -1
- package/dist/cli/commands/prime.js +4 -3
- package/dist/cli/commands/prime.js.map +1 -1
- package/dist/cli/commands/route.js +142 -0
- package/dist/cli/commands/route.js.map +1 -0
- package/dist/cli/commands/state/write.js +19 -0
- package/dist/cli/commands/state/write.js.map +1 -1
- package/dist/cli/commands/verify.js +17 -1
- package/dist/cli/commands/verify.js.map +1 -1
- package/dist/cli/dispatch/index.js +18 -0
- package/dist/cli/dispatch/index.js.map +1 -1
- package/dist/cli/errors.js +2 -2
- package/dist/cli/errors.js.map +1 -1
- package/dist/cli/help.js +20 -1
- package/dist/cli/help.js.map +1 -1
- package/dist/cli/migrationRequired.js +1 -1
- package/dist/cli/migrationRequired.js.map +1 -1
- package/dist/eval/hybridRouteEvaluation.js +156 -0
- package/dist/eval/hybridRouteEvaluation.js.map +1 -0
- package/dist/registries/capabilityContract.js +5 -20
- package/dist/registries/capabilityContract.js.map +1 -1
- package/dist/registries/hybridRoute.js +203 -0
- package/dist/registries/hybridRoute.js.map +1 -0
- package/dist/registries/hybridRouteReceipt.js +221 -0
- package/dist/registries/hybridRouteReceipt.js.map +1 -0
- package/dist/registries/triggerLoader.js +7 -43
- package/dist/registries/triggerLoader.js.map +1 -1
- package/dist/release/releaseMetadata.js +2 -0
- package/dist/release/releaseMetadata.js.map +1 -1
- package/dist/state/archiveDiscovery.js +24 -35
- package/dist/state/archiveDiscovery.js.map +1 -1
- package/dist/state/canonicalMigrationRecord.js +37 -0
- package/dist/state/canonicalMigrationRecord.js.map +1 -0
- package/dist/state/decisionEntities.js +73 -33
- package/dist/state/decisionEntities.js.map +1 -1
- package/dist/state/decisionLegacyValidation.js +31 -0
- package/dist/state/decisionLegacyValidation.js.map +1 -1
- package/dist/state/decisionMigrationProvenance.js +117 -0
- package/dist/state/decisionMigrationProvenance.js.map +1 -0
- package/dist/state/durability.js +24 -5
- package/dist/state/durability.js.map +1 -1
- package/dist/state/entityCutover.js +2 -2
- package/dist/state/entityCutover.js.map +1 -1
- package/dist/state/entityMigrationCausality.js +99 -0
- package/dist/state/entityMigrationCausality.js.map +1 -0
- package/dist/state/entityMigrationPreview.js +138 -77
- package/dist/state/entityMigrationPreview.js.map +1 -1
- package/dist/state/entityStorage.js +59 -24
- package/dist/state/entityStorage.js.map +1 -1
- package/dist/state/healthEntities.js +28 -31
- package/dist/state/healthEntities.js.map +1 -1
- package/dist/state/legacySummaryRecord.js +7 -0
- package/dist/state/legacySummaryRecord.js.map +1 -0
- package/dist/state/listCursor.js +43 -0
- package/dist/state/listCursor.js.map +1 -0
- package/dist/state/migrationSourceBinding.js +29 -0
- package/dist/state/migrationSourceBinding.js.map +1 -0
- package/dist/state/progressEntities.js +35 -59
- package/dist/state/progressEntities.js.map +1 -1
- package/dist/state/retrievalAuthority.js +10 -0
- package/dist/state/retrievalAuthority.js.map +1 -1
- package/dist/state/summaryEntityRead.js +26 -0
- package/dist/state/summaryEntityRead.js.map +1 -0
- package/dist/state/summaryMigrationProvenance.js +67 -0
- package/dist/state/summaryMigrationProvenance.js.map +1 -0
- package/dist/state/summarySourceRowAuthority.js +37 -0
- package/dist/state/summarySourceRowAuthority.js.map +1 -0
- package/dist/validate/capability.js +11 -2
- package/dist/validate/capability.js.map +1 -1
- package/package.json +2 -2
- package/bundle/references/analysis/analytics-boundary-proportional-2026-07-20.yaml +0 -74
- package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-1.json.gz +0 -0
- package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-2.json.gz +0 -0
- package/bundle/references/analysis/evidence/analytics-boundary-proportional-2026-07-20/source-focused-3.json.gz +0 -0
- package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-1.json.gz +0 -0
- package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-2.json.gz +0 -0
- package/bundle/references/analysis/evidence/migration-pagination-proportional-2026-07-20/source-focused-3.json.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-cli-route.log.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-cli.log.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/precommit-documentation.log.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/recompute.mjs +0 -98
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-1.json.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-2.json.gz +0 -0
- package/bundle/references/analysis/evidence/verification-baseline-2026-07-20/source-3.json.gz +0 -0
- package/bundle/references/analysis/migration-pagination-proportional-2026-07-20.yaml +0 -64
- package/bundle/references/analysis/verification-baseline-2026-07-20.yaml +0 -313
- package/bundle/references/analysis/verification-final-proof-2026-07-21.yaml +0 -340
- 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.
|