@orkestrel/scaffold 0.0.131 → 0.0.133
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/bin/main.js +13 -13
- package/dist/host/agents/orchestration.md +5 -3
- package/dist/host/claude/agents/orkestrel.md +54 -54
- package/dist/host/claude/rules/tests.md +5 -0
- package/dist/host/configs/helpers.ts +2 -2
- package/dist/host/guides/browser.md +1 -1
- package/dist/host/guides/contract.md +26 -5
- package/dist/host/guides/database.md +43 -37
- package/dist/host/guides/queue.md +3 -1
- package/dist/host/guides/scaffold.md +4 -4
- package/dist/host/guides/test.md +333 -195
- package/dist/host/guides/workflow.md +4 -2
- package/dist/host/manifest.json +14 -14
- package/dist/host/tests/config.test.ts +3 -3
- package/dist/host/tests/policy.test.ts +1 -1
- package/dist/src/core/index.cjs +13 -14
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.js +13 -14
- package/dist/src/core/index.js.map +1 -1
- package/package.json +13 -13
|
@@ -251,7 +251,7 @@ that renders a thrown value as a failure message, also come from `@orkestrel/con
|
|
|
251
251
|
| `requireTimerBound` | function | `(value: unknown, label: string) => number` | Returns a timer bound, or refuses a value the host timer cannot arm as one. |
|
|
252
252
|
| `requireConcurrency` | function | `(value: unknown, phase: string) => number` | Returns a phase concurrency, or refuses a value that is not a positive safe integer. |
|
|
253
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
|
|
254
|
+
| `admitPatch` | function | `<T>(contract: ContractInterface<T>, value: unknown, noun: string, id: string) => Result<T, WorkflowError>` | Admits a patch through its contract with only lossless repairs, or refuses it with the faults that name why. |
|
|
255
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
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
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`. |
|
|
@@ -1081,11 +1081,13 @@ if (added.success) {
|
|
|
1081
1081
|
}
|
|
1082
1082
|
|
|
1083
1083
|
// A direct entity `patch` is the defense-in-depth self-check the manager's `update` delegates to.
|
|
1084
|
-
phase.patch({ concurrency: 2 }) // throws MUTATION unless this phase is `pending` and the patch
|
|
1084
|
+
phase.patch({ concurrency: 2 }) // throws MUTATION unless this phase is `pending` and the patch admits
|
|
1085
1085
|
```
|
|
1086
1086
|
|
|
1087
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.
|
|
1088
1088
|
|
|
1089
|
+
A patch admits through the same door as a definition, so a lossless type repair enters repaired: `workflow.update(phase.id, { concurrency: '4' })` applies `concurrency: 4`, so the phase's `concurrency` reads `4` afterwards. An undeclared key, a lossy repair such as `'4.5'` for an integer, and a value that cannot be read refuse with their faults.
|
|
1090
|
+
|
|
1089
1091
|
### Building the live tree by hand — `append`
|
|
1090
1092
|
|
|
1091
1093
|
`createWorkflow` builds every phase/task from the definition through `PhaseManagerInterface.append` / `TaskManagerInterface.append` internally — the same methods are available directly on an already-built tree's managers, for example to graft a live phase (or task) built elsewhere onto it:
|
package/dist/host/manifest.json
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
"storage": "agents/orchestration.md",
|
|
17
17
|
"destination": ".agents/orchestration.md",
|
|
18
18
|
"executable": false,
|
|
19
|
-
"digest": "
|
|
19
|
+
"digest": "60026f0e737170d18d68ddaa390d687e504a7fee645bfe8904d55c3a21b2354d"
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
"storage": "agents/platforms/posix.md",
|
|
@@ -628,7 +628,7 @@
|
|
|
628
628
|
"storage": "claude/agents/orkestrel.md",
|
|
629
629
|
"destination": ".claude/agents/orkestrel.md",
|
|
630
630
|
"executable": false,
|
|
631
|
-
"digest": "
|
|
631
|
+
"digest": "9c738ca649599037840aaf83f3a7f445701fab72174135310d14d90a26c74d11"
|
|
632
632
|
},
|
|
633
633
|
{
|
|
634
634
|
"storage": "claude/agents/planner.md",
|
|
@@ -724,7 +724,7 @@
|
|
|
724
724
|
"storage": "claude/rules/tests.md",
|
|
725
725
|
"destination": ".claude/rules/tests.md",
|
|
726
726
|
"executable": false,
|
|
727
|
-
"digest": "
|
|
727
|
+
"digest": "3af5f4c5104a7846d0ee4dfb40bc8f4940d90f4a00bee3bee0c4e6d4bf6980ac"
|
|
728
728
|
},
|
|
729
729
|
{
|
|
730
730
|
"storage": "claude/rules/typescript.md",
|
|
@@ -910,7 +910,7 @@
|
|
|
910
910
|
"storage": "configs/helpers.ts",
|
|
911
911
|
"destination": "configs/helpers.ts",
|
|
912
912
|
"executable": false,
|
|
913
|
-
"digest": "
|
|
913
|
+
"digest": "316a70bb0e3eb51d9831dad144b613e86092fc82c6288b9ce428d2bb0cc93ba0"
|
|
914
914
|
},
|
|
915
915
|
{
|
|
916
916
|
"storage": "configs/policy.ts",
|
|
@@ -1006,7 +1006,7 @@
|
|
|
1006
1006
|
"storage": "guides/browser.md",
|
|
1007
1007
|
"destination": "guides/browser.md",
|
|
1008
1008
|
"executable": false,
|
|
1009
|
-
"digest": "
|
|
1009
|
+
"digest": "d8756604cff1e55661c7d7f9a57ac4748553f0d2d7acc8e61aefd39c2e00a91c"
|
|
1010
1010
|
},
|
|
1011
1011
|
{
|
|
1012
1012
|
"storage": "guides/budget.md",
|
|
@@ -1036,7 +1036,7 @@
|
|
|
1036
1036
|
"storage": "guides/contract.md",
|
|
1037
1037
|
"destination": "guides/contract.md",
|
|
1038
1038
|
"executable": false,
|
|
1039
|
-
"digest": "
|
|
1039
|
+
"digest": "3092cdb3ef53f9dfcc59f2a06e665e609ddca3fda2b6a45686863461e383f277"
|
|
1040
1040
|
},
|
|
1041
1041
|
{
|
|
1042
1042
|
"storage": "guides/csv.md",
|
|
@@ -1048,7 +1048,7 @@
|
|
|
1048
1048
|
"storage": "guides/database.md",
|
|
1049
1049
|
"destination": "guides/database.md",
|
|
1050
1050
|
"executable": false,
|
|
1051
|
-
"digest": "
|
|
1051
|
+
"digest": "aa18f2aaed701023c831aef84aa069c4b4e74d9b0da3a29120a03e94e7a14188"
|
|
1052
1052
|
},
|
|
1053
1053
|
{
|
|
1054
1054
|
"storage": "guides/emitter.md",
|
|
@@ -1168,7 +1168,7 @@
|
|
|
1168
1168
|
"storage": "guides/queue.md",
|
|
1169
1169
|
"destination": "guides/queue.md",
|
|
1170
1170
|
"executable": false,
|
|
1171
|
-
"digest": "
|
|
1171
|
+
"digest": "5c45ea302c935ad96efaaa41b1d0ad4d37ace364ac94792305102c24595a5097"
|
|
1172
1172
|
},
|
|
1173
1173
|
{
|
|
1174
1174
|
"storage": "guides/rater.md",
|
|
@@ -1198,7 +1198,7 @@
|
|
|
1198
1198
|
"storage": "guides/scaffold.md",
|
|
1199
1199
|
"destination": "guides/scaffold.md",
|
|
1200
1200
|
"executable": false,
|
|
1201
|
-
"digest": "
|
|
1201
|
+
"digest": "b7a01ef90671422f3e49e520fb046c37ef21c45703c2181a5a66529cd6faa29c"
|
|
1202
1202
|
},
|
|
1203
1203
|
{
|
|
1204
1204
|
"storage": "guides/sea.md",
|
|
@@ -1252,7 +1252,7 @@
|
|
|
1252
1252
|
"storage": "guides/test.md",
|
|
1253
1253
|
"destination": "guides/test.md",
|
|
1254
1254
|
"executable": false,
|
|
1255
|
-
"digest": "
|
|
1255
|
+
"digest": "2636786781a7824ae58d61e10a600e54385d573486788c1aa6d2757dae4fd7b5"
|
|
1256
1256
|
},
|
|
1257
1257
|
{
|
|
1258
1258
|
"storage": "guides/timeout.md",
|
|
@@ -1288,7 +1288,7 @@
|
|
|
1288
1288
|
"storage": "guides/workflow.md",
|
|
1289
1289
|
"destination": "guides/workflow.md",
|
|
1290
1290
|
"executable": false,
|
|
1291
|
-
"digest": "
|
|
1291
|
+
"digest": "9e477d5b716d8de8357e7ea498bbea681ecd71db44a65a096343ad21bf7b0d55"
|
|
1292
1292
|
},
|
|
1293
1293
|
{
|
|
1294
1294
|
"storage": "guides/workspace.md",
|
|
@@ -1336,13 +1336,13 @@
|
|
|
1336
1336
|
"storage": "tests/config.test.ts",
|
|
1337
1337
|
"destination": "tests/config.test.ts",
|
|
1338
1338
|
"executable": false,
|
|
1339
|
-
"digest": "
|
|
1339
|
+
"digest": "f164d7ae0a443b1373798c09c14772fd5e097cfad7959f27e7eb2d3aea6a30d6"
|
|
1340
1340
|
},
|
|
1341
1341
|
{
|
|
1342
1342
|
"storage": "tests/policy.test.ts",
|
|
1343
1343
|
"destination": "tests/policy.test.ts",
|
|
1344
1344
|
"executable": false,
|
|
1345
|
-
"digest": "
|
|
1345
|
+
"digest": "f52fbd4346715e945b62dcaa1530a3a5d4e2c960bccfc06f5d37b2b1dae7a254"
|
|
1346
1346
|
},
|
|
1347
1347
|
{
|
|
1348
1348
|
"storage": "tests/setupPolicy.ts",
|
|
@@ -1417,5 +1417,5 @@
|
|
|
1417
1417
|
"scripts"
|
|
1418
1418
|
],
|
|
1419
1419
|
"surface": [],
|
|
1420
|
-
"digest": "
|
|
1420
|
+
"digest": "6dbb9df5361073276b11d612c1aa6cbba8890d80880216a1662c82165de478c4"
|
|
1421
1421
|
}
|
|
@@ -5174,7 +5174,7 @@ describe('configuration helpers', () => {
|
|
|
5174
5174
|
'environmentSourceError',
|
|
5175
5175
|
'fileSystemPath',
|
|
5176
5176
|
'findPackageDirectory',
|
|
5177
|
-
'
|
|
5177
|
+
'hasASCIIURLControl',
|
|
5178
5178
|
'isBoundaryExemptModule',
|
|
5179
5179
|
'isExtractorModule',
|
|
5180
5180
|
'isOutsideWorkspacePath',
|
|
@@ -5462,8 +5462,8 @@ describe('configuration helpers', () => {
|
|
|
5462
5462
|
"const module = import('./module.js')\nconst asset = new URL('./asset%20name.png', import.meta.url)\nvoid module\nvoid asset\n"
|
|
5463
5463
|
writeFileSync(source, code, 'utf8')
|
|
5464
5464
|
|
|
5465
|
-
expect(configHelpers.
|
|
5466
|
-
expect(configHelpers.
|
|
5465
|
+
expect(configHelpers.hasASCIIURLControl('clean')).toBe(false)
|
|
5466
|
+
expect(configHelpers.hasASCIIURLControl('line\u0000break')).toBe(true)
|
|
5467
5467
|
expect(configHelpers.isBoundaryExemptModule('virtual:control')).toBe(true)
|
|
5468
5468
|
expect(configHelpers.isBoundaryExemptModule(resolve(POLICY_ROOT, 'src/core/index.ts'))).toBe(
|
|
5469
5469
|
false,
|
|
@@ -979,7 +979,7 @@ describe('denylist currency', () => {
|
|
|
979
979
|
describe('repository policy', () => {
|
|
980
980
|
it('enforces the workspace policy laws including surface ownership', () => {
|
|
981
981
|
expect(inspectPolicyWorkspace(process.cwd())).toEqual([])
|
|
982
|
-
})
|
|
982
|
+
}, 20_000)
|
|
983
983
|
|
|
984
984
|
// A target reads the canon from the installed package, so its tree carries the
|
|
985
985
|
// pointer pair and no `.agents/` directory, no rule map, and no skill bridges.
|
package/dist/src/core/index.cjs
CHANGED
|
@@ -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.
|
|
7
|
+
version: "0.0.133",
|
|
8
8
|
description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
|
|
9
9
|
keywords: [
|
|
10
10
|
"audit",
|
|
@@ -96,27 +96,27 @@ var package_default = {
|
|
|
96
96
|
"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test && npm run test:templates && npm run test:distribution -- --mode release"
|
|
97
97
|
},
|
|
98
98
|
dependencies: {
|
|
99
|
-
"@orkestrel/console": "^0.0.
|
|
100
|
-
"@orkestrel/contract": "^0.0.
|
|
101
|
-
"@orkestrel/emitter": "^0.0.
|
|
102
|
-
"@orkestrel/markdown": "^0.0.
|
|
103
|
-
"@orkestrel/process": "^0.0.
|
|
104
|
-
"@orkestrel/template": "^0.0.
|
|
99
|
+
"@orkestrel/console": "^0.0.20",
|
|
100
|
+
"@orkestrel/contract": "^0.0.23",
|
|
101
|
+
"@orkestrel/emitter": "^0.0.16",
|
|
102
|
+
"@orkestrel/markdown": "^0.0.21",
|
|
103
|
+
"@orkestrel/process": "^0.0.19",
|
|
104
|
+
"@orkestrel/template": "^0.0.14"
|
|
105
105
|
},
|
|
106
106
|
devDependencies: {
|
|
107
107
|
"@microsoft/api-extractor": "^7.60.1",
|
|
108
|
-
"@orkestrel/browser": "^0.0.
|
|
109
|
-
"@orkestrel/guide": "^0.0.
|
|
110
|
-
"@orkestrel/html": "^0.0.
|
|
111
|
-
"@orkestrel/probe": "^0.0.
|
|
112
|
-
"@orkestrel/test": "^0.0.
|
|
108
|
+
"@orkestrel/browser": "^0.0.33",
|
|
109
|
+
"@orkestrel/guide": "^0.0.31",
|
|
110
|
+
"@orkestrel/html": "^0.0.16",
|
|
111
|
+
"@orkestrel/probe": "^0.0.30",
|
|
112
|
+
"@orkestrel/test": "^0.0.36",
|
|
113
113
|
"@types/node": "^24.19.2",
|
|
114
114
|
"@vitest/browser-playwright": "^5.1.0",
|
|
115
115
|
"oxfmt": "^0.78.0",
|
|
116
116
|
"oxlint": "^1.93.0",
|
|
117
117
|
"playwright": "^1.64.1",
|
|
118
118
|
"typescript": "^7.0.2",
|
|
119
|
-
"vite": "^8.3.
|
|
119
|
+
"vite": "^8.3.8",
|
|
120
120
|
"vitest": "^5.1.0"
|
|
121
121
|
},
|
|
122
122
|
engines: { "node": ">=22.18.0" }
|
|
@@ -1703,7 +1703,6 @@ export function studies(override?: UserConfig): UserConfig {
|
|
|
1703
1703
|
browser: { enabled: false },
|
|
1704
1704
|
testTimeout: 120_000,
|
|
1705
1705
|
hookTimeout: 120_000,
|
|
1706
|
-
fileParallelism: false,
|
|
1707
1706
|
sequence: { groupOrder: 1 },
|
|
1708
1707
|
},
|
|
1709
1708
|
}
|