@orkestrel/scaffold 0.0.114 → 0.0.116
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/bin/main.js +137 -15
- package/dist/bin/main.js.map +1 -1
- package/dist/host/agents/orchestration.md +5 -3
- package/dist/host/agents/platforms/windows.md +1 -0
- package/dist/host/agents/skills/orkestrel-align/references/integration.md +1 -1
- package/dist/host/agents/skills/orkestrel-debrief/SKILL.md +4 -4
- package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +4 -1
- package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +8 -2
- package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +1 -0
- package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +1 -1
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -1
- package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +1 -0
- package/dist/host/agents/skills/orkestrel-publish/references/wave.md +9 -3
- package/dist/host/claude/agents/analyst.md +1 -1
- package/dist/host/claude/agents/astra.md +2 -2
- package/dist/host/claude/agents/builder.md +4 -4
- package/dist/host/claude/agents/opus.md +3 -3
- package/dist/host/claude/agents/orkestrel.md +5 -7
- package/dist/host/claude/agents/planner.md +8 -2
- package/dist/host/claude/rules/campaign.md +2 -1
- package/dist/host/claude/rules/documentation.md +1 -0
- package/dist/host/claude/rules/names.md +3 -1
- package/dist/host/claude/rules/tests.md +7 -4
- package/dist/host/claude/rules/writing.md +1 -0
- package/dist/host/claude/skills/enterprise-bootstrap/SKILL.md +1 -2
- package/dist/host/claude/skills/orkestrel-align/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-build/SKILL.md +1 -2
- package/dist/host/claude/skills/orkestrel-debrief/SKILL.md +1 -2
- package/dist/host/claude/skills/orkestrel-dispatch/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-falsify/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-journey/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-parallel/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-polish/SKILL.md +1 -2
- package/dist/host/claude/skills/orkestrel-publish/SKILL.md +1 -2
- package/dist/host/claude/skills/orkestrel-scout/SKILL.md +1 -1
- package/dist/host/codex/agents/analyst.toml +8 -5
- package/dist/host/codex/agents/astra.toml +4 -5
- package/dist/host/codex/agents/builder.toml +5 -5
- package/dist/host/codex/agents/opus.toml +3 -4
- package/dist/host/codex/agents/orkestrel.toml +2 -1
- package/dist/host/codex/agents/planner.toml +8 -5
- package/dist/host/codex/agents/reviewer.toml +5 -4
- package/dist/host/guides/abort.md +17 -17
- package/dist/host/guides/agent.md +445 -445
- package/dist/host/guides/brief.md +143 -143
- package/dist/host/guides/browser.md +731 -731
- package/dist/host/guides/budget.md +39 -39
- package/dist/host/guides/capture.md +298 -298
- package/dist/host/guides/console.md +109 -109
- package/dist/host/guides/contract.md +335 -335
- package/dist/host/guides/csv.md +30 -30
- package/dist/host/guides/database.md +163 -163
- package/dist/host/guides/emitter.md +17 -17
- package/dist/host/guides/form.md +99 -99
- package/dist/host/guides/guide.md +361 -183
- package/dist/host/guides/html.md +49 -49
- package/dist/host/guides/indexeddb.md +40 -40
- package/dist/host/guides/interpret.md +139 -139
- package/dist/host/guides/lsp.md +114 -114
- package/dist/host/guides/markdown.md +68 -68
- package/dist/host/guides/mcp.md +3745 -3745
- package/dist/host/guides/middleware.md +170 -170
- package/dist/host/guides/msg.md +95 -95
- package/dist/host/guides/ndjson.md +8 -8
- package/dist/host/guides/ollama.md +56 -56
- package/dist/host/guides/pool.md +21 -21
- package/dist/host/guides/probe.md +82 -82
- package/dist/host/guides/process.md +99 -99
- package/dist/host/guides/program.md +98 -96
- package/dist/host/guides/qualifier.md +70 -70
- package/dist/host/guides/queue.md +37 -37
- package/dist/host/guides/rater.md +38 -38
- package/dist/host/guides/reason.md +308 -308
- package/dist/host/guides/relation.md +50 -50
- package/dist/host/guides/router.md +58 -58
- package/dist/host/guides/scaffold.md +554 -419
- package/dist/host/guides/sea.md +128 -128
- package/dist/host/guides/server.md +100 -100
- package/dist/host/guides/sqlite.md +28 -28
- package/dist/host/guides/sse.md +20 -20
- package/dist/host/guides/study.md +444 -444
- package/dist/host/guides/table.md +82 -82
- package/dist/host/guides/template.md +41 -41
- package/dist/host/guides/terminal.md +121 -121
- package/dist/host/guides/test.md +273 -273
- package/dist/host/guides/timeout.md +18 -18
- package/dist/host/guides/tool.md +27 -27
- package/dist/host/guides/toolbox.md +166 -166
- package/dist/host/guides/websocket.md +54 -54
- package/dist/host/guides/worker.md +24 -24
- package/dist/host/guides/workflow.md +187 -187
- package/dist/host/guides/workspace.md +55 -55
- package/dist/host/manifest.json +93 -93
- package/dist/host/tests/setupPolicy.ts +5 -3
- package/dist/src/core/index.cjs +89 -3
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +229 -144
- package/dist/src/core/index.d.ts +229 -144
- package/dist/src/core/index.js +87 -4
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +292 -66
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.d.cts +188 -6
- package/dist/src/server/index.d.ts +188 -6
- package/dist/src/server/index.js +287 -69
- package/dist/src/server/index.js.map +1 -1
- package/package.json +4 -3
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
name = "astra"
|
|
2
|
-
description = "GPT-6 Astra implementation of one bounded, objective, constraint-heavy unit
|
|
2
|
+
description = "GPT-6 Astra implementation of one bounded, objective, constraint-heavy unit under the orchestration contract."
|
|
3
3
|
model = "gpt-6-astra"
|
|
4
4
|
model_reasoning_effort = "high"
|
|
5
5
|
sandbox_mode = "workspace-write"
|
|
@@ -11,10 +11,9 @@ skill, and the guide. Follow AGENTS.md § Work loop: types first, prove the clai
|
|
|
11
11
|
test, consolidate, document. Select the instrument per AGENTS.md § Work loop and
|
|
12
12
|
.claude/rules/quality.md § Instruments and return the evidence that instrument produced.
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
.claude/rules/tests.md § Probes.
|
|
14
|
+
Apply .agents/orchestration.md § Parallelism for shared-file and validation ownership, and the
|
|
15
|
+
orkestrel-parallel skill § Implement in phases when that procedure applies. Leave no probe behind,
|
|
16
|
+
per .claude/rules/tests.md § Probes.
|
|
18
17
|
|
|
19
18
|
Never add a dependency, suppress a diagnostic, mock project-owned behavior, leave a TODO in scope,
|
|
20
19
|
commit, push, install, read a secret, or run a destructive command. Stop only per
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
name = "builder"
|
|
2
|
-
description = "Sol executor for a fully specified unit with a closed shape in src, app, tests, or configs;
|
|
2
|
+
description = "Sol executor for a fully specified unit with a closed shape in src, app, tests, or configs; owns and validates its files under the orchestration contract."
|
|
3
3
|
model = "gpt-6.1-sol"
|
|
4
4
|
model_reasoning_effort = "low"
|
|
5
5
|
sandbox_mode = "workspace-write"
|
|
@@ -7,10 +7,10 @@ developer_instructions = """
|
|
|
7
7
|
Implement a fully specified unit with a closed shape. The dispatch is the plan; do not re-plan.
|
|
8
8
|
|
|
9
9
|
Read the brief, the .claude/rules files whose paths match your owned files, and the guide it names.
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
10
|
+
Follow AGENTS.md § Work loop at the size the brief names. Apply .agents/orchestration.md
|
|
11
|
+
§ Parallelism for shared-file and validation ownership, and the orkestrel-parallel skill
|
|
12
|
+
§ Implement in phases when that procedure applies. Leave no probe behind, per
|
|
13
|
+
.claude/rules/tests.md § Probes.
|
|
14
14
|
|
|
15
15
|
A unit that leaves naming, API shape, or architecture open, or that spans packages, belongs to
|
|
16
16
|
astra or opus: stop and say so. A unit whose mechanism is open: a protocol, a lock, a retry class, or a termination path; report it as belonging to astra or opus. Never install, commit, push, read a secret, or run a destructive command. Stop and report
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
name = "opus"
|
|
2
|
-
description = "GPT-6 Astra implementation of one bounded subjective unit: API shape, naming, ergonomics, guide voice.
|
|
2
|
+
description = "GPT-6 Astra implementation of one bounded subjective unit: API shape, naming, ergonomics, guide voice. Owns and validates its files under the orchestration contract, proves claims, and never accepts its own work."
|
|
3
3
|
model = "gpt-6-astra"
|
|
4
4
|
model_reasoning_effort = "high"
|
|
5
5
|
sandbox_mode = "workspace-write"
|
|
@@ -11,9 +11,8 @@ guide. Follow AGENTS.md § Work loop: types first, prove the claim, implement, t
|
|
|
11
11
|
document. Select the instrument per AGENTS.md § Work loop and .claude/rules/quality.md § Instruments
|
|
12
12
|
and return the evidence that instrument produced.
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
Never run format, lint --fix, build, or the whole suite. Leave no probe behind, per
|
|
14
|
+
Apply .agents/orchestration.md § Parallelism for shared-file and validation ownership, and the
|
|
15
|
+
orkestrel-parallel skill § Implement in phases when that procedure applies. Leave no probe behind, per
|
|
17
16
|
.claude/rules/tests.md § Probes. Finish the whole unit. Stop only per
|
|
18
17
|
.agents/orchestration.md § Deviation protocol.
|
|
19
18
|
|
|
@@ -18,7 +18,8 @@ evidence a question needs, report that question as unknown, name the reading tha
|
|
|
18
18
|
settle it, and stop; live collection belongs to a tool-capable lane or to the
|
|
19
19
|
Orchestrator before this role is dispatched. Never edit, install, push, or spawn.
|
|
20
20
|
Return exactly one requested shape: `Map`, `Health`, or `Work order`, as the Claude
|
|
21
|
-
charter defines them.
|
|
21
|
+
charter defines them.
|
|
22
|
+
Read the catalog table as the layer order that `.agents/skills/orkestrel-publish/references/release.md` uses and as discovery data for versions, never as live state.
|
|
22
23
|
|
|
23
24
|
Your sandbox is read-only: you never edit a file and never write your report to a file.
|
|
24
25
|
Your final message IS the requested shape. A dispatch that names a report path for you is
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
name = "planner"
|
|
2
|
-
description = "Read-only GPT-6 Astra design of shape, naming, ergonomics, alternatives, and bounded units. Never implements or accepts."
|
|
2
|
+
description = "Read-only GPT-6 Astra design of shape, naming, ergonomics, alternatives, and bounded units, or a consultation at a seam. Never implements or accepts."
|
|
3
3
|
model = "gpt-6-astra"
|
|
4
4
|
model_reasoning_effort = "high"
|
|
5
5
|
sandbox_mode = "read-only"
|
|
6
6
|
developer_instructions = """
|
|
7
|
-
Design one dispatched unit
|
|
7
|
+
Design one dispatched unit or give a read-only consultation under .agents/orchestration.md
|
|
8
|
+
§ Sessions and consultation on GPT-6 Astra. Use read-only inspection commands. Never edit,
|
|
8
9
|
run a mutating command, or spawn.
|
|
9
10
|
|
|
10
11
|
Read the brief, AGENTS.md, the rules whose paths match the subject, the named skill, the guide,
|
|
@@ -12,13 +13,15 @@ and the supplied distillate. Work from the brief alone; never look for or reconc
|
|
|
12
13
|
lane's answer. Hold the lane the dispatch names and say which: subjective (shape, naming,
|
|
13
14
|
ergonomics, design fit) or objective (correctness, constraints, what the contracts permit).
|
|
14
15
|
|
|
15
|
-
|
|
16
|
+
For a consultation, follow .agents/orchestration.md § Sessions and consultation.
|
|
17
|
+
For a design, propose one design. Name each real alternative that a constraint favors and why the design
|
|
16
18
|
wins; leave out an option nothing favors. Cut every unit to a fully specified brief; name its
|
|
17
19
|
role and engine, owned files, dependencies, and acceptance criteria. Name every judgment call
|
|
18
20
|
under Tensions for the other lane or the Orchestrator to rule.
|
|
19
21
|
|
|
20
|
-
|
|
22
|
+
For a consultation, use the return shape in .agents/orchestration.md § Sessions and consultation.
|
|
23
|
+
For a design, return Design, Alternatives, Constraints (each with file:line), Refusals (options a rule
|
|
21
24
|
forecloses, rule quoted), Measurements (readings supplied and readings missing), Units, Tensions,
|
|
22
25
|
Risks. Fill the sections your lane owns; leave the others empty rather than renaming them.
|
|
23
|
-
A dispatch-named skill that fixes another shape wins.
|
|
26
|
+
A dispatch-named skill that fixes another shape wins. Return the proposal or consultation in your final message.
|
|
24
27
|
"""
|
|
@@ -11,10 +11,11 @@ Read the claims file, the actual diff and git status --porcelain the dispatch su
|
|
|
11
11
|
AGENTS.md, the rules whose paths match the changed files, the guide, and enough surrounding
|
|
12
12
|
source to judge. The diff and git status are required only for a code subject; return a deviation if that diff is missing.
|
|
13
13
|
|
|
14
|
-
Hold the lane the dispatch names and say which. Subjective: requested shape and voice
|
|
15
|
-
names and boundaries, the right layer, each concept
|
|
16
|
-
correctness under adverse orderings, what
|
|
17
|
-
dependency and range truth,
|
|
14
|
+
Hold the lane the dispatch names and say which. Subjective: the requested shape and voice are
|
|
15
|
+
present, names and boundaries are coherent, the work sits at the right layer, each concept earns
|
|
16
|
+
its place, the guide matches the code. Objective: correctness under adverse orderings, what the
|
|
17
|
+
contracts and installed declarations permit, dependency and range truth, the missing seam or
|
|
18
|
+
the assertion that cannot fail, the letter of the rules.
|
|
18
19
|
|
|
19
20
|
Try to falsify each claim with a concrete input, state, or interleaving. Before confirming a
|
|
20
21
|
proof, name the mutation that would make it fail and whether its assertions distinguish it. Rule a
|
|
@@ -32,39 +32,39 @@ Construction is a strict JavaScript boundary. `validateAbortOptions` normalizes
|
|
|
32
32
|
|
|
33
33
|
### Factories
|
|
34
34
|
|
|
35
|
-
|
|
|
36
|
-
| ------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
37
|
-
| `createAbort` | function | Creates a cancellation handle from validated options and returns it as an `AbortInterface` — a resolved trace `id` and a `signal` already linked to any parent given, so a caller holds the published contract rather than the `Abort` class. |
|
|
35
|
+
| Name | Kind | Signature | Summary |
|
|
36
|
+
| ------------- | -------- | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
37
|
+
| `createAbort` | function | `(options?: AbortOptions) => AbortInterface` | Creates a cancellation handle from validated options and returns it as an `AbortInterface` — a resolved trace `id` and a `signal` already linked to any parent given, so a caller holds the published contract rather than the `Abort` class. |
|
|
38
38
|
|
|
39
39
|
### Helpers
|
|
40
40
|
|
|
41
|
-
|
|
|
42
|
-
| ---------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
|
|
43
|
-
| `validateAbortOptions` | function | Validates once-read abort construction options and returns a fresh normalized copy omitting absent optional keys. |
|
|
44
|
-
| `linkSignal` | function | Links an own `AbortSignal` to an optional parent signal, returning `AbortSignal.any([own, parent])` when a parent is given. |
|
|
41
|
+
| Name | Kind | Signature | Summary |
|
|
42
|
+
| ---------------------- | -------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
|
|
43
|
+
| `validateAbortOptions` | function | `(options?: AbortOptions) => AbortOptions` | Validates once-read abort construction options and returns a fresh normalized copy omitting absent optional keys. |
|
|
44
|
+
| `linkSignal` | function | `(own: AbortSignal, parent: AbortSignal \| undefined) => AbortSignal` | Links an own `AbortSignal` to an optional parent signal, returning `AbortSignal.any([own, parent])` when a parent is given. |
|
|
45
45
|
|
|
46
46
|
### Validators
|
|
47
47
|
|
|
48
48
|
In a guard table a `Shape` cell holds the type the guard narrows to.
|
|
49
49
|
|
|
50
|
-
|
|
|
51
|
-
| --------------- | -------- |
|
|
52
|
-
| `isAbortSignal` | function | `AbortSignal` | Determines whether a value is a native `AbortSignal`, staying total for structural spoofs and for hostile or revoked proxies. |
|
|
50
|
+
| Name | Kind | Signature | Summary |
|
|
51
|
+
| --------------- | -------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
|
|
52
|
+
| `isAbortSignal` | function | `(value: unknown) => value is AbortSignal` | Determines whether a value is a native `AbortSignal`, staying total for structural spoofs and for hostile or revoked proxies. |
|
|
53
53
|
|
|
54
54
|
### Classes
|
|
55
55
|
|
|
56
|
-
|
|
|
57
|
-
| ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
58
|
-
| `Abort` | class | Implements `AbortInterface` over a private `AbortController` the instance owns, resolving the trace `id` at construction and exposing either that controller's own `signal` or one linked to a parent. |
|
|
56
|
+
| Name | Kind | Signature | Summary |
|
|
57
|
+
| ------- | ----- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
58
|
+
| `Abort` | class | `new (options?: AbortOptions) => AbortInterface` | Implements `AbortInterface` over a private `AbortController` the instance owns, resolving the trace `id` at construction and exposing either that controller's own `signal` or one linked to a parent. |
|
|
59
59
|
|
|
60
60
|
### Types
|
|
61
61
|
|
|
62
62
|
A `Shape` cell holds an interface's data members as bare names in braces, `?` marking an optional member and `plus` introducing its call-signature members, and a type alias's own type literal with a union's arms escaped as `\|`.
|
|
63
63
|
|
|
64
|
-
|
|
|
65
|
-
| ---------------- | --------- |
|
|
66
|
-
| `AbortOptions` | interface | `{ id?, signal? }`
|
|
67
|
-
| `AbortInterface` | interface | `{ id, signal, aborted }
|
|
64
|
+
| Name | Kind | Signature | Summary |
|
|
65
|
+
| ---------------- | --------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
66
|
+
| `AbortOptions` | interface | `{ id?, signal? }` | Represents the options for `createAbort` and `Abort` construction. |
|
|
67
|
+
| `AbortInterface` | interface | `{ id, signal, aborted, abort() }` | Represents the cancellation contract a consumer holds — a traceable `id`, the exposed `AbortSignal`, an `aborted` reading of it, and an idempotent `abort` that cancels the work bound to that signal. |
|
|
68
68
|
|
|
69
69
|
The `id`, `signal`, and `aborted` members of `AbortInterface` are `readonly` data members (Surface rows, earlier) — its call-signature method is documented under [Methods](#methods).
|
|
70
70
|
|