@orkestrel/scaffold 0.0.120 → 0.0.122

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 (78) hide show
  1. package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +57 -9
  2. package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +22 -2
  3. package/dist/agents/skills/orkestrel-publish/scripts/pins.js +5 -5
  4. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +67 -5
  5. package/dist/bin/main.js +5 -5
  6. package/dist/bin/main.js.map +1 -1
  7. package/dist/host/agents/orchestration.md +16 -11
  8. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +4 -4
  9. package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +2 -1
  10. package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +65 -9
  11. package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +28 -2
  12. package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +2 -1
  13. package/dist/host/agents/skills/orkestrel-harden/SKILL.md +8 -8
  14. package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +3 -3
  15. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +2 -2
  16. package/dist/host/agents/skills/orkestrel-publish/SKILL.md +10 -8
  17. package/dist/host/agents/skills/orkestrel-publish/references/release.md +2 -2
  18. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +22 -8
  19. package/dist/host/agents/skills/orkestrel-publish/references/window.md +5 -1
  20. package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +5 -5
  21. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +86 -7
  22. package/dist/host/claude/AGENTS.md +1 -1
  23. package/dist/host/claude/agents/analyst.md +1 -1
  24. package/dist/host/claude/agents/opus.md +7 -6
  25. package/dist/host/claude/agents/orkestrel.md +26 -26
  26. package/dist/host/claude/agents/planner.md +3 -3
  27. package/dist/host/claude/agents/reviewer.md +3 -3
  28. package/dist/host/claude/agents/verifier.md +1 -1
  29. package/dist/host/claude/rules/campaign.md +3 -2
  30. package/dist/host/claude/rules/names.md +13 -7
  31. package/dist/host/claude/rules/tests.md +1 -1
  32. package/dist/host/claude/rules/workspace.md +9 -0
  33. package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
  34. package/dist/host/codex/agents/analyst.toml +2 -5
  35. package/dist/host/codex/agents/opus.toml +5 -3
  36. package/dist/host/codex/agents/planner.toml +6 -5
  37. package/dist/host/codex/agents/reviewer.toml +4 -7
  38. package/dist/host/codex/agents/verifier.toml +2 -2
  39. package/dist/host/dotfiles/gitignore +1 -2
  40. package/dist/host/guides/agent.md +5 -5
  41. package/dist/host/guides/brief.md +7 -15
  42. package/dist/host/guides/browser.md +1 -1
  43. package/dist/host/guides/capture.md +2 -2
  44. package/dist/host/guides/console.md +4 -30
  45. package/dist/host/guides/guide.md +0 -1
  46. package/dist/host/guides/interpret.md +165 -182
  47. package/dist/host/guides/lsp.md +26 -51
  48. package/dist/host/guides/mcp.md +220 -276
  49. package/dist/host/guides/middleware.md +14 -22
  50. package/dist/host/guides/ollama.md +1 -3
  51. package/dist/host/guides/probe.md +71 -80
  52. package/dist/host/guides/program.md +26 -35
  53. package/dist/host/guides/qualifier.md +0 -6
  54. package/dist/host/guides/queue.md +0 -4
  55. package/dist/host/guides/rater.md +6 -12
  56. package/dist/host/guides/relation.md +0 -2
  57. package/dist/host/guides/scaffold.md +18 -9
  58. package/dist/host/guides/sea.md +47 -51
  59. package/dist/host/guides/server.md +15 -19
  60. package/dist/host/guides/terminal.md +0 -26
  61. package/dist/host/guides/toolbox.md +0 -10
  62. package/dist/host/guides/worker.md +57 -57
  63. package/dist/host/guides/workflow.md +13 -26
  64. package/dist/host/guides/workspace.md +15 -21
  65. package/dist/host/manifest.json +63 -483
  66. package/dist/host/tests/config.test.ts +7 -0
  67. package/dist/src/core/index.cjs +13 -46
  68. package/dist/src/core/index.cjs.map +1 -1
  69. package/dist/src/core/index.js +13 -46
  70. package/dist/src/core/index.js.map +1 -1
  71. package/dist/src/server/index.cjs +10 -9
  72. package/dist/src/server/index.cjs.map +1 -1
  73. package/dist/src/server/index.d.cts +12 -8
  74. package/dist/src/server/index.d.ts +12 -8
  75. package/dist/src/server/index.js +10 -9
  76. package/dist/src/server/index.js.map +1 -1
  77. package/package.json +5 -5
  78. /package/dist/host/agents/skills/orkestrel-parallel/references/{claude.md → claude-code.md} +0 -0
