zco-claude 0.0.8__py3-none-any.whl

ClaudeSettings/zco-scripts/update-plan-metadata.py

@@ -0,0 +1,324 @@
+#!/usr/bin/env python3
+"""
+Plan Metadata Auto-Update Script
+
+Updates YAML front matter in plan documents with:
+- Status transitions (draft:0 → ongoing:2 → completed:3)
+- Timestamp management (created_at, updated_at)
+- Auto-generated tags (from Claude input)
+
+Usage:
+    echo '{"plan_path": "/path/to/plan.md", "action": "start"}' | python3 update-plan-metadata.py
+
+Actions:
+    - start: Set status to ongoing:2, initialize timestamps
+    - complete: Set status to completed:3, update timestamp
+    - fail: Set status to failed:4, update timestamp
+    - cancel: Set status to canceled:5, update timestamp
+
+Input (stdin JSON):
+    {
+        "plan_path": "/path/to/plan.md",
+        "action": "start|complete|fail|cancel",
+        "tags": ["feature", "backend"]  # optional
+    }
+
+Output (stdout JSON):
+    Success: {"success": true, "old_status": "draft:0", "new_status": "ongoing:2", "updated_at": "2026-01-09 15:30:45"}
+    Error: {"success": false, "error": "error message"}
+"""
+
+import json
+import sys
+import re
+from datetime import datetime
+from pathlib import Path
+import tempfile
+import shutil
+
+try:
+    import yaml
+except ImportError:
+    print(json.dumps({
+        'success': False,
+        'error': 'PyYAML not installed. Run: pip install PyYAML'
+    }), file=sys.stderr)
+    sys.exit(1)
+
+
+class PlanMetadataUpdater:
+    """Handles parsing and updating plan document YAML front matter"""
+
+    STATUS_ENUM = {
+        'draft:0': '起稿中',
+        'ready:1': '准备就绪',
+        'ongoing:2': '进行中',
+        'completed:3': '执行完成',
+        'failed:4': '执行失败',
+        'canceled:5': '已取消',
+        'archived:8': '已归档'
+    }
+
+    PRIORITY_ENUM = {
+        'p0:紧急:重要': '紧急且重要',
+        'p1:高:当前迭代/排期内重点解决': '高优先级',
+        'p2:中:可纳入后续迭代计划': '中等优先级',
+        'p3:低:可记录，待后续评估': '低优先级',
+        'p4:无:不影响当前迭代/排期': '无优先级'
+    }
+
+    def __init__(self, plan_path: str):
+        self.plan_path = Path(plan_path)
+
+        if not self.plan_path.exists():
+            raise FileNotFoundError(f"Plan file not found: {plan_path}")
+
+        self.content = self._read_file()
+        self.yaml_data, self.yaml_start, self.yaml_end = self._parse_yaml()
+        self.body = self.content[self.yaml_end:]
+
+    def _read_file(self) -> str:
+        """Read plan file content"""
+        try:
+            return self.plan_path.read_text(encoding='utf-8')
+        except Exception as e:
+            raise IOError(f"Failed to read file {self.plan_path}: {e}")
+
+    def _parse_yaml(self) -> tuple:
+        """
+        Parse YAML front matter
+
+        Returns:
+            tuple: (yaml_data dict, yaml_start pos, yaml_end pos)
+        """
+        # Extract YAML between --- markers
+        match = re.match(r'^(---\n)(.*?)(---\n)', self.content, re.DOTALL)
+
+        if not match:
+            raise ValueError(
+                f"No YAML front matter found in {self.plan_path.name}. "
+                "File must start with ---\\n and end YAML section with ---\\n"
+            )
+
+        yaml_start = match.start()
+        yaml_end = match.end()
+        yaml_text = match.group(2)
+
+        try:
+            yaml_data = yaml.safe_load(yaml_text)
+        except yaml.YAMLError as e:
+            raise ValueError(f"Malformed YAML in {self.plan_path.name}: {e}")
+
+        if not isinstance(yaml_data, dict):
+            raise ValueError(f"YAML front matter must be a dictionary, got: {type(yaml_data)}")
+
+        return yaml_data, yaml_start, yaml_end
+
+    def normalize_status(self, status: str) -> str:
+        """
+        Convert old status format to new enum format
+
+        Args:
+            status: Status string (old or new format)
+
+        Returns:
+            Normalized status in enum format (e.g., "ongoing:2")
+        """
+        # Map old format to new format
+        status_map = {
+            'pending': 'draft:0',
+            'in-progress': 'ongoing:2',
+            'completed': 'completed:3',
+            'cancelled': 'canceled:5'
+        }
+
+        if ':' in status:
+            # Already new format - validate it exists
+            if status in self.STATUS_ENUM:
+                return status
+            else:
+                # Unknown enum, default to draft
+                return 'draft:0'
+        else:
+            # Old format - convert
+            return status_map.get(status.lower(), 'draft:0')
+
+    def update_status(self, new_status: str, tags: list = None):
+        """
+        Update plan status and timestamps
+
+        Args:
+            new_status: Target status (ongoing:2, completed:3, etc.)
+            tags: Optional tags list from Claude
+
+        Returns:
+            tuple: (old_status, new_status)
+        """
+        now = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
+
+        # Get and normalize current status
+        old_status = self.yaml_data.get('status', 'draft:0')
+        old_status = self.normalize_status(old_status)
+
+        # Validate new status
+        if new_status not in self.STATUS_ENUM:
+            raise ValueError(f"Invalid status: {new_status}. Must be one of: {list(self.STATUS_ENUM.keys())}")
+
+        # Update status
+        self.yaml_data['status'] = new_status
+
+        # Update timestamps
+        if not self.yaml_data.get('created_at') or self.yaml_data.get('created_at') == '':
+            # First execution - set created_at
+            self.yaml_data['created_at'] = now
+
+        self.yaml_data['updated_at'] = now
+
+        # Update tags if provided
+        if tags is not None:
+            if isinstance(tags, list):
+                self.yaml_data['tags'] = tags
+            elif isinstance(tags, str):
+                # Parse comma-separated string
+                self.yaml_data['tags'] = [t.strip() for t in tags.split(',') if t.strip()]
+
+        # Ensure other required fields exist
+        if 'seq' not in self.yaml_data:
+            # Try to extract from filename: plan.{seq}.*.md
+            match = re.match(r'plan\.(\d+)\.', self.plan_path.name)
+            if match:
+                self.yaml_data['seq'] = int(match.group(1))
+
+        if 'priority' not in self.yaml_data or self.yaml_data.get('priority') == '':
+            # Default priority
+            self.yaml_data['priority'] = 'p2:中:可纳入后续迭代计划'
+
+        # Write back to file
+        self._write_file()
+
+        return old_status, new_status
+
+    def _write_file(self):
+        """
+        Write updated content back to file using atomic write
+
+        Uses temp file + rename to prevent corruption
+        """
+        try:
+            # Dump YAML with custom settings
+            yaml_str = yaml.dump(
+                self.yaml_data,
+                allow_unicode=True,
+                default_flow_style=False,
+                sort_keys=False,
+                width=1000  # Prevent line wrapping
+            )
+
+            # Reconstruct file content
+            new_content = f"---\n{yaml_str}---\n{self.body}"
+
+            # Atomic write: write to temp file, then rename
+            temp_fd, temp_path = tempfile.mkstemp(
+                suffix='.md',
+                prefix=f'.{self.plan_path.name}_',
+                dir=self.plan_path.parent,
+                text=True
+            )
+
+            try:
+                with open(temp_fd, 'w', encoding='utf-8') as f:
+                    f.write(new_content)
+
+                # Atomic rename
+                shutil.move(temp_path, self.plan_path)
+
+            except Exception as e:
+                # Cleanup temp file on error
+                try:
+                    Path(temp_path).unlink()
+                except:
+                    pass
+                raise
+
+        except Exception as e:
+            raise IOError(f"Failed to write file {self.plan_path}: {e}")
+
+
+def main():
+    """
+    CLI Interface for plan metadata updates
+
+    Reads JSON from stdin, updates plan metadata, outputs JSON result
+    """
+    try:
+        # Read JSON input from stdin
+        input_data = json.load(sys.stdin)
+
+        # Validate required fields
+        if 'plan_path' not in input_data:
+            raise ValueError("Missing required field: plan_path")
+
+        if 'action' not in input_data:
+            raise ValueError("Missing required field: action")
+
+        plan_path = input_data['plan_path']
+        action = input_data['action']
+        tags = input_data.get('tags', None)
+
+        # Map action to status
+        status_map = {
+            'start': 'ongoing:2',
+            'complete': 'completed:3',
+            'fail': 'failed:4',
+            'cancel': 'canceled:5'
+        }
+
+        new_status = status_map.get(action)
+        if not new_status:
+            raise ValueError(f"Invalid action: {action}. Must be one of: {list(status_map.keys())}")
+
+        # Update metadata
+        updater = PlanMetadataUpdater(plan_path)
+        old_status, new_status = updater.update_status(new_status, tags)
+
+        # Success response
+        result = {
+            'success': True,
+            'plan_path': plan_path,
+            'old_status': old_status,
+            'new_status': new_status,
+            'created_at': updater.yaml_data.get('created_at', ''),
+            'updated_at': updater.yaml_data.get('updated_at', ''),
+            'tags': updater.yaml_data.get('tags', [])
+        }
+
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+        sys.exit(0)
+
+    except json.JSONDecodeError as e:
+        error_result = {
+            'success': False,
+            'error': f'Invalid JSON input: {e}'
+        }
+        print(json.dumps(error_result), file=sys.stderr)
+        sys.exit(1)
+
+    except (ValueError, FileNotFoundError, IOError) as e:
+        error_result = {
+            'success': False,
+            'error': str(e)
+        }
+        print(json.dumps(error_result), file=sys.stderr)
+        sys.exit(1)
+
+    except Exception as e:
+        error_result = {
+            'success': False,
+            'error': f'Unexpected error: {type(e).__name__}: {e}'
+        }
+        print(json.dumps(error_result), file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()

zco_claude-0.0.8.dist-info/METADATA

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: zco-claude
+Version: 0.0.8
+Summary: Claude Code 配置管理工具 - 快速初始化项目的 .claude 配置目录
+Home-page: https://github.com/zco-team/zco-claude
+Author: ZCO Team
+Author-email: NicoNing <vmico@outlook.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/zco-team/zco-claude
+Project-URL: Repository, https://github.com/zco-team/zco-claude.git
+Project-URL: Issues, https://github.com/zco-team/zco-claude/issues
+Keywords: claude,claude-code,cli,configuration,settings template,claude-skills
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+
+# ClaudeSettings 配置扩展包
+
+[![PyPI version](https://badge.fury.io/py/zco-claude.svg)](https://badge.fury.io/py/zco-claude)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+Claude Code 配置管理工具 - 快速初始化项目的 `.claude` 配置目录
+
+## 安装
+
+### 方式一：通过 pip 安装（推荐）
+
+```bash
+pip install zco-claude
+```
+
+### 方式二：本地安装
+
+```bash
+git clone <repository-url>
+cd zco-claude-skills
+pip install -e .
+```
+
+### 方式三：使用 Makefile
+
+```bash
+make install   # 复制安装
+make link      # 软链接安装（开发推荐）
+make uninstall # 卸载
+```
+
+## 使用方法
+
+### 初始化项目
+
+```bash
+# 初始化当前目录
+zco-claude init
+
+# 初始化指定目录
+zco-claude init /path/to/project
+
+# 使用自定义模板
+zco-claude init /path/to/project --tpl /custom/template
+```
+
+### 管理已链接项目
+
+```bash
+# 列出所有已链接的项目
+zco-claude list-linked-repos
+
+# 修复所有项目的软链接
+zco-claude fix-linked-repos
+
+# 删除不存在的项目记录
+zco-claude fix-linked-repos --remove-not-found
+
+# 修复指定项目
+zco-claude fix /path/to/project
+```
+
+### 生成全局配置
+
+```bash
+# 仅生成全局配置
+zco-claude
+```
+
+## 支持的命令
+
+| 命令 | 说明 |
+|------|------|
+| `init [path] [--tpl]` | 初始化项目配置 |
+| `list-linked-repos` | 列出已链接项目 |
+| `fix-linked-repos [--remove-not-found]` | 修复所有项目软链接 |
+| `fix [path] [--tpl]` | 修复指定项目软链接 |
+
+## zco-plan 工作流程
+
+### 1. 安装工具
+
+```bash
+pip install zco-claude
+```
+
+### 2. 初始化项目
+
+```bash
+cd /path/to/your/project
+zco-claude init
+```
+
+### 3. 启动 Claude Code
+
+```bash
+claude .
+```
+
+### 4. 执行计划
+
+```
+/zco-plan 001
+```
+
+### 5. 创建新计划
+
+```
+/zco-plan-new 实现用户认证功能
+```
+
+## 项目结构
+
+```
+.
+├── src/
+│   └── zco_claude/
+│       ├── __init__.py
+│       ├── __main__.py
+│       ├── cli.py              # 主命令行工具
+│       └── ClaudeSettings/     # 配置模板
+│           ├── commands/
+│           ├── hooks/
+│           ├── rules/
+│           ├── skills/
+│           └── zco-scripts/
+├── docs/
+│   └── plans/                  # 计划文档
+├── pyproject.toml              # 包配置
+├── setup.py                    # 安装脚本
+└── Makefile                    # 快捷命令
+```
+
+## 开发
+
+### 构建包
+
+```bash
+python setup.py sdist bdist_wheel
+```
+
+### 本地测试安装
+
+```bash
+pip install -e .
+```
+
+### 上传到 PyPI
+
+```bash
+# 安装工具
+pip install twine
+
+# 上传
+python -m twine upload dist/*
+```
+
+## 许可证
+
+MIT License
+

zco_claude-0.0.8.dist-info/RECORD

@@ -0,0 +1,34 @@
+zco_claude_init.py,sha256=dC2gOKAFpzZ3IDjTNl3yuq8ZRH_cAFmssRggNDan_5k,59106
+ClaudeSettings/DOT.claudeignore,sha256=5TunbuRtwH2Sqls0-O-qVsLnGG_OuzXe6pNuTRyI7_Y,74
+ClaudeSettings/README.md,sha256=2pkCTpQJvkGUSgDYN2VT-jzvcUJ1PRHjmXzsddCRRkE,2541
+ClaudeSettings/settings.sample.json,sha256=2dPH5LpQxv0qClREr27uqrlYn3bUdjOOi7Nt6rw4L2E,1701
+ClaudeSettings/commands/generate_changelog.sh,sha256=9U7LdF0wDQpjqSak5ql92IS4V1D3HEnbnSu2wAmwelM,1771
+ClaudeSettings/commands/show_env,sha256=A7K0MG4RfP6XqRiJ3ZYZyapjrCUepPTnk3DCWKefCFg,2816
+ClaudeSettings/commands/zco-clean,sha256=tGCd9TxxIHiuWPnS4Jkp0xqYmJJ53EacvVTfAmcAywg,4839
+ClaudeSettings/commands/zco-git-summary,sha256=hb0Tr1GOUk4wjkEWw8O3aj_hlcw8GFOR-inyK5_3Zbo,375
+ClaudeSettings/commands/zco-git-tag,sha256=VGTr7WoIVRUqTbRaxQ92SkYbl3ZARmhuRTqYlLHSQLc,1394
+ClaudeSettings/hooks/CHANGELOG.md,sha256=pXR_iKRy29Vrg-pLG51c0KIl--0FIA7OheQOxJq8xzU,3343
+ClaudeSettings/hooks/README.md,sha256=-3L2RW7n6ukLYsuFRGE_cJfssRG4PVudYXdAD57miOE,6047
+ClaudeSettings/hooks/save_chat_plain.py,sha256=aeCQUK0DkONBd9ZKbDeihcH-SX1WJ7shBEeqFAlCO3I,4748
+ClaudeSettings/hooks/save_chat_spec.py,sha256=CH78j3TYaqt6aZDYvnQNV22MlyKYKp9aIxMuSJumCac,13811
+ClaudeSettings/rules/README.md,sha256=cGbgv4k-bL9gXTmSNP0XGMgZG2oAciL-V4Zduxa_XO8,5919
+ClaudeSettings/rules/go/.golangci.yml.template,sha256=3REc23nDiqUMJWQRBnnTbjuLLNNUls283M3oVj9Ln64,3505
+ClaudeSettings/rules/go/GoBuildAutoVersion.v250425.md,sha256=CJt8kPPCTtNwlsdou-QzaXVkmwCuLBEfqZX954bVu10,2589
+ClaudeSettings/rules/go/check-standards.sh,sha256=jj9Du95rgJRC0jV_-MeMVWGa9oovRpo4758YEzTXh_Q,3519
+ClaudeSettings/rules/go/coding-standards.md,sha256=B5IW2zkX_UXWdjpqPC5e6EoeUz4brU0ya_ytSYLEZwg,19877
+ClaudeSettings/rules/go/example.go,sha256=dtpIyCBsUwd5udhz_qgPTg5hyj-16FBgKu6dfX6Lh1Y,5129
+ClaudeSettings/rules/go/go-testing.md,sha256=K-LCGQZjRRvKUEmh2jlbTdK9cOlhPX7Yv4dZVWjvXOs,14177
+ClaudeSettings/rules/go/list-comments.sh,sha256=jBhFkbbmQwiYsYwuEtB5gbgw3FnrQYfB4ptk_wRoAdE,2244
+ClaudeSettings/skills/README.md,sha256=GiDBytWucdaKRkFu0fhg7PhFyO-S7S-LjNPl3EP1xEk,4690
+ClaudeSettings/skills/zco-docs-update/SKILL.md,sha256=ttNUH4zEum1X-ycOyeopxV3qOQAu9WNQPtdLtlTdLW4,8826
+ClaudeSettings/skills/zco-help/SKILL.md,sha256=RiPcbekw0MhAT8kJH15McBN3M5UuAfONAB8-vpYBUCA,16858
+ClaudeSettings/skills/zco-plan/SKILL.md,sha256=PqFkbKCH49SnzjiqBrU_5ToD-gHaBrES-DEC9GDhV1M,15348
+ClaudeSettings/skills/zco-plan-new/SKILL.md,sha256=fw50MM6ES74X_V1agmYNOoNGXJ5JluEd1NjfYPavyy0,13866
+ClaudeSettings/zco-scripts/co-docs-update.sh,sha256=4Pq8ZzHSlmdorbTaCgKsGLl8Xdrx2JMZ_hQAA0m95cc,4217
+ClaudeSettings/zco-scripts/test_update_plan_metadata.py,sha256=Vuvci7--b6-jEvThnmdpukw-yq21Q9BNCpCLCT1A8Hc,8875
+ClaudeSettings/zco-scripts/update-plan-metadata.py,sha256=xHmARVV-gth6zY6TwfJPMJzn9WeZNbPlrwdrYkGUg5E,10169
+zco_claude-0.0.8.dist-info/METADATA,sha256=C5eMTJL8pSjMGVNDinj3s8J-xT15X2MIHXrNPsG34JU,3921
+zco_claude-0.0.8.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+zco_claude-0.0.8.dist-info/entry_points.txt,sha256=7scvouCbVq1bajSMnTlB0p08sz_HVPSYgtVMMkdOAJk,79
+zco_claude-0.0.8.dist-info/top_level.txt,sha256=z90aX525nPqTigU74uWrpww-_dFTPMPQm9CQkg2NvSc,16
+zco_claude-0.0.8.dist-info/RECORD,,

zco_claude-0.0.8.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

zco_claude-0.0.8.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+zco = zco_claude_init:main
+zco-claude = zco_claude_init:main

zco_claude-0.0.8.dist-info/top_level.txt

@@ -0,0 +1 @@
+zco_claude_init