planager 0.1.1__tar.gz

planager-0.1.1/.claude/settings.local.json

@@ -0,0 +1,19 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(uv sync:*)",
+      "Bash(uv add:*)",
+      "Bash(uv run:*)",
+      "Read(//tmp/**)",
+      "Bash(mkdir -p test-planager)",
+      "Bash(rm -rf /tmp/test-planager2)",
+      "Bash(mkdir /tmp/test-planager2)",
+      "Bash(rm -rf /tmp/test-planager3)",
+      "Bash(mkdir /tmp/test-planager3)",
+      "Bash(uvx --from /home/forest/PycharmProjects/planager planager init --path /tmp/test-planager3)",
+      "Bash(wc -l /tmp/test-planager3/CLAUDE.md /tmp/test-planager3/.claude/skills/*/SKILL.md)",
+      "Bash(python3:*)",
+      "Bash(uv build:*)"
+    ]
+  }
+}

planager-0.1.1/.gitignore

@@ -0,0 +1,164 @@
+### Python template
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+

planager-0.1.1/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: planager
+Version: 0.1.1
+Summary: Feature plans for LLM-assisted development. One command sets up your project so coding agents automatically create, follow, and maintain structured plans.
+Project-URL: Repository, https://github.com/forest-d/planager
+Author: forest-d
+License-Expression: MIT
+Keywords: claude,codex,development,llm,planning
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# planager
+
+Feature plans for LLM-assisted development.
+
+One command sets up your project so coding agents (Claude Code, Codex, etc.)
+automatically create, follow, and maintain structured feature plans across
+sessions.
+
+## Install
+
+```bash
+cd your-project
+uvx planager init
+```
+
+That's it. No runtime dependencies, no background processes. The command copies
+a few template files into your project and you're done.
+
+## What it does
+
+After `planager init`, your project gets:
+
+- **`.plans/`** — directory where feature plans live (markdown files).
+- **`.claude/skills/plan/`** — a `/plan` slash command for creating and resuming plans.
+- **`.claude/skills/plan-status/`** — a `/plan-status` slash command for checking progress.
+- **CLAUDE.md snippet** — instructions that make the agent automatically discover
+  and follow plans without you having to ask.
+
+## How it works
+
+Plans are markdown files with frontmatter, phased steps, and checkboxes:
+
+```markdown
+---
+feature: auth
+title: User Authentication
+status: in-progress
+created: 2026-04-18
+updated: 2026-04-18
+---
+
+## Context
+
+Implement email/password authentication with session management.
+
+## Phase 1: Database schema
+
+- [x] Create users table migration
+- [x] Add password hashing utility
+- [ ] Add session table migration
+
+## Phase 2: API endpoints
+
+- [ ] POST /login
+- [ ] POST /register
+
+## Notes
+
+Using bcrypt for hashing. Decided against JWT — sessions are simpler for now.
+```
+
+The CLAUDE.md snippet teaches the agent to:
+
+1. **Check for in-progress plans** at the start of each session.
+2. **Create plans** before starting non-trivial features.
+3. **Update plans** as work progresses (check off steps, add notes).
+4. **Mark plans done** when a feature is complete.
+
+No special tools or MCP servers — the agent reads and writes plain markdown files.
+
+## Slash commands
+
+### `/plan`
+
+Create a new feature plan or resume an existing one.
+
+- With a description: `/plan add dark mode support` — explores the codebase,
+  drafts a phased plan, asks for approval.
+- Without: `/plan` — lists in-progress plans and offers to resume or create new.
+
+### `/plan-status`
+
+Show progress across all plans:
+
+```
+Feature          Status       Progress
+───────────────  ───────────  ────────────────
+auth             in-progress  Phase 2: 3/7
+dark-mode        planning     Phase 1: 0/4
+api-v2           done         5/5
+```
+
+## Idempotent
+
+Running `uvx planager init` again is safe — it skips files that already exist
+and won't duplicate the CLAUDE.md snippet.
+
+## License
+
+MIT

planager-0.1.1/PLAN.md

