mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-17 04:45:33 -08:00
Sync upstream v2.4.0 into v2.4.1: welcome dialog, bug/idea button with issue templates, version in Help, gear preferences and ocean default accent, plus web console screenshots, new landing page and web-console-first docs
AI Assisted
This commit is contained in:
1 parent
0d7c2e140b
commit
cb86034de9
288 files changed
+25222
-4767
No files matched your search
@@ -0,0 +1,18 @@
|
||||
# Screenshot payloads
|
||||
|
||||
Each JSON file here stages one web console screen for the docs, with no agent
|
||||
involved. `node scripts/capture-screenshots.mjs` opens a console session in a
|
||||
throwaway sample project, posts these files, and saves the screens as light
|
||||
and dark WebP images in `docs/screenshots/`.
|
||||
|
||||
| File | Stages |
|
||||
| --- | --- |
|
||||
| `dashboard.json` | The dashboard menu, suggesting the next build phase |
|
||||
| `question.json` | A Plan session with three questions open (also the base of the Ask shot) |
|
||||
| `doc.json` | A living document with settled, assumed and draft sections, and its review card |
|
||||
| `build.json` | A phase being built: the progress bar, the task list and the current task |
|
||||
| `signoff.json` | The completion report and the sign-off card |
|
||||
| `finish.json` | The finished screen after sign-off (posted after `signoff.json`) |
|
||||
|
||||
Refresh every image with `node scripts/capture-screenshots.mjs`, or one with
|
||||
`--only <shot>`.
|
||||
@@ -0,0 +1,40 @@
|
||||
{
|
||||
"workflow": "implement",
|
||||
"title": "task-api: Phase 3",
|
||||
"headline": {
|
||||
"stage": "Phase 3: API endpoints",
|
||||
"cleared": 5,
|
||||
"total": 11
|
||||
},
|
||||
"docs": [
|
||||
{
|
||||
"id": "phase",
|
||||
"title": "Phase 3 tasks",
|
||||
"version": 6,
|
||||
"blocks": [
|
||||
{
|
||||
"id": "tasks",
|
||||
"state": "settled",
|
||||
"md": "- [x] **Task 3.1:** Register the /tasks routes plugin\n- [x] **Task 3.2:** Add GET /tasks with cursor paging\n- [x] **Task 3.3:** Add GET /tasks/:id\n- [x] **Task 3.4:** Add POST /tasks with a Zod schema\n- [x] **Task 3.5:** Add PATCH /tasks/:id for status and fields\n- [ ] **Task 3.6:** Add DELETE /tasks/:id as a soft delete\n- [ ] **Task 3.7:** Filter GET /tasks by status and assignee\n- [ ] **Task 3.8:** Return one error shape for 400, 404 and 409\n- [ ] **Task 3.9:** Document the endpoints in openapi.yaml\n- [ ] **Task 3.10:** Write tests for paging, filters and validation\n- [ ] **Task 3.11:** Run the test suite and record the results"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "phasefile",
|
||||
"title": "phase-3.md",
|
||||
"version": 6,
|
||||
"blocks": [
|
||||
{
|
||||
"id": "body",
|
||||
"state": "settled",
|
||||
"md": "# Phase 3: API endpoints\n\n**Status:** In Progress\n**Estimated Tasks:** 11\n\n## Overview\n\nThe /tasks endpoints: list with paging and filters, read, create, update and soft delete, with one error shape for every failure.\n\n## Prerequisites\n\n- Phase 2 complete (the tasks table and model exist) VERIFIED\n- Postgres runs locally VERIFIED\n\n## Tasks\n\n- [x] **Task 3.1:** Register the /tasks routes plugin\n- [x] **Task 3.2:** Add GET /tasks with cursor paging\n- [x] **Task 3.3:** Add GET /tasks/:id\n- [x] **Task 3.4:** Add POST /tasks with a Zod schema\n- [x] **Task 3.5:** Add PATCH /tasks/:id for status and fields\n- [ ] **Task 3.6:** Add DELETE /tasks/:id as a soft delete\n- [ ] **Task 3.7:** Filter GET /tasks by status and assignee\n- [ ] **Task 3.8:** Return one error shape for 400, 404 and 409\n- [ ] **Task 3.9:** Document the endpoints in openapi.yaml\n- [ ] **Task 3.10:** Write tests for paging, filters and validation\n- [ ] **Task 3.11:** Run the test suite and record the results\n\n## Acceptance Criteria\n\n- Every endpoint validates its input and answers errors in one shape\n- Paging stays stable while tasks are added and removed\n"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"agent": {
|
||||
"status": "working",
|
||||
"activity": "Task 6 of 11: deleting a task",
|
||||
"quietMinutes": 15
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,12 @@
|
||||
{
|
||||
"menu": {
|
||||
"note": "task-api is built up to Phase 2 of 4. Phase 3 is next.",
|
||||
"recommend": "plan2code-3-implement",
|
||||
"details": {
|
||||
"plan2code-3-implement": "Phase 3 of 4 is next"
|
||||
}
|
||||
},
|
||||
"agent": {
|
||||
"status": "waiting"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,63 @@
|
||||
{
|
||||
"workflow": "plan",
|
||||
"title": "Task API",
|
||||
"headline": {
|
||||
"stage": "Step 3 of 7: What we've agreed",
|
||||
"cleared": 4,
|
||||
"total": 7,
|
||||
"confidence": "Most of it is settled. Paging is assumed for now."
|
||||
},
|
||||
"docs": [
|
||||
{
|
||||
"id": "map",
|
||||
"title": "What we've agreed",
|
||||
"version": 2,
|
||||
"note": "Added paging",
|
||||
"blocks": [
|
||||
{
|
||||
"id": "b1",
|
||||
"state": "settled",
|
||||
"md": "## Where we're headed\n\nA REST API for a team's tasks: create, list, update and delete them, with filters by status and assignee. Built on Fastify, Postgres and Zod."
|
||||
},
|
||||
{
|
||||
"id": "b2",
|
||||
"state": "assumed",
|
||||
"md": "### Paging\n\nAssuming cursor paging, 50 tasks per page. Still open: the web app may want page numbers."
|
||||
},
|
||||
{
|
||||
"id": "b3",
|
||||
"state": "draft",
|
||||
"md": "### Still to work out\n\n- How clients sign in\n- Whether a deleted task can be restored"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"items": [
|
||||
{
|
||||
"id": "agree",
|
||||
"kind": "review",
|
||||
"title": "Check the plan so far",
|
||||
"doc": "map",
|
||||
"body": "Read what we've agreed, then approve it or say what to change. Paging is marked as assumed.",
|
||||
"verdicts": [
|
||||
{
|
||||
"id": "approve",
|
||||
"label": "Looks right"
|
||||
},
|
||||
{
|
||||
"id": "changes",
|
||||
"label": "I want changes"
|
||||
}
|
||||
],
|
||||
"token": {
|
||||
"approve": "yes",
|
||||
"changes": "needs changes"
|
||||
},
|
||||
"nothingYet": "Nothing is written to disk until you approve.",
|
||||
"fallbackText": "Does what we've agreed look right? Reply yes, or describe what to change."
|
||||
}
|
||||
],
|
||||
"agent": {
|
||||
"status": "waiting"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
{
|
||||
"items": [
|
||||
{
|
||||
"id": "signoff",
|
||||
"status": "answered",
|
||||
"answer": {
|
||||
"verdict": "approve"
|
||||
}
|
||||
}
|
||||
],
|
||||
"finish": {
|
||||
"headline": "Phase 3 is built",
|
||||
"body": "11 of 11 tasks, all on disk. Phase 4 (authentication) is next.",
|
||||
"command": "/plan2code-3-implement specs/task-api/overview.md",
|
||||
"doc": "report",
|
||||
"dashboard": true
|
||||
},
|
||||
"agent": {
|
||||
"status": "waiting"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,117 @@
|
||||
{
|
||||
"workflow": "plan",
|
||||
"title": "Task API",
|
||||
"headline": {
|
||||
"stage": "Step 1 of 7: What we're building",
|
||||
"cleared": 1,
|
||||
"total": 7,
|
||||
"confidence": "A clear idea so far. Who calls the API and how it signs in are still open."
|
||||
},
|
||||
"topics": [
|
||||
{
|
||||
"id": "t1",
|
||||
"title": "What we're building",
|
||||
"status": "current"
|
||||
}
|
||||
],
|
||||
"items": [
|
||||
{
|
||||
"id": "q2",
|
||||
"topic": "t1",
|
||||
"kind": "choice",
|
||||
"title": "How tasks are paged",
|
||||
"body": "A team can have thousands of tasks. How should the list endpoint hand them back?",
|
||||
"options": [
|
||||
{
|
||||
"k": "A",
|
||||
"text": "Cursor paging",
|
||||
"detail": "Stable while tasks are added and removed. No jumping to page 7.",
|
||||
"recommended": true
|
||||
},
|
||||
{
|
||||
"k": "B",
|
||||
"text": "Page numbers",
|
||||
"detail": "Familiar and easy to link to, but rows shift when tasks change mid-scroll."
|
||||
},
|
||||
{
|
||||
"k": "C",
|
||||
"text": "Everything at once",
|
||||
"detail": "Simplest to build; slow and heavy once a team has a few thousand tasks."
|
||||
}
|
||||
],
|
||||
"token": {
|
||||
"A": "a",
|
||||
"B": "b",
|
||||
"C": "c"
|
||||
},
|
||||
"fallbackText": "How tasks are paged: a) cursor paging b) page numbers c) everything at once. My guess: a."
|
||||
},
|
||||
{
|
||||
"id": "q3",
|
||||
"topic": "t1",
|
||||
"kind": "multi",
|
||||
"title": "Day one endpoints",
|
||||
"body": "Which of these should be there on the first day? Anything left unticked waits for a later version.",
|
||||
"options": [
|
||||
{
|
||||
"k": "1",
|
||||
"text": "List and read tasks",
|
||||
"detail": "GET /tasks and GET /tasks/:id, with filters by status and assignee."
|
||||
},
|
||||
{
|
||||
"k": "2",
|
||||
"text": "Create and update tasks",
|
||||
"detail": "POST /tasks and PATCH /tasks/:id, validated."
|
||||
},
|
||||
{
|
||||
"k": "3",
|
||||
"text": "Delete tasks",
|
||||
"detail": "A soft delete, so a task can come back."
|
||||
},
|
||||
{
|
||||
"k": "4",
|
||||
"text": "Comments on a task",
|
||||
"detail": "A thread under each task. Doubles the data model."
|
||||
}
|
||||
],
|
||||
"presets": [
|
||||
{
|
||||
"label": "The essentials",
|
||||
"ks": [
|
||||
"1",
|
||||
"2"
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "Everything",
|
||||
"ks": [
|
||||
"1",
|
||||
"2",
|
||||
"3",
|
||||
"4"
|
||||
]
|
||||
}
|
||||
],
|
||||
"token": {
|
||||
"1": "1",
|
||||
"2": "2",
|
||||
"3": "3",
|
||||
"4": "4"
|
||||
},
|
||||
"fallbackText": "Day one endpoints (pick any): 1) list and read 2) create and update 3) delete 4) comments on a task."
|
||||
},
|
||||
{
|
||||
"id": "q4",
|
||||
"topic": "t1",
|
||||
"kind": "text",
|
||||
"title": "Who calls it",
|
||||
"body": "Which apps will call this API, and roughly how many people use them?",
|
||||
"placeholder": "For example: our web app and a mobile app, about 2,000 people across 40 teams.",
|
||||
"token": {},
|
||||
"fallbackText": "Who calls it: which apps will call this API, and roughly how many people use them?"
|
||||
}
|
||||
],
|
||||
"agent": {
|
||||
"status": "waiting"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,88 @@
|
||||
{
|
||||
"workflow": "implement",
|
||||
"title": "task-api: Phase 3",
|
||||
"headline": {
|
||||
"stage": "Phase 3: API endpoints",
|
||||
"cleared": 11,
|
||||
"total": 11
|
||||
},
|
||||
"docs": [
|
||||
{
|
||||
"id": "phase",
|
||||
"title": "Phase 3 tasks",
|
||||
"version": 12,
|
||||
"blocks": [
|
||||
{
|
||||
"id": "tasks",
|
||||
"state": "settled",
|
||||
"md": "- [x] **Task 3.1:** Register the /tasks routes plugin\n- [x] **Task 3.2:** Add GET /tasks with cursor paging\n- [x] **Task 3.3:** Add GET /tasks/:id\n- [x] **Task 3.4:** Add POST /tasks with a Zod schema\n- [x] **Task 3.5:** Add PATCH /tasks/:id for status and fields\n- [x] **Task 3.6:** Add DELETE /tasks/:id as a soft delete\n- [x] **Task 3.7:** Filter GET /tasks by status and assignee\n- [x] **Task 3.8:** Return one error shape for 400, 404 and 409\n- [x] **Task 3.9:** Document the endpoints in openapi.yaml\n- [x] **Task 3.10:** Write tests for paging, filters and validation\n- [x] **Task 3.11:** Run the test suite and record the results"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "report",
|
||||
"title": "Completion report",
|
||||
"version": 1,
|
||||
"blocks": [
|
||||
{
|
||||
"id": "summary",
|
||||
"state": "settled",
|
||||
"md": "## Summary\n\nThe /tasks endpoints work end to end. Clients can list tasks with cursor paging and filters, read one, create, update and soft delete, and every failure comes back in the same error shape.\n\n**Tasks:** 11 of 11 done, none blocked."
|
||||
},
|
||||
{
|
||||
"id": "tests",
|
||||
"state": "settled",
|
||||
"md": "## Tests\n\n| Suite | Passed | Failed |\n| --- | --- | --- |\n| tasks | 31 | 0 |\n| paging | 8 | 0 |"
|
||||
},
|
||||
{
|
||||
"id": "files",
|
||||
"state": "settled",
|
||||
"md": "## Files\n\n**Created:** `src/tasks/routes.js`, `src/tasks/schema.js`, `src/tasks/paginate.js`, `test/tasks.test.js`\n\n**Modified:** `src/app.js`, `openapi.yaml`"
|
||||
},
|
||||
{
|
||||
"id": "verify",
|
||||
"state": "settled",
|
||||
"md": "## How to check it\n\n1. Run `npm test`: 39 passing.\n2. Create two tasks, then call `GET /tasks?limit=1`: one task and a `nextCursor`.\n3. `PATCH /tasks/:id` with an unknown status answers 400 in the shared error shape."
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"items": [
|
||||
{
|
||||
"id": "signoff",
|
||||
"kind": "review",
|
||||
"title": "Approve this phase",
|
||||
"doc": "report",
|
||||
"body": "Phase 3 is built. Read the report, try the checks, then approve it, review the code first, or say what to change.",
|
||||
"verdicts": [
|
||||
{
|
||||
"id": "review",
|
||||
"label": "Review the code first"
|
||||
},
|
||||
{
|
||||
"id": "approve",
|
||||
"label": "Approve this phase"
|
||||
},
|
||||
{
|
||||
"id": "changes",
|
||||
"label": "I want changes"
|
||||
}
|
||||
],
|
||||
"token": {
|
||||
"review": "review",
|
||||
"approve": "approved",
|
||||
"changes": "needs changes"
|
||||
},
|
||||
"nothingYet": "Nothing is marked complete until you approve.",
|
||||
"gate": {
|
||||
"id": "signoff",
|
||||
"authoritative": true
|
||||
},
|
||||
"fallbackText": "Reply \"approved\" to mark this phase complete, \"review\" to run the code review first, or describe any issues."
|
||||
}
|
||||
],
|
||||
"agent": {
|
||||
"status": "waiting",
|
||||
"quietMinutes": null
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user