@orkestrel/scaffold 0.0.121 → 0.0.123
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/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +57 -9
- package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +22 -2
- package/dist/agents/skills/orkestrel-harden/scripts/interleave.js +539 -0
- package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +1163 -0
- package/dist/agents/skills/orkestrel-publish/scripts/pins.js +5 -5
- package/dist/agents/skills/orkestrel-publish/scripts/wave.js +67 -5
- package/dist/bin/main.js +8 -6
- package/dist/bin/main.js.map +1 -1
- package/dist/host/agents/orchestration.md +29 -18
- package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +7 -6
- package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +3 -2
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +65 -9
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +28 -2
- package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +4 -2
- package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +3 -2
- package/dist/host/agents/skills/orkestrel-harden/SKILL.md +24 -11
- package/dist/host/agents/skills/orkestrel-harden/references/bindings.md +18 -12
- package/dist/host/agents/skills/orkestrel-harden/references/document.md +1 -0
- package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +2 -1
- package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +4 -4
- package/dist/host/agents/skills/orkestrel-harden/references/methods.md +642 -0
- package/dist/host/agents/skills/orkestrel-harden/scripts/interleave.ts +665 -0
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +16 -15
- package/dist/host/agents/skills/orkestrel-parallel/references/{claude.md → claude-code.md} +13 -13
- package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +1 -0
- package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +1433 -0
- package/dist/host/agents/skills/orkestrel-publish/SKILL.md +12 -9
- package/dist/host/agents/skills/orkestrel-publish/references/release.md +2 -2
- package/dist/host/agents/skills/orkestrel-publish/references/wave.md +39 -8
- package/dist/host/agents/skills/orkestrel-publish/references/window.md +5 -1
- package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +5 -5
- package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +86 -7
- package/dist/host/claude/AGENTS.md +2 -2
- package/dist/host/claude/agents/analyst.md +1 -1
- package/dist/host/claude/agents/builder.md +1 -1
- package/dist/host/claude/agents/distiller.md +2 -1
- package/dist/host/claude/agents/grok.md +2 -2
- package/dist/host/claude/agents/opus.md +8 -7
- package/dist/host/claude/agents/orkestrel.md +7 -7
- package/dist/host/claude/agents/planner.md +3 -3
- package/dist/host/claude/agents/reviewer.md +3 -3
- package/dist/host/claude/agents/scout.md +2 -1
- package/dist/host/claude/agents/verifier.md +2 -2
- package/dist/host/claude/rules/campaign.md +15 -13
- package/dist/host/claude/rules/documentation.md +1 -0
- package/dist/host/claude/rules/names.md +13 -7
- package/dist/host/claude/rules/patterns.md +14 -0
- package/dist/host/claude/rules/quality.md +4 -1
- package/dist/host/claude/rules/tests.md +5 -1
- package/dist/host/claude/rules/workspace.md +9 -0
- package/dist/host/claude/rules/writing.md +1 -1
- package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-parallel/SKILL.md +1 -1
- package/dist/host/codex/agents/analyst.toml +6 -6
- package/dist/host/codex/agents/astra.toml +1 -1
- package/dist/host/codex/agents/builder.toml +1 -1
- package/dist/host/codex/agents/distiller.toml +4 -2
- package/dist/host/codex/agents/grok.toml +5 -2
- package/dist/host/codex/agents/opus.toml +6 -4
- package/dist/host/codex/agents/planner.toml +6 -5
- package/dist/host/codex/agents/reviewer.toml +9 -8
- package/dist/host/codex/agents/scout.toml +5 -1
- package/dist/host/codex/agents/verifier.toml +8 -3
- package/dist/host/dotfiles/gitignore +1 -2
- package/dist/host/guides/agent.md +1119 -457
- package/dist/host/guides/ndjson.md +81 -21
- package/dist/host/guides/ollama.md +22 -18
- package/dist/host/guides/probe.md +29 -27
- package/dist/host/guides/scaffold.md +42 -15
- package/dist/host/guides/study.md +538 -450
- package/dist/host/manifest.json +81 -63
- package/dist/host/tests/config.test.ts +7 -0
- package/dist/src/core/index.cjs +14 -8
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +1 -4
- package/dist/src/core/index.d.ts +1 -4
- package/dist/src/core/index.js +14 -8
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +87 -8
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.d.cts +50 -6
- package/dist/src/server/index.d.ts +50 -6
- package/dist/src/server/index.js +87 -10
- package/dist/src/server/index.js.map +1 -1
- package/package.json +2 -2
|
@@ -14,6 +14,7 @@ This reference governs the guide pass for one package, `AGENTS.md` § Work loop
|
|
|
14
14
|
2. **README.** Set the pitch equal to the guide's tagline; keep the install and link lines in step with the shipped exports.
|
|
15
15
|
3. **TSDoc.** Give each export the change touched the block `.claude/rules/typescript.md` § Comments and API documentation fixes, with fictional descriptive data in its `@example`.
|
|
16
16
|
4. **Fences.** Import through the published specifier and run each example; read what it returns before writing the comment beside it.
|
|
17
|
+
5. **Ergonomics.** Where the guide claims authoring ergonomics, pair the executed example with an independent reader who receives only the authored declaration, and test that reader's interpretation.
|
|
17
18
|
|
|
18
19
|
## Choose the rewrite direction
|
|
19
20
|
|
|
@@ -8,7 +8,8 @@ with a row for each class this contract names that the changed code admits.
|
|
|
8
8
|
|
|
9
9
|
## Hold the contract
|
|
10
10
|
|
|
11
|
-
- When a rewrite changes traversal, membership, allocation, or materialization, compare its cost growth with the baseline on the package's realistic load and rule the measured effect under `.claude/rules/quality.md` § Performance.
|
|
11
|
+
- When a rewrite changes traversal, membership, allocation, or materialization, compare its cost growth with the baseline on the package's realistic load and rule the measured effect under `.claude/rules/quality.md` § Performance. When a profile places the rewritten function on a hot path, also read its constant factor against the baseline, and rule that reading under the same section.
|
|
12
|
+
- When a loop that a profile places on a hot path recomputes a result for an input it already computed within one operation, a memo under `.claude/rules/typescript.md` § Bindings **Exemptions** can hold the result, and so can `#` fields of an entity created for the call under **Per-call state** when the call's awaits or callbacks change that state. Rule the gain under `.claude/rules/quality.md` § Performance, and keep every element read and effect this contract matches.
|
|
12
13
|
- Treat every value the declared parameter types admit as inside the contract: holes, entries read
|
|
13
14
|
through getters (their count and order), entries that throw, an array whose `Symbol.iterator` is
|
|
14
15
|
missing or replaced, and an iterator's `return()`.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Production hardening
|
|
2
2
|
|
|
3
|
-
This reference governs
|
|
3
|
+
This reference governs a hardening selection: the package's bounds, the risk and seam matrix, real-implementation testing, live-service tests, lifecycle pressure, holding the bounds, security paths, the test audit, and generated outputs.
|
|
4
4
|
|
|
5
5
|
## Build the risk and seam matrix
|
|
6
6
|
|
|
@@ -40,7 +40,7 @@ protocol tests prove the protocol, and only a real client of that class proves t
|
|
|
40
40
|
integration. Drive it end to end, record the exact commands, and record what that client
|
|
41
41
|
could NOT reach as an honest limit rather than an untested assumption.
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
`AGENTS.md` § Non-negotiable rules owns the law on mocks, fakes, and fake clocks. Use recorders for callbacks and customizable data factories/stubs for inert shapes.
|
|
44
44
|
|
|
45
45
|
## Design live-service tests
|
|
46
46
|
|
|
@@ -80,7 +80,7 @@ A seam's finding concerns the package when it falsifies a promise the contract m
|
|
|
80
80
|
- When a finding falsifies a promise, repair it within its row and close the repair with the mutation probe `.agents/orchestration.md` § Size gate names.
|
|
81
81
|
- When a finding describes a host behavior the contract never promised to survive, open one design question on the package's dependence on that behavior: remove the dependence, narrow the promise, or refuse on that host. Never add a mechanism around the behavior.
|
|
82
82
|
- When a finding is outside the bounds and below the release bar, record it in the deferral list (`.claude/rules/campaign.md` § Content), and reopen it only when its trigger fires.
|
|
83
|
-
- Before another round at one seam, weigh a further repair against a design question and re-examine the stop set for that seam against the signals `.agents/orchestration.md` § Size gate names;
|
|
83
|
+
- Before another round at one seam, weigh a further repair against a design question and re-examine the stop set for that seam against the signals `.agents/orchestration.md` § Size gate names; a hardening selection adds one: findings move from the contract to the host.
|
|
84
84
|
- A seam that reprices on every edit (a count, a timing) is not a seam; drop the claim per the `orkestrel-falsify` skill § End the depth search.
|
|
85
85
|
|
|
86
86
|
## Audit security and destructive paths
|
|
@@ -96,7 +96,7 @@ For every fetch, write, delete, extraction, path, protocol, or authentication bo
|
|
|
96
96
|
|
|
97
97
|
## Audit the tests themselves
|
|
98
98
|
|
|
99
|
-
Run the discovery census, `scripts/discovery.ts` as `SKILL.md` § Scripts states (step 11 of the
|
|
99
|
+
Run the discovery census, `scripts/discovery.ts` as `SKILL.md` § Scripts states (step 11 of the workflow): which project collects each file, which gate reaches each project, and where a file carries `.todo`, a conditional skip (`.skipIf`, `.runIf`), `.fails`, a retry, or a timeout. `vitest/no-focused-tests` and `vitest/no-disabled-tests` refuse `.only` and `.skip`. Then verify:
|
|
100
100
|
|
|
101
101
|
- every intended test file is collected by the correct project, and the test counts and environments match the intent;
|
|
102
102
|
- judge each discovered project's invocation and gate membership by `.claude/rules/workspace.md` § Test project matrix; read each reported chain and rule each workbench by its purpose;
|