cokodo-agent 1.0.0__tar.gz

cokodo_agent-1.0.0/.gitignore

@@ -0,0 +1,32 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+.venv/
+*.egg-info/
+dist/
+build/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temp files
+*.tmp
+*.temp
+*.log
+
+# Local config (if any)
+.env
+.env.local

cokodo_agent-1.0.0/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: cokodo-agent
+Version: 1.0.0
+Summary: AI Agent Collaboration Protocol Generator - Create standardized .agent protocol for your projects
+Project-URL: Homepage, https://github.com/dinwind/agent_protocol
+Project-URL: Repository, https://github.com/dinwind/agent_protocol
+Project-URL: Issues, https://github.com/dinwind/agent_protocol/issues
+Author: dinwind
+License-Expression: MIT
+Keywords: agent,ai,claude,cokodo,copilot,cursor,generator,protocol
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Code Generators
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Cokodo Agent
+
+A CLI tool to generate standardized AI collaboration protocol (`.agent`) for your projects.
+
+Similar to `create-react-app`, this tool helps you quickly set up an `.agent` directory with best practices for AI-assisted development.
+
+---
+
+## Installation
+
+```bash
+# Install globally
+pip install cokodo-agent
+
+# Or use pipx (recommended)
+pipx install cokodo-agent
+```
+
+---
+
+## Quick Start
+
+```bash
+# Navigate to your project
+cd my-project
+
+# Run the generator
+cokodo init
+
+# Or specify a path
+cokodo init ./new-project
+```
+
+---
+
+## Usage
+
+### Interactive Mode (Default)
+
+```bash
+$ cokodo init
+
+  Cokodo Agent v1.0.0
+  ====================
+
+  Fetching protocol...
+    [1/2] GitHub Release... OK (v2.1.0)
+
+? Project name: my-awesome-app
+? Brief description: A task management web application
+
+? Primary tech stack:
+  > Python
+    Rust
+    Qt/C++
+    Mixed
+    Other
+
+? AI tools to configure: (space to select)
+  [x] Cursor
+  [x] GitHub Copilot
+  [ ] Claude Projects
+
+  Generating .agent/
+  [========================================] 100%
+
+  Success! Created .agent in /path/to/my-awesome-app
+
+  Next steps:
+    1. Review .agent/project/context.md
+    2. Start coding with AI assistance!
+```
+
+### Quick Mode
+
+```bash
+# Use defaults, skip prompts
+cokodo init --yes
+
+# Specify options directly
+cokodo init --name "my-app" --stack python
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `cokodo init [path]` | Create .agent in target directory |
+| `cokodo version` | Show version information |
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--yes, -y` | Skip prompts, use defaults |
+| `--name` | Project name |
+| `--stack` | Tech stack (python/rust/qt/mixed/other) |
+| `--force` | Overwrite existing .agent directory |
+| `--offline` | Use built-in protocol (no network) |
+
+---
+
+## Protocol Sources
+
+The tool fetches the latest protocol from multiple sources with fallback:
+
+| Priority | Source | Description |
+|----------|--------|-------------|
+| 1 | GitHub Release | Latest version from repository |
+| 2 | Remote Server | Backup server [reserved] |
+| 3 | Built-in | Bundled version in package |
+
+```
+Priority 1: GitHub Release
+    |
+    | [unavailable]
+    v
+Priority 2: Remote Server [reserved, not implemented]
+    |
+    | [unavailable]
+    v
+Priority 3: Built-in (offline fallback)
+```
+
+---
+
+## Generated Structure
+
+```
+your-project/
++-- .agent/                     # Protocol directory
+|   +-- start-here.md           # * Entry point
+|   +-- quick-reference.md      # Cheat sheet
+|   +-- index.md                # Navigation
+|   +-- manifest.json           # Config
+|   +-- core/                   # Governance rules
+|   +-- project/                # Project-specific
+|   |   +-- context.md          # <- Customized
+|   |   +-- tech-stack.md       # <- Customized
+|   +-- skills/                 # Skill modules
+|   +-- adapters/               # Tool adapters
+|   +-- meta/                   # Protocol evolution
+|   +-- scripts/                # Helper scripts
+|
++-- .cursorrules                # [Optional] Cursor config
++-- .github/
+    +-- copilot-instructions.md # [Optional] Copilot config
+```
+
+---
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `COKODO_OFFLINE` | Force offline mode (`1` or `true`) |
+| `COKODO_CACHE_DIR` | Custom cache directory |
+
+### Cache Location
+
+Downloaded protocols are cached at:
+- Linux/macOS: `~/.cache/cokodo/`
+- Windows: `%LOCALAPPDATA%\cokodo\cache\`
+
+---
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/dinwind/agent_protocol.git
+cd agent_protocol/cokodo-agent
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+## Documentation
+
+- [Complete Usage Guide](../docs/usage-guide.md) - Detailed usage instructions
+- [使用指南 (中文)](../docs/usage-guide_cn.md) - Chinese documentation
+- [Agent Protocol Documentation](https://github.com/dinwind/agent_protocol)
+- [Report Issues](https://github.com/dinwind/agent_protocol/issues)

cokodo_agent-1.0.0/README.md

@@ -0,0 +1,196 @@
+# Cokodo Agent
+
+A CLI tool to generate standardized AI collaboration protocol (`.agent`) for your projects.
+
+Similar to `create-react-app`, this tool helps you quickly set up an `.agent` directory with best practices for AI-assisted development.
+
+---
+
+## Installation
+
+```bash
+# Install globally
+pip install cokodo-agent
+
+# Or use pipx (recommended)
+pipx install cokodo-agent
+```
+
+---
+
+## Quick Start
+
+```bash
+# Navigate to your project
+cd my-project
+
+# Run the generator
+cokodo init
+
+# Or specify a path
+cokodo init ./new-project
+```
+
+---
+
+## Usage
+
+### Interactive Mode (Default)
+
+```bash
+$ cokodo init
+
+  Cokodo Agent v1.0.0
+  ====================
+
+  Fetching protocol...
+    [1/2] GitHub Release... OK (v2.1.0)
+
+? Project name: my-awesome-app
+? Brief description: A task management web application
+
+? Primary tech stack:
+  > Python
+    Rust
+    Qt/C++
+    Mixed
+    Other
+
+? AI tools to configure: (space to select)
+  [x] Cursor
+  [x] GitHub Copilot
+  [ ] Claude Projects
+
+  Generating .agent/
+  [========================================] 100%
+
+  Success! Created .agent in /path/to/my-awesome-app
+
+  Next steps:
+    1. Review .agent/project/context.md
+    2. Start coding with AI assistance!
+```
+
+### Quick Mode
+
+```bash
+# Use defaults, skip prompts
+cokodo init --yes
+
+# Specify options directly
+cokodo init --name "my-app" --stack python
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `cokodo init [path]` | Create .agent in target directory |
+| `cokodo version` | Show version information |
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--yes, -y` | Skip prompts, use defaults |
+| `--name` | Project name |
+| `--stack` | Tech stack (python/rust/qt/mixed/other) |
+| `--force` | Overwrite existing .agent directory |
+| `--offline` | Use built-in protocol (no network) |
+
+---
+
+## Protocol Sources
+
+The tool fetches the latest protocol from multiple sources with fallback:
+
+| Priority | Source | Description |
+|----------|--------|-------------|
+| 1 | GitHub Release | Latest version from repository |
+| 2 | Remote Server | Backup server [reserved] |
+| 3 | Built-in | Bundled version in package |
+
+```
+Priority 1: GitHub Release
+    |
+    | [unavailable]
+    v
+Priority 2: Remote Server [reserved, not implemented]
+    |
+    | [unavailable]
+    v
+Priority 3: Built-in (offline fallback)
+```
+
+---
+
+## Generated Structure
+
+```
+your-project/
++-- .agent/                     # Protocol directory
+|   +-- start-here.md           # * Entry point
+|   +-- quick-reference.md      # Cheat sheet
+|   +-- index.md                # Navigation
+|   +-- manifest.json           # Config
+|   +-- core/                   # Governance rules
+|   +-- project/                # Project-specific
+|   |   +-- context.md          # <- Customized
+|   |   +-- tech-stack.md       # <- Customized
+|   +-- skills/                 # Skill modules
+|   +-- adapters/               # Tool adapters
+|   +-- meta/                   # Protocol evolution
+|   +-- scripts/                # Helper scripts
+|
++-- .cursorrules                # [Optional] Cursor config
++-- .github/
+    +-- copilot-instructions.md # [Optional] Copilot config
+```
+
+---
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `COKODO_OFFLINE` | Force offline mode (`1` or `true`) |
+| `COKODO_CACHE_DIR` | Custom cache directory |
+
+### Cache Location
+
+Downloaded protocols are cached at:
+- Linux/macOS: `~/.cache/cokodo/`
+- Windows: `%LOCALAPPDATA%\cokodo\cache\`
+
+---
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/dinwind/agent_protocol.git
+cd agent_protocol/cokodo-agent
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+## Documentation
+
+- [Complete Usage Guide](../docs/usage-guide.md) - Detailed usage instructions
+- [使用指南 (中文)](../docs/usage-guide_cn.md) - Chinese documentation
+- [Agent Protocol Documentation](https://github.com/dinwind/agent_protocol)
+- [Report Issues](https://github.com/dinwind/agent_protocol/issues)

cokodo_agent-1.0.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cokodo-agent"
+version = "1.0.0"
+description = "AI Agent Collaboration Protocol Generator - Create standardized .agent protocol for your projects"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "dinwind" }
+]
+keywords = ["ai", "agent", "protocol", "generator", "copilot", "cursor", "claude", "cokodo"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "questionary>=2.0.0",
+    "httpx>=0.25.0",
+    "jinja2>=3.1.0",
+    "rich>=13.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+]
+
+[project.scripts]
+cokodo = "cokodo_agent.cli:app"
+cokodo-agent = "cokodo_agent.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/dinwind/agent_protocol"
+Repository = "https://github.com/dinwind/agent_protocol"
+Issues = "https://github.com/dinwind/agent_protocol/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cokodo_agent"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+]

cokodo_agent-1.0.0/src/cokodo_agent/__init__.py

@@ -0,0 +1,3 @@
+"""Cokodo Agent - AI collaboration protocol generator."""
+
+__version__ = "1.0.0"

cokodo_agent-1.0.0/src/cokodo_agent/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for python -m cokodo_agent."""
+
+from cokodo_agent.cli import app
+
+if __name__ == "__main__":
+    app()

cokodo_agent-1.0.0/src/cokodo_agent/bundled/agent/adapters/ci/github-actions.template.yml

@@ -0,0 +1,28 @@
+name: Protocol Check
+
+on:
+  push:
+    paths:
+      - '.agent/**'
+  pull_request:
+    paths:
+      - '.agent/**'
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      
+      - name: Protocol Lint
+        run: |
+          python .agent/scripts/lint-protocol.py
+      
+      - name: Token Count
+        run: |
+          python .agent/scripts/token-counter.py

cokodo_agent-1.0.0/src/cokodo_agent/bundled/agent/adapters/ci/pre-commit-config.template.yaml

@@ -0,0 +1,9 @@
+repos:
+  - repo: local
+    hooks:
+      - id: protocol-lint
+        name: Protocol Lint
+        entry: python .agent/scripts/lint-protocol.py
+        language: system
+        pass_filenames: false
+        files: ^\.agent/

cokodo_agent-1.0.0/src/cokodo_agent/bundled/agent/adapters/ci/readme.md

@@ -0,0 +1,34 @@
+# CI/CD Integration Templates
+
+> Templates for integrating protocol checks into CI pipelines.
+
+---
+
+## Available Templates
+
+| Template | Purpose |
+|----------|---------|
+| `github-actions.template.yml` | GitHub Actions workflow |
+| `pre-commit-config.template.yaml` | Pre-commit hooks |
+
+---
+
+## GitHub Actions Setup
+
+```bash
+cp $AGENT_DIR/adapters/ci/github-actions.template.yml .github/workflows/ci.yml
+```
+
+---
+
+## Pre-commit Setup
+
+```bash
+cp $AGENT_DIR/adapters/ci/pre-commit-config.template.yaml .pre-commit-config.yaml
+pip install pre-commit
+pre-commit install
+```
+
+---
+
+*Adapt $AGENT_DIR to your actual directory name*