@orkestrel/scaffold 0.0.135 → 0.0.136

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 (35) hide show
  1. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +167 -4
  2. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +20 -5
  3. package/dist/bin/main.js +3 -3
  4. package/dist/host/AGENTS.md +1 -1
  5. package/dist/host/agents/orchestration.md +2 -2
  6. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +201 -8
  7. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +24 -5
  8. package/dist/host/claude/agents/orkestrel.md +7 -7
  9. package/dist/host/claude/agents/reviewer.md +1 -1
  10. package/dist/host/claude/rules/documentation.md +1 -1
  11. package/dist/host/claude/rules/patterns.md +2 -2
  12. package/dist/host/claude/rules/workspace.md +9 -4
  13. package/dist/host/configs/helpers.ts +21 -6
  14. package/dist/host/guides/contract.md +198 -163
  15. package/dist/host/guides/database.md +760 -300
  16. package/dist/host/guides/indexeddb.md +80 -66
  17. package/dist/host/guides/relation.md +56 -32
  18. package/dist/host/guides/scaffold.md +8 -2
  19. package/dist/host/guides/sqlite.md +44 -23
  20. package/dist/host/guides/test.md +7 -3
  21. package/dist/host/manifest.json +19 -19
  22. package/dist/host/scripts/browsers.sh +0 -0
  23. package/dist/host/scripts/codex.sh +0 -0
  24. package/dist/host/scripts/cursor.sh +0 -0
  25. package/dist/host/scripts/deps.sh +0 -0
  26. package/dist/host/scripts/npm.sh +0 -0
  27. package/dist/host/scripts/ollama.sh +0 -0
  28. package/dist/host/tests/config.test.ts +71 -3
  29. package/dist/src/core/index.cjs +103 -26
  30. package/dist/src/core/index.cjs.map +1 -1
  31. package/dist/src/core/index.d.cts +31 -5
  32. package/dist/src/core/index.d.ts +31 -5
  33. package/dist/src/core/index.js +103 -27
  34. package/dist/src/core/index.js.map +1 -1
  35. package/package.json +3 -3
@@ -51,14 +51,14 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
51
51
  | `@orkestrel/capture` | `0.0.7` | L3 | `@orkestrel/process` `^0.0.19`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23` | `vite` `^8.3.8`, `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.61.0`, `@vitest/browser-playwright` `^4.1.12 \|\| ^5.0.5` |
52
52
  | `@orkestrel/codec` | `0.0.10` | L1 | `@orkestrel/contract` `^0.0.23` | |
53
53
  | `@orkestrel/console` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
54
- | `@orkestrel/contract` | `0.0.23` | L0 | | |
54
+ | `@orkestrel/contract` | `0.0.24` | L0 | | |
55
55
  | `@orkestrel/csv` | `0.0.14` | L2 | `@orkestrel/codec` `^0.0.10`, `@orkestrel/contract` `^0.0.23` | |
56
- | `@orkestrel/database` | `0.0.24` | L2 | `@orkestrel/sqlite` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/indexeddb` `^0.0.18` | |
56
+ | `@orkestrel/database` | `0.0.25` | L2 | `@orkestrel/sqlite` `^0.0.19`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/indexeddb` `^0.0.19` | |
57
57
  | `@orkestrel/emitter` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.23` | |
58
58
  | `@orkestrel/form` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
59
59
  | `@orkestrel/guide` | `0.0.31` | L3 | `@orkestrel/contract` `^0.0.23`, `@orkestrel/markdown` `^0.0.21` | |
60
60
  | `@orkestrel/html` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.23` | |
61
- | `@orkestrel/indexeddb` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.23` | |
61
+ | `@orkestrel/indexeddb` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
62
62
  | `@orkestrel/interpret` | `0.0.23` | L3 | `@orkestrel/reason` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/template` `^0.0.14` | |
63
63
  | `@orkestrel/jsonrpc` | `0.0.3` | L1 | `@orkestrel/contract` `^0.0.23` | |
64
64
  | `@orkestrel/lsp` | `0.0.15` | L3 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/jsonrpc` `^0.0.3`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23` | |
@@ -76,18 +76,18 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
76
76
  | `@orkestrel/queue` | `0.0.23` | L3 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.24` | |
77
77
  | `@orkestrel/rater` | `0.0.22` | L3 | `@orkestrel/reason` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
78
78
  | `@orkestrel/reason` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
79
- | `@orkestrel/relation` | `0.0.22` | L3 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.24` | |
79
+ | `@orkestrel/relation` | `0.0.23` | L3 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.25` | |
80
80
  | `@orkestrel/router` | `0.0.21` | L2 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
