@orkestrel/scaffold 0.0.124 → 0.0.125

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 (46) hide show
  1. package/dist/agents/skills/orkestrel-publish/scripts/steps.js +523 -0
  2. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +70 -11
  3. package/dist/bin/main.js +5 -5
  4. package/dist/bin/main.js.map +1 -1
  5. package/dist/host/agents/orchestration.md +5 -1
  6. package/dist/host/agents/platforms/windows.md +9 -1
  7. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +1 -1
  8. package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +1 -0
  9. package/dist/host/agents/skills/orkestrel-harden/references/methods.md +30 -2
  10. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -0
  11. package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +5 -1
  12. package/dist/host/agents/skills/orkestrel-publish/SKILL.md +1 -0
  13. package/dist/host/agents/skills/orkestrel-publish/references/release.md +2 -2
  14. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +23 -6
  15. package/dist/host/agents/skills/orkestrel-publish/scripts/steps.ts +654 -0
  16. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +79 -14
  17. package/dist/host/claude/agents/orkestrel.md +21 -21
  18. package/dist/host/claude/rules/patterns.md +1 -1
  19. package/dist/host/claude/rules/portability.md +2 -0
  20. package/dist/host/claude/rules/quality.md +3 -1
  21. package/dist/host/claude/rules/tests.md +3 -1
  22. package/dist/host/guides/agent.md +349 -244
  23. package/dist/host/guides/brief.md +52 -48
  24. package/dist/host/guides/browser.md +2 -2
  25. package/dist/host/guides/interpret.md +531 -155
  26. package/dist/host/guides/mcp.md +183 -61
  27. package/dist/host/guides/ollama.md +123 -66
  28. package/dist/host/guides/program.md +117 -39
  29. package/dist/host/guides/qualifier.md +110 -59
  30. package/dist/host/guides/rater.md +85 -32
  31. package/dist/host/guides/scaffold.md +13 -5
  32. package/dist/host/guides/study.md +580 -483
  33. package/dist/host/guides/toolbox.md +159 -80
  34. package/dist/host/guides/workflow.md +44 -25
  35. package/dist/host/manifest.json +36 -30
  36. package/dist/src/core/index.cjs +4 -4
  37. package/dist/src/core/index.cjs.map +1 -1
  38. package/dist/src/core/index.js +4 -4
  39. package/dist/src/core/index.js.map +1 -1
  40. package/dist/src/server/index.cjs +23 -11
  41. package/dist/src/server/index.cjs.map +1 -1
  42. package/dist/src/server/index.d.cts +10 -6
  43. package/dist/src/server/index.d.ts +10 -6
  44. package/dist/src/server/index.js +23 -11
  45. package/dist/src/server/index.js.map +1 -1
  46. package/package.json +4 -4
@@ -72,7 +72,7 @@ Why this is safe: the definition is the single source of truth. `execute` builds
72
72
 
73
73
  | Name | Kind | Signature | Summary |
74
74
  | ----------------------------- | -------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
75
- | `createWorkflowContract` | function | `() => ContractInterface<WorkflowDefinition>` | Compiles the workflow definition contract — the JSON Schema, guard, parser, and seeded generator for a `WorkflowDefinition`, all derived from one shape and kept in lockstep. |
75
+ | `createWorkflowContract` | function | `() => ContractInterface<WorkflowDefinition>` | Returns the compiled workflow definition contract — the JSON Schema, guard, parser, and seeded generator for a `WorkflowDefinition`, all derived from one shape and kept in lockstep. |
76
76
  | `createWorkflow` | function | `(definition: WorkflowDefinition, options?: WorkflowOptions) => WorkflowInterface` | Builds the live W-b entity tree from a `WorkflowDefinition` — the whole `WorkflowInterface` → `PhaseInterface` → `TaskInterface` tree, each level wired with its lineage context, its emitter, and the cascade, and every node born `pending`. |
77
77
  | `createWorkflowTree` | function | `(definition: WorkflowDefinition, captured: WorkflowOptions) => WorkflowInterface` | Builds the live entity tree one definition and one owned options bag describe — the shared construction path behind every definition-driven mint. |
78
78
  | `createRestoredWorkflow` | function | `(snapshot: unknown, options?: WorkflowOptions) => WorkflowInterface` | Builds an equivalent live W-b entity tree from a `WorkflowSnapshot` — the inverse of `WorkflowInterface.snapshot`, restoring structure + each node's status + recorded results + positional order + the persisted `#override`. |
@@ -101,23 +101,22 @@ A phase and a task are minted by their parent and reached as `PhaseInterface` an
101
101
 
102
102
  Every tier declares `description` as a required `string | undefined` member backed by a getter, so `'description' in entity` reports `true` whatever the definition declared and a reader takes absence from the value. The pure-JSON snapshot still omits the key when no prose was declared.
103
103
 
104
- | Name | Kind | Signature | Summary |
105
- | -------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
106
- | `Workflow` | class | `new (snapshot: WorkflowSnapshot, options?: WorkflowOptions) => WorkflowInterface` | Implements the live derived state machine (W-b) for a whole workflow — the observable root whose `LifecycleStatus` is computed from its phases under the `bail` policy and recomputed reactively as the cascade propagates up from a task transition. |
107
- | `PhaseManager` | class | `new () => PhaseManagerInterface` | Implements the lean child manager of a `Workflow`'s live phases — the phase vocabulary over one insertion-ordered `Collection`, the phase analogue of `TaskManager`. |
108
- | `TaskManager` | class | `new () => TaskManagerInterface` | Implements the lean child manager of a `Phase`'s live tasks — the task vocabulary over one insertion-ordered `Collection`, so positional order is preserved across an interior `skip` / `remove`. |
109
- | `Collection` | class | `new <TEntry extends CollectionEntry<TPatch>, TPatch>(noun: string, patch: Guard<TPatch>) => CollectionInterface<TEntry, TPatch>` | Implements the insertion-ordered gated store both lean managers hold — entities keyed by `id`, positional order preserved across an interior `skip` or `remove`. |
104
+ | Name | Kind | Signature | Summary |
105
+ | -------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
106
+ | `Workflow` | class | `new (snapshot: unknown, options?: WorkflowOptions) => WorkflowInterface` | Implements the live derived state machine (W-b) for a whole workflow — the observable root whose `LifecycleStatus` is computed from its phases under the `bail` policy and recomputed reactively as the cascade propagates up from a task transition. |
107
+ | `PhaseManager` | class | `new () => PhaseManagerInterface` | Implements the lean child manager of a `Workflow`'s live phases — the phase vocabulary over one insertion-ordered `Collection`, the phase analogue of `TaskManager`. |
108
+ | `TaskManager` | class | `new () => TaskManagerInterface` | Implements the lean child manager of a `Phase`'s live tasks — the task vocabulary over one insertion-ordered `Collection`, so positional order is preserved across an interior `skip` / `remove`. |
109
+ | `Collection` | class | `new <TEntry extends CollectionEntry<TPatch>, TPatch>(noun: string, patch: ContractInterface<TPatch>) => CollectionInterface<TEntry, TPatch>` | Implements the insertion-ordered gated store both lean managers hold — entities keyed by `id`, positional order preserved across an interior `skip` or `remove`. |
110
110
 
