nccgs 2.1.1 → 3.0.0-rc.2

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 (705) hide show
  1. package/CHANGELOG.md +76 -235
  2. package/LICENSE +1 -1
  3. package/README.md +87 -206
  4. package/THIRD_PARTY_NOTICES.md +6 -34
  5. package/bin/nccgs.mjs +96 -0
  6. package/cli/doctor.mjs +82 -0
  7. package/cli/feedback.mjs +13 -0
  8. package/cli/install.mjs +111 -0
  9. package/cli/release.mjs +59 -0
  10. package/cli/run.mjs +35 -0
  11. package/cli/spawn.mjs +20 -0
  12. package/cli/uninstall.mjs +43 -0
  13. package/cli/update-check.mjs +66 -0
  14. package/docs/EVIDENCE-VERIFICATION.md +22 -0
  15. package/package.json +23 -30
  16. package/runtime/core/diag.mjs +43 -0
  17. package/runtime/core/feedback-policy.mjs +54 -0
  18. package/runtime/core/fs.mjs +80 -0
  19. package/runtime/core/job-object.mjs +73 -0
  20. package/runtime/core/modes.mjs +87 -0
  21. package/runtime/core/process-tree.mjs +109 -0
  22. package/runtime/core/project.mjs +113 -0
  23. package/runtime/core/snapshot.mjs +114 -0
  24. package/runtime/hooks/common.mjs +22 -0
  25. package/runtime/hooks/done-guard.mjs +15 -0
  26. package/runtime/hooks/guard-mcp.mjs +8 -0
  27. package/runtime/hooks/guard-shell.mjs +16 -0
  28. package/runtime/hooks/guard-write.mjs +25 -0
  29. package/runtime/hooks/session-log.mjs +7 -0
  30. package/runtime/hooks/session-start.mjs +40 -0
  31. package/runtime/hooks/unity-transport.mjs +12 -0
  32. package/runtime/modes.json +39 -0
  33. package/runtime/task/cost.mjs +103 -0
  34. package/runtime/task/criteria.mjs +128 -0
  35. package/runtime/task/feedback.mjs +136 -0
  36. package/runtime/task/ledger.mjs +109 -0
  37. package/runtime/task/plan.mjs +69 -0
  38. package/runtime/task/project.mjs +79 -0
  39. package/runtime/task/report.mjs +252 -0
  40. package/runtime/task/task.mjs +238 -0
  41. package/runtime/unity/assets.mjs +51 -0
  42. package/runtime/unity/playtest.mjs +145 -0
  43. package/runtime/unity/unity.mjs +350 -0
  44. package/scripts/check-job-object.mjs +18 -0
  45. package/scripts/sync-unity-skills.mjs +35 -119
  46. package/template/CLAUDE.md +39 -0
  47. package/template/agents/fast-fix.md +9 -0
  48. package/template/agents/implementer.md +19 -0
  49. package/template/agents/playtester.md +15 -0
  50. package/template/agents/reviewer.md +19 -0
  51. package/template/agents/scout.md +9 -0
  52. package/template/ponytail/README.md +8 -0
  53. package/{.claude/nccgs/packages → template}/ponytail/engineering.md +10 -0
  54. package/template/protocols/evidence.md +52 -0
  55. package/template/protocols/playtest.md +45 -0
  56. package/template/protocols/review.md +34 -0
  57. package/template/protocols/unity-cli-notes.md +56 -0
  58. package/template/settings.fragment.json +33 -0
  59. package/template/skills/art-bible/SKILL.md +19 -0
  60. package/template/skills/asset-spec/SKILL.md +19 -0
  61. package/template/skills/brainstorm/SKILL.md +17 -0
  62. package/template/skills/feedback/SKILL.md +16 -0
  63. package/template/skills/map-systems/SKILL.md +25 -0
  64. package/template/skills/playtest/SKILL.md +17 -0
  65. package/template/skills/status/SKILL.md +18 -0
  66. package/template/skills/test/SKILL.md +34 -0
  67. package/template/skills/unity-foundation/SKILL.md +17 -0
  68. package/template/skills/vertical-slice/SKILL.md +17 -0
  69. package/template/skills/work/SKILL.md +65 -0
  70. package/tools/feedback-worker/README.md +12 -0
  71. package/tools/feedback-worker/worker.js +39 -0
  72. package/tools/feedback-worker/wrangler.toml +12 -0
  73. package/unity-skills/2d-pixel-perfect/SKILL.md +208 -0
  74. package/unity-skills/2d-pixel-perfect/references/api-reference.md +81 -0
  75. package/unity-skills/2d-pixel-perfect/references/camera-setup-builtin.cs +40 -0
  76. package/unity-skills/2d-pixel-perfect/references/camera-setup-urp.cs +49 -0
  77. package/unity-skills/2d-pixel-perfect/references/pipeline-detection.cs +50 -0
  78. package/unity-skills/2d-pixel-perfect/references/sprite-settings.cs +37 -0
  79. package/unity-skills/asset-transformer-toolkit/SECURITY.md +15 -0
  80. package/unity-skills/asset-transformer-toolkit/SKILL.md +39 -0
  81. package/unity-skills/asset-transformer-toolkit/references/create-importer.md +121 -0
  82. package/unity-skills/asset-transformer-toolkit/references/lods.md +61 -0
  83. package/unity-skills/asset-transformer-toolkit/references/rule-api.md +154 -0
  84. package/unity-skills/asset-transformer-toolkit/references/ruleblock-api.md +37 -0
  85. package/unity-skills/asset-transformer-toolkit/references/ruleset-api.md +138 -0
  86. package/unity-skills/asset-transformer-toolkit/references/rulesets-and-actions.md +227 -0
  87. package/unity-skills/audio-setup-mixers/SECURITY.md +16 -0
  88. package/unity-skills/audio-setup-mixers/SKILL.md +127 -0
  89. package/unity-skills/audio-setup-mixers/references/api.md +162 -0
  90. package/unity-skills/build-gtk/SKILL.md +242 -0
  91. package/unity-skills/build-gtk/references/graph-api.md +324 -0
  92. package/unity-skills/build-gtk/references/pitfalls.md +86 -0
  93. package/unity-skills/build-gtk/references/runtime-and-visualization.md +196 -0
  94. package/unity-skills/build-gtk/references/state-machine-api.md +286 -0
  95. package/unity-skills/build-live-game/SKILL.md +255 -0
  96. package/{.claude/skills → unity-skills}/build-live-game/references/achievements.md +132 -154
  97. package/{.claude/skills → unity-skills}/build-live-game/references/apis.md +10 -19
  98. package/{.claude/skills → unity-skills}/build-live-game/references/authentication.md +14 -20
  99. package/{.claude/skills → unity-skills}/build-live-game/references/battlepass.md +269 -225
  100. package/unity-skills/build-live-game/references/blueprints-and-samples.md +75 -0
  101. package/unity-skills/build-live-game/references/cloud-code-cloudbehaviours.md +1111 -0
  102. package/unity-skills/build-live-game/references/cloud-code-modules.md +1276 -0
  103. package/unity-skills/build-live-game/references/cloud-code.md +58 -0
  104. package/{.claude/skills → unity-skills}/build-live-game/references/cloud-save.md +15 -25
  105. package/{.claude/skills → unity-skills}/build-live-game/references/deployment.md +33 -18
  106. package/{.claude/skills → unity-skills}/build-live-game/references/player-account.md +31 -23
  107. package/{.claude/skills → unity-skills}/build-live-game/references/tooling.md +0 -56
  108. package/unity-skills/build-live-game/references/ugs-cli.md +86 -0
  109. package/unity-skills/craft-game-floors/SECURITY.md +23 -0
  110. package/unity-skills/craft-game-floors/SKILL.md +134 -0
  111. package/unity-skills/craft-game-floors/references/art-direction.md +85 -0
  112. package/unity-skills/craft-game-floors/references/camera-rigs.md +51 -0
  113. package/unity-skills/craft-game-floors/references/character-motion.md +35 -0
  114. package/unity-skills/craft-game-floors/references/game-audio.md +47 -0
  115. package/unity-skills/craft-game-floors/references/game-feel.md +68 -0
  116. package/unity-skills/craft-game-floors/references/game-shell.md +45 -0
  117. package/unity-skills/craft-game-floors/references/live-floor.md +35 -0
  118. package/unity-skills/craft-game-floors/references/placeholder-assets.md +35 -0
  119. package/unity-skills/craft-game-floors/references/scene-lighting.md +52 -0
  120. package/unity-skills/craft-game-floors/references/toon-shading.md +34 -0
  121. package/unity-skills/craft-game-floors/references/vfx.md +40 -0
  122. package/unity-skills/craft-game-floors/references/visual-scorecard.md +43 -0
  123. package/unity-skills/create-2d-physics/SECURITY.md +16 -0
  124. package/unity-skills/create-2d-physics/SKILL.md +128 -0
  125. package/unity-skills/create-2d-physics/references/2d-physics-core.md +155 -0
  126. package/unity-skills/create-2d-physics/references/legacy-2d-physics.md +45 -0
  127. package/unity-skills/create-tile-palette-or-rule-tiles/SKILL.md +12 -0
  128. package/unity-skills/create-tile-palette-or-rule-tiles/references/hexagonalruletile.md +71 -0
  129. package/unity-skills/create-tile-palette-or-rule-tiles/references/palette-create.md +38 -0
  130. package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile-createempty.md +35 -0
  131. package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile-createfromsegment.md +212 -0
  132. package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile.md +90 -0
  133. package/unity-skills/create-tile-palette-or-rule-tiles/scripts/CreatePaletteTemplate.cs +148 -0
  134. package/unity-skills/create-tile-palette-or-rule-tiles/scripts/ManualWorkflowExample.cs +63 -0
  135. package/unity-skills/create-tile-palette-or-rule-tiles/scripts/RuleTileGenerator.cs +61 -0
  136. package/unity-skills/create-tile-palette-or-rule-tiles/scripts/TilemapRuleTileCreateFromSegment.cs +225 -0
  137. package/unity-skills/generate-editor-search-query/SECURITY.md +17 -0
  138. package/unity-skills/generate-editor-search-query/SKILL.md +117 -0
  139. package/unity-skills/generate-editor-search-query/references/open-search-window.md +70 -0
  140. package/unity-skills/generate-editor-search-query/references/query-patterns.md +124 -0
  141. package/{.claude/skills → unity-skills}/implement-in-app-purchases/SKILL.md +1 -2
  142. package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/api-notes.md +25 -28
  143. package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-convert-native-google-billing.md +1 -1
  144. package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-implement-iap-d2c.md +40 -5
  145. package/{.claude/skills → unity-skills}/initialize-ai-navigation/SKILL.md +4 -4
  146. package/{.claude/skills → unity-skills}/initialize-ai-navigation/references/navigation-system.md +3 -3
  147. package/{.claude/skills → unity-skills}/levelplay-unity-integration/CHANGELOG.md +12 -0
  148. package/{.claude/skills → unity-skills}/levelplay-unity-integration/README.md +9 -5
  149. package/unity-skills/levelplay-unity-integration/SKILL.md +442 -0
  150. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/banner-api.md +15 -8
  151. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/best-practices.md +604 -536
  152. package/unity-skills/levelplay-unity-integration/references/dependency-resolution.md +94 -0
  153. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/ilrd-api.md +2 -2
  154. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/initialization-api.md +221 -0
  155. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/interstitial-api.md +11 -3
  156. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/ios-setup.md +6 -34
  157. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/migration-sdk-9.md +1 -1
  158. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/privacy-settings.md +14 -29
  159. package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/rewarded-api.md +20 -4
  160. package/unity-skills/levelplay-unity-integration/references/testing-and-validation.md +222 -0
  161. package/unity-skills/levelplay-unity-integration/references/troubleshooting.md +99 -0
  162. package/unity-skills/localization/SKILL.md +347 -0
  163. package/{.claude/skills → unity-skills}/localization/references/api-notes.md +4 -0
  164. package/unity-skills/localization/resources/L10nBatchProcessor.cs +191 -0
  165. package/unity-skills/manage-sprite-atlas/SKILL.md +351 -0
  166. package/unity-skills/manage-sprite-atlas/references/addressables-delivery.md +58 -0
  167. package/unity-skills/manage-sprite-atlas/references/api.md +382 -0
  168. package/unity-skills/manage-sprite-atlas/references/best-practices.md +183 -0
  169. package/unity-skills/manage-sprite-atlas/references/common-errors.md +123 -0
  170. package/unity-skills/manage-sprite-atlas/references/custom-packing.md +147 -0
  171. package/unity-skills/manage-sprite-atlas/references/manual-authoring.md +39 -0
  172. package/unity-skills/manage-sprite-atlas/resources/authoringvsruntime.cs +176 -0
  173. package/unity-skills/manage-sprite-atlas/resources/buildaddressablespostprocess.cs +59 -0
  174. package/unity-skills/manage-sprite-atlas/resources/cacheloadedatlases.cs +145 -0
  175. package/unity-skills/manage-sprite-atlas/resources/cleanupbatchoperations.cs +119 -0
  176. package/unity-skills/manage-sprite-atlas/resources/createandconfiguremasteratlas.cs +57 -0
  177. package/unity-skills/manage-sprite-atlas/resources/custompackersetup.cs +88 -0
  178. package/unity-skills/manage-sprite-atlas/resources/deprecatedmethods.cs +142 -0
  179. package/unity-skills/manage-sprite-atlas/resources/dontmodifywithoutsaving.cs +120 -0
  180. package/unity-skills/manage-sprite-atlas/resources/dontpackinruntimebuilds.cs +190 -0
  181. package/unity-skills/manage-sprite-atlas/resources/dontscriptspriteatlasineditor.cs +114 -0
  182. package/unity-skills/manage-sprite-atlas/resources/editorconfiguration.cs +95 -0
  183. package/unity-skills/manage-sprite-atlas/resources/enablespritepacking.cs +172 -0
  184. package/unity-skills/manage-sprite-atlas/resources/gridspritepacker.cs +50 -0
  185. package/unity-skills/manage-sprite-atlas/resources/handlelatebinding.cs +147 -0
  186. package/unity-skills/manage-sprite-atlas/resources/handlenullcases.cs +141 -0
  187. package/unity-skills/manage-sprite-atlas/resources/migratev1tov2.cs +335 -0
  188. package/unity-skills/manage-sprite-atlas/resources/multipagepacker.cs +80 -0
  189. package/unity-skills/manage-sprite-atlas/resources/optimizetexturesettings.cs +191 -0
  190. package/unity-skills/manage-sprite-atlas/resources/packerdebugging.cs +158 -0
  191. package/unity-skills/manage-sprite-atlas/resources/packtransform.cs +51 -0
  192. package/unity-skills/manage-sprite-atlas/resources/platformnames.cs +127 -0
  193. package/unity-skills/manage-sprite-atlas/resources/queryspritesefficiently.cs +222 -0
  194. package/unity-skills/manage-sprite-atlas/resources/registercallbacks.cs +152 -0
  195. package/unity-skills/manage-sprite-atlas/resources/runtimeatlasloader.cs +15 -0
  196. package/unity-skills/manage-sprite-atlas/resources/runtimespriteaccess.cs +19 -0
  197. package/unity-skills/manage-sprite-atlas/resources/savespriteatlasasset.cs +107 -0
  198. package/unity-skills/manage-sprite-atlas/resources/scriptablepacker.cs +81 -0
  199. package/unity-skills/manage-sprite-atlas/resources/setincludeinbuild.cs +164 -0
  200. package/unity-skills/manage-sprite-atlas/resources/sizeoptimizedpacker.cs +88 -0
  201. package/unity-skills/manage-sprite-atlas/resources/spriteatlaslatebinding.cs +123 -0
  202. package/unity-skills/manage-sprite-atlas/resources/spriteatlasprebuildgenerator.cs +219 -0
  203. package/unity-skills/manage-sprite-atlas/resources/spritedata.cs +35 -0
  204. package/unity-skills/manage-sprite-atlas/resources/spritepack.cs +39 -0
  205. package/unity-skills/manage-sprite-atlas/resources/texturedata.cs +15 -0
  206. package/unity-skills/manage-sprite-atlas/resources/updatebuildscripts.cs +357 -0
  207. package/unity-skills/manage-sprite-atlas/resources/updatesettingsconfiguration.cs +135 -0
  208. package/unity-skills/manage-sprite-atlas/resources/usevariantswisely.cs +179 -0
  209. package/unity-skills/manage-sprite-atlas/resources/variantatlas.cs +39 -0
  210. package/unity-skills/manifest.json +1155 -0
  211. package/unity-skills/migrate-birp-to-urp/SECURITY.md +16 -0
  212. package/unity-skills/migrate-birp-to-urp/SKILL.md +543 -0
  213. package/unity-skills/migrate-birp-to-urp/references/capturing-the-editor.md +66 -0
  214. package/unity-skills/migrate-birp-to-urp/references/complex-shader-situations.md +272 -0
  215. package/unity-skills/migrate-birp-to-urp/references/custom-shader-triage.md +123 -0
  216. package/unity-skills/migrate-birp-to-urp/references/implementation-patterns.md +529 -0
  217. package/unity-skills/migrate-birp-to-urp/references/migration-workflow.md +265 -0
  218. package/unity-skills/migrate-birp-to-urp/references/quality-settings-map.md +69 -0
  219. package/unity-skills/new-unity-project/SECURITY.md +26 -0
  220. package/unity-skills/new-unity-project/SKILL.md +386 -0
  221. package/unity-skills/new-unity-project/references/skill-setup.md +66 -0
  222. package/unity-skills/optimize-audio/SECURITY.md +16 -0
  223. package/{.claude/skills → unity-skills}/optimize-audio/SKILL.md +17 -17
  224. package/{.claude/skills → unity-skills}/optimize-audio/resources/audio-import-api.md +8 -5
  225. package/{.claude/skills → unity-skills}/optimize-text-mesh-pro/SKILL.md +1 -11
  226. package/unity-skills/optimize-web/SECURITY.md +16 -0
  227. package/{.claude/skills → unity-skills}/optimize-web/SKILL.md +164 -27
  228. package/unity-skills/optimize-web/scripts/WebOptimizer.cs +46 -0
  229. package/unity-skills/optimize-web/scripts/toktx-examples.sh +11 -0
  230. package/{.claude/skills → unity-skills}/physics-3d-collision/SKILL.md +2 -2
  231. package/unity-skills/physics-3d-collision/references/troubleshooting.md +8 -0
  232. package/unity-skills/project-auditor-fixes/SKILL.md +64 -0
  233. package/{.claude/skills → unity-skills}/setup-multiplayer-services/SKILL.md +1 -4
  234. package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/SKILL.md +1 -1
  235. package/{.claude/skills → unity-skills}/shader-graph-create-custom-node/SKILL.md +1 -1
  236. package/unity-skills/sprite-editor/SECURITY.md +16 -0
  237. package/{.claude/skills → unity-skills}/sprite-editor/SKILL.md +9 -9
  238. package/{.claude/skills → unity-skills}/sprite-editor/references/templates.md +1 -1
  239. package/unity-skills/sprite-segment-3x3grid/SKILL.md +136 -0
  240. package/unity-skills/sprite-segment-3x3grid/scripts/SpriteGridAnalysis.cs +119 -0
  241. package/{.claude/skills → unity-skills}/ui/SKILL.md +1 -1
  242. package/{.claude/skills → unity-skills}/ui-imgui/SKILL.md +1 -7
  243. package/{.claude/skills → unity-skills}/ui-ugui/SKILL.md +3 -9
  244. package/{.claude/skills → unity-skills}/ui-uitk/SKILL.md +8 -14
  245. package/{.claude/skills → unity-skills}/ui-uitk/references/custom-elements.md +1 -1
  246. package/unity-skills/unity-cli/CHANGELOG.md +515 -0
  247. package/unity-skills/unity-cli/SECURITY.md +68 -0
  248. package/unity-skills/unity-cli/SKILL.md +723 -0
  249. package/unity-skills/unity-cli/references/auth-license-cloud.md +318 -0
  250. package/unity-skills/unity-cli/references/build-run-test.md +555 -0
  251. package/unity-skills/unity-cli/references/cloud-automation.md +736 -0
  252. package/{.claude/skills → unity-skills}/unity-cli/references/collaboration.md +166 -105
  253. package/unity-skills/unity-cli/references/config-hub.md +239 -0
  254. package/unity-skills/unity-cli/references/diagnostics-maintenance.md +720 -0
  255. package/unity-skills/unity-cli/references/docs-workflow.md +179 -0
  256. package/unity-skills/unity-cli/references/editors-install.md +476 -0
  257. package/unity-skills/unity-cli/references/integration-advanced.md +1130 -0
  258. package/unity-skills/unity-cli/references/playmode-verification-loop.md +279 -0
  259. package/unity-skills/unity-cli/references/projects-templates.md +996 -0
  260. package/unity-skills/unity-cli/references/version-control.md +612 -0
  261. package/{.claude/skills → unity-skills}/unity-package-management/SKILL.md +60 -12
  262. package/{.claude/skills → unity-skills}/unity-package-management/references/select-packages.md +39 -21
  263. package/unity-skills/unity-pipeline/SECURITY.md +17 -0
  264. package/unity-skills/unity-pipeline/SKILL.md +335 -0
  265. package/unity-skills/urp-postprocessing/SECURITY.md +16 -0
  266. package/{.claude/skills → unity-skills}/urp-postprocessing/SKILL.md +12 -12
  267. package/{.claude/skills → unity-skills}/urp-postprocessing/references/code-templates.md +39 -8
  268. package/{.claude/skills → unity-skills}/validate-urp-render-graph-renderer-feature/SKILL.md +1 -1
  269. package/.claude/agents/nccgs-adversarial-reviewer.md +0 -43
  270. package/.claude/agents/nccgs-engine-programmer.md +0 -27
  271. package/.claude/agents/nccgs-fast-implementer.md +0 -30
  272. package/.claude/agents/nccgs-game-designer.md +0 -26
  273. package/.claude/agents/nccgs-gameplay-programmer.md +0 -26
  274. package/.claude/agents/nccgs-qa-engineer.md +0 -27
  275. package/.claude/agents/nccgs-task-scout.md +0 -24
  276. package/.claude/agents/nccgs-ui-programmer.md +0 -27
  277. package/.claude/agents/nccgs-unity-build-specialist.md +0 -27
  278. package/.claude/agents/nccgs-unity-implementer.md +0 -28
  279. package/.claude/agents/nccgs-unity-systems-specialist.md +0 -27
  280. package/.claude/agents/nccgs-unity-ui-specialist.md +0 -27
  281. package/.claude/agents/nccgs-verification-engineer.md +0 -27
  282. package/.claude/nccgs/MEMORY.md +0 -66
  283. package/.claude/nccgs/THIRD_PARTY_NOTICES.md +0 -29
  284. package/.claude/nccgs/VERSION +0 -1
  285. package/.claude/nccgs/agent-library/nccgs-accessibility-specialist.md +0 -25
  286. package/.claude/nccgs/agent-library/nccgs-adversarial-reviewer.md +0 -41
  287. package/.claude/nccgs/agent-library/nccgs-ai-programmer.md +0 -25
  288. package/.claude/nccgs/agent-library/nccgs-analytics-engineer.md +0 -25
  289. package/.claude/nccgs/agent-library/nccgs-art-direction-lead.md +0 -25
  290. package/.claude/nccgs/agent-library/nccgs-audio-direction-lead.md +0 -25
  291. package/.claude/nccgs/agent-library/nccgs-creative-director.md +0 -25
  292. package/.claude/nccgs/agent-library/nccgs-documentation-manager.md +0 -25
  293. package/.claude/nccgs/agent-library/nccgs-economy-designer.md +0 -25
  294. package/.claude/nccgs/agent-library/nccgs-engine-programmer.md +0 -25
  295. package/.claude/nccgs/agent-library/nccgs-fast-implementer.md +0 -28
  296. package/.claude/nccgs/agent-library/nccgs-game-design-lead.md +0 -25
  297. package/.claude/nccgs/agent-library/nccgs-game-designer.md +0 -24
  298. package/.claude/nccgs/agent-library/nccgs-gameplay-programmer.md +0 -24
  299. package/.claude/nccgs/agent-library/nccgs-level-designer.md +0 -25
  300. package/.claude/nccgs/agent-library/nccgs-live-ops-designer.md +0 -25
  301. package/.claude/nccgs/agent-library/nccgs-localization-lead.md +0 -25
  302. package/.claude/nccgs/agent-library/nccgs-narrative-lead.md +0 -25
  303. package/.claude/nccgs/agent-library/nccgs-network-programmer.md +0 -25
  304. package/.claude/nccgs/agent-library/nccgs-performance-analyst.md +0 -25
  305. package/.claude/nccgs/agent-library/nccgs-producer.md +0 -25
  306. package/.claude/nccgs/agent-library/nccgs-production-coordinator.md +0 -22
  307. package/.claude/nccgs/agent-library/nccgs-programming-lead.md +0 -25
  308. package/.claude/nccgs/agent-library/nccgs-prototyper.md +0 -25
  309. package/.claude/nccgs/agent-library/nccgs-qa-engineer.md +0 -25
  310. package/.claude/nccgs/agent-library/nccgs-qa-lead.md +0 -25
  311. package/.claude/nccgs/agent-library/nccgs-release-engineer.md +0 -25
  312. package/.claude/nccgs/agent-library/nccgs-release-lead.md +0 -25
  313. package/.claude/nccgs/agent-library/nccgs-security-engineer.md +0 -25
  314. package/.claude/nccgs/agent-library/nccgs-sound-designer.md +0 -25
  315. package/.claude/nccgs/agent-library/nccgs-systems-designer.md +0 -25
  316. package/.claude/nccgs/agent-library/nccgs-task-scout.md +0 -22
  317. package/.claude/nccgs/agent-library/nccgs-technical-architect.md +0 -25
  318. package/.claude/nccgs/agent-library/nccgs-technical-artist.md +0 -25
  319. package/.claude/nccgs/agent-library/nccgs-technical-director.md +0 -25
  320. package/.claude/nccgs/agent-library/nccgs-tools-programmer.md +0 -25
  321. package/.claude/nccgs/agent-library/nccgs-ui-programmer.md +0 -25
  322. package/.claude/nccgs/agent-library/nccgs-unity-build-specialist.md +0 -25
  323. package/.claude/nccgs/agent-library/nccgs-unity-content-specialist.md +0 -25
  324. package/.claude/nccgs/agent-library/nccgs-unity-implementer.md +0 -26
  325. package/.claude/nccgs/agent-library/nccgs-unity-rendering-specialist.md +0 -25
  326. package/.claude/nccgs/agent-library/nccgs-unity-systems-specialist.md +0 -25
  327. package/.claude/nccgs/agent-library/nccgs-unity-ui-specialist.md +0 -25
  328. package/.claude/nccgs/agent-library/nccgs-ux-designer.md +0 -25
  329. package/.claude/nccgs/agent-library/nccgs-verification-engineer.md +0 -25
  330. package/.claude/nccgs/agent-library/nccgs-world-builder.md +0 -25
  331. package/.claude/nccgs/agent-library/nccgs-writer.md +0 -25
  332. package/.claude/nccgs/constitution.md +0 -187
  333. package/.claude/nccgs/hooks/agent-audit.mjs +0 -16
  334. package/.claude/nccgs/hooks/closure-guard.mjs +0 -59
  335. package/.claude/nccgs/hooks/common.mjs +0 -42
  336. package/.claude/nccgs/hooks/post-compact.mjs +0 -1
  337. package/.claude/nccgs/hooks/pre-compact.mjs +0 -8
  338. package/.claude/nccgs/hooks/protect-git.mjs +0 -22
  339. package/.claude/nccgs/hooks/protect-write.mjs +0 -17
  340. package/.claude/nccgs/hooks/runtime-observation.mjs +0 -11
  341. package/.claude/nccgs/hooks/session-start.mjs +0 -29
  342. package/.claude/nccgs/hooks/session-stop.mjs +0 -7
  343. package/.claude/nccgs/hooks/unity-transport-guard.mjs +0 -11
  344. package/.claude/nccgs/packages/ponytail/README.md +0 -46
  345. package/.claude/nccgs/packages/ponytail/manifest.json +0 -24
  346. package/.claude/nccgs/pipeline.json +0 -260
  347. package/.claude/nccgs/protocols/agent-contract.md +0 -101
  348. package/.claude/nccgs/protocols/astra-claude.md +0 -111
  349. package/.claude/nccgs/protocols/bounded-repair.md +0 -246
  350. package/.claude/nccgs/protocols/context-packets.md +0 -23
  351. package/.claude/nccgs/protocols/delivery-acceptance.md +0 -105
  352. package/.claude/nccgs/protocols/design-lifecycle.md +0 -139
  353. package/.claude/nccgs/protocols/editor-session-evidence.md +0 -52
  354. package/.claude/nccgs/protocols/evidence.md +0 -31
  355. package/.claude/nccgs/protocols/model-routing.md +0 -46
  356. package/.claude/nccgs/protocols/orchestration.md +0 -74
  357. package/.claude/nccgs/protocols/review-handoff.md +0 -101
  358. package/.claude/nccgs/protocols/shared-workflow-context.md +0 -33
  359. package/.claude/nccgs/protocols/standalone-gates.md +0 -329
  360. package/.claude/nccgs/protocols/standalone-pilot.md +0 -144
  361. package/.claude/nccgs/protocols/standalone.md +0 -207
  362. package/.claude/nccgs/protocols/task-autonomy.md +0 -55
  363. package/.claude/nccgs/protocols/task-gates.md +0 -144
  364. package/.claude/nccgs/protocols/task-slices.md +0 -106
  365. package/.claude/nccgs/protocols/unity-boundary.md +0 -31
  366. package/.claude/nccgs/routing.generated.md +0 -49
  367. package/.claude/nccgs/settings.fragment.json +0 -213
  368. package/.claude/nccgs/studio.json +0 -472
  369. package/.claude/nccgs/tools/approve-overrides.mjs +0 -81
  370. package/.claude/nccgs/tools/autonomy.mjs +0 -40
  371. package/.claude/nccgs/tools/command-process.mjs +0 -50
  372. package/.claude/nccgs/tools/command-tokens.mjs +0 -22
  373. package/.claude/nccgs/tools/compile-policy.mjs +0 -121
  374. package/.claude/nccgs/tools/configure-models.mjs +0 -96
  375. package/.claude/nccgs/tools/criteria.mjs +0 -121
  376. package/.claude/nccgs/tools/delivery-budget.mjs +0 -52
  377. package/.claude/nccgs/tools/design-readiness.mjs +0 -158
  378. package/.claude/nccgs/tools/editor-session-evidence.mjs +0 -66
  379. package/.claude/nccgs/tools/evidence.mjs +0 -153
  380. package/.claude/nccgs/tools/gates.mjs +0 -297
  381. package/.claude/nccgs/tools/handoff.mjs +0 -51
  382. package/.claude/nccgs/tools/hook-transport.mjs +0 -34
  383. package/.claude/nccgs/tools/inputs.mjs +0 -108
  384. package/.claude/nccgs/tools/installation-guard.mjs +0 -55
  385. package/.claude/nccgs/tools/integrity.mjs +0 -69
  386. package/.claude/nccgs/tools/lifecycle.mjs +0 -542
  387. package/.claude/nccgs/tools/native-completion.mjs +0 -30
  388. package/.claude/nccgs/tools/orchestration.mjs +0 -680
  389. package/.claude/nccgs/tools/paths.mjs +0 -60
  390. package/.claude/nccgs/tools/policy.mjs +0 -107
  391. package/.claude/nccgs/tools/process-lock.mjs +0 -74
  392. package/.claude/nccgs/tools/repair-packet.mjs +0 -106
  393. package/.claude/nccgs/tools/returned-handoff.mjs +0 -47
  394. package/.claude/nccgs/tools/review-budget.mjs +0 -171
  395. package/.claude/nccgs/tools/review-handoff.mjs +0 -66
  396. package/.claude/nccgs/tools/runtime.mjs +0 -71
  397. package/.claude/nccgs/tools/session-budget.mjs +0 -67
  398. package/.claude/nccgs/tools/shared-context-guard.mjs +0 -60
  399. package/.claude/nccgs/tools/shared-context.mjs +0 -25
  400. package/.claude/nccgs/tools/task-slices.mjs +0 -147
  401. package/.claude/nccgs/tools/task.mjs +0 -145
  402. package/.claude/nccgs/tools/tool-guard.mjs +0 -120
  403. package/.claude/nccgs/tools/unity-repair.mjs +0 -128
  404. package/.claude/nccgs/tools/unity-transport.mjs +0 -170
  405. package/.claude/nccgs/tools/verification-jobs.mjs +0 -171
  406. package/.claude/nccgs/tools/verification-worker.mjs +0 -71
  407. package/.claude/nccgs/tools/windows-compiler-server.cs +0 -163
  408. package/.claude/nccgs/tools/windows-job.cs +0 -103
  409. package/.claude/nccgs/unity-skills-manifest.json +0 -727
  410. package/.claude/nccgs/workflow-catalog.json +0 -654
  411. package/.claude/rules/nccgs-canonical-docs.md +0 -19
  412. package/.claude/rules/nccgs-editor-tools.md +0 -12
  413. package/.claude/rules/nccgs-localization.md +0 -12
  414. package/.claude/rules/nccgs-networking.md +0 -13
  415. package/.claude/rules/nccgs-performance.md +0 -14
  416. package/.claude/rules/nccgs-rendering.md +0 -16
  417. package/.claude/rules/nccgs-security.md +0 -13
  418. package/.claude/rules/nccgs-tests.md +0 -18
  419. package/.claude/rules/nccgs-ui.md +0 -14
  420. package/.claude/rules/nccgs-unity-assets.md +0 -21
  421. package/.claude/rules/nccgs-unity-code.md +0 -22
  422. package/.claude/skills/accessibility-review/SKILL.md +0 -22
  423. package/.claude/skills/accessibility-review/references/astra.md +0 -17
  424. package/.claude/skills/accessibility-review/references/legacy.md +0 -7
  425. package/.claude/skills/architecture-decision/SKILL.md +0 -22
  426. package/.claude/skills/architecture-decision/references/astra.md +0 -12
  427. package/.claude/skills/architecture-decision/references/legacy.md +0 -7
  428. package/.claude/skills/asset-audit/SKILL.md +0 -22
  429. package/.claude/skills/asset-audit/references/astra.md +0 -17
  430. package/.claude/skills/asset-audit/references/legacy.md +0 -7
  431. package/.claude/skills/audit/SKILL.md +0 -22
  432. package/.claude/skills/audit/references/astra.md +0 -17
  433. package/.claude/skills/audit/references/dimensions.md +0 -46
  434. package/.claude/skills/audit/references/legacy.md +0 -9
  435. package/.claude/skills/balance-review/SKILL.md +0 -22
  436. package/.claude/skills/balance-review/references/astra.md +0 -17
  437. package/.claude/skills/balance-review/references/legacy.md +0 -7
  438. package/.claude/skills/bug-triage/SKILL.md +0 -22
  439. package/.claude/skills/bug-triage/references/astra.md +0 -27
  440. package/.claude/skills/bug-triage/references/legacy.md +0 -7
  441. package/.claude/skills/build-live-game/SKILL.md +0 -317
  442. package/.claude/skills/build-live-game/references/cloud-code.md +0 -563
  443. package/.claude/skills/closure/SKILL.md +0 -22
  444. package/.claude/skills/closure/references/astra.md +0 -15
  445. package/.claude/skills/closure/references/legacy.md +0 -7
  446. package/.claude/skills/compatibility-review/SKILL.md +0 -22
  447. package/.claude/skills/compatibility-review/references/astra.md +0 -17
  448. package/.claude/skills/compatibility-review/references/legacy.md +0 -7
  449. package/.claude/skills/context-pack/SKILL.md +0 -22
  450. package/.claude/skills/context-pack/references/astra.md +0 -12
  451. package/.claude/skills/context-pack/references/legacy.md +0 -7
  452. package/.claude/skills/dependency-review/SKILL.md +0 -22
  453. package/.claude/skills/dependency-review/references/astra.md +0 -17
  454. package/.claude/skills/dependency-review/references/legacy.md +0 -7
  455. package/.claude/skills/design/SKILL.md +0 -24
  456. package/.claude/skills/design/references/astra.md +0 -12
  457. package/.claude/skills/design/references/legacy.md +0 -13
  458. package/.claude/skills/design-review/SKILL.md +0 -24
  459. package/.claude/skills/design-review/references/astra.md +0 -17
  460. package/.claude/skills/design-review/references/legacy.md +0 -7
  461. package/.claude/skills/evidence-review/SKILL.md +0 -22
  462. package/.claude/skills/evidence-review/references/astra.md +0 -17
  463. package/.claude/skills/evidence-review/references/legacy.md +0 -7
  464. package/.claude/skills/hotfix/SKILL.md +0 -22
  465. package/.claude/skills/hotfix/references/astra.md +0 -30
  466. package/.claude/skills/hotfix/references/legacy.md +0 -7
  467. package/.claude/skills/incident-recovery/SKILL.md +0 -22
  468. package/.claude/skills/incident-recovery/references/astra.md +0 -27
  469. package/.claude/skills/incident-recovery/references/legacy.md +0 -7
  470. package/.claude/skills/levelplay-unity-integration/SKILL.md +0 -1126
  471. package/.claude/skills/localization/SKILL.md +0 -135
  472. package/.claude/skills/localization/resources/L10nBatchProcessor.cs +0 -69
  473. package/.claude/skills/localize-game/SKILL.md +0 -22
  474. package/.claude/skills/localize-game/references/astra.md +0 -27
  475. package/.claude/skills/localize-game/references/legacy.md +0 -7
  476. package/.claude/skills/migrate-project/SKILL.md +0 -22
  477. package/.claude/skills/migrate-project/references/astra.md +0 -30
  478. package/.claude/skills/migrate-project/references/legacy.md +0 -19
  479. package/.claude/skills/migrate-project/references/procedure.md +0 -96
  480. package/.claude/skills/milestone-review/SKILL.md +0 -22
  481. package/.claude/skills/milestone-review/references/astra.md +0 -12
  482. package/.claude/skills/milestone-review/references/legacy.md +0 -7
  483. package/.claude/skills/nccgs-code-review/SKILL.md +0 -22
  484. package/.claude/skills/nccgs-code-review/references/astra.md +0 -21
  485. package/.claude/skills/nccgs-code-review/references/legacy.md +0 -7
  486. package/.claude/skills/new-unity-project/SKILL.md +0 -179
  487. package/.claude/skills/performance-audit/SKILL.md +0 -22
  488. package/.claude/skills/performance-audit/references/astra.md +0 -17
  489. package/.claude/skills/performance-audit/references/legacy.md +0 -7
  490. package/.claude/skills/physics-3d-collision/references/troubleshooting.md +0 -41
  491. package/.claude/skills/plan-feature/SKILL.md +0 -22
  492. package/.claude/skills/plan-feature/references/astra.md +0 -12
  493. package/.claude/skills/plan-feature/references/legacy.md +0 -7
  494. package/.claude/skills/playtest/SKILL.md +0 -22
  495. package/.claude/skills/playtest/references/astra.md +0 -31
  496. package/.claude/skills/playtest/references/legacy.md +0 -7
  497. package/.claude/skills/project-stage/SKILL.md +0 -22
  498. package/.claude/skills/project-stage/references/astra.md +0 -12
  499. package/.claude/skills/project-stage/references/legacy.md +0 -7
  500. package/.claude/skills/prototype-feature/SKILL.md +0 -22
  501. package/.claude/skills/prototype-feature/references/astra.md +0 -31
  502. package/.claude/skills/prototype-feature/references/legacy.md +0 -7
  503. package/.claude/skills/qa-plan/SKILL.md +0 -22
  504. package/.claude/skills/qa-plan/references/astra.md +0 -12
  505. package/.claude/skills/qa-plan/references/legacy.md +0 -7
  506. package/.claude/skills/release/SKILL.md +0 -22
  507. package/.claude/skills/release/references/astra.md +0 -30
  508. package/.claude/skills/release/references/legacy.md +0 -11
  509. package/.claude/skills/release-readiness/SKILL.md +0 -22
  510. package/.claude/skills/release-readiness/references/astra.md +0 -17
  511. package/.claude/skills/release-readiness/references/legacy.md +0 -7
  512. package/.claude/skills/retrospective/SKILL.md +0 -22
  513. package/.claude/skills/retrospective/references/astra.md +0 -12
  514. package/.claude/skills/retrospective/references/legacy.md +0 -7
  515. package/.claude/skills/review/SKILL.md +0 -22
  516. package/.claude/skills/review/references/astra.md +0 -21
  517. package/.claude/skills/review/references/legacy.md +0 -9
  518. package/.claude/skills/security-audit/SKILL.md +0 -22
  519. package/.claude/skills/security-audit/references/astra.md +0 -17
  520. package/.claude/skills/security-audit/references/legacy.md +0 -7
  521. package/.claude/skills/sprint-plan/SKILL.md +0 -22
  522. package/.claude/skills/sprint-plan/references/astra.md +0 -12
  523. package/.claude/skills/sprint-plan/references/legacy.md +0 -7
  524. package/.claude/skills/status/SKILL.md +0 -22
  525. package/.claude/skills/status/references/astra.md +0 -19
  526. package/.claude/skills/status/references/legacy.md +0 -9
  527. package/.claude/skills/story-readiness/SKILL.md +0 -24
  528. package/.claude/skills/story-readiness/references/astra.md +0 -17
  529. package/.claude/skills/story-readiness/references/legacy.md +0 -7
  530. package/.claude/skills/test/SKILL.md +0 -22
  531. package/.claude/skills/test/references/astra.md +0 -27
  532. package/.claude/skills/test/references/legacy.md +0 -9
  533. package/.claude/skills/ui-review/SKILL.md +0 -22
  534. package/.claude/skills/ui-review/references/astra.md +0 -17
  535. package/.claude/skills/ui-review/references/legacy.md +0 -7
  536. package/.claude/skills/unity-cli/CHANGELOG.md +0 -233
  537. package/.claude/skills/unity-cli/SECURITY.md +0 -22
  538. package/.claude/skills/unity-cli/SKILL.md +0 -414
  539. package/.claude/skills/unity-cli/references/auth-license-cloud.md +0 -146
  540. package/.claude/skills/unity-cli/references/build-run-test.md +0 -349
  541. package/.claude/skills/unity-cli/references/config-hub.md +0 -103
  542. package/.claude/skills/unity-cli/references/diagnostics-maintenance.md +0 -326
  543. package/.claude/skills/unity-cli/references/editors-install.md +0 -327
  544. package/.claude/skills/unity-cli/references/integration-advanced.md +0 -472
  545. package/.claude/skills/unity-cli/references/projects-templates.md +0 -574
  546. package/.claude/skills/work/SKILL.md +0 -22
  547. package/.claude/skills/work/references/astra.md +0 -32
  548. package/.claude/skills/work/references/classification.md +0 -41
  549. package/.claude/skills/work/references/closure.md +0 -60
  550. package/.claude/skills/work/references/feature-contracts.md +0 -36
  551. package/.claude/skills/work/references/legacy.md +0 -29
  552. package/.claude/skills/work/references/verification.md +0 -26
  553. package/CLAUDE.md +0 -10
  554. package/MEMORY.md +0 -109
  555. package/UPGRADING.md +0 -130
  556. package/VERSION +0 -1
  557. package/docs/ARCHITECTURE.md +0 -131
  558. package/docs/ASSET-PRODUCTION-GRAPHIFY-PLAN.md +0 -230
  559. package/docs/BOUNDED-REPAIR.md +0 -80
  560. package/docs/EDITOR-SESSION-EVIDENCE.md +0 -52
  561. package/docs/HANDOFF-AUTOMATION.md +0 -144
  562. package/docs/HUONG-DAN-MIGRATE-VA-SU-DUNG.md +0 -117
  563. package/docs/MIGRATION-MATRIX.md +0 -23
  564. package/docs/NCCGS-1.3.md +0 -13
  565. package/docs/NCCGS-1.4.1.md +0 -149
  566. package/docs/NCCGS-1.4.md +0 -184
  567. package/docs/NCCGS-1.5-IMPLEMENTATION-PLAN.md +0 -378
  568. package/docs/NCCGS-1.5-PILOT.md +0 -130
  569. package/docs/NCCGS-1.5.md +0 -237
  570. package/docs/PHASE-1-OPERATIONS.md +0 -278
  571. package/docs/PHASE-2-OPERATIONS.md +0 -183
  572. package/docs/PROJECT-POLICY.md +0 -94
  573. package/docs/RELEASE-STATUS.md +0 -150
  574. package/docs/TASK-SLICING.md +0 -57
  575. package/docs/UNINSTALL.md +0 -134
  576. package/docs/UPGRADE-QUALIFICATION.md +0 -45
  577. package/docs/WFK17-HOOK-REPAIR.md +0 -71
  578. package/docs/WORKFLOWS.md +0 -85
  579. package/package-assets/nccgs-project.gitignore +0 -2
  580. package/package-assets/setup-vivox-voice-chat-evals.gitignore +0 -7
  581. package/scaffold/.nccgs/autonomy.json +0 -4
  582. package/scaffold/.nccgs/bugs/.gitkeep +0 -1
  583. package/scaffold/.nccgs/closures/.gitkeep +0 -1
  584. package/scaffold/.nccgs/context/.gitkeep +0 -1
  585. package/scaffold/.nccgs/decisions/.gitkeep +0 -1
  586. package/scaffold/.nccgs/evidence/.gitkeep +0 -1
  587. package/scaffold/.nccgs/execution.json +0 -10
  588. package/scaffold/.nccgs/features/.gitkeep +0 -1
  589. package/scaffold/.nccgs/gates.json +0 -7
  590. package/scaffold/.nccgs/inputs.json +0 -6
  591. package/scaffold/.nccgs/migrations/.gitkeep +0 -1
  592. package/scaffold/.nccgs/playtests/.gitkeep +0 -1
  593. package/scaffold/.nccgs/project.yaml +0 -109
  594. package/scaffold/.nccgs/requirements.yaml +0 -10
  595. package/scaffold/.nccgs/reviews/.gitkeep +0 -1
  596. package/scaffold/.nccgs/state.md +0 -40
  597. package/scaffold/.nccgs/templates/agent-handoff.md +0 -37
  598. package/scaffold/.nccgs/templates/architecture-decision.md +0 -27
  599. package/scaffold/.nccgs/templates/closure-record.md +0 -62
  600. package/scaffold/.nccgs/templates/context-packet.yaml +0 -17
  601. package/scaffold/.nccgs/templates/design-contract.json +0 -34
  602. package/scaffold/.nccgs/templates/evidence-record.md +0 -23
  603. package/scaffold/.nccgs/templates/feature-contract.md +0 -60
  604. package/scaffold/.nccgs/templates/implementation-report.md +0 -52
  605. package/scaffold/.nccgs/templates/migration-plan.md +0 -40
  606. package/scaffold/.nccgs/templates/repair-packet.json +0 -14
  607. package/scaffold/.nccgs/templates/repair-unity-code.json +0 -18
  608. package/scaffold/.nccgs/templates/repair-unity-editor.json +0 -21
  609. package/scaffold/.nccgs/templates/task-slices.json +0 -28
  610. package/scaffold/.nccgs/templates/waiver.md +0 -11
  611. package/scripts/benchmark-snapshot.mjs +0 -205
  612. package/scripts/benchmark-v15.mjs +0 -173
  613. package/scripts/cli.mjs +0 -205
  614. package/scripts/doctor.mjs +0 -261
  615. package/scripts/install.mjs +0 -530
  616. package/scripts/recover-session.mjs +0 -89
  617. package/scripts/run.mjs +0 -86
  618. package/scripts/supervise.mjs +0 -152
  619. package/scripts/uninstall.mjs +0 -292
  620. package/scripts/validate.mjs +0 -285
  621. package/scripts/work-handoff.mjs +0 -38
  622. package/tests/autonomy.test.mjs +0 -126
  623. package/tests/benchmark-v15.test.mjs +0 -65
  624. package/tests/design-readiness.test.mjs +0 -200
  625. package/tests/editor-session-evidence.test.mjs +0 -45
  626. package/tests/evidence.test.mjs +0 -186
  627. package/tests/fixtures/compiler-shutdown.cs +0 -67
  628. package/tests/fixtures/native-provider.mjs +0 -61
  629. package/tests/framework.test.mjs +0 -740
  630. package/tests/gates.test.mjs +0 -479
  631. package/tests/hook-repair.test.mjs +0 -106
  632. package/tests/lifecycle-v15.test.mjs +0 -346
  633. package/tests/native-completion-notices.test.mjs +0 -181
  634. package/tests/orchestration-v15.test.mjs +0 -596
  635. package/tests/phase1.test.mjs +0 -427
  636. package/tests/phase2.test.mjs +0 -250
  637. package/tests/policy-v15.test.mjs +0 -234
  638. package/tests/ponytail-package.test.mjs +0 -75
  639. package/tests/returned-handoff-notices.test.mjs +0 -170
  640. package/tests/review-budget.test.mjs +0 -177
  641. package/tests/runtime-v15.test.mjs +0 -1198
  642. package/tests/session-budget.test.mjs +0 -34
  643. package/tests/task-slices.test.mjs +0 -285
  644. package/tests/uninstall.test.mjs +0 -477
  645. package/tests/unity-generated.test.mjs +0 -140
  646. package/tests/unity-transport.test.mjs +0 -348
  647. /package/{.claude/nccgs/packages → template}/ponytail/LICENSE +0 -0
  648. /package/{.claude/nccgs/packages → template}/ponytail/NOTICE.md +0 -0
  649. /package/{.claude/nccgs/packages → template}/ponytail/complexity-review.md +0 -0
  650. /package/{.claude/skills → unity-skills}/build-live-game/references/remote-config.md +0 -0
  651. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/README.md +0 -0
  652. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/codeless-catalog.md +0 -0
  653. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-adapty.md +0 -0
  654. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-essentialkit.md +0 -0
  655. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-revenuecat.md +0 -0
  656. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-unipay.md +0 -0
  657. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/migration-v4-to-v5.md +0 -0
  658. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-add-iap-to-new-project.md +0 -0
  659. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-convert-native-storekit.md +0 -0
  660. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/platform-notes.md +0 -0
  661. /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/pre-check.md +0 -0
  662. /package/{.claude/skills → unity-skills}/localization/resources/LocalizedFontAsset.cs +0 -0
  663. /package/{.claude/skills → unity-skills}/optimize-audio/resources/platform-settings.md +0 -0
  664. /package/{.claude/skills → unity-skills}/optimize-web/resources/WebOptimizer.cs +0 -0
  665. /package/{.claude/skills → unity-skills}/optimize-web/resources/toktx-examples.sh +0 -0
  666. /package/{.claude/skills → unity-skills}/physics-3d-collision/resources/CollisionDebugger.cs +0 -0
  667. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/dgs-entrypoint.md +0 -0
  668. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/entrypoints.md +0 -0
  669. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/examples.md +0 -0
  670. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/implementation-fit.md +0 -0
  671. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/underlying-services.md +0 -0
  672. /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/workflows-prerequisites.md +0 -0
  673. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/.env.example +0 -0
  674. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/README.md +0 -0
  675. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/promptfooconfig.yaml +0 -0
  676. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/init-and-login.yaml +0 -0
  677. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/text-chat.yaml +0 -0
  678. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/voice-channels.yaml +0 -0
  679. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/events-and-participants.md +0 -0
  680. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/init-and-login.md +0 -0
  681. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/text-chat.md +0 -0
  682. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/troubleshooting.md +0 -0
  683. /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/voice-channels.md +0 -0
  684. /package/{.claude/skills → unity-skills}/shader-graph-create-custom-node/resources/all_hints.hlsl +0 -0
  685. /package/{.claude/skills → unity-skills}/sprite-editor/references/api_reference.md +0 -0
  686. /package/{.claude/skills → unity-skills}/sprite-editor/references/background.md +0 -0
  687. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/AutomaticSliceTexture.cs +0 -0
  688. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GenerateNewSpriteRects.cs +0 -0
  689. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GetTextureSourceImageSize.cs +0 -0
  690. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GetTextureToSlice.cs +0 -0
  691. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GridSliceTexture.cs +0 -0
  692. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/IsometricSliceTexture.cs +0 -0
  693. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/README.md +0 -0
  694. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/SetPivotExample.cs +0 -0
  695. /package/{.claude/skills → unity-skills}/sprite-editor/scripts/SpriteToPng.cs +0 -0
  696. /package/{.claude/skills → unity-skills}/ui-imgui/references/gui-elements.md +0 -0
  697. /package/{.claude/skills → unity-skills}/ui-imgui/references/templates.md +0 -0
  698. /package/{.claude/skills → unity-skills}/ui-ugui/references/scrollview-setup.md +0 -0
  699. /package/{.claude/skills → unity-skills}/ui-uitk/references/common-issues.md +0 -0
  700. /package/{.claude/skills → unity-skills}/ui-uitk/references/painter2d.md +0 -0
  701. /package/{.claude/skills → unity-skills}/ui-uitk/references/pointermanipulator-guide.md +0 -0
  702. /package/{.claude/skills → unity-skills}/ui-uitk/references/svg-icons.md +0 -0
  703. /package/{.claude/skills → unity-skills}/ui-uitk/references/ui-runtime-binding.md +0 -0
  704. /package/{.claude/skills → unity-skills}/ui-uitk/references/uss-guide.md +0 -0
  705. /package/{.claude/skills → unity-skills}/urp-postprocessing/references/effect-reference.md +0 -0
