@orkestrel/scaffold 0.0.113 → 0.0.115

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 (94) hide show
  1. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +83 -16
  2. package/dist/bin/main.js +71 -23
  3. package/dist/bin/main.js.map +1 -1
  4. package/dist/host/agents/orchestration.md +5 -3
  5. package/dist/host/agents/platforms/windows.md +1 -0
  6. package/dist/host/agents/skills/orkestrel-align/references/integration.md +1 -1
  7. package/dist/host/agents/skills/orkestrel-debrief/SKILL.md +4 -4
  8. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +4 -1
  9. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +8 -2
  10. package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +1 -0
  11. package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +1 -1
  12. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -1
  13. package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +1 -0
  14. package/dist/host/agents/skills/orkestrel-publish/SKILL.md +7 -7
  15. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +31 -11
  16. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +150 -49
  17. package/dist/host/claude/agents/analyst.md +1 -1
  18. package/dist/host/claude/agents/astra.md +2 -2
  19. package/dist/host/claude/agents/builder.md +4 -4
  20. package/dist/host/claude/agents/opus.md +3 -3
  21. package/dist/host/claude/agents/orkestrel.md +57 -59
  22. package/dist/host/claude/agents/planner.md +8 -2
  23. package/dist/host/claude/rules/campaign.md +2 -1
  24. package/dist/host/claude/rules/documentation.md +1 -0
  25. package/dist/host/claude/rules/tests.md +13 -8
  26. package/dist/host/claude/rules/workspace.md +28 -28
  27. package/dist/host/claude/rules/writing.md +1 -0
  28. package/dist/host/claude/skills/enterprise-bootstrap/SKILL.md +1 -2
  29. package/dist/host/claude/skills/orkestrel-align/SKILL.md +1 -1
  30. package/dist/host/claude/skills/orkestrel-build/SKILL.md +1 -2
  31. package/dist/host/claude/skills/orkestrel-debrief/SKILL.md +1 -2
  32. package/dist/host/claude/skills/orkestrel-dispatch/SKILL.md +1 -1
  33. package/dist/host/claude/skills/orkestrel-falsify/SKILL.md +1 -1
  34. package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
  35. package/dist/host/claude/skills/orkestrel-journey/SKILL.md +1 -1
  36. package/dist/host/claude/skills/orkestrel-parallel/SKILL.md +1 -1
  37. package/dist/host/claude/skills/orkestrel-polish/SKILL.md +1 -2
  38. package/dist/host/claude/skills/orkestrel-publish/SKILL.md +1 -2
  39. package/dist/host/claude/skills/orkestrel-scout/SKILL.md +1 -1
  40. package/dist/host/codex/agents/analyst.toml +8 -5
  41. package/dist/host/codex/agents/astra.toml +4 -5
  42. package/dist/host/codex/agents/builder.toml +5 -5
  43. package/dist/host/codex/agents/opus.toml +3 -4
  44. package/dist/host/codex/agents/orkestrel.toml +2 -1
  45. package/dist/host/codex/agents/planner.toml +8 -5
  46. package/dist/host/codex/agents/reviewer.toml +5 -4
  47. package/dist/host/guides/agent.md +13 -13
  48. package/dist/host/guides/brief.md +4 -0
  49. package/dist/host/guides/browser.md +162 -44
  50. package/dist/host/guides/budget.md +1 -1
  51. package/dist/host/guides/capture.md +4 -0
  52. package/dist/host/guides/console.md +13 -0
  53. package/dist/host/guides/contract.md +38 -3
  54. package/dist/host/guides/csv.md +5 -0
  55. package/dist/host/guides/database.md +58 -8
  56. package/dist/host/guides/form.md +17 -0
  57. package/dist/host/guides/guide.md +36 -33
  58. package/dist/host/guides/html.md +72 -44
  59. package/dist/host/guides/indexeddb.md +4 -0
  60. package/dist/host/guides/lsp.md +49 -8
  61. package/dist/host/guides/markdown.md +146 -1
  62. package/dist/host/guides/mcp.md +117 -22
  63. package/dist/host/guides/middleware.md +194 -26
  64. package/dist/host/guides/msg.md +9 -5
  65. package/dist/host/guides/pool.md +8 -1
  66. package/dist/host/guides/probe.md +13 -1
  67. package/dist/host/guides/process.md +102 -90
  68. package/dist/host/guides/program.md +4 -0
  69. package/dist/host/guides/qualifier.md +4 -0
  70. package/dist/host/guides/rater.md +4 -0
  71. package/dist/host/guides/reason.md +6 -4
  72. package/dist/host/guides/relation.md +4 -0
  73. package/dist/host/guides/scaffold.md +32 -14
  74. package/dist/host/guides/server.md +29 -13
  75. package/dist/host/guides/sqlite.md +6 -0
  76. package/dist/host/guides/sse.md +6 -0
  77. package/dist/host/guides/study.md +473 -473
  78. package/dist/host/guides/table.md +3 -0
  79. package/dist/host/guides/template.md +3 -0
  80. package/dist/host/guides/test.md +38 -20
  81. package/dist/host/guides/tool.md +3 -0
  82. package/dist/host/guides/toolbox.md +21 -0
  83. package/dist/host/guides/websocket.md +3 -1
  84. package/dist/host/guides/workflow.md +103 -11
  85. package/dist/host/guides/workspace.md +4 -0
  86. package/dist/host/manifest.json +84 -84
  87. package/dist/host/tests/config.test.ts +7 -13
  88. package/dist/src/core/index.cjs +20 -28
  89. package/dist/src/core/index.cjs.map +1 -1
  90. package/dist/src/core/index.d.cts +7 -7
  91. package/dist/src/core/index.d.ts +7 -7
  92. package/dist/src/core/index.js +20 -28
  93. package/dist/src/core/index.js.map +1 -1
  94. package/package.json +12 -12
