asecli 0.8.6__tar.gz → 0.8.7__tar.gz

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 (286) hide show
  1. {asecli-0.8.6 → asecli-0.8.7}/PKG-INFO +3 -3
  2. {asecli-0.8.6 → asecli-0.8.7}/README.md +2 -2
  3. {asecli-0.8.6 → asecli-0.8.7}/docs/00-governance/timeline.md +2 -0
  4. asecli-0.8.7/docs/01-architecture/codely-bridge-protocol.md +310 -0
  5. {asecli-0.8.6 → asecli-0.8.7}/docs/03-quality/regression-catalog.md +1 -0
  6. {asecli-0.8.6 → asecli-0.8.7}/docs/04-delivery/project-plan-task-charter.md +2 -1
  7. asecli-0.8.7/docs/adversarial-audits/2026-10-14-163548-audit-report.md +463 -0
  8. asecli-0.8.7/docs/adversarial-audits/2026-10-14-163548-optimization-plan.md +273 -0
  9. asecli-0.8.7/docs/adversarial-audits/2026-11-17-142104-audit-report.md +160 -0
  10. asecli-0.8.7/docs/adversarial-audits/2026-11-17-142104-optimization-plan.md +171 -0
  11. asecli-0.8.7/docs/adversarial-audits/2026-11-17-164913-audit-report.md +137 -0
  12. asecli-0.8.7/docs/adversarial-audits/2026-11-17-164913-optimization-plan.md +160 -0
  13. asecli-0.8.7/docs/adversarial-audits/2026-11-17-200530-audit-report.md +165 -0
  14. asecli-0.8.7/docs/adversarial-audits/2026-11-17-200530-optimization-plan.md +189 -0
  15. asecli-0.8.7/docs/adversarial-audits/2026-11-17-205918-audit-report.md +223 -0
  16. asecli-0.8.7/docs/adversarial-audits/2026-11-17-205918-optimization-plan.md +113 -0
  17. {asecli-0.8.6 → asecli-0.8.7}/pyproject.toml +1 -1
  18. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/__init__.py +1 -1
  19. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/__init__.py +13 -0
  20. asecli-0.8.7/src/asecli/bridge/backend.py +249 -0
  21. asecli-0.8.7/src/asecli/bridge/bridge_client.py +238 -0
  22. asecli-0.8.7/src/asecli/bridge/bridge_instance.py +92 -0
  23. asecli-0.8.7/src/asecli/bridge/bridge_mailbox.py +63 -0
  24. asecli-0.8.7/src/asecli/bridge/bridge_probe.py +48 -0
  25. asecli-0.8.7/src/asecli/bridge/codely_client.py +220 -0
  26. asecli-0.8.7/src/asecli/bridge/codely_discovery.py +119 -0
  27. asecli-0.8.7/src/asecli/bridge/codely_probe.py +57 -0
  28. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/editor_create.py +63 -33
  29. asecli-0.8.7/src/asecli/bridge/editor_result.py +69 -0
  30. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/graph_geometry.py +18 -24
  31. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/graph_geometry_parser.py +10 -10
  32. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/graph_inspect.py +23 -36
  33. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/gui_provider_detection.py +17 -8
  34. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/recompile.py +35 -17
  35. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/wire_route.py +23 -12
  36. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/commands.py +6 -2
  37. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/commentary_command.py +4 -2
  38. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/create_command.py +6 -11
  39. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/gui_support_command.py +4 -2
  40. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/layout_command.py +12 -9
  41. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/main.py +16 -16
  42. asecli-0.8.7/tests/_bridge_harness.py +94 -0
  43. asecli-0.8.7/tests/test_bridge_adversarial.py +201 -0
  44. {asecli-0.8.6 → asecli-0.8.7}/tests/test_bridge_contract.py +10 -10
  45. asecli-0.8.7/tests/test_bridge_transport.py +306 -0
  46. asecli-0.8.7/tests/test_cli_backend_forwarding.py +105 -0
  47. asecli-0.8.7/tests/test_codely_bridge.py +311 -0
  48. {asecli-0.8.6 → asecli-0.8.7}/tests/test_editor_create_bridge.py +118 -5
  49. asecli-0.8.7/tests/test_smoke.py +4 -0
  50. {asecli-0.8.6 → asecli-0.8.7}/tests/test_wire_route_bridge.py +3 -3
  51. {asecli-0.8.6 → asecli-0.8.7}/uv.lock +1 -1
  52. asecli-0.8.6/tests/test_smoke.py +0 -4
  53. {asecli-0.8.6 → asecli-0.8.7}/.github/workflows/ci.yml +0 -0
  54. {asecli-0.8.6 → asecli-0.8.7}/.github/workflows/publish.yml +0 -0
  55. {asecli-0.8.6 → asecli-0.8.7}/.gitignore +0 -0
  56. {asecli-0.8.6 → asecli-0.8.7}/.project-architect.json +0 -0
  57. {asecli-0.8.6 → asecli-0.8.7}/AGENTS.md +0 -0
  58. {asecli-0.8.6 → asecli-0.8.7}/LICENSE +0 -0
  59. {asecli-0.8.6 → asecli-0.8.7}/SECURITY.md +0 -0
  60. {asecli-0.8.6 → asecli-0.8.7}/docs/00-governance/audit-supplement.json +0 -0
  61. {asecli-0.8.6 → asecli-0.8.7}/docs/00-governance/change-register.md +0 -0
  62. {asecli-0.8.6 → asecli-0.8.7}/docs/00-governance/delivery-protocol.md +0 -0
  63. {asecli-0.8.6 → asecli-0.8.7}/docs/00-governance/project-charter.md +0 -0
  64. {asecli-0.8.6 → asecli-0.8.7}/docs/00-governance/supply-chain-policy.md +0 -0
  65. {asecli-0.8.6 → asecli-0.8.7}/docs/00-governance/traceability.csv +0 -0
  66. {asecli-0.8.6 → asecli-0.8.7}/docs/01-architecture/assumption-experiments.md +0 -0
  67. {asecli-0.8.6 → asecli-0.8.7}/docs/01-architecture/module-map.md +0 -0
  68. {asecli-0.8.6 → asecli-0.8.7}/docs/01-architecture/project-architecture-and-requirements.md +0 -0
  69. {asecli-0.8.6 → asecli-0.8.7}/docs/01-architecture/technical-route.md +0 -0
  70. {asecli-0.8.6 → asecli-0.8.7}/docs/03-quality/bug-register.md +0 -0
  71. {asecli-0.8.6 → asecli-0.8.7}/docs/03-quality/test-strategy.md +0 -0
  72. {asecli-0.8.6 → asecli-0.8.7}/docs/04-delivery/roadmap.md +0 -0
  73. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-01-014104-audit-report.md +0 -0
  74. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-01-014104-optimization-plan.md +0 -0
  75. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-01-145343-audit-report.md +0 -0
  76. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-01-145343-optimization-plan.md +0 -0
  77. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-01-193521-audit-report.md +0 -0
  78. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-01-193521-optimization-plan.md +0 -0
  79. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-01-203438-audit-report.md +0 -0
  80. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-01-203438-optimization-plan.md +0 -0
  81. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-02-121155-audit-report.md +0 -0
  82. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-02-121155-optimization-plan.md +0 -0
  83. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-02-175509-audit-report.md +0 -0
  84. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-02-175509-optimization-plan.md +0 -0
  85. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-04-122304-audit-report.md +0 -0
  86. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-04-122304-optimization-plan.md +0 -0
  87. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-05-142617-audit-report.md +0 -0
  88. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-05-142617-optimization-plan.md +0 -0
  89. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-05-160945-audit-report.md +0 -0
  90. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-05-160945-optimization-plan.md +0 -0
  91. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-05-213523-audit-report.md +0 -0
  92. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-05-213523-optimization-plan.md +0 -0
  93. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-10-193631-audit-report.md +0 -0
  94. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-10-193631-optimization-plan.md +0 -0
  95. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-14-123640-audit-report.md +0 -0
  96. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-14-123640-optimization-plan.md +0 -0
  97. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-14-124947-audit-report.md +0 -0
  98. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-14-124947-optimization-plan.md +0 -0
  99. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-14-132814-audit-report.md +0 -0
  100. {asecli-0.8.6 → asecli-0.8.7}/docs/adversarial-audits/2026-09-14-132814-optimization-plan.md +0 -0
  101. {asecli-0.8.6 → asecli-0.8.7}/docs/first-principles/2026-08-31-231401-optimization-plan.md +0 -0
  102. {asecli-0.8.6 → asecli-0.8.7}/docs/first-principles/2026-09-01-190656-optimization-plan.md +0 -0
  103. {asecli-0.8.6 → asecli-0.8.7}/docs/proposals/2026-09-07-shadergraph-to-ase-requirements.md +0 -0
  104. {asecli-0.8.6 → asecli-0.8.7}/scripts/install.ps1 +0 -0
  105. {asecli-0.8.6 → asecli-0.8.7}/scripts/install.sh +0 -0
  106. {asecli-0.8.6 → asecli-0.8.7}/skills/asecli/SKILL.md +0 -0
  107. {asecli-0.8.6 → asecli-0.8.7}/skills/asecli/references/conversion-publication-receipt.v1.schema.json +0 -0
  108. {asecli-0.8.6 → asecli-0.8.7}/skills/asecli/references/conversion-workflow.md +0 -0
  109. {asecli-0.8.6 → asecli-0.8.7}/skills/asecli/references/layout-standard.md +0 -0
  110. {asecli-0.8.6 → asecli-0.8.7}/skills/asecli/references/master-output-settings-standard.md +0 -0
  111. {asecli-0.8.6 → asecli-0.8.7}/skills/asecli/references/material-property-standard.md +0 -0
  112. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_editor_port_contract.py +0 -0
  113. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_editor_primitives.py +0 -0
  114. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_editor_spec_grammar.py +0 -0
  115. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_editor_spec_io.py +0 -0
  116. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_editor_spec_validation.py +0 -0
  117. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_gui_handoff_store.py +0 -0
  118. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_gui_project.py +0 -0
  119. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_gui_resource_store.py +0 -0
  120. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/_gui_resource_upgrade.py +0 -0
  121. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/editor_spec.py +0 -0
  122. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/gui_handoff.py +0 -0
  123. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/gui_presentation.py +0 -0
  124. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/gui_runtime_probe.py +0 -0
  125. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/gui_support.py +0 -0
  126. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/gui_support_resource.py +0 -0
  127. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/mcp_client.py +0 -0
  128. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/render_settings.py +0 -0
  129. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resource_text.py +0 -0
  130. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.authoring.part00.cs.txt +0 -0
  131. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.authoring.part01.cs.txt +0 -0
  132. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.authoring.store.cs.txt +0 -0
  133. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.condition.cs.txt +0 -0
  134. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.hydration.cs.txt +0 -0
  135. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.part00.cs.txt +0 -0
  136. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.part01.cs.txt +0 -0
  137. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.reconciliation.cs.txt +0 -0
  138. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/asecli_material_gui.transaction.cs.txt +0 -0
  139. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/editor_create.part00.cs.txt +0 -0
  140. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/editor_create.part01.cs.txt +0 -0
  141. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/editor_create.part02.cs.txt +0 -0
  142. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/editor_create.part03.cs.txt +0 -0
  143. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/editor_create.part04.cs.txt +0 -0
  144. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/bridge/resources/wire_route.transaction.cs.txt +0 -0
  145. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/checks/__init__.py +0 -0
  146. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/checks/checksum.py +0 -0
  147. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/checks/local_vars.py +0 -0
  148. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/checks/usage.py +0 -0
  149. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/checks/validate.py +0 -0
  150. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/__init__.py +0 -0
  151. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/contract.py +0 -0
  152. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/contract_command.py +0 -0
  153. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/conversion_output.py +0 -0
  154. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/custom_gui_command.py +0 -0
  155. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/export_sg_command.py +0 -0
  156. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/graph_review_command.py +0 -0
  157. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/gui_provider.py +0 -0
  158. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/io.py +0 -0
  159. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/migrate_package_command.py +0 -0
  160. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/recompile_metadata.py +0 -0
  161. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/skill_command.py +0 -0
  162. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/cli/usage_command.py +0 -0
  163. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/contracts/editor-graph-spec.v3.schema.json +0 -0
  164. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/contracts/sgcli.native.v3.schema.json +0 -0
  165. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/contracts.py +0 -0
  166. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/__init__.py +0 -0
  167. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/comment_bounds.py +0 -0
  168. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/comment_layout.py +0 -0
  169. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/comment_metrics.py +0 -0
  170. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/comment_purpose.py +0 -0
  171. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/commentary.py +0 -0
  172. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/compiled_metadata.py +0 -0
  173. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/compiled_properties.py +0 -0
  174. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/custom_gui.py +0 -0
  175. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/custom_gui_versions.py +0 -0
  176. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/fishbone_placement.py +0 -0
  177. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/fishbone_topology.py +0 -0
  178. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/graph_ops.py +0 -0
  179. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/graph_review.py +0 -0
  180. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/island_layout.py +0 -0
  181. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/layout.py +0 -0
  182. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/layout_audit.py +0 -0
  183. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/layout_audit_geometry.py +0 -0
  184. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/layout_audit_repeated.py +0 -0
  185. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/layout_graph.py +0 -0
  186. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/local_vars.py +0 -0
  187. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/material_gui_condition.py +0 -0
  188. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/material_gui_protocol.py +0 -0
  189. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/material_gui_spec.py +0 -0
  190. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/meticulous_layout.py +0 -0
  191. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/model.py +0 -0
  192. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/property_presentation.py +0 -0
  193. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/reuse_plan.py +0 -0
  194. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/wire_geometry.py +0 -0
  195. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/core/wire_router.py +0 -0
  196. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/export_sg.py +0 -0
  197. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/schema/__init__.py +0 -0
  198. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/schema/data/observed.json +0 -0
  199. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/schema/data/schemas.json +0 -0
  200. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/schema_validation.py +0 -0
  201. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/__init__.py +0 -0
  202. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/alpha_modulate.py +0 -0
  203. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/binding.py +0 -0
  204. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/conversion_report.py +0 -0
  205. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/custom_expression.py +0 -0
  206. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/decoder.py +0 -0
  207. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/evidence.py +0 -0
  208. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/model.py +0 -0
  209. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/nodes.py +0 -0
  210. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/pass_blend.py +0 -0
  211. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/reconciliation.py +0 -0
  212. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/report_presentation.py +0 -0
  213. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/report_semantics.py +0 -0
  214. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/sources.py +0 -0
  215. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/surface_matching.py +0 -0
  216. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/surface_precision.py +0 -0
  217. {asecli-0.8.6 → asecli-0.8.7}/src/asecli/sg_export/surface_semantics.py +0 -0
  218. {asecli-0.8.6 → asecli-0.8.7}/tests/TEST.md +0 -0
  219. {asecli-0.8.6 → asecli-0.8.7}/tests/__init__.py +0 -0
  220. {asecli-0.8.6 → asecli-0.8.7}/tests/conftest.py +0 -0
  221. {asecli-0.8.6 → asecli-0.8.7}/tests/editor_create_v3_fixture.py +0 -0
  222. {asecli-0.8.6 → asecli-0.8.7}/tests/fixtures/HLIT.shader +0 -0
  223. {asecli-0.8.6 → asecli-0.8.7}/tests/fixtures/asecli_material_gui_v0_2_0.cs.txt +0 -0
  224. {asecli-0.8.6 → asecli-0.8.7}/tests/fixtures/step-antialiasing.function.txt +0 -0
  225. {asecli-0.8.6 → asecli-0.8.7}/tests/test_adversarial_hardening.py +0 -0
  226. {asecli-0.8.6 → asecli-0.8.7}/tests/test_audit_fixes.py +0 -0
  227. {asecli-0.8.6 → asecli-0.8.7}/tests/test_bridge_recompile.py +0 -0
  228. {asecli-0.8.6 → asecli-0.8.7}/tests/test_build_reproducibility.py +0 -0
  229. {asecli-0.8.6 → asecli-0.8.7}/tests/test_cli_contract.py +0 -0
  230. {asecli-0.8.6 → asecli-0.8.7}/tests/test_commentary.py +0 -0
  231. {asecli-0.8.6 → asecli-0.8.7}/tests/test_contract_schema.py +0 -0
  232. {asecli-0.8.6 → asecli-0.8.7}/tests/test_conversion_report_semantics.py +0 -0
  233. {asecli-0.8.6 → asecli-0.8.7}/tests/test_core_contract.py +0 -0
  234. {asecli-0.8.6 → asecli-0.8.7}/tests/test_create.py +0 -0
  235. {asecli-0.8.6 → asecli-0.8.7}/tests/test_create_constant_presentation.py +0 -0
  236. {asecli-0.8.6 → asecli-0.8.7}/tests/test_cross_cli_workflow.py +0 -0
  237. {asecli-0.8.6 → asecli-0.8.7}/tests/test_custom_gui.py +0 -0
  238. {asecli-0.8.6 → asecli-0.8.7}/tests/test_custom_gui_cli.py +0 -0
  239. {asecli-0.8.6 → asecli-0.8.7}/tests/test_editor_create_cli.py +0 -0
  240. {asecli-0.8.6 → asecli-0.8.7}/tests/test_editor_create_e2e.py +0 -0
  241. {asecli-0.8.6 → asecli-0.8.7}/tests/test_editor_create_spec.py +0 -0
  242. {asecli-0.8.6 → asecli-0.8.7}/tests/test_editor_create_spec_v3.py +0 -0
  243. {asecli-0.8.6 → asecli-0.8.7}/tests/test_editor_render_settings.py +0 -0
  244. {asecli-0.8.6 → asecli-0.8.7}/tests/test_export_fidelity.py +0 -0
  245. {asecli-0.8.6 → asecli-0.8.7}/tests/test_export_precision_diagnostics.py +0 -0
  246. {asecli-0.8.6 → asecli-0.8.7}/tests/test_export_property_visibility.py +0 -0
  247. {asecli-0.8.6 → asecli-0.8.7}/tests/test_export_sg.py +0 -0
  248. {asecli-0.8.6 → asecli-0.8.7}/tests/test_governance.py +0 -0
  249. {asecli-0.8.6 → asecli-0.8.7}/tests/test_graph_review.py +0 -0
  250. {asecli-0.8.6 → asecli-0.8.7}/tests/test_graph_safety.py +0 -0
  251. {asecli-0.8.6 → asecli-0.8.7}/tests/test_gui_handoff.py +0 -0
  252. {asecli-0.8.6 → asecli-0.8.7}/tests/test_gui_native_extension.py +0 -0
  253. {asecli-0.8.6 → asecli-0.8.7}/tests/test_gui_support.py +0 -0
  254. {asecli-0.8.6 → asecli-0.8.7}/tests/test_gui_support_cli_contract.py +0 -0
  255. {asecli-0.8.6 → asecli-0.8.7}/tests/test_gui_upgrade.py +0 -0
  256. {asecli-0.8.6 → asecli-0.8.7}/tests/test_install_scripts.py +0 -0
  257. {asecli-0.8.6 → asecli-0.8.7}/tests/test_island_layout.py +0 -0
  258. {asecli-0.8.6 → asecli-0.8.7}/tests/test_layout.py +0 -0
  259. {asecli-0.8.6 → asecli-0.8.7}/tests/test_layout_governance.py +0 -0
  260. {asecli-0.8.6 → asecli-0.8.7}/tests/test_layout_local_var_policy.py +0 -0
  261. {asecli-0.8.6 → asecli-0.8.7}/tests/test_material_gui_e2e.py +0 -0
  262. {asecli-0.8.6 → asecli-0.8.7}/tests/test_mcp_security.py +0 -0
  263. {asecli-0.8.6 → asecli-0.8.7}/tests/test_migrate_package.py +0 -0
  264. {asecli-0.8.6 → asecli-0.8.7}/tests/test_mutate.py +0 -0
  265. {asecli-0.8.6 → asecli-0.8.7}/tests/test_pass_blend.py +0 -0
  266. {asecli-0.8.6 → asecli-0.8.7}/tests/test_perf.py +0 -0
  267. {asecli-0.8.6 → asecli-0.8.7}/tests/test_property_presentation.py +0 -0
  268. {asecli-0.8.6 → asecli-0.8.7}/tests/test_roundtrip.py +0 -0
  269. {asecli-0.8.6 → asecli-0.8.7}/tests/test_schema_add.py +0 -0
  270. {asecli-0.8.6 → asecli-0.8.7}/tests/test_schema_samples.py +0 -0
  271. {asecli-0.8.6 → asecli-0.8.7}/tests/test_sg_export_sources.py +0 -0
  272. {asecli-0.8.6 → asecli-0.8.7}/tests/test_skill_install.py +0 -0
  273. {asecli-0.8.6 → asecli-0.8.7}/tests/test_supply_chain.py +0 -0
  274. {asecli-0.8.6 → asecli-0.8.7}/tests/test_surface_semantics.py +0 -0
  275. {asecli-0.8.6 → asecli-0.8.7}/tests/test_surface_semantics_integration.py +0 -0
  276. {asecli-0.8.6 → asecli-0.8.7}/tests/test_usage_audit.py +0 -0
  277. {asecli-0.8.6 → asecli-0.8.7}/tools/build_schema.py +0 -0
  278. {asecli-0.8.6 → asecli-0.8.7}/tools/check_ci_governance.py +0 -0
  279. {asecli-0.8.6 → asecli-0.8.7}/tools/check_document_governance.py +0 -0
  280. {asecli-0.8.6 → asecli-0.8.7}/tools/check_packed_executor_loc.py +0 -0
  281. {asecli-0.8.6 → asecli-0.8.7}/tools/check_regression_catalog.py +0 -0
  282. {asecli-0.8.6 → asecli-0.8.7}/tools/check_release_candidate.py +0 -0
  283. {asecli-0.8.6 → asecli-0.8.7}/tools/compare_build_artifacts.py +0 -0
  284. {asecli-0.8.6 → asecli-0.8.7}/tools/generate_sbom.py +0 -0
  285. {asecli-0.8.6 → asecli-0.8.7}/tools/independent_wheel_smoke.py +0 -0
  286. {asecli-0.8.6 → asecli-0.8.7}/tools/supply_chain_check.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: asecli
