@orkestrel/scaffold 0.0.108 → 0.0.110

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 (162) hide show
  1. package/dist/agents/skills/orkestrel-dispatch/scripts/bench.js +326 -91
  2. package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +110 -14
  3. package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +280 -0
  4. package/dist/agents/skills/orkestrel-dispatch/scripts/cite.js +188 -26
  5. package/dist/agents/skills/orkestrel-dispatch/scripts/launch.js +142 -43
  6. package/dist/agents/skills/orkestrel-dispatch/scripts/login.js +240 -62
  7. package/dist/agents/skills/orkestrel-dispatch/scripts/patch.js +323 -0
  8. package/dist/agents/skills/orkestrel-dispatch/scripts/result.js +169 -32
  9. package/dist/agents/skills/orkestrel-dispatch/scripts/sweep.js +290 -69
  10. package/dist/agents/skills/orkestrel-falsify/scripts/mutate.js +560 -0
  11. package/dist/agents/skills/orkestrel-harden/scripts/discovery.js +1052 -205
  12. package/dist/agents/skills/orkestrel-harden/scripts/measure.js +361 -0
  13. package/dist/agents/skills/orkestrel-harden/scripts/titles.js +455 -80
  14. package/dist/agents/skills/orkestrel-parallel/scripts/cases.js +327 -0
  15. package/dist/agents/skills/orkestrel-publish/scripts/compare.js +298 -51
  16. package/dist/agents/skills/orkestrel-publish/scripts/pins.js +170 -13
  17. package/dist/agents/skills/orkestrel-publish/scripts/swap.js +956 -191
  18. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +707 -112
  19. package/dist/agents/skills/orkestrel-publish/scripts/window.js +235 -41
  20. package/dist/agents/skills/orkestrel-scout/scripts/map.js +341 -54
  21. package/dist/agents/templates/brief.md +6 -2
  22. package/dist/bin/main.js +51 -46
  23. package/dist/bin/main.js.map +1 -1
  24. package/dist/host/AGENTS.md +23 -21
  25. package/dist/host/agents/orchestration.md +85 -54
  26. package/dist/host/agents/platforms/windows.md +8 -3
  27. package/dist/host/agents/skills/orkestrel-align/SKILL.md +10 -13
  28. package/dist/host/agents/skills/orkestrel-align/references/fleet.md +4 -10
  29. package/dist/host/agents/skills/orkestrel-align/references/integration.md +1 -1
  30. package/dist/host/agents/skills/orkestrel-build/SKILL.md +16 -48
  31. package/dist/host/agents/skills/orkestrel-build/agents/openai.yaml +1 -1
  32. package/dist/host/agents/skills/orkestrel-debrief/SKILL.md +19 -16
  33. package/dist/host/agents/skills/orkestrel-debrief/agents/openai.yaml +1 -1
  34. package/dist/host/agents/skills/orkestrel-debrief/references/field-testing.md +15 -28
  35. package/dist/host/agents/skills/orkestrel-debrief/references/instruction-audit.md +5 -6
  36. package/dist/host/agents/skills/orkestrel-debrief/references/retention.md +4 -6
  37. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +36 -25
  38. package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +4 -5
  39. package/dist/host/agents/skills/orkestrel-dispatch/scripts/bench.ts +366 -75
  40. package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +126 -16
  41. package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +323 -0
  42. package/dist/host/agents/skills/orkestrel-dispatch/scripts/cite.ts +220 -31
  43. package/dist/host/agents/skills/orkestrel-dispatch/scripts/launch.ts +176 -33
  44. package/dist/host/agents/skills/orkestrel-dispatch/scripts/login.ts +294 -59
  45. package/dist/host/agents/skills/orkestrel-dispatch/scripts/patch.ts +401 -0
  46. package/dist/host/agents/skills/orkestrel-dispatch/scripts/result.ts +199 -34
  47. package/dist/host/agents/skills/orkestrel-dispatch/scripts/sweep.ts +330 -69
  48. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +14 -12
  49. package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +2 -5
  50. package/dist/host/agents/skills/orkestrel-falsify/references/reconcile.md +2 -1
  51. package/dist/host/agents/skills/orkestrel-falsify/scripts/mutate.ts +701 -0
  52. package/dist/host/agents/skills/orkestrel-harden/SKILL.md +31 -24
  53. package/dist/host/agents/skills/orkestrel-harden/references/bindings.md +23 -81
  54. package/dist/host/agents/skills/orkestrel-harden/references/centralization.md +4 -5
  55. package/dist/host/agents/skills/orkestrel-harden/references/contract.md +2 -0
  56. package/dist/host/agents/skills/orkestrel-harden/references/document.md +33 -0
  57. package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +6 -3
  58. package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +34 -18
  59. package/dist/host/agents/skills/orkestrel-harden/references/research.md +2 -0
  60. package/dist/host/agents/skills/orkestrel-harden/scripts/discovery.ts +1272 -279
  61. package/dist/host/agents/skills/orkestrel-harden/scripts/measure.ts +425 -0
  62. package/dist/host/agents/skills/orkestrel-harden/scripts/titles.ts +603 -98
  63. package/dist/host/agents/skills/orkestrel-journey/SKILL.md +79 -98
  64. package/dist/host/agents/skills/orkestrel-journey/references/captures.md +54 -17
  65. package/dist/host/agents/skills/orkestrel-journey/references/decide.md +1 -20
  66. package/dist/host/agents/skills/orkestrel-journey/references/layer.md +21 -31
  67. package/dist/host/agents/skills/orkestrel-journey/references/styles.md +1 -1
  68. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +33 -29
  69. package/dist/host/agents/skills/orkestrel-parallel/references/claude.md +15 -13
  70. package/dist/host/agents/skills/orkestrel-parallel/references/cloud.md +28 -0
  71. package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +1 -0
  72. package/dist/host/agents/skills/orkestrel-parallel/references/cursor.md +13 -13
  73. package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +13 -13
  74. package/dist/host/agents/skills/orkestrel-parallel/scripts/cases.ts +389 -0
  75. package/dist/host/agents/skills/orkestrel-polish/SKILL.md +16 -20
  76. package/dist/host/agents/skills/orkestrel-polish/references/capture-harness.md +16 -26
  77. package/dist/host/agents/skills/orkestrel-publish/SKILL.md +12 -26
  78. package/dist/host/agents/skills/orkestrel-publish/agents/openai.yaml +2 -2
  79. package/dist/host/agents/skills/orkestrel-publish/references/adopt.md +23 -0
  80. package/dist/host/agents/skills/orkestrel-publish/references/release.md +4 -4
  81. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +13 -10
  82. package/dist/host/agents/skills/orkestrel-publish/references/window.md +21 -26
  83. package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +348 -59
  84. package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +202 -22
  85. package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +1061 -191
  86. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +812 -140
  87. package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +280 -38
  88. package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
  89. package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +428 -70
  90. package/dist/host/agents/templates/brief.md +6 -2
  91. package/dist/host/agents/transports/claude-cli.md +3 -3
  92. package/dist/host/agents/transports/codex.md +3 -8
  93. package/dist/host/agents/transports/cursor.md +2 -3
  94. package/dist/host/claude/AGENTS.md +2 -3
  95. package/dist/host/claude/agents/analyst.md +3 -3
  96. package/dist/host/claude/agents/astra.md +4 -4
  97. package/dist/host/claude/agents/builder.md +4 -3
  98. package/dist/host/claude/agents/checker.md +1 -1
  99. package/dist/host/claude/agents/distiller.md +1 -1
  100. package/dist/host/claude/agents/grok.md +1 -1
  101. package/dist/host/claude/agents/opus.md +3 -3
  102. package/dist/host/claude/agents/orkestrel.md +57 -90
  103. package/dist/host/claude/agents/researcher.md +1 -1
  104. package/dist/host/claude/agents/reviewer.md +6 -2
  105. package/dist/host/claude/agents/scout.md +1 -1
  106. package/dist/host/claude/agents/verifier.md +2 -2
  107. package/dist/host/claude/rules/application.md +14 -21
  108. package/dist/host/claude/rules/architecture.md +34 -44
  109. package/dist/host/claude/rules/browser.md +3 -4
  110. package/dist/host/claude/rules/campaign.md +3 -2
  111. package/dist/host/claude/rules/documentation.md +25 -12
  112. package/dist/host/claude/rules/names.md +9 -4
  113. package/dist/host/claude/rules/patterns.md +6 -7
  114. package/dist/host/claude/rules/portability.md +1 -1
  115. package/dist/host/claude/rules/quality.md +7 -6
  116. package/dist/host/claude/rules/styles.md +2 -2
  117. package/dist/host/claude/rules/tests.md +68 -115
  118. package/dist/host/claude/rules/typescript.md +7 -9
  119. package/dist/host/claude/rules/workspace.md +27 -26
  120. package/dist/host/claude/rules/writing.md +2 -5
  121. package/dist/host/claude/skills/orkestrel-dispatch/SKILL.md +1 -1
  122. package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
  123. package/dist/host/claude/skills/orkestrel-publish/SKILL.md +1 -1
  124. package/dist/host/claude/skills/orkestrel-scout/SKILL.md +1 -1
  125. package/dist/host/codex/agents/analyst.toml +9 -3
  126. package/dist/host/codex/agents/astra.toml +10 -7
  127. package/dist/host/codex/agents/builder.toml +4 -4
  128. package/dist/host/codex/agents/opus.toml +6 -6
  129. package/dist/host/codex/agents/orkestrel.toml +1 -1
  130. package/dist/host/codex/agents/researcher.toml +2 -2
  131. package/dist/host/codex/agents/reviewer.toml +2 -2
  132. package/dist/host/codex/agents/verifier.toml +4 -4
  133. package/dist/host/codex/config.toml +1 -1
  134. package/dist/host/configs/helpers.ts +21 -1
  135. package/dist/host/configs/policy.ts +299 -15
  136. package/dist/host/cursor/rules/orchestration.mdc +1 -1
  137. package/dist/host/dotfiles/oxlintrc.json +137 -3
  138. package/dist/host/guides/agent.md +111 -134
  139. package/dist/host/guides/capture.md +801 -0
  140. package/dist/host/guides/probe.md +27 -8
  141. package/dist/host/guides/scaffold.md +97 -19
  142. package/dist/host/guides/study.md +534 -440
  143. package/dist/host/guides/test.md +111 -44
  144. package/dist/host/manifest.json +170 -244
  145. package/dist/host/tests/config.test.ts +977 -187
  146. package/dist/host/tests/policy.test.ts +165 -1
  147. package/dist/host/tests/setupPolicy.ts +1246 -33
  148. package/dist/src/core/index.cjs +222 -90
  149. package/dist/src/core/index.cjs.map +1 -1
  150. package/dist/src/core/index.d.cts +126 -40
  151. package/dist/src/core/index.d.ts +126 -40
  152. package/dist/src/core/index.js +217 -89
  153. package/dist/src/core/index.js.map +1 -1
  154. package/dist/src/server/index.cjs +20 -27
  155. package/dist/src/server/index.cjs.map +1 -1
  156. package/dist/src/server/index.js +21 -28
  157. package/dist/src/server/index.js.map +1 -1
  158. package/package.json +11 -11
  159. package/dist/agents/skills/orkestrel-dispatch/scripts/helpers.js +0 -283
  160. package/dist/host/agents/skills/orkestrel-dispatch/references/bench.md +0 -25
  161. package/dist/host/agents/skills/orkestrel-dispatch/scripts/helpers.ts +0 -333
  162. package/dist/host/guides/supervisor.md +0 -4890
