backlog.md 0.1.0

package/CLAUDE.md

@@ -0,0 +1,87 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+### Development
+- `bun install` - Install dependencies 
+- `bun test` - Run tests
+- `bun run format` - Format code with Biome
+- `bun run lint` - Lint and auto-fix with Biome  
+- `bun run check` - Run all Biome checks (format + lint)
+
+### Testing
+- `bun test` - Run all tests
+- `bun test <filename>` - Run specific test file
+
+## Project Architecture
+
+This is the **Backlog.md** project - a lightweight git + markdown project management tool for human-AI collaboration.
+
+### Core Structure
+- **CLI Tool**: Built with Bun and TypeScript as a global npm package (`@backlog.md`)
+- **Source Code**: Located in `/src` directory with modular TypeScript structure
+- **Task Management**: Uses markdown files in `.backlog/` directory structure
+- **Workflow**: Git-integrated with task IDs referenced in commits and PRs
+
+### Key Components
+- **Task System**: Tasks stored as `task-<id> - <title>.md` files with decimal subtasks (e.g., `task-4.1`)
+- **Configuration**: Uses `config.yml` for project settings
+- **Status Workflow**: Draft → Active → Archive progression
+
+### AI Agent Integration
+- Reference task IDs in commit messages and PR titles when implementing features
+- Use `.backlog/tasks/` markdown files to understand implementation requirements
+- Include a `## Description` section and a `## Acceptance Criteria` checklist in every task file
+- Write relevant tests when implementing new functionality or fixing bugs
+- Follow decimal numbering for subtasks
+- Maintain clean git status before commits
+- Use task-descriptive branch names: `<task-id> feature description`
+- When you start working on a task, update its status to `In Progress`, assign yourself as the assignee, and push the change.
+- After testing a task, mark it **Done** with:
+
+```bash
+backlog task edit <task-id> --status Done
+```
+
+### Code Standards
+- **Runtime**: Bun with TypeScript 5
+- **Formatting**: Biome with tab indentation and double quotes
+- **Linting**: Biome recommended rules
+- **Testing**: Bun's built-in test runner
+- **Pre-commit**: Husky + lint-staged automatically runs Biome checks before commits
+
+The pre-commit hook automatically runs `biome check --write` on staged files to ensure code quality. If linting errors are found, the commit will be blocked until fixed.
+
+## Definition of Done
+
+A task is **Done** only when **all** of the following hold:
+
+1. **Acceptance criteria** checklist in the task file is fully checked.  
+2. **Automated tests** (unit + integration) cover new logic and CI passes.  
+3. **Static analysis**: linter & formatter succeed (when available).  
+4. **Documentation**:  
+   - Docs updated.  
+   - Task file appended with a `## Implementation Notes` section summarising approach, trade‑offs and follow‑ups.  
+5. **Review**: code reviewed.  
+6. **Task hygiene**: status set to **Done** via CLI.  
+7. **No regressions**: performance, security and licence checks green.
+
+## Backlog.md Tool - CLI usage
+| Purpose | Command |
+|---------|---------|
+| Create task | `backlog task create "Add OAuth"`                    |
+| Create sub task | `backlog task create --parent 14 "Add Google auth"`                    |
+| List tasks  | `backlog task list`                                  |
+| View detail | `backlog task 7`                                     |
+| Edit        | `backlog task edit 7 -a @sara -l auth,backend`       |
+| Archive     | `backlog task archive 7`                             |
+| Draft flow  | `backlog draft create "Spike GraphQL"` → `backlog draft promote 3.1` |
+| Demote to draft| `backlog task demote <id>` |
+
+## Backlog.md Tool - Tips for AI Agents
+- Keep tasks **small, atomic, and testable**; create subtasks liberally.  
+- Prefer **idempotent** changes so reruns remain safe.  
+- Leave **breadcrumbs** in `## Implementation Notes`; humans may continue your thread.  
+- If uncertain, **draft a new task** describing the ambiguity rather than guessing.  

package/CONTRIBUTING.md