@@ -0,0 +1,232 @@
+# planager — Feature Plans for LLM-Assisted Development
+
+## Overview
+
+planager is a lightweight tool that gives LLM coding agents (Claude Code,
+Codex, etc.) the ability to automatically create, follow, and maintain
+feature plans across sessions. The runtime behavior is pure markdown and
+CLAUDE.md conventions — no database, no server. The Python package exists
+only as a distribution mechanism: `uvx planager init` copies template files
+into your project, then the package is no longer involved.
+
+### What gets installed into your project
+
+```
+your-project/
+  .plans/                    # feature plan markdown files (create as needed)
+  .claude/
+    skills/
+      plan/SKILL.md          # /plan — create or resume a feature plan
+      plan-status/SKILL.md   # /plan-status — summarize all plans
+  CLAUDE.md                  # planager snippet appended (or created)
+```
+
+### What the agent does automatically (via CLAUDE.md instructions)
+
+1. **Session start**: checks `.plans/` for `in-progress` plans and offers
+   to resume.
+2. **New feature work**: creates a plan (explore codebase, propose phases,
+   get user approval) before writing code.
+3. **During work**: checks off steps, adds notes, updates the plan file.
+4. **On completion**: marks the plan `done` with a summary.
+
+No MCP tools, no special runtime. The agent reads and writes markdown files.
+
+---
+
+## User experience
+
+```bash
+# One-time install (works from any machine with uv)
+cd my-project
+uvx planager init
+
+# That's it. From now on, Claude Code automatically uses plans.
+# Or use the slash commands:
+#   /plan          — create a new plan or resume an existing one
+#   /plan-status   — see progress across all plans
+```
+
+---
+
+## Plan format
+
+```markdown
+---
+feature: short-slug
+title: Human-Readable Title
+status: planning | in-progress | blocked | done
+created: 2026-04-18
+updated: 2026-04-18
+---
+
+## Context
+
+What the feature is, why it matters, constraints, links to issues or docs.
+Everything an agent needs to start or resume work without asking questions.
+
+## Phase 1: <title>
+
+Brief description of this phase's goal.
+
+- [x] Completed step
+- [ ] Pending step
+
+## Phase 2: <title>
+
+- [ ] Step
+- [ ] Step
+
+## Notes
+
+Running log — decisions, blockers, things tried, links to commits/PRs.
+```
+
+Key properties:
+- **Self-contained**: the plan has all context needed to resume work.
+- **Round-trip safe**: agents read and rewrite plans without losing content.
+- **Human-readable**: it's just markdown. Open it, read it, edit it by hand.
+- **Git-friendly**: diffs show exactly what changed between sessions.
+
+---
+
+## CLAUDE.md snippet
+
+The core integration. When present in a project's CLAUDE.md, it makes Claude
+Code automatically aware of plans without any user prompting.
+
+The snippet instructs the agent to:
+
+1. **On session start**: check `.plans/` for any `in-progress` or `blocked`
+   plans. If one exists and the user's request relates to it, read it and
+   resume from the first unchecked step.
+2. **When starting a new feature**: create a plan in `.plans/<slug>.md`
+   before writing code. Explore the codebase, design phases, and get user
+   approval on the plan before implementing.
+3. **While working**: check off steps as they're completed. Add notes about
+   decisions or blockers. Update the `updated` date and `status` field.
+4. **On completion**: set status to `done`, write a final note summarizing
+   what was built.
+
+---
+
+## Slash-command skills
+
+### `/plan` — Create or resume a plan
+
+Behavior:
+- If there are `in-progress` plans, list them and ask which to resume (or
+  offer to create a new one).
+- If creating new: ask for a brief description, explore the codebase to
+  understand what's involved, then draft a phased plan and present it for
+  approval before saving to `.plans/`.
+- If resuming: read the plan, summarize where things stand, and begin work
+  from the first unchecked step.
+
+### `/plan-status` — Show status of all plans
+
+Reads all `.md` files in `.plans/`, parses frontmatter and checkboxes, and
+prints a summary table:
+
+```
+Feature          Status       Progress
+───────────────  ───────────  ─────────
+auth             in-progress  Phase 2: 3/7
+dark-mode        planning     Phase 1: 0/4
+api-v2           done         5/5
+```
+
+---
+
+## Architecture
+
+```
+planager/
+  src/planager/
+    __init__.py
+    cli.py               # entry point: `planager init`
+    templates/            # bundled template files
+      CLAUDE.md.snippet
+      plan/SKILL.md
+      plan-status/SKILL.md
+  pyproject.toml          # uv/hatchling config, [project.scripts]
+  README.md
+  PLAN.md                 # this file
+```
+
+The package is a thin wrapper around file-copy logic. The `init` command:
+1. Creates `.plans/` directory.
+2. Copies skill files into `.claude/skills/`.
+3. Appends the CLAUDE.md snippet (or creates CLAUDE.md if absent).
+4. Is idempotent — safe to run again without duplicating content.
+
+Only dependency: Python stdlib. No runtime dependencies.
+
+### Tooling
+
+- **uv** — packaging, virtual environments, `uvx` for one-shot execution.
+- **hatchling** — build backend.
+- **ruff** — linting and formatting.
+- **pytest** — tests.
+
+---
+
+## Phases of implementation
+
+### Phase 1: Core content
+
+The CLAUDE.md snippet and skill definitions are the product. Everything
+else is packaging around them.
+
+- [ ] Write the CLAUDE.md snippet with automatic plan behavior
+  - Session-start: detect and offer to resume in-progress plans
+  - New feature: explore, propose phased plan, get approval, save
+  - During work: check steps, add notes, update frontmatter
+  - Completion: set done, write summary
+- [ ] Write `plan/SKILL.md` — the `/plan` skill
+  - Create flow: gather description, explore, propose phases
+  - Resume flow: read plan, summarize, begin from first unchecked step
+- [ ] Write `plan-status/SKILL.md` — the `/plan-status` skill
+  - Glob `.plans/*.md`, parse frontmatter + checkboxes, print table
+- [ ] Test: add the snippet and skills to this repo, start a fresh session,
+  verify the agent follows the plan workflow automatically
+
+### Phase 2: Package and `init` command
+
+- [ ] Set up project skeleton (pyproject.toml, src layout, uv sync)
+- [ ] Bundle template files in `src/planager/templates/`
+- [ ] Write `cli.py` with `planager init` command
+  - Create `.plans/`
+  - Copy skills into `.claude/skills/`
+  - Append snippet to CLAUDE.md (skip if already present)
+  - Idempotent
+- [ ] Wire up `[project.scripts]` so `uvx planager init` works
+- [ ] Write tests for the init command (verify files created, idempotency)
+- [ ] Ensure `ruff check` and `ruff format --check` pass
+
+### Phase 3: Distribution and docs
+
+- [ ] Fill out pyproject.toml metadata (description, author, license, urls)
+- [ ] Write README.md
+  - One-liner install: `uvx planager init`
+  - What it does, how it works, plan format reference
+  - Examples of plan workflow in practice
+- [ ] Test: `uvx` install from source into a clean project, verify workflow
+- [ ] Publish to PyPI (`uv build && uv publish`)
+
+### Phase 4: Polish
+
+- [ ] Refine CLAUDE.md wording based on real usage
+- [ ] Consider: Codex/AGENTS.md equivalent of the CLAUDE.md snippet
+- [ ] Consider: `/plan-archive` skill to move done plans out of the way
+- [ ] Consider: plan templates for different work types (feature vs bugfix)
+
+---
+
+## Non-goals
+
+- Runtime dependencies or background processes
+- Database or registry
+- MCP server
+- Web UI
+- Issue tracker integration