@@ -1496,24 +1496,18 @@ describe('root configuration', () => {
1496
1496
  expect(typeof publish === 'string' && publish.includes('npm run test:service')).toBe(
1497
1497
  hasService && manifestPublishes,
1498
1498
  )
1499
- // The study proof spawns processes, so it follows the same split as the live-service proof:
1500
- // the publish gate of a publishing workspace runs it after `npm test` and before the release
1501
- // proof, and a private workspace reaches it from `test`.
1502
1499
  expect(studies).toBe(
1503
1500
  hasStudies
1504
1501
  ? 'vitest run --config vite.config.ts --no-cache --reporter=dot --project studies'
1505
1502
  : undefined,
1506
1503
  )
1507
- expect(typeof test === 'string' && test.includes('npm run test:studies')).toBe(
1508
- hasStudies && !manifestPublishes,
1509
- )
1510
- expect(typeof publish === 'string' && publish.includes('npm run test:studies')).toBe(
1511
- hasStudies && manifestPublishes,
1512
- )
1513
- const steps = ['npm test &&', 'npm run test:studies', 'npm run test:distribution']
1514
- const positions = typeof publish === 'string' ? steps.map((step) => publish.indexOf(step)) : []
1515
- const sequenced = positions.every((position, index) => position > (positions[index - 1] ?? -1))
1516
- expect(sequenced || !(hasStudies && hasDistribution && manifestPublishes)).toBe(true)
1504
+ for (const [name, command] of Object.entries(scripts)) {
1505
+ if (name === 'test:studies') continue
1506
+ expect(
1507
+ typeof command === 'string' &&
1508
+ (command.includes('npm run test:studies') || command.includes('--project studies')),
1509
+ ).toBe(false)
1510
+ }
1517
1511
  })
1518
1512
 