@@ -1,4 +1,4 @@
1
- import { existsSync, readdirSync, readFileSync, rmSync } from 'node:fs'
1
+ import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
2
2
  import { join } from 'node:path'
3
3
  import { describe, expect, it } from 'vitest'
4
4
  import { POLICY_BANNED_TERMS, POLICY_JUDGED_TERMS } from '../configs/policy.js'
@@ -10,11 +10,17 @@ import {
10
10
  createPolicySurfaceGuide,
11
11
  writePolicySurfaceHost,
12
12
  createSkillMetadata,
13
+ DIST_POLICY_CONTROLS,
14
+ DIST_POLICY_MESSAGE,
13
15
  inspectPolicyControl,
16
+ inspectPolicyDist,
14
17
  inspectPolicyFilenamePaths,
15
18
  inspectPolicyMirrorPaths,
16
19
  inspectPolicyMirrors,
17
20
  inspectPolicyPortability,
21
+ inspectPolicyShellPaths,
22
+ inspectPolicyShells,
23
+ inspectPolicyText,
18
24
  inspectPolicyWiring,
19
25
  inspectPolicyWorkspace,
20
26
  inspectSkillFamily,
@@ -56,6 +62,7 @@ import {
56
62
  SKILL_POLICY_PARAGRAPHS,
57
63
  SKILL_POLICY_TEXT,
58
64
  stemToPolicyCandidates,
65
+ TEXT_POLICY_CONTROLS,
59
66
  testToPolicyStem,
60
67
  } from './setupPolicy.js'
61
68
 
@@ -712,6 +719,140 @@ describe('portability policy', () => {
712
719
  ]),
713
720
  ).toEqual([])