@@ -16,6 +16,7 @@ import type { Snapshot } from '@orkestrel/scaffold';
16
16
  import type { SurfaceCandidate } from '@orkestrel/scaffold';
17
17
  import type { SurfaceCollision } from '@orkestrel/scaffold';
18
18
  import type { SurfaceContract } from '@orkestrel/scaffold';
19
+ import type { SurfaceTransfer } from '@orkestrel/scaffold';
19
20
 
20
21
  /**
21
22
  * Matches the Git branch syntax the repository endpoint accepts.
@@ -385,11 +386,13 @@ export declare interface HostManifestEntry {
385
386
  * `inventory` is relative to the checkout. Default: `host.json`.
386
387
  * `establish`: if `true`, an absent inventory establishes the baseline; if `false`,
387
388
  * an absent inventory refuses staging. Default: `false`.
389
+ * `transfers` lists the declared transfers the stage admits. Default: `SURFACE_TRANSFERS`.
388
390
  */
389
391
  export declare interface HostStageOptions {
390
392
  readonly inventory?: string;
391
393
  readonly establish?: boolean;
392
394
  readonly report?: (message: string) => void;
395
+ readonly transfers?: readonly SurfaceTransfer[];
393
396
  }
394
397
 
395
398
  /**
@@ -2322,8 +2325,8 @@ export declare class Materializer implements MaterializerInterface {
2322
2325
  *
2323
2326
  * @param checkout - The checkout the vendored paths are read from.
2324
2327
  * @param host - The vendored host root to fill; it must be absent or empty.
2325
- * @param options - The inventory selection, establishment switch, and reporting callback.
2326
- * Default: no reporting.
2328
+ * @param options - The inventory selection, establishment switch, reporting callback, and
2329
+ * declared transfers. Default: no reporting, and the transfers in `SURFACE_TRANSFERS`.
2327
2330
  * @returns One entry per staged file, sorted by storage name.
2328
2331
  * @throws `ScaffoldError('INVALID', …)` when either argument is not a host path
2329
2332
  * or a vendored path leaves the checkout or the host root.
@@ -2331,8 +2334,8 @@ export declare class Materializer implements MaterializerInterface {
2331
2334
  * host root is not vacant, the checkout does not carry every vendored path, two
2332
2335
  * vendored files claim one storage name, a vendored file is not a plain file
2333
2336
  * within the artifact ceiling, published guides are unreadable, a staged
2334
- * collision's owner set is not a subset of its published owner set, a
2335
- * `SURFACE_TRANSFERS` entry is spent because its keeper alone claims the name, the
2337
+ * collision's owner set is not a subset of its published owner set, a declared
2338
+ * transfer is spent because its keeper alone claims the name, the
2336
2339
  * inventory is absent without `establish: true`, or the staged manifest does not read back.
2337
2340
  * @throws `ScaffoldError('WRITE', …)` when a staged file or the manifest cannot
2338
2341
  * be written.
@@ -2369,10 +2372,11 @@ export declare class Materializer implements MaterializerInterface {
2369
2372
  * the canon and reference files for reading. Every catalog package must have a
2370
2373
  * guide in the discovered membership before the host is written.
2371
2374
  * Copied guides must carry no collision whose name and exact owner set the
2372
- * committed inventory lacks. A `SURFACE_TRANSFERS` entry that another guide claims
2373
- * admits its keeper beside the recorded owners, or beside the one owner of a name
2374
- * the inventory lacks, and the staged surface records that keeper whether or not
2375
- * its guide is mirrored. An absent inventory requires `establish: true`;
2375
+ * committed inventory lacks. A declared transfer that another guide claims admits
2376
+ * its keeper beside the recorded owners, or beside the one owner of a name the
2377
+ * inventory lacks, and the staged surface records that keeper whether or not its
2378
+ * guide is mirrored. `options.transfers` declares the transfers, and its default is
2379
+ * `SURFACE_TRANSFERS`. An absent inventory requires `establish: true`;
2376
2380
  * an inventory without a valid recorded Surface is refused.
2377
2381
  * Everything downstream — the missing-path refusal, the
2378
2382
  * storage collision guard, the sort, the digests, and the root inventory — reads
@@ -16,6 +16,7 @@ import type { Snapshot } from '@orkestrel/scaffold';
16
16
  import type { SurfaceCandidate } from '@orkestrel/scaffold';
17
17
  import type { SurfaceCollision } from '@orkestrel/scaffold';
18
18
  import type { SurfaceContract } from '@orkestrel/scaffold';
19
+ import type { SurfaceTransfer } from '@orkestrel/scaffold';
19
20
 
20
21
  /**
21
22
  * Matches the Git branch syntax the repository endpoint accepts.
@@ -385,11 +386,13 @@ export declare interface HostManifestEntry {
385
386
  * `inventory` is relative to the checkout. Default: `host.json`.
386
387
  * `establish`: if `true`, an absent inventory establishes the baseline; if `false`,
387
388
  * an absent inventory refuses staging. Default: `false`.
389
+ * `transfers` lists the declared transfers the stage admits. Default: `SURFACE_TRANSFERS`.
388
390
  */
