planpilot 2.2.0__tar.gz → 2.4.0__tar.gz

{planpilot-2.2.0 → planpilot-2.4.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: planpilot
-Version: 2.2.0
+Version: 2.4.0
 Summary: Sync roadmap plans (epics, stories, tasks) to GitHub Issues and Projects v2
 License: MIT
 License-File: LICENSE
 Keywords: github,projects,roadmap,sync,issues,project-management,cli,asyncio
-Author: aryeko
-Maintainer: aryeko
-Requires-Python: >=3.11
+Author: Arye Kogan
+Maintainer: Arye Kogan
+Requires-Python: >=3.11,<4.0
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -35,7 +35,7 @@ Description-Content-Type: text/markdown
 # <img src="https://raw.githubusercontent.com/aryeko/planpilot/main/assets/branding/navigator/navigator-square-512.png" alt="planpilot logo" width="32" height="32" align="absmiddle" /> planpilot
 
 [![CI](https://github.com/aryeko/planpilot/actions/workflows/ci.yml/badge.svg)](https://github.com/aryeko/planpilot/actions/workflows/ci.yml)
-[![codecov](https://codecov.io/gh/aryeko/planpilot/graph/badge.svg?token=3I2A515YTI)](https://codecov.io/gh/aryeko/planpilot)
+[![codecov](https://codecov.io/gh/aryeko/planpilot/graph/badge.svg)](https://codecov.io/gh/aryeko/planpilot)
 [![PyPI](https://img.shields.io/pypi/v/planpilot)](https://pypi.org/project/planpilot/)
 [![Python](https://img.shields.io/pypi/pyversions/planpilot)](https://pypi.org/project/planpilot/)
 [![Downloads](https://static.pepy.tech/badge/planpilot)](https://pepy.tech/project/planpilot)
@@ -45,6 +45,12 @@ Sync roadmap plans (epics, stories, tasks) to GitHub Issues and Projects v2.
 
 > **⭐ If planpilot helps you manage your roadmaps, consider [giving it a star](https://github.com/aryeko/planpilot)!**
 
+## Why planpilot?
+
+Managing roadmaps through GitHub's UI works for small projects, but breaks down fast: manually creating dozens of issues, linking parent/child hierarchies, setting up blocked-by dependencies, and keeping project board fields in sync is tedious and error-prone. Scripting the GitHub API directly means dealing with pagination, rate limits, idempotency, and GraphQL complexity.
+
+**planpilot treats your roadmap as code.** Define epics, stories, and tasks in JSON files, commit them alongside your source code, and let planpilot handle the rest — creating issues, wiring up sub-issue hierarchies, setting blocked-by relations, and populating project board fields. It's idempotent (safe to rerun), supports dry-run previews, and works across multiple epics in a single run.
+
 ## What it does
 
 **planpilot** takes structured plan files and turns them into a fully linked project board:
@@ -72,26 +78,21 @@ planpilot follows SOLID principles with a modular, provider-agnostic design:
 
 ```text
 src/planpilot/
-├── contracts/       # Core types, ABCs, and exception hierarchy
-├── plan/            # Plan loading, validation, and hashing
-├── auth/            # Token resolver strategy + factory
-├── renderers/       # Body rendering implementations
-├── engine/          # 5-phase sync orchestration
-├── providers/       # Provider adapter layer
-│   └── github/      # GitHub GraphQL adapter + generated client
-├── sdk.py           # Composition root and config loading
-└── cli.py           # CLI entry point
+├── core/            # Runtime domains (auth/config/contracts/engine/plan/providers/renderers)
+├── cli/             # CLI parser/app/commands and persistence helpers
+├── sdk.py           # SDK composition root and public facade
+└── __init__.py      # Public API exports
 ```
 
-Core modules depend on contracts, and the SDK composes the runtime pieces. This keeps provider and renderer implementations swappable without changing engine internals.
+Core domains provide business logic, and the SDK composes runtime pieces. This keeps provider and renderer implementations swappable without changing engine internals.
 
 See [docs/design/architecture.md](docs/design/architecture.md) for the full architecture guide.
 
 ## Requirements
 
 - Python 3.11+
-- [`gh` CLI](https://cli.github.com/) installed and authenticated
-- GitHub token scopes: `repo`, `project`
+- GitHub token with `repo` and `project` scopes
+- [`gh` CLI](https://cli.github.com/) only when using `auth: "gh-cli"`
 
 ## Installation
 
@@ -120,42 +121,83 @@ pip install planpilot
 <summary>From source (Poetry)</summary>
 
 ```bash
-poetry add planpilot
+poetry install
 ```
 
 </details>
 
-## Install Agent Skill
-
-### Agent Self-Install
+## Try it now
 
-Tell your agent:
+See planpilot in action without any configuration or GitHub token — the built-in example runs a fully offline dry-run:
 
+```bash
+git clone https://github.com/aryeko/planpilot.git && cd planpilot
+pipx install .   # or: pip install .
+planpilot sync --config examples/sync-workflow/planpilot.json --dry-run
 ```
-Fetch and follow instructions from https://raw.githubusercontent.com/aryeko/planpilot/refs/heads/main/skills/INSTALL.agent.md
+
+```text
+planpilot - sync complete (dry-run)
+
+  Plan ID:   3832d3ffce22
+  Target:    example-org/example-repo
+  Board:     https://github.com/orgs/example-org/projects/1
+
+  Items:     6 total (1 epic, 2 stories, 3 tasks)
+  Created:   6 (1 epic, 2 stories, 3 tasks)
+
+  Sync map:  /absolute/path/to/examples/sync-workflow/output/sync-map-sample.json.dry-run
+
+  [dry-run] No changes were made
 ```
 
-The agent will install both `planpilot` and the skill automatically.
+## Install Agent Skills
 
-### Manual Install
+planpilot ships three agent skills that form a complete product workflow:
+
+| Skill | Purpose |
+|-------|---------|
+| `create-prd` | Generate structured PRDs from feature ideas |
+| `create-tech-spec` | Create codebase-aware technical specs from PRDs |
+| `plan-sync` | Sync specs to GitHub Issues + Projects v2 |
+
+### Claude Code Plugin
 
-Install the skill to the open discovery path used by agent platforms that support filesystem skills:
+Install the planpilot plugin directly in Claude Code (the planpilot CLI is installed automatically from PyPI):
 
 ```bash
-mkdir -p ~/.agents/skills/roadmap-to-github-project
+claude plugin marketplace add aryeko/planpilot
+claude plugin install planpilot@planpilot
+```
+
+Then use:
+- `/planpilot:prd` — create a PRD from a feature idea
+- `/planpilot:spec` — create a tech spec from a PRD
+- `/planpilot:sync` — generate `.plans` JSON and sync to GitHub
+
+### Agent Self-Install
 
-curl -fsSL "https://raw.githubusercontent.com/aryeko/planpilot/main/skills/roadmap-to-github-project/SKILL.md" \
-  -o ~/.agents/skills/roadmap-to-github-project/SKILL.md
+Tell your agent:
+
+```text
+Fetch and follow instructions from https://raw.githubusercontent.com/aryeko/planpilot/main/src/planpilot/skills/INSTALL.agent.md
 ```
 
-Or from a local checkout:
+The agent will install `planpilot` and all three skills automatically.
+
+### Manual Install
+
+Install skills to the open discovery path used by agent platforms that support filesystem skills:
 
 ```bash
-cp skills/roadmap-to-github-project/SKILL.md \
-  ~/.agents/skills/roadmap-to-github-project/SKILL.md
+for skill in create-prd create-tech-spec plan-sync; do
+  mkdir -p ~/.agents/skills/$skill
+  curl -fsSL "https://raw.githubusercontent.com/aryeko/planpilot/main/src/planpilot/skills/$skill/SKILL.md" \
+    -o ~/.agents/skills/$skill/SKILL.md
+done
 ```
 
-Full standalone instructions: [`skills/INSTALL.md`](skills/INSTALL.md)
+Full standalone instructions: [`src/planpilot/skills/INSTALL.md`](src/planpilot/skills/INSTALL.md)
 
 ## Quickstart
 
@@ -178,7 +220,7 @@ cat > planpilot.json <<'JSON'
     "stories": ".plans/stories.json",
     "tasks": ".plans/tasks.json"
   },
-  "sync_path": ".plans/github-sync-map.json"
+  "sync_path": ".plans/sync-map.json"
 }
 JSON
 ```
@@ -221,6 +263,16 @@ planpilot sync --config ./planpilot.json --apply
 | `--apply` | — | Apply mode |
 | `--verbose` | off | Enable verbose logging |
 
+### `planpilot clean`
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--config` | `./planpilot.json` | Path to `planpilot.json` |
+| `--dry-run` | — | Preview which issues would be deleted |
+| `--apply` | — | Execute deletions |
+| `--all` | off | Delete all planpilot-managed issues by label, regardless of current plan hash |
+| `--verbose` | off | Enable verbose logging |
+
 ### `planpilot map sync`
 
 | Flag | Default | Description |
@@ -238,23 +290,39 @@ Full CLI reference: [docs/modules/cli.md](docs/modules/cli.md)
 
 ## Plan file schemas
 
-See [docs/schemas.md](docs/schemas.md) for plan schema examples and [docs/modules/plan.md](docs/modules/plan.md) for validation behavior.
+See [docs/reference/plan-schemas.md](docs/reference/plan-schemas.md) for plan schema examples and [docs/modules/plan.md](docs/modules/plan.md) for validation behavior.
 
 A complete working example is in the [examples/](examples/) directory, including sample rendered issue bodies and a sync-map output.
 
 ## Documentation
 
-- [Docs Index](docs/README.md) -- v2 documentation hub
-- [How It Works](docs/how-it-works.md) -- end-to-end sync behavior
-- [E2E Testing](docs/e2e-testing.md) -- offline end-to-end test design, coverage, and usage
-- [Plan Schemas](docs/schemas.md) -- plan JSON shapes and examples
-- [Architecture](docs/design/architecture.md) -- layer rules and data flow
-- [Contracts](docs/design/contracts.md) -- core domain and adapter contracts
-- [Engine](docs/design/engine.md) -- sync pipeline behavior
-- [CLI](docs/modules/cli.md) -- command structure, output, and exit codes
-- [SDK](docs/modules/sdk.md) -- public API and composition root
-- [Providers](docs/modules/providers.md) -- provider model and extension guide
-- [Release Guide](RELEASE.md) -- automated versioning, publishing, and release pipeline
+- Start here:
+  - [Docs Index](docs/README.md)
+  - [CLI Reference](docs/reference/cli-reference.md)
+  - [SDK Reference](docs/reference/sdk-reference.md)
+  - [Config Reference](docs/reference/config-reference.md)
+  - [Exit Codes](docs/reference/exit-codes.md)
+  - [Workflows Reference](docs/reference/workflows-reference.md)
+  - [Developer Workflow](docs/reference/developer-workflow.md)
+  - [Docs Inventory](docs/reference/docs-inventory.md)
+  - [Troubleshooting](docs/guides/troubleshooting.md)
+- Architecture and behavior:
+  - [How It Works](docs/how-it-works.md)
+  - [Architecture](docs/design/architecture.md)
+  - [Contracts](docs/design/contracts.md)
+  - [Engine](docs/design/engine.md)
+  - [Map Sync Design](docs/design/map-sync.md)
+  - [Clean Workflow Design](docs/design/clean.md)
+  - [Code Map](docs/design/codemap.md)
+- Module implementation details:
+  - [CLI](docs/modules/cli.md)
+  - [SDK](docs/modules/sdk.md)
+  - [Providers](docs/modules/providers.md)
+  - [GitHub Provider](docs/modules/github-provider.md)
+- Operations:
+  - [E2E Testing](docs/testing/e2e.md)
+  - [Release Guide](RELEASE.md)
+  - [Changelog](CHANGELOG.md)
 
 ## Support
 
@@ -272,12 +340,13 @@ Development tasks use [poethepoet](https://github.com/nat-n/poethepoet):
 ```bash
 poe lint           # ruff check
 poe format         # ruff format
-poe test           # pytest -v
+poe docs-links     # validate local markdown links
+poe test           # pytest -v --ignore=tests/e2e
 poe test-e2e       # run offline E2E suite
 poe coverage       # pytest + HTML coverage report
 poe coverage-e2e   # E2E-only coverage XML
 poe typecheck      # mypy
-poe check          # lint + format-check + tests (all-in-one)
+poe check          # lint + format-check + typecheck + tests
 ```
 
 ## Contributing

{planpilot-2.2.0 → planpilot-2.4.0}/README.md

@@ -1,7 +1,7 @@
 # <img src="https://raw.githubusercontent.com/aryeko/planpilot/main/assets/branding/navigator/navigator-square-512.png" alt="planpilot logo" width="32" height="32" align="absmiddle" /> planpilot
 
 [![CI](https://github.com/aryeko/planpilot/actions/workflows/ci.yml/badge.svg)](https://github.com/aryeko/planpilot/actions/workflows/ci.yml)
-[![codecov](https://codecov.io/gh/aryeko/planpilot/graph/badge.svg?token=3I2A515YTI)](https://codecov.io/gh/aryeko/planpilot)
+[![codecov](https://codecov.io/gh/aryeko/planpilot/graph/badge.svg)](https://codecov.io/gh/aryeko/planpilot)
 [![PyPI](https://img.shields.io/pypi/v/planpilot)](https://pypi.org/project/planpilot/)
 [![Python](https://img.shields.io/pypi/pyversions/planpilot)](https://pypi.org/project/planpilot/)
 [![Downloads](https://static.pepy.tech/badge/planpilot)](https://pepy.tech/project/planpilot)
@@ -11,6 +11,12 @@ Sync roadmap plans (epics, stories, tasks) to GitHub Issues and Projects v2.
 
 > **⭐ If planpilot helps you manage your roadmaps, consider [giving it a star](https://github.com/aryeko/planpilot)!**
 
+## Why planpilot?
+
+Managing roadmaps through GitHub's UI works for small projects, but breaks down fast: manually creating dozens of issues, linking parent/child hierarchies, setting up blocked-by dependencies, and keeping project board fields in sync is tedious and error-prone. Scripting the GitHub API directly means dealing with pagination, rate limits, idempotency, and GraphQL complexity.
+
+**planpilot treats your roadmap as code.** Define epics, stories, and tasks in JSON files, commit them alongside your source code, and let planpilot handle the rest — creating issues, wiring up sub-issue hierarchies, setting blocked-by relations, and populating project board fields. It's idempotent (safe to rerun), supports dry-run previews, and works across multiple epics in a single run.
+
 ## What it does
 
 **planpilot** takes structured plan files and turns them into a fully linked project board:
@@ -38,26 +44,21 @@ planpilot follows SOLID principles with a modular, provider-agnostic design:
 
 ```text
 src/planpilot/
-├── contracts/       # Core types, ABCs, and exception hierarchy
-├── plan/            # Plan loading, validation, and hashing
-├── auth/            # Token resolver strategy + factory
-├── renderers/       # Body rendering implementations
-├── engine/          # 5-phase sync orchestration
-├── providers/       # Provider adapter layer
-│   └── github/      # GitHub GraphQL adapter + generated client
-├── sdk.py           # Composition root and config loading
-└── cli.py           # CLI entry point
+├── core/            # Runtime domains (auth/config/contracts/engine/plan/providers/renderers)
+├── cli/             # CLI parser/app/commands and persistence helpers
+├── sdk.py           # SDK composition root and public facade
+└── __init__.py      # Public API exports
 ```
 
-Core modules depend on contracts, and the SDK composes the runtime pieces. This keeps provider and renderer implementations swappable without changing engine internals.
+Core domains provide business logic, and the SDK composes runtime pieces. This keeps provider and renderer implementations swappable without changing engine internals.
 
 See [docs/design/architecture.md](docs/design/architecture.md) for the full architecture guide.
 
 ## Requirements
 
 - Python 3.11+
-- [`gh` CLI](https://cli.github.com/) installed and authenticated
-- GitHub token scopes: `repo`, `project`
+- GitHub token with `repo` and `project` scopes
+- [`gh` CLI](https://cli.github.com/) only when using `auth: "gh-cli"`
 
 ## Installation
 
@@ -86,42 +87,83 @@ pip install planpilot
 <summary>From source (Poetry)</summary>
 
 ```bash
-poetry add planpilot
+poetry install
 ```
 
 </details>
 
-## Install Agent Skill
-
-### Agent Self-Install
+## Try it now
 
-Tell your agent:
+See planpilot in action without any configuration or GitHub token — the built-in example runs a fully offline dry-run:
 
+```bash
+git clone https://github.com/aryeko/planpilot.git && cd planpilot
+pipx install .   # or: pip install .
+planpilot sync --config examples/sync-workflow/planpilot.json --dry-run
 ```
-Fetch and follow instructions from https://raw.githubusercontent.com/aryeko/planpilot/refs/heads/main/skills/INSTALL.agent.md
+
+```text
+planpilot - sync complete (dry-run)
+
+  Plan ID:   3832d3ffce22
+  Target:    example-org/example-repo
+  Board:     https://github.com/orgs/example-org/projects/1
+
+  Items:     6 total (1 epic, 2 stories, 3 tasks)
+  Created:   6 (1 epic, 2 stories, 3 tasks)
+
+  Sync map:  /absolute/path/to/examples/sync-workflow/output/sync-map-sample.json.dry-run
+
+  [dry-run] No changes were made
 ```
 
-The agent will install both `planpilot` and the skill automatically.
+## Install Agent Skills
 
-### Manual Install
+planpilot ships three agent skills that form a complete product workflow:
+
+| Skill | Purpose |
+|-------|---------|
+| `create-prd` | Generate structured PRDs from feature ideas |
+| `create-tech-spec` | Create codebase-aware technical specs from PRDs |
+| `plan-sync` | Sync specs to GitHub Issues + Projects v2 |
+
+### Claude Code Plugin
 
-Install the skill to the open discovery path used by agent platforms that support filesystem skills:
+Install the planpilot plugin directly in Claude Code (the planpilot CLI is installed automatically from PyPI):
 
 ```bash
-mkdir -p ~/.agents/skills/roadmap-to-github-project
+claude plugin marketplace add aryeko/planpilot
+claude plugin install planpilot@planpilot
+```
+
+Then use:
+- `/planpilot:prd` — create a PRD from a feature idea
+- `/planpilot:spec` — create a tech spec from a PRD
+- `/planpilot:sync` — generate `.plans` JSON and sync to GitHub
+
+### Agent Self-Install
 
-curl -fsSL "https://raw.githubusercontent.com/aryeko/planpilot/main/skills/roadmap-to-github-project/SKILL.md" \
-  -o ~/.agents/skills/roadmap-to-github-project/SKILL.md
+Tell your agent:
+
+```text
+Fetch and follow instructions from https://raw.githubusercontent.com/aryeko/planpilot/main/src/planpilot/skills/INSTALL.agent.md
 ```
 
-Or from a local checkout:
+The agent will install `planpilot` and all three skills automatically.
+
+### Manual Install
+
+Install skills to the open discovery path used by agent platforms that support filesystem skills:
 
 ```bash
-cp skills/roadmap-to-github-project/SKILL.md \
-  ~/.agents/skills/roadmap-to-github-project/SKILL.md
+for skill in create-prd create-tech-spec plan-sync; do
+  mkdir -p ~/.agents/skills/$skill
+  curl -fsSL "https://raw.githubusercontent.com/aryeko/planpilot/main/src/planpilot/skills/$skill/SKILL.md" \
+    -o ~/.agents/skills/$skill/SKILL.md
+done
 ```
 
-Full standalone instructions: [`skills/INSTALL.md`](skills/INSTALL.md)
+Full standalone instructions: [`src/planpilot/skills/INSTALL.md`](src/planpilot/skills/INSTALL.md)
 
 ## Quickstart
 
@@ -144,7 +186,7 @@ cat > planpilot.json <<'JSON'
     "stories": ".plans/stories.json",
     "tasks": ".plans/tasks.json"
   },
-  "sync_path": ".plans/github-sync-map.json"
+  "sync_path": ".plans/sync-map.json"
 }
 JSON
 ```
@@ -187,6 +229,16 @@ planpilot sync --config ./planpilot.json --apply
 | `--apply` | — | Apply mode |
 | `--verbose` | off | Enable verbose logging |
 
+### `planpilot clean`
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--config` | `./planpilot.json` | Path to `planpilot.json` |
+| `--dry-run` | — | Preview which issues would be deleted |
+| `--apply` | — | Execute deletions |
+| `--all` | off | Delete all planpilot-managed issues by label, regardless of current plan hash |
+| `--verbose` | off | Enable verbose logging |
+
 ### `planpilot map sync`
 
 | Flag | Default | Description |
@@ -204,23 +256,39 @@ Full CLI reference: [docs/modules/cli.md](docs/modules/cli.md)
 
 ## Plan file schemas
 
-See [docs/schemas.md](docs/schemas.md) for plan schema examples and [docs/modules/plan.md](docs/modules/plan.md) for validation behavior.
+See [docs/reference/plan-schemas.md](docs/reference/plan-schemas.md) for plan schema examples and [docs/modules/plan.md](docs/modules/plan.md) for validation behavior.
 
 A complete working example is in the [examples/](examples/) directory, including sample rendered issue bodies and a sync-map output.
 
 ## Documentation
 
-- [Docs Index](docs/README.md) -- v2 documentation hub
-- [How It Works](docs/how-it-works.md) -- end-to-end sync behavior
-- [E2E Testing](docs/e2e-testing.md) -- offline end-to-end test design, coverage, and usage
-- [Plan Schemas](docs/schemas.md) -- plan JSON shapes and examples
-- [Architecture](docs/design/architecture.md) -- layer rules and data flow
-- [Contracts](docs/design/contracts.md) -- core domain and adapter contracts
-- [Engine](docs/design/engine.md) -- sync pipeline behavior
-- [CLI](docs/modules/cli.md) -- command structure, output, and exit codes
-- [SDK](docs/modules/sdk.md) -- public API and composition root
-- [Providers](docs/modules/providers.md) -- provider model and extension guide
-- [Release Guide](RELEASE.md) -- automated versioning, publishing, and release pipeline
+- Start here:
+  - [Docs Index](docs/README.md)
+  - [CLI Reference](docs/reference/cli-reference.md)
+  - [SDK Reference](docs/reference/sdk-reference.md)
+  - [Config Reference](docs/reference/config-reference.md)
+  - [Exit Codes](docs/reference/exit-codes.md)
+  - [Workflows Reference](docs/reference/workflows-reference.md)
+  - [Developer Workflow](docs/reference/developer-workflow.md)
+  - [Docs Inventory](docs/reference/docs-inventory.md)
+  - [Troubleshooting](docs/guides/troubleshooting.md)
+- Architecture and behavior:
+  - [How It Works](docs/how-it-works.md)
+  - [Architecture](docs/design/architecture.md)
+  - [Contracts](docs/design/contracts.md)
+  - [Engine](docs/design/engine.md)
+  - [Map Sync Design](docs/design/map-sync.md)
+  - [Clean Workflow Design](docs/design/clean.md)
+  - [Code Map](docs/design/codemap.md)
+- Module implementation details:
+  - [CLI](docs/modules/cli.md)
+  - [SDK](docs/modules/sdk.md)
+  - [Providers](docs/modules/providers.md)
+  - [GitHub Provider](docs/modules/github-provider.md)
+- Operations:
+  - [E2E Testing](docs/testing/e2e.md)
+  - [Release Guide](RELEASE.md)
+  - [Changelog](CHANGELOG.md)
 
 ## Support
 
@@ -238,12 +306,13 @@ Development tasks use [poethepoet](https://github.com/nat-n/poethepoet):
 ```bash
 poe lint           # ruff check
 poe format         # ruff format
-poe test           # pytest -v
+poe docs-links     # validate local markdown links
+poe test           # pytest -v --ignore=tests/e2e
 poe test-e2e       # run offline E2E suite
 poe coverage       # pytest + HTML coverage report
 poe coverage-e2e   # E2E-only coverage XML
 poe typecheck      # mypy
-poe check          # lint + format-check + tests (all-in-one)
+poe check          # lint + format-check + typecheck + tests
 ```
 
 ## Contributing

{planpilot-2.2.0 → planpilot-2.4.0}/pyproject.toml

@@ -1,11 +1,11 @@
 [tool.poetry]
 name = "planpilot"
-version = "2.2.0"
+version = "2.4.0"
 description = "Sync roadmap plans (epics, stories, tasks) to GitHub Issues and Projects v2"
 readme = "README.md"
 license = "MIT"
-authors = ["aryeko"]
-maintainers = ["aryeko"]
+authors = ["Arye Kogan"]
+maintainers = ["Arye Kogan"]
 homepage = "https://github.com/aryeko/planpilot"
 repository = "https://github.com/aryeko/planpilot"
 documentation = "https://github.com/aryeko/planpilot/tree/main/docs"
@@ -27,7 +27,6 @@ classifiers = [
 packages = [
     {include = "planpilot", from = "src"},
 ]
-exclude = ["skills"]
 
 [tool.poetry.urls]
 "Bug Tracker" = "https://github.com/aryeko/planpilot/issues"
@@ -38,7 +37,7 @@ exclude = ["skills"]
 planpilot = "planpilot.cli:main"
 
 [tool.poetry.dependencies]
-python = ">=3.11"
+python = ">=3.11,<4.0"
 pydantic = "^2.12.5"
 httpx = "^0.28"
 questionary = "^2.1"
@@ -51,7 +50,7 @@ mypy = ">=1.0"
 pytest-cov = "^7.0.0"
 pytest-asyncio = "^1.3.0"
 commitlint = ">=1.3"
-poethepoet = "^0.40.0"
+poethepoet = ">=0.40,<0.42"
 python-semantic-release = {version = "10.5.3", python = ">=3.11,<4.0"}
 # ariadne-codegen is run via pipx (click conflict with python-semantic-release)
 # pipx run --spec "ariadne-codegen>=0.17,<0.18" ariadne-codegen
@@ -64,12 +63,14 @@ build-backend = "poetry.core.masonry.api"
 lint = "ruff check ."
 format = "ruff format ."
 format-check = "ruff format --check ."
+workflow-lint = "./scripts/actionlint.sh"
+docs-links = "python scripts/check_markdown_links.py"
 test = "pytest -v --ignore=tests/e2e"
 test-e2e = "pytest -v tests/e2e/test_cli_e2e.py"
 coverage = "pytest -v --cov-report=html:.coverage/html"
 coverage-e2e = "pytest -v tests/e2e/test_cli_e2e.py --cov-report=term-missing --cov-report=xml:.coverage/coverage-e2e.xml"
 typecheck = "mypy src/planpilot"
-check = ["lint", "format-check", "test"]
+check = ["lint", "format-check", "typecheck", "test"]
 
 [tool.poe.tasks.gen-schema]
 help = "Introspect GitHub GraphQL API and download schema"
@@ -77,7 +78,7 @@ shell = "export GITHUB_TOKEN=\"bearer $(gh auth token)\" && pipx run --spec 'ari
 
 [tool.poe.tasks.gen-client]
 help = "Generate typed GraphQL client from schema and operations"
-shell = "rm -rf src/planpilot/providers/github/github_gql && pipx run --spec 'ariadne-codegen>=0.17,<0.18' ariadne-codegen && ruff check --fix src/planpilot/providers/github/github_gql && ruff format src/planpilot/providers/github/github_gql"
+shell = "rm -rf src/planpilot/core/providers/github/github_gql && pipx run --spec 'ariadne-codegen>=0.17,<0.18' ariadne-codegen && ruff check --fix src/planpilot/core/providers/github/github_gql && ruff format src/planpilot/core/providers/github/github_gql"
 
 [tool.poe.tasks.gen-gql]
 help = "Download schema and generate GraphQL client"
@@ -98,7 +99,7 @@ source = ["planpilot"]
 branch = true
 data_file = ".coverage/coverage.db"
 omit = [
-    "src/planpilot/providers/github/github_gql/*",
+    "src/planpilot/core/providers/github/github_gql/*",
 ]
 
 [tool.coverage.report]
@@ -127,7 +128,7 @@ select = [
 ]
 
 [tool.ruff.lint.per-file-ignores]
-"src/planpilot/providers/github/github_gql/*" = ["F401", "RUF022", "UP042", "UP045", "E501"]
+"src/planpilot/core/providers/github/github_gql/*" = ["F401", "RUF022", "UP042", "UP045", "E501"]
 
 [tool.ruff.lint.isort]
 known-first-party = ["planpilot"]
@@ -138,11 +139,12 @@ warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
 plugins = ["pydantic.mypy"]
-exclude = "(^src/planpilot/providers/github/github_gql/)"
+files = ["src/planpilot"]
+exclude = "(^src/planpilot/core/providers/github/github_gql/)"
 
 [tool.semantic_release]
 version_toml = ["pyproject.toml:tool.poetry.version"]
-version_variables = ["src/planpilot/__init__.py:__version__"]
+version_variables = ["src/planpilot/__init__.py:__version__", "src/planpilot/.claude-plugin/plugin.json:version"]
 commit_parser = "conventional"
 commit_message = "chore(release): {version}"
 tag_format = "v{version}"
@@ -163,10 +165,10 @@ mode = "update"
 type = "github"
 
 [tool.ariadne-codegen]
-schema_path = "src/planpilot/providers/github/schema.graphql"
-queries_path = "src/planpilot/providers/github/operations"
+schema_path = "src/planpilot/core/providers/github/schema.graphql"
+queries_path = "src/planpilot/core/providers/github/operations"
 target_package_name = "github_gql"
-target_package_path = "src/planpilot/providers/github"
+target_package_path = "src/planpilot/core/providers/github"
 client_name = "GitHubGraphQLClient"
 client_file_name = "client"
 async_client = true

planpilot-2.4.0/src/planpilot/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "planpilot",
+  "owner": {
+    "name": "Arye Kogan",
+    "email": "aryekogan@gmail.com"
+  },
+  "plugins": [
+    {
+      "name": "planpilot",
+      "source": {
+        "source": "pip",
+        "package": "planpilot"
+      }
+    }
+  ]
+}