principles-disciple 1.71.0 → 1.73.0

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 (309) hide show
  1. package/openclaw.plugin.json +10 -5
  2. package/package.json +17 -19
  3. package/scripts/acceptance-test.mjs +16 -73
  4. package/scripts/sync-plugin.mjs +382 -77
  5. package/src/commands/archive-impl.ts +2 -1
  6. package/src/commands/capabilities.ts +2 -2
  7. package/src/commands/context.ts +2 -2
  8. package/src/commands/disable-impl.ts +2 -1
  9. package/src/commands/evolution-status.ts +16 -16
  10. package/src/commands/export.ts +12 -67
  11. package/src/commands/pain.ts +91 -1
  12. package/src/commands/principle-rollback.ts +2 -1
  13. package/src/commands/promote-impl.ts +7 -43
  14. package/src/commands/rollback-impl.ts +2 -1
  15. package/src/commands/rollback.ts +2 -1
  16. package/src/commands/samples.ts +2 -1
  17. package/src/commands/thinking-os.ts +2 -1
  18. package/src/config/errors.ts +18 -2
  19. package/src/constants/diagnostician.ts +2 -2
  20. package/src/constants/tools.ts +2 -1
  21. package/src/core/__tests__/focus-history.test.ts +210 -0
  22. package/src/core/config.ts +1 -1
  23. package/src/core/confirm-first-gate.ts +255 -0
  24. package/src/core/correction-cue-learner.ts +2 -136
  25. package/src/core/correction-types.ts +16 -88
  26. package/src/core/dictionary.ts +19 -20
  27. package/src/core/empathy-keyword-matcher.ts +17 -289
  28. package/src/core/empathy-types.ts +18 -229
  29. package/src/core/event-log.ts +38 -132
  30. package/src/core/evolution-reducer.ts +21 -2
  31. package/src/core/evolution-types.ts +76 -464
  32. package/src/core/file-store.ts +80 -0
  33. package/src/core/focus-history.ts +228 -955
  34. package/src/core/local-worker-routing.ts +34 -314
  35. package/src/core/merge-gate-audit.ts +0 -195
  36. package/src/core/pain-diagnostic-gate.ts +154 -0
  37. package/src/core/pain-signal.ts +21 -138
  38. package/src/core/pain.ts +15 -88
  39. package/src/core/pd-task-reconciler.ts +26 -115
  40. package/src/core/pd-task-service.ts +9 -9
  41. package/src/core/pd-task-types.ts +23 -127
  42. package/src/core/principle-compiler/__tests__/compiler-replay-gate.test.ts +174 -0
  43. package/src/core/principle-compiler/code-validator.ts +15 -42
  44. package/src/core/principle-compiler/compiler.ts +100 -15
  45. package/src/core/principle-compiler/index.ts +5 -2
  46. package/src/core/principle-compiler/template-generator.ts +4 -104
  47. package/src/core/principle-injection.ts +10 -202
  48. package/src/core/principle-internalization/filesystem-lifecycle-datasource.ts +42 -0
  49. package/src/core/principle-internalization/lifecycle-read-model.ts +39 -242
  50. package/src/core/principle-internalization/principle-lifecycle-service.ts +12 -10
  51. package/src/core/principle-tree-ledger-adapter.ts +145 -0
  52. package/src/core/principle-tree-ledger.ts +8 -6
  53. package/src/core/reflection/reflection-context.ts +14 -109
  54. package/src/core/replay-engine.ts +8 -500
  55. package/src/core/rule-host-helpers.ts +5 -35
  56. package/src/core/rule-host-types.ts +10 -82
  57. package/src/core/rule-host.ts +6 -63
  58. package/src/core/runtime-v2-prompt-activation-reader.ts +231 -0
  59. package/src/core/session-tracker.ts +87 -101
  60. package/src/core/shadow-observation-registry.ts +19 -48
  61. package/src/core/trajectory.ts +3 -1
  62. package/src/core/workflow-funnel-loader.ts +62 -68
  63. package/src/core/workspace-context.ts +46 -0
  64. package/src/core/workspace-dir-service.ts +1 -1
  65. package/src/core/workspace-dir-validation.ts +18 -9
  66. package/src/hooks/AGENTS.md +1 -1
  67. package/src/hooks/gate-block-helper.ts +46 -44
  68. package/src/hooks/gate.ts +207 -7
  69. package/src/hooks/lifecycle.ts +30 -32
  70. package/src/hooks/llm.ts +60 -32
  71. package/src/hooks/pain.ts +297 -103
  72. package/src/hooks/prompt.ts +469 -339
  73. package/src/hooks/subagent.ts +2 -29
  74. package/src/i18n/commands.ts +2 -10
  75. package/src/index.ts +95 -85
  76. package/src/openclaw-sdk.ts +311 -0
  77. package/src/service/central-database.ts +8 -4
  78. package/src/service/evolution-queue-migration.ts +2 -1
  79. package/src/service/evolution-worker.ts +163 -1786
  80. package/src/service/internalization-trigger-adapter.ts +302 -0
  81. package/src/service/keyword-optimization-service.ts +4 -4
  82. package/src/service/monitoring-query-service.ts +1 -215
  83. package/src/service/queue-io.ts +60 -331
  84. package/src/service/runtime-summary-service.ts +115 -18
  85. package/src/service/subagent-workflow/index.ts +0 -41
  86. package/src/service/subagent-workflow/types.ts +9 -120
  87. package/src/service/subagent-workflow/workflow-store.ts +2 -119
  88. package/src/service/workflow-watchdog.ts +0 -43
  89. package/src/types/event-payload.ts +16 -74
  90. package/src/types/event-types.ts +39 -547
  91. package/src/types/hygiene-types.ts +7 -30
  92. package/src/types/principle-tree-schema.ts +20 -222
  93. package/src/types/queue.ts +15 -70
  94. package/src/types/runtime-summary.ts +5 -49
  95. package/src/utils/io.ts +10 -0
  96. package/src/utils/retry.ts +1 -1
  97. package/src/utils/shadow-fingerprint.ts +2 -2
  98. package/src/utils/workspace-resolver.ts +50 -0
  99. package/templates/langs/en/core/AGENTS.md +2 -2
  100. package/templates/langs/en/core/BOOT.md +1 -1
  101. package/templates/langs/en/core/HEARTBEAT.md +2 -2
  102. package/templates/langs/en/skills/ai-sprint-orchestration/references/agent-registry.json +1 -72
  103. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json +6 -6
  104. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json +6 -6
  105. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json +2 -12
  106. package/templates/langs/en/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json +2 -12
  107. package/templates/langs/en/skills/ai-sprint-orchestration/runtime/.gitignore +2 -2
  108. package/templates/langs/en/skills/ai-sprint-orchestration/scripts/run.mjs +51 -15
  109. package/templates/langs/en/skills/evolve-task/SKILL.md +1 -1
  110. package/templates/langs/en/skills/pd-cli-operator/SKILL.md +67 -0
  111. package/templates/langs/en/skills/pd-diagnostician/SKILL.md +1 -1
  112. package/templates/langs/en/skills/pd-mentor/SKILL.md +1 -1
  113. package/templates/langs/en/skills/pd-pain-signal/SKILL.md +17 -39
  114. package/templates/langs/en/skills/pd-runtime-v2/SKILL.md +61 -0
  115. package/templates/langs/zh/core/AGENTS.md +2 -2
  116. package/templates/langs/zh/core/BOOT.md +1 -1
  117. package/templates/langs/zh/core/HEARTBEAT.md +2 -2
  118. package/templates/langs/zh/skills/ai-sprint-orchestration/references/agent-registry.json +1 -72
  119. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/bugfix-complex-template.json +6 -6
  120. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/feature-complex-template.json +6 -6
  121. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/nocturnal-trinity-quality-enhancement.json +8 -8
  122. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal-verify.json +2 -12
  123. package/templates/langs/zh/skills/ai-sprint-orchestration/references/specs/workflow-validation-minimal.json +2 -12
  124. package/templates/langs/zh/skills/ai-sprint-orchestration/runtime/.gitignore +2 -2
  125. package/templates/langs/zh/skills/ai-sprint-orchestration/scripts/run.mjs +51 -15
  126. package/templates/langs/zh/skills/ai-sprint-orchestration/test/run.test.mjs +21 -5
  127. package/templates/langs/zh/skills/evolve-task/SKILL.md +2 -2
  128. package/templates/langs/zh/skills/pd-cli-operator/SKILL.md +67 -0
  129. package/templates/langs/zh/skills/pd-diagnostician/SKILL.md +1 -1
  130. package/templates/langs/zh/skills/pd-mentor/SKILL.md +1 -1
  131. package/templates/langs/zh/skills/pd-pain-signal/SKILL.md +17 -38
  132. package/templates/langs/zh/skills/pd-runtime-v2/SKILL.md +61 -0
  133. package/tests/build-artifacts.test.ts +1 -3
  134. package/tests/commands/evolution-status.test.ts +0 -118
  135. package/tests/core/bootstrap-rules.test.ts +1 -1
  136. package/tests/core/config.test.ts +1 -1
  137. package/tests/core/event-log.test.ts +35 -0
  138. package/tests/core/evolution-engine.test.ts +610 -0
  139. package/tests/core/file-store.test.ts +102 -0
  140. package/tests/core/focus-history.test.ts +203 -11
  141. package/tests/core/merge-gate-audit.test.ts +2 -169
  142. package/tests/core/model-deployment-registry.test.ts +7 -1
  143. package/tests/core/model-training-registry.test.ts +19 -0
  144. package/tests/core/observability.test.ts +0 -1
  145. package/tests/core/pain-diagnostic-gate.test.ts +498 -0
  146. package/tests/core/pain.test.ts +0 -1
  147. package/tests/core/principle-internalization/deprecated-readiness.test.ts +2 -2
  148. package/tests/core/principle-internalization/lifecycle-metrics.test.ts +2 -2
  149. package/tests/core/principle-internalization/{internalization-routing-policy.test.ts → lifecycle-routing-policy.test.ts} +6 -6
  150. package/tests/core/principle-internalization/lineage-source-retired.test.ts +56 -0
  151. package/tests/core/principle-internalization/principle-lifecycle-service.test.ts +1 -23
  152. package/tests/core/principle-tree-ledger-adapter.test.ts +253 -0
  153. package/tests/core/reflection-context.test.ts +0 -14
  154. package/tests/core/replay-engine.test.ts +127 -215
  155. package/tests/core/rule-host-helpers.test.ts +2 -2
  156. package/tests/core/rule-implementation-runtime.test.ts +0 -27
  157. package/tests/core/workflow-funnel-loader.test.ts +162 -0
  158. package/tests/core/workspace-dir-validation.test.ts +8 -1
  159. package/tests/core-anti-growth.test.ts +192 -0
  160. package/tests/hook-workspace-nextaction-contract.test.ts +42 -0
  161. package/tests/hooks/confirm-first-gate.test.ts +333 -0
  162. package/tests/hooks/gate-auto-correct-shadow.test.ts +310 -0
  163. package/tests/hooks/gate-auto-correct.test.ts +665 -0
  164. package/tests/hooks/gate-rule-host-pipeline.test.ts +2 -1
  165. package/tests/hooks/pain.test.ts +269 -12
  166. package/tests/hooks/prompt-characterization.test.ts +500 -0
  167. package/tests/hooks/prompt-size-guard.test.ts +329 -0
  168. package/tests/hooks/runtime-v2-prompt-activation.test.ts +869 -0
  169. package/tests/index.test.ts +94 -1
  170. package/tests/integration/auto-entry-gate.test.ts +248 -0
  171. package/tests/integration/internalization-trigger-guard.test.ts +69 -0
  172. package/tests/integration/m8-legacy-paths.test.ts +63 -0
  173. package/tests/integration/runtime-v2-pain-guard.test.ts +125 -0
  174. package/tests/plugin-config-resolution-cutover.test.ts +359 -0
  175. package/tests/runtime-v2-discovery-guard.test.ts +154 -0
  176. package/tests/service/central-database.test.ts +457 -0
  177. package/tests/service/evolution-worker.correction-observer.test.ts +173 -0
  178. package/tests/service/evolution-worker.timeout.test.ts +11 -129
  179. package/tests/service/internalization-trigger-adapter.test.ts +251 -0
  180. package/tests/service/monitoring-query-service.test.ts +1 -47
  181. package/tests/service/queue-io.test.ts +1 -62
  182. package/tests/service/runtime-summary-service.test.ts +184 -3
  183. package/tests/service/workflow-watchdog.test.ts +0 -91
  184. package/tests/utils/file-lock.test.ts +5 -3
  185. package/tests/utils/session-key.test.ts +52 -0
  186. package/tests/utils/subagent-probe.test.ts +48 -1
  187. package/vitest.config.ts +4 -11
  188. package/.planning/codebase/ARCHITECTURE.md +0 -157
  189. package/.planning/codebase/CONCERNS.md +0 -145
  190. package/.planning/codebase/CONVENTIONS.md +0 -148
  191. package/.planning/codebase/INTEGRATIONS.md +0 -81
  192. package/.planning/codebase/STACK.md +0 -87
  193. package/.planning/codebase/STRUCTURE.md +0 -193
  194. package/.planning/codebase/TESTING.md +0 -243
  195. package/.planning/phases/01-basic-visualization/01-GAP-CLOSURE-VERIFICATION.md +0 -113
  196. package/docs/COMMAND_REFERENCE.md +0 -76
  197. package/docs/COMMAND_REFERENCE_EN.md +0 -79
  198. package/scripts/build-web.mjs +0 -46
  199. package/scripts/diagnose-nocturnal.mjs +0 -537
  200. package/scripts/seed-nocturnal-scenarios.mjs +0 -384
  201. package/src/commands/nocturnal-review.ts +0 -322
  202. package/src/commands/nocturnal-rollout.ts +0 -790
  203. package/src/commands/nocturnal-train.ts +0 -986
  204. package/src/commands/pd-reflect.ts +0 -88
  205. package/src/core/adaptive-thresholds.ts +0 -478
  206. package/src/core/diagnostician-task-store.ts +0 -192
  207. package/src/core/nocturnal-arbiter.ts +0 -715
  208. package/src/core/nocturnal-artifact-lineage.ts +0 -116
  209. package/src/core/nocturnal-artificer.ts +0 -257
  210. package/src/core/nocturnal-candidate-scoring.ts +0 -530
  211. package/src/core/nocturnal-compliance.ts +0 -1146
  212. package/src/core/nocturnal-dataset.ts +0 -763
  213. package/src/core/nocturnal-executability.ts +0 -428
  214. package/src/core/nocturnal-export.ts +0 -499
  215. package/src/core/nocturnal-paths.ts +0 -240
  216. package/src/core/nocturnal-reasoning-deriver.ts +0 -343
  217. package/src/core/nocturnal-rule-implementation-validator.ts +0 -246
  218. package/src/core/nocturnal-snapshot-contract.ts +0 -99
  219. package/src/core/nocturnal-trajectory-extractor.ts +0 -512
  220. package/src/core/nocturnal-trinity-types.ts +0 -218
  221. package/src/core/nocturnal-trinity.ts +0 -2680
  222. package/src/core/principle-internalization/deprecated-readiness.ts +0 -93
  223. package/src/core/principle-internalization/internalization-routing-policy.ts +0 -208
  224. package/src/core/principle-internalization/lifecycle-metrics.ts +0 -152
  225. package/src/http/principles-console-route.ts +0 -709
  226. package/src/service/central-health-service.ts +0 -49
  227. package/src/service/central-overview-service.ts +0 -138
  228. package/src/service/control-ui-query-service.ts +0 -900
  229. package/src/service/cooldown-strategy.ts +0 -97
  230. package/src/service/evolution-pain-context.ts +0 -79
  231. package/src/service/evolution-query-service.ts +0 -407
  232. package/src/service/health-query-service.ts +0 -1038
  233. package/src/service/nocturnal-config.ts +0 -214
  234. package/src/service/nocturnal-runtime.ts +0 -734
  235. package/src/service/nocturnal-service.ts +0 -1605
  236. package/src/service/nocturnal-target-selector.ts +0 -545
  237. package/src/service/sleep-cycle.ts +0 -157
  238. package/src/service/startup-reconciler.ts +0 -112
  239. package/src/service/subagent-workflow/correction-observer-types.ts +0 -82
  240. package/src/service/subagent-workflow/correction-observer-workflow-manager.ts +0 -250
  241. package/src/service/subagent-workflow/deep-reflect-workflow-manager.ts +0 -1
  242. package/src/service/subagent-workflow/dynamic-timeout.ts +0 -30
  243. package/src/service/subagent-workflow/empathy-observer-workflow-manager.ts +0 -268
  244. package/src/service/subagent-workflow/nocturnal-workflow-manager.ts +0 -795
  245. package/src/service/subagent-workflow/runtime-direct-driver.ts +0 -268
  246. package/src/service/subagent-workflow/workflow-manager-base.ts +0 -580
  247. package/src/tools/write-pain-flag.ts +0 -215
  248. package/tests/commands/nocturnal-review.test.ts +0 -448
  249. package/tests/commands/nocturnal-train.test.ts +0 -97
  250. package/tests/commands/pd-reflect.test.ts +0 -49
  251. package/tests/core/adaptive-thresholds.test.ts +0 -261
  252. package/tests/core/nocturnal-arbiter.test.ts +0 -559
  253. package/tests/core/nocturnal-artifact-lineage.test.ts +0 -53
  254. package/tests/core/nocturnal-artificer.test.ts +0 -241
  255. package/tests/core/nocturnal-candidate-scoring.test.ts +0 -532
  256. package/tests/core/nocturnal-compliance-p-principles.test.ts +0 -133
  257. package/tests/core/nocturnal-compliance.test.ts +0 -646
  258. package/tests/core/nocturnal-dataset.test.ts +0 -892
  259. package/tests/core/nocturnal-e2e.test.ts +0 -234
  260. package/tests/core/nocturnal-executability.test.ts +0 -357
  261. package/tests/core/nocturnal-export.test.ts +0 -517
  262. package/tests/core/nocturnal-reasoning-deriver.test.ts +0 -372
  263. package/tests/core/nocturnal-reviewed-subset-comparison.test.ts +0 -428
  264. package/tests/core/nocturnal-rule-implementation-validator.test.ts +0 -127
  265. package/tests/core/nocturnal-snapshot-contract.test.ts +0 -121
  266. package/tests/core/nocturnal-trajectory-extractor.test.ts +0 -634
  267. package/tests/core/nocturnal-trinity.test.ts +0 -2053
  268. package/tests/core/pain-auto-repair.test.ts +0 -96
  269. package/tests/core/pain-integration.test.ts +0 -510
  270. package/tests/fixtures/nocturnal-reviewed-subset.json +0 -183
  271. package/tests/http/principles-console-route.test.ts +0 -162
  272. package/tests/integration/chaos-resilience.test.ts +0 -348
  273. package/tests/integration/empathy-workflow-integration.test.ts +0 -626
  274. package/tests/integration/pain-diagnostician-loop.e2e.test.ts +0 -380
  275. package/tests/service/control-ui-query-service.test.ts +0 -121
  276. package/tests/service/cooldown-strategy.test.ts +0 -164
  277. package/tests/service/data-endpoints-regression.test.ts +0 -834
  278. package/tests/service/empathy-observer-workflow-manager.test.ts +0 -175
  279. package/tests/service/evolution-worker.nocturnal.test.ts +0 -601
  280. package/tests/service/nocturnal-runtime-hardening.test.ts +0 -118
  281. package/tests/service/nocturnal-runtime.test.ts +0 -473
  282. package/tests/service/nocturnal-service-code-candidate.test.ts +0 -330
  283. package/tests/service/nocturnal-target-selector.test.ts +0 -615
  284. package/tests/service/startup-reconciler.test.ts +0 -148
  285. package/tests/tools/write-pain-flag.test.ts +0 -358
  286. package/ui/src/App.tsx +0 -45
  287. package/ui/src/api.ts +0 -220
  288. package/ui/src/charts.tsx +0 -955
  289. package/ui/src/components/ErrorState.tsx +0 -6
  290. package/ui/src/components/Loading.tsx +0 -13
  291. package/ui/src/components/ProtectedRoute.tsx +0 -12
  292. package/ui/src/components/Shell.tsx +0 -91
  293. package/ui/src/components/WorkspaceConfig.tsx +0 -178
  294. package/ui/src/components/index.ts +0 -5
  295. package/ui/src/context/auth.tsx +0 -80
  296. package/ui/src/context/theme.tsx +0 -66
  297. package/ui/src/hooks/useAutoRefresh.ts +0 -39
  298. package/ui/src/i18n/ui.ts +0 -473
  299. package/ui/src/main.tsx +0 -16
  300. package/ui/src/pages/EvolutionPage.tsx +0 -333
  301. package/ui/src/pages/FeedbackPage.tsx +0 -138
  302. package/ui/src/pages/GateMonitorPage.tsx +0 -136
  303. package/ui/src/pages/LoginPage.tsx +0 -89
  304. package/ui/src/pages/OverviewPage.tsx +0 -599
  305. package/ui/src/pages/SamplesPage.tsx +0 -174
  306. package/ui/src/pages/ThinkingModelsPage.tsx +0 -702
  307. package/ui/src/styles.css +0 -2020
  308. package/ui/src/types.ts +0 -384
  309. package/ui/src/utils/format.ts +0 -15
