@orkestrel/scaffold 0.0.135 → 0.0.137
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 +12 -12
- 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 +52 -52
- 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/agent.md +3 -1
- package/dist/host/guides/brief.md +16 -16
- package/dist/host/guides/browser.md +1 -1
- package/dist/host/guides/contract.md +198 -163
- package/dist/host/guides/database.md +773 -310
- package/dist/host/guides/indexeddb.md +80 -66
- package/dist/host/guides/reason.md +1 -1
- 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/guides/tool.md +2 -1
- package/dist/host/guides/toolbox.md +44 -44
- package/dist/host/guides/workflow.md +2 -2
- package/dist/host/manifest.json +26 -26
- package/dist/host/tests/config.test.ts +71 -3
- package/dist/src/core/index.cjs +112 -35
- 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 +112 -36
- package/dist/src/core/index.js.map +1 -1
- package/package.json +12 -12
|
@@ -43,58 +43,58 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
|
|
|
43
43
|
|
|
44
44
|
| Package | Version | Layer | Runtime dependencies | Peer dependencies |
|
|
45
45
|
| ----------------------- | --------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
|
|
46
|
-
| `@orkestrel/abort` | `0.0.
|
|
47
|
-
| `@orkestrel/agent` | `0.0.
|
|
48
|
-
| `@orkestrel/brief` | `0.0.
|
|
49
|
-
| `@orkestrel/browser` | `0.0.
|
|
50
|
-
| `@orkestrel/budget` | `0.0.
|
|
51
|
-
| `@orkestrel/capture` | `0.0.
|
|
52
|
-
| `@orkestrel/codec` | `0.0.
|
|
53
|
-
| `@orkestrel/console` | `0.0.
|
|
54
|
-
| `@orkestrel/contract` | `0.0.
|
|
55
|
-
| `@orkestrel/csv` | `0.0.
|
|
56
|
-
| `@orkestrel/database` | `0.0.
|
|
57
|
-
| `@orkestrel/emitter` | `0.0.
|
|
58
|
-
| `@orkestrel/form` | `0.0.
|
|
59
|
-
| `@orkestrel/guide` | `0.0.
|
|
60
|
-
| `@orkestrel/html` | `0.0.
|
|
61
|
-
| `@orkestrel/indexeddb` | `0.0.
|
|
62
|
-
| `@orkestrel/interpret` | `0.0.
|
|
63
|
-
| `@orkestrel/jsonrpc` | `0.0.
|
|
64
|
-
| `@orkestrel/lsp` | `0.0.
|
|
65
|
-
| `@orkestrel/markdown` | `0.0.
|
|
66
|
-
| `@orkestrel/mcp` | `0.0.
|
|
67
|
-
| `@orkestrel/middleware` | `0.0.
|
|
68
|
-
| `@orkestrel/msg` | `0.0.
|
|
69
|
-
| `@orkestrel/ndjson` | `0.0.
|
|
70
|
-
| `@orkestrel/ollama` | `0.0.
|
|
71
|
-
| `@orkestrel/pool` | `0.0.
|
|
72
|
-
| `@orkestrel/probe` | `0.0.
|
|
73
|
-
| `@orkestrel/process` | `0.0.
|
|
74
|
-
| `@orkestrel/program` | `0.0.
|
|
75
|
-
| `@orkestrel/qualifier` | `0.0.
|
|
76
|
-
| `@orkestrel/queue` | `0.0.
|
|
77
|
-
| `@orkestrel/rater` | `0.0.
|
|
78
|
-
| `@orkestrel/reason` | `0.0.
|
|
79
|
-
| `@orkestrel/relation` | `0.0.
|
|
80
|
-
| `@orkestrel/router` | `0.0.
|
|
81
|
-
| `@orkestrel/scaffold` | `0.0.
|
|
82
|
-
| `@orkestrel/sea` | `0.0.
|
|
83
|
-
| `@orkestrel/server` | `0.0.
|
|
84
|
-
| `@orkestrel/sqlite` | `0.0.
|
|
85
|
-
| `@orkestrel/sse` | `0.0.
|
|
86
|
-
| `@orkestrel/study` | `0.0.
|
|
87
|
-
| `@orkestrel/table` | `0.0.
|
|
88
|
-
| `@orkestrel/template` | `0.0.
|
|
89
|
-
| `@orkestrel/terminal` | `0.0.
|
|
90
|
-
| `@orkestrel/test` | `0.0.
|
|
91
|
-
| `@orkestrel/timeout` | `0.0.
|
|
92
|
-
| `@orkestrel/tool` | `0.0.
|
|
93
|
-
| `@orkestrel/toolbox` | `0.0.
|
|
94
|
-
| `@orkestrel/websocket` | `0.0.
|
|
95
|
-
| `@orkestrel/worker` | `0.0.
|
|
96
|
-
| `@orkestrel/workflow` | `0.0.
|
|
97
|
-
| `@orkestrel/workspace` | `0.0.
|
|
46
|
+
| `@orkestrel/abort` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
47
|
+
| `@orkestrel/agent` | `0.0.45` | L5 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/abort` `^0.0.18`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ndjson` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27`, `@orkestrel/workflow` `^0.0.30`, `@orkestrel/workspace` `^0.0.20` | |
|
|
48
|
+
| `@orkestrel/brief` | `0.0.19` | L4 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/interpret` `^0.0.24` | |
|
|
49
|
+
| `@orkestrel/browser` | `0.0.34` | L5 | `@orkestrel/mcp` `^0.0.44`, `@orkestrel/html` `^0.0.17`, `@orkestrel/pool` `^0.0.22`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/router` `^0.0.22`, `@orkestrel/server` `^0.0.28`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.22`, `@orkestrel/websocket` `^0.0.20` | |
|
|
50
|
+
| `@orkestrel/budget` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
51
|
+
| `@orkestrel/capture` | `0.0.8` | L3 | `@orkestrel/process` `^0.0.20`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `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
|
+
| `@orkestrel/codec` | `0.0.11` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
53
|
+
| `@orkestrel/console` | `0.0.21` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
54
|
+
| `@orkestrel/contract` | `0.0.24` | L0 | | |
|
|
55
|
+
| `@orkestrel/csv` | `0.0.15` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
|
|
56
|
+
| `@orkestrel/database` | `0.0.27` | L2 | `@orkestrel/sqlite` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/indexeddb` `^0.0.19` | |
|
|
57
|
+
| `@orkestrel/emitter` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
58
|
+
| `@orkestrel/form` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
59
|
+
| `@orkestrel/guide` | `0.0.32` | L3 | `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.22` | |
|
|
60
|
+
| `@orkestrel/html` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
61
|
+
| `@orkestrel/indexeddb` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
62
|
+
| `@orkestrel/interpret` | `0.0.24` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/template` `^0.0.15` | |
|
|
63
|
+
| `@orkestrel/jsonrpc` | `0.0.4` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
64
|
+
| `@orkestrel/lsp` | `0.0.16` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/jsonrpc` `^0.0.4`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
|
|
65
|
+
| `@orkestrel/markdown` | `0.0.22` | L2 | `@orkestrel/html` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
66
|
+
| `@orkestrel/mcp` | `0.0.44` | L4 | `@orkestrel/sse` `^0.0.15`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/jsonrpc` `^0.0.4`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/websocket` `^0.0.20` | `@orkestrel/router` `^0.0.22`, `@orkestrel/server` `^0.0.28` |
|
|
67
|
+
| `@orkestrel/middleware` | `0.0.33` | L4 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `@orkestrel/server` `^0.0.28`, `@orkestrel/database` `^0.0.27` |
|
|
68
|
+
| `@orkestrel/msg` | `0.0.18` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
|
|
69
|
+
| `@orkestrel/ndjson` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
70
|
+
| `@orkestrel/ollama` | `0.0.39` | L6 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ndjson` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
|
|
71
|
+
| `@orkestrel/pool` | `0.0.22` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
72
|
+
| `@orkestrel/probe` | `0.0.31` | L5 | `@orkestrel/lsp` `^0.0.16`, `@orkestrel/mcp` `^0.0.44`, `@orkestrel/pool` `^0.0.22`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `vitest` `^4.1.12 \|\| ^5.1.0`, `typescript` `^6.0.3 \|\| ^7.0.2` |
|
|
73
|
+
| `@orkestrel/process` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
74
|
+
| `@orkestrel/program` | `0.0.22` | L4 | `@orkestrel/rater` `^0.0.23`, `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/qualifier` `^0.0.23` | |
|
|
75
|
+
| `@orkestrel/qualifier` | `0.0.23` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
76
|
+
| `@orkestrel/queue` | `0.0.24` | L3 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
|
|
77
|
+
| `@orkestrel/rater` | `0.0.23` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
78
|
+
| `@orkestrel/reason` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
79
|
+
| `@orkestrel/relation` | `0.0.25` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
|
|
80
|
+
| `@orkestrel/router` | `0.0.22` | L2 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
81
|
+
| `@orkestrel/scaffold` | `0.0.136` | L3 | `@orkestrel/console` `^0.0.20`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.21`, `@orkestrel/template` `^0.0.14` | |
|
|
82
|
+
| `@orkestrel/sea` | `0.0.24` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
|
|
83
|
+
| `@orkestrel/server` | `0.0.28` | L3 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/router` `^0.0.22`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | |
|
|
84
|
+
| `@orkestrel/sqlite` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
85
|
+
| `@orkestrel/sse` | `0.0.15` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
|
|
86
|
+
| `@orkestrel/study` | `0.0.21` | L7 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/abort` `^0.0.18`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ollama` `^0.0.39`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | |
|
|
87
|
+
| `@orkestrel/table` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
88
|
+
| `@orkestrel/template` | `0.0.15` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
89
|
+
| `@orkestrel/terminal` | `0.0.27` | L3 | `@orkestrel/sse` `^0.0.15`, `@orkestrel/form` `^0.0.19`, `@orkestrel/console` `^0.0.21`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
|
|
90
|
+
| `@orkestrel/test` | `0.0.40` | L1 | `@orkestrel/contract` `^0.0.24` | `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.65.0` |
|
|
91
|
+
| `@orkestrel/timeout` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
|
|
92
|
+
| `@orkestrel/tool` | `0.0.24` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
93
|
+
| `@orkestrel/toolbox` | `0.0.34` | L6 | `@orkestrel/form` `^0.0.19`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/server` `^0.0.28`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27`, `@orkestrel/relation` `^0.0.25`, `@orkestrel/terminal` `^0.0.27`, `@orkestrel/workflow` `^0.0.30`, `@orkestrel/workspace` `^0.0.20` | |
|
|
94
|
+
| `@orkestrel/websocket` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
|
|
95
|
+
| `@orkestrel/worker` | `0.0.24` | L4 | `@orkestrel/pool` `^0.0.22`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
|
|
96
|
+
| `@orkestrel/workflow` | `0.0.30` | L4 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
|
|
97
|
+
| `@orkestrel/workspace` | `0.0.20` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
|
|
98
98
|
|
|
99
99
|
<!-- /orkestrel:catalog -->
|
|
100
100
|
|
|
@@ -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
|
|
@@ -535,6 +535,8 @@ The `builtins` option of `AgentOptions` enables the tools an agent serves itself
|
|
|
535
535
|
|
|
536
536
|
The constructor refuses the `builtins` option with `AgentError` code `'BUILTIN'` when an entry is no `AgentBuiltin` name, when a name repeats, when it lists `unload` without `load`, and when the tool manager already holds a tool under an enabled name. Each run owns its built-in tools, so a tool a host registers later under an enabled name is never advertised or dispatched. With `builtins` absent, no skill holds a tool back and no skill body renders.
|
|
537
537
|
|
|
538
|
+
Each built-in's door repairs a lossless leaf before its handler runs, as the `repairValue` function of `@orkestrel/contract` repairs it: a finite number given for an argument, `-0` excepted, reads as its digits, so `{ skill: 7 }` loads the skill `'7'`. Every other malformed argument refuses with the tool's `'ARGUMENTS'` error before the handler runs. Each built-in's description in `BUILTIN_TOOLS` states the repair to the model, and the ledger's room admission and the read of what a run shows repair a stored call's arguments the same way.
|
|
539
|
+
|
|
538
540
|
The following agent lets the model load a skill, and the skill's tool waits for that load:
|
|
539
541
|
|
|
540
542
|
```ts
|
|
@@ -587,7 +589,7 @@ const plain = createScope({ name: 'plain', workspaces: ['orders'] })
|
|
|
587
589
|
await agent.generate({ prompt: { content: 'Check order 9.' }, scope: plain }) // renders orders
|
|
588
590
|
```
|
|
589
591
|
|
|
590
|
-
What a run shows comes from its conversation. Each turn reads the conversation's stored messages for every successful `load`, `unload`, and `switch` call, recognized by the note it returned, and keeps what the registries hold and the ceiling admits. The shown skills are the model's, in load order, and a skill loaded again after its unload goes last. A denied, refused, or failed call shows nothing, and so does a tool message whose text equals a note but answers another tool's call. A record counts only while the run enables its built-in, so a host tool under a built-in's name on a run that doesn't enable it shows nothing. A stored record can't name its writer, so a record such a tool wrote counts after a run enables the built-in, bounded by the registry and the ceiling as every record is. The read
|
|
592
|
+
What a run shows comes from its conversation. Each turn reads the conversation's stored messages for every successful `load`, `unload`, and `switch` call, recognized by the note it returned, and keeps what the registries hold and the ceiling admits. The shown skills are the model's, in load order, and a skill loaded again after its unload goes last. A denied, refused, or failed call shows nothing, and so does a tool message whose text equals a note but answers another tool's call. A record counts only while the run enables its built-in, so a host tool under a built-in's name on a run that doesn't enable it shows nothing. A stored record can't name its writer, so a record such a tool wrote counts after a run enables the built-in, bounded by the registry and the ceiling as every record is. The read repairs each call's arguments through the `repairValue` function of `@orkestrel/contract`, as the tool's door repairs them, so a `{ skill: 1 }` the door repaired to `'1'` shows the skill `'1'`. A fold keeps the record, because the read covers each section's retained originals before the live tail, and a conversation restored from its `ConversationSnapshot` shows what it showed when the snapshot was taken. A skill the ceiling excludes, or the registry no longer holds, shows nothing, and it shows again with no further `load` when it is admitted again. The loop reads no record while `builtins` lists none of `load`, `unload`, and `switch`. In the following runs, the second conversation shows nothing until its own load, and the restored one shows the skill from its first request:
|
|
591
593
|
|
|
592
594
|
```ts
|
|
593
595
|
import type { ProviderInterface } from '@orkestrel/agent'
|