cjk-semantic-split 0.1.0__tar.gz

cjk_semantic_split-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: ruff check src tests
+
+      - name: Run tests with coverage
+        run: |
+          pytest -v --cov=chinese_decompose --cov-report=xml --cov-report=term
+
+      - name: Check coverage gate
+        run: |
+          coverage report --fail-under=80

cjk_semantic_split-0.1.0/.gitignore

@@ -0,0 +1,44 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual envs
+.venv/
+venv/
+env/
+ENV/
+
+# Test / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.cache
+coverage.xml
+*.cover
+
+# IDE
+.idea/
+.vscode/
+*.swp
+.DS_Store

cjk_semantic_split-0.1.0/.hypothesis/.gitignore

@@ -0,0 +1,9 @@
+# This .gitignore file was automatically created by Hypothesis. Hypothesis gitignores
+# .hypothesis by default, because we generally recommend that .hypothesis not be checked
+# into version control.
+#
+# If you *would* like to check .hypothesis into version control, you should delete this
+# file. Hypothesis will not re-create this .gitignore unless .hypothesis is deleted (and
+# if it does, that's a bug - please report it!)
+
+*

cjk_semantic_split-0.1.0/.hypothesis/constants/2b726390919ba924

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/dsl.py
+# hypothesis_version: 6.156.6
+
+[':', 'Empty DSL string', 'Missing root segment', '|']

cjk_semantic_split-0.1.0/.hypothesis/constants/447154ffb3443956

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/loader.py
+# hypothesis_version: 6.156.6
+
+['Loader | None', '_meta', 'data', 'decomp_l1.json', 'decomp_l2.json', 'decomp_l3.json', 'decomp_patches.json', 'utf-8']

cjk_semantic_split-0.1.0/.hypothesis/constants/448896e190e1a139

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/dsl.py
+# hypothesis_version: 6.156.6
+
+[':', 'Empty DSL string', 'Missing root segment', '|']

cjk_semantic_split-0.1.0/.hypothesis/constants/44fdbf8fc7dec723

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/api.py
+# hypothesis_version: 6.156.6
+
+[':', '?', 'DecompositionTree', 'decompose', '|']

cjk_semantic_split-0.1.0/.hypothesis/constants/7d0a29d738e12257

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/primitives.py
+# hypothesis_version: 6.156.6
+
+['data', 'primitives', 'primitives.json', 'utf-8']

cjk_semantic_split-0.1.0/.hypothesis/constants/a686eee4be3e3873

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/errors.py
+# hypothesis_version: 6.156.6
+
+[]

cjk_semantic_split-0.1.0/.hypothesis/constants/a80ac1b9c26466c7

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/structures.py
+# hypothesis_version: 6.156.6
+
+[]

cjk_semantic_split-0.1.0/.hypothesis/constants/cd01bf70c5c5b577

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/__init__.py
+# hypothesis_version: 6.156.6
+
+['0.1.0']

cjk_semantic_split-0.1.0/.hypothesis/constants/dc1aa6aba7748109

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/split.py
+# hypothesis_version: 6.156.6
+
+['Loader']

cjk_semantic_split-0.1.0/.hypothesis/constants/eb3de9a3db1e637c

@@ -0,0 +1,4 @@
+# file: /Users/mac/Develop/gitstore/full_brain_intelligence/Semantic-Character-Splitting-and-Structural-Coding-for-Chinese-Script/src/chinese_decompose/api.py
+# hypothesis_version: 6.156.6
+
+[':', '?', 'DecompositionTree', 'decompose', '|']

cjk_semantic_split-0.1.0/.superpowers/sdd/.gitignore

@@ -0,0 +1 @@
+*

cjk_semantic_split-0.1.0/.superpowers/sdd/progress.md