planager-0.1.1/README.md

@@ -0,0 +1,100 @@
+# planager
+
+Feature plans for LLM-assisted development.
+
+One command sets up your project so coding agents (Claude Code, Codex, etc.)
+automatically create, follow, and maintain structured feature plans across
+sessions.
+
+## Install
+
+```bash
+cd your-project
+uvx planager init
+```
+
+That's it. No runtime dependencies, no background processes. The command copies
+a few template files into your project and you're done.
+
+## What it does
+
+After `planager init`, your project gets:
+
+- **`.plans/`** — directory where feature plans live (markdown files).
+- **`.claude/skills/plan/`** — a `/plan` slash command for creating and resuming plans.
+- **`.claude/skills/plan-status/`** — a `/plan-status` slash command for checking progress.
+- **CLAUDE.md snippet** — instructions that make the agent automatically discover
+  and follow plans without you having to ask.
+
+## How it works
+
+Plans are markdown files with frontmatter, phased steps, and checkboxes:
+
+```markdown
+---
+feature: auth
+title: User Authentication
+status: in-progress
+created: 2026-04-18
+updated: 2026-04-18
+---
+
+## Context
+
+Implement email/password authentication with session management.
+
+## Phase 1: Database schema
+
+- [x] Create users table migration
+- [x] Add password hashing utility
+- [ ] Add session table migration
+
+## Phase 2: API endpoints
+
+- [ ] POST /login
+- [ ] POST /register
+
+## Notes
+
+Using bcrypt for hashing. Decided against JWT — sessions are simpler for now.
+```
+
+The CLAUDE.md snippet teaches the agent to:
+
+1. **Check for in-progress plans** at the start of each session.
+2. **Create plans** before starting non-trivial features.
+3. **Update plans** as work progresses (check off steps, add notes).
+4. **Mark plans done** when a feature is complete.
+
+No special tools or MCP servers — the agent reads and writes plain markdown files.
+
+## Slash commands
+
+### `/plan`
+
+Create a new feature plan or resume an existing one.
+
+- With a description: `/plan add dark mode support` — explores the codebase,
+  drafts a phased plan, asks for approval.
+- Without: `/plan` — lists in-progress plans and offers to resume or create new.
+
+### `/plan-status`
+
+Show progress across all plans:
+
+```
+Feature          Status       Progress
+───────────────  ───────────  ────────────────
+auth             in-progress  Phase 2: 3/7
+dark-mode        planning     Phase 1: 0/4
+api-v2           done         5/5
+```
+
+## Idempotent
+
+Running `uvx planager init` again is safe — it skips files that already exist
+and won't duplicate the CLAUDE.md snippet.
+
+## License
+
+MIT

planager-0.1.1/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "planager"
+version = "0.1.1"
+description = "Feature plans for LLM-assisted development. One command sets up your project so coding agents automatically create, follow, and maintain structured plans."
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "forest-d" }]
+readme = "README.md"
+keywords = ["claude", "codex", "llm", "planning", "development"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development",
+]
+
+[project.urls]
+Repository = "https://github.com/forest-d/planager"
+
+[project.scripts]
+planager = "planager.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/planager"]
+
+
+[tool.ruff]
+target-version = "py312"
+line-length = 99
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.3",
+]

planager-0.1.1/src/planager/__init__.py

@@ -0,0 +1 @@
+"""planager — Feature plans for LLM-assisted development."""

planager-0.1.1/src/planager/cli.py