389
391
  export declare interface HostStageOptions {
390
392
  readonly inventory?: string;
391
393
  readonly establish?: boolean;
392
394
  readonly report?: (message: string) => void;
395
+ readonly transfers?: readonly SurfaceTransfer[];
393
396
  }
394
397
 
395
398
  /**
@@ -2322,8 +2325,8 @@ export declare class Materializer implements MaterializerInterface {
2322
2325
  *
2323
2326
  * @param checkout - The checkout the vendored paths are read from.
2324
2327
  * @param host - The vendored host root to fill; it must be absent or empty.
2325
- * @param options - The inventory selection, establishment switch, and reporting callback.
2326
- * Default: no reporting.
2328
+ * @param options - The inventory selection, establishment switch, reporting callback, and
2329
+ * declared transfers. Default: no reporting, and the transfers in `SURFACE_TRANSFERS`.
2327
2330
  * @returns One entry per staged file, sorted by storage name.
2328
2331
  * @throws `ScaffoldError('INVALID', …)` when either argument is not a host path
2329
2332
  * or a vendored path leaves the checkout or the host root.
@@ -2331,8 +2334,8 @@ export declare class Materializer implements MaterializerInterface {
2331
2334
  * host root is not vacant, the checkout does not carry every vendored path, two
2332
2335
  * vendored files claim one storage name, a vendored file is not a plain file
2333
2336
  * within the artifact ceiling, published guides are unreadable, a staged
2334
- * collision's owner set is not a subset of its published owner set, a
2335
- * `SURFACE_TRANSFERS` entry is spent because its keeper alone claims the name, the
2337
+ * collision's owner set is not a subset of its published owner set, a declared
2338
+ * transfer is spent because its keeper alone claims the name, the
2336
2339
  * inventory is absent without `establish: true`, or the staged manifest does not read back.
2337
2340
  * @throws `ScaffoldError('WRITE', …)` when a staged file or the manifest cannot
2338
2341
  * be written.
@@ -2369,10 +2372,11 @@ export declare class Materializer implements MaterializerInterface {
2369
2372
  * the canon and reference files for reading. Every catalog package must have a
2370
2373
  * guide in the discovered membership before the host is written.
2371
2374
  * Copied guides must carry no collision whose name and exact owner set the
2372
- * committed inventory lacks. A `SURFACE_TRANSFERS` entry that another guide claims
2373
- * admits its keeper beside the recorded owners, or beside the one owner of a name
2374
- * the inventory lacks, and the staged surface records that keeper whether or not
2375
- * its guide is mirrored. An absent inventory requires `establish: true`;
2375
+ * committed inventory lacks. A declared transfer that another guide claims admits
2376
+ * its keeper beside the recorded owners, or beside the one owner of a name the
2377
+ * inventory lacks, and the staged surface records that keeper whether or not its
2378
+ * guide is mirrored. `options.transfers` declares the transfers, and its default is
2379
+ * `SURFACE_TRANSFERS`. An absent inventory requires `establish: true`;
2376
2380
  * an inventory without a valid recorded Surface is refused.
2377
2381
  * Everything downstream — the missing-path refusal, the
2378
2382
  * storage collision guard, the sort, the digests, and the root inventory — reads
@@ -1482,8 +1482,8 @@ function stageBytes(host, root, destinations) {
1482
1482
  *
1483
1483
  * @param checkout - The checkout the vendored paths are read from.
1484
1484
  * @param host - The vendored host root to fill; it must be absent or empty.
1485
- * @param options - The inventory selection, establishment switch, and reporting callback.
1486
- * Default: no reporting.
1485
+ * @param options - The inventory selection, establishment switch, reporting callback, and
1486
+ * declared transfers. Default: no reporting, and the transfers in `SURFACE_TRANSFERS`.
1487
1487
  * @returns One entry per staged file, sorted by storage name.
1488
1488
  * @throws `ScaffoldError('INVALID', …)` when either argument is not a host path
1489
1489
  * or a vendored path leaves the checkout or the host root.
@@ -1491,8 +1491,8 @@ function stageBytes(host, root, destinations) {
1491
1491
  * host root is not vacant, the checkout does not carry every vendored path, two
1492
1492
  * vendored files claim one storage name, a vendored file is not a plain file
1493
1493
  * within the artifact ceiling, published guides are unreadable, a staged
1494
- * collision's owner set is not a subset of its published owner set, a
1495
- * `SURFACE_TRANSFERS` entry is spent because its keeper alone claims the name, the
1494
+ * collision's owner set is not a subset of its published owner set, a declared
1495
+ * transfer is spent because its keeper alone claims the name, the
1496
1496
  * inventory is absent without `establish: true`, or the staged manifest does not read back.
1497
1497
  * @throws `ScaffoldError('WRITE', …)` when a staged file or the manifest cannot
1498
1498
  * be written.
@@ -1529,10 +1529,11 @@ function stageBytes(host, root, destinations) {
1529
1529
  * the canon and reference files for reading. Every catalog package must have a
1530
1530
  * guide in the discovered membership before the host is written.
1531
1531
  * Copied guides must carry no collision whose name and exact owner set the
1532
- * committed inventory lacks. A `SURFACE_TRANSFERS` entry that another guide claims
1533
- * admits its keeper beside the recorded owners, or beside the one owner of a name
1534
- * the inventory lacks, and the staged surface records that keeper whether or not
1535
- * its guide is mirrored. An absent inventory requires `establish: true`;
1532
+ * committed inventory lacks. A declared transfer that another guide claims admits
1533
+ * its keeper beside the recorded owners, or beside the one owner of a name the
1534
+ * inventory lacks, and the staged surface records that keeper whether or not its
1535
+ * guide is mirrored. `options.transfers` declares the transfers, and its default is
1536
+ * `SURFACE_TRANSFERS`. An absent inventory requires `establish: true`;
1536
1537
  * an inventory without a valid recorded Surface is refused.
1537
1538
  * Everything downstream — the missing-path refusal, the
1538
1539
  * storage collision guard, the sort, the digests, and the root inventory — reads
@@ -1678,7 +1679,7 @@ function stageHost(checkout, host, options) {
1678
1679
  name,
1679
1680
  owner
1680
1681
  }))), ({ name }) => name);
1681
- const transfers = SURFACE_TRANSFERS.map((transfer) => {
1682
+ const transfers = (options?.transfers ?? SURFACE_TRANSFERS).map((transfer) => {
1682
1683
  const owners = new Set(claimants.get(transfer.name)?.map(({ owner }) => owner));
1683
1684
  return {
1684
1685
  ...transfer,