@@ -0,0 +1,43 @@
+# Subagent-Driven Development Progress Ledger
+
+## Completed Tasks
+
+- **Task 1: Project Scaffold** — DONE (commits `22d28a8`..`564c3e6`). Fix: relaxed `hatch>=1.18` to `hatch>=1.0`.
+- **Task 2: Position Codes Module** — DONE (commit `0b4b3f6`). Brief self-contradiction: 98 was in code but excluded from set; resolved by keeping constant, excluding from set.
+- **Task 3: Errors + Composition Operator** — DONE (commit `9f3918d`). Brief had contradictory assertions for `compose(P_TOP, P_BOTTOM)`; corrected to match spec §2.3.
+- **Task 4: Primitive Set Module** — DONE (commit after `0b4b3f6`). Inline execution.
+- **Task 5: Multi-Tier Loader** — DONE. Brief had `女旁` (2-char) as sub-component and 踩/采 nested inside `_meta`; both fixed.
+- **Task 6: Recursive Split Walker** — DONE. Side fix: extended COMPOSE_TABLE row 0 to include surround codes 90-99 (center passthrough).
+- **Task 7: DecompositionTree** — DONE. Brief had wrong atoms/positions expectations and a circular-import trap; resolved.
+- **Task 8: DSL Serializer + Parser** — DONE. Brief's parser raised on bare last segment; relaxed parser.
+- **Task 9: Public decompose() API** — DONE. Removed circular api.py ↔ dsl.py import.
+- **Task 10: CLI** — DONE. CLI now includes exception class name in error output.
+- **Task 11: README** — DONE.
+- **Task 12: Property Tests** — DONE. Suppressed `function_scoped_fixture` health check.
+- **Task 13: Data Expansion** — DONE. Brief's `decomp_l1.json` had `休` listed twice (one is silent dup).
+- **Task 14: CI Workflow** — DONE. Removed Codecov upload (no token configured).
+- **Task 15: Harvest Script** — DONE.
+- **Post-Task fix**: 囗 missing from primitives set; added.
+
+## Final Stats
+
+- 78 tests passing, 90% test coverage (above 80% gate).
+- 19 commits since the spec doc.
+- All 15 plan tasks complete.
+
+## In-Progress Tasks
+
+(none)
+
+## Blocked Tasks
+
+(none)
+
+## Open Items (Not Blocking — for Final Review)
+
+- **`pyproject.toml:25` authors = []**: PyPI upload will fail until a real author is configured.
+- **`pyproject.toml:[project.urls]`**: placeholder `https://github.com/USER/REPO` should be set to the real repo URL before publish.
+- **`tests/conftest.py:sample_fixture_data`** fixture: defined but not used by any current test (scaffolding for future tasks).
+- **Strip codes (14/16/34/36)**: have no composition rules in spec §2.3 table; calling `compose(14, X)` raises CompositionError. Acceptable per spec since these are wall-strip positions, not standalone.
+- **`P_SURROUND_LL_LO (98)`**: orphan named constant; semantics TBD per spec.
+- **Codecov token**: not configured in CI; coverage gate via `--fail-under=80` works without it.

cjk_semantic_split-0.1.0/.superpowers/sdd/review-22d28a8..564c3e6.diff

