@benzotti/jedi 0.1.0

package/framework/templates/STATE.md

@@ -0,0 +1,137 @@
+# Project State
+
+> Living memory for {Project Name}
+
+---
+
+<section name="Position">
+
+## Current Position
+
+**Phase:** {X} of {Y} ({phase name})
+**Plan:** {A} of {B} ({plan name})
+**Status:** {Idle | Planning | Executing | Verifying | Complete | Blocked}
+**Last activity:** {date} - {what happened}
+
+**Progress:**
+```
+[████████████░░░░░░░░] 60%
+```
+
+</section>
+
+---
+
+<section name="Continuity">
+
+## Session Continuity
+
+**Last session:** {date and time}
+**Stopped at:** {where work stopped}
+**Resume file:** {path to plan index file or "None"}
+
+**To continue:**
+1. {Next step}
+2. {Following step}
+
+## Brief Alignment
+
+{2-3 sentences about current project state. What's done? What's next? Any blockers?}
+
+</section>
+
+---
+
+<section name="Decisions">
+
+## Decisions
+
+| Date | Phase | Decision | Rationale |
+|------|-------|----------|-----------|
+| {date} | {X} | {decision} | {why} |
+
+</section>
+
+---
+
+<section name="Blockers">
+
+## Blockers
+
+### Active
+
+- [ ] **{Type}**: {description}
+  - Impact: {what's blocked}
+  - Added: {date}
+
+### Resolved
+
+- [x] **{Type}**: {description}
+  - Resolved: {date} - {how}
+
+</section>
+
+---
+
+<section name="Progress">
+
+## Phase Progress
+
+### Phase 1: {name}
+
+| Plan | Name | Status | SUMMARY |
+|------|------|--------|---------|
+| 01 | {name} | Complete | ✓ |
+| 02 | {name} | In Progress | — |
+| 03 | {name} | Pending | — |
+
+### Phase 2: {name}
+
+| Plan | Name | Status | SUMMARY |
+|------|------|--------|---------|
+| 01 | {name} | Pending | — |
+
+</section>
+
+---
+
+<section name="Context">
+
+## Accumulated Context
+
+### Key Files
+
+| File | Purpose |
+|------|---------|
+| {path} | {what it does} |
+
+### Patterns Established
+
+- {Pattern 1}: {description}
+- {Pattern 2}: {description}
+
+### Things to Watch
+
+- {Item 1}
+- {Item 2}
+
+## Metrics
+
+| Metric | Value |
+|--------|-------|
+| Plans completed | {X} / {Y} |
+| Tasks completed | {A} / {B} |
+| Commits | {count} |
+| Deviations | {count} |
+
+## Session Log
+
+| Date | Duration | Activity | Outcome |
+|------|----------|----------|---------|
+| {date} | {time} | {what was done} | {result} |
+
+</section>
+
+---
+
+*Auto-updated during execution*

package/framework/templates/SUMMARY.md

@@ -0,0 +1,201 @@
+<section name="Frontmatter">
+
+---
+phase: {X}
+plan: {YY}
+name: {Plan Name}
+completed_at: {ISO timestamp}
+duration: {time in minutes}
+
+# Dependency Graph (copied from PLAN.md, updated with actuals)
+requires:
+  - phase: {N}
+    provides: [dependency1, dependency2]
+provides: [deliverable1, deliverable2]
+affects: [{future-phase-1}, {future-phase-2}]
+
+# Semantic Indexing
+subsystem: {auth|api|ui|data|infra|docs|test}
+tags: [tag1, tag2, tag3]
+
+# Execution Stats
+tasks_completed: {n}
+tasks_total: {n}
+deviations: {n}
+commits: {n}
+---
+
+# Phase {X} Plan {YY}: {Plan Name} - Summary
+
+## One-Liner
+
+{Single sentence describing what was accomplished}
+
+</section>
+
+---
+
+<section name="TasksCompleted">
+
+## Tasks Completed
+
+| # | Task | Commit | Files | Duration |
+|---|------|--------|-------|----------|
+| 1 | {Task 1 name} | `{hash}` | {n} files | {time} |
+| 2 | {Task 2 name} | `{hash}` | {n} files | {time} |
+| 3 | {Task 3 name} | `{hash}` | {n} files | {time} |
+
+### Commits Detail
+
+```
+{hash1} {type}({scope}): {message}
+{hash2} {type}({scope}): {message}
+{hash3} {type}({scope}): {message}
+```
+
+</section>
+
+---
+
+<section name="Deviations">
+
+## Deviations from Plan
+
+{If no deviations: "None - plan executed as written."}
+
+### Auto-Fixed Issues
+
+**1. [Rule {N}] {Title}**
+- **Found during:** Task {X}
+- **Issue:** {Description of what was wrong}
+- **Fix:** {What was done to fix it}
+- **Commit:** `{hash}`
+- **Files affected:** {list}
+
+### User Decisions (Rule 4 Stops)
+
+{If any Rule 4 stops occurred}
+
+**1. {Decision Title}**
+- **Question posed:** {What was asked}
+- **User decision:** {What was decided}
+- **Rationale:** {Why}
+- **Implementation:** {How it was implemented}
+
+## Decisions Made
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+| {What was decided} | {The choice} | {Why} |
+
+</section>
+
+---
+
+<section name="KeyFiles">
+
+## Key Files
+
+### Created
+
+| File | Purpose |
+|------|---------|
+| `{path/to/new/file.ts}` | {What it does} |
+
+### Modified
+
+| File | Changes |
+|------|---------|
+| `{path/to/existing/file.ts}` | {What changed} |
+
+## Dependencies
+
+### Consumed (from requires)
+
+| Source | What Was Used |
+|--------|---------------|
+| Phase {N} | {dependency used} |
+
+### Provided (for affects)
+
+| Deliverable | Description |
+|-------------|-------------|
+| {deliverable1} | {What it enables} |
+
+</section>
+
+---
+
+<section name="Verification">
+
+## Verification Results
+
+| Check | Status | Notes |
+|-------|--------|-------|
+| All tasks completed | {PASS/FAIL} | |
+| No uncommitted changes | {PASS/FAIL} | |
+| Lint passes | {PASS/FAIL} | {n} warnings |
+| Types check | {PASS/FAIL} | |
+| Tests pass | {PASS/FAIL} | {n}/{m} passed |
+
+## Checkpoints Encountered
+
+{If no checkpoints: "None - fully autonomous execution."}
+
+| Checkpoint | Type | Outcome |
+|------------|------|---------|
+| Task {N} | human-verify | Approved |
+| Task {N} | decision | Chose option {X} |
+
+</section>
+
+---
+
+<section name="Metrics">
+
+## Metrics
+
+| Metric | Value |
+|--------|-------|
+| Total duration | {time} |
+| Tasks completed | {n}/{n} |
+| Commits created | {n} |
+| Files created | {n} |
+| Files modified | {n} |
+| Deviations handled | {n} |
+| Checkpoints passed | {n} |
+
+</section>
+
+---
+
+<section name="NextContext">
+
+## Context for Next Plans
+
+{Key information that downstream plans should know}
+
+### What's Now Available
+- {Capability or component now exists}
+- {API or function now available}
+
+### Patterns Established
+- {Pattern used that should be followed}
+- {Convention established}
+
+### Warnings for Future Work
+- {Gotcha to be aware of}
+- {Limitation to know about}
+
+## Next Phase Readiness
+
+This plan provides: `{provides list}`
+
+Phases that can now proceed:
+- Phase {N}: {name} (was waiting for {dependency})
+
+</section>
+
+---
+
+*Generated by jdi-executor at {timestamp}*

package/framework/workflows/README.md

@@ -0,0 +1,87 @@
+# JDI Workflows
+
+Quick-reference for common development workflows using JDI commands.
+
+---
+
+## Feature Workflow
+
+End-to-end: requirements to merged PR.
+
+```
+Discovery → Planning → Execution → Review
+```
+
+1. `/jdi:create-plan "feature description"` — researches codebase, creates PLAN.md
+2. Review and refine the generated plan
+3. `/jdi:implement-plan .jdi/plans/{phase}-{plan}-{slug}.plan.md` — executes with atomic commits
+4. `/jdi:generate-pr` — creates PR with description from SUMMARY.md
+5. `/jdi:pr-review` — self-review before requesting human review
+6. `/jdi:pr-feedback` — address review comments
+
+**Quick variant:** For small changes, use `/jdi:quick "description"` instead of steps 1-3.
+
+---
+
+## Bugfix Workflow
+
+Investigate, fix, and verify bugs.
+
+```
+Reproduce → Investigate → Fix → Verify
+```
+
+1. Reproduce the bug and confirm the issue
+2. `/jdi:create-plan "fix: description of bug"` — creates targeted fix plan
+3. `/jdi:implement-plan` — implements the fix with tests
+4. `/jdi:generate-pr` — creates PR
+5. `/jdi:pr-review` — verify fix addresses root cause
+
+**Quick variant:** For obvious fixes, use `/jdi:quick "fix: description"`.
+
+---
+
+## PR Workflow
+
+Pull request lifecycle from creation to merge.
+
+```
+Create → Review → Feedback → Merge
+```
+
+1. `/jdi:generate-pr` — creates PR with comprehensive description
+2. `/jdi:pr-review` — self-review, posts line comments to GitHub
+3. Wait for human review
+4. `/jdi:pr-feedback` — address all review comments, post replies
+5. Repeat steps 3-4 until approved
+6. Merge via GitHub
+
+---
+
+## Discovery Workflow
+
+Research and analysis before implementation.
+
+```
+Scope → Research → Analyse → Document
+```
+
+1. Define what needs to be understood (scope the research)
+2. `/jdi:create-plan --depth deep "research: topic"` — generates research tasks
+3. Review research outputs in `.jdi/research/`
+4. Use findings to inform feature planning
+
+---
+
+## Command Quick Reference
+
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| `/jdi:quick` | Small focused change | Single file, <50 lines, obvious fix |
+| `/jdi:create-plan` | Create implementation plan | New features, complex changes |
+| `/jdi:implement-plan` | Execute plan | After plan is created and reviewed |
+| `/jdi:commit` | Conventional commit | Manual commits outside plan execution |
+| `/jdi:generate-pr` | Create pull request | After implementation is complete |
+| `/jdi:pr-review` | Review pull request | Before requesting human review |
+| `/jdi:pr-feedback` | Address PR feedback | After receiving review comments |
+| `/jdi:status` | Show current status | Check progress and next steps |

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@benzotti/jedi",
+  "version": "0.1.0",
+  "description": "JDI - Context-efficient AI development framework for Claude Code",
+  "type": "module",
+  "bin": {
+    "jdi": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun",
+    "dev": "bun run src/index.ts",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "citty": "^0.1.6",
+    "consola": "^3.4.0",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.8.0"
+  },
+  "files": [
+    "dist",
+    "framework"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zottiben/jedi.git"
+  },
+"license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}