@@ -0,0 +1,112 @@
+"""CLI entry point: `planager init` sets up a project for plan-based development."""
+
+from __future__ import annotations
+
+import argparse
+import shutil
+import sys
+from importlib.resources import files
+from pathlib import Path
+
+SNIPPET_MARKER = "<!-- planager:start -->"
+SNIPPET_END_MARKER = "<!-- planager:end -->"
+
+TEMPLATES = files("planager.templates")
+
+
+def get_template_path() -> Path:
+    """Resolve the templates directory to a filesystem path."""
+    return Path(str(TEMPLATES))
+
+
+def init_project(target: Path) -> list[str]:
+    """Install planager files into *target* project directory.
+
+    Returns a list of actions taken (for user feedback).
+    """
+    actions: list[str] = []
+    template_dir = get_template_path()
+
+    # 1. Create .plans/ directory
+    plans_dir = target / ".plans"
+    if not plans_dir.exists():
+        plans_dir.mkdir(parents=True)
+        actions.append("Created .plans/")
+    else:
+        actions.append(".plans/ already exists, skipped")
+
+    # 2. Copy skill files
+    skills_dir = target / ".claude" / "skills"
+    for skill_name in ("plan", "plan-status"):
+        skill_dest = skills_dir / skill_name / "SKILL.md"
+        skill_src = template_dir / skill_name / "SKILL.md"
+
+        if skill_dest.exists():
+            actions.append(f".claude/skills/{skill_name}/SKILL.md already exists, skipped")
+        else:
+            skill_dest.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(str(skill_src), str(skill_dest))
+            actions.append(f"Created .claude/skills/{skill_name}/SKILL.md")
+
+    # 3. Append CLAUDE.md snippet
+    claude_md = target / "CLAUDE.md"
+    snippet = (template_dir / "CLAUDE.md.snippet").read_text()
+    wrapped_snippet = f"{SNIPPET_MARKER}\n{snippet}{SNIPPET_END_MARKER}\n"
+
+    if claude_md.exists():
+        existing = claude_md.read_text()
+        if SNIPPET_MARKER in existing:
+            actions.append("CLAUDE.md already has planager snippet, skipped")
+        else:
+            with claude_md.open("a") as f:
+                f.write("\n" + wrapped_snippet)
+            actions.append("Appended planager snippet to CLAUDE.md")
+    else:
+        claude_md.write_text(wrapped_snippet)
+        actions.append("Created CLAUDE.md with planager snippet")
+
+    return actions
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="planager",
+        description="Feature plans for LLM-assisted development.",
+    )
+    sub = parser.add_subparsers(dest="command")
+
+    init_parser = sub.add_parser(
+        "init",
+        help="Set up the current project for plan-based development.",
+    )
+    init_parser.add_argument(
+        "--path",
+        type=Path,
+        default=Path.cwd(),
+        help="Project root directory (default: current directory).",
+    )
+
+    args = parser.parse_args(argv)
+
+    if args.command is None:
+        parser.print_help()
+        return 1
+
+    if args.command == "init":
+        target = args.path.resolve()
+        if not target.is_dir():
+            print(f"Error: {target} is not a directory.", file=sys.stderr)
+            return 1
+
+        actions = init_project(target)
+        print(f"Initialized planager in {target}\n")
+        for action in actions:
+            print(f"  {action}")
+        print("\nDone. Start a Claude Code session and plans will work automatically.")
+        return 0
+
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

planager-0.1.1/src/planager/templates/CLAUDE.md.snippet

