@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.
- package/dist/agents/skills/orkestrel-publish/scripts/steps.js +523 -0
- package/dist/agents/skills/orkestrel-publish/scripts/wave.js +70 -11
- package/dist/bin/main.js +5 -5
- package/dist/bin/main.js.map +1 -1
- package/dist/host/agents/orchestration.md +5 -1
- package/dist/host/agents/platforms/windows.md +9 -1
- package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +1 -1
- package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +1 -0
- package/dist/host/agents/skills/orkestrel-harden/references/methods.md +30 -2
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -0
- package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +5 -1
- package/dist/host/agents/skills/orkestrel-publish/SKILL.md +1 -0
- package/dist/host/agents/skills/orkestrel-publish/references/release.md +2 -2
- package/dist/host/agents/skills/orkestrel-publish/references/wave.md +23 -6
- package/dist/host/agents/skills/orkestrel-publish/scripts/steps.ts +654 -0
- package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +79 -14
- package/dist/host/claude/agents/orkestrel.md +21 -21
- package/dist/host/claude/rules/patterns.md +1 -1
- package/dist/host/claude/rules/portability.md +2 -0
- package/dist/host/claude/rules/quality.md +3 -1
- package/dist/host/claude/rules/tests.md +3 -1
- package/dist/host/guides/agent.md +349 -244
- package/dist/host/guides/brief.md +52 -48
- package/dist/host/guides/browser.md +2 -2
- package/dist/host/guides/interpret.md +531 -155
- package/dist/host/guides/mcp.md +183 -61
- package/dist/host/guides/ollama.md +123 -66
- package/dist/host/guides/program.md +117 -39
- package/dist/host/guides/qualifier.md +110 -59
- package/dist/host/guides/rater.md +85 -32
- package/dist/host/guides/scaffold.md +13 -5
- package/dist/host/guides/study.md +580 -483
- package/dist/host/guides/toolbox.md +159 -80
- package/dist/host/guides/workflow.md +44 -25
- package/dist/host/manifest.json +36 -30
- package/dist/src/core/index.cjs +4 -4
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.js +4 -4
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +23 -11
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.d.cts +10 -6
- package/dist/src/server/index.d.ts +10 -6
- package/dist/src/server/index.js +23 -11
- package/dist/src/server/index.js.map +1 -1
- package/package.json +4 -4
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
// that fails: pin (read `scaffold audit --json`, whose drift exit is the reading the pin closes, then
|
|
6
6
|
// re-pin every range the audit release readings name to the registry caret and install), commit (`git commit --only` of
|
|
7
7
|
// the manifest and lockfile as the preparation commit), overwrite (`scaffold overwrite --json`, then
|
|
8
|
-
// `scaffold audit` exiting 0; offline, an exit of 1 whose note names the catalog
|
|
8
|
+
// `scaffold audit` exiting 0; offline, an exit of 1 whose note names the skipped catalog step is
|
|
9
9
|
// accepted; on @orkestrel/scaffold itself both are skipped with a note, because the vendored host
|
|
10
10
|
// is staged from that checkout), verify (`scaffold audit --json` prints the releases envelope and
|
|
11
11
|
// the audit's writable dependency population matches its lookup bounds; on @orkestrel/scaffold itself an audit exit of 1 is
|
|
@@ -68,8 +68,20 @@ export const RANGE_FIELDS: readonly string[] = [...RUNTIME_FIELDS, 'devDependenc
|
|
|
68
68
|
/** Names the agent file that carries the catalog table. */
|
|
69
69
|
export const CATALOG = '.claude/agents/orkestrel.md'
|
|
70
70
|
|
|
71
|
-
/**
|
|
72
|
-
|
|
71
|
+
/**
|
|
72
|
+
* Lists the texts that name the catalog step an offline overwrite skips.
|
|
73
|
+
*
|
|
74
|
+
* @remarks
|
|
75
|
+
* The executable is the target's installed release, so a checkout's script also reads the wording an
|
|
76
|
+
* earlier release prints.
|
|
77
|
+
*/
|
|
78
|
+
export const OFFLINE_NOTES: readonly string[] = [
|
|
79
|
+
'the catalog reads upstream and --offline reads none',
|
|
80
|
+
"'catalog' does not take --offline",
|
|
81
|
+
]
|
|
82
|
+
|
|
83
|
+
/** Lists the codes a host reports when a process holds a file a move or a removal reaches. */
|
|
84
|
+
export const HELD_CODES: readonly string[] = ['EBUSY', 'EPERM']
|
|
73
85
|
|
|
74
86
|
/**
|
|
75
87
|
* Names the package whose checkout the vendored host is staged from.
|
|
@@ -668,14 +680,14 @@ export function judgePin(result: SpawnSyncReturns<string>): Verdict {
|
|
|
668
680
|
* Judges the overwrite command.
|
|
669
681
|
*
|
|
670
682
|
* @param result - The overwrite.
|
|
671
|
-
* @param offline - If `true`, an exit of 1 whose note names the catalog
|
|
672
|
-
* the exit alone decides.
|
|
683
|
+
* @param offline - If `true`, an exit of 1 whose note names the skipped catalog step passes; if
|
|
684
|
+
* `false`, the exit alone decides.
|
|
673
685
|
* @returns The verdict.
|
|
674
686
|
*/
|
|
675
687
|
export function judgeOverwrite(result: SpawnSyncReturns<string>, offline: boolean): Verdict {
|
|
676
688
|
if (!offline || result.status !== 1) return readVerdict(result)
|
|
677
689
|
const note = readString(parseJsonLine(result.stdout), 'note')
|
|
678
|
-
return note !== undefined && note.includes(
|
|
690
|
+
return note !== undefined && OFFLINE_NOTES.some((text) => note.includes(text))
|
|
679
691
|
? { exit: 0, note: 'offline overwrite skipped the catalog step by design' }
|
|
680
692
|
: { exit: 1, note: describeFailure(result) }
|
|
681
693
|
}
|
|
@@ -1001,6 +1013,18 @@ export function readRegenerationRefusal(runner: Runner): string | undefined {
|
|
|
1001
1013
|
return undefined
|
|
1002
1014
|
}
|
|
1003
1015
|
|
|
1016
|
+
/**
|
|
1017
|
+
* Extracts the code that names a held file from a thrown value.
|
|
1018
|
+
*
|
|
1019
|
+
* @param error - The thrown value.
|
|
1020
|
+
* @returns The code when {@link HELD_CODES} lists it, else undefined.
|
|
1021
|
+
*/
|
|
1022
|
+
export function extractHeldCode(error: unknown): string | undefined {
|
|
1023
|
+
return isRecord(error) && typeof error.code === 'string' && HELD_CODES.includes(error.code)
|
|
1024
|
+
? error.code
|
|
1025
|
+
: undefined
|
|
1026
|
+
}
|
|
1027
|
+
|
|
1004
1028
|
/**
|
|
1005
1029
|
* Renames a directory, retrying while the host holds it.
|
|
1006
1030
|
*
|
|
@@ -1014,8 +1038,7 @@ export function moveModules(source: string, target: string, attempt = 0): void {
|
|
|
1014
1038
|
try {
|
|
1015
1039
|
renameSync(source, target)
|
|
1016
1040
|
} catch (error) {
|
|
1017
|
-
if (
|
|
1018
|
-
throw error
|
|
1041
|
+
if (extractHeldCode(error) === undefined || attempt >= 9) throw error
|
|
1019
1042
|
Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100)
|
|
1020
1043
|
moveModules(source, target, attempt + 1)
|
|
1021
1044
|
}
|
|
@@ -1092,10 +1115,15 @@ export function regenerateLock(
|
|
|
1092
1115
|
runner,
|
|
1093
1116
|
step,
|
|
1094
1117
|
'regenerate lock and modules',
|
|
1095
|
-
[
|
|
1118
|
+
[
|
|
1119
|
+
result.note,
|
|
1120
|
+
restored,
|
|
1121
|
+
versions === undefined ? undefined : `installed ${versions}`,
|
|
1122
|
+
cleanup?.note,
|
|
1123
|
+
]
|
|
1096
1124
|
.filter((value) => value !== undefined)
|
|
1097
1125
|
.join('; '),
|
|
1098
|
-
cleanup
|
|
1126
|
+
cleanup?.exit ?? result.exit,
|
|
1099
1127
|
)
|
|
1100
1128
|
if (result.installed !== undefined)
|
|
1101
1129
|
appendResult(
|
|
@@ -1152,18 +1180,55 @@ export function regenerateTree(target: string, manifest: Buffer, before: string)
|
|
|
1152
1180
|
* @param target - The target directory.
|
|
1153
1181
|
* @param moved - The moved previous tree.
|
|
1154
1182
|
* @param backup - The saved lock.
|
|
1155
|
-
* @returns
|
|
1183
|
+
* @returns Exit 0 and no note on success, else the verdict {@link judgeCleanup} reaches.
|
|
1156
1184
|
*/
|
|
1157
|
-
export function discardBackup(target: string, moved: string, backup: string):
|
|
1185
|
+
export function discardBackup(target: string, moved: string, backup: string): Verdict {
|
|
1158
1186
|
try {
|
|
1159
1187
|
for (const path of [moved, backup, join(target, 'node_modules')]) validateWavePath(target, path)
|
|
1188
|
+
} catch (error) {
|
|
1189
|
+
return judgeCleanup(error, false, backup, moved)
|
|
1190
|
+
}
|
|
1191
|
+
try {
|
|
1160
1192
|
removeTree(moved)
|
|
1161
|
-
return undefined
|
|
1193
|
+
return { exit: 0, note: undefined }
|
|
1162
1194
|
} catch (error) {
|
|
1163
|
-
return
|
|
1195
|
+
return judgeCleanup(error, true, backup, moved)
|
|
1164
1196
|
}
|
|
1165
1197
|
}
|
|
1166
1198
|
|
|
1199
|
+
/**
|
|
1200
|
+
* Judges a cleanup that failed after a proved regeneration.
|
|
1201
|
+
*
|
|
1202
|
+
* @remarks
|
|
1203
|
+
* The proved installation reads nothing from the moved tree, so a file a process holds there stops
|
|
1204
|
+
* neither the step nor the visit.
|
|
1205
|
+
*
|
|
1206
|
+
* @param failure - The thrown value.
|
|
1207
|
+
* @param removing - If `true`, the removal threw and a held file's code passes; if `false`, the path
|
|
1208
|
+
* validation threw and every value fails.
|
|
1209
|
+
* @param backup - The saved lock.
|
|
1210
|
+
* @param moved - The moved previous tree.
|
|
1211
|
+
* @returns Exit 0 with a note that names the code for a held file, else exit 1; each note names both
|
|
1212
|
+
* backup paths.
|
|
1213
|
+
*/
|
|
1214
|
+
export function judgeCleanup(
|
|
1215
|
+
failure: unknown,
|
|
1216
|
+
removing: boolean,
|
|
1217
|
+
backup: string,
|
|
1218
|
+
moved: string,
|
|
1219
|
+
): Verdict {
|
|
1220
|
+
const code = removing ? extractHeldCode(failure) : undefined
|
|
1221
|
+
return code === undefined
|
|
1222
|
+
? {
|
|
1223
|
+
exit: 1,
|
|
1224
|
+
note: `backup cleanup failed: ${String(failure)}; proved installation retained; backups: ${backup}; ${moved}`,
|
|
1225
|
+
}
|
|
1226
|
+
: {
|
|
1227
|
+
exit: 0,
|
|
1228
|
+
note: `proved installation retained; a held file stopped backup cleanup (${code}): ${String(failure)}; backups: ${backup}; ${moved}`,
|
|
1229
|
+
}
|
|
1230
|
+
}
|
|
1231
|
+
|
|
1167
1232
|
/**
|
|
1168
1233
|
* Restores the previous tree and lock after a failed regeneration.
|
|
1169
1234
|
*
|
|
@@ -44,9 +44,9 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
|
|
|
44
44
|
| Package | Version | Layer | Runtime dependencies | Peer dependencies |
|
|
45
45
|
| ----------------------- | --------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
|
|
46
46
|
| `@orkestrel/abort` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
47
|
-
| `@orkestrel/agent` | `0.0.
|
|
48
|
-
| `@orkestrel/brief` | `0.0.
|
|
49
|
-
| `@orkestrel/browser` | `0.0.
|
|
47
|
+
| `@orkestrel/agent` | `0.0.36` | L5 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/abort` `^0.0.16`, `@orkestrel/queue` `^0.0.20`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ndjson` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.21`, `@orkestrel/workflow` `^0.0.26`, `@orkestrel/workspace` `^0.0.15` | |
|
|
48
|
+
| `@orkestrel/brief` | `0.0.17` | L4 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/interpret` `^0.0.22` | |
|
|
49
|
+
| `@orkestrel/browser` | `0.0.32` | L5 | `@orkestrel/mcp` `^0.0.42`, `@orkestrel/html` `^0.0.15`, `@orkestrel/pool` `^0.0.20`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/router` `^0.0.20`, `@orkestrel/server` `^0.0.26`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20`, `@orkestrel/websocket` `^0.0.18` | |
|
|
50
50
|
| `@orkestrel/budget` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
51
51
|
| `@orkestrel/capture` | `0.0.3` | L3 | `@orkestrel/process` `^0.0.17`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21` | `vite` `^8.3.5`, `vitest` `^4.1.12 \|\| ^5.0.5`, `playwright` `^1.61.0`, `@vitest/browser-playwright` `^4.1.12 \|\| ^5.0.5` |
|
|
52
52
|
| `@orkestrel/codec` | `0.0.9` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
@@ -56,45 +56,45 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
|
|
|
56
56
|
| `@orkestrel/database` | `0.0.21` | L2 | `@orkestrel/sqlite` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/indexeddb` `^0.0.17` | |
|
|
57
57
|
| `@orkestrel/emitter` | `0.0.15` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
58
58
|
| `@orkestrel/form` | `0.0.16` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
59
|
-
| `@orkestrel/guide` | `0.0.
|
|
59
|
+
| `@orkestrel/guide` | `0.0.30` | L3 | `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20` | |
|
|
60
60
|
| `@orkestrel/html` | `0.0.15` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
61
61
|
| `@orkestrel/indexeddb` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
62
|
-
| `@orkestrel/interpret` | `0.0.
|
|
62
|
+
| `@orkestrel/interpret` | `0.0.22` | L3 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/template` `^0.0.13` | |
|
|
63
63
|
| `@orkestrel/jsonrpc` | `0.0.2` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
64
|
-
| `@orkestrel/lsp` | `0.0.
|
|
64
|
+
| `@orkestrel/lsp` | `0.0.14` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/jsonrpc` `^0.0.2`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
|
|
65
65
|
| `@orkestrel/markdown` | `0.0.20` | L2 | `@orkestrel/html` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
66
|
-
| `@orkestrel/mcp` | `0.0.
|
|
66
|
+
| `@orkestrel/mcp` | `0.0.42` | L4 | `@orkestrel/sse` `^0.0.13`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/jsonrpc` `^0.0.2`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/websocket` `^0.0.18` | `@orkestrel/router` `^0.0.20`, `@orkestrel/server` `^0.0.26` |
|
|
67
67
|
| `@orkestrel/middleware` | `0.0.27` | L4 | `@orkestrel/abort` `^0.0.15`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21` | `@orkestrel/server` `^0.0.25`, `@orkestrel/database` `^0.0.20` |
|
|
68
68
|
| `@orkestrel/msg` | `0.0.15` | L2 | `@orkestrel/codec` `^0.0.8`, `@orkestrel/contract` `^0.0.21` | |
|
|
69
69
|
| `@orkestrel/ndjson` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
70
|
-
| `@orkestrel/ollama` | `0.0.
|
|
70
|
+
| `@orkestrel/ollama` | `0.0.30` | L6 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/agent` `^0.0.36`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ndjson` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
|
|
71
71
|
| `@orkestrel/pool` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
72
|
-
| `@orkestrel/probe` | `0.0.
|
|
72
|
+
| `@orkestrel/probe` | `0.0.29` | L5 | `@orkestrel/lsp` `^0.0.14`, `@orkestrel/mcp` `^0.0.42`, `@orkestrel/pool` `^0.0.20`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `vitest` `^4.1.12 \|\| ^5.1.0`, `typescript` `^6.0.3 \|\| ^7.0.2` |
|
|
73
73
|
| `@orkestrel/process` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
74
|
-
| `@orkestrel/program` | `0.0.
|
|
75
|
-
| `@orkestrel/qualifier` | `0.0.
|
|
76
|
-
| `@orkestrel/queue` | `0.0.
|
|
77
|
-
| `@orkestrel/rater` | `0.0.
|
|
74
|
+
| `@orkestrel/program` | `0.0.20` | L4 | `@orkestrel/rater` `^0.0.21`, `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/qualifier` `^0.0.21` | |
|
|
75
|
+
| `@orkestrel/qualifier` | `0.0.21` | L3 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
76
|
+
| `@orkestrel/queue` | `0.0.20` | L3 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.21` | |
|
|
77
|
+
| `@orkestrel/rater` | `0.0.21` | L3 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
78
78
|
| `@orkestrel/reason` | `0.0.17` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
79
|
-
| `@orkestrel/relation` | `0.0.
|
|
79
|
+
| `@orkestrel/relation` | `0.0.19` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.21` | |
|
|
80
80
|
| `@orkestrel/router` | `0.0.20` | L2 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
81
|
-
| `@orkestrel/scaffold` | `0.0.
|
|
81
|
+
| `@orkestrel/scaffold` | `0.0.124` | L3 | `@orkestrel/console` `^0.0.19`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20`, `@orkestrel/template` `^0.0.13` | |
|
|
82
82
|
| `@orkestrel/sea` | `0.0.21` | L3 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/contract` `^0.0.21` | |
|
|
83
|
-
| `@orkestrel/server` | `0.0.
|
|
83
|
+
| `@orkestrel/server` | `0.0.26` | L3 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/router` `^0.0.20`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | |
|
|
84
84
|
| `@orkestrel/sqlite` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
85
85
|
| `@orkestrel/sse` | `0.0.13` | L2 | `@orkestrel/codec` `^0.0.9`, `@orkestrel/contract` `^0.0.22` | |
|
|
86
|
-
| `@orkestrel/study` | `0.0.
|
|
86
|
+
| `@orkestrel/study` | `0.0.11` | L7 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/abort` `^0.0.16`, `@orkestrel/agent` `^0.0.36`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ollama` `^0.0.30`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | |
|
|
87
87
|
| `@orkestrel/table` | `0.0.14` | L2 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
|
|
88
88
|
| `@orkestrel/template` | `0.0.13` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
89
|
-
| `@orkestrel/terminal` | `0.0.
|
|
89
|
+
| `@orkestrel/terminal` | `0.0.23` | L3 | `@orkestrel/sse` `^0.0.13`, `@orkestrel/form` `^0.0.16`, `@orkestrel/console` `^0.0.19`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.21` | |
|
|
90
90
|
| `@orkestrel/test` | `0.0.33` | L1 | `@orkestrel/contract` `^0.0.22` | `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.64.1` |
|
|
91
91
|
| `@orkestrel/timeout` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.22` | |
|
|
92
92
|
| `@orkestrel/tool` | `0.0.22` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
93
|
-
| `@orkestrel/toolbox` | `0.0.
|
|
93
|
+
| `@orkestrel/toolbox` | `0.0.25` | L6 | `@orkestrel/form` `^0.0.16`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/agent` `^0.0.36`, `@orkestrel/server` `^0.0.26`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.21`, `@orkestrel/relation` `^0.0.19`, `@orkestrel/terminal` `^0.0.23`, `@orkestrel/workflow` `^0.0.26`, `@orkestrel/workspace` `^0.0.15` | |
|
|
94
94
|
| `@orkestrel/websocket` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
|
|
95
95
|
| `@orkestrel/worker` | `0.0.19` | L4 | `@orkestrel/pool` `^0.0.19`, `@orkestrel/queue` `^0.0.19`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20` | |
|
|
96
|
-
| `@orkestrel/workflow` | `0.0.
|
|
97
|
-
| `@orkestrel/workspace` | `0.0.
|
|
96
|
+
| `@orkestrel/workflow` | `0.0.26` | L4 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/queue` `^0.0.20`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.21` | |
|
|
97
|
+
| `@orkestrel/workspace` | `0.0.15` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.21` | |
|
|
98
98
|
|
|
99
99
|
<!-- /orkestrel:catalog -->
|
|
100
100
|
|
|
@@ -139,7 +139,7 @@ Use these orthogonal contract mechanisms:
|
|
|
139
139
|
- Report unread or unavailable evidence as unread, never as a false predicate or an empty success.
|
|
140
140
|
- Bind admission and approval to the exact operation and instance, and recheck that binding across every suspension and callback before dispatch.
|
|
141
141
|
- Name the actual commit boundary in a restore or continuation claim, partial commits included.
|
|
142
|
-
- Declare a parser's whole admitted language and its adjacent refusals, and prove them with a table of the class; never tune the parser example by example.
|
|
142
|
+
- Declare a parser's whole admitted language and its adjacent refusals, and prove them with a table of the class; never tune the parser example by example. On a parser change, run a seeded differential against its parent build, and read a passing suite as no evidence of what the change moved.
|
|
143
143
|
- Derive a decision from validated inputs; an editable prior result never substitutes for them.
|
|
144
144
|
- Project a value outward by its authorship and trust origin, and accept no authority channel from a client.
|
|
145
145
|
|
|
@@ -35,6 +35,8 @@ and the form of a conditional skip.
|
|
|
35
35
|
- Split arrived text on `/\r\n|\n/`. Never split on `\n` alone, and never split on a bare `\r`.
|
|
36
36
|
- Split first, then trim each line; trimming the whole payload leaves a `\r` on every line but the
|
|
37
37
|
last.
|
|
38
|
+
- Split `git status --porcelain` output before reading its columns, or read the `-z` form: trimming
|
|
39
|
+
the whole output eats the first row's leading status column, and a fixed slice then cuts its path.
|
|
38
40
|
- Frame a named protocol — HTTP, LSP, RFC 6455, NDJSON — with the terminator that protocol fixes,
|
|
39
41
|
and leave that terminator alone.
|
|
40
42
|
- Emit `\n` from code this package owns. Never emit `os.EOL`.
|
|
@@ -56,7 +56,9 @@ These rules govern how a claim is established: the evidence read before a change
|
|
|
56
56
|
- Keep an algorithmic repair (a superlinear term, a repeated layout) when the measurement shows it.
|
|
57
57
|
- Before the run, size the fixtures, the sample count, and the threshold to the case, and state the reasoning and the result that makes the change worth keeping.
|
|
58
58
|
- Read the difference between methods against each side's reported uncertainty, and record no difference smaller than the result stated before the run.
|
|
59
|
-
- Report every measurement with the host's other load during the run.
|
|
59
|
+
- Report every measurement with the host's other load during the run, its memory and console counts included.
|
|
60
|
+
- When a brief changes a hot path, name a measured cost bar at the input limit, and read the cost there before acceptance: an ordinary-length test cannot read a superlinear term.
|
|
61
|
+
- Before a long measured run, rehearse it at full scale on its real inputs with the model or service taken out, and read the rehearsal's own cost, before spending the window. A review or a hand fixture does not stand in for that rehearsal.
|
|
60
62
|
- Compare two builds interleaved in one run under one host load, with `.agents/skills/orkestrel-harden/scripts/interleave.ts`. Read a published side from the published artifact, calibrate the run with identical sides, and bar the relative change, never an absolute reading from another moment.
|
|
61
63
|
- Price a cost over the caller's whole lifecycle and workload: construction, restoration, transfer, and decision beside the warm saving.
|
|
62
64
|
- Derive a cost stop from what the consumer spends around the cost, and state responsiveness and throughput as separate claims.
|
|
@@ -277,7 +277,9 @@ Import `waitForCondition`, `waitForEvent`, `waitForAbort`, and `retryUntil` from
|
|
|
277
277
|
event in a test or a setup module is a defect: `waitForCondition` owns the poll, `waitForEvent`
|
|
278
278
|
the deferred on an event, and `waitForAbort` the deferred on a signal. A guide fence transcribed
|
|
279
279
|
byte for byte into `tests/guides.test.ts` is the consumer's code and stays as the guide shows it.
|
|
280
|
-
Give each timed wait a `description` the timeout error names.
|
|
280
|
+
Give each timed wait a `description` the timeout error names. When a poll fails, read what it saw
|
|
281
|
+
along the way before ruling on its final reading, and let a background start's rejection reach the
|
|
282
|
+
wait through its signal rather than swallowing it with an empty `catch`.
|
|
281
283
|
|
|
282
284
|
### Scratch
|
|
283
285
|
|