@@ -3,75 +3,13 @@ import * as os from 'os';
3
3
  import * as path from 'path';
4
4
  import { afterEach, beforeEach, describe, expect, it } from 'vitest';
5
5
  import { ReplayEngine } from '../../src/core/replay-engine.js';
6
- import { TrajectoryDatabase, TrajectoryRegistry } from '../../src/core/trajectory.js';
7
- import { registerSample } from '../../src/core/nocturnal-dataset.js';
8
6
  import { createImplementationAssetDir, getImplementationAssetRoot } from '../../src/core/code-implementation-storage.js';
9
- import { saveLedger, type LedgerPrinciple, type LedgerRule } from '../../src/core/principle-tree-ledger.js';
10
- import type { Implementation } from '../../src/types/principle-tree-schema.js';
11
7
  import { safeRmDir } from '../test-utils.js';
12
8
 
13
- function makePrinciple(): LedgerPrinciple {
14
- return {
15
- id: 'P-1',
16
- version: 1,
17
- text: 'Protect risky writes without READY plans',
18
- triggerPattern: 'write',
19
- action: 'require approval before risky write',
20
- status: 'active',
21
- priority: 'P1',
22
- scope: 'general',
23
- evaluability: 'deterministic',
24
- valueScore: 0,
25
- adherenceRate: 0,
26
- painPreventedCount: 0,
27
- derivedFromPainIds: [],
28
- ruleIds: ['R-1'],
29
- conflictsWithPrincipleIds: [],
30
- createdAt: '2026-04-08T00:00:00.000Z',
31
- updatedAt: '2026-04-08T00:00:00.000Z',
32
- };
33
- }
34
-
35
- function makeRule(): LedgerRule {
36
- return {
37
- id: 'R-1',
38
- version: 1,
39
- name: 'Require approval for risky writes',
40
- description: 'Risky write operations without a READY plan need approval.',
41
- type: 'gate',
42
- triggerCondition: 'tool=write',
43
- enforcement: 'block',
44
- action: 'require approval for risky write',
45
- principleId: 'P-1',
46
- status: 'implemented',
47
- coverageRate: 0,
48
- falsePositiveRate: 0,
49
- implementationIds: ['IMPL-1'],
50
- createdAt: '2026-04-08T00:00:00.000Z',
51
- updatedAt: '2026-04-08T00:00:00.000Z',
52
- };
53
- }
54
-
55
- function makeImplementation(): Implementation {
56
- return {
57
- id: 'IMPL-1',
58
- ruleId: 'R-1',
59
- type: 'code',
60
- path: path.join('virtual', 'IMPL-1.js'),
61
- version: '1.0.0',
62
- coversCondition: 'risky write',
63
- coveragePercentage: 100,
64
- lifecycleState: 'candidate',
65
- createdAt: '2026-04-08T00:00:00.000Z',
66
- updatedAt: '2026-04-08T00:00:00.000Z',
67
- };
68
- }
69
-
70
9
  describe('ReplayEngine', () => {
71
10
  let tempDir: string;
72
11
  let workspaceDir: string;
73
12
  let stateDir: string;
74
- let trajectory: TrajectoryDatabase;
75
13
 
76
14
  beforeEach(() => {
77
15
  tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pd-replay-engine-'));
@@ -79,175 +17,149 @@ describe('ReplayEngine', () => {
79
17
  stateDir = path.join(tempDir, '.state');
80
18
  fs.mkdirSync(workspaceDir, { recursive: true });
81
19
  fs.mkdirSync(stateDir, { recursive: true });
82
- fs.writeFileSync(
83
- path.join(workspaceDir, 'PROFILE.json'),
84
- JSON.stringify({ risk_paths: ['src/**'] }, null, 2),
85
- 'utf-8',
86
- );
87
- trajectory = new TrajectoryDatabase({ workspaceDir });
88
20
  });
89
21
 
90
22
  afterEach(() => {
91
- try {
92
- trajectory.dispose();
93
- } catch {
94
- // Best effort cleanup.
95
- }
96
- try {
97
- TrajectoryRegistry.dispose(workspaceDir);
98
- } catch {
99
- // Best effort cleanup.
100
- }
101
23
  safeRmDir(tempDir);
102
24
  });
103
25
 
104
- function seedLedgerAndImplementation(): void {
105
- saveLedger(stateDir, {
106
- trainingStore: {
107
- 'P-1': {
108
- principleId: 'P-1',
109
- evaluability: 'deterministic',
110
- applicableOpportunityCount: 1,
111
- observedViolationCount: 0,
112
- complianceRate: 1,
113
- violationTrend: 0,
114
- generatedSampleCount: 0,
115
- approvedSampleCount: 0,
116
- includedTrainRunIds: [],
117
- deployedCheckpointIds: [],
118
- internalizationStatus: 'internalized',
119
- },
26
+ it('listReports returns empty array when no replays exist', () => {
27
+ const engine = new ReplayEngine(workspaceDir, stateDir);
28
+ expect(engine.listReports('IMPL-1')).toEqual([]);
29
+ });
30
+
31
+ it('listReports returns persisted replay reports sorted by name descending', () => {
32
+ createImplementationAssetDir(stateDir, 'IMPL-1', '1.0.0');
33
+ const replayDir = path.join(getImplementationAssetRoot(stateDir, 'IMPL-1'), 'replays');
34
+ fs.mkdirSync(replayDir, { recursive: true });
35
+
36
+ const report1 = {
37
+ implementationId: 'IMPL-1',
38
+ generatedAt: '2026-04-08T00:00:00.000Z',
39
+ overallDecision: 'needs-review',
40
+ blockers: [],
41
+ sampleFingerprints: [],
42
+ replayResults: {
43
+ painNegative: { total: 0, passed: 0, failed: 0, details: [] },
44
+ successPositive: { total: 0, passed: 0, failed: 0, details: [] },
45
+ principleAnchor: { total: 0, passed: 0, failed: 0, details: [] },
120
46
  },
121
- tree: {
122
- principles: { 'P-1': makePrinciple() },
123
- rules: { 'R-1': makeRule() },
124
- implementations: { 'IMPL-1': makeImplementation() },
125
- metrics: {},
126
- lastUpdated: '2026-04-08T00:00:00.000Z',
47
+ evidenceSummary: {
48
+ evidenceStatus: 'empty',
49
+ totalSamples: 0,
50
+ classifiedCounts: { painNegative: 0, successPositive: 0, principleAnchor: 0 },
127
51
  },
128
- });
129
-
130
- createImplementationAssetDir(stateDir, 'IMPL-1', '1.0.0', {
131
- entrySource: [
132
- 'export const meta = {',
133
- ' name: "risky-write-guard",',
134
- ' version: "1.0.0",',
135
- ' ruleId: "R-1",',
136
- ' coversCondition: "risky write",',
137
- '};',
138
- 'export function evaluate(input, helpers) {',
139
- " if (helpers.isRiskPath() && helpers.getToolName() === 'write' && helpers.getPlanStatus() !== 'READY') {",
140
- " return { decision: 'requireApproval', matched: true, reason: 'plan required' };",
141
- ' }',
142
- " return { decision: 'allow', matched: false, reason: 'not-applicable' };",
143
- '}',
144
- ].join('\n'),
145
- });
146
- }
147
-
148
- function seedPainNegativeSample(): void {
149
- trajectory.recordSession({
150
- sessionId: 'session-1',
151
- startedAt: '2026-04-08T00:00:00.000Z',
152
- });
153
- trajectory.recordToolCall({
154
- sessionId: 'session-1',
155
- toolName: 'write',
156
- outcome: 'blocked',
157
- errorMessage: 'risky write requires approval',
158
- paramsJson: { filePath: 'src/app.ts' },
159
- createdAt: '2026-04-08T00:01:00.000Z',
160
- });
161
- trajectory.recordPainEvent({
162
- sessionId: 'session-1',
163
- source: 'gate',
164
- score: 75,
165
- reason: 'risky write requires approval',
166
- createdAt: '2026-04-08T00:01:01.000Z',
167
- });
168
- trajectory.recordGateBlock({
169
- sessionId: 'session-1',
170
- toolName: 'write',
171
- filePath: 'src/app.ts',
172
- reason: 'risky write requires approval',
173
- planStatus: 'NONE',
174
- createdAt: '2026-04-08T00:01:02.000Z',
175
- });
176
-
177
- const artifactPath = path.join(stateDir, 'nocturnal', 'samples', 'artifact-1.json');
178
- fs.mkdirSync(path.dirname(artifactPath), { recursive: true });
179
- fs.writeFileSync(
180
- artifactPath,
181
- JSON.stringify(
182
- {
183
- artifactId: 'artifact-1',
184
- sessionId: 'session-1',
185
- principleId: 'P-1',
186
- sourceSnapshotRef: 'snapshot-session-1',
187
- badDecision: 'Retried the write without checking approval requirements',
188
- betterDecision: 'Check the approval requirements before writing',
189
- rationale: 'Riskiest paths should not be written without a plan',
190
- createdAt: '2026-04-08T00:02:00.000Z',
191
- },
192
- null,
193
- 2,
194
- ),
195
- 'utf-8',
196
- );
197
-
198
- registerSample(
199
- workspaceDir,
200
- {
201
- artifactId: 'artifact-1',
202
- sessionId: 'session-1',
203
- principleId: 'P-1',
204
- sourceSnapshotRef: 'snapshot-session-1',
205
- badDecision: 'Retried the write without checking approval requirements',
206
- betterDecision: 'Check the approval requirements before writing',
207
- rationale: 'Riskiest paths should not be written without a plan',
208
- createdAt: '2026-04-08T00:02:00.000Z',
52
+ };
53
+
54
+ const report2 = {
55
+ ...report1,
56
+ generatedAt: '2026-04-09T00:00:00.000Z',
57
+ overallDecision: 'pass',
58
+ };
59
+
60
+ fs.writeFileSync(path.join(replayDir, '2026-04-08T00-00-00-000Z.json'), JSON.stringify(report1, null, 2), 'utf-8');
61
+ fs.writeFileSync(path.join(replayDir, '2026-04-09T00-00-00-000Z.json'), JSON.stringify(report2, null, 2), 'utf-8');
62
+
63
+ const engine = new ReplayEngine(workspaceDir, stateDir);
64
+ const reports = engine.listReports('IMPL-1');
65
+
66
+ expect(reports).toHaveLength(2);
67
+ expect(reports[0].overallDecision).toBe('pass');
68
+ expect(reports[1].overallDecision).toBe('needs-review');
69
+ });
70
+
71
+ it('getLatestReport returns the most recent report', () => {
72
+ createImplementationAssetDir(stateDir, 'IMPL-1', '1.0.0');
73
+ const replayDir = path.join(getImplementationAssetRoot(stateDir, 'IMPL-1'), 'replays');
74
+ fs.mkdirSync(replayDir, { recursive: true });
75
+
76
+ const report = {
77
+ implementationId: 'IMPL-1',
78
+ generatedAt: '2026-04-08T00:00:00.000Z',
79
+ overallDecision: 'pass',
80
+ blockers: [],
81
+ sampleFingerprints: [],
82
+ replayResults: {
83
+ painNegative: { total: 1, passed: 1, failed: 0, details: [] },
84
+ successPositive: { total: 0, passed: 0, failed: 0, details: [] },
85
+ principleAnchor: { total: 0, passed: 0, failed: 0, details: [] },
86
+ },
87
+ evidenceSummary: {
88
+ evidenceStatus: 'observed',
89
+ totalSamples: 1,
90
+ classifiedCounts: { painNegative: 1, successPositive: 0, principleAnchor: 0 },
209
91
  },
210
- artifactPath,
211
- null,
212
- 'pain-negative',
213
- );
214
- }
92
+ };
215
93
 
216
- it('persists replay reports under the implementation asset root', () => {
217
- seedLedgerAndImplementation();
218
- seedPainNegativeSample();
94
+ fs.writeFileSync(path.join(replayDir, '2026-04-08T00-00-00-000Z.json'), JSON.stringify(report, null, 2), 'utf-8');
219
95
 
220
96
  const engine = new ReplayEngine(workspaceDir, stateDir);
221
- const report = engine.runReplayForImplementation('IMPL-1', ['pain-negative']);
222
-
223
- expect(report.overallDecision).toBe('pass');
224
- expect(report.replayResults.painNegative.passed).toBe(1);
225
- expect(report.replayResults.painNegative.failed).toBe(0);
226
-
227
- const reportDir = path.join(
228
- getImplementationAssetRoot(stateDir, 'IMPL-1'),
229
- 'replays',
230
- );
231
- expect(fs.existsSync(reportDir)).toBe(true);
232
- expect(fs.readdirSync(reportDir).some((file) => file.endsWith('.json'))).toBe(true);
97
+ const latest = engine.getLatestReport('IMPL-1');
98
+
99
+ expect(latest).not.toBeNull();
100
+ expect(latest!.overallDecision).toBe('pass');
233
101
  });
234
102
 
235
- it('marks empty replay evidence as needs-review instead of pass', () => {
236
- seedLedgerAndImplementation();
103
+ it('getLatestReport returns null when no reports exist', () => {
104
+ const engine = new ReplayEngine(workspaceDir, stateDir);
105
+ expect(engine.getLatestReport('IMPL-1')).toBeNull();
106
+ });
107
+
108
+ it('hasPassingReport returns true when a passing report exists', () => {
109
+ createImplementationAssetDir(stateDir, 'IMPL-1', '1.0.0');
110
+ const replayDir = path.join(getImplementationAssetRoot(stateDir, 'IMPL-1'), 'replays');
111
+ fs.mkdirSync(replayDir, { recursive: true });
112
+
113
+ const report = {
114
+ implementationId: 'IMPL-1',
115
+ generatedAt: '2026-04-08T00:00:00.000Z',
116
+ overallDecision: 'pass',
117
+ blockers: [],
118
+ sampleFingerprints: [],
119
+ replayResults: {
120
+ painNegative: { total: 1, passed: 1, failed: 0, details: [] },
121
+ successPositive: { total: 0, passed: 0, failed: 0, details: [] },
122
+ principleAnchor: { total: 0, passed: 0, failed: 0, details: [] },
123
+ },
124
+ evidenceSummary: {
125
+ evidenceStatus: 'observed',
126
+ totalSamples: 1,
127
+ classifiedCounts: { painNegative: 1, successPositive: 0, principleAnchor: 0 },
128
+ },
129
+ };
130
+
131
+ fs.writeFileSync(path.join(replayDir, '2026-04-08T00-00-00-000Z.json'), JSON.stringify(report, null, 2), 'utf-8');
237
132
 
238
133
  const engine = new ReplayEngine(workspaceDir, stateDir);
239
- const report = engine.runReplayForImplementation('IMPL-1', ['pain-negative']);
240
-
241
- expect(report.overallDecision).toBe('needs-review');
242
- expect(report.evidenceSummary).toEqual({
243
- evidenceStatus: 'empty',
244
- totalSamples: 0,
245
- classifiedCounts: {
246
- painNegative: 0,
247
- successPositive: 0,
248
- principleAnchor: 0,
134
+ expect(engine.hasPassingReport('IMPL-1')).toBe(true);
135
+ });
136
+
137
+ it('hasPassingReport returns false when no passing report exists', () => {
138
+ createImplementationAssetDir(stateDir, 'IMPL-1', '1.0.0');
139
+ const replayDir = path.join(getImplementationAssetRoot(stateDir, 'IMPL-1'), 'replays');
140
+ fs.mkdirSync(replayDir, { recursive: true });
141
+
142
+ const report = {
143
+ implementationId: 'IMPL-1',
144
+ generatedAt: '2026-04-08T00:00:00.000Z',
145
+ overallDecision: 'needs-review',
146
+ blockers: ['NO REPLAY EVIDENCE'],
147
+ sampleFingerprints: [],
148
+ replayResults: {
149
+ painNegative: { total: 0, passed: 0, failed: 0, details: [] },
150
+ successPositive: { total: 0, passed: 0, failed: 0, details: [] },
151
+ principleAnchor: { total: 0, passed: 0, failed: 0, details: [] },
152
+ },
153
+ evidenceSummary: {
154
+ evidenceStatus: 'empty',
155
+ totalSamples: 0,
156
+ classifiedCounts: { painNegative: 0, successPositive: 0, principleAnchor: 0 },
249
157
  },
250
- });
251
- expect(report.blockers[0]).toContain('NO REPLAY EVIDENCE');
158
+ };
159
+
160
+ fs.writeFileSync(path.join(replayDir, '2026-04-08T00-00-00-000Z.json'), JSON.stringify(report, null, 2), 'utf-8');
161
+
162
+ const engine = new ReplayEngine(workspaceDir, stateDir);
163
+ expect(engine.hasPassingReport('IMPL-1')).toBe(false);
252
164
  });
253
165
  });
@@ -101,7 +101,7 @@ describe('createRuleHostHelpers', () => {
101
101
  const helpers = createRuleHostHelpers(makeInput({
102
102
  evolution: { epTier: 4 },
103
103
  }));
104
- expect(helpers.getCurrentEpiTier()).toBe(4);
104
+ expect(helpers.getEpTier()).toBe(4);
105
105
  });
106
106
 
107
107
  it('all helpers should be pure functions with no side effects', () => {
@@ -115,6 +115,6 @@ describe('createRuleHostHelpers', () => {
115
115
  expect(helpers.getBashRisk()).toBe(helpers.getBashRisk());
116
116
  expect(helpers.hasPlanFile()).toBe(helpers.hasPlanFile());
117
117
  expect(helpers.getPlanStatus()).toBe(helpers.getPlanStatus());
118
- expect(helpers.getCurrentEpiTier()).toBe(helpers.getCurrentEpiTier());
118
+ expect(helpers.getEpTier()).toBe(helpers.getEpTier());
119
119
  });
120
120
  });
@@ -1,6 +1,5 @@
1
1
  import { describe, expect, it } from 'vitest';
2
2
  import { loadRuleImplementationModule } from '../../src/core/rule-implementation-runtime.js';
3
- import { validateRuleImplementationCandidate } from '../../src/core/nocturnal-rule-implementation-validator.js';
4
3
 
5
4
  describe('rule-implementation-runtime', () => {
6
5
  it('does not leak global mutations from loaded rule implementations into the host realm', () => {
@@ -35,30 +34,4 @@ describe('rule-implementation-runtime', () => {
35
34
 
36
35
  expect((globalThis as Record<string, unknown>).__pdRuleHostLeak).toBeUndefined();
37
36
  });
38
-
39
- it('keeps validator execution isolated from the host global object', () => {
40
- delete (globalThis as Record<string, unknown>).__pdValidatorLeak;
41
-
42
- const result = validateRuleImplementationCandidate(`
43
- globalThis.__pdValidatorLeak = 'sandbox-only';
44
- export const meta = {
45
- name: 'validator-leak-check',
46
- version: '1.0.0',
47
- ruleId: 'R-VAL',
48
- coversCondition: 'validator isolation'
49
- };
50
-
51
- export function evaluate() {
52
- globalThis.__pdValidatorLeak = 'still-sandboxed';
53
- return {
54
- decision: 'allow',
55
- matched: false,
56
- reason: 'ok'
57
- };
58
- }
59
- `);
60
-
61
- expect(result.passed).toBe(true);
62
- expect((globalThis as Record<string, unknown>).__pdValidatorLeak).toBeUndefined();
63
- });
64
37
  });
@@ -863,4 +863,166 @@ funnels:
863
863
  expect(typeof stage1.statsField).toBe('string');
864
864
  });
865
865
  });
866
+
867
+ // ─────────────────────────────────────────────────────────────────────────────
868
+ // POLICY-01: Funnel and stage policy fields
869
+ // Extended schema: timeoutMs, successCriteria, legacyDisabled, observability
870
+ // ─────────────────────────────────────────────────────────────────────────────
871
+ describe('POLICY-01: funnel and stage policy fields', () => {
872
+ it('should load funnel with policy fields', () => {
873
+ const yamlPath = path.join(tempDir, 'workflows.yaml');
874
+ fs.writeFileSync(yamlPath, `
875
+ version: "1.0"
876
+ funnels:
877
+ - workflowId: "pd-runtime-v2-diagnosis"
878
+ policy:
879
+ timeoutMs: 600000
880
+ stageOrder: "strict"
881
+ legacyDisabled: false
882
+ observability:
883
+ enabled: true
884
+ emitEvents: ["stage_entered", "stage_exited"]
885
+ logLevel: "debug"
886
+ stages:
887
+ - name: "pain_detected"
888
+ eventType: "pain_detected"
889
+ eventCategory: "created"
890
+ statsField: "diagnostic.painDetected"
891
+ - name: "task_created"
892
+ eventType: "task_created"
893
+ eventCategory: "created"
894
+ statsField: "diagnostic.taskCreated"
895
+ timeoutMs: 300000
896
+ legacyDisabled: false
897
+ `, 'utf-8');
898
+
899
+ const loader = new WorkflowFunnelLoader(tempDir);
900
+ const funnel = loader.getFunnel('pd-runtime-v2-diagnosis');
901
+
902
+ expect(funnel).toBeDefined();
903
+ expect(funnel!.policy).toBeDefined();
904
+ expect(funnel!.policy!.timeoutMs).toBe(600000);
905
+ expect(funnel!.policy!.stageOrder).toBe('strict');
906
+ expect(funnel!.policy!.legacyDisabled).toBe(false);
907
+ expect(funnel!.policy!.observability!.enabled).toBe(true);
908
+ expect(funnel!.policy!.observability!.emitEvents).toEqual(['stage_entered', 'stage_exited']);
909
+ expect(funnel!.policy!.observability!.logLevel).toBe('debug');
910
+ });
911
+
912
+ it('should load stage-level policy fields', () => {
913
+ const yamlPath = path.join(tempDir, 'workflows.yaml');
914
+ fs.writeFileSync(yamlPath, `
915
+ version: "1.0"
916
+ funnels:
917
+ - workflowId: "policy-stage-test"
918
+ stages:
919
+ - name: "custom_stage"
920
+ eventType: "custom_event"
921
+ eventCategory: "completed"
922
+ statsField: "test.custom"
923
+ timeoutMs: 900000
924
+ successCriteria: "artifact.committed"
925
+ legacyDisabled: true
926
+ observability:
927
+ enabled: false
928
+ emitEvents: []
929
+ `, 'utf-8');
930
+
931
+ const loader = new WorkflowFunnelLoader(tempDir);
932
+ const stages = loader.getStages('policy-stage-test');
933
+
934
+ expect(stages).toHaveLength(1);
935
+ expect(stages[0].timeoutMs).toBe(900000);
936
+ expect(stages[0].successCriteria).toBe('artifact.committed');
937
+ expect(stages[0].legacyDisabled).toBe(true);
938
+ expect(stages[0].observability!.enabled).toBe(false);
939
+ });
940
+
941
+ it('should return stages without policy fields (backward compatible)', () => {
942
+ const yamlPath = path.join(tempDir, 'workflows.yaml');
943
+ fs.writeFileSync(yamlPath, `
944
+ version: "1.0"
945
+ funnels:
946
+ - workflowId: "backward_compat"
947
+ stages:
948
+ - name: "plain_stage"
949
+ eventType: "plain_event"
950
+ eventCategory: "completed"
951
+ statsField: "test.plain"
952
+ `, 'utf-8');
953
+
954
+ const loader = new WorkflowFunnelLoader(tempDir);
955
+ const stages = loader.getStages('backward_compat');
956
+
957
+ expect(stages).toHaveLength(1);
958
+ expect(stages[0].timeoutMs).toBeUndefined();
959
+ expect(stages[0].successCriteria).toBeUndefined();
960
+ expect(stages[0].legacyDisabled).toBeUndefined();
961
+ expect(stages[0].observability).toBeUndefined();
962
+ });
963
+
964
+ it('getAllFunnelsWithPolicy returns all funnels with policy', () => {
965
+ const yamlPath = path.join(tempDir, 'workflows.yaml');
966
+ fs.writeFileSync(yamlPath, `
967
+ version: "1.0"
968
+ funnels:
969
+ - workflowId: "funnel_a"
970
+ policy:
971
+ timeoutMs: 600000
972
+ stages:
973
+ - name: "s1"
974
+ eventType: "e1"
975
+ eventCategory: "c"
976
+ statsField: "f.f1"
977
+ - workflowId: "funnel_b"
978
+ stages:
979
+ - name: "s2"
980
+ eventType: "e2"
981
+ eventCategory: "c"
982
+ statsField: "f.f2"
983
+ `, 'utf-8');
984
+
985
+ const loader = new WorkflowFunnelLoader(tempDir);
986
+ const all = loader.getAllFunnelsWithPolicy();
987
+
988
+ expect(all.get('funnel_a')!.policy!.timeoutMs).toBe(600000);
989
+ expect(all.get('funnel_b')!.policy).toBeUndefined();
990
+ });
991
+
992
+ it('getFunnel returns undefined for unknown workflowId', () => {
993
+ const yamlPath = path.join(tempDir, 'workflows.yaml');
994
+ fs.writeFileSync(yamlPath, `
995
+ version: "1.0"
996
+ funnels: []
997
+ `, 'utf-8');
998
+
999
+ const loader = new WorkflowFunnelLoader(tempDir);
1000
+ expect(loader.getFunnel('nonexistent')).toBeUndefined();
1001
+ });
1002
+
1003
+ it('getFunnel returns shallow clone (mutation isolation)', () => {
1004
+ const yamlPath = path.join(tempDir, 'workflows.yaml');
1005
+ fs.writeFileSync(yamlPath, `
1006
+ version: "1.0"
1007
+ funnels:
1008
+ - workflowId: "mutation_test"
1009
+ policy:
1010
+ timeoutMs: 600000
1011
+ stages:
1012
+ - name: "stage_one"
1013
+ eventType: "e1"
1014
+ eventCategory: "c"
1015
+ statsField: "f.f1"
1016
+ `, 'utf-8');
1017
+
1018
+ const loader = new WorkflowFunnelLoader(tempDir);
1019
+ const funnel1 = loader.getFunnel('mutation_test')!;
1020
+ funnel1.policy!.timeoutMs = 999;
1021
+ funnel1.stages[0].name = 'MUTATED';
1022
+
1023
+ const funnel2 = loader.getFunnel('mutation_test')!;
1024
+ expect(funnel2.policy!.timeoutMs).toBe(600000);
1025
+ expect(funnel2.stages[0].name).toBe('stage_one');
1026
+ });
1027
+ });
866
1028
  });
@@ -13,10 +13,17 @@ describe('validateWorkspaceDir', () => {
13
13
  it('rejects home directory and root-like paths', () => {
14
14
  expect(validateWorkspaceDir(homeDir)).toContain('home directory');
15
15
  expect(validateWorkspaceDir(`${homeDir}/`)).toContain('home directory');
16
- expect(validateWorkspaceDir('/')).toContain('root or empty');
16
+ const slashResult = validateWorkspaceDir('/');
17
+ expect(slashResult && (slashResult.includes('root') || slashResult.includes('drive root'))).toBe(true);
17
18
  expect(validateWorkspaceDir('')).toContain('undefined/null');
18
19
  });
19
20
 
21
+ it('rejects Windows drive root paths', () => {
22
+ expect(validateWorkspaceDir('C:\\')).toContain('drive root');
23
+ expect(validateWorkspaceDir('D:\\')).toContain('drive root');
24
+ expect(validateWorkspaceDir('c:\\')).toContain('drive root');
25
+ });
26
+
20
27
  it('accepts normal workspace paths', () => {
21
28
  expect(validateWorkspaceDir('/home/user/projects/workspace-main')).toBeNull();
22
29
  expect(validateWorkspaceDir('/tmp/test-workspace')).toBeNull();