@danalexilewis/taskgraph 0.1.0

package/dist/template/docs/skills/plan-authoring.md

@@ -0,0 +1,38 @@
+# plan-authoring
+
+Use this guide when writing plans in Cursor format for import into TaskGraph.
+
+## File location
+
+- Store plans in `plans/` as `plans/<name>.md`
+
+## Minimal Cursor-format frontmatter
+
+```yaml
+---
+name: My Plan
+overview: "What this plan accomplishes."
+todos:
+  - id: stable-key
+    content: "A small task"
+    status: pending
+  - id: depends-on-first
+    content: "Another small task"
+    blockedBy: [stable-key]
+---
+```
+
+## Optional task dimensions
+
+- `domain`: string or array of strings → `docs/<domain>.md`
+- `skill`: string or array of strings → `docs/skills/<skill>.md`
+- `changeType`: one of `create`, `modify`, `refactor`, `fix`, `investigate`, `test`, `document`
+
+Pick dimensions that help an agent load the right conventions and choose the right approach.
+
+## Import command
+
+```bash
+tg import plans/<file> --plan "<Plan Name>" --format cursor
+```
+

package/dist/template/docs/skills/refactoring-safely.md

@@ -0,0 +1,21 @@
+# refactoring-safely
+
+Use this guide when the goal is **behavior-preserving change** (rename, reorganize, simplify, extract, delete dead code) while keeping externally-visible behavior stable.
+
+## Principles
+
+- Make the smallest change that moves you forward.
+- Prefer mechanical edits (rename, move, extract) over semantic changes.
+- Keep diffs reviewable: one intent per commit/PR section.
+
+## Workflow
+
+1. Identify the behavior you need to preserve.
+2. Add/confirm tests (or a quick script) that will fail if behavior changes.
+3. Refactor in small steps; run the tests after each meaningful step.
+4. Only then do follow-up cleanup (formatting, dead code removal).
+
+## When to stop and split
+
+If the refactor reveals unrelated issues (bugs, missing coverage, design changes), split into new tasks so the original task stays predictable.
+

package/dist/template/docs/skills/taskgraph-lifecycle-execution.md

@@ -0,0 +1,23 @@
+# taskgraph-lifecycle-execution
+
+Use this guide when you are executing tasks in a TaskGraph-backed repo and want to avoid status drift and missing context.
+
+## Standard loop (per task)
+
+1. `tg start <taskId>`
+2. `tg context <taskId>` (read the printed docs and any related done tasks)
+3. Make the change (stay within task scope)
+4. `tg done <taskId> --evidence "tests run, commands, commit hashes"`
+
+If your repo doesn’t have `tg` on PATH, you might use `pnpm tg ...` or `npx tg ...` depending on how you installed the CLI.
+
+## Recovery
+
+- If work is done but the task is still `todo`: `tg done <taskId> --force --evidence "completed previously"`
+- If a task is stuck in `doing`: `tg done <taskId> --evidence "completed previously"`
+
+## When blocked
+
+- `tg block <taskId> --on <blockerId> --reason "..."` (block on an existing task)
+- If the blocker doesn’t exist: create a new task (owner=human) and block on it.
+

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@danalexilewis/taskgraph",
+  "version": "0.1.0",
+  "description": "Task Graph CLI for Centaur Development",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "tg": "dist/cli/index.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "tg": "node dist/cli/index.js",
+    "dev": "tsx src/cli/index.ts",
+    "build": "tsc && node -e \"require('fs').cpSync('src/template','dist/template',{recursive:true})\"",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/cli/index.js",
+    "test": "vitest run --dir __tests__",
+    "test:e2e": "vitest run --dir __tests__/e2e",
+    "test:integration": "vitest run --dir __tests__/integration"
+  },
+  "keywords": ["cli", "tasks", "plans", "dolt", "cursor", "centaur", "taskgraph", "agent-workflow"],
+  "author": "danalexilewis",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danalexilewis/taskgraph"
+  },
+  "homepage": "https://github.com/danalexilewis/taskgraph",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "execa": "^9.0.0",
+    "js-yaml": "^4.1.1",
+    "neverthrow": "^6.0.0",
+    "uuid": "^9.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.17",
+    "@types/uuid": "^9.0.8",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.0.0"
+  }
+}