asecli 0.6.2__tar.gz

asecli-0.6.2/.github/workflows/ci.yml

@@ -0,0 +1,95 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.12"]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1 (Node 24)
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1 (Node 24)
+        with:
+          version: "0.11.14"
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+      - run: uv lock --check
+      - run: uv sync --frozen --python ${{ matrix.python-version }}
+      - run: uv run --frozen --python ${{ matrix.python-version }} pytest -q
+      - name: Validate regression catalog coverage
+        run: uv run --frozen --python ${{ matrix.python-version }} python tools/check_regression_catalog.py
+      - run: uv run --frozen --python ${{ matrix.python-version }} python tools/check_ci_governance.py
+
+  package:
+    needs: verify
+    runs-on: ubuntu-latest
+    env:
+      SOURCE_DATE_EPOCH: "1788220800"
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1 (Node 24)
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1 (Node 24)
+        with:
+          version: "0.11.14"
+          python-version: "3.12"
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+      - name: Configure build paths outside the checkout
+        run: |
+          echo "ASECLI_VERSION=$(uv version --short)" >> "$GITHUB_ENV"
+          echo "ASECLI_BUILD_A=$RUNNER_TEMP/asecli-build-a" >> "$GITHUB_ENV"
+          echo "ASECLI_BUILD_B=$RUNNER_TEMP/asecli-build-b" >> "$GITHUB_ENV"
+          echo "ASECLI_REPRO_REPORT=$RUNNER_TEMP/asecli-reproducibility.json" >> "$GITHUB_ENV"
+      - run: uv sync --frozen --python 3.12
+      - name: Report build toolchain
+        run: |
+          uv --version
+          uv run --frozen python --version
+          uv run --frozen python -c "from importlib.metadata import version; print('hatchling', version('hatchling'))"
+      - run: uv build --no-build-isolation --out-dir "$ASECLI_BUILD_A"
+      - run: uv build --no-build-isolation --out-dir "$ASECLI_BUILD_B"
+      - name: Compare reproducible artifacts
+        id: reproducibility
+        run: >-
+          uv run --frozen python tools/compare_build_artifacts.py
+          --left "$ASECLI_BUILD_A"
+          --right "$ASECLI_BUILD_B"
+          --output "$ASECLI_REPRO_REPORT"
+      - name: Upload reproducibility diagnostics on failure
+        if: ${{ always() && steps.reproducibility.outcome == 'failure' }}
+        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0 (Node 24)
+        with:
+          name: asecli-reproducibility-diagnostics-${{ runner.arch }}
+          path: |
+            ${{ env.ASECLI_BUILD_A }}/
+            ${{ env.ASECLI_BUILD_B }}/
+            ${{ env.ASECLI_REPRO_REPORT }}
+          if-no-files-found: error
+      - run: mkdir dist && cp "$ASECLI_BUILD_A"/* dist/
+      - run: cd dist && shasum -a 256 *.whl *.tar.gz > SHA256SUMS
+      - run: uv run --frozen python tools/generate_sbom.py --dist dist --output "dist/asecli-$ASECLI_VERSION.spdx.json"
+      - run: uv run --frozen python tools/supply_chain_check.py --output dist/supply-chain-check.json
+      - run: uv venv .artifact-venv --python 3.12
+      - run: uv pip install --python .artifact-venv/bin/python "dist/asecli-$ASECLI_VERSION-py3-none-any.whl"
+      - run: .artifact-venv/bin/asecli parse tests/fixtures/step-antialiasing.function.txt
+      - name: Smoke test packaged GUI installer
+        run: |
+          test_project="$RUNNER_TEMP/asecli-gui-smoke"
+          mkdir -p "$test_project/Assets" "$test_project/ProjectSettings"
+          .artifact-venv/bin/asecli gui-support "$test_project" --write
+          test -f "$test_project/Assets/Editor/ASECLI/ASECLIMaterialGUI.cs"
+      - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0 (Node 24)
+        with:
+          name: asecli-${{ env.ASECLI_VERSION }}-python-${{ runner.arch }}
+          path: dist/
+          if-no-files-found: error

asecli-0.6.2/.github/workflows/publish.yml

@@ -0,0 +1,110 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"
+
+permissions:
+  contents: read
+
+env:
+  SOURCE_DATE_EPOCH: "1788220800"
+
+jobs:
+  verify:
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.12"]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1 (Node 24)
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1 (Node 24)
+        with:
+          version: "0.11.14"
+          python-version: ${{ matrix.python-version }}
+          enable-cache: false
+      - run: uv lock --check
+      - run: uv sync --frozen --python ${{ matrix.python-version }}
+      - run: >-
+          uv run --frozen --python ${{ matrix.python-version }}
+          python tools/check_release_candidate.py --tag "$GITHUB_REF_NAME"
+      - run: uv run --frozen --python ${{ matrix.python-version }} pytest -q
+      - run: >-
+          uv run --frozen --python ${{ matrix.python-version }}
+          python tools/check_regression_catalog.py
+      - run: >-
+          uv run --frozen --python ${{ matrix.python-version }}
+          python tools/check_ci_governance.py
+
+  package:
+    needs: verify
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5.0.1 (Node 24)
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1 (Node 24)
+        with:
+          version: "0.11.14"
+          python-version: "3.12"
+          enable-cache: false
+      - run: uv sync --frozen --python 3.12
+      - run: uv run --frozen python tools/check_release_candidate.py --tag "$GITHUB_REF_NAME"
+      - name: Configure immutable candidate paths
+        run: |
+          echo "ASECLI_VERSION=$(uv version --short)" >> "$GITHUB_ENV"
+          echo "ASECLI_BUILD_A=$RUNNER_TEMP/asecli-build-a" >> "$GITHUB_ENV"
+          echo "ASECLI_BUILD_B=$RUNNER_TEMP/asecli-build-b" >> "$GITHUB_ENV"
+          echo "ASECLI_REPRO_REPORT=$RUNNER_TEMP/asecli-reproducibility.json" >> "$GITHUB_ENV"
+      - run: uv build --no-build-isolation --out-dir "$ASECLI_BUILD_A"
+      - run: uv build --no-build-isolation --out-dir "$ASECLI_BUILD_B"
+      - run: >-
+          uv run --frozen python tools/compare_build_artifacts.py
+          --left "$ASECLI_BUILD_A"
+          --right "$ASECLI_BUILD_B"
+          --output "$ASECLI_REPRO_REPORT"
+      - run: mkdir dist && cp "$ASECLI_BUILD_A"/* dist/
+      - run: cd dist && shasum -a 256 *.whl *.tar.gz > SHA256SUMS
+      - run: >-
+          uv run --frozen python tools/generate_sbom.py
+          --dist dist --output "dist/asecli-$ASECLI_VERSION.spdx.json"
+      - run: uv run --frozen python tools/supply_chain_check.py --output dist/supply-chain-check.json
+      - run: uv venv .artifact-venv --python 3.12
+      - run: uv pip install --python .artifact-venv/bin/python "dist/asecli-${ASECLI_VERSION}-py3-none-any.whl"
+      - run: .artifact-venv/bin/asecli parse tests/fixtures/step-antialiasing.function.txt
+      - run: .artifact-venv/bin/asecli install-skill --skill-root "$RUNNER_TEMP/codex-skills"
+      - name: Smoke test packaged GUI installer
+        run: |
+          test_project="$RUNNER_TEMP/asecli-gui-smoke"
+          mkdir -p "$test_project/Assets" "$test_project/ProjectSettings"
+          .artifact-venv/bin/asecli gui-support "$test_project" --write
+          test -f "$test_project/Assets/Editor/ASECLI/ASECLIMaterialGUI.cs"
+      - uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0 (Node 24)
+        with:
+          name: dist-${{ github.sha }}
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    needs: package
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/asecli/
+    permissions:
+      id-token: write
+    steps:
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1 (Node 24)
+        with:
+          version: "0.11.14"
+          enable-cache: false
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 (Node 24)
+        with:
+          name: dist-${{ github.sha }}
+          path: dist/
+      - run: cd dist && shasum -a 256 -c SHA256SUMS
+      - run: uv publish dist/*.whl dist/*.tar.gz

asecli-0.6.2/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+*.egg-info/
+pytest-cache/
+.pytest_cache/

asecli-0.6.2/.project-architect.json

@@ -0,0 +1,27 @@
+{
+  "project_id": "PRJ-ASECLI",
+  "profiles": ["core", "ai-agent"],
+  "source_roots": ["src", "tests", "tools"],
+  "thresholds": {
+    "source": {"warning": 250, "limit": 400},
+    "test": {"warning": 400, "limit": 600},
+    "config": {"warning": 160, "limit": 200}
+  },
+  "loc_exemptions": [],
+  "packed_executor_warning_baselines": {
+    "src/asecli/bridge/resources/asecli_material_gui.part00.cs.txt": 300,
+    "src/asecli/bridge/resources/asecli_material_gui.part01.cs.txt": 290
+  },
+  "module_roots": ["src/asecli"],
+  "module_public_patterns": [
+    "__init__.py",
+    "contracts/**"
+  ],
+  "module_import_aliases": {},
+  "fitness": {"module_dependency_warning": 5, "module_dependency_limit": 8},
+  "audit": {
+    "output_dir": "docs/05-audits",
+    "reuse_legacy_history": false,
+    "supplement": "docs/00-governance/audit-supplement.json"
+  }
+}

asecli-0.6.2/AGENTS.md

@@ -0,0 +1,23 @@
+# ASECLI 工程执行规则
+
+## 默认采用快速路径
+
+- 文档、注释、文案和不改变行为的配置修改，只检查相关 diff、格式与直接引用；不得启动 Unity/Tuanjie、截图、运行全量 pytest、发布治理或构建发布包。
+- 局部 Python 修改只运行直接相关测试和必要的 CLI smoke。只有跨核心模块、公共契约、发布或定向测试无法覆盖时，才运行全量 pytest。
+- 不因修改文件数量、搜索次数或内部步骤数量自动升级验证等级。
+
+## Editor 与截图按需执行
+
+- 只有改动实际触及 C# Editor 资源、ASE Editor API、Inspector 视觉/交互、真实节点边界或最终渲染时，才允许启动 Unity/Tuanjie。
+- 必须先完成静态检查、自动测试和全部候选修改，再使用一个 Editor 会话集中验证；不得按“改一点、启动一次、截图一次”的方式迭代。
+- 同一验证阶段最多进行一次正常 Editor 启动。没有新的代码变化或新的失败证据时，不得重复关闭、重开或重复截图。
+- 截图只证明最终视觉，不用于调试代码逻辑。视觉代码未变化时复用已有有效证据，不重跑主题、宽度、缩放或交互矩阵。
+- Editor/MCP 不可用或超时时，不自动反复重试；保留自动验证结果，并明确报告对应实机项未验证。
+
+## 验证等级
+
+1. 快速：相关定向测试或 CLI smoke，加 `git diff --check`。适用于普通局部修改，目标数分钟内完成。
+2. 标准：相关模块测试；确有跨模块风险时追加一次全量 pytest。Editor 验证仍按改动范围决定。
+3. 发布：仅在用户明确要求推送或发布时，执行完整治理、可复现构建、远端 CI、资产校验和回滚。
+
+不得把发布级验证用于普通修改，也不得为了补充报告而重复已经通过且对应代码未变化的实机或截图验证。

asecli-0.6.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AseCLI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.