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
@@ -0,0 +1,58 @@
1
+ # Cloud Code Reference
2
+
3
+ ## Table of Contents
4
+
5
+ - [Four Execution Models](#four-execution-models)
6
+ - [Cloud Code Modules vs CloudBehaviours](#cloud-code-modules-vs-cloudbehaviours)
7
+ - [Where the details live](#where-the-details-live)
8
+
9
+ Accessed via `CloudCodeService.Instance` (`ICloudCodeService`, namespace `Unity.Services.CloudCode`). Assembly: `Unity.Services.CloudCode`.
10
+
11
+ Call `UnityServices.InitializeAsync()` from `com.unity.services.core` and sign in via `com.unity.services.authentication` before use.
12
+
13
+ ---
14
+
15
+ ## Four Execution Models
16
+
17
+ | Model | Language | Client Method | Deployed as |
18
+ |---|---|---|---|
19
+ | **Scripts** | JavaScript | `CallEndpointAsync` | `.js` files via Deployment Window |
20
+ | **Legacy modules** | C# (.NET 8, up to .NET 10) | generated bindings, or `CallModuleEndpointAsync` | `.ccmr` references to a .NET solution built outside Unity |
21
+ | **Cloud Code modules** | C# (.NET 8; .NET 10 on Unity 6.7+) | generated bindings only | `.ccmu` assets, authored natively in the Editor |
22
+ | **CloudBehaviours** (experimental) | C# (.NET 8; .NET 10 on Unity 6.7+) | generated bindings — `await behaviour.Method(args)` | `.ccmu` assets, authored natively in the Editor |
23
+
24
+ **Recommendation:** Prefer **C#** over JavaScript scripts for production — type safety, generated client
25
+ bindings, and access to NuGet packages. Do not write new scripts; maintain and call existing ones. Prefer authoring
26
+ natively in the Editor (`.ccmu`) over a `.ccmr` reference for new work: the module lives in the project,
27
+ compiles with it, and needs no separate solution. Between Cloud Code modules and CloudBehaviours, see
28
+ the breakdown below.
29
+
30
+ ### Cloud Code Modules vs CloudBehaviours
31
+
32
+ Both are C# modules, and both can hold state per scope with `[StateScope]`. They differ in how the client
33
+ reaches them and in whether that state reaches the client on its own:
34
+
35
+ | | Cloud Code modules | CloudBehaviours |
36
+ |---|---|---|
37
+ | **Endpoint naming** | one function per `[CloudCodeFunction]` | one generated `[CloudCodeFunction]` per public method you define, named `Behaviour__Method` |
38
+ | **Scoped state** | `[StateScope]` persists public fields per player or session | the same, and public fields also synchronize to clients |
39
+ | **Client updates** | request/response; subscribe by hand for push messages | synchronized fields and push events arrive on the generated bindings |
40
+ | **Client code** | you write the call and deserialize the result | the bindings partial is generated from the cloud class |
41
+ | **Requires** | `com.unity.services.cloudcode` `3.0.0`+, Unity 6000.5+ | `com.unity.services.cloudcode` `3.1.0-exp.1`+, Unity 6000.5+ |
42
+
43
+ **Use CloudBehaviours when clients need to see the state** — shared match state, an inventory the client
44
+ displays, per-player views of a shared secret, or a server-owned timer whose deadline the client shows.
45
+ The bindings, the synchronization and the push plumbing are generated, so it is less code and less
46
+ error-prone than a module plus hand-written calls and subscriptions.
47
+
48
+ **Use Cloud Code modules when the client only needs the result of a call** — validating a purchase, awarding a
49
+ reward, calling another service, running a trigger on a schedule. Scoped state still works; simpler than
50
+ using CloudBehaviours if there is no need for state synchronization.
51
+
52
+ ## Where the details live
53
+
54
+ | Reference | Covers |
55
+ | :-- | :-- |
56
+ | `references/cloud-code-modules.md` | Cloud Code modules (`.ccmu`), legacy modules (`.ccmr`) and scripts — creating a `.ccmu`, the `.ccmu` asset and how the deployed module name is derived, `ICloudCodeService`, subscriptions, triggers, module scope, generated bindings, deployment, error handling |
57
+ | `references/cloud-code-cloudbehaviours.md` | CloudBehaviours — the authoring model, synchronized state, per-viewer projections, timers, access control |
58
+
@@ -93,7 +93,7 @@ Task<List<EntityData>> QueryAsync(Query query, QueryOptions options)
93
93
  Read-only from the client. Write via Cloud Code modules or `IAdminClient.CloudSaveData` from the `com.unity.services.apis` package. All methods require a `customDataID` parameter -- the namespace configured in the Unity Dashboard.
94
94
 
95
95
  > **To write Custom Data from the editor or a deploy command**, use `IAdminClient.CloudSaveData.SetCustomItem` /
96
- > `SetCustomItemBatch`. See [apis.md](apis.md) for setup and code templates. The client SDK has no write
96
+ > `SetCustomItemBatch`. See `references/apis.md` for setup and code templates. The client SDK has no write
97
97
  > path for Custom Data.
98
98
 
99
99
  ```csharp
@@ -448,27 +448,17 @@ catch (CloudSaveException ex)
448
448
 
449
449
  ### `CloudSaveExceptionReason` Enum
450
450
 
451
- | Reason | Value | Meaning |
452
- |---|---|---|
453
- | `Unknown` | 0 | Unknown error |
454
- | `NoInternetConnection` | 1 | No network |
455
- | `ProjectIdMissing` | 2 | Project ID not set |
456
- | `PlayerIdMissing` | 3 | Player not signed in |
457
- | `AccessTokenMissing` | 4 | No access token |
458
- | `InvalidArgument` | 5 | Bad input |
459
- | `Unauthorized` | 6 | Not authorized |
460
- | `KeyLimitExceeded` | 7 | Too many keys stored |
461
- | `NotFound` | 8 | Key not found |
462
- | `TooManyRequests` | 9 | Rate limited |
463
- | `ServiceUnavailable` | 10 | Service down |
464
- | `Conflict` | 11 | Write-lock conflict |
465
-
466
- ---
467
-
468
- ## Asset Store Building Blocks
469
-
470
- The following Building Blocks from the Unity Asset Store demonstrate Cloud Save patterns:
471
-
472
- - **Achievements Building Block** — Reads/writes achievement records in Protected buckets via Cloud Code, with Access Control denying direct player writes. [Asset Store](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-achievements-341918)
473
- - **Player Account Building Block** — Stores player profile data in Default and Public access classes with direct client writes for non-sensitive data. [Asset Store](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-player-account-341928)
474
- - **Leaderboards Building Block** — Uses Cloud Save for player score data alongside Cloud Code modules. [Asset Store](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-leaderboards-341926)
451
+ | Reason | Value | Meaning | Fix |
452
+ |---|---|---| :-- |
453
+ | `Unknown` | 0 | Unknown error | Log `ex.Message`, retry once, then report it |
454
+ | `NoInternetConnection` | 1 | No network | Retry when connectivity returns |
455
+ | `ProjectIdMissing` | 2 | Project ID not set | Link the project in **Project Settings > Services** |
456
+ | `PlayerIdMissing` | 3 | Player not signed in | Sign in before calling Cloud Save |
457
+ | `AccessTokenMissing` | 4 | No access token | Sign in and check the token has not expired |
458
+ | `InvalidArgument` | 5 | Bad input | Correct the keys or values named in the validation details |
459
+ | `Unauthorized` | 6 | Not authorized | Check the access class and any Access Control policy denying the call |
460
+ | `KeyLimitExceeded` | 7 | Too many keys stored | Delete unused keys |
461
+ | `NotFound` | 8 | Key not found | Check the key and the access class used to read it |
462
+ | `TooManyRequests` | 9 | Rate limited | Back off and retry after `RetryAfter` |
463
+ | `ServiceUnavailable` | 10 | Service down | Retry with backoff |
464
+ | `Conflict` | 11 | Write-lock conflict | Reload the keys, merge your change and retry with the new write lock |
@@ -32,14 +32,16 @@ Each service package registers its own file types with the Deployment Window. In
32
32
  | Service | Package | File Type(s) | Min Version |
33
33
  |---|---|---|---|
34
34
  | Cloud Code Scripts | `com.unity.services.cloudcode` | `.js` | 2.1.0 |
35
- | Cloud Code C# Modules | `com.unity.services.cloudcode` | `.ccmr` | 2.5.0 |
35
+ | Cloud Code C# Modules (native) | `com.unity.services.cloudcode` | `.ccmu` | 3.0.0 |
36
+ | Cloud Code C# Modules (legacy) | `com.unity.services.cloudcode` | `.ccmr` | 2.5.0 |
36
37
  | Remote Config | `com.unity.remote-config` | `.rc` | 3.2.0 |
37
- | Economy | `com.unity.services.economy` | `.ecc`, `.eci`, `.ecv`, `.ecr` | 3.2.1 |
38
38
  | Leaderboards | `com.unity.services.leaderboards` | `.lb` | 2.0.0 |
39
39
  | Game Server Hosting | `com.unity.services.multiplayer` | `.gsh` | 1.1.0 |
40
40
  | Matchmaker | `com.unity.services.multiplayer` | `.mmq` | 1.0 |
41
41
  | Game Overrides | `com.unity.services.tooling` | `.ugo` | 1.3.0 |
42
42
  | Access Control | `com.unity.services.tooling` | `.ac` | 1.0 |
43
+ | Triggers | `com.unity.services.tooling` | `.tr` | 1.4.2 |
44
+ | Scheduler | `com.unity.services.tooling` | `.sched` | 1.4.2 |
43
45
  | Deployment Definitions | `com.unity.services.deployment` | `.ddef` | -- |
44
46
 
45
47
  ## Workflow
@@ -190,27 +192,40 @@ static void RegisterProvider()
190
192
  > `com.unity.services.apis` package (`com.unity.services.apis`). Authenticate with a service
191
193
  > account via `adminClient.SetServiceAccount(keyId, keySecret)`, then call the appropriate
192
194
  > admin API (e.g. `adminClient.CloudSaveData.SetCustomItem` for Cloud Save game data).
193
- > See [apis.md](apis.md) for the full `IAdminClient` interface and code templates.
195
+ > See `references/apis.md` for the full `IAdminClient` interface and code templates.
194
196
 
195
197
  ### Code Template -- Trigger Deployment Programmatically
196
198
 
199
+ Run it with `unity command run_script --file AgentScripts/Deploy.cs --entry Deploy.Run --args '[["Assets/MyConfig.rc"]]'`
200
+ (needs the `com.unity.pipeline` and `com.unity.services.deployment.api` packages; keep the file outside `Assets/`). `DeploymentWindow` throws
201
+ *"Deployment Window must be opened for this operation."* until the window is open, so the script opens it
202
+ and waits.
203
+
197
204
  ```csharp
205
+ // AgentScripts/Deploy.cs — deploys to the active environment. Await; never .Wait(), which deadlocks the main thread.
206
+ using System.Linq;
207
+ using System.Threading.Tasks;
198
208
  using Unity.Services.DeploymentApi.Editor;
209
+ using UnityEditor;
199
210
 
200
- // Deploy all items
201
- var allItems = Deployments.Instance.DeploymentWindow.GetAllDeploymentItems();
202
- var result = await Deployments.Instance.DeploymentWindow.Deploy(allItems);
203
-
204
- // Deploy by file paths
205
- await Deployments.Instance.DeploymentWindow.Deploy(new[] { "Assets/MyConfig.rc" });
206
-
207
- // Listen for deployment events
208
- Deployments.Instance.DeploymentWindow.DeploymentStarting += items =>
209
- {
210
- Debug.Log($"Deploying {items.Count} items...");
211
- };
212
- Deployments.Instance.DeploymentWindow.DeploymentEnded += items =>
211
+ public static class Deploy
213
212
  {
214
- Debug.Log($"Deployment complete: {items.Count} items");
215
- };
213
+ public static async Task<string> Run(string[] paths)
214
+ {
215
+ var deployments = Deployments.Instance;
216
+ if (!(deployments.DeploymentWindow is EditorWindow))
217
+ deployments.DeploymentWindow.OpenWindow();
218
+ for (var i = 0; i < 100 && !(deployments.DeploymentWindow is EditorWindow); i++)
219
+ await Task.Delay(100);
220
+
221
+ var items = deployments.DeploymentWindow.GetFromFiles(paths);
222
+ var found = items.Where(item => item != null).ToList();
223
+ // Deploy all items instead: await deployments.DeploymentWindow.Deploy(deployments.DeploymentWindow.GetAllDeploymentItems());
224
+ if (found.Count > 0)
225
+ await deployments.DeploymentWindow.Deploy(found);
226
+ return string.Join("\n", paths.Select((path, i) => items[i] == null
227
+ ? $"{path}: not a deployable item"
228
+ : $"{path}: {items[i].Status.MessageSeverity} {items[i].Status.Message} {items[i].Status.MessageDetail}"));
229
+ }
230
+ }
216
231
  ```
@@ -31,7 +31,6 @@
31
31
  - [PlayerAccountsException](#playeraccountsexception)
32
32
  - [CloudSaveException](#cloudsaveexception)
33
33
  - [Validation](#validation)
34
- - [Asset Store Building Block](#asset-store-building-block)
35
34
 
36
35
  ---
37
36
 
@@ -124,9 +123,13 @@ Ensure the following packages are listed in `Packages/manifest.json`:
124
123
  **Optional** — add `com.unity.services.cloudcode` if using Protected player data or Custom (shared) data:
125
124
 
126
125
  ```json
127
- "com.unity.services.cloudcode": "2.10.3"
126
+ "com.unity.services.cloudcode": "3.0.0"
128
127
  ```
129
128
 
129
+ > `com.unity.services.cloudcode` **`3.0.0`** is the native-authoring line, which the `.ccmu` module
130
+ > below requires — see the Requirements section of `references/cloud-code-modules.md`. The `2.10.x` line
131
+ > deploys legacy `.ccmr` modules only; use it when maintaining one, not for new work.
132
+
130
133
  ---
131
134
 
132
135
  ## Sign-In: Anonymous
@@ -437,13 +440,24 @@ if (result.TryGetValue("player_level", out var item))
437
440
 
438
441
  Writes to Protected and Custom buckets must go through a Cloud Code module. The module uses `IGameApiClient` with the service token to call Cloud Save server-side APIs.
439
442
 
440
- To create the module, follow [cloud-code.md — Module Creation](cloud-code.md#module-creation). All scaffolding files are required:
443
+ Create it with the Editor rather than by hand: right-click a folder under `Assets/` →
444
+ **Create > Services > Cloud Code Module Script** and name it `PlayerAccountModule`. See
445
+ the Creating a Cloud Code Module section of `references/cloud-code-modules.md`.
446
+ The Editor generates the following — use the list to check what you got, not as files to type out. There is
447
+ no `.sln`, `.csproj`, `.pubxml` or test project.
448
+
449
+ - [ ] `Assets/CloudCode/PlayerAccountModule/PlayerAccountModule.ccmu` (holds the two asmdef GUIDs)
450
+ - [ ] `Cloud/PlayerAccountModule.asmdef` — Editor-only, `noEngineReferences`, `autoReferenced: false`
451
+ - [ ] `Cloud/PlayerAccountModule.cs` — rename/replace with the `[CloudCodeFunction]` endpoints
452
+ - [ ] `Client/PlayerAccountModuleClient.asmdef` — references the cloud assembly
453
+ - [ ] `Client/PlayerAccountModuleClient.cs` — `[CloudModuleClient(typeof(PlayerAccountModule))]` partial
454
+
455
+ One file the Editor does **not** generate, which this module needs because its endpoints inject
456
+ `IGameApiClient`:
441
457
 
442
- - [ ] `.sln` (generate fresh GUIDs)
443
- - [ ] `.csproj` (net9.0, CloudCode.Apis + CloudCode.Core)
444
- - [ ] `ModuleSetup.cs` (registers `GameApiClient`)
445
- - [ ] `Properties/PublishProfiles/FolderProfile.pubxml` — **without this file, deployment fails with "Failed to retrieve main project"**
446
- - [ ] `Assets/CloudCode/<ModuleName>.ccmr` (points to the `.sln`)
458
+ - [ ] `Cloud/CloudSetup.cs` — an `ICloudCodeSetup` calling `config.AddGameApiClient()`
459
+
460
+ The deployed module name is the **cloud asmdef's name** (`PlayerAccountModule`), not the `.ccmu` filename.
447
461
 
448
462
  ---
449
463
 
@@ -741,11 +755,11 @@ catch (RequestFailedException ex)
741
755
 
742
756
  Key error codes:
743
757
 
744
- | Constant | Value | Meaning |
745
- |---|---|---|
746
- | `AccountAlreadyLinked` | 10003 | Username already exists (on sign-up) or external ID already linked |
747
- | `InvalidParameters` | 10002 | Bad input parameters |
748
- | `ClientInvalidUserState` | 10000 | Operation not valid in current state |
758
+ | Constant | Value | Meaning | Fix |
759
+ |---|---|---| :-- |
760
+ | `AccountAlreadyLinked` | 10003 | Username already exists (on sign-up) or external ID already linked | Sign in instead on sign-up, or link with `ForceLink` only after the player confirms |
761
+ | `InvalidParameters` | 10002 | Bad input parameters | Validate the input before the call |
762
+ | `ClientInvalidUserState` | 10000 | Operation not valid in current state | Check the player's sign-in state before the call |
749
763
 
750
764
  ### PlayerAccountsException
751
765
 
@@ -764,10 +778,10 @@ catch (PlayerAccountsException ex)
764
778
 
765
779
  Key error codes (from `PlayerAccountsErrorCodes`):
766
780
 
767
- | Constant | Value | Meaning |
768
- |---|---|---|
769
- | `InvalidState` | 10101 | Player is already signed in |
770
- | `MissingClientId` | 10102 | Client ID not configured in Unity Dashboard |
781
+ | Constant | Value | Meaning | Fix |
782
+ |---|---|---| :-- |
783
+ | `InvalidState` | 10101 | Player is already signed in | Check `PlayerAccountService.Instance.IsSignedIn` before `StartSignInAsync` |
784
+ | `MissingClientId` | 10102 | Client ID not configured in Unity Dashboard | Configure the Unity identity provider's client ID in the Unity Dashboard |
771
785
 
772
786
  ### CloudSaveException
773
787
 
@@ -805,9 +819,3 @@ After implementing a player account feature, verify:
805
819
  4. **SignedIn event wiring:** `PlayerAccountService.Instance.SignedIn` is subscribed **before** calling `StartSignInAsync()`. The `StartSignInAsync` Task completes when the browser opens, not when sign-in finishes.
806
820
  5. **Access class matching:** Data saved with `PublicWriteAccessClassOptions` is loaded with `PublicReadAccessClassOptions`. Data saved with no options (Default) is loaded with `DefaultReadAccessClassOptions` or no options. Mismatched access classes return empty results without error.
807
821
  6. **SignOut is synchronous:** `AuthenticationService.Instance.SignOut()` and `PlayerAccountService.Instance.SignOut()` are both `void` methods. Do not `await` them.
808
-
809
- ---
810
-
811
- ## Asset Store Building Block
812
-
813
- - **Player Account Building Block:** Complete reference implementation with sign-in UI (anonymous, Unity browser, username/password), Cloud Save data management, and a Cloud Code module with generated client bindings. [Asset Store](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-player-account-341928)
@@ -45,7 +45,6 @@ Access Control policies permit or deny access to UGS services on a **URN basis**
45
45
 
46
46
  Common use cases:
47
47
  - Deny direct player writes to Cloud Save (force writes through Cloud Code)
48
- - Deny player currency/inventory writes in Economy (only allow purchases)
49
48
  - Restrict Cloud Code module/script invocation to specific endpoints
50
49
  - Deny player account deletion or identity unlinking
51
50
 
@@ -114,17 +113,6 @@ urn:ugs:<service>:/<path>
114
113
  | `urn:ugs:cloud-save:/**/players/public/query**` | Query Public player data |
115
114
  | `urn:ugs:cloud-save:/**/custom/*/items**` | Read game-wide (Custom) data items |
116
115
 
117
- #### Economy (`economy`)
118
-
119
- | URN Pattern | Description |
120
- |---|---|
121
- | `urn:ugs:economy:/**/players/*/config**` | Read player economy configuration |
122
- | `urn:ugs:economy:/**/currencies**` | Player currencies (Read/Write) |
123
- | `urn:ugs:economy:/**/inventory**` | Player inventory (Read/Write) |
124
- | `urn:ugs:economy:/**/purchases/virtual**` | Virtual purchases |
125
- | `urn:ugs:economy:/**/purchases/googleplaystore**` | Google Play Store purchases |
126
- | `urn:ugs:economy:/**/purchases/appleappstore**` | Apple App Store purchases |
127
-
128
116
  #### Leaderboards (`leaderboards`)
129
117
 
130
118
  | URN Pattern | Description |
@@ -196,48 +184,6 @@ Start with a blanket deny, then explicitly allow only what the player needs. Thi
196
184
  "Principal": "Player",
197
185
  "Resource": "urn:ugs:player-auth:/.well-known/**"
198
186
  },
199
- {
200
- "Sid": "Allow-Read-Economy-Config",
201
- "Effect": "Allow",
202
- "Action": ["Read"],
203
- "Principal": "Player",
204
- "Resource": "urn:ugs:economy:/**/players/*/config**"
205
- },
206
- {
207
- "Sid": "Allow-Read-Currencies",
208
- "Effect": "Allow",
209
- "Action": ["Read"],
210
- "Principal": "Player",
211
- "Resource": "urn:ugs:economy:/**/currencies**"
212
- },
213
- {
214
- "Sid": "Allow-Read-Inventory",
215
- "Effect": "Allow",
216
- "Action": ["Read"],
217
- "Principal": "Player",
218
- "Resource": "urn:ugs:economy:/**/inventory**"
219
- },
220
- {
221
- "Sid": "Allow-Virtual-Purchases",
222
- "Effect": "Allow",
223
- "Action": ["Write"],
224
- "Principal": "Player",
225
- "Resource": "urn:ugs:economy:/**/purchases/virtual**"
226
- },
227
- {
228
- "Sid": "Allow-GooglePlay-Purchases",
229
- "Effect": "Allow",
230
- "Action": ["Write"],
231
- "Principal": "Player",
232
- "Resource": "urn:ugs:economy:/**/purchases/googleplaystore**"
233
- },
234
- {
235
- "Sid": "Allow-AppStore-Purchases",
236
- "Effect": "Allow",
237
- "Action": ["Write"],
238
- "Principal": "Player",
239
- "Resource": "urn:ugs:economy:/**/purchases/appleappstore**"
240
- },
241
187
  {
242
188
  "Sid": "Allow-Read-Leaderboards",
243
189
  "Effect": "Allow",
@@ -330,8 +276,6 @@ This policy:
330
276
  - **Denies** all UGS access by default
331
277
  - **Allows** authentication (anonymous, external, session token sign-in; link external ID; read player info)
332
278
  - **Denies** identity unlinking and player deletion (inherited from blanket deny)
333
- - **Allows** economy reads (config, currencies, inventory) and purchases (virtual, Google Play, Apple App Store)
334
- - **Denies** direct currency/inventory writes (inherited from blanket deny — use Cloud Code for server grants)
335
279
  - **Allows** leaderboard reads
336
280
  - **Allows** Cloud Save player data reads/writes for own data (Default items), public data reads, game-wide data reads
337
281
  - **Denies** Cloud Save blanket writes (Protected data only writable via Cloud Code)
@@ -0,0 +1,86 @@
1
+ # UGS CLI Reference
2
+
3
+ ## Table of Contents
4
+
5
+ - [Overview](#overview)
6
+ - [Install and Update](#install-and-update)
7
+ - [If the Unity CLI Itself Is Missing](#if-the-unity-cli-itself-is-missing)
8
+ - [Auth and Project Setup](#auth-and-project-setup)
9
+ - [Running Commands](#running-commands)
10
+ - [Headless Deploy by File Type](#headless-deploy-by-file-type)
11
+ - [Credentials and Environment](#credentials-and-environment)
12
+
13
+ ## Overview
14
+
15
+ The [Unity Gaming Services CLI](https://github.com/Unity-Technologies/unity-gaming-services-cli/) manages UGS resources outside the Unity Editor: deploy and fetch cloud resource files, manage triggers and schedules, and reach admin functionality across all UGS services. Every command in this reference is invoked as `unity ugs <command>` — there is no standalone `ugs` form.
16
+
17
+ ## Install and Update
18
+
19
+ **It ships as a Unity CLI plugin**, so install and update it through the Unity CLI rather than downloading it separately. Before running any `unity ugs` command, confirm the plugin is installed and install it if it's missing:
20
+
21
+ ```bash
22
+ unity plugin list # every component, its state, and where it resolved from — check ugs is "resolved"
23
+ unity plugin install ugs # install the managed copy, if missing
24
+ unity plugin upgrade ugs # re-install when the pinned build changes
25
+ ```
26
+
27
+ If `unity plugin list` shows `ugs` resolved from `path` rather than `managed`, a UGS CLI already on PATH is used instead of the plugin, and may be an older version without the features above (e.g. Hub sign-in needs 2.0.0+). Check `unity ugs --version`; remove the other install or upgrade it.
28
+
29
+ For the plugin system itself (what a managed tool is, `unity plugin remove` / `changelog`), see the **unity-cli** skill.
30
+
31
+ ## If the Unity CLI Itself Is Missing
32
+
33
+ If `unity` is not on PATH at all, `unity plugin install ugs` can't run. Don't stop at a raw "command not found" — tell the user to install the Unity CLI first, following the **unity-cli** skill's own install instructions (its own `--help`/docs are the source of truth for the current install command).
34
+
35
+ ## Auth and Project Setup
36
+
37
+ Before any `unity ugs` command that talks to the backend, the CLI needs credentials and a target project/environment:
38
+
39
+ ```bash
40
+ unity ugs config set project-id <project-id>
41
+ unity ugs config set environment-name <environment-name>
42
+ ```
43
+
44
+ **Developer sign-in — Unity Hub (requires UGS CLI 2.0.0+):** with Unity Hub running and signed in, either run `unity ugs login` with its Hub option (see `unity ugs login --help`) to persist Hub auth, or set `UGS_CLI_USE_HUB_AUTH=true` (also accepts `1`/`yes`/`y`/`t`) to use it for one invocation without logging in — it takes priority over any saved `unity ugs login` and the service-account env vars below for that call. Hub sign-in reads the currently-running Hub's session over its local IPC socket (`/tmp/Unity-hubIPCService.sock` on macOS/Linux, a named pipe on Windows), not a file or keychain, so Hub has to actually be running and signed in on the machine the CLI runs on. The CLI prints bare `ugs` in its messages; run the equivalent as `unity ugs logout` then `unity ugs login`. Hub sign-in failures:
45
+
46
+ | Error string | Cause | Fix |
47
+ | :-- | :-- | :-- |
48
+ | ``Unity Hub is not running. Start Hub or run `ugs logout` then `ugs login` to switch to service account authentication.`` | Hub is not running on this machine | Start Hub and sign in, or switch to a service account |
49
+ | ``Unity Hub user is not signed in. Sign in through Unity Hub or run `ugs logout` then `ugs login` to switch to service account authentication.`` | Hub is running but nobody is signed in | Sign in through Hub, or switch to a service account |
50
+
51
+ Run `unity ugs --version` first — v1.9.0 predates Hub auth; `unity plugin upgrade ugs` if it reports lower than 2.0.0. Note `unity ugs status` does **not** reflect `UGS_CLI_USE_HUB_AUTH` — it only detects a persisted Hub login, so it can still report "no credentials" while a command using the env var succeeds.
52
+
53
+ **Service account — CI / headless:**
54
+
55
+ ```bash
56
+ unity ugs login --service-key-id <id> --secret-key-stdin # prompts for the secret key on stdin
57
+ # or set UGS_CLI_SERVICE_KEY_ID / UGS_CLI_SERVICE_SECRET_KEY instead of logging in
58
+ ```
59
+
60
+ `unity ugs status` reports whether a service account is currently stored. Run `unity ugs login --help` / `unity ugs config --help` to confirm flags against the installed CLI version before relying on this from memory.
61
+
62
+ ## Running Commands
63
+
64
+ Invoke it as `unity ugs <command>`:
65
+
66
+ ```bash
67
+ unity ugs login # or UGS_CLI_SERVICE_KEY_ID / UGS_CLI_SERVICE_SECRET_KEY
68
+ unity ugs deploy . --dry-run
69
+ unity ugs fetch . -s remote-config -e production
70
+ ```
71
+
72
+ ## Headless Deploy by File Type
73
+
74
+ `unity ugs deploy` picks files up by extension and silently skips the rest. A skipped file does not show up in the result at all, so a dry run that lists nothing means nothing was recognised.
75
+
76
+ | Resource | Headless path |
77
+ |---|---|
78
+ | `.ccmu` (native C# module) | **Not the UGS CLI** — `unity ugs deploy` skips `.ccmu`. The Editor compiles the module and deploys it: the Deployment Window, or headlessly the `Deploy.cs` template in `references/deployment.md`. |
79
+ | `.ccmr` (legacy module) | `unity ugs deploy` skips the `.ccmr` itself — pass the `.sln` it points at: `unity ugs deploy Module~/Module.sln`. The CLI runs `dotnet publish` (needs a .NET SDK on PATH). The Deployment Window deploys the `.ccmr` directly. |
80
+ | `.ccm` (packaged module) | `unity ugs deploy <file>.ccm` |
81
+ | `.rc`, `.ac`, `.lb`, `.js`, `.tr`, `.sched` | `unity ugs deploy <paths>` and `unity ugs fetch <path>`, or the Deployment Window. `--dry-run` first; `--reconcile` deletes remote content not in the deploy. `unity ugs tr new-file <name>` / `unity ugs sched new-file <name>` generate a default trigger / schedule config. |
82
+ | `.ugo` (Game Overrides) | **Not the UGS CLI** — `unity ugs deploy` skips `.ugo`. Deploy through the Deployment Window, or headlessly the `Deploy.cs` template in `references/deployment.md`. |
83
+
84
+ ## Credentials and Environment
85
+
86
+ `unity ugs deploy`/`fetch` authenticate using whichever CLI credential is active — a service account (`unity ugs login` or its env vars) or, from 2.0.0+, Unity Hub sign-in (see [Auth and Project Setup](#auth-and-project-setup)) — never as the signed-in Editor user, and take the environment as an argument (`-e <name>`). An Editor deploy uses the Editor's own credentials and the project's *active* environment — except that while the local Cloud Code server runs, a Cloud Code module deploy goes to that server instead. Stop the local server before deploying a module remotely.
@@ -0,0 +1,23 @@
1
+ # Security notes: craft-game-floors
2
+
3
+ This skill has the agent run C# inside the user's open Unity Editor (applying the craft floors:
4
+ materials, lighting, UI, audio, captures) and, for the live floor, wire Unity Gaming Services
5
+ calls in the user's own project. Automated skill scanners flag these as powerful capabilities.
6
+ They are intentional, and limited by the safeguards below.
7
+
8
+ ## Accepted risks
9
+
10
+ | Risk | Capability | Why it is accepted |
11
+ |---|---|---|
12
+ | `SEC_POWER_CAP` | Runs C# in the user's open Editor | It only reaches the Editor the user already has open, on their own machine, as that user, behind the Pipeline capability gate. No code fetched from a remote source is run — the agent runs C# written from this skill's own references, which also require a restore point before project changes. |
13
+ | `SEC_CLOUD` | Wires Cloud Save / Leaderboards / Remote Config client calls (the live floor) | Only against the project's own cloud id, only when a live identity probe succeeds, and declining any floor is one word. Provisioning that needs credentials or the Editor UI is named as a human step, never automated. |
14
+
15
+ ## Mitigations
16
+
17
+ - **Restore point first.** The skill requires a rollback point (a clean commit, or one it creates)
18
+ before changing the project.
19
+ - **Floors are declinable.** Every floor reverses on a word; declines are recorded, not argued.
20
+ - **Only the user's own Editor and project.** Everything runs on this machine as this user.
21
+ - **No remote code.** All executed C# comes from this skill's references.
22
+ - **Mechanics route to their owners.** Mixer routing, UI construction, backend integration, and
23
+ import settings go to their dedicated skills rather than being improvised here.
@@ -0,0 +1,134 @@
1
+ ---
2
+ name: craft-game-floors
3
+ description: "Makes a Unity game look and feel finished: art style, lighting, juice, sound, menus, saves and look scoring. Use when building a new game's first playable version, or when a game looks like programmer art, feels flat or silent, or needs polish."
4
+ allowed-tools:
5
+ - Bash
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ ---
10
+
11
+ # Craft Game Floors
12
+
13
+ A functional game that looks and feels like programmer art reads as a failure to the person who
14
+ asked for it. This skill is the craft layer: **floors** — disciplines where every game needs a
15
+ minimum and the engine's defaults are unacceptable — each carried by a reference below with
16
+ opinionated values, worked examples to imitate, and a verify step. The floors are the heart of the
17
+ **paved** path (Unity's default scaffolding for agent-built games: assumptions declared up front,
18
+ reversible on a word); in this skill, "paved" simply means these floors are always on unless the
19
+ user declines one.
20
+
21
+ **Before starting any floor or diagnosis, open and read the matching reference below and the Unity
22
+ docs pages it links** — your engine knowledge may be out of date, wrong, or for a different
23
+ version. Name the files and pages you read in your report. **Do only what's asked. Don't change
24
+ unrelated assets or files. Avoid long explanations.**
25
+
26
+ Two ways in, same floors:
27
+
28
+ - **During project creation** — the `new-unity-project` skill loads this one and carries the
29
+ floors through the build in the order below.
30
+ - **Mid-project, on any craft ask** ("fix the look", "add sound", "it feels flat", "make a title
31
+ screen", "score it") — jump straight to the matching reference, after the mid-flow check below.
32
+
33
+ **Scope by the ask**: a request that authorizes changes ("fix", "add", "polish") gets the floor
34
+ applied; an assessment-only ask ("score it", "what should I fix?") gets the scored board and
35
+ recommendations, with no project modifications until the user says go.
36
+
37
+ ## Entering mid-flow
38
+
39
+ The references assume an **art bible** (style statement + fixed palette) and, where audio meets
40
+ UI, the **mixer handshake** (exposed params `MusicVol`/`SFXVol`). On an existing project, run
41
+ these in order before the asked-for floor:
42
+
43
+ 1. **Restore point** — confirm a clean commit to roll back to, or create one, before any change.
44
+ 2. **Render pipeline** — read `GraphicsSettings.currentRenderPipeline`: the look floors' verifies
45
+ are written for URP; on Built-in or HDRP, apply the opinions, name the pipeline gap, and skip
46
+ the URP-typed checks.
47
+ 3. **Art bible** — look for a `Palette` type or an art-bible note (CLAUDE.md, docs); if none
48
+ exists, write the three-line bible from the game's current look first — retro-tinting later is
49
+ the expensive order.
50
+ 4. **Identity (live floor only)** — verify player identity with a live probe (services
51
+ initialized and a PlayerId present), never by assuming an earlier setup step ran.
52
+ 5. **Scope the done gate** to the surface you touched: a title-screen session scores the shell
53
+ and look axes, not the whole board.
54
+
55
+ **A floor fills an engine default, never a developer's choice.** If the project already has its
56
+ own controller, camera, shader, palette or style, keep it, apply only the floor's opinions that
57
+ don't conflict, and name the difference in the report. Write an art bible only from choices the
58
+ developer has made, and ask before adding one mid-project.
59
+
60
+ ## The floors — numbered in build order, read each at its moment
61
+
62
+ 1. [art-direction](references/art-direction.md) — before the first material, light, or UI element
63
+ 2. [scene-lighting](references/scene-lighting.md) — with the visual baseline (3D)
64
+ 3. [toon-shading](references/toon-shading.md) — when the art bible picks a cel/toon style (3D)
65
+ 4. [camera-rigs](references/camera-rigs.md) — first gameplay camera (has a 2D section)
66
+ 5. [placeholder-assets](references/placeholder-assets.md) — first missing asset
67
+ 6. [character-motion](references/character-motion.md) — first moving character (3D-leaning)
68
+ 7. *(the playable loop lands here — loop before content, one system per pass)*
69
+ 8. [game-feel](references/game-feel.md) — the feel pass, after the loop
70
+ 9. [vfx](references/vfx.md) — with the feel pass (has a 2D section)
71
+ 10. [game-audio](references/game-audio.md) — before done
72
+ 11. [game-shell](references/game-shell.md) — before done (2D backdrop delta). Before the first TextMeshPro text, import TMP Essentials (see the reference's failure table).
73
+ 12. [live-floor](references/live-floor.md) — with the shell (services before gameplay code)
74
+ 13. [visual-scorecard](references/visual-scorecard.md) — **the done gate, always last; run it once a playable loop exists.** During project creation, stop at the lit-baseline capture and skip the gate.
75
+
76
+ Mid-project asks enter at the matching number and pull earlier floors only as the mid-flow check
77
+ requires (the bible, the pipeline, the identity probe).
78
+
79
+ **Resolving `<VERSION>` in the references' doc links** — prefer WebFetch of the exact page over
80
+ WebSearch: for `docs.unity.com/en-us/engine/<VERSION>` manual and script-reference pages, use the
81
+ project's Editor stream (e.g. `6000.3`) from `ProjectSettings/ProjectVersion.txt`, and the same
82
+ stream for the remaining `docs.unity3d.com/<VERSION>/Documentation` pages; for
83
+ `docs.unity3d.com/Packages/<package>@<VERSION>` pages, use the installed package's major.minor
84
+ from `Packages/manifest.json` or the `Library/PackageCache` folder name; the
85
+ `docs.unity.com/en-us/<service>.md` services pages are unversioned.
86
+
87
+ Routing follows the game's 2D/3D nature; **the 2D look floor (sprite art direction, 2D lights,
88
+ sprite placeholders) is not yet covered** — on a 2D game, say so at those beats rather than
89
+ applying 3D instructions. The scorecard's 2D anchor set still applies.
90
+
91
+ ## The boundary (what this skill is not)
92
+
93
+ This skill owns **opinionated creation and floors** — which values, in what order, to what bar.
94
+ Catalog neighbours own **mechanics on existing setups**: volume/post mechanics →
95
+ `urp-postprocessing` · routing sources into existing mixer groups → `audio-setup-mixers` · audio
96
+ import/memory → `optimize-audio` · UI framework choice and construction → `ui` · font assets →
97
+ `optimize-text-mesh-pro` · backend services → `build-live-game` · pixel-perfect 2D →
98
+ `2d-pixel-perfect`. When an ask is purely mechanical, route there; when it's "make it good," it's
99
+ this skill, which then delegates the mechanics. If this index wants to grow, the new thing is a
100
+ catalog skill routed by the prompt, not another floor — a floor must apply to *every* game.
101
+
102
+ ## The done gate
103
+
104
+ A craft session ends with [visual-scorecard](references/visual-scorecard.md)'s board — scored
105
+ frames, not a green compile. In order:
106
+
107
+ 1. **Score** all six axes per the scorecard. All six at 3 or better is the floor.
108
+ 2. **Fix pass** — anything below 3 gets its fix before done (assessment-only asks: scores and
109
+ recommendations, no fixes). If a fix doesn't work, reread the relevant reference and its
110
+ linked documentation before trying variations.
111
+ 3. **Console** — confirm zero console errors.
112
+ 4. **Play check** — enter Play mode and check the touched behavior with `Debug.Log` lines you
113
+ added for the purpose. If the fix pass or this check fails, reread the relevant reference and
114
+ its linked documentation before trying variations.
115
+
116
+ ## Final report
117
+
118
+ State: which floors ran and which references were read · the board (or the scoped axes) before and
119
+ after the fix pass · every incidental side effect — packages installed, files or settings edited,
120
+ assets imported — and any follow-up the user needs · any floor skipped or gap named (the 2D look
121
+ floor, a declined install, a missing neighbour skill), so the user knows what deeper guidance was
122
+ skipped.
123
+
124
+ ## Common mistakes
125
+
126
+ - **Polishing without a bible** — fixing one object's look against no palette; write the
127
+ three-line bible first, even mid-project.
128
+ - **Replacing a developer's choice with a floor recipe** — an existing custom controller,
129
+ camera, shader or palette stays; the fix pass never swaps it for the floor's default.
130
+ - **Treating a floor as a feature** — floors are defaults; the user declines one with a word, and
131
+ the decline is recorded in the report, never argued.
132
+ - **Running the mechanics from memory** when a neighbour skill owns them — route and delegate.
133
+ - **Skipping the done gate** because the change was small — scope it down instead.
134
+ - **Applying 3D look instructions to a 2D game** — name the gap instead.