@@ -1,542 +0,0 @@
1
- import fs from "node:fs";
2
- import path from "node:path";
3
- import crypto from "node:crypto";
4
- import { artifact, atomicJson, contained, hash, json, loadPipeline, resolveExecution, verifyArtifact } from "./policy.mjs";
5
- import { canonicalInputs, pinInputs } from "./inputs.mjs";
6
- import { snapshot, taskPath } from "./gates.mjs";
7
- import { validateStageDispatch, status as dispatchStatus } from "./orchestration.mjs";
8
- import { pendingJobs } from "./verification-jobs.mjs";
9
- import { assessCriteria, validateCriteria } from "./criteria.mjs";
10
- import { pinDesign, requireDesignReady, sameDesignValue, verifyDesignReceipt } from "./design-readiness.mjs";
11
- import { verifyReviewHandoff } from "./review-handoff.mjs";
12
-
13
- const assert = (condition, message) => { if (!condition) throw new Error(message); };
14
- const now = () => new Date().toISOString();
15
- const digest = value => hash(JSON.stringify(value));
16
- const risks = ["FAST", "STANDARD", "CONTROLLED"];
17
- const outcomes = ["success", "partial", "blocked", "failed"];
18
- const validTime = time => Number.isFinite(Date.parse(time)) && Date.parse(time) <= Date.now();
19
- const nonempty = value => typeof value === "string" && value.trim().length > 0;
20
- function validateFindings(findings) {
21
- assert(Array.isArray(findings) && findings.every(item => item && typeof item === "object" &&
22
- ["BLOCKER", "HIGH", "MEDIUM", "LOW", "INFO"].includes(item.severity) && ["OPEN", "RESOLVED", "ACCEPTED"].includes(item.status) && nonempty(item.description)),
23
- "Review findings require severity, status and description; malformed findings cannot imply PASS");
24
- }
25
- const externalOnly = () => assert(!(process.env.CLAUDECODE || process.env.CLAUDE_CODE_ENTRYPOINT), "External decisions must be imported outside the Claude session");
26
- const writeTask = (project, task) => { atomicJson(taskPath(project, task.id), task); return task; };
27
- const contractHash = task => digest({ contract: task.contract, intake: task.intake, classification: task.classification, executionHash: task.executionHash });
28
- const firstStage = task => task.mode === "implement" ? "implementation" : "analysis";
29
- const unique = values => [...new Set(values)];
30
- function strings(value, label) {
31
- assert(Array.isArray(value) && value.every(nonempty), `${label} must be an array of nonempty strings`);
32
- return unique(value.map(item => item.trim()));
33
- }
34
- function routeFor(project, execution, risk) {
35
- const tier = loadPipeline(project).contract.taskTiers[risk];
36
- assert(tier, "Risk must be FAST, STANDARD or CONTROLLED");
37
- const route = execution.profile.models[tier.implementationClass];
38
- assert(route?.model && execution.profile.models.review?.model, "Standalone implementation and review routes need explicit model families");
39
- return { route: { class: tier.implementationClass, ...route }, tier };
40
- }
41
- function classify(contract, intake, requested = null, reason = null, evidence = null) {
42
- const text = `${contract.objective}\n${contract.systems.join(" ")}\n${contract.riskSignals.join(" ")}`;
43
- const signals = [];
44
- for (const [label, pattern] of [
45
- ["save/serialization", /\b(?:save(?:game| data| format)?|serializ\w*|deserializ\w*)\b/i],
46
- ["migration", /\bmigrat\w*\b/i],
47
- ["network authority", /\b(?:network|server)[ -]authorit\w*\b/i],
48
- ["commerce", /\b(?:commerce|iap|purchase\w*|payment\w*|monetiz\w*)\b/i],
49
- ["cross-system contract", /\bcross[ -]system\b/i]
50
- ]) if (pattern.test(text)) signals.push(label);
51
- if (contract.scope === "cross-system") signals.push("cross-system scope");
52
- const inferred = signals.length ? "CONTROLLED" : contract.scope === "local" && contract.target === "fix" && contract.readiness === "ready" ? "FAST" : "STANDARD";
53
- const risk = requested || inferred;
54
- assert(risks.includes(risk), "Risk must be FAST, STANDARD or CONTROLLED");
55
- assert(!signals.length || risk === "CONTROLLED", `Observed risk signals require CONTROLLED: ${signals.join(", ")}`);
56
- assert(risk !== "FAST" || inferred === "FAST", "FAST requires a ready local fix with complete scope evidence; inspect incomplete inputs before lowering the tier");
57
- const explanation = reason?.trim() || (signals.length ? `Controlled risk signals: ${signals.join(", ")}` : inferred === "FAST" ? "Ready local fix with bounded scope; verify the declared acceptance criteria" : "Conservative STANDARD route until inspection supplies evidence for a different tier");
58
- assert(!requested || nonempty(reason), "An explicit risk override requires a classification reason");
59
- const sources = evidence ?? [{ kind: "intake", path: intake.path, sha256: intake.sha256 }];
60
- assert(Array.isArray(sources) && sources.length > 0 && sources.every(item => nonempty(item) || (item && typeof item === "object" && (nonempty(item.path) || nonempty(item.observation)))), "Classification evidence must identify sources or observed facts");
61
- return { risk, reason: explanation, evidence: structuredClone(sources), signals, method: requested ? "explicit-with-signal-check" : "conservative-rules", classifiedAt: now() };
62
- }
63
- function normalize(project, relative, options = {}) {
64
- const intake = artifact(project, relative);
65
- const text = fs.readFileSync(verifyArtifact(project, intake), "utf8");
66
- let raw = {};
67
- if (relative.endsWith(".json")) {
68
- raw = JSON.parse(text);
69
- assert(raw && typeof raw === "object" && !Array.isArray(raw), "Contract/intake JSON must be an object");
70
- assert(raw.schemaVersion === undefined || raw.schemaVersion === 1, "Unsupported input contract schema");
71
- } else raw = { objective: text.trim() };
72
- const mode = options.mode || raw.mode || "implement";
73
- let design;
74
- if (raw.design !== undefined) {
75
- assert(mode === "implement" && raw.design && Object.keys(raw.design).length === 1 && typeof raw.design.taskId === "string", "design must contain only the completed design taskId for implementation");
76
- design = pinDesign(project, raw.design.taskId, options.id);
77
- for (const key of ["objective", "scope", "target", "acceptance", "requiredChecks", "manualGates"]) {
78
- assert(raw[key] === undefined || sameDesignValue(raw[key], design.specification[key]), `Intake ${key} differs from reviewed design; revise and review the design first`);
79
- raw[key] = structuredClone(design.specification[key]);
80
- }
81
- assert(raw.readiness === undefined || raw.readiness === "ready", "Reviewed design intake must be ready"); raw.readiness = "ready";
82
- delete design.specification;
83
- }
84
- assert(["implement", "audit", "plan"].includes(mode), "Task mode must be implement, audit or plan");
85
- assert(!options.mode || !raw.mode || raw.mode === options.mode, "CLI mode conflicts with input contract");
86
- assert(nonempty(raw.objective), "Task intake requires an objective");
87
- assert(raw.acceptance === undefined || Array.isArray(raw.acceptance), "acceptance must be an array of criteria");
88
- const contract = {
89
- schemaVersion: 1, objective: raw.objective.trim(), mode,
90
- ...(raw.workflow !== undefined ? { workflow: raw.workflow } : {}), ...(design ? { design } : {}),
91
- scope: raw.scope || "feature", systems: strings(raw.systems ?? [], "systems"),
92
- target: raw.target || "production-change", readiness: raw.readiness || "needs-inspection",
93
- riskSignals: strings(raw.riskSignals ?? [], "riskSignals"),
94
- requiredChecks: strings(raw.requiredChecks ?? [mode === "implement" ? "task-verification" : "analysis-verification"], "requiredChecks"),
95
- requiredArtifacts: strings(raw.requiredArtifacts ?? [], "requiredArtifacts"),
96
- manualGates: strings(raw.manualGates ?? [], "manualGates"),
97
- acceptanceRequired: raw.acceptanceRequired === true,
98
- analysisArtifacts: strings(raw.analysisArtifacts ?? (mode === "implement" ? [] : [`.nccgs/evidence/analysis/${options.id}-result.md`]), "analysisArtifacts"),
99
- acceptance: Array.isArray(raw.acceptance) ? structuredClone(raw.acceptance) : [],
100
- assumptions: strings(raw.assumptions ?? [], "assumptions"),
101
- reassessWhen: strings(raw.reassessWhen ?? [], "reassessWhen")
102
- };
103
- assert(raw.acceptanceRequired === undefined || typeof raw.acceptanceRequired === "boolean", "acceptanceRequired must be boolean");
104
- assert(raw.workflow === undefined || nonempty(raw.workflow), "workflow must be a nonempty string");
105
- const criteriaIds = new Set();
106
- for (const criterion of contract.acceptance) {
107
- assert(criterion && typeof criterion === "object" && nonempty(criterion.id) && nonempty(criterion.description), "Each acceptance criterion needs an id and description");
108
- assert(!criteriaIds.has(criterion.id), "Acceptance criterion IDs must be unique"); criteriaIds.add(criterion.id);
109
- assert(criterion.manual === true || nonempty(criterion.check), "Acceptance criteria need a check name or manual:true");
110
- if (criterion.manual === true) contract.manualGates.push(criterion.id);
111
- if (nonempty(criterion.check)) contract.requiredChecks.push(criterion.check);
112
- }
113
- validateCriteria(project, contract.acceptance);
114
- // Pinned once when dispatch accounting starts. Refresh/reclassification cannot
115
- // refund these slots or spend them on unrelated feature expansion.
116
- contract.deliveryReserve = mode === "implement" ? { repair: 1, qa: 1, review: 2 } : { repair: 0, qa: 0, review: 1 };
117
- contract.manualGates = unique(contract.manualGates); contract.requiredChecks = unique(contract.requiredChecks);
118
- contract.sources = strings(raw.sources ?? [], "sources").map(relative => artifact(project, relative));
119
- assert(["local", "feature", "cross-system"].includes(contract.scope), "Invalid contract scope");
120
- assert(["fix", "learning-prototype", "alpha-ready", "production-change"].includes(contract.target), "Invalid contract target");
121
- assert(["ready", "needs-inspection", "needs-product-decision"].includes(contract.readiness), "Invalid contract readiness");
122
- for (const relative of [...contract.requiredArtifacts, ...contract.analysisArtifacts]) contained(project, relative);
123
- for (const relative of contract.analysisArtifacts) assert(relative.startsWith(".nccgs/evidence/analysis/"), "Analysis artifacts must be declared under .nccgs/evidence/analysis/; source files are never exempted");
124
- if (mode !== "implement") assert(contract.analysisArtifacts.length > 0, "Audit/plan contracts must declare analysisArtifacts under .nccgs/evidence/analysis/");
125
- const classification = classify(contract, intake, options.risk || raw.risk, options.reason || raw.reason, options.evidence || raw.evidence);
126
- return { intake, contract, classification };
127
- }
128
- function optionalArtifact(project, relative) { return fs.existsSync(contained(project, relative)) ? artifact(project, relative) : null; }
129
- function projectObligations(project) {
130
- const policy = optionalArtifact(project, ".nccgs/project.yaml");
131
- const gates = optionalArtifact(project, ".nccgs/gates.json");
132
- if (gates && policy) assert(json(verifyArtifact(project, gates)).policySha256 === policy.sha256, "Project gate manifest must match current project.yaml");
133
- return { projectPolicy: policy, projectGates: gates };
134
- }
135
- export function initializeStandalone(project, id, options) {
136
- assert(!fs.existsSync(taskPath(project, id)), `Task already exists: ${id}`);
137
- const execution = resolveExecution(project);
138
- assert(execution.name === "standalone", "Standalone init requires an explicit standalone execution policy");
139
- const relative = options.intake || options.contract || options.plan;
140
- assert(nonempty(relative), "Standalone init needs --intake FILE, --contract FILE or --plan FILE");
141
- const normalized = normalize(project, relative, { ...options, id });
142
- const { route, tier } = routeFor(project, execution, normalized.classification.risk);
143
- const task = { schemaVersion: 2, id, profile: execution.profileName, execution: structuredClone(execution), executionHash: digest(execution),
144
- pipelineHash: digest(loadPipeline(project)), createdAt: now(), mode: normalized.contract.mode,
145
- ...normalized, risk: normalized.classification.risk, implementationRoute: route,
146
- reviewBudget: { used: 0, limit: tier.maxReviewRounds, baseLimit: tier.maxReviewRounds, extensions: [] },
147
- ...projectObligations(project), requirements: options.requirements ? artifact(project, options.requirements) : null,
148
- canonicalInputs: pinInputs(project), stages: {}, history: [], externalReviews: [], phase: "READY", outcome: null,
149
- parentId: options.parentId || null };
150
- if (task.parentId) { taskPath(project, task.parentId); assert(task.parentId !== id, "Task cannot be its own parent"); }
151
- task.contractHash = contractHash(task);
152
- task.analysisBaseline = task.mode === "implement" ? null : snapshot(project, task).sourceSha256;
153
- return writeTask(project, task);
154
- }
155
- function validateBudget(task) {
156
- const budget = task.reviewBudget;
157
- assert(budget && Number.isSafeInteger(budget.used) && budget.used >= 0 && Number.isSafeInteger(budget.baseLimit) && budget.baseLimit > 0 && Array.isArray(budget.extensions), "Invalid task review budget");
158
- let limit = budget.baseLimit;
159
- for (const extension of budget.extensions) {
160
- assert(Number.isSafeInteger(extension.rounds) && extension.rounds > 0 && extension.rounds <= budget.baseLimit && nonempty(extension.reason) && validTime(extension.at) && extension.previousLimit === limit && extension.newLimit === limit + extension.rounds, "Invalid review extension audit");
161
- limit = extension.newLimit;
162
- }
163
- assert(limit === budget.limit && budget.used <= limit, "Review budget does not match its audit");
164
- return { used: budget.used, limit, remaining: limit - budget.used };
165
- }
166
- function obligations(project, task) {
167
- const manifests = [task.projectGates, task.requirements].filter(Boolean).map(ref => json(verifyArtifact(project, ref)));
168
- for (const spec of manifests) assert(spec.schemaVersion === 1 && [spec.requiredChecks, spec.requiredArtifacts, spec.manualGates].every(Array.isArray), "Invalid gate manifest schema");
169
- return {
170
- requiredChecks: unique([task.contract, ...manifests].flatMap(spec => spec.requiredChecks)),
171
- requiredArtifacts: unique([task.contract, ...manifests].flatMap(spec => spec.requiredArtifacts)),
172
- manualGates: unique([task.contract, ...manifests].flatMap(spec => spec.manualGates))
173
- };
174
- }
175
- function current(project, task) {
176
- assert(task.schemaVersion === 2 && task.execution?.name === "standalone", "Unsupported standalone task record");
177
- taskPath(project, task.id);
178
- assert(task.executionHash === digest(task.execution) && task.executionHash === digest(resolveExecution(project)), "Execution policy changed; preserve this task and explicitly migrate/replan before claiming completion");
179
- assert(task.pipelineHash === digest(loadPipeline(project)), "Pipeline policy changed; create a new task against the current policy");
180
- assert(task.contractHash === contractHash(task), "Task contract hash mismatch");
181
- requireDesignReady(project, task);
182
- verifyArtifact(project, task.intake);
183
- for (const source of task.contract.sources ?? []) verifyArtifact(project, source);
184
- assert(digest(task.projectPolicy) === digest(optionalArtifact(project, ".nccgs/project.yaml")) && digest(task.projectGates) === digest(optionalArtifact(project, ".nccgs/gates.json")), "Project policy/gate inputs changed; refresh-inputs before recording fresh evidence");
185
- assert(task.canonicalInputs?.sha256 === canonicalInputs(project).sha256, "Canonical inputs are stale; refresh-inputs and record fresh evidence");
186
- assert(validTime(task.canonicalInputs.pinnedAt), "Invalid canonical input pin");
187
- assert(task.risk === task.classification.risk, "Classification risk mismatch");
188
- const expected = routeFor(project, task.execution, task.risk).route;
189
- assert(digest(task.implementationRoute) === digest(expected), "Implementation route differs from selected tier/profile");
190
- const budget = validateBudget(task);
191
- const captured = snapshot(project, task), snap = captured.sha256;
192
- if (task.mode !== "implement") assert(captured.sourceSha256 === task.analysisBaseline, "Audit/plan task modified source; restore the source before verification (analysis artifacts are allowed only in declared evidence paths)");
193
- return { snap, budget, obligations: obligations(project, task) };
194
- }
195
- function modelMatches(actual, configured) {
196
- if (["sonnet", "opus", "haiku", "fable"].includes(configured)) return new RegExp(`^claude-${configured}-\\d[\\w.-]*$`).test(actual ?? "");
197
- return /^claude-[\w.-]+-\d[\w.-]*$/.test(actual ?? "") && actual === configured;
198
- }
199
- export function validateStandaloneRuntime(project, task, stage, expected, snap) {
200
- const trace = json(verifyArtifact(project, stage.runtime));
201
- assert(trace.schemaVersion === 1 && trace.origin === "runtime-observation", "Runtime evidence must be an observation, not model configuration");
202
- assert(trace.taskId === task.id && trace.snapshot === snap && trace.contractHash === task.contractHash, "Runtime observation task/snapshot/contract mismatch");
203
- assert(trace.observedProvider === "claude-code", "Verified standalone execution requires observedProvider claude-code; other providers or missing identity are not evidence");
204
- assert(trace.status === "completed" && nonempty(trace.sessionId) && nonempty(trace.agentId), "Runtime observation is incomplete");
205
- assert(validTime(trace.capturedAt) && Date.parse(trace.capturedAt) >= Math.max(Date.parse(task.createdAt), Date.parse(task.canonicalInputs.pinnedAt)), "Runtime observation predates current input pin or has invalid time");
206
- const models = trace.modelsUsed?.length ? trace.modelsUsed : [trace.observedModel];
207
- assert(modelMatches(trace.observedModel, expected.model) && models.every(model => modelMatches(model, expected.model)), "Observed model/fallback does not satisfy selected profile route");
208
- const unknown = trace.observedEffort === null || trace.observedEffort === undefined || trace.observedEffort === "UNKNOWN";
209
- assert(!unknown || task.execution.requireObservedEffort === false, "Observed effort is UNKNOWN and execution policy requires observation");
210
- if (!unknown) assert(["low", "medium", "high", "xhigh", "max"].includes(trace.observedEffort) && (expected.effort === null || trace.observedEffort === expected.effort), "Observed effort does not match selected route");
211
- const source = json(verifyArtifact(project, trace.observationSource));
212
- for (const key of ["taskId", "snapshot", "contractHash", "observedProvider", "sessionId", "agentId", "toolUseId", "capturedAt", "status", "dispatchId"]) assert(source[key] === trace[key], `Runtime raw source ${key} mismatch`);
213
- assert((source.observedModel ?? source.resolvedModel) === trace.observedModel && (source.observedEffort ?? null) === (trace.observedEffort ?? null), "Observation model/effort differs from raw source");
214
- assert(digest(source.modelsUsed?.length ? source.modelsUsed : [source.observedModel ?? source.resolvedModel]) === digest(models), "Observation changed raw fallback history");
215
- assert(["provider-log", "operator-observation"].includes(source.provenance?.kind) && nonempty(source.provenance.reference), "Runtime raw source provenance is missing");
216
- assert(stage.runtime.path.startsWith(".nccgs/evidence/runtime/observations/") && trace.observationSource.path.startsWith(".nccgs/evidence/runtime/sources/"), "Runtime evidence must use durable observations and sources");
217
- return { ...trace, effortEvidence: unknown ? "UNKNOWN" : "OBSERVED" };
218
- }
219
- function stageCurrent(task, name, snap) {
220
- const stage = task.stages[name];
221
- assert(stage && stage.snapshot === snap && stage.contractHash === task.contractHash, `${name}: missing or stale for current snapshot/contract`);
222
- assert(validTime(stage.recordedAt) && Date.parse(stage.recordedAt) >= Date.parse(task.canonicalInputs.pinnedAt), `${name}: invalid recording time`);
223
- return stage;
224
- }
225
- function verification(project, task, input, spec, snap) {
226
- assert(Array.isArray(input.checks) && input.checks.length > 0, "Output requires verification evidence");
227
- for (const check of input.checks) {
228
- assert(nonempty(check.name) && check.status === "PASS", "Verification contains failed or unproven checks");
229
- const file = verifyArtifact(project, check.evidence);
230
- if (check.evidence.path.endsWith(".json")) {
231
- const data = json(file);
232
- assert(data.origin !== "unity-repair-operation", "Unity repair operation receipts are not verification evidence; run the original declared checks");
233
- if (data.origin === "verification-command") {
234
- assert(data.taskId === task.id && data.name === check.name && data.snapshot === snap && data.contractHash === task.contractHash && data.status === "PASS" && data.exitCode === 0 && data.sourceUnchanged === true, "Verification execution failed or stale");
235
- assert(Date.parse(data.startedAt) >= Date.parse(task.canonicalInputs.pinnedAt), "Verification predates current input pin");
236
- verifyArtifact(project, data.log);
237
- }
238
- if (data.origin === "design-contract-validation") verifyDesignReceipt(project, task, input, data);
239
- }
240
- }
241
- for (const name of spec.requiredChecks) assert(input.checks.some(item => item.name === name && item.status === "PASS"), `Required check missing: ${name}`);
242
- }
243
- function inspectWork(project, task, context) {
244
- const name = firstStage(task), stage = stageCurrent(task, name, context.snap);
245
- assert(task.contract.readiness !== "needs-product-decision", "Task still needs a product decision; update classification with its source before verification");
246
- const trace = validateStandaloneRuntime(project, task, stage, task.implementationRoute, context.snap);
247
- validateStageDispatch(project, task, stage, trace, name);
248
- verification(project, task, stage, context.obligations, context.snap);
249
- if (name === "analysis") {
250
- assert(task.contract.analysisArtifacts.includes(stage.evidence?.path), "Analysis result must be a declared analysis artifact");
251
- verifyArtifact(project, stage.evidence);
252
- if (task.contract.workflow === "design") {
253
- const receipt = stage.checks.find(item => item.name === "design-contract");
254
- assert(receipt, "Design analysis requires a design-contract validation receipt");
255
- verifyDesignReceipt(project, task, stage, json(verifyArtifact(project, receipt.evidence)));
256
- }
257
- }
258
- return trace;
259
- }
260
- function inspectReview(project, task, context, implementer, allowNegative = false) {
261
- const stage = stageCurrent(task, "review", context.snap);
262
- const trace = validateStandaloneRuntime(project, task, stage, task.execution.profile.models.review, context.snap);
263
- const dispatch = validateStageDispatch(project, task, stage, trace, "review");
264
- verifyReviewHandoff(project, task, stage, dispatch);
265
- assert(`${trace.sessionId}/${trace.agentId}` !== `${implementer.sessionId}/${implementer.agentId}`, "Internal review must be independent of implementation/analysis");
266
- assert(Date.parse(trace.capturedAt) >= Date.parse(task.stages[firstStage(task)].recordedAt), "Review observation predates its output evidence");
267
- assert(["PASS", "CHANGES_REQUIRED", "BLOCKED"].includes(stage.verdict) && Array.isArray(stage.findings) && typeof stage.criteriaMet === "boolean", "Invalid internal review result");
268
- validateFindings(stage.findings);
269
- if (task.contract.workflow === "design") {
270
- // A concrete acceptance gap cannot be waived by labelling it MEDIUM/ACCEPTED.
271
- for (const finding of stage.findings) assert(["none", "false-pass", "missing-coverage", "authority-gap"].includes(finding.acceptanceImpact),
272
- "Design findings must classify acceptanceImpact as none, false-pass, missing-coverage or authority-gap");
273
- if (stage.verdict === "PASS") assert(!stage.findings.some(f => f.acceptanceImpact !== "none" && f.status !== "RESOLVED"),
274
- "Design acceptance has unresolved coverage/authority gaps or false-pass routes; revise the document and independently review it before PASS");
275
- }
276
- verifyArtifact(project, stage.evidence);
277
- if (!allowNegative || stage.verdict === "PASS") {
278
- assert(stage.verdict === "PASS", "Internal review has not passed");
279
- if (task.contract.workflow === "design") {
280
- const analysis = task.stages.analysis;
281
- const receipt = analysis.checks.find(item => item.name === "design-contract");
282
- const document = verifyDesignReceipt(project, task, analysis, json(verifyArtifact(project, receipt.evidence)));
283
- assert(document.readiness !== "BLOCKED", "BLOCKED design cannot receive a PASS review");
284
- }
285
- assert(stage.criteriaMet && !stage.findings.some(f => ["BLOCKER", "HIGH"].includes(f.severity) && f.status !== "RESOLVED"), "Review has unresolved blocking findings or acceptance criteria");
286
- const assessment = assessCriteria(project, task, context.snap);
287
- assert(assessment.automaticPassed, `Acceptance criteria not proven: ${assessment.criteria.filter(c => !["PASS", "MANUAL_PENDING"].includes(c.status)).map(c => `${c.id}=${c.status}`).join(", ")}`);
288
- }
289
- return trace;
290
- }
291
- function externalStatus(project, task, context, required) {
292
- if (task.execution.externalReview.mode === "off") return { mode: "off", findings: [] };
293
- const currentReceipts = (task.externalReviews ?? []).filter(item => item.snapshot === context.snap && item.contractHash === task.contractHash);
294
- const receipts = currentReceipts.map(item => {
295
- try { verifyArtifact(project, item.evidence); return item; }
296
- catch (error) { if (required) throw error; return { ...item, evidenceWarning: error.message }; }
297
- });
298
- const latest = receipts.at(-1);
299
- const superseded = new Map(receipts.flatMap(receipt => (receipt.supersedes ?? []).map(id => [id, receipt.id])));
300
- const effective = receipts.filter(receipt => !superseded.has(receipt.id));
301
- if (required) {
302
- assert(latest, "Required external review is missing");
303
- assert(effective.every(receipt => receipt.verdict === "PASS"), "Required external review has not passed; earlier negative receipts need explicit supersession");
304
- assert(!effective.some(receipt => receipt.findings.some(f => ["BLOCKER", "HIGH"].includes(f.severity) && f.status !== "RESOLVED")), "Required external review has unresolved blocking findings");
305
- }
306
- return { mode: task.execution.externalReview.mode, verdict: latest?.verdict ?? "MISSING", warnings: receipts.filter(item => item.evidenceWarning).map(item => item.evidenceWarning), findings: receipts.flatMap(receipt => receipt.findings.map(finding => ({ ...finding, actor: receipt.actor, source: receipt.source, receiptId: receipt.id, supersededBy: superseded.get(receipt.id) ?? null }))) };
307
- }
308
- function inspectReport(project, task, context) {
309
- const stage = stageCurrent(task, "report", context.snap);
310
- assert(stage.outcome === "success", "Report outcome is not success; partial/blocked/failed never unlock completion");
311
- verifyArtifact(project, stage.evidence);
312
- assert(Date.parse(stage.recordedAt) >= Date.parse(task.stages.review.recordedAt), "Success report predates current review");
313
- for (const relative of context.obligations.requiredArtifacts) {
314
- const ref = stage.artifacts?.find(item => item.path === relative);
315
- assert(ref, `Required closure artifact missing: ${relative}`);
316
- verifyArtifact(project, ref);
317
- }
318
- }
319
- function acceptanceNeeded(task, context) { return task.execution.acceptanceRequired || task.contract.acceptanceRequired || context.obligations.manualGates.length > 0; }
320
- function inspectAcceptance(project, task, context) {
321
- if (!acceptanceNeeded(task, context)) return;
322
- const stage = stageCurrent(task, "acceptance", context.snap);
323
- const data = json(verifyArtifact(project, stage.evidence));
324
- assert(data.actor === "Product Owner" && data.decision === "ACCEPTED", "Explicit Product Owner acceptance is required");
325
- assert(data.taskId === task.id && data.contractHash === task.contractHash && data.snapshot === context.snap, "Acceptance covers another task/contract/snapshot");
326
- assert(nonempty(data.statement) && nonempty(data.reference), "Acceptance requires a decision statement and source reference");
327
- assert(validTime(data.decidedAt) && Date.parse(data.decidedAt) >= Date.parse(task.stages.report.recordedAt) && Date.parse(data.decidedAt) <= Date.parse(stage.recordedAt), "Acceptance predates its report");
328
- for (const id of context.obligations.manualGates) assert(data.gates?.some(item => item.id === id && item.decision === "ACCEPTED" && nonempty(item.reference)), `Manual gate missing: ${id}`);
329
- }
330
- export function checkStandalone(project, task, target = "done") {
331
- if (target === "done") assert(pendingJobs(project, task.id).length === 0, "Verification jobs are pending or uncertain; retain checkpoint, do not close DONE");
332
- const context = current(project, task);
333
- const allowedTargets = [firstStage(task), "review", "report", "acceptance", "done", "external"];
334
- assert(allowedTargets.includes(target), "Invalid standalone gate target");
335
- let executionEvidence = null;
336
- if (target !== firstStage(task)) {
337
- const implemented = inspectWork(project, task, context);
338
- executionEvidence = { observedProvider: implemented.observedProvider, observedModel: implemented.observedModel, observedEffort: implemented.observedEffort ?? null, effortEvidence: implemented.effortEvidence };
339
- if (!["review"].includes(target)) inspectReview(project, task, context, implemented);
340
- if (["acceptance", "done", "external"].includes(target)) inspectReport(project, task, context);
341
- }
342
- const external = externalStatus(project, task, context, ["acceptance", "done"].includes(target) && task.execution.externalReview.mode === "required");
343
- if (target === "done") inspectAcceptance(project, task, context);
344
- const exhausted = target === "review" && context.budget.remaining === 0;
345
- return { allowed: !exhausted, target, snapshot: context.snap, contractHash: task.contractHash, mode: task.mode, risk: task.risk,
346
- implementationRoute: task.implementationRoute, reviewBudget: context.budget, executionEvidence, externalReview: external,
347
- acceptanceRequired: acceptanceNeeded(task, context),
348
- phase: exhausted ? "REVIEW_BUDGET_EXHAUSTED" : target === "done" ? "DONE" : `READY_FOR_${target.toUpperCase()}`,
349
- ...(exhausted ? { message: "Review budget exhausted; stop and escalate. An external extension requires an explicit decision; this is never PASS" } : {}) };
350
- }
351
- function invalidate(task, reason, fields = Object.keys(task.stages)) {
352
- task.history.push({ action: reason, recordedAt: now(), stages: structuredClone(task.stages), closed: task.closed ?? null });
353
- for (const name of fields) delete task.stages[name];
354
- delete task.closed;
355
- }
356
- function reportRecord(project, task, input) {
357
- assert(outcomes.includes(input.outcome), "Report outcome must be success, partial, blocked or failed");
358
- let snap = null, snapshotError = null;
359
- try { snap = snapshot(project, task).sha256; } catch (error) { snapshotError = error.message; }
360
- let verificationState;
361
- let executionSummary;
362
- let acceptanceAssessment;
363
- try {
364
- const context = current(project, task);
365
- acceptanceAssessment = assessCriteria(project, task, context.snap);
366
- } catch (error) { acceptanceAssessment = { automaticPassed: false, status: "UNVERIFIED", reason: error.message }; }
367
- if (input.outcome === "success") assert(acceptanceAssessment.automaticPassed, "Cannot report success: acceptance criteria failed or are unverified; record partial/blocked with the missing evidence");
368
- try {
369
- const ledger = dispatchStatus(project, task.id);
370
- executionSummary = { usage: ledger.usage, limits: ledger.limits, deliveryBudget: ledger.deliveryBudget, active: ledger.active.map(d => d.id), telemetry: ledger.telemetry,
371
- scope: "Worker attempts only; unobserved coordinator, human wait and provider billing are excluded" };
372
- } catch (error) { executionSummary = { unavailable: true, reason: error.message }; }
373
- try {
374
- const status = checkStandalone(project, task, "report");
375
- verificationState = { verified: status.allowed, phase: status.phase, executionEvidence: status.executionEvidence };
376
- } catch (error) { verificationState = { verified: false, reason: error.message }; }
377
- if (input.outcome === "success") assert(verificationState.verified,
378
- `Cannot report success: ${verificationState.reason ?? "current work and independent review are not verified"}; record partial/blocked instead`);
379
- let evidence = input.evidence;
380
- if (evidence) verifyArtifact(project, evidence);
381
- else {
382
- assert(nonempty(input.summary), "Report needs an evidence artifact or a nonempty summary");
383
- const relative = `.nccgs/evidence/reports/${task.id}-${crypto.randomUUID()}.md`;
384
- const file = contained(project, relative);
385
- fs.mkdirSync(path.dirname(file), { recursive: true });
386
- fs.writeFileSync(file, `# ${task.id}\n\nOutcome: ${input.outcome}\n\nVerification: ${verificationState.verified ? "current implementation/analysis and internal review evidence accepted" : `not verified — ${verificationState.reason}`}\n\n${input.summary.trim()}\n\n## Acceptance criteria\n\n\`\`\`json\n${JSON.stringify(acceptanceAssessment, null, 2)}\n\`\`\`\n\n## Dispatch and measurement coverage\n\n\`\`\`json\n${JSON.stringify(executionSummary, null, 2)}\n\`\`\`\n`, { encoding: "utf8", flag: "wx" });
387
- evidence = artifact(project, relative);
388
- }
389
- invalidate(task, "record-report", ["report", "acceptance"]);
390
- task.stages.report = { ...input, evidence, snapshot: snap, contractHash: task.contractHash, recordedAt: now(), snapshotError, verificationState, executionSummary, acceptanceAssessment };
391
- task.outcome = input.outcome;
392
- task.phase = input.outcome === "success" ? "REPORTED" : input.outcome.toUpperCase();
393
- return writeTask(project, task);
394
- }
395
- export function recordStandalone(project, task, name, input) {
396
- assert(task.schemaVersion === 2, "Unsupported standalone task record");
397
- if (name === "report") return reportRecord(project, task, input);
398
- const work = firstStage(task);
399
- assert([work, "review", "acceptance"].includes(name), "Unknown standalone stage for task mode");
400
- if (name === "acceptance") externalOnly();
401
- const status = checkStandalone(project, task, name);
402
- assert(status.allowed, status.message);
403
- assert(input.snapshot === status.snapshot, "Submitted evidence does not cover current snapshot");
404
- if ([work, "review"].includes(name)) {
405
- const previousStages = [...Object.values(task.stages), ...task.history.flatMap(item => Object.values(item.stages ?? {}))];
406
- assert(nonempty(input.dispatchId) && !previousStages.some(stage => stage.dispatchId === input.dispatchId), "A completed dispatch may be recorded only once; reserve a fresh attempt");
407
- }
408
- const candidate = structuredClone(task);
409
- invalidate(candidate, `record-${name}`, name === work ? [work, "review", "report", "acceptance"] : name === "review" ? ["review", "report", "acceptance"] : ["acceptance"]);
410
- candidate.stages[name] = { ...input, contractHash: task.contractHash, recordedAt: now() };
411
- const context = current(project, candidate);
412
- if (name === work) {
413
- inspectWork(project, candidate, context);
414
- candidate.phase = work === "implementation" ? "VERIFIED" : "ANALYZED";
415
- } else if (name === "review") {
416
- inspectReview(project, candidate, context, inspectWork(project, candidate, context), true);
417
- candidate.reviewBudget.used += 1;
418
- candidate.phase = input.verdict === "PASS" ? "REVIEWED" : "BLOCKED";
419
- } else {
420
- inspectAcceptance(project, candidate, context);
421
- candidate.phase = "ACCEPTED";
422
- }
423
- candidate.outcome = null;
424
- return writeTask(project, candidate);
425
- }
426
- export function extendStandalone(project, task, reason, rounds) {
427
- externalOnly();
428
- assert(nonempty(reason), "Review extension requires a reason");
429
- validateBudget(task);
430
- const budget = task.reviewBudget;
431
- assert(Number.isSafeInteger(rounds) && rounds > 0 && rounds <= budget.baseLimit && Number.isSafeInteger(budget.limit + rounds), `Review extension requires an integer from 1 to ${budget.baseLimit}`);
432
- const extension = { at: now(), reason: reason.trim(), rounds, previousLimit: budget.limit, newLimit: budget.limit + rounds };
433
- budget.limit += rounds; budget.extensions.push(extension);
434
- task.history.push({ action: "extend-review", recordedAt: extension.at, ...extension });
435
- return writeTask(project, task);
436
- }
437
- export function reclassifyStandalone(project, task, changes) {
438
- assert(nonempty(changes.reason) && Array.isArray(changes.evidence) && changes.evidence.length > 0, "Reclassification requires a reason and source evidence");
439
- current(project, task);
440
- const previous = { classification: task.classification, contract: task.contract, contractHash: task.contractHash, implementationRoute: task.implementationRoute };
441
- const contract = { ...task.contract };
442
- for (const key of ["scope", "target", "readiness"]) if (changes[key] !== undefined) contract[key] = changes[key];
443
- assert(["local", "feature", "cross-system"].includes(contract.scope) && ["ready", "needs-inspection", "needs-product-decision"].includes(contract.readiness) && ["fix", "learning-prototype", "alpha-ready", "production-change"].includes(contract.target), "Invalid reclassification dimensions");
444
- if (changes.riskSignals) contract.riskSignals = strings(changes.riskSignals, "riskSignals");
445
- if (changes.systems) contract.systems = strings(changes.systems, "systems");
446
- const classification = classify(contract, task.intake, changes.risk || task.risk, changes.reason, changes.evidence);
447
- invalidate(task, "reclassify");
448
- task.history.at(-1).previous = previous;
449
- task.history.at(-1).reason = changes.reason;
450
- task.contract = contract; task.classification = classification; task.risk = classification.risk;
451
- task.implementationRoute = routeFor(project, task.execution, task.risk).route;
452
- task.contractHash = contractHash(task);
453
- task.canonicalInputs.pinnedAt = now();
454
- task.phase = "READY"; task.outcome = null;
455
- return writeTask(project, task);
456
- }
457
- export function refreshStandalone(project, task, reason) {
458
- assert(nonempty(reason), "Input refresh requires a reason");
459
- assert(task.executionHash === digest(resolveExecution(project)) && task.pipelineHash === digest(loadPipeline(project)), "Input refresh cannot migrate changed execution/pipeline policy");
460
- validateBudget(task);
461
- const normalized = normalize(project, task.intake.path, { mode: task.mode, id: task.id });
462
- if (risks.indexOf(normalized.classification.risk) < risks.indexOf(task.risk)) {
463
- normalized.classification = { ...normalized.classification, risk: task.risk,
464
- reason: `Input refresh retains ${task.risk}; lowering the tier requires explicit reclassification with evidence`,
465
- evidence: [...normalized.classification.evidence, { observation: `Previous classification: ${task.classification.reason}` }] };
466
- }
467
- invalidate(task, "refresh-inputs");
468
- task.history.at(-1).previous = { intake: task.intake, contract: task.contract, classification: task.classification, canonicalInputs: task.canonicalInputs };
469
- task.history.at(-1).reason = reason.trim();
470
- Object.assign(task, normalized, projectObligations(project), { canonicalInputs: pinInputs(project), stages: {}, phase: "READY", outcome: null });
471
- task.risk = normalized.classification.risk;
472
- task.implementationRoute = routeFor(project, task.execution, task.risk).route;
473
- task.requirements = task.requirements ? artifact(project, task.requirements.path) : null;
474
- task.contractHash = contractHash(task);
475
- // Do not reset audit/plan source baseline or any spent/allocated budget.
476
- return writeTask(project, task);
477
- }
478
- export function migrateFrameworkBaseline(project, id, relative) {
479
- externalOnly();
480
- const task = json(taskPath(project, id)), reference = artifact(project, relative), decision = json(verifyArtifact(project, reference));
481
- assert(task.schemaVersion === 2 && task.mode !== "implement" && !task.closed, "Framework migration requires an open plan/audit task");
482
- assert(nonempty(decision.reason) && nonempty(decision.authority) && Array.isArray(decision.beforeFiles), "Framework migration requires explicit external authority and original file inventory");
483
- assert(digest(decision.beforeFiles) === task.analysisBaseline, "Original inventory does not match the pinned analysis baseline");
484
- assert(task.executionHash === digest(resolveExecution(project)) && task.pipelineHash === digest(loadPipeline(project)), "Framework migration cannot change execution/pipeline policy");
485
- assert(task.canonicalInputs.sha256 === canonicalInputs(project).sha256, "Framework migration cannot change canonical inputs");
486
- assert(!dispatchStatus(project, id).active.length && !pendingJobs(project).length, "Settle all workers and verification before framework migration");
487
- validateBudget(task);
488
- const captured = snapshot(project, task, { includeFiles: true }), before = new Map(decision.beforeFiles), after = new Map(captured.fileEntries);
489
- const changes = [...new Set([...before.keys(), ...after.keys()])].filter(file => before.get(file) !== after.get(file)).map(file => ({ path: file, before: before.get(file) ?? null, after: after.get(file) ?? null }));
490
- assert(changes.length > 0 && changes.every(change => change.path.startsWith(".claude/")), "Framework migration refuses non-framework source changes");
491
- invalidate(task, "migrate-framework-baseline");
492
- Object.assign(task.history.at(-1), { reference, reason: decision.reason, authority: decision.authority,
493
- previousBaseline: task.analysisBaseline, newBaseline: captured.sourceSha256, changes });
494
- task.analysisBaseline = captured.sourceSha256; task.phase = "READY"; task.outcome = null;
495
- // No evidence is promoted: fresh native analysis and independent review required.
496
- return writeTask(project, task);
497
- }
498
- export function exportExternalStandalone(project, task, relative) {
499
- assert(task.execution.externalReview.mode !== "off", "External review is off for this task");
500
- const context = current(project, task);
501
- assert(nonempty(relative) && relative.startsWith(".nccgs/evidence/external/requests/"), "External export destination must be under .nccgs/evidence/external/requests/");
502
- const packet = { schemaVersion: 1, kind: "external-review-request", taskId: task.id, contractHash: task.contractHash, snapshot: context.snap,
503
- requestedAt: now(), mode: task.mode, risk: task.risk, contract: task.contract, stages: task.stages, priorReviews: task.externalReviews };
504
- const file = contained(project, relative);
505
- fs.mkdirSync(path.dirname(file), { recursive: true });
506
- fs.writeFileSync(file, `${JSON.stringify(packet, null, 2)}\n`, { encoding: "utf8", flag: "wx" });
507
- const ref = artifact(project, relative);
508
- task.history.push({ action: "export-external", recordedAt: now(), evidence: ref });
509
- writeTask(project, task);
510
- return ref;
511
- }
512
- export function importExternalStandalone(project, task, relative) {
513
- externalOnly();
514
- assert(task.execution.externalReview.mode !== "off", "External review is off for this task");
515
- const context = current(project, task);
516
- const imported = artifact(project, relative), receipt = json(verifyArtifact(project, imported));
517
- assert(receipt.schemaVersion === 1 && receipt.taskId === task.id && receipt.contractHash === task.contractHash && receipt.snapshot === context.snap, "External review receipt is stale or belongs to another task/contract/snapshot");
518
- assert(nonempty(receipt.id) && nonempty(receipt.actor) && nonempty(receipt.source) && ["PASS", "CHANGES_REQUIRED", "BLOCKED", "REJECTED"].includes(receipt.verdict) && Array.isArray(receipt.findings), "External receipt needs id, actor, verdict, findings and source");
519
- validateFindings(receipt.findings);
520
- const supersedes = strings(receipt.supersedes ?? [], "supersedes");
521
- if (supersedes.length) {
522
- assert(nonempty(receipt.supersessionReason), "Receipt supersession requires an explicit reason");
523
- for (const id of supersedes) assert(task.externalReviews.some(previous => previous.id === id && previous.contractHash === task.contractHash && previous.snapshot === context.snap), "Only existing receipts for the current contract/snapshot can be superseded");
524
- }
525
- assert(validTime(receipt.reviewedAt) && Date.parse(receipt.reviewedAt) >= Date.parse(task.canonicalInputs.pinnedAt), "External receipt time predates current contract/input pins");
526
- const duplicate = task.externalReviews.find(item => item.id === receipt.id);
527
- if (duplicate) {
528
- assert(duplicate.evidence.sha256 === imported.sha256, "External receipt ID already exists with different content");
529
- return task;
530
- }
531
- const durable = `.nccgs/evidence/external/receipts/${imported.sha256}.json`;
532
- const destination = contained(project, durable);
533
- fs.mkdirSync(path.dirname(destination), { recursive: true });
534
- if (!fs.existsSync(destination)) fs.writeFileSync(destination, fs.readFileSync(verifyArtifact(project, imported)), { flag: "wx" });
535
- const evidence = artifact(project, durable);
536
- assert(evidence.sha256 === imported.sha256, "External receipt durable evidence collision");
537
- const stored = { ...receipt, evidence, importedAt: now() };
538
- task.externalReviews.push(stored);
539
- task.history.push({ action: "import-external", recordedAt: stored.importedAt, evidence });
540
- delete task.stages.acceptance; delete task.closed;
541
- return writeTask(project, task);
542
- }
@@ -1,30 +0,0 @@
1
- import { hash } from "./policy.mjs";
2
-
3
- // This provider-designated block is an inventory, not an incomplete-run notice.
4
- // Match the entire block and a bounded identifier list; unknown mixed text must
5
- // continue to fail closed. Never recognize this marker in model-authored prose.
6
- const toolSummary = /^\s*<tools-used-before-summary>[A-Za-z][A-Za-z0-9_.:-]*(?:\s*,\s*[A-Za-z][A-Za-z0-9_.:-]*)*<\/tools-used-before-summary>\s*$/;
7
- const informationalNote = block => block?.type === "text"
8
- && typeof block.text === "string" && block.text.length <= 4096
9
- && toolSummary.test(block.text);
10
-
11
- // The native harness reports an ended invocation as "completed" even when its
12
- // worker hit maxTurns. Inspect only harness-designated blocks, never the model's
13
- // prose. Store a diagnosis/hash, not prompts or arbitrary tool-result content.
14
- export function nativeCompletion(response) {
15
- const reportedStatus = response?.status ?? "unknown";
16
- const count = response?.harnessNoteCount ?? 0, tail = response?.harnessTailCount ?? 0;
17
- const blocks = response?.content;
18
- const valid = Number.isSafeInteger(count) && count >= 0 && Number.isSafeInteger(tail) && tail >= 0
19
- && ((count + tail === 0) || (Array.isArray(blocks) && count + tail <= blocks.length));
20
- if (!valid) return { reportedStatus, status: "failed", reason: "invalid-harness-metadata", turnLimit: null, noteHash: null };
21
- const notes = count + tail ? [...blocks.slice(0, count), ...(tail ? blocks.slice(-tail) : [])] : [];
22
- const noteText = notes.map(block => block?.type === "text" && typeof block.text === "string" ? block.text : "").join("\n");
23
- const limit = noteText.match(/\bthis agent stopped at its (\d+)-turn limit before finishing\b/i);
24
- // A previously unseen harness advisory needs reconciliation; it cannot silently
25
- // certify completion. Text outside these provider-designated blocks is ignored.
26
- const reason = limit ? "turn-limit"
27
- : notes.length && !notes.every(informationalNote) ? "unrecognized-harness-notice" : null;
28
- return { reportedStatus, status: reason ? "failed" : reportedStatus, reason,
29
- turnLimit: limit ? Number(limit[1]) : null, noteHash: notes.length ? hash(noteText) : null };
30
- }