@@ -0,0 +1,19 @@
+# Contributing to Backlog.md
+
+Thank you for your interest in contributing to Backlog.md. This project is managed using the Backlog.md workflow and we welcome community involvement.
+
+## Opening Issues
+
+- Search existing issues before creating a new one.
+- Provide a clear description of the problem or proposal.
+- Reference the related task ID when applicable.
+
+## Pull Requests
+
+1. Fork the repository and create a branch named after the task ID and a short description (e.g. `task-27-contributing-guidelines`).
+2. Make your changes and commit them with the task ID in the message.
+3. Run tests with `bun test` and ensure they pass.
+4. Format and lint the code using `npx biome check .`.
+5. Open a pull request referencing the issue or task it addresses.
+
+Please read [AGENTS.md](AGENTS.md) for detailed rules that apply to contributors and AI agents.

package/DEVELOPMENT.md

@@ -0,0 +1,37 @@
+## Local Development
+
+Run these commands to bootstrap the project:
+
+```bash
+bun install
+```
+
+Run tests:
+
+```bash
+bun test
+```
+
+Format and lint:
+
+```bash
+npx biome check .
+```
+
+For contribution guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Release
+
+To publish a new version to npm:
+
+1. Update the `version` field in `package.json`.
+2. Commit the change and create a git tag matching the version, e.g. `v0.1.0`.
+   ```bash
+   git tag v<version>
+   git push origin v<version>
+   ```
+3. Push the tag to trigger the GitHub Actions workflow. It will build, test and
+   publish the package to npm using the repository `NPM_TOKEN` secret.
+
+[← Back to README](README.md)
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Backlog.md
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/biome.json

@@ -0,0 +1,31 @@
+{
+	"$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+	"vcs": {
+		"enabled": false,
+		"clientKind": "git",
+		"useIgnoreFile": false
+	},
+	"files": {
+		"ignoreUnknown": false,
+		"ignore": ["cli/"]
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab",
+		"lineWidth": 120
+	},
+	"organizeImports": {
+		"enabled": true
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double"
+		}
+	}
+}

package/bun.lock

