@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.
Files changed (108) hide show
  1. package/dist/bin/main.js +137 -15
  2. package/dist/bin/main.js.map +1 -1
  3. package/dist/host/agents/orchestration.md +5 -3
  4. package/dist/host/agents/platforms/windows.md +1 -0
  5. package/dist/host/agents/skills/orkestrel-align/references/integration.md +1 -1
  6. package/dist/host/agents/skills/orkestrel-debrief/SKILL.md +4 -4
  7. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +4 -1
  8. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +8 -2
  9. package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +1 -0
  10. package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +1 -1
  11. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -1
  12. package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +1 -0
  13. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +9 -3
  14. package/dist/host/claude/agents/analyst.md +1 -1
  15. package/dist/host/claude/agents/astra.md +2 -2
  16. package/dist/host/claude/agents/builder.md +4 -4
  17. package/dist/host/claude/agents/opus.md +3 -3
  18. package/dist/host/claude/agents/orkestrel.md +5 -7
  19. package/dist/host/claude/agents/planner.md +8 -2
  20. package/dist/host/claude/rules/campaign.md +2 -1
  21. package/dist/host/claude/rules/documentation.md +1 -0
  22. package/dist/host/claude/rules/names.md +3 -1
  23. package/dist/host/claude/rules/tests.md +7 -4
  24. package/dist/host/claude/rules/writing.md +1 -0
  25. package/dist/host/claude/skills/enterprise-bootstrap/SKILL.md +1 -2
  26. package/dist/host/claude/skills/orkestrel-align/SKILL.md +1 -1
  27. package/dist/host/claude/skills/orkestrel-build/SKILL.md +1 -2
  28. package/dist/host/claude/skills/orkestrel-debrief/SKILL.md +1 -2
  29. package/dist/host/claude/skills/orkestrel-dispatch/SKILL.md +1 -1
  30. package/dist/host/claude/skills/orkestrel-falsify/SKILL.md +1 -1
  31. package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
  32. package/dist/host/claude/skills/orkestrel-journey/SKILL.md +1 -1
  33. package/dist/host/claude/skills/orkestrel-parallel/SKILL.md +1 -1
  34. package/dist/host/claude/skills/orkestrel-polish/SKILL.md +1 -2
  35. package/dist/host/claude/skills/orkestrel-publish/SKILL.md +1 -2
  36. package/dist/host/claude/skills/orkestrel-scout/SKILL.md +1 -1
  37. package/dist/host/codex/agents/analyst.toml +8 -5
  38. package/dist/host/codex/agents/astra.toml +4 -5
  39. package/dist/host/codex/agents/builder.toml +5 -5
  40. package/dist/host/codex/agents/opus.toml +3 -4
  41. package/dist/host/codex/agents/orkestrel.toml +2 -1
  42. package/dist/host/codex/agents/planner.toml +8 -5
  43. package/dist/host/codex/agents/reviewer.toml +5 -4
  44. package/dist/host/guides/abort.md +17 -17
  45. package/dist/host/guides/agent.md +445 -445
  46. package/dist/host/guides/brief.md +143 -143
  47. package/dist/host/guides/browser.md +731 -731
  48. package/dist/host/guides/budget.md +39 -39
  49. package/dist/host/guides/capture.md +298 -298
  50. package/dist/host/guides/console.md +109 -109
  51. package/dist/host/guides/contract.md +335 -335
  52. package/dist/host/guides/csv.md +30 -30
  53. package/dist/host/guides/database.md +163 -163
  54. package/dist/host/guides/emitter.md +17 -17
  55. package/dist/host/guides/form.md +99 -99
  56. package/dist/host/guides/guide.md +361 -183
  57. package/dist/host/guides/html.md +49 -49
  58. package/dist/host/guides/indexeddb.md +40 -40
  59. package/dist/host/guides/interpret.md +139 -139
  60. package/dist/host/guides/lsp.md +114 -114
  61. package/dist/host/guides/markdown.md +68 -68
  62. package/dist/host/guides/mcp.md +3745 -3745
  63. package/dist/host/guides/middleware.md +170 -170
  64. package/dist/host/guides/msg.md +95 -95
  65. package/dist/host/guides/ndjson.md +8 -8
  66. package/dist/host/guides/ollama.md +56 -56
  67. package/dist/host/guides/pool.md +21 -21
  68. package/dist/host/guides/probe.md +82 -82
  69. package/dist/host/guides/process.md +99 -99
  70. package/dist/host/guides/program.md +98 -96
  71. package/dist/host/guides/qualifier.md +70 -70
  72. package/dist/host/guides/queue.md +37 -37
  73. package/dist/host/guides/rater.md +38 -38
  74. package/dist/host/guides/reason.md +308 -308
  75. package/dist/host/guides/relation.md +50 -50
  76. package/dist/host/guides/router.md +58 -58
  77. package/dist/host/guides/scaffold.md +554 -419
  78. package/dist/host/guides/sea.md +128 -128
  79. package/dist/host/guides/server.md +100 -100
  80. package/dist/host/guides/sqlite.md +28 -28
  81. package/dist/host/guides/sse.md +20 -20
  82. package/dist/host/guides/study.md +444 -444
  83. package/dist/host/guides/table.md +82 -82
  84. package/dist/host/guides/template.md +41 -41
  85. package/dist/host/guides/terminal.md +121 -121
  86. package/dist/host/guides/test.md +273 -273
  87. package/dist/host/guides/timeout.md +18 -18
  88. package/dist/host/guides/tool.md +27 -27
  89. package/dist/host/guides/toolbox.md +166 -166
  90. package/dist/host/guides/websocket.md +54 -54
  91. package/dist/host/guides/worker.md +24 -24
  92. package/dist/host/guides/workflow.md +187 -187
  93. package/dist/host/guides/workspace.md +55 -55
  94. package/dist/host/manifest.json +93 -93
  95. package/dist/host/tests/setupPolicy.ts +5 -3
  96. package/dist/src/core/index.cjs +89 -3
  97. package/dist/src/core/index.cjs.map +1 -1
  98. package/dist/src/core/index.d.cts +229 -144
  99. package/dist/src/core/index.d.ts +229 -144
  100. package/dist/src/core/index.js +87 -4
  101. package/dist/src/core/index.js.map +1 -1
  102. package/dist/src/server/index.cjs +292 -66
  103. package/dist/src/server/index.cjs.map +1 -1
  104. package/dist/src/server/index.d.cts +188 -6
  105. package/dist/src/server/index.d.ts +188 -6
  106. package/dist/src/server/index.js +287 -69
  107. package/dist/src/server/index.js.map +1 -1
  108. 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 as the sole writer in its checkout."
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
- Write only the owned files; return an exact patch for a shared file. Validate read-only and scoped:
15
- the touched project's check: script, the touched test file, then the touched project. Never run
16
- format, lint --fix, build, or the whole suite. Leave no probe behind, per
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; writes only owned files as the sole writer in its checkout and validates scoped to them."
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
- Write only the owned files; return an exact patch for a shared file. Follow AGENTS.md § Work loop
11
- at the size the brief names: edit, prove or test the claim, run the touched test file, then the
12
- touched project when the brief names it. Validate read-only and scoped: a non-fix lint on your paths, the
13
- scoped check: script, the touched tests; never run format, lint --fix, build, or the whole suite. Leave no probe behind, per .claude/rules/tests.md § Probes.
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. Writes owned files, proves claims, and validates scoped. Never accepts its own work."
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
- Write only the owned files; return an exact patch for a shared file. Validate read-only and
15
- scoped: the touched project's check: script, the touched test file, then the touched project.
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. The embedded catalog is discovery data, never live state.
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 on GPT-6 Astra. Use read-only inspection commands. Never edit,
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
- Propose one design. Name each real alternative that a constraint favors and why the design
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
- Return Design, Alternatives, Constraints (each with file:line), Refusals (options a rule
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. Your final message is the proposal.
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, coherent
15
- names and boundaries, the right layer, each concept's purpose, guide parity. Objective:
16
- correctness under adverse orderings, what contracts and installed declarations permit,
17
- dependency and range truth, test sufficiency, and the letter of the rules.
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
- | API | Kind | Summary |
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
- | API | Kind | Summary |
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
- | API | Kind | Shape | Summary |
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
- | API | Kind | Summary |
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
- | Type | Kind | Shape | Summary |
65
- | ---------------- | --------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
66
- | `AbortOptions` | interface | `{ id?, signal? }` | Represents the options for `createAbort` and `Abort` construction. |
67
- | `AbortInterface` | interface | `{ id, signal, aborted } plus 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. |
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