714
721
  })
722
+
723
+ it('rejects a shell-family file outside scripts whatever its case, and a non-shell file inside it', () => {
724
+ expect(
725
+ inspectPolicyShellPaths([
726
+ 'src/run.sh',
727
+ 'tools/BUILD.PY',
728
+ 'scripts/probe.ts',
729
+ 'scripts/a/b.cmd',
730
+ ]),
731
+ ).toEqual([
732
+ {
733
+ rule: 'portability',
734
+ path: 'src/run.sh',
735
+ message: 'shell, PowerShell, Python, and batch files sit only in scripts',
736
+ },
737
+ {
738
+ rule: 'portability',
739
+ path: 'tools/BUILD.PY',
740
+ message: 'shell, PowerShell, Python, and batch files sit only in scripts',
741
+ },
742
+ {
743
+ rule: 'portability',
744
+ path: 'scripts/probe.ts',
745
+ message: 'scripts holds .sh files and nothing else',
746
+ },
747
+ {
748
+ rule: 'portability',
749
+ path: 'scripts/a/b.cmd',
750
+ message: 'scripts holds .sh files and nothing else',
751
+ },
752
+ ])
753
+ })
754
+
755
+ it('accepts a shell file at any depth inside scripts and every other file elsewhere', () => {
756
+ expect(
757
+ inspectPolicyShellPaths([
758
+ 'scripts/deps.sh',
759
+ 'scripts/DEPS.SH',
760
+ 'scripts/nested/hook.sh',
761
+ 'src/worker/helpers.ts',
762
+ 'package.json',
763
+ '.gitattributes',
764
+ 'build.shared.ts',
765
+ ]),
766
+ ).toEqual([])
767
+ })
768
+
769
+ it('reads files only: a directory named like a shell file or inside scripts is no violation', () => {
770
+ const scratch = createPolicyScratch({ prefix: 'orkestrel-policy-shells-' })
771
+ try {
772
+ scratch.write('src/tools.py/index.ts', 'export {}\n')
773
+ scratch.write('scripts/nested/deps.sh', '#!/usr/bin/env bash\n')
774
+ scratch.write('src/run.sh', '#!/usr/bin/env bash\n')
775
+ // The refused file arrives beside the directories, so an empty result elsewhere is a read
776
+ // that reached the population rather than one that found nothing.
777
+ expect(inspectPolicyShells(scratch.path)).toEqual([
778
+ {
779
+ rule: 'portability',
780
+ path: 'src/run.sh',
781
+ message: 'shell, PowerShell, Python, and batch files sit only in scripts',
782
+ },
783
+ ])
784
+ } finally {
785
+ scratch.destroy()
786
+ }
787
+ })
788
+ })
789
+
790
+ describe('dist import policy', () => {
791
+ for (const control of DIST_POLICY_CONTROLS) {
792
+ it(`${control.label} [membership: ${control.membership}]`, () => {
793
+ expect(
794
+ inspectPolicyControl(control).filter((violation) => violation.rule === 'dist'),
795
+ ).toEqual(control.violations)
796
+ })
797
+ }
798
+
799
+ // The valid file beside the broken one proves the sweep ran over the workspace and refused the
800
+ // file it could not read, rather than reporting nothing because it read nothing.
801
+ it('reports a file the parser refuses and still reads the files beside it', () => {
802
+ const scratch = createPolicyScratch({ prefix: 'orkestrel-policy-dist-' })
803
+ try {
804
+ scratch.write('src/core/valid.ts', "import '../../dist/src/core/index.js'\n")
805
+ scratch.write('src/core/broken.ts', 'export const = \n')
806
+ const violations = inspectPolicyDist(scratch.path)
807
+ expect(violations).toHaveLength(2)
808
+ expect(violations[0]).toMatchObject({ rule: 'dist', path: 'src/core/broken.ts' })
809
+ expect(violations[0]?.message.startsWith('tracked TypeScript parses: ')).toBe(true)
810
+ expect(violations[1]).toEqual({
811
+ rule: 'dist',
812
+ path: 'src/core/valid.ts',
813
+ message: `${DIST_POLICY_MESSAGE}: ../../dist/src/core/index.js`,
814
+ })
815
+ } finally {
816
+ scratch.destroy()
817
+ }
818
+ })
819
+
820
+ it('holds the tracked TypeScript of this workspace clear of dist', () => {
821
+ expect(inspectPolicyDist(process.cwd())).toEqual([])
822
+ })
823
+ })
824
+
825
+ describe('text integrity policy', () => {
826
+ for (const control of TEXT_POLICY_CONTROLS) {
827
+ it(`${control.label} [membership: ${control.membership}]`, () => {
828
+ expect(
829
+ inspectPolicyControl(control).filter((violation) => violation.rule === 'text'),
830
+ ).toEqual(control.violations)
831
+ })
832
+ }
833
+
834
+ // A text fixture is a JavaScript string and cannot hold a byte sequence UTF-8 never carries, so
835
+ // the bytes are written directly. The valid file beside the broken one proves the sweep ran
836
+ // over the workspace and refused one file rather than every file.
837
+ it('rejects a file whose bytes are not UTF-8 and accepts the same file once they are', () => {
838
+ const scratch = createPolicyScratch({ prefix: 'orkestrel-policy-text-' })
839
+ try {
840
+ mkdirSync(join(scratch.path, 'src'), { recursive: true })
841
+ writeFileSync(join(scratch.path, 'src', 'valid.ts'), Uint8Array.of(0x61, 0xc3, 0xa8, 0x0a))
842
+ writeFileSync(join(scratch.path, 'src', 'broken.ts'), Uint8Array.of(0x61, 0xc3, 0x28, 0x0a))
843
+ expect(inspectPolicyText(scratch.path)).toEqual([
844
+ { rule: 'text', path: 'src/broken.ts', message: 'text decodes as UTF-8' },
845
+ ])
846
+ writeFileSync(join(scratch.path, 'src', 'broken.ts'), Uint8Array.of(0x61, 0xc3, 0xa8, 0x0a))
847
+ expect(inspectPolicyText(scratch.path)).toEqual([])
848
+ } finally {
849
+ scratch.destroy()
850
+ }
851
+ })
852
+
853
+ it('holds the authored and source text of this workspace to clean UTF-8', () => {
854
+ expect(inspectPolicyText(process.cwd())).toEqual([])
855
+ })
715
856
  })