81
- | `@orkestrel/scaffold` | `0.0.134` | L3 | `@orkestrel/console` `^0.0.20`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/markdown` `^0.0.21`, `@orkestrel/template` `^0.0.14` | |
81
+ | `@orkestrel/scaffold` | `0.0.135` | L3 | `@orkestrel/console` `^0.0.20`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/markdown` `^0.0.21`, `@orkestrel/template` `^0.0.14` | |
82
82
  | `@orkestrel/sea` | `0.0.23` | L3 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23` | |
83
83
  | `@orkestrel/server` | `0.0.27` | L3 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/codec` `^0.0.10`, `@orkestrel/router` `^0.0.21`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23` | |
84
- | `@orkestrel/sqlite` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.23` | |
84
+ | `@orkestrel/sqlite` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
85
85
  | `@orkestrel/sse` | `0.0.14` | L2 | `@orkestrel/codec` `^0.0.10`, `@orkestrel/contract` `^0.0.23` | |
86
86
  | `@orkestrel/study` | `0.0.20` | L7 | `@orkestrel/tool` `^0.0.23`, `@orkestrel/abort` `^0.0.17`, `@orkestrel/agent` `^0.0.44`, `@orkestrel/budget` `^0.0.18`, `@orkestrel/ollama` `^0.0.38`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23` | |
87
87
  | `@orkestrel/table` | `0.0.17` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
88
88
  | `@orkestrel/template` | `0.0.14` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
89
89
  | `@orkestrel/terminal` | `0.0.26` | L3 | `@orkestrel/sse` `^0.0.14`, `@orkestrel/form` `^0.0.18`, `@orkestrel/console` `^0.0.20`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.24` | |
90
- | `@orkestrel/test` | `0.0.38` | L1 | `@orkestrel/contract` `^0.0.23` | `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.65.0` |
90
+ | `@orkestrel/test` | `0.0.39` | L1 | `@orkestrel/contract` `^0.0.23` | `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.65.0` |
91
91
  | `@orkestrel/timeout` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.23` | |
92
92
  | `@orkestrel/tool` | `0.0.23` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
93
93
  | `@orkestrel/toolbox` | `0.0.33` | L6 | `@orkestrel/form` `^0.0.18`, `@orkestrel/tool` `^0.0.23`, `@orkestrel/agent` `^0.0.44`, `@orkestrel/server` `^0.0.27`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.24`, `@orkestrel/relation` `^0.0.22`, `@orkestrel/terminal` `^0.0.26`, `@orkestrel/workflow` `^0.0.29`, `@orkestrel/workspace` `^0.0.19` | |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: reviewer
3
- description: 'Opus 5.5 review lane by default, on another engine when the dispatch names one, over implemented work, read-only on source: design fit, API and vocabulary, architecture shape, guide voice by default; correctness, constraints, and test sufficiency when the dispatch assigns the objective lane. Tests numbered claims and returns the falsify verdict. Never edits source.'
3
+ description: 'Opus 5.5 review lane by default, on another engine when the dispatch names one, over implemented work, read-only on source: design fit, API and vocabulary, and architecture shape by default; correctness, constraints, and test sufficiency when the dispatch assigns the objective lane. Tests numbered claims and returns the falsify verdict. Never edits source.'
4
4
  tools: Read, Grep, Glob
5
5
  model: opus
6
6
  effort: high
@@ -84,7 +84,7 @@ A skill, a tool description, and a refusal message each teach an agent mid-task.
84
84
  - Put the critical path in the tool description, most important first: a worked example, the key nesting, and the reply shape. A harness abbreviates a nested schema and delivers the description intact; never leave the teaching to the schema.
85
85
  - Make every refusal orient, name, or correct: state the subject, the exact key path, the expected shape, the valid candidates, and every missing and every unexpected item, in one refusal.
86
86
  - Keep the provenance a refusal computed, its token, span, reason, and known field, and never invent the value or field the caller intended.
87
- - Refuse with the correction in the message. Never coerce a malformed input and never silently drop it. Encode an untrusted identifier in a diagnostic, JSON-encoded and length-capped, so malformed input cannot fake or balloon the message.
87
+ - Refuse with the correction in the message. Never coerce a malformed input and never silently drop it. A door can repair a lossless leaf through the `repairValue` function where its guide states that it does, and, where the door serves a model, its tool description states it too. Encode an untrusted identifier in a diagnostic, JSON-encoded and length-capped, so malformed input cannot fake or balloon the message.
88
88
  - Acknowledge or state, never both: a mutation returns an acknowledgement and a read returns state. Say the split in both tools' descriptions so neither is polled for the other's job.
89
89
 
90
90
  ## Workflow skills
@@ -135,8 +135,8 @@ Use these orthogonal contract mechanisms:
135
135
  - Choose a hand guard or a shape-derived guard by how often the check runs and the representation it reads: a hand guard with a directional parity test on a per-element path, a derived guard at a once-per-entity door, and a diagnostic computed only after a refusal.
136
136
  - Admit an owned record from its raw form before any projection or fallback, so that corrupt-present stays apart from absent.
137
137
  - When a person, a model, or a client authored a value, admit it whole against the contract this package owns for it: refuse the value when it omits a member the contract requires or carries a member the contract does not declare, and never remove a member to admit the rest. Apply § Foreign contracts, not this bullet, to a value another package publishes.