1519
1513
  it('rebuilds publishing workspaces before packing', () => {
@@ -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.113",
7
+ version: "0.0.115",
8
8
  description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
9
9
  keywords: [
10
10
  "audit",
@@ -95,20 +95,20 @@ var package_default = {
95
95
  "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"
96
96
  },
97
97
  dependencies: {
98
- "@orkestrel/console": "^0.0.16",
99
- "@orkestrel/contract": "^0.0.19",
100
- "@orkestrel/emitter": "^0.0.12",
101
- "@orkestrel/markdown": "^0.0.17",
102
- "@orkestrel/process": "^0.0.15",
103
- "@orkestrel/template": "^0.0.10"
98
+ "@orkestrel/console": "^0.0.17",
99
+ "@orkestrel/contract": "^0.0.20",
100
+ "@orkestrel/emitter": "^0.0.13",
101
+ "@orkestrel/markdown": "^0.0.18",
102
+ "@orkestrel/process": "^0.0.16",
103
+ "@orkestrel/template": "^0.0.11"
104
104
  },
105
105
  devDependencies: {
106
106
  "@microsoft/api-extractor": "^7.60.0",
107
- "@orkestrel/browser": "^0.0.29",
108
- "@orkestrel/guide": "^0.0.25",
109
- "@orkestrel/html": "^0.0.12",
110
- "@orkestrel/probe": "^0.0.25",
111
- "@orkestrel/test": "^0.0.30",
107
+ "@orkestrel/browser": "^0.0.30",
108
+ "@orkestrel/guide": "^0.0.26",
109
+ "@orkestrel/html": "^0.0.13",
110
+ "@orkestrel/probe": "^0.0.26",
111
+ "@orkestrel/test": "^0.0.31",
112
112
  "@types/node": "^24.19.2",
113
113
  "@vitest/browser-playwright": "^5.0.5",
114
114
  "oxfmt": "^0.75.0",
@@ -1612,9 +1612,7 @@ export function service(override?: UserConfig): UserConfig {
1612
1612
  return mergeOverride(project, override)
1613
1613
  }
1614
1614
  `,
1615
- studies: `// The @orkestrel/study engine drives these proofs, running installed packages through bounded
1616
- // subprocesses and protocol fixtures, so this project is isolated in its own gate script,
1617
- // test:studies.
1615
+ studies: `// Run these @orkestrel/study proofs on demand with npm run test:studies; no gate or chain runs them.
1618
1616
  export function studies(override?: UserConfig): UserConfig {
1619
1617
  const project: UserConfig = {
1620
1618
  resolve,
@@ -6960,12 +6958,13 @@ function replaceManifestOverride(manifest, path, range) {
6960
6958
  * proofs every workspace can pass before it has a public API, and one build per
6961
6959
  * target that actually builds.
6962
6960
  *
6963
- * A publishing workspace isolates its distribution, study, and live-service proofs
6961
+ * A publishing workspace isolates its distribution and live-service proofs
6964
6962
  * from `test` and runs them from `prepublishOnly` instead. Publishing is what
6965
6963
  * selects the distribution proof: what that proof measures is the packed tarball,
6966
6964
  * so a workspace that packs no published source has nothing for it to read. A
6967
- * private workspace therefore omits it and runs a study proof and a live-service
6968
- * proof from `test`, the study proof first.
6965
+ * private workspace therefore omits it and runs a live-service proof from `test`.
6966
+ * Study proofs run on demand through `test:studies` in either workspace; no gate
6967
+ * or chain runs them.
6969
6968
  * Integration and conformance stay in `test` because they neither pack nor
6970
6969
  * install the workspace and drive no external service. A conformance run may
6971
6970
  * start a server, but it starts its own and reaches it over loopback, so the run
@@ -7045,7 +7044,6 @@ function blueprintToScripts(blueprint) {
7045
7044
  ...blueprint.conformance ? ["npm run test:conformance"] : [],
7046
7045
  ...blueprint.tree ? ["npm run test:tree"] : [],
7047
7046
  ...integrates ? ["npm run test:integration"] : [],
7048
- ...!publishes && blueprint.studies ? ["npm run test:studies"] : [],
7049
7047
  ...!publishes && blueprint.service ? ["npm run test:service"] : []
7050
7048
  ].join(" && "),
7051
7049
  ...compiles ? {
@@ -7129,7 +7127,6 @@ function blueprintToScripts(blueprint) {
7129
7127
  "npm run format:check && npm run lint:check && npm run check && npm run build",
7130
7128
  ...blueprint.showcase && blueprint.app.includes("browser") ? ["npm run build:showcase", ...application.map((name) => `npm run build:showcase:${name}`)] : [],
7131
7129
  "npm test",
7132
- ...blueprint.studies ? ["npm run test:studies"] : [],
7133
7130
  RELEASE_PROOF_COMMAND,
7134
7131
  ...blueprint.service ? ["npm run test:service"] : []
7135
7132
  ].join(" && ")
@@ -7160,9 +7157,8 @@ function blueprintToScripts(blueprint) {
7160
7157
  * `probe` project through `vitest bench`, before the dedicated bench project
7161
7158
  * existed. The pack hook accepts the build chain emitted before it
7162
7159
  * delegated to `build`. The publication hook accepts the same gate chain without
7163
- * {@link RELEASE_PROOF_COMMAND}. A workspace carrying studies also accepts the
7164
- * chain without its study step and the chain without both its study step and
7165
- * the release proof. The value being written is always writable, so
7160
+ * {@link RELEASE_PROOF_COMMAND}. No accepted publication chain carries a study
7161
+ * step. The value being written is always writable, so
7166
7162
  * it is not repeated there. Any other value is a script the workspace author
7167
7163
  * customized, and {@link replaceManifestScripts} retains it while writing the
7168
7164
  * other named scripts independently.
@@ -7204,11 +7200,7 @@ function blueprintToWritableScripts(blueprint) {
7204
7200
  ...prepublish === void 0 || unreleased === void 0 ? [] : [{
7205
7201
  name: "prepublishOnly",
7206
7202
  command: prepublish,
7207
- accepted: blueprint.studies ? [
7208
- unreleased,
7209
- prepublish.replace(" && npm run test:studies", ""),
7210
- unreleased.replace(" && npm run test:studies", "")
7211
- ] : [unreleased]
7203
+ accepted: [unreleased]
7212
7204
  }]
7213
7205
  ];
7214
7206
  }