@@ -0,0 +1,227 @@
+# Review package: 22d28a8..HEAD
+
+## Commits
+564c3e6 fix(deps): relax hatch pin to >=1.0 (1.18 doesn't exist; 1.17 is latest)
+b832b39 feat: scaffold python project with hatchling
+
+## Files changed
+ .gitignore                        | 44 ++++++++++++++++++++++++++
+ LICENSE                           | 21 +++++++++++++
+ pyproject.toml                    | 65 +++++++++++++++++++++++++++++++++++++++
+ src/chinese_decompose/__init__.py |  2 ++
+ tests/__init__.py                 |  1 +
+ tests/conftest.py                 | 22 +++++++++++++
+ tests/test_smoke.py               | 13 ++++++++
+ 7 files changed, 168 insertions(+)
+
+## Diff
+diff --git a/.gitignore b/.gitignore
+new file mode 100644
+index 0000000..36b59b4
+--- /dev/null
++++ b/.gitignore
+@@ -0,0 +1,44 @@
++# Byte-compiled / optimized / DLL files
++__pycache__/
++*.py[cod]
++*$py.class
++*.so
++.Python
++build/
++develop-eggs/
++dist/
++downloads/
++eggs/
++.eggs/
++lib/
++lib64/
++parts/
++sdist/
++var/
++wheels/
++*.egg-info/
++.installed.cfg
++*.egg
++MANIFEST
++
++# Virtual envs
++.venv/
++venv/
++env/
++ENV/
++
++# Test / coverage
++.pytest_cache/
++.coverage
++.coverage.*
++htmlcov/
++.tox/
++.cache
++coverage.xml
++*.cover
++
++# IDE
++.idea/
++.vscode/
++*.swp
++.DS_Store
+diff --git a/LICENSE b/LICENSE
+new file mode 100644
+index 0000000..14fac91
+--- /dev/null
++++ b/LICENSE
+@@ -0,0 +1,21 @@
++MIT License
++
++Copyright (c) 2026
++
++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.
+diff --git a/pyproject.toml b/pyproject.toml
+new file mode 100644
+index 0000000..26d4258
+--- /dev/null
++++ b/pyproject.toml
+@@ -0,0 +1,65 @@
++[build-system]
++requires = ["hatchling>=1.18"]
++build-backend = "hatchling.build"
++
++[project]
++name = "cjk-semantic-split"
++version = "0.1.0"
++description = "Recursive atomic decomposition of CJK characters with 9-grid spatial encoding"
++readme = "README.md"
++requires-python = ">=3.9"
++license = { file = "LICENSE" }
++authors = []
++keywords = ["cjk", "chinese", "decomposition", "ideograph"]
++classifiers = [
++    "Programming Language :: Python :: 3",
++    "Programming Language :: Python :: 3.9",
++    "Programming Language :: Python :: 3.10",
++    "Programming Language :: Python :: 3.11",
++    "Programming Language :: Python :: 3.12",
++    "License :: OSI Approved :: MIT License",
++    "Operating System :: OS Independent",
++    "Topic :: Software Development :: Libraries :: Python Modules",
++]
++dependencies = []
++
++[project.optional-dependencies]
++dev = [
++    "pytest>=7.0",
++    "pytest-cov>=4.0",
++    "hypothesis>=6.0",
++    "ruff>=0.1",
++    "hatch>=1.0",
++]
++
++[project.urls]
++"Source" = "https://github.com/USER/REPO"
++"Bug Tracker" = "https://github.com/USER/REPO/issues"
++
++[tool.hatch.build.targets.wheel]
++packages = ["src/chinese_decompose"]
++include = ["src/chinese_decompose/data/*.json"]
++
++[tool.pytest.ini_options]
++testpaths = ["tests"]
++pythonpath = ["src"]
++addopts = "-ra --strict-markers"
++
++[tool.coverage.run]
++source = ["src/chinese_decompose"]
++
++[tool.coverage.report]
++exclude_lines = [
++    "pragma: no cover",
++    "raise NotImplementedError",
++    "if __name__ == .__main__.:",
++]
++show_missing = true
++fail_under = 80
++
++[tool.ruff]
++line-length = 100
++target-version = "py39"
++
++[tool.ruff.lint]
++select = ["E", "F", "W", "I", "N", "UP"]
+diff --git a/src/chinese_decompose/__init__.py b/src/chinese_decompose/__init__.py
+new file mode 100644
+index 0000000..c94b366
+--- /dev/null
++++ b/src/chinese_decompose/__init__.py
+@@ -0,0 +1,2 @@
++"""chinese_decompose: recursive atomic decomposition of CJK characters."""
++__version__ = "0.1.0"
+diff --git a/tests/__init__.py b/tests/__init__.py
+new file mode 100644
+index 0000000..38bb211
+--- /dev/null
++++ b/tests/__init__.py
+@@ -0,0 +1 @@
++"""Test package."""
+diff --git a/tests/conftest.py b/tests/conftest.py
+new file mode 100644
+index 0000000..225de0f
+--- /dev/null
++++ b/tests/conftest.py
+@@ -0,0 +1,22 @@
++"""Shared test fixtures."""
++import pytest
++
++
++@pytest.fixture
++def sample_fixture_data() -> dict[str, list[list]]:
++    """Tiny hand-curated decomposition data for tests.
++
++    Each entry: char -> [[component_char, position_code], ...].
++    Positions are 2-digit codes per spec §2.1.
++    """
++    return {
++        # One-level primitive (no entry needed but included for completeness)
++        "木": [],
++        # 2-cell horizontal split
++        "好": [["女", 30], ["子", 40]],
++        # 2-cell with nested decomposition
++        "踩": [["足", 30], ["采", 40]],
++        "采": [["爪", 10], ["木", 20]],
++        # 3-cell horizontal + vertical composition
++        "囚": [["囗", 90], ["人", 0]],
++    }
+diff --git a/tests/test_smoke.py b/tests/test_smoke.py
+new file mode 100644
+index 0000000..f81646c
+--- /dev/null
++++ b/tests/test_smoke.py
+@@ -0,0 +1,13 @@
++"""Smoke tests: package imports cleanly."""
++
++
++def test_package_imports():
++    """Verify the package and version are importable."""
++    import chinese_decompose
++
++    assert chinese_decompose.__version__ == "0.1.0"
++
++
++def test_pytest_runs():
++    """Sanity check: pytest discovers and runs this test."""
++    assert True

cjk_semantic_split-0.1.0/.superpowers/sdd/review-564c3e6..0b4b3f6.diff

@@ -0,0 +1,146 @@
+# Review package: 564c3e6..HEAD
+
+## Commits
+0b4b3f6 feat(structures): add 2-digit position code constants
+
+## Files changed
+ src/chinese_decompose/structures.py | 47 +++++++++++++++++++++++
+ tests/test_structures.py            | 76 +++++++++++++++++++++++++++++++++++++
+ 2 files changed, 123 insertions(+)
+
+## Diff
+diff --git a/src/chinese_decompose/structures.py b/src/chinese_decompose/structures.py
+new file mode 100644
+index 0000000..b70bd35
+--- /dev/null
++++ b/src/chinese_decompose/structures.py
+@@ -0,0 +1,47 @@
++"""Position code constants for the 9-grid spatial encoding.
++
++Codes are 2-digit numbers (spec §2.1): digit A is the spatial zone, digit B
++is the sub-zone within the parent zone (0 means atomic slot, non-zero for
++specific sub-strips or surround variants).
++"""
++from __future__ import annotations
++
++# Atomic single-slot positions
++P_CENTER = 0
++P_TOP = 10
++P_BOTTOM = 20
++P_LEFT = 30
++P_RIGHT = 40
++P_TOP_LEFT = 50
++P_TOP_RIGHT = 60
++P_BOTTOM_LEFT = 70
++P_BOTTOM_RIGHT = 80
++
++# 4-cell layout strip positions
++P_STRIP_VERT_RIGHT = 14   # inner-right-edge of upper zone (e.g. 目's right strip)
++P_STRIP_VERT_LEFT = 16    # inner-left-edge of lower zone
++P_STRIP_HORIZ_RIGHT = 34  # inner-right-edge of left zone (e.g. 罒's right strip)
++P_STRIP_HORIZ_LEFT = 36   # inner-left-edge of right zone
++
++# Surround envelopes (90-99)
++P_SURROUND_FULL = 90
++P_SURROUND_BELOW = 91
++P_SURROUND_LEFT = 92
++P_SURROUND_ABOVE = 93
++P_SURROUND_RIGHT = 94
++P_SURROUND_UL = 95
++P_SURROUND_LR = 96
++P_SURROUND_UR = 97
++P_SURROUND_LL_LO = 98     # lower-bottom extension (semantics TBD per spec)
++P_SURROUND_LL = 99
++
++VALID_POSITIONS: frozenset[int] = frozenset({
++    P_CENTER, P_TOP, P_BOTTOM, P_LEFT, P_RIGHT,
++    P_TOP_LEFT, P_TOP_RIGHT, P_BOTTOM_LEFT, P_BOTTOM_RIGHT,
++    P_STRIP_VERT_RIGHT, P_STRIP_VERT_LEFT,
++    P_STRIP_HORIZ_RIGHT, P_STRIP_HORIZ_LEFT,
++    P_SURROUND_FULL, P_SURROUND_BELOW, P_SURROUND_LEFT,
++    P_SURROUND_ABOVE, P_SURROUND_RIGHT, P_SURROUND_UL,
++    P_SURROUND_LR, P_SURROUND_UR, P_SURROUND_LL,
++    # NOTE: P_SURROUND_LL_LO (98) intentionally excluded — semantics TBD per spec §2.1
++})
+diff --git a/tests/test_structures.py b/tests/test_structures.py
+new file mode 100644
+index 0000000..79ecfeb
+--- /dev/null
++++ b/tests/test_structures.py
+@@ -0,0 +1,76 @@
++"""Tests for structures.py — position codes and constants."""
++from chinese_decompose.structures import (
++    VALID_POSITIONS,
++    P_CENTER,
++    P_TOP,
++    P_BOTTOM,
++    P_LEFT,
++    P_RIGHT,
++    P_TOP_LEFT,
++    P_TOP_RIGHT,
++    P_BOTTOM_LEFT,
++    P_BOTTOM_RIGHT,
++    P_STRIP_VERT_RIGHT,
++    P_STRIP_VERT_LEFT,
++    P_STRIP_HORIZ_RIGHT,
++    P_STRIP_HORIZ_LEFT,
++    P_SURROUND_FULL,
++    P_SURROUND_BELOW,
++    P_SURROUND_LEFT,
++    P_SURROUND_ABOVE,
++    P_SURROUND_RIGHT,
++    P_SURROUND_UL,
++    P_SURROUND_LR,
++    P_SURROUND_UR,
++    P_SURROUND_LL_LO,
++    P_SURROUND_LL,
++)
++
++
++def test_valid_positions_count():
++    """All 22 valid 2-digit position codes are exposed."""
++    assert len(VALID_POSITIONS) == 22
++
++
++def test_valid_positions_contents():
++    """Specific 2-digit codes from spec §2.1 must be in the set."""
++    expected = {0, 10, 20, 30, 40, 50, 60, 70, 80,
++                14, 16, 34, 36,
++                90, 91, 92, 93, 94, 95, 96, 97, 99}
++    # NOTE: 98 not exposed by named constant (semantics TBD per spec)
++    assert expected == VALID_POSITIONS
++
++
++def test_atomic_positions_are_in_set():
++    """Atomic single-slot positions."""
++    assert P_CENTER == 0
++    assert P_TOP == 10
++    assert P_BOTTOM == 20
++    assert P_LEFT == 30
++    assert P_RIGHT == 40
++    assert P_TOP_LEFT == 50
++    assert P_TOP_RIGHT == 60
++    assert P_BOTTOM_LEFT == 70
++    assert P_BOTTOM_RIGHT == 80
++
++
++def test_strip_positions():
++    """4-cell layout strip positions."""
++    assert P_STRIP_VERT_RIGHT == 14
++    assert P_STRIP_VERT_LEFT == 16
++    assert P_STRIP_HORIZ_RIGHT == 34
++    assert P_STRIP_HORIZ_LEFT == 36
++
++
++def test_surround_positions():
++    """Full surround code set 90-99 (excluding 98)."""
++    assert P_SURROUND_FULL == 90
++    assert P_SURROUND_BELOW == 91
++    assert P_SURROUND_LEFT == 92
++    assert P_SURROUND_ABOVE == 93
++    assert P_SURROUND_RIGHT == 94
++    assert P_SURROUND_UL == 95
++    assert P_SURROUND_LR == 96
++    assert P_SURROUND_UR == 97
++    assert P_SURROUND_LL_LO == 98
++    assert P_SURROUND_LL == 99