3
- Version: 0.8.6
3
+ Version: 0.8.7
4
4
  Summary: Agent-native CLI for reading, modifying, validating and compiling Amplify Shader Editor assets
5
5
  Project-URL: Homepage, https://github.com/seeseeczl/ASECLI
6
6
  Project-URL: Repository, https://github.com/seeseeczl/ASECLI
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
28
28
 
29
29
  AseCLI 是面向 AI Agent 的本地 CLI:离线读取、编辑和校验 ASE 节点图;通过运行中的 Unity/团结引擎与 MCP,让真实 ASE 创建节点、提供精排几何并重新生成 HLSL。Skill 提供跨 Agent 的操作规则,CLI 提供可验证的执行结果。
30
30
 
31
- 当前正式版:**[0.8.6](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.6)** · [PyPI](https://pypi.org/project/asecli/0.8.6/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
31
+ 当前正式版:**[0.8.7](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.7)** · [PyPI](https://pypi.org/project/asecli/0.8.7/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
32
32
 
33
33
  ASECLI 接收 SGCLI 生成的裸 `EditorGraphSpec v3`,并可把受支持的 ASE Shader 直接导出为 SGCLI 的裸 `sgcli.native.v3`。两个方向都只有“生产者 spec 原文件→消费者 `--spec`”;spec 是唯一图规格;独立 report 与发布 receipt 通过各自参数提供转换认证证据,创建成功也不代表转换效果等价。
34
34
 
@@ -348,7 +348,7 @@ asecli recompile Assets/Example.shader
348
348
  - 首期绑定 ASE `1.9.6.2`;Master 端口契约只开放已实测的 URP Unlit 模板 GUID。未知版本、模板 Master 端口、节点、字段、端口或类型在写入前失败。
349
349
  - 规格只传 JSON 数据。执行的 C# 来自包内固定资源;Custom Expression 的 HLSL 是可编辑节点内容,但任意 C#、任意反射字段和危险运行时标记不会透传。
350
350
  - 保存成功必须同时满足 Save、暂存重载、模板 GUID/Shader 名、节点/属性/动态端口/连接 manifest、移动提交和目标 Shader 身份一致;Editor 事务失败会回滚明确的目标/暂存资产并恢复原 ASE 窗口状态。为避免 MCP 插件重连吞掉成功回执,同一次创建调用不再重复加载目标图。成功 JSON 中 `reloaded` 与 `staging_reloaded` 表示暂存图已 LoadFromDisk;`target_graph_reloaded` 恒为 `false`。CLI 属性收尾后必须使用独立 `recompile` 完成目标图重载复验。若提交后 Python 后验解析失败,CLI 为避免竞态误删会保留目标和 `.meta`,并返回 `transaction_nonce`、Shader/meta SHA-256 供人工核对。
351
- - MCP 3.4.7 默认按源码模式拦截 `AssetDatabase.DeleteAsset`。CLI 仅对包内固定、参数已校验且暂存名带随机 nonce 的事务执行器设置该次 `safety_checks=false`;不会把用户 C# 透传到这一入口。
351
+ - 按源码模式扫描 C# 的 MCP 服务会拦截 `AssetDatabase.DeleteAsset`。CLI 仅对包内固定、参数已校验且暂存名带随机 nonce 的事务执行器请求本次关闭该扫描(`safety_checks=false`);不会把用户 C# 透传到这一入口。该参数按**能力**协商而非绑定服务版本:若服务拒绝该参数,CLI 去掉它重试一次并接受服务的默认扫描策略,因此不需要为适配新版 MCP 而改代码。
352
352
  - MCP 客户端超时代表完成状态未知,不等同于 Editor 已停止或已回滚。初始化握手共用 20 秒总预算,真实 `tools/call` 保留 120 秒执行预算;超时 JSON 会给出 `phase`、`elapsed_ms`、`budget_ms` 并返回 `BRIDGE_ERROR`/3。重试前先检查目标文件及同目录 `ASECLI-Temp-*`,避免把迟到成功误判为失败。
353
353
  - 隔离团结 E2E 已证明 Caster-like/Receiver-like 图可创建、保存、关闭并由新进程重载;这不证明目标工程的运行时矩阵注入、材质绑定或最终渲染画面正确。
354
354
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  AseCLI 是面向 AI Agent 的本地 CLI:离线读取、编辑和校验 ASE 节点图;通过运行中的 Unity/团结引擎与 MCP,让真实 ASE 创建节点、提供精排几何并重新生成 HLSL。Skill 提供跨 Agent 的操作规则,CLI 提供可验证的执行结果。
6
6
 
7
- 当前正式版:**[0.8.6](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.6)** · [PyPI](https://pypi.org/project/asecli/0.8.6/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
7
+ 当前正式版:**[0.8.7](https://github.com/seeseeczl/ASECLI/releases/tag/v0.8.7)** · [PyPI](https://pypi.org/project/asecli/0.8.7/) · [Agent 操作手册](skills/asecli/SKILL.md) · [SG 转换后整理流程](skills/asecli/references/conversion-workflow.md)
8
8
 
9
9
  ASECLI 接收 SGCLI 生成的裸 `EditorGraphSpec v3`,并可把受支持的 ASE Shader 直接导出为 SGCLI 的裸 `sgcli.native.v3`。两个方向都只有“生产者 spec 原文件→消费者 `--spec`”;spec 是唯一图规格;独立 report 与发布 receipt 通过各自参数提供转换认证证据,创建成功也不代表转换效果等价。
10
10
 
@@ -324,7 +324,7 @@ asecli recompile Assets/Example.shader
324
324
  - 首期绑定 ASE `1.9.6.2`;Master 端口契约只开放已实测的 URP Unlit 模板 GUID。未知版本、模板 Master 端口、节点、字段、端口或类型在写入前失败。
325
325
  - 规格只传 JSON 数据。执行的 C# 来自包内固定资源;Custom Expression 的 HLSL 是可编辑节点内容,但任意 C#、任意反射字段和危险运行时标记不会透传。
326
326
  - 保存成功必须同时满足 Save、暂存重载、模板 GUID/Shader 名、节点/属性/动态端口/连接 manifest、移动提交和目标 Shader 身份一致;Editor 事务失败会回滚明确的目标/暂存资产并恢复原 ASE 窗口状态。为避免 MCP 插件重连吞掉成功回执,同一次创建调用不再重复加载目标图。成功 JSON 中 `reloaded` 与 `staging_reloaded` 表示暂存图已 LoadFromDisk;`target_graph_reloaded` 恒为 `false`。CLI 属性收尾后必须使用独立 `recompile` 完成目标图重载复验。若提交后 Python 后验解析失败,CLI 为避免竞态误删会保留目标和 `.meta`,并返回 `transaction_nonce`、Shader/meta SHA-256 供人工核对。
327
- - MCP 3.4.7 默认按源码模式拦截 `AssetDatabase.DeleteAsset`。CLI 仅对包内固定、参数已校验且暂存名带随机 nonce 的事务执行器设置该次 `safety_checks=false`;不会把用户 C# 透传到这一入口。
327
+ - 按源码模式扫描 C# 的 MCP 服务会拦截 `AssetDatabase.DeleteAsset`。CLI 仅对包内固定、参数已校验且暂存名带随机 nonce 的事务执行器请求本次关闭该扫描(`safety_checks=false`);不会把用户 C# 透传到这一入口。该参数按**能力**协商而非绑定服务版本:若服务拒绝该参数,CLI 去掉它重试一次并接受服务的默认扫描策略,因此不需要为适配新版 MCP 而改代码。
328
328
  - MCP 客户端超时代表完成状态未知,不等同于 Editor 已停止或已回滚。初始化握手共用 20 秒总预算,真实 `tools/call` 保留 120 秒执行预算;超时 JSON 会给出 `phase`、`elapsed_ms`、`budget_ms` 并返回 `BRIDGE_ERROR`/3。重试前先检查目标文件及同目录 `ASECLI-Temp-*`,避免把迟到成功误判为失败。
329
329
  - 隔离团结 E2E 已证明 Caster-like/Receiver-like 图可创建、保存、关闭并由新进程重载;这不证明目标工程的运行时矩阵注入、材质绑定或最终渲染画面正确。
330
330
 
@@ -101,3 +101,5 @@
101
101
  | 2026-09-14 | v0.8.5 发布准备 | 用户授权推送发布;本地 485 passed/3 skipped,实文件导出成功;算法/属性/设置门禁保留,精度边界提示;远端与双渠道校验待执行 | CR-0031 TASK-0067 REG-0064 REL-0018 |
102
102
  | 2026-09-14 | v0.8.5 双渠道发布完成 | tag cb80828;主线 CI 34823345703 与 publish 34823348963 全成功;GitHub 五资产回读与 PyPI SHA 一致,本机 0.8.5 和 Skill 校验通过;隔离回滚通过,Editor/视觉未运行 | CR-0031 TASK-0067 REG-0064 REL-0018 |
103
103
  | 2026-09-14 | v0.8.6 文档补丁准备 | 已按用户要求删除仓库内三份未跟踪实机副本;README 补齐三文件认证、--write、时间后缀和分层验收;运行行为不变 | CR-0031 TASK-0068 REG-0064 REL-0019 |
104
+ | 2026-09-14 | v0.8.6 双渠道发布及本机升级完成 | tag 48d9fc4;CI/publish 全绿,GitHub 五资产和 PyPI SHA 一致;本机正式 0.8.6/Skill 校验通过;三份未跟踪副本已删除 | CR-0031 TASK-0068 REG-0064 REL-0019 |
105
+ | 2026-11-17 | v0.8.7 三编辑器后端发布 | 新增 Codely Bridge 与 DSH-Bridge 后端,MCP 保留;`--editor-backend` 默认改为 auto(DSH-Bridge → Codely → MCP);四轮红队审计关闭 2×P1 + 3×P2 + 2×P3 | AUD-0087 REL-0020 |
@@ -0,0 +1,310 @@
1
+ # Codely Bridge 协议说明(团结官方 `cn.tuanjie.codely.bridge`)
2
+
3
+ 本文记录 ASECLI 接入 Codely Bridge 所需的协议事实。全部内容来自**实机验证与静态分析**,
4
+ 不是官方文档(官方 README 已过时,其描述的 "echo server" 与实际实现不符)。
5
+
6
+ - 分析对象:`Library/PackageCache/cn.tuanjie.codely.bridge@1.0.66`
7
+ - 原生库:`Plugins/macOS/libNativeTcpBridge.dylib`(arm64 + x86_64 universal)
8
+ - 验证环境:P376 / Tuanjie 2022.3.61t15 / pid 70407
9
+ - 记录日期:2026-11-17
10
+
11
+ ---
12
+
13
+ ## 1. 传输层
14
+
15
+ ### 1.1 启停行为
16
+
17
+ Codely Bridge 随编辑器**自动启动**,无需手动操作:
18
+
19
+ - `UnityTcpBridge` 标记 `[InitializeOnLoad]`
20
+ - 静态构造函数:`if (!EditorPrefs.GetBool("UnityTcp.ManualStop", false)) Start();`
21
+ - 域重载后自动重启,除非曾手动 Stop(写入 `UnityTcp.ManualStop` 标记)
22
+ - Batch 模式下默认不启动,除非设置环境变量 `UNITY_TCP_ALLOW_BATCH=1`
23
+
24
+ ### 1.2 连接握手
25
+
26
+ TCP 连接建立后,服务端立即发送一行欢迎串,以 `\n` 结尾:
27
+
28
+ ```
29
+ WELCOME UNITY-TCP 1 FRAMING=1 SERVER_VERSION=2
30
+ ```
31
+
32
+ 注意两处易错点:
33
+
34
+ - 握手是 **`UNITY-TCP`**,不是 CHANGELOG 曾提到的 `Codely-Bridge`
35
+ - `FRAMING=1` 与 `SERVER_VERSION=2` 是**两套独立编号**,包版本 `1.0.66` 又是第三套
36
+
37
+ ### 1.3 帧格式
38
+
39
+ **「8 字节大端序无符号长度」+「UTF-8 JSON 负载」**,请求与响应同构。
40
+
41
+ ```
42
+ ┌──────────────────┬─────────────────────────┐
43
+ │ length: u64 (BE) │ payload: UTF-8 JSON │
44
+ └──────────────────┴─────────────────────────┘
45
+ ```
46
+
47
+ 依据:原生库 `TcpUtils_ReadFrame` 反汇编。
48
+
49
+ ```asm
50
+ 62b0: mov w24, #0x8 ; 固定读 8 字节长度头
51
+ 62e8: rev x1, x8 ; 字节序反转 → 大端
52
+ 62f0: cmp x8, w21 ; 与长度上限校验
53
+ ```
54
+
55
+ 约束:
56
+
57
+ - 单帧上限 **64 MiB**(`MaxFrameBytes`)
58
+ - 读取超时 **3000 ms**(`FrameIOTimeoutMs`),超时后连接被断开
59
+
60
+ **易错点**:只发 JSON 不发长度头时,服务端把它当作 `length` 的前 8 字节解析,
61
+ 导致长度校验失败并**静默关闭连接**(表现为 `recv` 返回空)。这是初次接入最常见的失败模式。
62
+
63
+ ---
64
+
65
+ ## 2. 请求 / 响应格式
66
+
67
+ ### 2.1 请求
68
+
69
+ ```jsonc
70
+ {
71
+ "type": "<命令名>", // 必填,snake_case
72
+ "params": { } // 可选,命令参数对象
73
+ }
74
+ ```
75
+
76
+ `type` 为空时返回:
77
+
78
+ ```json
79
+ {"success":false,"code":"Command type cannot be empty","error":"Command type cannot be empty","data":"A valid command type is required for processing"}
80
+ ```
81
+
82
+ `type` 未知时返回:
83
+
84
+ ```json
85
+ {"success":false,"code":"Unknown or unsupported command type: <type>","error":"...","data":{"command":"<type>","stackTrace":"..."}}
86
+ ```
87
+
88
+ ### 2.2 响应
89
+
90
+ 成功(`read_console` 示例):
91
+
92
+ ```json
93
+ {"success":true,"message":"Command executed successfully","data":{"success":true,"message":"Retrieved 0 log entries.","data":[]}}
94
+ ```
95
+
96
+ 失败时带 `code` / `error` / `data`,`data` 内可能含 `stackTrace`。
97
+
98
+ **注意**:响应是**两层结构** —— 外层 `success` 是传输层状态,内层 `data.success` 是
99
+ 命令本身的结果。两层都要检查。
100
+
101
+ ---
102
+
103
+ ## 3. 命令清单
104
+
105
+ 共 17 个,均从 `UnityTcpBridge.ExecuteCommand` 的 switch 分支确认:
106
+
107
+ | 命令 | 说明 |
108
+ |---|---|
109
+ | `manage_script` | 脚本文件 CRUD |
110
+ | `manage_scene` | 场景操作 |
111
+ | `manage_editor` | 编辑器状态与操作 |
112
+ | `manage_gameobject` | GameObject CRUD |
113
+ | `manage_asset` | 资产操作 |
114
+ | `read_console` | 读取控制台 |
115
+ | `execute_menu_item` | 执行编辑器菜单 |
116
+ | **`manage_shader`** | Shader 文件 CRUD(**不含 ASE 图操作**) |
117
+ | **`execute_csharp_script`** | **执行任意 C# 脚本(Roslyn)** |
118
+ | `manage_package` | 包管理 |
119
+ | `manage_bake` | 烘焙 |
120
+ | `manage_ui_toolkit` | UI Toolkit |
121
+ | `manage_gameview` | Game 视图 |
122
+ | `manage_workflow` | 工作流 |
123
+ | `execute_custom_tool` | 自定义工具 |
124
+ | `manage_window_bridge` | 原生窗口桥 |
125
+ | `_internal_state_dirty` | 内部状态通知(不对 LLM 暴露) |
126
+
127
+ ---
128
+
129
+ ## 4. `execute_csharp_script`(ASECLI 的核心依赖)
130
+
131
+ 这是与 MCP `execute_code` **语义等价**的能力,ASECLI 现有 C# 片段可零改造复用。
132
+
133
+ ### 4.1 参数
134
+
135
+ | 参数 | 说明 |
136
+ |---|---|
137
+ | `script` | C# 脚本文本 |
138
+ | `script_path` | 脚本文件路径(与 `script` 二选一) |
139
+ | `description` | 日志描述 |
140
+
141
+ ### 4.2 实现
142
+
143
+ - 引擎:Microsoft.CodeAnalysis.CSharp.Scripting(Roslyn,随包分发)
144
+ - 语法自动修复:8 个 `ScriptFixProvider`,最多迭代 50 轮
145
+ - `FixMissingImports` / `FixMissingAssemblyReference` / `FixUnqualifiedUnityStaticMethod`
146
+ - `FixMissingParenthesis` / `FixMissingBrace` / `FixMissingSquareBracket`
147
+ - `FixMissingSemicolon` / `FixAmbiguousReference`
148
+ - 脚本以 `return` 直接产出结果值
149
+
150
+ ### 4.3 响应
151
+
152
+ ```json
153
+ {"success":true,"message":"Command executed successfully","data":{
154
+ "success":true,
155
+ "message":"C# script executed successfully.",
156
+ "data":{"result":"2","logs":[],"log_count":0},
157
+ "state_delta":{"scene":{"dirty":true}}
158
+ }}
159
+ ```
160
+
161
+ 编译失败时:
162
+
163
+ ```json
164
+ {"success":true,"data":{"success":true,"message":"C# script execution failed: (2,48): error CS1010: Newline in constant","state_delta":{...}}}
165
+ ```
166
+
167
+ **注意**:编译失败时**外层仍是 `success:true`**,失败信息藏在 `data.message` 的文本里,
168
+ `data.result` 缺失。ASECLI 必须显式判定 `data.result` 是否存在,不能只看外层 `success`。
169
+
170
+ ### 4.4 已验证可达性
171
+
172
+ | 验证项 | 实测结果 |
173
+ |---|---|
174
+ | 执行 `return 1+1;` | `result: "2"`,耗时约 2.3s |
175
+ | 解析 ASE 窗口类型 | `result: "AmplifyShaderEditor.AmplifyShaderEditorWindow"` |
176
+ | 读取 ASE 私有字段 | `result: "m_mzguiAttribs"`(`NonPublic\|Instance` 可达) |
177
+
178
+ 结论:**ASE 私有字段与实例方法全部可达**,ASECLI 的 15 个 `.cs.txt` 片段可直接复用。
179
+
180
+ ---
181
+
182
+ ## 5. 实例发现
183
+
184
+ ### 5.1 端口注册文件(推荐)
185
+
186
+ 端口持久化在**工程根目录**的 `.com-unity-codely.json`:
187
+
188
+ ```json
189
+ {
190
+ "unity_port": 53996,
191
+ "stream_port": 0,
192
+ "created_date": "2026-05-21T01:52:48.7469400Z",
193
+ "project_path": "/Users/long/Tuanjie3D/P376/Assets",
194
+ "reloading": false,
195
+ "reason": "ready",
196
+ "seq": 1,
197
+ "last_heartbeat": "2026-11-17T04:11:25.9743330Z"
198
+ }
199
+ ```
200
+
201
+ 字段语义:
202
+
203
+ | 字段 | 用途 |
204
+ |---|---|
205
+ | `unity_port` | **TCP 监听端口**,ASECLI 的连接目标 |
206
+ | `stream_port` | 原生窗口桥的信令端口(ASECLI 无需使用) |
207
+ | `project_path` | 指向 `Assets` 目录,可用于反推工程根 |
208
+ | `reloading` | 程序集是否正在重载 |
209
+ | `reason` | 状态原因,`ready` 表示就绪 |
210
+ | `last_heartbeat` | 心跳时间戳,用于 stale 判定(**官方未定义阈值**) |
211
+
212
+ ### 5.2 回退路径
213
+
214
+ 若工程内文件缺失,按顺序回退:
215
+
216
+ 1. `<工程根>/unity-tcp-port.json`(旧版,已废弃)
217
+ 2. `~/.unity-tcp/unity-tcp-port.json`(用户级,已废弃)
218
+
219
+ 实测三处内容一致。
220
+
221
+ ### 5.3 已知限制
222
+
223
+ - `last_heartbeat` 的**更新频率无文档**,ASECLI 不宜据此做严格 stale 判定
224
+ - 无 `instanceId` / `bootId`,**无法区分同工程多编辑器实例**
225
+ - 端口动态分配,不可假设默认值 25916(实测该端口未监听)
226
+
227
+ ---
228
+
229
+ ## 6. 与 DSH-Bridge 的对比
230
+
231
+ | 维度 | Codely Bridge | DSH-Bridge |
232
+ |---|---|---|
233
+ | 传输 | TCP + 8 字节大端长度帧 | 文件系统邮箱 IPC |
234
+ | 端口 | 有(动态) | 无 |
235
+ | 载荷 | C# 源码字符串 | 结构化反射调用 |
236
+ | ASE 私有字段 | 天然可达 | 需 `NonPublic` 反射 |
237
+ | 实例发现 | `.com-unity-codely.json` | `Library/DSHBridge/instance.json` |
238
+ | 多实例区分 | ❌ 无 | ✅ `instanceId` + `bootId` |
239
+ | 危险能力门禁 | 无 | `allowDangerous` |
240
+ | 对 ASECLI 的改造量 | **极小**(仅换传输层) | 大(片段需翻译) |
241
+
242
+ ---
243
+
244
+ ## 7. 复现验证
245
+
246
+ ```python
247
+ import socket, struct, json
248
+
249
+ def codely_call(port: int, command: str, params: dict, timeout: float = 30):
250
+ payload = json.dumps({"type": command, "params": params}).encode()
251
+ with socket.create_connection(("127.0.0.1", port), timeout=timeout) as s:
252
+ s.settimeout(timeout)
253
+ s.recv(4096) # 消费握手,勿跳过
254
+ s.sendall(struct.pack(">Q", len(payload)) + payload)
255
+ header = s.recv(8)
256
+ if len(header) != 8:
257
+ raise RuntimeError("connection closed before response header")
258
+ size = struct.unpack(">Q", header)[0]
259
+ buf = b""
260
+ while len(buf) < size:
261
+ chunk = s.recv(size - len(buf))
262
+ if not chunk:
263
+ break
264
+ buf += chunk
265
+ return json.loads(buf)
266
+
267
+ # 实测通过的调用
268
+ print(codely_call(53996, "read_console", {}))
269
+ print(codely_call(53996, "execute_csharp_script", {"script": "return 1+1;"}))
270
+ ```
271
+
272
+ ---
273
+
274
+ ## 8. 待确认项
275
+
276
+ - `last_heartbeat` 的更新周期与推荐 stale 阈值
277
+ - 多编辑器实例并存时的端口注册覆盖行为
278
+ - `manage_shader` 之外是否存在 ASE 感知能力(当前确认:无)
279
+
280
+ ---
281
+
282
+ ## 9. 实现落点与实测数据(2026-11-17)
283
+
284
+ ASECLI 侧实现位于 `src/asecli/bridge/`:
285
+
286
+ | 文件 | 职责 |
287
+ |---|---|
288
+ | `codely_discovery.py` | 定位工程根与端口注册文件 |
289
+ | `codely_client.py` | 帧编解码、握手、`execute_csharp_script` |
290
+ | `editor_result.py` | 统一两种后端的响应解包 |
291
+ | `backend.py` | 后端选择(auto 优先 Codely,回退 MCP) |
292
+
293
+ ### 9.1 耗时实测(编辑器 pid 70407)
294
+
295
+ | 场景 | 字符数 | 耗时 |
296
+ |---|---|---|
297
+ | 小脚本稳态(5 次) | 8 | 0.93–1.37s |
298
+ | 真实 `GEOMETRY_SNIPPET` | 11080 | 2.29 / 2.41 / 3.30s |
299
+ | `editor_create` 执行器 | 46663 | 首次 7.81s,其后 0.84–1.92s |
300
+
301
+ 结论:单次读取的 3000ms 上限**不会中断大脚本**;服务端处理完成后正常回包。
302
+ 客户端超时因此设为 180s,并在连接后执行一次预热探测以消化 Roslyn 冷启动。
303
+
304
+ ### 9.2 已验证的 ASE 可达性
305
+
306
+ ```
307
+ win=True;node=True;field=m_mzguiAttribs
308
+ ```
309
+
310
+ ASE 窗口类型与私有字段均可经 `execute_csharp_script` 访问,ASECLI 现有 C# 片段无需改写。
@@ -66,3 +66,4 @@
66
66
  | REG-0062 | CR-0029 AA-DATA-001 AA-DATA-002 AA-CONTRACT-001 AA-CONTRACT-002 AA-TEST-001 | cli-json-contract-v1:先序列化后原子 ASCII-safe 写出;拒绝 NaN/Infinity 与非有限几何;顶层契约/版本/命令字段;version JSON/help 唯一文本例外;22 错误码与 17 子命令动态对账 | `uv run --frozen pytest tests/test_cli_contract.py tests/test_bridge_contract.py tests/test_commentary.py tests/test_smoke.py tests/test_install_scripts.py` + 全量 pytest + 隔离 wheel console-script smoke | 定向 76 passed;全量 388 passed/3 skipped;ASCII stdout+中文错误路径、wheel 安装、lock/CI/供应链/文档治理/diff 通过;Editor/Windows 未本地运行,Windows 交由发布 CI 验证 |
67
67
  | REG-0063 | CR-0030 ADR-0022 AUD-FLOW-001 AUD-CONTRACT-002 AUD-CONTRACT-003 AA-CONTRACT-201 AA-CI-202 AA-REL-203 AA-TEST-204 AA-EVIDENCE-205 AA-DATA-206 AA-MIGRATE-207 AA-CI-301 AA-CI-302 AA-TEST-303 AA-EVIDENCE-304 AA-REL-305 AA-EVIDENCE-306 AA-CONTRACT-307 AA-PROV-308 AA-GOV-309 | direct-cross-cli-json-v3:`export-sg` 规范命名与失败仅报告;裸 native v3 顶层;反方向/report/wrapper/未知字段拒绝;Draft 2020-12 数值 parity;三态 receipt 交叉绑定;build-once 候选 wheel;固定 WaveNoise 双向语义 fixture;fixture-set 完整性;clean provenance;生产者输出与消费者输入 SHA-256 完全一致 | `uv run --frozen pytest tests/test_export_sg.py tests/test_contract_schema.py tests/test_editor_create_cli.py tests/test_cli_contract.py tests/test_build_reproducibility.py tests/test_cross_cli_workflow.py` + SGCLI `tests/test_cross_cli_semantics.py`、双 wheel 黑盒 matrix/verifier + bridge 3 分层 E2E | 第三轮全量 `428 passed, 3 skipped`,Python 3.10 同结果;临时干净快照 release-mode matrix 两仓 `dirty=false`、WaveNoise configured、离线 verifier 通过。远端 required checks/ruleset、最终 wheel Editor/画布/render 未关闭,不得声明发布或视觉等价。 |
68
68
  | REG-0064 | CR-0031 | export-fidelity:已知算法折叠、精度提示、属性篡改拒绝、设置负例与后缀 receipt | `uv run --frozen pytest tests/test_export_precision_diagnostics.py tests/test_export_property_visibility.py tests/test_export_fidelity.py tests/test_surface_semantics.py` | 自动通过;私有真实 Shader 仅显式 opt-in,不作为公开 CI 必需输入 |
69
+ | REG-0065 | AUD-0087 | 三编辑器后端:传输层协议、CLI 开关转发、响应归属与资源卫生 | `uv run --frozen pytest tests/test_codely_bridge.py tests/test_bridge_transport.py tests/test_bridge_adversarial.py tests/test_cli_backend_forwarding.py` | 自动通过;真机端到端需编辑器在线,作为独立验收项 |
@@ -122,4 +122,5 @@ kickoff_completion: complete
122
122
  - [x] 里程碑、验收命令、停止条件与回滚已定义
123
123
  - [x] 门禁与审计计划已建立
124
124
  | TASK-0067 | CR-0031 REL-0018 | 发布 ASE→SG 精度提示与保真修复 v0.8.5 | 用户明确授权推送并发布 | 导出、报告、测试、Skill 与发布元数据 | SGCLI、源 Shader、Editor 与视觉验收 | long/2026-09-14 | REG-0064;pytest、治理、双构建、远端 CI、双渠道 SHA、隔离安装回滚 | 任一发布检查失败则停止 | 本地 485 passed/3 skipped;正式候选 484 passed/4 skipped;run 34823348963、GitHub/PyPI SHA、本机安装与回滚通过 | released |
125
- | TASK-0068 | CR-0031 REL-0019 | 清理本地实机副本并发布 README 说明补丁 0.8.6 | 用户授权丢弃三文件、更新 README、推送发布和本机安装 | 三个未跟踪文件、README 与版本发布记录 | 源 Tuanjie 资产、SGCLI 与运行逻辑 | long/2026-09-14 | REG-0064;文档 diff、发布治理、测试、双构建、双渠道 SHA 与安装回滚 | 发布检查失败则停止,保留 0.8.5 | 清理及 README 更新完成,发布验证中 | verified |
125
+ | TASK-0068 | CR-0031 REL-0019 | 清理本地实机副本并发布 README 说明补丁 0.8.6 | 用户授权丢弃三文件、更新 README、推送发布和本机安装 | 三个未跟踪文件、README 与版本发布记录 | 源 Tuanjie 资产、SGCLI 与运行逻辑 | long/2026-09-14 | REG-0064;文档 diff、发布治理、测试、双构建、双渠道 SHA 与安装回滚 | 发布检查失败则停止,保留 0.8.5 | 清理完成;本地 484 passed/4 skipped;CI 34834788825/publish 34834791618 成功,双渠道 SHA、本机 0.8.6/Skill 通过 | released |
126
+ | TASK-0069 | AUD-0087 REL-0020 | 新增 Codely 与 DSH-Bridge 编辑器后端并发布 0.8.7 | 用户授权三后端与默认 auto | 三后端传输层、CLI 开关接线、四轮红队审计记录 | 源 Tuanjie 资产、SGCLI、MCP 既有行为 | long/2026-11-17 | REG-0065;548 passed/4 skipped;治理、供应链、发布候选检查全绿 | 发布检查失败则停止并回滚到 0.8.6 | 待发布 |