138
- - When that contract is a compiled `@orkestrel/contract` contract, admit through the `admitValue` function and return its faults in the refusal; call the contract's `parse` method only to project an owned value outward.
139
- - State shape soundness, lossless semantic admission, and authoring validity as separate claims, and prove each at its own door.
138
+ - When that contract is a compiled `@orkestrel/contract` contract, then from `@orkestrel/contract` 0.0.24 on, admit through the strict `admitValue` function and return its faults in the refusal, and admit through the `repairValue` function only at a door the repair exception in `.claude/rules/documentation.md` § Agent-facing surfaces covers; call the contract's `parse` method only to project an owned value outward.
139
+ - State shape soundness, lossless repair, and authoring validity as separate claims, and prove each at its own door.
140
140
  - Treat persistence canonicalization as part of the declared identity round trip: when a store reorders or rewrites a value, compare identity by the value the declaration states.
141
141
  - Make a refusal bound cover the ownership and capture work paid before validation: read the limit during capture, with one counter per door call.
142
142
  - Report unread or unavailable evidence as unread, never as a false predicate or an empty success.
@@ -256,10 +256,15 @@ throwaway instrument against real sources, aliases and setup. Declare no proof t
256
256
  project composed in the root configuration rather than declared as a path string. The `probe` MCP
257
257
  server arms through it — its arming specifications live under the `tmp/probes/` directory and infer
258
258
  this project — so a workspace that removes the project, or declares it as a path string, fails the
259
- server's arming, and an unarmed server refuses every `prove` call. `test:bench` runs the bench
260
- project over `*.bench.ts` files under `tests/` and `tmp/probes/` and collects no ordinary test file.
261
- Every test script names its project and the `test:bench` script joins no chain, so no gate runs
262
- either project; the project's directory is
259
+ server's arming, and an unarmed server refuses every `prove` call. A browser-hosted face is every
260
+ planned face that runs in Playwright Chromium: `src:browser`, `app:browser`, `src:vue`, `app:vue`,
261
+ each sheet face, and the themes target. Its browser benches are the `*.bench.ts` files beneath its
262
+ test directory. `test:bench` runs the Node bench project over `*.bench.ts` files under `tests/` and
263
+ `tmp/probes/` other than the browser benches. In a workspace with a browser-hosted face, it also
264
+ runs the `bench:browser` project over those browser benches in Playwright Chromium; derive both
265
+ glob lists from the planned faces, and give a workspace without one no `bench:browser` project.
266
+ Neither bench project collects an ordinary test file. Every test script names its project and the `test:bench` script
267
+ joins no chain, so no gate runs a probe or bench project; the `probe` project's directory is
263
268
  ignored by git; and `.claude/rules/tests.md` governs what may live there.
264
269
 
265
270
  - Define a cross-cutting project only for a proof the package actually has.
@@ -374,11 +374,28 @@ export function findPackageDirectory(current: string): string | undefined {
374
374
  return parent === current ? undefined : findPackageDirectory(parent)
375
375
  }
376
376
 
377
+ /**
378
+ * Checks whether a path names an existing directory.
379
+ *
380
+ * @remarks
381
+ * Reads presence through `existsSync`, which answers `false` for an absent path and for a path
382
+ * beneath a file on every host; `lstatSync` with `throwIfNoEntry: false` returns `undefined` for
383
+ * the second on Windows (`ENOENT`) and throws on Linux (`ENOTDIR`).
384
+ *
385
+ * @param path - The path to check.
386
+ * @returns True if the path names an existing directory; false otherwise.
387
+ * @example
388
+ * ```ts
389
+ * isDirectoryPath(process.cwd()) // true
390
+ * ```
391
+ */
392
+ export function isDirectoryPath(path: string): boolean {
393
+ return existsSync(path) && lstatSync(path).isDirectory()
394
+ }
395
+
377
396
  export function packageRootOf(packageName: string, resolvedPath: string): string | undefined {
378
397
  const physical = physicalPath(resolvedPath)
379
- const directory = findPackageDirectory(
380
- lstatSync(physical, { throwIfNoEntry: false })?.isDirectory() ? physical : dirname(physical),
381
- )
398
+ const directory = findPackageDirectory(isDirectoryPath(physical) ? physical : dirname(physical))
382
399
  return directory !== undefined && packageManifestName(directory) === packageName
383
400
  ? realpathSync.native(directory)
384
401
  : undefined
@@ -386,9 +403,7 @@ export function packageRootOf(packageName: string, resolvedPath: string): string
386
403
 
387
404
  export function packageRootForResolved(resolvedPath: string): string | undefined {
388
405
  const physical = physicalPath(resolvedPath)
389
- const directory = findPackageDirectory(
390
- lstatSync(physical, { throwIfNoEntry: false })?.isDirectory() ? physical : dirname(physical),
391
- )
406
+ const directory = findPackageDirectory(isDirectoryPath(physical) ? physical : dirname(physical))
392
407
  return directory !== undefined && packageManifestName(directory) !== undefined
393
408
  ? realpathSync.native(directory)
394
409
  : undefined