111
111
  ### The positional collection
112
112
 
113
113
  `PhaseManager` and `TaskManager` differ only in the entity noun their refusals name and the patch shape they validate, so both hold one `Collection` and add nothing but their domain accessors (`phase` / `phases`, `task` / `tasks`). The store keys entities by `id` in a `Map` whose insertion order is the single source of positional truth, so order survives an interior `skip` (a status change, never a removal) and a snapshot restore reproduces it by re-`append`ing in order. `append` is the build-time wiring path and throws a `MUTATION` `WorkflowError` on a duplicate id; `add` / `remove` / `move` / `update` are its graceful `Result` counterparts, gating only on the target's own existence, `pending` status, id, and bounds. Build one over any entity carrying `id`, `status`, and `patch` — the `CollectionEntry` contract both live entities satisfy:
114
114
 
115
115
  ```ts
116
- import { compileGuard } from '@orkestrel/contract'
117
- import { Collection, taskUpdateShape } from '@orkestrel/workflow'
116
+ import { Collection, taskUpdateContract } from '@orkestrel/workflow'
118
117
  import type { TaskInterface, TaskUpdate } from '@orkestrel/workflow'
119
118
 
120
- const store = new Collection<TaskInterface, TaskUpdate>('task', compileGuard(taskUpdateShape))
119
+ const store = new Collection<TaskInterface, TaskUpdate>('task', taskUpdateContract)
121
120
  store.append(first) // the build-time wiring path
122
121
  store.add(second, 0) // a Result boxing `second`, inserted before `first`
123
122
  store.move(second.id, 1) // a Result — repositioned back to the end
@@ -248,6 +247,15 @@ that renders a thrown value as a failure message, also come from `@orkestrel/con
248
247
  | `isWorkflowSnapshot` | function | `(value: unknown) => value is WorkflowSnapshot` | Guards the hostile boundary totally for a workflow snapshot. |
249
248
  | `isOwnedWorkflowSnapshot` | function | `(value: unknown) => value is WorkflowSnapshot` | Validates a safe owned JSON graph as a coherent workflow snapshot. |
250
249
  | `isLifecycleStatus` | function | `(value: unknown) => value is LifecycleStatus` | Checks whether an unknown value belongs to the workflow lifecycle vocabulary. |
250
+ | `isTimerBound` | function | `(value: unknown) => value is number` | Checks whether a value is a usable timer bound, an integer from `1` through `MAX_TIMER_MS`. |
251
+ | `requireTimerBound` | function | `(value: unknown, label: string) => number` | Returns a timer bound, or refuses a value the host timer cannot arm as one. |
252
+ | `requireConcurrency` | function | `(value: unknown, phase: string) => number` | Returns a phase concurrency, or refuses a value that is not a positive safe integer. |
253
+ | `requireRunnable` | function | `(workflow: WorkflowInterface, ms: number \| undefined) => void` | Refuses a run that cannot start, before anything claims the tree. |
254
+ | `admitPatch` | function | `<T>(contract: ContractInterface<T>, value: unknown, noun: string, id: string) => Result<T, WorkflowError>` | Admits a patch through its contract with no repair, or refuses it with the faults that name why. |
255
+ | `scanDuplicateIds` | function | `(phases: readonly PhaseDefinition[]) => WorkflowError \| undefined` | Finds the first id a list of phase definitions repeats, among the phases or within one phase's tasks, which a schema cannot say. |
256
+ | `scanSchemaNode` | function | `(schema: JSONSchema, path: readonly string[]) => JSONSchema \| undefined` | Walks a schema to the node a path names, through object properties and array items. |
257
+ | `describeWorkflowFaults` | function | `(subject: string, schema: JSONSchema, faults: readonly AuditFault[]) => string` | Renders the refusal a reader corrects a workflow definition or patch from, one line per fault, within `WORKFLOW_REFUSAL_LIMIT`. |
258
+ | `admitDefinition` | function | `<T>(contract: ContractInterface<T>, value: unknown, code: WorkflowErrorCode, subject: string) => Result<T, WorkflowError>` | Admits a definition through its contract, or refuses it with the faults that name why. |
251
259
  | `isTaskFailure` | function | `(value: unknown) => value is TaskFailure` | Tests a normalized persisted task failure. |
252
260
  | `isTaskResult` | function | `(value: unknown, workflow: unknown, phase: unknown, task: unknown) => value is TaskResult` | Tests a result's lineage against its containing snapshot nodes. |
253
261
  | `matchesDescription` | function | `(left: unknown, right: unknown) => boolean` | Compares two optional description values. |