716
857
 
717
858
  describe('prose policy', () => {
@@ -893,6 +1034,29 @@ describe('policy configuration wiring', () => {
893
1034
  ])
894
1035
  })
895
1036
 
1037
+ it('counts a rule as enabled only at error severity, in the string or an array first member', () => {
1038
+ const configuration = {
1039
+ rules: { 'rule/top-off': 'off', 'rule/top-warn': ['warn'], 'rule/top-error': 'error' },
1040
+ overrides: [
1041
+ {
1042
+ files: ['a/**'],
1043
+ rules: { 'rule/scoped-off': 'off', 'rule/scoped-error': ['error', {}] },
1044
+ },
1045
+ ],
1046
+ }
1047
+ expect(
1048
+ inspectPolicyWiring(
1049
+ configuration,
1050
+ ['rule/top-off', 'rule/top-warn', 'rule/top-error', 'rule/scoped-off', 'rule/scoped-error'],
1051
+ [],
1052
+ ),
1053
+ ).toEqual(
1054
+ ['rule/top-off', 'rule/top-warn', 'rule/scoped-off'].map(
1055
+ (rule) => `${rule} is enabled by no top-level or override rules record`,
1056
+ ),
1057
+ )
1058
+ })
1059
+
896
1060
  it('reports a configuration that is not a record', () => {
897
1061
  expect(inspectPolicyWiring([], [], [])).toEqual(['Oxlint configuration must be a record'])
898
1062
  })