mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-16 20:45:33 -08:00
Add the changelog skill and dashboard card to v2.6.0
AI Assisted
This commit is contained in:
1 parent
50a78a6917
commit
3414a19ce6
18 files changed
+754
-11
No files matched your search
@@ -97,7 +97,7 @@ files under `specs/` are the only source of truth, and neither channel owns them
|
||||
`--workflow` is whichever you are running: `dashboard`, `init`,
|
||||
`init-update`, `pathfinder`, `quick-task`, `plan`, `revise-plan`,
|
||||
`document`, `implement`, `implement-review`, `review`, `finalize`,
|
||||
`handoff` or `git-commit`. Get it
|
||||
`handoff`, `git-commit` or `changelog`. Get it
|
||||
right: the page decides from it whether to offer a brief, what stopping
|
||||
early costs, and which command resumes the session if you cannot say.
|
||||
`dashboard` is the special one: the page draws the skill menu itself, and
|
||||
@@ -873,6 +873,26 @@ that is what the person is there to download. The finish carries no
|
||||
`command`: the doc download is the point, and the dashboard button and the
|
||||
"All done" line cover what comes next.
|
||||
|
||||
### Changelog (`changelog`)
|
||||
|
||||
Open with `--workflow changelog` (launched from the dashboard: resume the
|
||||
session instead). Post `activity` while you read the history and the diff. One
|
||||
card per step, each asked only when the step needs it:
|
||||
|
||||
| Step | On the page |
|
||||
| --- | --- |
|
||||
| Version | A `choice`, "Which version?": the computed version (recommended) with its reason in `body` (main is at X, the branch has Y), "Keep Y" when the branch's own entry could stay, and "Another version" (`allowOther`, with a `pattern` of `^[0-9]+.[0-9]+.[0-9]+$`). Left out when the entry is already right. |
|
||||
| Entries | A `list` titled "Entries to add": one row per suggested entry (`title` the section, `body` the line), editable, removable and reorderable. Anything they add arrives as a row. |
|
||||
| The result | The final entry as a doc (`id: "entry"`, marked `"saved": "CHANGELOG.md"` once written) plus a `review` card with verdicts `write` ("Write it"), `change` and `stop`. |
|
||||
| package.json | A `confirm` with the `old → new` in `consequences`. |
|
||||
| Git commit next | A `confirm`, "Run Git commit next?". |
|
||||
|
||||
A yes to "Run Git commit next?" ends no session: settle the card, resume as
|
||||
`git-commit` (`open --resume <sid> --no-open --workflow git-commit`) and run
|
||||
that skill in this same session, as a dashboard launch does (Launches).
|
||||
Finish, on a no: `"dashboard": true` and the version and entries in `body`,
|
||||
with no `command`. A stop's finish is the bare `/plan2code-changelog`.
|
||||
|
||||
### Git commit (`git-commit`)
|
||||
|
||||
Open with `--workflow git-commit` (launched from the dashboard: resume the
|
||||
@@ -1013,7 +1033,7 @@ The page's top bar shows a meter of how much work this console session has
|
||||
done (green, yellow, red), so the person knows when a fresh session would be
|
||||
sharper. It is advice only and never blocks anything. The console counts
|
||||
launches itself: Plan, Revise plan, Document, Review, Quick task, Init, Init
|
||||
update, Finalize and Git commit score when their session opens, and there is nothing to
|
||||
update, Finalize, Git commit and Changelog score when their session opens, and there is nothing to
|
||||
post for them.
|
||||
|
||||
It counts answers itself too: every card the person answers in a send adds to
|
||||
@@ -1031,7 +1051,7 @@ Per-unit work is yours to report, with `run` in any post:
|
||||
nothing now: answers count instead), `pathfinder-research`, `plan`,
|
||||
`revise-plan`, `document`, `implement-phase`, `implement-review-phase`,
|
||||
`review`, `quick-task`, `init`, `init-update`, `finalize`, `handoff`,
|
||||
`git-commit` (counted when its session opens, so never post it).
|
||||
`git-commit`, `changelog` (both counted when their session opens, so never post them).
|
||||
An unknown event is exit `3`.
|
||||
- `id` names the unit: a question's file slug, `phase-N`, `map`. The same id
|
||||
posted again in the same skill run is ignored, so a repeated post never
|
||||
|
||||
@@ -1108,7 +1108,7 @@ port, and the filesystem as transport; this CLI is the whole agent surface.
|
||||
|
||||
workflows: dashboard · init · init-update · pathfinder · quick-task · plan ·
|
||||
revise-plan · document · implement · implement-review · review ·
|
||||
finalize · handoff · git-commit
|
||||
finalize · handoff · git-commit · changelog
|
||||
|
||||
A session handed to you by the dashboard (a --session id): resume it with
|
||||
"open --resume <sid> --no-open --workflow <yours> --title <t>" -- never a
|
||||
|
||||
@@ -248,6 +248,7 @@ export const WORKFLOW_LABEL = {
|
||||
finalize: "Wrapping up",
|
||||
handoff: "Handoff",
|
||||
"git-commit": "Git commit",
|
||||
changelog: "Changelog",
|
||||
};
|
||||
|
||||
export function workflowLabel(workflow) {
|
||||
@@ -273,6 +274,7 @@ export const CONSOLE_WORKFLOWS = [
|
||||
"/plan2code-4-finalize",
|
||||
"/plan2code-handoff",
|
||||
"/plan2code-git-commit",
|
||||
"/plan2code-changelog",
|
||||
];
|
||||
|
||||
// Rides on the end of the command as part of the skill's argument. Every
|
||||
@@ -438,6 +440,8 @@ export function resumeCommand({ workflow, specDir } = {}) {
|
||||
return "/plan2code-handoff";
|
||||
case "git-commit":
|
||||
return "/plan2code-git-commit";
|
||||
case "changelog":
|
||||
return "/plan2code-changelog";
|
||||
default:
|
||||
return dir ? `/plan2code-0-pathfinder ${dir}/pathfinder` : "/plan2code-0-pathfinder";
|
||||
}
|
||||
@@ -642,6 +646,17 @@ export const SKILL_CATALOG = [
|
||||
about:
|
||||
"Writes down everything a new session would need, as a single document: what was decided, what is done, what is left. Use it when a conversation got long, a machine changed, or tomorrow-you deserves the context today-you has.",
|
||||
},
|
||||
{
|
||||
skill: "plan2code-changelog",
|
||||
command: "/plan2code-changelog",
|
||||
workflow: "changelog",
|
||||
group: "extra",
|
||||
chip: "Utility",
|
||||
title: "Changelog",
|
||||
blurb: "Checks the CHANGELOG version against the main branch and suggests entries for what is new.",
|
||||
about:
|
||||
"Works out the right version from the default branch, then compares your branch with the latest CHANGELOG entry and suggests the entries it is missing. You edit them before anything is written, it keeps package.json in step, and it offers to run Git commit next. If the newest version is not released or on another branch yet, it adds to that entry instead of starting a new one.",
|
||||
},
|
||||
{
|
||||
skill: "plan2code-git-commit",
|
||||
command: "/plan2code-git-commit",
|
||||
@@ -676,6 +691,7 @@ export const START_POSES = [
|
||||
"review",
|
||||
"handoff",
|
||||
"git-commit",
|
||||
"changelog",
|
||||
];
|
||||
|
||||
const POSE_ALIASES = { "init-update": "init", "revise-plan": "plan", "implement-review": "implement" };
|
||||
@@ -744,6 +760,7 @@ export function cardAvailability(entry, scan, sel) {
|
||||
case "plan2code-quick-task":
|
||||
case "plan2code-review":
|
||||
case "plan2code-handoff":
|
||||
case "plan2code-changelog":
|
||||
return ON;
|
||||
case "plan2code-git-commit":
|
||||
return scan && scan.isGit === false ? { on: true, note: GIT_INIT_NOTE } : ON;
|
||||
|
||||
@@ -3433,6 +3433,9 @@ a.icon-btn { box-sizing: border-box; text-decoration: none; }
|
||||
100% { opacity: 0; transform: translateY(0); }
|
||||
}
|
||||
|
||||
/* Changelog -- the arm reaches the page and the newest line is written in step. */
|
||||
.pose .cl-line { animation: gc-dot 2.4s ease-in-out infinite; }
|
||||
|
||||
@media (max-width: 720px) {
|
||||
.dash { padding-top: 0; }
|
||||
.launch-stage { height: 140px; }
|
||||
|
||||
@@ -539,6 +539,32 @@
|
||||
<g class="ho-arrow"><path class="as" d="M178 64 L214 64 M204 54 L216 64 L204 74" /></g>
|
||||
</svg>
|
||||
|
||||
<!-- Changelog: keeping the record. A page of release notes stands beside him,
|
||||
and one arm reaches over to write the newest line onto it. -->
|
||||
<svg class="pose pose-changelog" data-pose="changelog" viewBox="0 4 240 216" aria-hidden="true" focusable="false">
|
||||
<ellipse class="shadow" cx="126" cy="198" rx="44" ry="5" />
|
||||
<g class="prop">
|
||||
<rect class="sh" x="176" y="58" width="44" height="116" rx="6" />
|
||||
<line class="lt" x1="186" y1="76" x2="206" y2="76" />
|
||||
<circle class="ac" cx="186" cy="94" r="3" /><line class="lt" x1="194" y1="94" x2="210" y2="94" />
|
||||
<circle class="ac" cx="186" cy="112" r="3" /><line class="lt" x1="194" y1="112" x2="206" y2="112" />
|
||||
<g class="cl-line"><circle class="ac" cx="186" cy="130" r="3" /><line class="lt" x1="194" y1="130" x2="210" y2="130" /></g>
|
||||
</g>
|
||||
<g class="bob">
|
||||
<g transform="translate(-14 0)">
|
||||
<rect class="fl foot f1" x="94" y="179" width="20" height="10" rx="5" />
|
||||
<rect class="fl foot f2" x="126" y="179" width="20" height="10" rx="5" />
|
||||
<rect class="sh" x="80" y="72" width="80" height="108" rx="16" />
|
||||
<path class="ln" d="M80 126 L66 150" /><circle class="fl" cx="66" cy="150" r="5.5" />
|
||||
<path class="ey blink" d="M126 86 L129.64 94.98 L139.31 95.67 L131.9 101.92 L134.23 111.33 L126 106.2 L117.77 111.33 L120.1 101.92 L112.69 95.67 L122.36 94.98 Z" />
|
||||
<path class="es" d="M110 120 Q122 129 134 120" />
|
||||
<g class="gc-reach">
|
||||
<line class="ln" x1="160" y1="126" x2="196" y2="132" />
|
||||
<circle class="fl" cx="196" cy="132" r="5.5" />
|
||||
</g>
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
<!-- Git commit: saving a step. Beside a branch line with two commits on
|
||||
it, one arm reaches to set a third commit onto the line. -->
|
||||
<svg class="pose pose-git-commit" data-pose="git-commit" viewBox="0 4 240 216" aria-hidden="true" focusable="false">
|
||||
@@ -1367,6 +1393,7 @@
|
||||
<li><strong>Quick task.</strong> Too small for the full process? A quick plan, then it just builds it.</li>
|
||||
<li><strong>Review.</strong> A second opinion on the changes. Problems ranked, and you pick what gets fixed.</li>
|
||||
<li><strong>Handoff.</strong> Pack this conversation into a document a fresh session can pick up cold.</li>
|
||||
<li><strong>Changelog.</strong> Checks the CHANGELOG version against the main branch and suggests entries for what is new.</li>
|
||||
<li><strong>Git commit.</strong> Commits your changes with a clear message, suggests a split when it is really two jobs, and offers to push.</li>
|
||||
</ul>
|
||||
<h4>Picking a spec</h4>
|
||||
|
||||
@@ -26,13 +26,14 @@ export const WEIGHTS = Object.freeze({
|
||||
finalize: 1,
|
||||
handoff: 0,
|
||||
"git-commit": 1,
|
||||
changelog: 1,
|
||||
});
|
||||
|
||||
// Workflows whose launch itself scores WEIGHTS[workflow]. Pathfinder,
|
||||
// implement and implement-review score only through the agent's `run`
|
||||
// reports; dashboard and handoff never score; git-commit scores 1 on launch.
|
||||
// reports; dashboard and handoff never score; git-commit and changelog score 1 on launch.
|
||||
export const LAUNCH_COUNTED = Object.freeze(
|
||||
new Set(["plan", "revise-plan", "document", "review", "quick-task", "init", "init-update", "finalize", "git-commit"])
|
||||
new Set(["plan", "revise-plan", "document", "review", "quick-task", "init", "init-update", "finalize", "git-commit", "changelog"])
|
||||
);
|
||||
|
||||
const weightOf = (key) => (Object.prototype.hasOwnProperty.call(WEIGHTS, key) ? WEIGHTS[key] : 0);
|
||||
@@ -128,6 +129,7 @@ const WORKFLOW_NAMES = Object.freeze({
|
||||
finalize: "Finalize",
|
||||
handoff: "Handoff",
|
||||
"git-commit": "Git commit",
|
||||
changelog: "Changelog",
|
||||
});
|
||||
|
||||
// The skill run an entry belongs to, from its ledger id ("L3:..." -> "L3").
|
||||
@@ -144,6 +146,7 @@ const LAUNCH_LABELS = Object.freeze({
|
||||
"init-update": "Init update started",
|
||||
finalize: "Finalize started",
|
||||
"git-commit": "Git commit started",
|
||||
changelog: "Changelog started",
|
||||
});
|
||||
const RUN_LABELS = Object.freeze({
|
||||
"pathfinder-chart": "Pathfinder map written",
|
||||
@@ -161,6 +164,7 @@ const RUN_LABELS = Object.freeze({
|
||||
finalize: "Finalize run",
|
||||
handoff: "Handoff written",
|
||||
"git-commit": "Git commit run",
|
||||
changelog: "Changelog run",
|
||||
});
|
||||
|
||||
// The unit a run names, from its ledger id ("L3:phase-2" -> "phase-2").
|
||||
|
||||
@@ -185,7 +185,7 @@ export function checkHelpers(list) {
|
||||
// are tested without a browser. `frame` is the state frame's `subagents`
|
||||
// block; app.js only renders what these say.
|
||||
|
||||
export const CHECKIN_LINE = "Helpers report through Plan2Code, so their progress is shown as it checks-in, not live.";
|
||||
export const CHECKIN_LINE = "Helpers report through Plan2Code, so their progress is shown as it checks in, not live.";
|
||||
|
||||
const STATE_LABELS = Object.freeze({ running: "Running", done: "Done", failed: "Failed" });
|
||||
|
||||
|
||||
Reference in new issue
Block a user