@@ -0,0 +1,152 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "dependencies": {
+        "blessed": "0.1.81",
+        "commander": "14.0.0",
+        "gray-matter": "4.0.3",
+      },
+      "devDependencies": {
+        "@biomejs/biome": "1.9.4",
+        "@types/bun": "1.2.15",
+        "husky": "9.1.7",
+        "lint-staged": "16.1.0",
+      },
+    },
+  },
+  "trustedDependencies": [
+    "@biomejs/biome",
+  ],
+  "packages": {
+    "@biomejs/biome": ["@biomejs/biome@1.9.4", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "1.9.4", "@biomejs/cli-darwin-x64": "1.9.4", "@biomejs/cli-linux-arm64": "1.9.4", "@biomejs/cli-linux-arm64-musl": "1.9.4", "@biomejs/cli-linux-x64": "1.9.4", "@biomejs/cli-linux-x64-musl": "1.9.4", "@biomejs/cli-win32-arm64": "1.9.4", "@biomejs/cli-win32-x64": "1.9.4" }, "bin": { "biome": "bin/biome" } }, "sha512-1rkd7G70+o9KkTn5KLmDYXihGoTaIGO9PIIN2ZB7UJxFrWw04CZHPYiMRjYsaDvVV7hP1dYNRLxSANLaBFGpog=="],
+
+    "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@1.9.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-bFBsPWrNvkdKrNCYeAp+xo2HecOGPAy9WyNyB/jKnnedgzl4W4Hb9ZMzYNbf8dMCGmUdSavlYHiR01QaYR58cw=="],
+
+    "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@1.9.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-ngYBh/+bEedqkSevPVhLP4QfVPCpb+4BBe2p7Xs32dBgs7rh9nY2AIYUL6BgLw1JVXV8GlpKmb/hNiuIxfPfZg=="],
+
+    "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@1.9.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-fJIW0+LYujdjUgJJuwesP4EjIBl/N/TcOX3IvIHJQNsAqvV2CHIogsmA94BPG6jZATS4Hi+xv4SkBBQSt1N4/g=="],
+
+    "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@1.9.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-v665Ct9WCRjGa8+kTr0CzApU0+XXtRgwmzIf1SeKSGAv+2scAlW6JR5PMFo6FzqqZ64Po79cKODKf3/AAmECqA=="],
+
+    "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@1.9.4", "", { "os": "linux", "cpu": "x64" }, "sha512-lRCJv/Vi3Vlwmbd6K+oQ0KhLHMAysN8lXoCI7XeHlxaajk06u7G+UsFSO01NAs5iYuWKmVZjmiOzJ0OJmGsMwg=="],
+
+    "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@1.9.4", "", { "os": "linux", "cpu": "x64" }, "sha512-gEhi/jSBhZ2m6wjV530Yy8+fNqG8PAinM3oV7CyO+6c3CEh16Eizm21uHVsyVBEB6RIM8JHIl6AGYCv6Q6Q9Tg=="],
+
+    "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@1.9.4", "", { "os": "win32", "cpu": "arm64" }, "sha512-tlbhLk+WXZmgwoIKwHIHEBZUwxml7bRJgk0X2sPyNR3S93cdRq6XulAZRQJ17FYGGzWne0fgrXBKpl7l4M87Hg=="],
+
+    "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@1.9.4", "", { "os": "win32", "cpu": "x64" }, "sha512-8Y5wMhVIPaWe6jw2H+KlEm4wP/f7EW3810ZLmDlrEEy5KvBsb9ECEfu/kMWD484ijfQ8+nIi0giMgu9g1UAuuA=="],
+
+    "@types/bun": ["@types/bun@1.2.15", "", { "dependencies": { "bun-types": "1.2.15" } }, "sha512-U1ljPdBEphF0nw1MIk0hI7kPg7dFdPyM7EenHsp6W5loNHl7zqy6JQf/RKCgnUn2KDzUpkBwHPnEJEjII594bA=="],
+
+    "@types/node": ["@types/node@22.15.30", "", { "dependencies": { "undici-types": "~6.21.0" } }, "sha512-6Q7lr06bEHdlfplU6YRbgG1SFBdlsfNC4/lX+SkhiTs0cpJkOElmWls8PxDFv4yY/xKb8Y6SO0OmSX4wgqTZbA=="],
+
+    "ansi-escapes": ["ansi-escapes@7.0.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-GdYO7a61mR0fOlAsvC9/rIHf7L96sBc6dEWzeOu+KAea5bZyQRPIpojrVoI4AXGJS/ycu/fBTdLrUkA4ODrvjw=="],
+
+    "ansi-regex": ["ansi-regex@6.1.0", "", {}, "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA=="],
+
+    "ansi-styles": ["ansi-styles@6.2.1", "", {}, "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug=="],
+
+    "argparse": ["argparse@1.0.10", "", { "dependencies": { "sprintf-js": "~1.0.2" } }, "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg=="],
+
+    "blessed": ["blessed@0.1.81", "", { "bin": { "blessed": "./bin/tput.js" } }, "sha512-LoF5gae+hlmfORcG1M5+5XZi4LBmvlXTzwJWzUlPryN/SJdSflZvROM2TwkT0GMpq7oqT48NRd4GS7BiVBc5OQ=="],
+
+    "braces": ["braces@3.0.3", "", { "dependencies": { "fill-range": "^7.1.1" } }, "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA=="],
+
+    "bun-types": ["bun-types@1.2.15", "", { "dependencies": { "@types/node": "*" } }, "sha512-NarRIaS+iOaQU1JPfyKhZm4AsUOrwUOqRNHY0XxI8GI8jYxiLXLcdjYMG9UKS+fwWasc1uw1htV9AX24dD+p4w=="],
+
+    "chalk": ["chalk@5.4.1", "", {}, "sha512-zgVZuo2WcZgfUEmsn6eO3kINexW8RAE4maiQ8QNs8CtpPCSyMiYsULR3HQYkm3w8FIA3SberyMJMSldGsW+U3w=="],
+
+    "cli-cursor": ["cli-cursor@5.0.0", "", { "dependencies": { "restore-cursor": "^5.0.0" } }, "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw=="],
+
+    "cli-truncate": ["cli-truncate@4.0.0", "", { "dependencies": { "slice-ansi": "^5.0.0", "string-width": "^7.0.0" } }, "sha512-nPdaFdQ0h/GEigbPClz11D0v/ZJEwxmeVZGeMo3Z5StPtUTkA9o1lD6QwoirYiSDzbcwn2XcjwmCp68W1IS4TA=="],
+
+    "colorette": ["colorette@2.0.20", "", {}, "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w=="],
+
+    "commander": ["commander@14.0.0", "", {}, "sha512-2uM9rYjPvyq39NwLRqaiLtWHyDC1FvryJDa2ATTVims5YAS4PupsEQsDvP14FqhFr0P49CYDugi59xaxJlTXRA=="],
+
+    "debug": ["debug@4.4.1", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-KcKCqiftBJcZr++7ykoDIEwSa3XWowTfNPo92BYxjXiyYEVrUQh2aLyhxBCwww+heortUFxEJYcRzosstTEBYQ=="],
+
+    "emoji-regex": ["emoji-regex@10.4.0", "", {}, "sha512-EC+0oUMY1Rqm4O6LLrgjtYDvcVYTy7chDnM4Q7030tP4Kwj3u/pR6gP9ygnp2CJMK5Gq+9Q2oqmrFJAz01DXjw=="],
+
+    "environment": ["environment@1.1.0", "", {}, "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q=="],
+
+    "esprima": ["esprima@4.0.1", "", { "bin": { "esparse": "./bin/esparse.js", "esvalidate": "./bin/esvalidate.js" } }, "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A=="],
+
+    "eventemitter3": ["eventemitter3@5.0.1", "", {}, "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA=="],
+
+    "extend-shallow": ["extend-shallow@2.0.1", "", { "dependencies": { "is-extendable": "^0.1.0" } }, "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug=="],
+
+    "fill-range": ["fill-range@7.1.1", "", { "dependencies": { "to-regex-range": "^5.0.1" } }, "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg=="],
+
+    "get-east-asian-width": ["get-east-asian-width@1.3.0", "", {}, "sha512-vpeMIQKxczTD/0s2CdEWHcb0eeJe6TFjxb+J5xgX7hScxqrGuyjmv4c1D4A/gelKfyox0gJJwIHF+fLjeaM8kQ=="],
+
+    "gray-matter": ["gray-matter@4.0.3", "", { "dependencies": { "js-yaml": "^3.13.1", "kind-of": "^6.0.2", "section-matter": "^1.0.0", "strip-bom-string": "^1.0.0" } }, "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q=="],
+
+    "husky": ["husky@9.1.7", "", { "bin": { "husky": "bin.js" } }, "sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA=="],
+
+    "is-extendable": ["is-extendable@0.1.1", "", {}, "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw=="],
+
+    "is-fullwidth-code-point": ["is-fullwidth-code-point@4.0.0", "", {}, "sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ=="],
+
+    "is-number": ["is-number@7.0.0", "", {}, "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng=="],
+
+    "js-yaml": ["js-yaml@3.14.1", "", { "dependencies": { "argparse": "^1.0.7", "esprima": "^4.0.0" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g=="],
+
+    "kind-of": ["kind-of@6.0.3", "", {}, "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw=="],
+
+    "lilconfig": ["lilconfig@3.1.3", "", {}, "sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw=="],
+
+    "lint-staged": ["lint-staged@16.1.0", "", { "dependencies": { "chalk": "^5.4.1", "commander": "^14.0.0", "debug": "^4.4.1", "lilconfig": "^3.1.3", "listr2": "^8.3.3", "micromatch": "^4.0.8", "nano-spawn": "^1.0.2", "pidtree": "^0.6.0", "string-argv": "^0.3.2", "yaml": "^2.8.0" }, "bin": { "lint-staged": "bin/lint-staged.js" } }, "sha512-HkpQh69XHxgCjObjejBT3s2ILwNjFx8M3nw+tJ/ssBauDlIpkx2RpqWSi1fBgkXLSSXnbR3iEq1NkVtpvV+FLQ=="],
+
+    "listr2": ["listr2@8.3.3", "", { "dependencies": { "cli-truncate": "^4.0.0", "colorette": "^2.0.20", "eventemitter3": "^5.0.1", "log-update": "^6.1.0", "rfdc": "^1.4.1", "wrap-ansi": "^9.0.0" } }, "sha512-LWzX2KsqcB1wqQ4AHgYb4RsDXauQiqhjLk+6hjbaeHG4zpjjVAB6wC/gz6X0l+Du1cN3pUB5ZlrvTbhGSNnUQQ=="],
+
+    "log-update": ["log-update@6.1.0", "", { "dependencies": { "ansi-escapes": "^7.0.0", "cli-cursor": "^5.0.0", "slice-ansi": "^7.1.0", "strip-ansi": "^7.1.0", "wrap-ansi": "^9.0.0" } }, "sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w=="],
+
+    "micromatch": ["micromatch@4.0.8", "", { "dependencies": { "braces": "^3.0.3", "picomatch": "^2.3.1" } }, "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA=="],
+
+    "mimic-function": ["mimic-function@5.0.1", "", {}, "sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA=="],
+
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "nano-spawn": ["nano-spawn@1.0.2", "", {}, "sha512-21t+ozMQDAL/UGgQVBbZ/xXvNO10++ZPuTmKRO8k9V3AClVRht49ahtDjfY8l1q6nSHOrE5ASfthzH3ol6R/hg=="],
+
+    "onetime": ["onetime@7.0.0", "", { "dependencies": { "mimic-function": "^5.0.0" } }, "sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ=="],
+
+    "picomatch": ["picomatch@2.3.1", "", {}, "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA=="],
+
+    "pidtree": ["pidtree@0.6.0", "", { "bin": { "pidtree": "bin/pidtree.js" } }, "sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g=="],
+
+    "restore-cursor": ["restore-cursor@5.1.0", "", { "dependencies": { "onetime": "^7.0.0", "signal-exit": "^4.1.0" } }, "sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA=="],
+
+    "rfdc": ["rfdc@1.4.1", "", {}, "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA=="],
+
+    "section-matter": ["section-matter@1.0.0", "", { "dependencies": { "extend-shallow": "^2.0.1", "kind-of": "^6.0.0" } }, "sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA=="],
+
+    "signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
+
+    "slice-ansi": ["slice-ansi@5.0.0", "", { "dependencies": { "ansi-styles": "^6.0.0", "is-fullwidth-code-point": "^4.0.0" } }, "sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ=="],
+
+    "sprintf-js": ["sprintf-js@1.0.3", "", {}, "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g=="],
+
+    "string-argv": ["string-argv@0.3.2", "", {}, "sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q=="],
+
+    "string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
+
+    "strip-ansi": ["strip-ansi@7.1.0", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ=="],
+
+    "strip-bom-string": ["strip-bom-string@1.0.0", "", {}, "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g=="],
+
+    "to-regex-range": ["to-regex-range@5.0.1", "", { "dependencies": { "is-number": "^7.0.0" } }, "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ=="],
+
+    "undici-types": ["undici-types@6.21.0", "", {}, "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="],
+
+    "wrap-ansi": ["wrap-ansi@9.0.0", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-G8ura3S+3Z2G+mkgNRq8dqaFZAuxfsxpBB8OCTGRTCtp+l/v9nbFNmCUP1BZMts3G1142MsZfn6eeUKrr4PD1Q=="],
+
+    "yaml": ["yaml@2.8.0", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-4lLa/EcQCB0cJkyts+FpIRx5G/llPxfP6VQU5KByHEhLxY3IJCH0f0Hy1MHI8sClTvsIb8qwRJ6R/ZdlDJ/leQ=="],
+
+    "log-update/slice-ansi": ["slice-ansi@7.1.0", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-bSiSngZ/jWeX93BqeIAbImyTbEihizcwNjFoRUIY/T1wWQsfsm2Vw1agPKylXvQTU7iASGdHhyqRlqQzfz+Htg=="],
+
+    "log-update/slice-ansi/is-fullwidth-code-point": ["is-fullwidth-code-point@5.0.0", "", { "dependencies": { "get-east-asian-width": "^1.0.0" } }, "sha512-OVa3u9kkBbw7b8Xw5F9P+D/T9X+Z4+JruYVNapTjPYZYUznQ5YfWeFkOj606XYYW8yugTfC8Pj0hYqvi4ryAhA=="],
+  }
+}

package/cli/.cursorrules-xh86jabm.md

@@ -0,0 +1,82 @@
+# AI Agent Guidelines
+
+*How to collaborate on Backlog.md–driven projects*
+
+---
+
+## 1. Source of Truth
+- Tasks live under **`.backlog/tasks/`** (drafts under **`.backlog/drafts/`**).
+- Every implementation decision starts with reading the corresponding Markdown task file.
+
+## 2. Typical Workflow
+
+```bash
+# 1 Identify work
+backlog task list --status "To Do"
+
+# 2 Read details
+backlog task view 42
+
+# 3 Start work: assign yourself & move column
+backlog task edit 42 -a @ai-bot -s "In Progress"
+
+# 4 Break work down if needed
+backlog task create "Refactor DB layer" --parent 42 -a @ai-bot
+
+# 5 Complete and mark Done
+backlog task edit 42 -s Done
+```
+
+## 3. Definition of Done (DOD)
+
+A task is **Done** only when **all** of the following hold:
+
+1. **Acceptance criteria** checklist in the task file is fully checked.  
+2. **Automated tests** (unit + integration) cover new logic and CI passes.  
+3. **Static analysis**: linter & formatter succeed (when available).  
+4. **Documentation**:  
+   - Docs updated.  
+   - Task file appended with a `## Implementation Notes` section summarising approach, trade‑offs and follow‑ups.  
+5. **Review**: code reviewed.  
+6. **Task hygiene**: status set to **Done** via CLI.  
+7. **No regressions**: performance, security and licence checks green.
+
+## 4. Recommended Task Anatomy
+
+```markdown
+# task‑42 - Add GraphQL resolver
+
+## Description
+Short, imperative explanation of the work.
+
+## Acceptance Criteria
+- [ ] Resolver returns correct data for happy path
+- [ ] Error response matches REST
+- [ ] P95 latency ≤ 50 ms under 100 RPS
+
+## Implementation Notes (only added after working on the task)
+*Created by @ai-bot on 2025‑06‑13*
+
+- Added `src/graphql/resolvers/user.ts`
+- Considered DataLoader but deferred
+- Follow‑up: integrate cache layer
+```
+
+## 5. Handy CLI Commands
+
+| Purpose | Command |
+|---------|---------|
+| Create task | `backlog task create "Add OAuth"`                    |
+| Create sub task | `backlog task create --parent 14 "Add Google auth"`                    |
+| List tasks  | `backlog task list`                                  |
+| View detail | `backlog task 7`                                     |
+| Edit        | `backlog task edit 7 -a @sara -l auth,backend`       |
+| Archive     | `backlog task archive 7`                             |
+| Draft flow  | `backlog draft create "Spike GraphQL"` → `backlog draft promote 3.1` |
+| Demote to draft| `backlog task demote <id>` |
+
+## 6. Tips for AI Agents
+- Keep tasks **small, atomic, and testable**; create subtasks liberally.  
+- Prefer **idempotent** changes so reruns remain safe.  
+- Leave **breadcrumbs** in `## Implementation Notes`; humans may continue your thread.  
+- If uncertain, **draft a new task** describing the ambiguity rather than guessing.  

package/cli/AGENTS-xh86jabm.md

@@ -0,0 +1,82 @@
+# AI Agent Guidelines
+
+*How to collaborate on Backlog.md–driven projects*
+
+---
+
+## 1. Source of Truth
+- Tasks live under **`.backlog/tasks/`** (drafts under **`.backlog/drafts/`**).
+- Every implementation decision starts with reading the corresponding Markdown task file.
+
+## 2. Typical Workflow
+
+```bash
+# 1 Identify work
+backlog task list --status "To Do"
+
+# 2 Read details
+backlog task view 42
+
+# 3 Start work: assign yourself & move column
+backlog task edit 42 -a @ai-bot -s "In Progress"
+
+# 4 Break work down if needed
+backlog task create "Refactor DB layer" --parent 42 -a @ai-bot
+
+# 5 Complete and mark Done
+backlog task edit 42 -s Done
+```
+
+## 3. Definition of Done (DOD)
+
+A task is **Done** only when **all** of the following hold:
+
+1. **Acceptance criteria** checklist in the task file is fully checked.  
+2. **Automated tests** (unit + integration) cover new logic and CI passes.  
+3. **Static analysis**: linter & formatter succeed (when available).  
+4. **Documentation**:  
+   - Docs updated.  
+   - Task file appended with a `## Implementation Notes` section summarising approach, trade‑offs and follow‑ups.  
+5. **Review**: code reviewed.  
+6. **Task hygiene**: status set to **Done** via CLI.  
+7. **No regressions**: performance, security and licence checks green.
+
+## 4. Recommended Task Anatomy
+
+```markdown
+# task‑42 - Add GraphQL resolver
+
+## Description
+Short, imperative explanation of the work.
+
+## Acceptance Criteria
+- [ ] Resolver returns correct data for happy path
+- [ ] Error response matches REST
+- [ ] P95 latency ≤ 50 ms under 100 RPS
+
+## Implementation Notes (only added after working on the task)
+*Created by @ai-bot on 2025‑06‑13*
+
+- Added `src/graphql/resolvers/user.ts`
+- Considered DataLoader but deferred
+- Follow‑up: integrate cache layer
+```
+
+## 5. Handy CLI Commands
+
+| Purpose | Command |
+|---------|---------|
+| Create task | `backlog task create "Add OAuth"`                    |
+| Create sub task | `backlog task create --parent 14 "Add Google auth"`                    |
+| List tasks  | `backlog task list`                                  |
+| View detail | `backlog task 7`                                     |
+| Edit        | `backlog task edit 7 -a @sara -l auth,backend`       |
+| Archive     | `backlog task archive 7`                             |
+| Draft flow  | `backlog draft create "Spike GraphQL"` → `backlog draft promote 3.1` |
+| Demote to draft| `backlog task demote <id>` |
+
+## 6. Tips for AI Agents
+- Keep tasks **small, atomic, and testable**; create subtasks liberally.  
+- Prefer **idempotent** changes so reruns remain safe.  
+- Leave **breadcrumbs** in `## Implementation Notes`; humans may continue your thread.  
+- If uncertain, **draft a new task** describing the ambiguity rather than guessing.  

package/cli/CLAUDE-xh86jabm.md

@@ -0,0 +1,82 @@
+# AI Agent Guidelines
+
+*How to collaborate on Backlog.md–driven projects*
+
+---
+
+## 1. Source of Truth
+- Tasks live under **`.backlog/tasks/`** (drafts under **`.backlog/drafts/`**).
+- Every implementation decision starts with reading the corresponding Markdown task file.
+
+## 2. Typical Workflow
+
+```bash
+# 1 Identify work
+backlog task list --status "To Do"
+
+# 2 Read details
+backlog task view 42
+
+# 3 Start work: assign yourself & move column
+backlog task edit 42 -a @ai-bot -s "In Progress"
+
+# 4 Break work down if needed
+backlog task create "Refactor DB layer" --parent 42 -a @ai-bot
+
+# 5 Complete and mark Done
+backlog task edit 42 -s Done
+```
+
+## 3. Definition of Done (DOD)
+
+A task is **Done** only when **all** of the following hold:
+
+1. **Acceptance criteria** checklist in the task file is fully checked.  
+2. **Automated tests** (unit + integration) cover new logic and CI passes.  
+3. **Static analysis**: linter & formatter succeed (when available).  
+4. **Documentation**:  
+   - Docs updated.  
+   - Task file appended with a `## Implementation Notes` section summarising approach, trade‑offs and follow‑ups.  
+5. **Review**: code reviewed.  
+6. **Task hygiene**: status set to **Done** via CLI.  
+7. **No regressions**: performance, security and licence checks green.
+
+## 4. Recommended Task Anatomy
+
+```markdown
+# task‑42 - Add GraphQL resolver
+
+## Description
+Short, imperative explanation of the work.
+
+## Acceptance Criteria
+- [ ] Resolver returns correct data for happy path
+- [ ] Error response matches REST
+- [ ] P95 latency ≤ 50 ms under 100 RPS
+
+## Implementation Notes (only added after working on the task)
+*Created by @ai-bot on 2025‑06‑13*
+
+- Added `src/graphql/resolvers/user.ts`
+- Considered DataLoader but deferred
+- Follow‑up: integrate cache layer
+```
+
+## 5. Handy CLI Commands
+
+| Purpose | Command |
+|---------|---------|
+| Create task | `backlog task create "Add OAuth"`                    |
+| Create sub task | `backlog task create --parent 14 "Add Google auth"`                    |
+| List tasks  | `backlog task list`                                  |
+| View detail | `backlog task 7`                                     |
+| Edit        | `backlog task edit 7 -a @sara -l auth,backend`       |
+| Archive     | `backlog task archive 7`                             |
+| Draft flow  | `backlog draft create "Spike GraphQL"` → `backlog draft promote 3.1` |
+| Demote to draft| `backlog task demote <id>` |
+
+## 6. Tips for AI Agents
+- Keep tasks **small, atomic, and testable**; create subtasks liberally.  
+- Prefer **idempotent** changes so reruns remain safe.  
+- Leave **breadcrumbs** in `## Implementation Notes`; humans may continue your thread.  
+- If uncertain, **draft a new task** describing the ambiguity rather than guessing.