@@ -258,7 +266,7 @@ that renders a thrown value as a failure message, also come from `@orkestrel/con
258
266
  | `deriveWorkflowStatus` | function | `(phases: readonly PhaseDerivation[]) => LifecycleStatus` | Derives a workflow's status from its phases' `PhaseDerivation`s — each phase's status paired with the effective `bail` it ran under (`phase.bail ?? workflow.bail`) — so the failure outcome is aware of each phase's own policy, and `failed` is reachable only where that policy is `true` (phases are sequential, but the derivation is an order-insensitive reduction over the settled set). |
259
267
  | `deriveBoundary` | function | `(statuses: readonly LifecycleStatus[]) => number` | Derives the pending-suffix boundary of a positional list of `LifecycleStatus`es — the index of the first entry in the contiguous trailing run of `pending` entries, or the list's length where it has none. |
260
268
  | `canTransitionTask` | function | `(from: LifecycleStatus, to: LifecycleStatus) => boolean` | Tests whether the live W-b task state machine may move directly from one `LifecycleStatus` to another — the legal-transition guard. |
261
- | `resolveTaskSilence` | function | `(value: number \| undefined, fallback: number \| undefined) => number \| undefined` | Resolves a task's runtime silence window against its workflow default, to a host-safe `1..MAX_TIMER_MS` window or to `undefined` where the task disables it. |
269
+ | `resolveTaskSilence` | function | `(value: number \| undefined, fallback: number \| undefined) => number \| undefined` | Resolves a task's runtime silence window against its workflow default, or refuses one outside `1..MAX_TIMER_MS`. |
262
270
  | `cloneTaskActivity` | function | `(input: unknown, updated?: number) => TaskActivity` | Validates and clones one complete task activity frame. |
263
271
  | `cloneTaskProgress` | function | `(input: unknown) => unknown` | Copies a supplied task progress frame after checking its own keys and prototype. |
264
272
  | `isTaskActivityInput` | function | `(value: unknown) => value is TaskActivityInput` | Tests whether an unknown value is a valid whole-frame activity report. |
@@ -351,25 +359,31 @@ if (isTaskActivityInput(input)) {
351
359
  const activity = cloneTaskActivity(input, Date.now())
352
360
  isTaskActivity(activity) // true
353
361
  }
354
- resolveTaskSilence(0, 30_000) // undefined: the task explicitly disables inheritance
362
+ resolveTaskSilence(undefined, 30_000) // 30000: the task inherits the workflow default
355
363
  ```
356
364
 
357
365
  ### Shapes
358
366
 
359
367
  `createWorkflowContract` derives its lockstep JSON Schema, guard, parser, and generator from these shape values. They agree with the hand-written definition interfaces (the source of truth); a round-trip parity test (`generate → is → parse`) guards against drift.
360
368
 
361
- | Name | Kind | Signature | Summary |
362
- | --------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
363
- | `taskDefinitionShape` | const | `import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; behavior: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; retries: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; timeout: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; }, false>` | Describes the shape of a `TaskDefinition` — identity plus an optional `behavior` behavior reference (a plain registry-key string, min length 1). `description` is optional prose. |
364
- | `phaseShape` | const | `import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; tasks: import("@orkestrel/contract").ArrayShape<import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; behavior: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; retries: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; timeout: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; }, false>>; concurrency: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; bail: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").LiteralShape<readonly [true, false]>>; }, false>` | Describes the shape of a `PhaseDefinition` — identity, its ordered `taskDefinitionShape` tasks, and an optional positive-integer `concurrency` throttle (max tasks in flight; omitted ⇒ unbounded). |
365
- | `workflowShape` | const | `import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; phases: import("@orkestrel/contract").ArrayShape<import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; tasks: import("@orkestrel/contract").ArrayShape<import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; behavior: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; retries: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; timeout: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; }, false>>; concurrency: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; bail: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").LiteralShape<readonly [true, false]>>; }, false>>; bail: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").LiteralShape<readonly [true, false]>>; }, false>` | Describes the shape of a `WorkflowDefinition` — the contract root: identity, its ordered `phaseShape` phases, and the optional `bail` boolean failure policy (the literal pair `true`/`false`, the runtime mirror of the boolean toggle; omitted ⇒ the graceful default). |
366
- | `taskUpdateShape` | const | `import("@orkestrel/contract").ObjectShape<{ name: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; }, false>` | Describes the shape of a `TaskUpdate` — a partial edit to a `pending` task's `name` / `description`, both optional. |
367
- | `phaseUpdateShape` | const | `import("@orkestrel/contract").ObjectShape<{ name: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; concurrency: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; bail: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").LiteralShape<readonly [true, false]>>; }, false>` | Describes the shape of a `PhaseUpdate` — a partial edit to a `pending` phase's `name` / `description` / `concurrency` / `bail`, all optional. |
369
+ | Name | Kind | Signature | Summary |
370
+ | ------------------------ | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
371
+ | `workflowContract` | const | `ContractInterface<WorkflowDefinition>` | Holds the compiled `WorkflowDefinition` contract every definition-driven mint enters through. |
372
+ | `phaseContract` | const | `ContractInterface<PhaseDefinition>` | Holds the compiled `PhaseDefinition` contract a live `add` on a workflow enters through. |
373
+ | `taskDefinitionContract` | const | `ContractInterface<TaskDefinition>` | Holds the compiled `TaskDefinition` contract a live `add` on a phase enters through. |
374
+ | `taskUpdateContract` | const | `ContractInterface<TaskUpdate>` | Holds the compiled `TaskUpdate` contract a task manager's `update` validates a patch with. |
375
+ | `phaseUpdateContract` | const | `ContractInterface<PhaseUpdate>` | Holds the compiled `PhaseUpdate` contract a phase manager's `update` validates a patch with. |
376
+ | `taskDefinitionShape` | const | `import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; behavior: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; retries: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; timeout: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; }, false>` | Describes the shape of a `TaskDefinition` — identity plus an optional `behavior` behavior reference (a plain registry-key string, min length 1). `description` is optional prose. |
377
+ | `phaseShape` | const | `import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; tasks: import("@orkestrel/contract").ArrayShape<import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; behavior: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; retries: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; timeout: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; }, false>>; concurrency: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; bail: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").LiteralShape<readonly [true, false]>>; }, false>` | Describes the shape of a `PhaseDefinition` — identity, its ordered `taskDefinitionShape` tasks, and an optional positive safe integer `concurrency` throttle (max tasks in flight; omitted ⇒ unbounded). |
378
+ | `workflowShape` | const | `import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; phases: import("@orkestrel/contract").ArrayShape<import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; tasks: import("@orkestrel/contract").ArrayShape<import("@orkestrel/contract").ObjectShape<{ id: import("@orkestrel/contract").StringShape; name: import("@orkestrel/contract").StringShape; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; behavior: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; retries: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; timeout: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; }, false>>; concurrency: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; bail: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").LiteralShape<readonly [true, false]>>; }, false>>; bail: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").LiteralShape<readonly [true, false]>>; }, false>` | Describes the shape of a `WorkflowDefinition` — the contract root: identity, its ordered `phaseShape` phases, and the optional `bail` boolean failure policy (the literal pair `true`/`false`, the runtime mirror of the boolean toggle; omitted ⇒ the graceful default). |
379
+ | `taskUpdateShape` | const | `import("@orkestrel/contract").ObjectShape<{ name: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; }, false>` | Describes the shape of a `TaskUpdate` — a partial edit to a `pending` task's `name` / `description`, both optional. |
380
+ | `phaseUpdateShape` | const | `import("@orkestrel/contract").ObjectShape<{ name: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; description: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").StringShape>; concurrency: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").NumberShape>; bail: import("@orkestrel/contract").OptionalShape<import("@orkestrel/contract").LiteralShape<readonly [true, false]>>; }, false>` | Describes the shape of a `PhaseUpdate` — a partial edit to a `pending` phase's `name` / `description` / `concurrency` / `bail`, all optional. |
368
381
 
