mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-16 04:45:33 -08:00
Let set-version ask for the version on a terminal (Enter takes the next patch) and run as npm run set-version, bump every carrier to 3.0.6, and read the Ask entry for screenshots from the session's chat log now that chat hands over only the seq
AI Assisted
This commit is contained in:
1 parent
567a65ff5b
commit
9199fc00af
14 files changed
+104
-22
No files matched your search
@@ -14,7 +14,7 @@
|
||||
|
||||
## Gotchas / Pitfalls
|
||||
|
||||
- **Version sync:** When adding a new version to `CHANGELOG.md`, run `node scripts/set-version.mjs <x.y.z>` (the one writer of every carrier; it never edits the changelog), which updates `version.json` and `package.json` (root) to match. `README.md` (the `Version X.Y.Z` line near the top) also carries the version, and `version.json`'s `releaseDate` moves with it. `version.json` is copied into every skill's `references/web-console/` (the console's Help shows it), so after a bump run `npm run build:skills` or `npm test` (`--verify-skills`) fails. The installer displays the version from `version.json` in its header. All three files (`CHANGELOG.md`, `version.json`, `package.json`) must always show the same version number. The desktop app carries it too (under `plan2code-app/`: `package.json`, `package-lock.json` with two lines, `src-tauri/tauri.conf.json`, `src-tauri/Cargo.toml`, `fake-agent/Cargo.toml`, and `Cargo.lock`'s `plan2code-app` and `fake-agent` entries): `node scripts/check-versions.mjs [--tag vX.Y.Z]` compares those, `version.json`, `package.json`, `CHANGELOG.md` and README's line (twelve places in all), `npm test` runs it first on this tree, and the release workflow runs it before building.
|
||||
- **Version sync:** When adding a new version to `CHANGELOG.md`, run `npm run set-version -- <x.y.z>` (`node scripts/set-version.mjs`; with no version on a terminal it shows the current one and asks, Enter taking the next patch; the one writer of every carrier; it never edits the changelog), which updates `version.json` and `package.json` (root) to match. `README.md` (the `Version X.Y.Z` line near the top) also carries the version, and `version.json`'s `releaseDate` moves with it. `version.json` is copied into every skill's `references/web-console/` (the console's Help shows it), so after a bump run `npm run build:skills` or `npm test` (`--verify-skills`) fails. The installer displays the version from `version.json` in its header. All three files (`CHANGELOG.md`, `version.json`, `package.json`) must always show the same version number. The desktop app carries it too (under `plan2code-app/`: `package.json`, `package-lock.json` with two lines, `src-tauri/tauri.conf.json`, `src-tauri/Cargo.toml`, `fake-agent/Cargo.toml`, and `Cargo.lock`'s `plan2code-app` and `fake-agent` entries): `node scripts/check-versions.mjs [--tag vX.Y.Z]` compares those, `version.json`, `package.json`, `CHANGELOG.md` and README's line (twelve places in all), `npm test` runs it first on this tree, and the release workflow runs it before building.
|
||||
- **CHANGELOG ordering:** Entries in `CHANGELOG.md` must be in reverse-chronological order — newest version at the top, oldest at the bottom. New entries are always inserted immediately after the file header.
|
||||
- **CHANGELOG house format is not Keep a Changelog:** version headings are `## vX.Y.Z` — with a `v` prefix and **no date**. The release date is recorded only in `version.json`'s `releaseDate`. Category headings carry emoji: `### ✨ Added`, `### 🔧 Changed`, `### 🐛 Fixed`, `### 💥 Breaking`, `### 🗑️ Removed`, `### 📚 Documentation`. Older entries contain one-off variants (`🎁 Added`, `📦 Updated`, `📝 Documentation`, `🏎️ Improved`, `🧪 Testing`) — do not introduce new ones. The `.claude/skills/plan2code-changelog/` skill automates version selection and formatting; use it rather than hand-rolling an entry.
|
||||
- **PowerShell mangles the CHANGELOG emoji:** `Get-Content` / `Select-String` render the `###` heading emoji as `?` under the default Windows console encoding, so a heading audit done that way reports garbage. Read `CHANGELOG.md` with a file-read or grep tool instead.
|
||||
|
||||
@@ -1 +1 @@
|
||||
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 truncated
|
||||
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 truncated
|
||||
@@ -13,7 +13,7 @@ the next engineer all start from the same specs.
|
||||
|
||||
One command opens it, every step is a card, and the terminal is always there if you prefer it.
|
||||
|
||||
Version 3.0.5 · MIT · 📖 [plan2code.jparkerweb.com](https://plan2code.jparkerweb.com)
|
||||
Version 3.0.6 · MIT · 📖 [plan2code.jparkerweb.com](https://plan2code.jparkerweb.com)
|
||||
|
||||
---
|
||||
|
||||
|
||||
+2
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "plan2code",
|
||||
"version": "3.0.5",
|
||||
"version": "3.0.6",
|
||||
"private": true,
|
||||
"bin": {
|
||||
"plan2code-install": "./install.js"
|
||||
@@ -9,6 +9,7 @@
|
||||
"prepare": "husky",
|
||||
"build:skills": "node install.js --build-skills",
|
||||
"fix:eol": "node scripts/fix-line-endings.mjs",
|
||||
"set-version": "node scripts/set-version.mjs",
|
||||
"play": "node scripts/play.mjs",
|
||||
"pretest": "node scripts/fix-line-endings.mjs",
|
||||
"test:fast": "node scripts/test-fast.mjs",
|
||||
|
||||
Generated
+2
-2
@@ -757,7 +757,7 @@ dependencies = [
|
||||
|
||||
[[package]]
|
||||
name = "fake-agent"
|
||||
version = "3.0.5"
|
||||
version = "3.0.6"
|
||||
dependencies = [
|
||||
"serde_json",
|
||||
"terminal_size",
|
||||
@@ -2371,7 +2371,7 @@ checksum = "f6b464fbc74e149a392436b17d523f769e057cb6877f6a5c4618bc6f11800548"
|
||||
|
||||
[[package]]
|
||||
name = "plan2code-app"
|
||||
version = "3.0.5"
|
||||
version = "3.0.6"
|
||||
dependencies = [
|
||||
"chrono",
|
||||
"libc",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
[package]
|
||||
name = "fake-agent"
|
||||
version = "3.0.5"
|
||||
version = "3.0.6"
|
||||
description = "A stand-in agent program for the Plan2Code app's tests"
|
||||
edition = "2021"
|
||||
publish = false
|
||||
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "plan2code-app",
|
||||
"version": "3.0.5",
|
||||
"version": "3.0.6",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "plan2code-app",
|
||||
"version": "3.0.5",
|
||||
"version": "3.0.6",
|
||||
"dependencies": {
|
||||
"@tauri-apps/api": "2.12.4",
|
||||
"@xterm/addon-fit": "0.11.0",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "plan2code-app",
|
||||
"version": "3.0.5",
|
||||
"version": "3.0.6",
|
||||
"private": true,
|
||||
"description": "Plan2Code desktop app (Tauri). Separate from the repo root so the root and the web console stay dependency-free.",
|
||||
"scripts": {
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
[package]
|
||||
name = "plan2code-app"
|
||||
version = "3.0.5"
|
||||
version = "3.0.6"
|
||||
description = "Plan2Code desktop app"
|
||||
edition = "2021"
|
||||
publish = false
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"$schema": "https://schema.tauri.app/config/2",
|
||||
"productName": "Plan2Code",
|
||||
"version": "3.0.5",
|
||||
"version": "3.0.6",
|
||||
"identifier": "com.plan2code.desktop",
|
||||
"build": {
|
||||
"frontendDist": "../ui",
|
||||
|
||||
@@ -535,10 +535,17 @@ async function captureAsk(browser, project, sid, url, question) {
|
||||
if (send) send.click();
|
||||
});
|
||||
|
||||
// `chat` hands over only the message's seq (its text goes in `reply`) and
|
||||
// moves its cursor past it, so the first seq seen is the one; the entry
|
||||
// itself, with its conversation, is read from the session's chat log.
|
||||
let entry = null;
|
||||
for (let i = 0; i < 40 && !entry; i++) {
|
||||
const r = cli(project, "chat", "--session", sid);
|
||||
if (r.code === 0 && r.out && r.out.chat) entry = r.out.chat.find((c) => c.kind === "message");
|
||||
const seq = r.code === 0 && r.out && Array.isArray(r.out.chat) ? r.out.chat[0] : undefined;
|
||||
if (Number.isInteger(seq)) {
|
||||
const log = path.join(HOME, "sessions", sid, "chat.ndjson");
|
||||
entry = fs.readFileSync(log, "utf8").split("\n").filter(Boolean).map((l) => JSON.parse(l)).find((e) => e.seq === seq) || null;
|
||||
}
|
||||
if (!entry) await sleep(250);
|
||||
}
|
||||
if (!entry) throw new Error("the Ask question never reached the console");
|
||||
|
||||
+62
-5
@@ -5,8 +5,11 @@
|
||||
// entries). It never touches CHANGELOG.md: write its heading by hand, then run this.
|
||||
// `check-versions.mjs` is the reader of the same places and stays the judge.
|
||||
//
|
||||
// node scripts/set-version.mjs <x.y.z> [--date YYYY-MM-DD] [--root <dir>]
|
||||
// node scripts/set-version.mjs [x.y.z] [--date YYYY-MM-DD] [--root <dir>]
|
||||
// npm run set-version [-- x.y.z]
|
||||
//
|
||||
// With no version on a terminal it shows the current one and asks (Enter takes the next patch);
|
||||
// with no version and no terminal (a script, a pipe) it prints the usage line and exits 2.
|
||||
// The release date defaults to today (local time). Every carrier is read and checked before any is
|
||||
// written, so a file that has no version leaves the tree as it was. Exit 0 when written, 1 when a
|
||||
// carrier could not be edited, 2 for bad arguments.
|
||||
@@ -111,6 +114,47 @@ export function setVersion(root, version, date = today()) {
|
||||
|
||||
export const CARRIER_FILES = CARRIERS.map((c) => c.file);
|
||||
|
||||
// The next patch after `current` (x.y.z), or "" when `current` is not one.
|
||||
export function nextPatch(current) {
|
||||
if (!SEMVER.test(current || "")) return "";
|
||||
const [major, minor, patch] = current.split(".").map(Number);
|
||||
return `${major}.${minor}.${patch + 1}`;
|
||||
}
|
||||
|
||||
// Ask on the terminal until a valid x.y.z is typed. Enter takes the suggested next patch.
|
||||
// Returns "" when the input ends (Ctrl+D, Ctrl+C) without one.
|
||||
async function askVersion(root) {
|
||||
let current = "";
|
||||
try {
|
||||
current = JSON.parse(fs.readFileSync(path.join(root, "version.json"), "utf8")).version || "";
|
||||
} catch {
|
||||
// No readable version.json: ask without a current version or a suggestion.
|
||||
}
|
||||
const suggested = nextPatch(current);
|
||||
const { createInterface } = await import("node:readline");
|
||||
const rl = createInterface({ input: process.stdin, terminal: false });
|
||||
// The line iterator buffers what is typed and ends on Ctrl+D or Ctrl+C, where a pending
|
||||
// rl.question() would never settle and leave the process to exit on an unsettled await.
|
||||
const lines = rl[Symbol.asyncIterator]();
|
||||
rl.on("SIGINT", () => rl.close());
|
||||
try {
|
||||
if (current) console.log(`Current version: ${current}`);
|
||||
for (;;) {
|
||||
process.stdout.write(`New version (x.y.z)${suggested ? ` [${suggested}]` : ""}: `);
|
||||
const { value, done } = await lines.next();
|
||||
if (done) {
|
||||
process.stdout.write("\n");
|
||||
return "";
|
||||
}
|
||||
const picked = value.trim() || suggested;
|
||||
if (SEMVER.test(picked)) return picked;
|
||||
console.log(picked ? `"${picked}" is not x.y.z, for example 3.1.0.` : "Type a version, for example 3.1.0.");
|
||||
}
|
||||
} finally {
|
||||
rl.close();
|
||||
}
|
||||
}
|
||||
|
||||
if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
|
||||
const args = process.argv.slice(2);
|
||||
const take = (flag) => {
|
||||
@@ -121,13 +165,26 @@ if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.me
|
||||
};
|
||||
const date = take("--date");
|
||||
const rootArg = take("--root");
|
||||
const [version, ...extra] = args;
|
||||
const usage = "Usage: node scripts/set-version.mjs <x.y.z> [--date YYYY-MM-DD] [--root <dir>]";
|
||||
if (!version || extra.length || !SEMVER.test(version) || (date !== undefined && !validDate(date)) || rootArg === "") {
|
||||
let [version, ...extra] = args;
|
||||
const usage = "Usage: node scripts/set-version.mjs [x.y.z] [--date YYYY-MM-DD] [--root <dir>] (npm run set-version)";
|
||||
const root = rootArg ? path.resolve(rootArg) : ROOT;
|
||||
if (extra.length || (version !== undefined && !SEMVER.test(version)) || (date !== undefined && !validDate(date)) || rootArg === "") {
|
||||
console.error(usage);
|
||||
process.exit(2);
|
||||
}
|
||||
const { ok, written, problems } = setVersion(rootArg ? path.resolve(rootArg) : ROOT, version, date);
|
||||
// No version given: ask for one on a terminal; a script or a pipe gets the usage line instead.
|
||||
if (version === undefined) {
|
||||
if (!process.stdin.isTTY) {
|
||||
console.error(usage);
|
||||
process.exit(2);
|
||||
}
|
||||
version = await askVersion(root);
|
||||
if (!version) {
|
||||
console.error("No version given. Nothing was written.");
|
||||
process.exit(2);
|
||||
}
|
||||
}
|
||||
const { ok, written, problems } = setVersion(root, version, date);
|
||||
if (!ok) {
|
||||
for (const problem of problems) console.error(`CANNOT SET: ${problem}`);
|
||||
console.error("Nothing was written.");
|
||||
|
||||
@@ -12,7 +12,7 @@ import path from "node:path";
|
||||
import { spawnSync } from "node:child_process";
|
||||
import { fileURLToPath } from "node:url";
|
||||
import { checkVersions } from "./check-versions.mjs";
|
||||
import { CARRIER_FILES } from "./set-version.mjs";
|
||||
import { CARRIER_FILES, nextPatch } from "./set-version.mjs";
|
||||
|
||||
const here = path.dirname(fileURLToPath(import.meta.url));
|
||||
const ROOT = path.resolve(here, "..");
|
||||
@@ -124,12 +124,29 @@ test("a carrier with no version in it fails and writes nothing", () => {
|
||||
|
||||
test("bad arguments exit 2 and write nothing", () => {
|
||||
const dir = scratch();
|
||||
// Compared with the file as copied, not with a number: the repo may already be at 3.0.1.
|
||||
const before = read(dir, "version.json");
|
||||
for (const args of [[], ["3.0"], ["v3.0.1"], ["3.0.1-beta"], ["3.0.1", "extra"], ["3.0.1", "--date", "yesterday"], ["3.0.1", "--root"]]) {
|
||||
const r = run(...args, ...(args.includes("--root") ? [] : ["--root", dir]));
|
||||
assert.equal(r.status, 2, `${args.join(" ")}: ${r.stderr}`);
|
||||
assert.match(r.stderr, /Usage: node scripts\/set-version\.mjs/);
|
||||
}
|
||||
assert.ok(!read(dir, "version.json").includes("3.0.1"));
|
||||
assert.equal(read(dir, "version.json"), before);
|
||||
});
|
||||
|
||||
test("no version and no terminal prints the usage line instead of asking", () => {
|
||||
// run() pipes stdin, so this is the script-or-pipe case: no prompt, exit 2, nothing written.
|
||||
const dir = scratch();
|
||||
const r = run("--root", dir);
|
||||
assert.equal(r.status, 2, r.stderr);
|
||||
assert.match(r.stderr, /npm run set-version/);
|
||||
});
|
||||
|
||||
test("the prompt suggests the next patch", () => {
|
||||
assert.equal(nextPatch("3.0.9"), "3.0.10");
|
||||
assert.equal(nextPatch("2.10.0"), "2.10.1");
|
||||
assert.equal(nextPatch("v3.0.1"), "");
|
||||
assert.equal(nextPatch(undefined), "");
|
||||
});
|
||||
|
||||
test("an impossible date is refused", () => {
|
||||
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "Plan2Code",
|
||||
"version": "3.0.5",
|
||||
"version": "3.0.6",
|
||||
"description": "A structured 4-step workflow methodology for AI-assisted software development",
|
||||
"keywords": [
|
||||
"ai",
|
||||
@@ -17,6 +17,6 @@
|
||||
"url": "https://github.com/jparkerweb/plan2code"
|
||||
},
|
||||
"homepage": "https://github.com/jparkerweb/plan2code",
|
||||
"releaseDate": "2026-11-08",
|
||||
"releaseDate": "2026-11-10",
|
||||
"mode": "utility"
|
||||
}
|
||||
Reference in new issue
Block a user