@@ -0,0 +1,75 @@
+
+# Feature Plans
+
+This project uses **planager** for structured feature planning. Plans are
+markdown files in `.plans/` with phased steps and checkboxes.
+
+## Automatic behavior
+
+### On session start
+
+Check `.plans/` for any plans with `status: in-progress` or `status: blocked`.
+If any exist, briefly note them to the user (e.g. "There's an in-progress plan
+for <title>"). If the user's request clearly relates to one, read it and resume
+from the first unchecked step. Don't force it — if the user is asking about
+something unrelated, just mention the plan exists and move on.
+
+### When starting new feature work
+
+Before writing code for a non-trivial feature, create a plan:
+
+1. Ask the user for a brief description (if not already provided).
+2. Explore the codebase to understand what's involved.
+3. Draft a phased plan with concrete, checkable steps.
+4. Present the plan to the user for approval.
+5. Save the approved plan to `.plans/<feature-slug>.md`.
+6. Begin implementation from Phase 1.
+
+Skip planning for trivial tasks (single-file fixes, typos, config changes).
+Use judgment — if the work spans multiple files or sessions, it deserves a plan.
+
+### While working on a planned feature
+
+- Check off steps (`- [x]`) as they are completed.
+- Add notes to the `## Notes` section for decisions, blockers, or alternatives
+  considered.
+- Update the `updated` date in frontmatter.
+- Set `status: in-progress` when work begins (if still `planning`).
+- If blocked, set `status: blocked` and note the reason.
+
+### On completion
+
+- Set `status: done` in frontmatter.
+- Write a brief summary in `## Notes` of what was built.
+- Check off all remaining steps.
+
+## Plan format
+
+```markdown
+---
+feature: short-slug
+title: Human-Readable Title
+status: planning | in-progress | blocked | done
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+---
+
+## Context
+
+What the feature is, why it matters, constraints, links to issues or docs.
+
+## Phase 1: <title>
+
+Brief description of this phase.
+
+- [ ] Step description
+- [ ] Step description
+
+## Phase 2: <title>
+
+- [ ] Step description
+
+## Notes
+
+Running log of decisions, blockers, things tried.
+```

planager-0.1.1/src/planager/templates/plan/SKILL.md

@@ -0,0 +1,35 @@
+# /plan — Create or resume a feature plan
+
+When the user invokes `/plan`, follow this workflow.
+
+## If given a description (e.g. `/plan add dark mode support`)
+
+1. Choose a short slug from the description (e.g. `dark-mode`).
+2. Check if `.plans/<slug>.md` already exists.
+   - If it does and is `in-progress`, switch to the **resume** flow below.
+   - If it does and is `done`, tell the user and ask if they want a new plan.
+3. Explore the codebase to understand what the feature involves:
+   - Read relevant files, check existing patterns, identify what needs to change.
+4. Draft a phased plan with concrete steps. Each step should be small enough
+   to complete in one action (a file edit, a test run, etc.).
+5. Present the plan to the user. Ask for approval or adjustments.
+6. Save the approved plan to `.plans/<slug>.md` with `status: planning`.
+7. Ask the user if they want to begin implementation now.
+   - If yes, set `status: in-progress` and start from Phase 1, step 1.
+
+## If invoked without a description (e.g. just `/plan`)
+
+1. Glob `.plans/*.md` and read the frontmatter of each.
+2. List any `in-progress` or `blocked` plans.
+3. If there are in-progress plans, ask the user:
+   - Resume one of them? (default if there's only one)
+   - Or create a new plan?
+4. If creating new, ask for a brief description and follow the flow above.
+
+## Resume flow
+
+1. Read the full plan file.
+2. Summarize current status: which phases are done, what's next.
+3. Begin work from the first unchecked step.
+4. Follow the standard plan update behavior (check steps, add notes, update
+   frontmatter) as you work.

planager-0.1.1/src/planager/templates/plan-status/SKILL.md

@@ -0,0 +1,22 @@
+# /plan-status — Show status of all feature plans
+
+When the user invokes `/plan-status`, do the following:
+
+1. Glob `.plans/*.md` to find all plan files.
+2. If no plans exist, say so and exit.
+3. For each plan file, read it and extract:
+   - `feature` and `title` from frontmatter
+   - `status` from frontmatter
+   - Checkbox counts: total `- [ ]` and `- [x]` lines per `## Phase N:` section
+   - Overall progress: completed steps / total steps
+4. Print a summary table, for example:
+
+```
+Feature          Status       Progress
+───────────────  ───────────  ────────────────
+auth             in-progress  Phase 2: 3/7
+dark-mode        planning     Phase 1: 0/4
+api-v2           done         5/5
+```
+
+5. If any plan is `blocked`, show the reason from the Notes section if available.

planager-0.1.1/tests/test_cli.py

@@ -0,0 +1,76 @@
+"""Tests for planager init command."""
+
+
+from planager.cli import SNIPPET_MARKER, init_project, main
+
+
+class TestInitProject:
+    def test_creates_plans_dir(self, tmp_path):
+        init_project(tmp_path)
+        assert (tmp_path / ".plans").is_dir()
+
+    def test_creates_plan_skill(self, tmp_path):
+        init_project(tmp_path)
+        skill = tmp_path / ".claude" / "skills" / "plan" / "SKILL.md"
+        assert skill.exists()
+        assert "/plan" in skill.read_text()
+
+    def test_creates_plan_status_skill(self, tmp_path):
+        init_project(tmp_path)
+        skill = tmp_path / ".claude" / "skills" / "plan-status" / "SKILL.md"
+        assert skill.exists()
+        assert "/plan-status" in skill.read_text()
+
+    def test_creates_claude_md(self, tmp_path):
+        init_project(tmp_path)
+        claude_md = tmp_path / "CLAUDE.md"
+        assert claude_md.exists()
+        content = claude_md.read_text()
+        assert SNIPPET_MARKER in content
+        assert "Feature Plans" in content
+
+    def test_appends_to_existing_claude_md(self, tmp_path):
+        claude_md = tmp_path / "CLAUDE.md"
+        claude_md.write_text("# My Project\n\nExisting content.\n")
+
+        init_project(tmp_path)
+
+        content = claude_md.read_text()
+        assert content.startswith("# My Project")
+        assert "Existing content." in content
+        assert SNIPPET_MARKER in content
+
+    def test_idempotent(self, tmp_path):
+        actions1 = init_project(tmp_path)
+        actions2 = init_project(tmp_path)
+
+        assert all("Created" in a for a in actions1)
+        assert all("skipped" in a for a in actions2)
+
+        # Content not duplicated
+        claude_md = (tmp_path / "CLAUDE.md").read_text()
+        assert claude_md.count(SNIPPET_MARKER) == 1
+
+    def test_returns_actions(self, tmp_path):
+        actions = init_project(tmp_path)
+        assert len(actions) == 4
+        assert any(".plans/" in a for a in actions)
+        assert any("plan/SKILL.md" in a for a in actions)
+        assert any("plan-status/SKILL.md" in a for a in actions)
+        assert any("CLAUDE.md" in a for a in actions)
+
+
+class TestMain:
+    def test_init_subcommand(self, tmp_path):
+        ret = main(["init", "--path", str(tmp_path)])
+        assert ret == 0
+        assert (tmp_path / ".plans").is_dir()
+        assert (tmp_path / "CLAUDE.md").exists()
+
+    def test_no_subcommand_shows_help(self, capsys):
+        ret = main([])
+        assert ret == 1
+
+    def test_bad_path(self, tmp_path):
+        ret = main(["init", "--path", str(tmp_path / "nonexistent")])
+        assert ret == 1

planager-0.1.1/uv.lock

@@ -0,0 +1,156 @@
+version = 1
+revision = 1
+requires-python = ">=3.10"
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335 },
+]
+
+[[package]]
+name = "exceptiongroup"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8a/0e/97c33bf5009bdbac74fd2beace167cab3f978feb69cc36f1ef79360d6c4e/exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598", size = 16740 },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484 },
+]
+
+[[package]]
+name = "packaging"
+version = "26.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/df/de/0d2b39fb4af88a0258f3bac87dfcbb48e73fbdea4a2ed0e2213f9a4c2f9a/packaging-26.1.tar.gz", hash = "sha256:f042152b681c4bfac5cae2742a55e103d27ab2ec0f3d88037136b6bfe7c9c5de", size = 215519 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7a/c2/920ef838e2f0028c8262f16101ec09ebd5969864e5a64c4c05fad0617c56/packaging-26.1-py3-none-any.whl", hash = "sha256:5d9c0669c6285e491e0ced2eee587eaf67b670d94a19e94e3984a481aba6802f", size = 95831 },
+]
+
+[[package]]
+name = "planager"
+version = "0.1.0"
+source = { editable = "." }
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+]
+
+[package.metadata]
+
+[package.metadata.requires-dev]
+dev = [{ name = "pytest", specifier = ">=9.0.3" }]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538 },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151 },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "exceptiongroup", marker = "python_full_version < '3.11'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+    { name = "tomli", marker = "python_full_version < '3.11'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7d/0d/549bd94f1a0a402dc8cf64563a117c0f3765662e2e668477624baeec44d5/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d4/24/a372aaf5c9b7208e7112038812994107bc65a84cd00e0354a88c2c77a617/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249 },
+]
+
+[[package]]
+name = "tomli"
+version = "2.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/22/de/48c59722572767841493b26183a0d1cc411d54fd759c5607c4590b6563a6/tomli-2.4.1.tar.gz", hash = "sha256:7c7e1a961a0b2f2472c1ac5b69affa0ae1132c39adcb67aba98568702b9cc23f", size = 17543 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/11/db3d5885d8528263d8adc260bb2d28ebf1270b96e98f0e0268d32b8d9900/tomli-2.4.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f8f0fc26ec2cc2b965b7a3b87cd19c5c6b8c5e5f436b984e85f486d652285c30", size = 154704 },
+    { url = "https://files.pythonhosted.org/packages/6d/f7/675db52c7e46064a9aa928885a9b20f4124ecb9bc2e1ce74c9106648d202/tomli-2.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4ab97e64ccda8756376892c53a72bd1f964e519c77236368527f758fbc36a53a", size = 149454 },
+    { url = "https://files.pythonhosted.org/packages/61/71/81c50943cf953efa35bce7646caab3cf457a7d8c030b27cfb40d7235f9ee/tomli-2.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96481a5786729fd470164b47cdb3e0e58062a496f455ee41b4403be77cb5a076", size = 237561 },
+    { url = "https://files.pythonhosted.org/packages/48/c1/f41d9cb618acccca7df82aaf682f9b49013c9397212cb9f53219e3abac37/tomli-2.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5a881ab208c0baf688221f8cecc5401bd291d67e38a1ac884d6736cbcd8247e9", size = 243824 },
+    { url = "https://files.pythonhosted.org/packages/22/e4/5a816ecdd1f8ca51fb756ef684b90f2780afc52fc67f987e3c61d800a46d/tomli-2.4.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:47149d5bd38761ac8be13a84864bf0b7b70bc051806bc3669ab1cbc56216b23c", size = 242227 },
+    { url = "https://files.pythonhosted.org/packages/6b/49/2b2a0ef529aa6eec245d25f0c703e020a73955ad7edf73e7f54ddc608aa5/tomli-2.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ec9bfaf3ad2df51ace80688143a6a4ebc09a248f6ff781a9945e51937008fcbc", size = 247859 },
+    { url = "https://files.pythonhosted.org/packages/83/bd/6c1a630eaca337e1e78c5903104f831bda934c426f9231429396ce3c3467/tomli-2.4.1-cp311-cp311-win32.whl", hash = "sha256:ff2983983d34813c1aeb0fa89091e76c3a22889ee83ab27c5eeb45100560c049", size = 97204 },
+    { url = "https://files.pythonhosted.org/packages/42/59/71461df1a885647e10b6bb7802d0b8e66480c61f3f43079e0dcd315b3954/tomli-2.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:5ee18d9ebdb417e384b58fe414e8d6af9f4e7a0ae761519fb50f721de398dd4e", size = 108084 },
+    { url = "https://files.pythonhosted.org/packages/b8/83/dceca96142499c069475b790e7913b1044c1a4337e700751f48ed723f883/tomli-2.4.1-cp311-cp311-win_arm64.whl", hash = "sha256:c2541745709bad0264b7d4705ad453b76ccd191e64aa6f0fc66b69a293a45ece", size = 95285 },
+    { url = "https://files.pythonhosted.org/packages/c1/ba/42f134a3fe2b370f555f44b1d72feebb94debcab01676bf918d0cb70e9aa/tomli-2.4.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c742f741d58a28940ce01d58f0ab2ea3ced8b12402f162f4d534dfe18ba1cd6a", size = 155924 },
+    { url = "https://files.pythonhosted.org/packages/dc/c7/62d7a17c26487ade21c5422b646110f2162f1fcc95980ef7f63e73c68f14/tomli-2.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7f86fd587c4ed9dd76f318225e7d9b29cfc5a9d43de44e5754db8d1128487085", size = 150018 },
+    { url = "https://files.pythonhosted.org/packages/5c/05/79d13d7c15f13bdef410bdd49a6485b1c37d28968314eabee452c22a7fda/tomli-2.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff18e6a727ee0ab0388507b89d1bc6a22b138d1e2fa56d1ad494586d61d2eae9", size = 244948 },
+    { url = "https://files.pythonhosted.org/packages/10/90/d62ce007a1c80d0b2c93e02cab211224756240884751b94ca72df8a875ca/tomli-2.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:136443dbd7e1dee43c68ac2694fde36b2849865fa258d39bf822c10e8068eac5", size = 253341 },
+    { url = "https://files.pythonhosted.org/packages/1a/7e/caf6496d60152ad4ed09282c1885cca4eea150bfd007da84aea07bcc0a3e/tomli-2.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:5e262d41726bc187e69af7825504c933b6794dc3fbd5945e41a79bb14c31f585", size = 248159 },
+    { url = "https://files.pythonhosted.org/packages/99/e7/c6f69c3120de34bbd882c6fba7975f3d7a746e9218e56ab46a1bc4b42552/tomli-2.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5cb41aa38891e073ee49d55fbc7839cfdb2bc0e600add13874d048c94aadddd1", size = 253290 },
+    { url = "https://files.pythonhosted.org/packages/d6/2f/4a3c322f22c5c66c4b836ec58211641a4067364f5dcdd7b974b4c5da300c/tomli-2.4.1-cp312-cp312-win32.whl", hash = "sha256:da25dc3563bff5965356133435b757a795a17b17d01dbc0f42fb32447ddfd917", size = 98141 },
+    { url = "https://files.pythonhosted.org/packages/24/22/4daacd05391b92c55759d55eaee21e1dfaea86ce5c571f10083360adf534/tomli-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:52c8ef851d9a240f11a88c003eacb03c31fc1c9c4ec64a99a0f922b93874fda9", size = 108847 },
+    { url = "https://files.pythonhosted.org/packages/68/fd/70e768887666ddd9e9f5d85129e84910f2db2796f9096aa02b721a53098d/tomli-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:f758f1b9299d059cc3f6546ae2af89670cb1c4d48ea29c3cacc4fe7de3058257", size = 95088 },
+    { url = "https://files.pythonhosted.org/packages/07/06/b823a7e818c756d9a7123ba2cda7d07bc2dd32835648d1a7b7b7a05d848d/tomli-2.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:36d2bd2ad5fb9eaddba5226aa02c8ec3fa4f192631e347b3ed28186d43be6b54", size = 155866 },
+    { url = "https://files.pythonhosted.org/packages/14/6f/12645cf7f08e1a20c7eb8c297c6f11d31c1b50f316a7e7e1e1de6e2e7b7e/tomli-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:eb0dc4e38e6a1fd579e5d50369aa2e10acfc9cace504579b2faabb478e76941a", size = 149887 },
+    { url = "https://files.pythonhosted.org/packages/5c/e0/90637574e5e7212c09099c67ad349b04ec4d6020324539297b634a0192b0/tomli-2.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7f2c7f2b9ca6bdeef8f0fa897f8e05085923eb091721675170254cbc5b02897", size = 243704 },
+    { url = "https://files.pythonhosted.org/packages/10/8f/d3ddb16c5a4befdf31a23307f72828686ab2096f068eaf56631e136c1fdd/tomli-2.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f3c6818a1a86dd6dca7ddcaaf76947d5ba31aecc28cb1b67009a5877c9a64f3f", size = 251628 },
+    { url = "https://files.pythonhosted.org/packages/e3/f1/dbeeb9116715abee2485bf0a12d07a8f31af94d71608c171c45f64c0469d/tomli-2.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d312ef37c91508b0ab2cee7da26ec0b3ed2f03ce12bd87a588d771ae15dcf82d", size = 247180 },
+    { url = "https://files.pythonhosted.org/packages/d3/74/16336ffd19ed4da28a70959f92f506233bd7cfc2332b20bdb01591e8b1d1/tomli-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:51529d40e3ca50046d7606fa99ce3956a617f9b36380da3b7f0dd3dd28e68cb5", size = 251674 },
+    { url = "https://files.pythonhosted.org/packages/16/f9/229fa3434c590ddf6c0aa9af64d3af4b752540686cace29e6281e3458469/tomli-2.4.1-cp313-cp313-win32.whl", hash = "sha256:2190f2e9dd7508d2a90ded5ed369255980a1bcdd58e52f7fe24b8162bf9fedbd", size = 97976 },
+    { url = "https://files.pythonhosted.org/packages/6a/1e/71dfd96bcc1c775420cb8befe7a9d35f2e5b1309798f009dca17b7708c1e/tomli-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d65a2fbf9d2f8352685bc1364177ee3923d6baf5e7f43ea4959d7d8bc326a36", size = 108755 },
+    { url = "https://files.pythonhosted.org/packages/83/7a/d34f422a021d62420b78f5c538e5b102f62bea616d1d75a13f0a88acb04a/tomli-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:4b605484e43cdc43f0954ddae319fb75f04cc10dd80d830540060ee7cd0243cd", size = 95265 },
+    { url = "https://files.pythonhosted.org/packages/3c/fb/9a5c8d27dbab540869f7c1f8eb0abb3244189ce780ba9cd73f3770662072/tomli-2.4.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fd0409a3653af6c147209d267a0e4243f0ae46b011aa978b1080359fddc9b6cf", size = 155726 },
+    { url = "https://files.pythonhosted.org/packages/62/05/d2f816630cc771ad836af54f5001f47a6f611d2d39535364f148b6a92d6b/tomli-2.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a120733b01c45e9a0c34aeef92bf0cf1d56cfe81ed9d47d562f9ed591a9828ac", size = 149859 },
+    { url = "https://files.pythonhosted.org/packages/ce/48/66341bdb858ad9bd0ceab5a86f90eddab127cf8b046418009f2125630ecb/tomli-2.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:559db847dc486944896521f68d8190be1c9e719fced785720d2216fe7022b662", size = 244713 },
+    { url = "https://files.pythonhosted.org/packages/df/6d/c5fad00d82b3c7a3ab6189bd4b10e60466f22cfe8a08a9394185c8a8111c/tomli-2.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:01f520d4f53ef97964a240a035ec2a869fe1a37dde002b57ebc4417a27ccd853", size = 252084 },
+    { url = "https://files.pythonhosted.org/packages/00/71/3a69e86f3eafe8c7a59d008d245888051005bd657760e96d5fbfb0b740c2/tomli-2.4.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7f94b27a62cfad8496c8d2513e1a222dd446f095fca8987fceef261225538a15", size = 247973 },
+    { url = "https://files.pythonhosted.org/packages/67/50/361e986652847fec4bd5e4a0208752fbe64689c603c7ae5ea7cb16b1c0ca/tomli-2.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede3e6487c5ef5d28634ba3f31f989030ad6af71edfb0055cbbd14189ff240ba", size = 256223 },
+    { url = "https://files.pythonhosted.org/packages/8c/9a/b4173689a9203472e5467217e0154b00e260621caa227b6fa01feab16998/tomli-2.4.1-cp314-cp314-win32.whl", hash = "sha256:3d48a93ee1c9b79c04bb38772ee1b64dcf18ff43085896ea460ca8dec96f35f6", size = 98973 },
+    { url = "https://files.pythonhosted.org/packages/14/58/640ac93bf230cd27d002462c9af0d837779f8773bc03dee06b5835208214/tomli-2.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:88dceee75c2c63af144e456745e10101eb67361050196b0b6af5d717254dddf7", size = 109082 },
+    { url = "https://files.pythonhosted.org/packages/d5/2f/702d5e05b227401c1068f0d386d79a589bb12bf64c3d2c72ce0631e3bc49/tomli-2.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:b8c198f8c1805dc42708689ed6864951fd2494f924149d3e4bce7710f8eb5232", size = 96490 },
+    { url = "https://files.pythonhosted.org/packages/45/4b/b877b05c8ba62927d9865dd980e34a755de541eb65fffba52b4cc495d4d2/tomli-2.4.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:d4d8fe59808a54658fcc0160ecfb1b30f9089906c50b23bcb4c69eddc19ec2b4", size = 164263 },
+    { url = "https://files.pythonhosted.org/packages/24/79/6ab420d37a270b89f7195dec5448f79400d9e9c1826df982f3f8e97b24fd/tomli-2.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7008df2e7655c495dd12d2a4ad038ff878d4ca4b81fccaf82b714e07eae4402c", size = 160736 },
+    { url = "https://files.pythonhosted.org/packages/02/e0/3630057d8eb170310785723ed5adcdfb7d50cb7e6455f85ba8a3deed642b/tomli-2.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d8591993e228b0c930c4bb0db464bdad97b3289fb981255d6c9a41aedc84b2d", size = 270717 },
+    { url = "https://files.pythonhosted.org/packages/7a/b4/1613716072e544d1a7891f548d8f9ec6ce2faf42ca65acae01d76ea06bb0/tomli-2.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:734e20b57ba95624ecf1841e72b53f6e186355e216e5412de414e3c51e5e3c41", size = 278461 },
+    { url = "https://files.pythonhosted.org/packages/05/38/30f541baf6a3f6df77b3df16b01ba319221389e2da59427e221ef417ac0c/tomli-2.4.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8a650c2dbafa08d42e51ba0b62740dae4ecb9338eefa093aa5c78ceb546fcd5c", size = 274855 },
+    { url = "https://files.pythonhosted.org/packages/77/a3/ec9dd4fd2c38e98de34223b995a3b34813e6bdadf86c75314c928350ed14/tomli-2.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:504aa796fe0569bb43171066009ead363de03675276d2d121ac1a4572397870f", size = 283144 },
+    { url = "https://files.pythonhosted.org/packages/ef/be/605a6261cac79fba2ec0c9827e986e00323a1945700969b8ee0b30d85453/tomli-2.4.1-cp314-cp314t-win32.whl", hash = "sha256:b1d22e6e9387bf4739fbe23bfa80e93f6b0373a7f1b96c6227c32bef95a4d7a8", size = 108683 },
+    { url = "https://files.pythonhosted.org/packages/12/64/da524626d3b9cc40c168a13da8335fe1c51be12c0a63685cc6db7308daae/tomli-2.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:2c1c351919aca02858f740c6d33adea0c5deea37f9ecca1cc1ef9e884a619d26", size = 121196 },
+    { url = "https://files.pythonhosted.org/packages/5a/cd/e80b62269fc78fc36c9af5a6b89c835baa8af28ff5ad28c7028d60860320/tomli-2.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:eab21f45c7f66c13f2a9e0e1535309cee140182a9cdae1e041d02e47291e8396", size = 100393 },
+    { url = "https://files.pythonhosted.org/packages/7b/61/cceae43728b7de99d9b847560c262873a1f6c98202171fd5ed62640b494b/tomli-2.4.1-py3-none-any.whl", hash = "sha256:0d85819802132122da43cb86656f8d1f8c6587d54ae7dcaf30e90533028b49fe", size = 14583 },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614 },
+]