369
382
  ### Constants
370
383
 
371
384
  | Name | Kind | Signature | Summary |
372
385
  | --------------------------- | ----- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
386
+ | `WORKFLOW_REFUSAL_LIMIT` | const | `2048` | Caps at `2048` the characters of a refusal that lists faults, because that text can reach a model through a tool. The whole report stays in `context.faults`. |
373
387
  | `DEFAULT_BAIL` | const | `false` | Names the default `WorkflowDefinition.bail`, `false` — the graceful policy that records a leaf failure and finishes every phase. |
374
388
  | `LIFECYCLE_STATUSES` | const | `readonly LifecycleStatus[]` | Lists every `LifecycleStatus` value, frozen — the vocabulary every tier draws from, in the order `pending`, `running`, `completed`, `failed`, `skipped`, `stopped`. |
375
389
  | `TERMINAL_STATUSES` | const | `readonly LifecycleStatus[]` | Lists the terminal `LifecycleStatus` values, frozen — `completed`, `failed`, `skipped`, and `stopped`, each a state a node never transitions out of. |
@@ -874,6 +888,10 @@ result.workflow.results() // every settled task's TaskResult, lineage-navigable
874
888
 
875
889
  `execute` is single-source — it builds the live tree from `definition` itself and returns it in `result.workflow`. Each task's `behavior` string is resolved once at construction against `options.functions`; an omitted `behavior` completes as a JSON `null` no-op, while a present but absent registry name is rejected before execution.
876
890
 
891
+ A run refuses what it cannot do before any task starts, and the promise rejects with a `SCHEDULE` `WorkflowError`. The definition door refuses a key the contract does not declare, so a misspelt `behaviour` reports an `extra` fault at `phases.0.tasks.0.behaviour` in `context.faults` instead of running a no-op. A tree with no task refuses too: `createWorkflow({ id: 'w', name: 'W', phases: [] })` still builds so a caller can `add` to it, and a refused live workflow stays unclaimed, so a corrected call can drive the same object. The same door guards `createWorkflow` and `WorkflowManager.add`, which throw, and a live `add`, which returns a `MUTATION` failure. One refusal lists every fault and every undeclared key, and a definition whose reads change refuses as unreadable.
892
+
893
+ The door repairs a leaf the way `parse` does, so a definition's `timeout: '5'` enters as `5`. A run option is not a definition and gets no repair, so `execute(definition, { timeout: '5' })` refuses the same value.
894
+
877
895
  ### The `bail` policy — graceful vs halt
878
896
 
879
897
  The following runs contrast graceful settlement with fail-fast handling.
@@ -913,7 +931,7 @@ const definition: WorkflowDefinition = {
913
931
  }
914
932
  ```
915
933
 
916
- A task may declare per-task reliability — extra attempts on failure and a workflow-owned per-attempt deadline. Both persist in `TaskSnapshot`; `timeout` must be an integer in `0..MAX_TIMER_MS`, where `0` disables the deadline:
934
+ A task may declare per-task reliability — extra attempts on failure and a workflow-owned per-attempt deadline. Both persist in `TaskSnapshot`; `timeout` must be an integer in `1..MAX_TIMER_MS`, and omitting it is the only way to run with no deadline:
917
935
 
918
936
  ```ts
