@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.
- package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +167 -4
- package/dist/agents/skills/orkestrel-publish/scripts/wave.js +20 -5
- package/dist/bin/main.js +3 -3
- package/dist/host/AGENTS.md +1 -1
- package/dist/host/agents/orchestration.md +2 -2
- package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +201 -8
- package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +24 -5
- package/dist/host/claude/agents/orkestrel.md +7 -7
- package/dist/host/claude/agents/reviewer.md +1 -1
- package/dist/host/claude/rules/documentation.md +1 -1
- package/dist/host/claude/rules/patterns.md +2 -2
- package/dist/host/claude/rules/workspace.md +9 -4
- package/dist/host/configs/helpers.ts +21 -6
- package/dist/host/guides/contract.md +198 -163
- package/dist/host/guides/database.md +760 -300
- package/dist/host/guides/indexeddb.md +80 -66
- package/dist/host/guides/relation.md +56 -32
- package/dist/host/guides/scaffold.md +8 -2
- package/dist/host/guides/sqlite.md +44 -23
- package/dist/host/guides/test.md +7 -3
- package/dist/host/manifest.json +19 -19
- package/dist/host/scripts/browsers.sh +0 -0
- package/dist/host/scripts/codex.sh +0 -0
- package/dist/host/scripts/cursor.sh +0 -0
- package/dist/host/scripts/deps.sh +0 -0
- package/dist/host/scripts/npm.sh +0 -0
- package/dist/host/scripts/ollama.sh +0 -0
- package/dist/host/tests/config.test.ts +71 -3
- package/dist/src/core/index.cjs +103 -26
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +31 -5
- package/dist/src/core/index.d.ts +31 -5
- package/dist/src/core/index.js +103 -27
- package/dist/src/core/index.js.map +1 -1
- 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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
|
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
|
|
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.
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
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
|