Add the changelog skill and dashboard card to v2.6.0

AI Assisted
This commit is contained in:
jparkerweb committed 2026-10-08 07:22:26 -07:00
1 parent 50a78a6917
commit 3414a19ce6
18 files changed
+754 -11

No files matched your search

+23 -3
View File
@@ -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
+1 -1
View File
@@ -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
+17
View File
@@ -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;
+3
View File
@@ -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; }
+27
View File
@@ -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>
+6 -2
View File
@@ -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").
+1 -1
View File
@@ -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" });