919
937
  const task: TaskDefinition = {
@@ -938,7 +956,7 @@ import { createBudget } from '@orkestrel/budget'
938
956
  const abort = createAbort()
939
957
  const result = await runner.execute(definition, {
940
958
  signal: abort.signal, // an external cancellation
941
- timeout: 10_000, // non-positive, non-finite, or over MAX_TIMER_MS means no deadline
959
+ timeout: 10_000, // an integer in 1..MAX_TIMER_MS; omit it for no deadline, anything else rejects SCHEDULE
942
960
  budget: createBudget({ max: 50_000, consume: (usage) => usage.total }), // a cost ceiling
943
961
  })
944
962
  // A fire of any bound folds through AbortSignal.any: it cancels every in-flight task, skips the rest,
@@ -1063,10 +1081,10 @@ if (added.success) {
1063
1081
  }
1064
1082
 
1065
1083
  // A direct entity `patch` is the defense-in-depth self-check the manager's `update` delegates to.
1066
- phase.patch({ concurrency: 2 }) // throws MUTATION unless this phase is `pending`
1084
+ phase.patch({ concurrency: 2 }) // throws MUTATION unless this phase is `pending` and the patch is exact
1067
1085
  ```
1068
1086
 
1069
- Every one of these is refused gracefully (a `MUTATION` `Result` failure, never a throw) when the container is terminal / `destroyed`, the target does not exist or is not `pending`, or the position falls outside the pending suffix; a `running` phase accepts an `add` only as a pure append — a live runner subscribed to that phase's own `add` event picks the new task up for same-run execution.
1087
+ Every one of these is refused gracefully (a `MUTATION` `Result` failure, never a throw) when a definition or a patch fails its contract or a patch is empty, each with `context.faults` listing every fault, when the container is terminal / `destroyed`, the target does not exist or is not `pending`, or the position falls outside the pending suffix; a `running` phase accepts an `add` only as a pure append — a live runner subscribed to that phase's own `add` event picks the new task up for same-run execution.
1070
1088
 
1071
1089
  ### Building the live tree by hand — `append`
1072
1090
 
@@ -1146,7 +1164,7 @@ Every accepted `report` replaces the complete frame. Omitted `note` / `progress`
1146
1164
 
1147
1165
  Activity is attempt-owned. `start` seeds the first empty frame; retry entry replaces it with another empty frame. A `TaskController` captures the runner's explicit claimed attempt and folded signal; ownership requires both the runner token and the live task's persisted attempt to match. A public or reentrant `start` therefore invalidates an older handle immediately: late `report` returns `TRANSITION`, late `pulse` returns `false`, handler settlement is ignored, and no settlement checkpoint is attributed to the stale attempt. Pending snapshots omit activity; running/completed/failed snapshots require the accepted frame; skipped/stopped snapshots may omit it or retain the last accepted reporter claim. Start, report, and pulse stamps use the greater of the host clock and the prior activity stamp, so a restored future timestamp never regresses. Restore never arms a silence timer merely because a frame was persisted.
1148
1166
 
1149
- `WorkflowOptions.silence` is the runtime default and `TaskOptions.silence` is the runtime override; neither is authored definition data nor persisted supervision config. A present value outside `1..MAX_TIMER_MS` explicitly disables inheritance. The effective task value is host-timer-safe or `undefined`, so overflow never clamps into an immediate silence event. One reusable, task-signal-parented deadline is rearmed after each accepted report or pulse. `silent` derives from that deadline's current `expired` state while the task is running and clears on the next accepted activity; repeated silence events are possible after rearming. Terminal settlement and destroy clear supervision.
1167
+ `WorkflowOptions.silence` is the runtime default and `TaskOptions.silence` is the runtime override; neither is authored definition data nor persisted supervision config. A present value outside `1..MAX_TIMER_MS` refuses with `SCHEDULE` at construction, and `0` is not a way to opt out: to leave one task unsupervised under a workflow default, give it `MAX_TIMER_MS`, or set `silence` per task with no default. The effective task value is host-timer-safe or `undefined`, so overflow never clamps into an immediate silence event. One reusable, task-signal-parented deadline is rearmed after each accepted report or pulse. `silent` derives from that deadline's current `expired` state while the task is running and clears on the next accepted activity; repeated silence events are possible after rearming. Terminal settlement and destroy clear supervision.
1150
1168
 
1151
1169
  Task pause is cooperative. `Task.wait()` parks only the task gate. `TaskController.wait()` folds the workflow, phase, and task gates, racing them against cancellation and ancestor Workflow/Phase `skip` / `stop` events; an ancestor terminal override wakes it without fabricating `resume`. No method suspends arbitrary JavaScript or an operating-system process. The queue acquires concurrency before the workflow handler gate, so a paused task can occupy one phase slot: with concurrency `1` it blocks later pending siblings, already-running siblings continue, the external handler is not invoked until resume, and the per-attempt timeout continues while the slot is held.
1152
1170
 
@@ -1156,7 +1174,7 @@ Provider-specific Claude/Cursor/Codex JSONL parsing, journals, raw-log retention
1156
1174
 
1157
1175
  ### Snapshot & restore (the durable payload)
1158
1176
 
1159
- The following workflow round-trips its durable snapshot through restore and recovery.
1177
+ The following workflow round-trips its durable snapshot through restore and recovery. Each route, `new Workflow` included, passes the exact snapshot boundary, so a key no snapshot declares refuses with `RESTORE` instead of building a task that succeeds with nothing to run.
1160
1178
 
1161
1179
  ```ts
1162
1180
  import {
@@ -1552,6 +1570,7 @@ A successful run fires `start` → `unit`/`settle` per unit → `finish`. A fail
1552
1570
  - [`tests/src/core/helpers.test.ts`](../tests/src/core/helpers.test.ts) — status/lineage/snapshot helpers, bounded silence inheritance, `createHostSchedule` setup/cancellation race arbitration with exact falsy failures, hostile caller signal methods, and throwing cancellation closures after caller abort or host failure, plus the snapshot-decode leaves: remaining-budget recovery, established strict halt boundaries, exhausted recovery failures, monotonic stamps, exact-restore separation, and hostile inputs.
1553
1571
  - [`tests/src/core/cloners.test.ts`](../tests/src/core/cloners.test.ts) — immutable activity cloning, hostile/revoked proxy containment, one-read getters, no alias retention, stamp-vs-restore `updated` handling, and exact wrong-storage-key `RESTORE` evidence.
1554
1572
  - [`tests/src/core/validators.test.ts`](../tests/src/core/validators.test.ts) — total activity, task-failure, task-result, and owned-snapshot guards over valid, malformed, cyclic, throwing-proxy/getter/ownKeys, and revoked inputs.
1573
+ - [`tests/src/core/contracts.test.ts`](../tests/src/core/contracts.test.ts) — the compiled contracts each door reads: the bounds on `timeout` and `concurrency`, and an undeclared key refused.
1555
1574
  - [`tests/src/core/shapers.test.ts`](../tests/src/core/shapers.test.ts) — the shape descriptors: the `taskDefinitionShape` / `phaseShape` / `workflowShape` mirroring the hand-written definition interfaces, the per-field `description`s riding the `behavior` string + key fields (Rank 1), `describedLiteral`.
1556
1575
  - [`tests/src/core/tasks/Task.test.ts`](../tests/src/core/tasks/Task.test.ts) — lifecycle plus whole-frame activity, validation/immutability, pulse, repeatable silence rearming, task signal, terminal cleanup, and cooperative pause.
1557
1576
  - [`tests/src/core/phases/Phase.test.ts`](../tests/src/core/phases/Phase.test.ts) — the derived middle tier: child-transition cascade, `skip` / `stop` override, results, snapshot/restore, and isolated lifecycle emission including idempotent pause/resume.
@@ -16,7 +16,7 @@
16
16
  "storage": "agents/orchestration.md",
17
17
  "destination": ".agents/orchestration.md",
18
18
  "executable": false,
19
- "digest": "6d0e054bbd6fcd07478b77208484ee1b20925895ebcbe36c72a856751603db80"
19
+ "digest": "521744de272a0d90483d955541191e3cbd77ad546c1859ff5aba90b80d54757d"
20
20
  },
21
21
  {
22
22
  "storage": "agents/platforms/posix.md",
@@ -28,7 +28,7 @@
28
28
  "storage": "agents/platforms/windows.md",
29
29
  "destination": ".agents/platforms/windows.md",
30
30
  "executable": false,
31
- "digest": "c97cc6fc884e8cb69af7799b0bab232e832f954bb98fcc4a28dbd3cac5dbe7b4"
31
+ "digest": "a0c5593da4d898339208686be0c7adc23f1faca6041c84fa54340b83c81d764f"
32
32
  },
33
33
  {
34
34
  "storage": "agents/skills/enterprise-bootstrap/SKILL.md",
@@ -160,7 +160,7 @@
160
160
  "storage": "agents/skills/orkestrel-dispatch/SKILL.md",
161
161
  "destination": ".agents/skills/orkestrel-dispatch/SKILL.md",
162
162
  "executable": false,
163
- "digest": "fef0dc031c09ea0875135f7302a4b4b41b3e8fd6c0ea170b0a8700a193ef10de"
163
+ "digest": "6f81fe2285749f5aedd16653574ebf1e8cc5dad53cf69ba136cb6ce1f893ba08"
164
164
  },
165
165
  {
166
166
  "storage": "agents/skills/orkestrel-dispatch/agents/openai.yaml",
@@ -244,7 +244,7 @@
244
244
  "storage": "agents/skills/orkestrel-falsify/references/brief.md",
245
245
  "destination": ".agents/skills/orkestrel-falsify/references/brief.md",
246
246
  "executable": false,
247
- "digest": "0e18051888e2d4e84a0a6a8db91f872a431fb177be8dec5d01c6afe254c9eee1"
247
+ "digest": "f92bfb01a5eaeafaa1308ca3942f8708dbe0166f4f5abc7c8b4df633e2252f6e"
248
248
  },
249
249
  {
250
250
  "storage": "agents/skills/orkestrel-falsify/references/reconcile.md",
@@ -310,7 +310,7 @@
310
310
  "storage": "agents/skills/orkestrel-harden/references/methods.md",
311
311
  "destination": ".agents/skills/orkestrel-harden/references/methods.md",
312
312
  "executable": false,
313
- "digest": "bea445a1028e026620d983a315866d160461f2f235302de37fda42c131a86951"
313
+ "digest": "e2812264c941cd4f75b54b49fdf7807095d2c23e7bc669d30604e4328faf48b6"
314
314
  },
315
315
  {
316
316
  "storage": "agents/skills/orkestrel-harden/references/research.md",
@@ -394,7 +394,7 @@
394
394
  "storage": "agents/skills/orkestrel-parallel/SKILL.md",
395
395
  "destination": ".agents/skills/orkestrel-parallel/SKILL.md",
396
396
  "executable": false,
397
- "digest": "acfce1cd94df7a3da032d201d2dd7534353f193cbb1792ef7a025a3f1043cf58"
397
+ "digest": "d5143cf928db202b00cdca243c090259547426700523256cc94a0d42f05e146a"
398
398
  },
399
399
  {
400
400
  "storage": "agents/skills/orkestrel-parallel/agents/openai.yaml",
@@ -430,7 +430,7 @@
430
430
  "storage": "agents/skills/orkestrel-parallel/references/t3.md",
431
431
  "destination": ".agents/skills/orkestrel-parallel/references/t3.md",
432
432
  "executable": false,
433
- "digest": "eaf10ec9384abaa18db419e96ebb09c3b79be1541d412898f08ad48b766f1442"
433
+ "digest": "52b9f7b2f6c9505feffdd599442221a030b646d6fa9a1afef0ace04db6eb8ff2"
434
434
  },
435
435
  {
436
436
  "storage": "agents/skills/orkestrel-parallel/scripts/cases.ts",
@@ -466,7 +466,7 @@
466
466
  "storage": "agents/skills/orkestrel-publish/SKILL.md",
467
467
  "destination": ".agents/skills/orkestrel-publish/SKILL.md",
468
468
  "executable": false,
469
- "digest": "d788227c0865da1fb5649ad683476c703165449a299af0b3654ec5812ffe7603"
469
+ "digest": "616df5116346a9d71accf5bfa0388674666ac396306915529c287ee8961045c8"
470
470
  },
471
471
  {
472
472
  "storage": "agents/skills/orkestrel-publish/agents/openai.yaml",
@@ -484,13 +484,13 @@
484
484
  "storage": "agents/skills/orkestrel-publish/references/release.md",
485
485
  "destination": ".agents/skills/orkestrel-publish/references/release.md",
486
486
  "executable": false,
487
- "digest": "a642fffdd6f375d65ce480409d5e3930ab7e76d3aa1acf8a0a2611c8171b93d5"
487
+ "digest": "609361eb5f11295a02defbb5f8a0f9478217faefbb056a35eeefd05801531f59"
488
488
  },
489
489
  {
490
490
  "storage": "agents/skills/orkestrel-publish/references/wave.md",
491
491
  "destination": ".agents/skills/orkestrel-publish/references/wave.md",
492
492
  "executable": false,
493
- "digest": "bcac5ade858b48414eda9f845749cb36d03df25e38ca73a8603c9223ab4c2793"
493
+ "digest": "7dae98088b423705ee15c0814cbea77e5514864f306338f598dd2014a5349381"
494
494
  },
495
495
  {
496
496
  "storage": "agents/skills/orkestrel-publish/references/window.md",
@@ -510,6 +510,12 @@
510
510
  "executable": false,
511
511
  "digest": "febc3921ec1d3f21f4b697eceed445946affb78f0617fdd0d2d24c4c0a050cbf"
512
512
  },
513
+ {
514
+ "storage": "agents/skills/orkestrel-publish/scripts/steps.ts",
515
+ "destination": ".agents/skills/orkestrel-publish/scripts/steps.ts",
516
+ "executable": false,
517
+ "digest": "50615d7a90c71be17451bea5c66b185731e7645348633a78ef0c6df604f8f9aa"
518
+ },
513
519
  {
514
520
  "storage": "agents/skills/orkestrel-publish/scripts/swap.ts",
515
521
  "destination": ".agents/skills/orkestrel-publish/scripts/swap.ts",
@@ -520,7 +526,7 @@
520
526
  "storage": "agents/skills/orkestrel-publish/scripts/wave.ts",
521
527
  "destination": ".agents/skills/orkestrel-publish/scripts/wave.ts",
522
528
  "executable": false,
523
- "digest": "44d9194ef97ea7f283f9b7f058f47b71927ada5ba9727ddbb154e96dc2a9640a"
529
+ "digest": "a7f0b902c0107ec6e3ca44034f3a92e1dead134811e80352bbe5e8f0a622b90e"
524
530
  },
525
531
  {
526
532
  "storage": "agents/skills/orkestrel-publish/scripts/window.ts",
@@ -622,7 +628,7 @@
622
628
  "storage": "claude/agents/orkestrel.md",
623
629
  "destination": ".claude/agents/orkestrel.md",
624
630
  "executable": false,
625
- "digest": "f7ea81be132d7811376e9cf54227ce83a122abe4f3aa57d55ee6ffca78a8bf35"
631
+ "digest": "97ac2fea7a537e6ff396aaaedf217ba72b0bbcdc30b27c6679f3f5f554008449"
626
632
  },
627
633
  {
628
634
  "storage": "claude/agents/planner.md",
@@ -694,19 +700,19 @@
694
700
  "storage": "claude/rules/patterns.md",
695
701
  "destination": ".claude/rules/patterns.md",
696
702
  "executable": false,
697
- "digest": "dff312736b6e9bc6a4e16fc26594076933502b2ba2fdb0bd2aaf1b5781e752e0"
703
+ "digest": "43920dca62ed88f1f117131f5830085cc709059bdb05ee98d90c807361f1d808"
698
704
  },
699
705
  {
700
706
  "storage": "claude/rules/portability.md",
701
707
  "destination": ".claude/rules/portability.md",
702
708
  "executable": false,
703
- "digest": "5ec26b95f22e2e956ea2f8982b8af603ba11da4fdae7a5709d790784404d0de7"
709
+ "digest": "850f1949f3fcd39a3c1b50b19e547acbcbc84e2f761ed5b54d7f69b1b1edb277"
704
710
  },
705
711
  {
706
712
  "storage": "claude/rules/quality.md",
707
713
  "destination": ".claude/rules/quality.md",
708
714
  "executable": false,
709
- "digest": "c69ba584a9b3a33f7e2b130e0c3f4f7a4a1e6c903610d89a594185230f2eb118"
715
+ "digest": "cc09ef3ac061daa19ed4422829199ca6ab9eedc1772406f1cc63c2b6d22b0946"
710
716
  },
711
717
  {
712
718
  "storage": "claude/rules/styles.md",
@@ -718,7 +724,7 @@
718
724
  "storage": "claude/rules/tests.md",
719
725
  "destination": ".claude/rules/tests.md",
720
726
  "executable": false,
721
- "digest": "5c8f9c463b5fba38cb5fc7a1f150e74682a5cfee05f4f68b46b191eb0f6d3ec0"
727
+ "digest": "5fda55b7acfc9291a56fd130de7076785d524d4c1a6e9edc1c451e5aec85b877"
722
728
  },
723
729
  {
724
730
  "storage": "claude/rules/typescript.md",
@@ -988,19 +994,19 @@
988
994
  "storage": "guides/agent.md",
989
995
  "destination": "guides/agent.md",
990
996
  "executable": false,
991
- "digest": "9dc2651a6644dd42cbc56d46b8be599e0a04a38f4bcbf5071e04567e6838c0ae"
997
+ "digest": "3569c17d72479a40a9eaab4dbb335bf6ba00a4540ad637fa2929e873ae3bdd82"
992
998
  },
993
999
  {
994
1000
  "storage": "guides/brief.md",
995
1001
  "destination": "guides/brief.md",
996
1002
  "executable": false,
997
- "digest": "392e1209e53f64a317b5aea43bad7d00d82ae8fdf7fdbbde96a327a6b7ee074b"
1003
+ "digest": "2a9001549bf8a65eb565187b20d3c5343d33981597d52ddd3527f965c860d14e"
998
1004
  },
999
1005
  {
1000
1006
  "storage": "guides/browser.md",
1001
1007
  "destination": "guides/browser.md",
1002
1008
  "executable": false,
1003
- "digest": "2750e69ff89ccdccf6c7c5524fe3d4d6d17cea2778a06b917ca23047a2f0cb5d"
1009
+ "digest": "3318bdd633c6cc8b27cbed210daeeb3a7043498dd6d9eff0b2270b4297936bee"
1004
1010
  },
1005
1011
  {
1006
1012
  "storage": "guides/budget.md",
@@ -1078,7 +1084,7 @@
1078
1084
  "storage": "guides/interpret.md",
1079
1085
  "destination": "guides/interpret.md",
1080
1086
  "executable": false,
1081
- "digest": "6b5305233e95588a235c1f04928f42b574a4c42383e1fbc61824b80a9bb3bb7c"
1087
+ "digest": "5ae8fc66bd208cb276eed279d772162ca3a55cd2670f8d3fe8e90802c679f69f"
1082
1088
  },
1083
1089
  {
1084
1090
  "storage": "guides/jsonrpc.md",
@@ -1102,7 +1108,7 @@
1102
1108
  "storage": "guides/mcp.md",
1103
1109
  "destination": "guides/mcp.md",
1104
1110
  "executable": false,
1105
- "digest": "88f6c0b6ab11b351f1c2c56d54e927f8e267bfcd43a2b1e112fb7fbdc9ec81ce"
1111
+ "digest": "c549421c2e5257cfbe132ad3ad8744ddf3e89b11efee92abd8663cda2feb6d90"
1106
1112
  },
1107
1113
  {
1108
1114
  "storage": "guides/middleware.md",
@@ -1126,7 +1132,7 @@
1126
1132
  "storage": "guides/ollama.md",
1127
1133
  "destination": "guides/ollama.md",
1128
1134
  "executable": false,
1129
- "digest": "04efd19961f79a02ab9406f7790b8eb7ac1bf7a67bb06ac74f72d9ee65055da6"
1135
+ "digest": "75c275894ad8634eef42ebe1b9cab2769aa2c651bce38e91bc358bd83e0ae781"
1130
1136
  },
1131
1137
  {
1132
1138
  "storage": "guides/pool.md",
@@ -1150,13 +1156,13 @@
1150
1156
  "storage": "guides/program.md",
1151
1157
  "destination": "guides/program.md",
1152
1158
  "executable": false,
1153
- "digest": "9382f5a5ed2435cd03eb4171f7586d20f5b2b19061d716fc6184be2605bf4bf8"
1159
+ "digest": "be219e2d7dad706f808a56dedafee3686593cbdef4df9289dab07e476db203c0"
1154
1160
  },
1155
1161
  {
1156
1162
  "storage": "guides/qualifier.md",
1157
1163
  "destination": "guides/qualifier.md",
1158
1164
  "executable": false,
1159
- "digest": "6f52daa59a2041b5282c11776dcbdf47616e137d2acf8db5d6588061b0858910"
1165
+ "digest": "aa02fef23c33fee497540d2cc85f8e8a4b0347ac9bda9730ac99a484a5d876ef"
1160
1166
  },
1161
1167
  {
1162
1168
  "storage": "guides/queue.md",
@@ -1168,7 +1174,7 @@
1168
1174
  "storage": "guides/rater.md",
1169
1175
  "destination": "guides/rater.md",
1170
1176
  "executable": false,
1171
- "digest": "8809ce4fdb5cc4bffe4ba5c27676230cc783a57681a169e54655cceb6039b5bf"
1177
+ "digest": "9506827b46e330e56e9b3d582c96c44e2286ea95737082b6819ab52e7578b28c"
1172
1178
  },
1173
1179
  {
1174
1180
  "storage": "guides/reason.md",
@@ -1192,7 +1198,7 @@
1192
1198
  "storage": "guides/scaffold.md",
1193
1199
  "destination": "guides/scaffold.md",
1194
1200
  "executable": false,
1195
- "digest": "e8dd9c1130b23f4a2f284445d10b0d85797c4f2cf71005aa13e477c91badf81a"
1201
+ "digest": "e25466eb37cc1ca0d468790abf8c493044721a4b0e2283ab9094b2756d0ae67e"
1196
1202
  },
1197
1203
  {
1198
1204
  "storage": "guides/sea.md",
@@ -1222,7 +1228,7 @@
1222
1228
  "storage": "guides/study.md",
1223
1229
  "destination": "guides/study.md",
1224
1230
  "executable": false,
1225
- "digest": "00e26a26df0dbc1cd1134cbb071b7db66671994055304f180c6c7a5bc5fc1eb8"
1231
+ "digest": "858823ab1315d11209938fc5959bd8abe7011cee7a6d95f2fdb7ddbb97b60ddf"
1226
1232
  },
1227
1233
  {
1228
1234
  "storage": "guides/table.md",
@@ -1264,7 +1270,7 @@
1264
1270
  "storage": "guides/toolbox.md",
1265
1271
  "destination": "guides/toolbox.md",
1266
1272
  "executable": false,
1267
- "digest": "f0d20f9da6f3a9715ca0b737a5458e7dc39aa3b3efb5db76e1abc687932fbeb4"
1273
+ "digest": "e9ab600c7eff85cef716da6f93bb1f7921df7c20d56806deae0a1e591274c9b0"
1268
1274
  },
1269
1275
  {
1270
1276
  "storage": "guides/websocket.md",
@@ -1282,7 +1288,7 @@
1282
1288
  "storage": "guides/workflow.md",
1283
1289
  "destination": "guides/workflow.md",
1284
1290
  "executable": false,
1285
- "digest": "fa29da8863e84aceb5c0fc9e0868df81c77a5f76e3a6353e213d33a8cf5bc875"
1291
+ "digest": "3cb2965246fde117663d1255dcf95471ec51652629cedadb29312cf4fddd9e2f"
1286
1292
  },
1287
1293
  {
1288
1294
  "storage": "guides/workspace.md",
@@ -1411,5 +1417,5 @@
1411
1417
  "scripts"
1412
1418
  ],
1413
1419
  "surface": [],
1414
- "digest": "dc9854241aa55f6dbb2c39addc40253de7303088880b51d6c1bfbfd54e39e2ff"
1420
+ "digest": "d8c20e658d97c0fe3dcfdf0f675bf0dc86a200de6b572ee25a4d1ad642321744"
1415
1421
  }
@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
4
4
  let _orkestrel_emitter = require("@orkestrel/emitter");
5
5
  var package_default = {
6
6
  name: "@orkestrel/scaffold",
7
- version: "0.0.124",
7
+ version: "0.0.125",
8
8
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
9
9
  keywords: [
10
10
  "audit",
@@ -105,10 +105,10 @@ var package_default = {
105
105
  },
106
106
  devDependencies: {
107
107
  "@microsoft/api-extractor": "^7.60.1",
108
- "@orkestrel/browser": "^0.0.31",
109
- "@orkestrel/guide": "^0.0.29",
108
+ "@orkestrel/browser": "^0.0.32",
109
+ "@orkestrel/guide": "^0.0.30",
110
110
  "@orkestrel/html": "^0.0.15",
111
- "@orkestrel/probe": "^0.0.28",
111
+ "@orkestrel/probe": "^0.0.29",
112
112
  "@orkestrel/test": "^0.0.33",
113
113
  "@types/node": "^24.19.2",
114
114
  "@vitest/browser-playwright": "^5.1.0",