Release 3.1.4: retry an update that stopped partway, and refresh the launcher's model menu and agent install data

AI Assisted
This commit is contained in:
jparkerweb committed 2026-11-20 16:57:47 -08:00
1 parent 630a1169c3
commit cfc58f5a06
17 files changed
+178 -62

No files matched your search

+1 -1
View File
@@ -148,7 +148,7 @@ The root `npm test` does not run the metrics or bot vitest suites; run them in t
|------|--------|
| `--build-skills` | Regenerate `skills/` from `src/`, pruning stale skills and reference files |
| `--verify-skills` | Diff local `skills/` against `src/`; exits 1 on drift. Diagnostic only, the installer rebuilds anyway |
| `--update [--force]` | No menu: reinstall what `~/.plan2code/install.json` lists (skills, launcher, app, statusline; metrics and bot only when run from a git checkout, since they run from the install folder, which npx's cache is not), never uninstalling; with no record, the skills and the `plan2code` command. Compact output: `Updating <old> -> <new>` from the record's version (or `Already on <new>`, which stops unless `--force`), each piece's own output held back (`captureOutput()`) and shown only for a warning or a failure, one summary with human piece names (`PIECE_LABELS`), the release notes link and the restart hint; a failed update also prints `plan2code update --tag v<old>`. A failed update, or one whose desktop app was kept because the release has no app file yet, puts the old version back on `install.json`, so the next update (the app's Update and restart included) runs instead of stopping at Already on. `plan2code update` runs it through npx, pinned to the newest `vX.Y.Z` tag the launcher finds with update-check.mjs's `git ls-remote` pick (`--main` takes the tip of `main`, `--tag <ref>` any ref, `--force` is passed on; `PLAN2CODE_LS_REMOTE_FILE` replaces the git call in tests) |
| `--update [--force]` | No menu: reinstall what `~/.plan2code/install.json` lists (skills, launcher, app, statusline; metrics and bot only when run from a git checkout, since they run from the install folder, which npx's cache is not), never uninstalling; with no record, the skills and the `plan2code` command. Compact output: `Updating <old> -> <new>` from the record's version (or `Already on <new>`, which stops unless `--force`, and only when the installed command's `bin/version.json` agrees with the record, so an update stopped after its skills step installs again), each piece's own output held back (`captureOutput()`) and shown only for a warning or a failure, one summary with human piece names (`PIECE_LABELS`), the release notes link and the restart hint; a failed update also prints `plan2code update --tag v<old>`. While an update runs, record writes keep the old version (`recordVersionHold`) and the new one is stamped only when every piece is in; a failed update, or one whose desktop app was kept because the release has no app file yet, leaves the old version on `install.json`, so the next update (the app's Update and restart included) runs instead of stopping at Already on. `plan2code update` runs it through npx, pinned to the newest `vX.Y.Z` tag the launcher finds with update-check.mjs's `git ls-remote` pick (`--main` takes the tip of `main`, `--tag <ref>` any ref, `--force` is passed on; `PLAN2CODE_LS_REMOTE_FILE` replaces the git call in tests) |
| `--uninstall [--yes] [--purge]` | No menu: confirm y/N (`--yes` skips it), run `uninstallAll()`, then ask whether to also delete `~/.plan2code` (`purgeData()`; `--purge` says yes without asking, `--yes` alone keeps the data). `uninstallAll()` is driven by the pieces `install.json` records plus a quiet probe for strays (`UNINSTALL_STEPS`, `UNINSTALL_PROBES`), prints one line per piece actually removed, falls back to deleting the `plan2code*` folders under `~/.agents/skills` when the skills CLI is unreachable, and removes the versioned console folders and `console-dir` (`removeConsoleFolders()`, stopping a running console first). What stays in `~/.plan2code` is listed by name with its size (`listKeptData()`), and the run always ends with the Removed / Could not remove / To finish block (`printUninstallReport()`). Deleting the data also removes the app's webview data outside `~/.plan2code` (`appWebviewDirs()`, `purgeAppWebview()`), and a running app is named before anything is removed (`appRunning()`). `plan2code uninstall [--yes] [--purge]` runs it through npx |
## How the Installer Works
+1
View File
@@ -7,6 +7,7 @@ Which checks cover which files, read by PR Prep and Test (`test-map.mjs read` ch
|---|---|---|---|
| Activities games | `src/web-console/public/activities/**`, `src/web-console/public/tones.js`, `src/web-console/public/music.js` | `node --test scripts/test-web-console-tones.mjs scripts/test-web-console-activities.mjs` | no |
| Launcher | `src/launcher/**` | `node --test scripts/test-launcher.mjs` | no |
| Installer update | `scripts/test-install-update.mjs` | `node --test scripts/test-install-update.mjs` | no |
| Dead Code script | `src/plan2code-dead-code-scripts/**`, `scripts/fixtures/dead-code/**` | `npm run build:skills && node scripts/node-test.mjs scripts/test-script-dead-code.mjs` | no |
| Update Dependencies script | `src/plan2code-deps-scripts/**`, `scripts/fixtures/deps/**` | `npm run build:skills && node scripts/node-test.mjs scripts/test-script-deps.mjs` | no |
| UI Prototype script and shell | `src/skill-scripts/ui-prototype*.mjs`, `src/plan2code-ui-prototype-references/**`, `scripts/fixtures/ui-prototype/**` | `npm run build:skills && node scripts/node-test.mjs scripts/test-script-ui-prototype.mjs scripts/test-ui-prototype-page.mjs` | no |
+1 -1
View File
@@ -1 +1 @@
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 truncated
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 truncated
+11
View File
@@ -4,6 +4,17 @@ All notable changes to Plan2Code will be documented in this file.
<!-- Format from 3.1.0 on: `## vX.Y.Z (YYYY-MM-DD)` with the date from version.json; a minor release opens with a three-bullet `### Highlights`; sections run Added, Changed, Fixed; game changes sit under one Activities line; tooling and test lines go under "For contributors". Older headings have no date and are not backfilled. -->
## v3.1.4 (2026-11-20)
### 🔧 Changed
- **launcher**: the model menu offers Claude Fable 5.2 in place of 5.1, Gemini 4 Hydrogen and Gemini 4 Neon for Devin, and GPT-6.2 Astra and GPT-6.2 Sol for Codex; Gemini 3.8 Flash, GLM-5.3 Low and SWE-2 Flash Medium leave Devin's list, and Claude's `haiku` and `fable` labels follow the Claude Code docs.
- **launcher**: Claude Code's install options add the Windows CMD installer and install `@latest` through npm, the OpenCode starter template opens with `@plan2code`, and the Gemini CLI note also names Gemini Code Assist for GitHub.
### 🐛 Fixed
- **launcher**: `plan2code update` no longer stops at "Already on" after an earlier update stopped partway and left the `plan2code` command on the old version; the install record keeps the old version until every piece is in.
## v3.1.3 (2026-11-18)
### 🔧 Changed
+1 -1
View File
@@ -13,7 +13,7 @@
Plan2Code is a spec-driven workflow for AI coding agents. You work through it on a page in your browser: the dashboard lists every step as a card, and each step's questions, progress and sign-offs arrive on that same page while your agent does the work. An approved plan becomes phase documents, and the agent builds to them one phase at a time.
Version 3.1.3 · Apache 2.0 · 📖 [plan2code.jparkerweb.com](https://plan2code.jparkerweb.com)
Version 3.1.4 · Apache 2.0 · 📖 [plan2code.jparkerweb.com](https://plan2code.jparkerweb.com)
---
+45 -9
View File
@@ -2569,8 +2569,13 @@ function readInstallRecord() {
return null;
}
// While update() runs, every record write keeps the version the update started from (`{ version }`),
// so an update stopped partway (Ctrl+C, a closed window, a killed child) never leaves the record
// claiming the new version over pieces that are still old. update() stamps the new one at the end.
let recordVersionHold = null;
/** Temp file, then rename, so a crash never leaves a half-written record. A failure only skips the record. */
function writeInstallRecord(pieces, skipped = (readInstallRecord() || {}).skipped || [], version = projectVersion.version) {
function writeInstallRecord(pieces, skipped = (readInstallRecord() || {}).skipped || [], version = recordVersionHold ? recordVersionHold.version : projectVersion.version) {
const record = {
version,
scope: 'global',
@@ -2591,15 +2596,25 @@ function writeInstallRecord(pieces, skipped = (readInstallRecord() || {}).skippe
}
/**
* Put `version` back in the record (null when none was known) without touching its pieces: every
* recordInstalled() stamps the version being installed, so an update that failed uses this to
* stay behind, and the next `plan2code update` does not answer "Already on".
* Write `version` on the record without touching its pieces: update() uses it to stamp the new
* version once every piece is in, and to keep the old one (null when none was known) after a
* failure or a kept app, so the next `plan2code update` does not answer "Already on".
*/
function setRecordVersion(version) {
const record = readInstallRecord();
if (record) writeInstallRecord(record.pieces, record.skipped || [], version);
}
/** The version in the installed plan2code command's version.json, or null when it is missing or unreadable. */
function installedLauncherVersion() {
try {
const { version } = JSON.parse(fs.readFileSync(LAUNCHER_VERSION_DEST, 'utf8'));
return typeof version === 'string' ? version : null;
} catch {
return null;
}
}
/** Add a piece after a successful global install. */
function recordInstalled(piece) {
const record = readInstallRecord();
@@ -3725,7 +3740,8 @@ function releaseNotesUrl(version) {
/**
* Reinstall whatever ~/.plan2code/install.json lists, without the menu or any prompt, and print
* one compact summary: `Updating <old> -> <new>` (or `Already on <new>`, which stops early unless
* `force`), one line per piece by its human name, then the release notes link and the restart
* `force`, and only when the installed command's bin/version.json agrees with the record whenever
* the record lists `launcher`), one line per piece by its human name, then the release notes link and the restart
* hint. Each piece's own output is held back and shown only when that piece warns or fails.
* Returns the exit code: 0 when every piece updated, 1 naming the pieces that failed.
*/
@@ -3733,15 +3749,33 @@ async function update({ steps = UPDATE_STEPS, cleanShims = removeLegacyLoopShims
const record = readInstallRecord();
const version = projectVersion.version;
const before = record && typeof record.version === 'string' ? record.version : null;
if (before === version && !force) {
const pieces = record ? record.pieces : ['skills', 'launcher'];
// The record alone is not proof: an update stopped before its launcher step (or one run by a
// launcher too old to pass --force on) left the record new and the command old, and every later
// update stopped here. The command's own version.json says what is really in place.
const launcherVersion = pieces.includes('launcher') ? installedLauncherVersion() : version;
if (before === version && launcherVersion === version && !force) {
console.log(`${COLORS.GREEN}${MARKS.DONE}${COLORS.RESET} Already on ${version}`);
console.log(`${COLORS.DIM}Run plan2code update --force to install it again.${COLORS.RESET}`);
return 0;
}
console.log(`${COLORS.BRIGHT}${before ? `Updating ${before} -> ${version}` : `Updating to ${version}`}${COLORS.RESET}`);
const pieces = record ? record.pieces : ['skills', 'launcher'];
if (before === version && launcherVersion !== version && !force) {
console.log(`${COLORS.DIM}The plan2code command is still on ${launcherVersion || 'an unknown version'}, so everything is installed again.${COLORS.RESET}`);
}
if (!record) console.log(`${COLORS.DIM}No install record found; updating the skills and the plan2code command.${COLORS.RESET}`);
recordVersionHold = { version: before };
try {
return await updatePieces({ steps, cleanShims, pieces, before, version });
} finally {
recordVersionHold = null;
}
}
/** update()'s body once it has decided to install: the pieces, the summary, and the version stamp. */
async function updatePieces({ steps, cleanShims, pieces, before, version }) {
await captureOutput(async () => cleanShims());
const results = {};
@@ -3798,7 +3832,7 @@ async function update({ steps = UPDATE_STEPS, cleanShims = removeLegacyLoopShims
console.log('');
if (failed.length > 0) {
console.log(`${COLORS.RED}${MARKS.FAIL} Update failed for: ${failed.join(', ')}${COLORS.RESET}`);
// The pieces that did install stamped the new version on the record: take it back, so running
// Keep the old version on the record (writes during the update already held it), so running
// plan2code update again retries instead of stopping at "Already on".
setRecordVersion(before);
console.log(`To try again, run: ${COLORS.CYAN}plan2code update${COLORS.RESET}`);
@@ -3809,7 +3843,9 @@ async function update({ steps = UPDATE_STEPS, cleanShims = removeLegacyLoopShims
// The release had no desktop app file yet, so the installed app is still the old one: keep the
// old version on the record, or the next update (the app's Update and restart among them) stops
// at "Already on" and never fetches the app once the file is attached.
if (before && typeof results.app === 'string' && results.app.startsWith('kept')) setRecordVersion(before);
// Otherwise every piece is in: only now does the record name the new version.
const appKept = typeof results.app === 'string' && results.app.startsWith('kept');
setRecordVersion(before && appKept ? before : version);
console.log(`${COLORS.GREEN}${MARKS.DONE} Plan2Code is up to date (v${version})${COLORS.RESET}`);
console.log(`What's new: ${releaseNotesUrl(version)}`);
console.log('Close any open Plan2Code console or app and start `plan2code` again.');
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "plan2code",
"version": "3.1.3",
"version": "3.1.4",
"private": true,
"license": "Apache-2.0",
"engines": {
+2 -2
View File
@@ -957,7 +957,7 @@ dependencies = [
[[package]]
name = "fake-agent"
version = "3.1.3"
version = "3.1.4"
dependencies = [
"serde_json",
"terminal_size",
@@ -2647,7 +2647,7 @@ checksum = "f6b464fbc74e149a392436b17d523f769e057cb6877f6a5c4618bc6f11800548"
[[package]]
name = "plan2code-app"
version = "3.1.3"
version = "3.1.4"
dependencies = [
"chrono",
"libc",
+1 -1
View File
@@ -1,6 +1,6 @@
[package]
name = "fake-agent"
version = "3.1.3"
version = "3.1.4"
description = "A stand-in agent program for the Plan2Code app's tests"
edition = "2021"
publish = false
+2 -2
View File
@@ -1,12 +1,12 @@
{
"name": "plan2code-app",
"version": "3.1.3",
"version": "3.1.4",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "plan2code-app",
"version": "3.1.3",
"version": "3.1.4",
"dependencies": {
"@tauri-apps/api": "2.12.4",
"@xterm/addon-fit": "0.11.0",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "plan2code-app",
"version": "3.1.3",
"version": "3.1.4",
"private": true,
"description": "Plan2Code desktop app (Tauri). Separate from the repo root so the root and the web console stay dependency-free.",
"scripts": {
+1 -1
View File
@@ -1,6 +1,6 @@
[package]
name = "plan2code-app"
version = "3.1.3"
version = "3.1.4"
description = "Plan2Code desktop app"
edition = "2021"
publish = false
+1 -1
View File
@@ -1,7 +1,7 @@
{
"$schema": "https://schema.tauri.app/config/2",
"productName": "Plan2Code",
"version": "3.1.3",
"version": "3.1.4",
"identifier": "com.plan2code.desktop",
"build": {
"frontendDist": "../ui",
+55
View File
@@ -175,9 +175,18 @@ test("update: prints the version change, one line per piece by name, the release
assert.doesNotMatch(out, /Happy coding|PARAMETERS|To go back to a release/);
});
const LAUNCHER_VERSION = path.join(HOME, ".plan2code", "bin", "version.json");
/** The installed plan2code command's version.json, as installLauncher() writes it. */
function writeLauncherVersion(version) {
fs.mkdirSync(path.dirname(LAUNCHER_VERSION), { recursive: true });
fs.writeFileSync(LAUNCHER_VERSION, JSON.stringify({ name: "Plan2Code", version }));
}
test("update: already on the new version it says so and stops, until --force", async () => {
fs.mkdirSync(path.dirname(RECORD), { recursive: true });
fs.writeFileSync(RECORD, JSON.stringify({ version: VERSION, scope: "global", pieces: ["skills", "launcher"] }));
writeLauncherVersion(VERSION);
const idle = fakeSteps();
const stopped = await runUpdate(idle.steps);
assert.equal(stopped.code, 0, stopped.out);
@@ -202,6 +211,52 @@ test("update: already on the new version it says so and stops, until --force", a
assert.match(out, new RegExp(`Updating ${VERSION.replace(/\./g, "\\.")} -> ${VERSION.replace(/\./g, "\\.")}`));
});
test("update: a record on the new version over an older plan2code command installs again, without --force", async () => {
// An update stopped after the skills step: the record says new, the command is still old.
fs.mkdirSync(path.dirname(RECORD), { recursive: true });
fs.writeFileSync(RECORD, JSON.stringify({ version: VERSION, scope: "global", pieces: ["skills", "launcher"] }));
for (const launcher of ["1.0.0", null]) {
if (launcher) writeLauncherVersion(launcher);
else fs.rmSync(LAUNCHER_VERSION, { force: true });
const fake = fakeSteps();
const { code, out } = await runUpdate(fake.steps);
assert.equal(code, 0, out);
assert.doesNotMatch(out, /Already on/);
assert.match(out, new RegExp(`The plan2code command is still on ${launcher ? "1\\.0\\.0" : "an unknown version"}`));
assert.deepEqual(fake.ran(), ["skills"]);
assert.match(out, /plan2code command: updated/);
}
// A record without the command does not look at its version.json.
fs.writeFileSync(RECORD, JSON.stringify({ version: VERSION, scope: "global", pieces: ["statusline"] }));
const idle = fakeSteps();
assert.match((await runUpdate(idle.steps)).out, /Already on/);
assert.deepEqual(idle.ran(), []);
});
test("update: the record keeps the old version until every piece is in, so a stopped update retries", async () => {
writeRecord(["skills", "launcher", "app"]);
const seen = [];
const fake = fakeSteps();
// As the real steps: each records its piece as it finishes.
for (const piece of ["skills", "app"]) {
const step = fake.steps[piece];
fake.steps[piece] = async (options) => {
const code = await step(options);
installer.recordInstalled(piece);
seen.push(installer.readInstallRecord().version);
return code;
};
}
const { code, out } = await runUpdate(fake.steps);
assert.equal(code, 0, out);
assert.deepEqual(seen, ["1.0.0", "1.0.0"], "mid-update writes keep the old version");
assert.equal(installer.readInstallRecord().version, VERSION, "stamped once the update finished");
assert.deepEqual(installer.readInstallRecord().pieces, ["app", "launcher", "skills"]);
// Outside an update, a record write stamps the version being installed again.
installer.recordInstalled("statusline");
assert.equal(installer.readInstallRecord().version, VERSION);
});
test("update: a step's own output stays out of the summary, except its warnings and its failures", async () => {
writeRecord(["skills", "statusline", "bot"]);
const fake = fakeSteps();
+6 -5
View File
@@ -14,15 +14,16 @@
"install": {
"win": [
{ "label": "PowerShell", "run": "irm https://claude.ai/install.ps1 | iex" },
{ "label": "npm", "run": "npm install -g @anthropic-ai/claude-code", "note": "Needs Node.js 22 or later" }
{ "label": "CMD", "run": "curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd" },
{ "label": "npm", "run": "npm install -g @anthropic-ai/claude-code@latest", "note": "Needs Node.js 22 or later" }
],
"mac": [
{ "label": "Terminal", "run": "curl -fsSL https://claude.ai/install.sh | bash" },
{ "label": "npm", "run": "npm install -g @anthropic-ai/claude-code", "note": "Needs Node.js 22 or later" }
{ "label": "npm", "run": "npm install -g @anthropic-ai/claude-code@latest", "note": "Needs Node.js 22 or later" }
],
"linux": [
{ "label": "Terminal", "run": "curl -fsSL https://claude.ai/install.sh | bash" },
{ "label": "npm", "run": "npm install -g @anthropic-ai/claude-code", "note": "Needs Node.js 22 or later" }
{ "label": "npm", "run": "npm install -g @anthropic-ai/claude-code@latest", "note": "Needs Node.js 22 or later" }
]
},
"installDirs": {
@@ -103,7 +104,7 @@
"name": "OpenCode",
"kind": "template",
"command": "opencode",
"prompt": "Use the plan2code skill",
"prompt": "@plan2code",
"args": ["{model}", "--prompt", "{prompt}"],
"bypassArgs": ["--auto"],
"modelArgs": ["--model", "{model}"]
@@ -117,7 +118,7 @@
"args": ["{model}", "{prompt}"],
"bypassArgs": ["--approval-mode=yolo"],
"modelArgs": ["--model", "{model}"],
"note": "For Google AI Pro and Ultra accounts and free Gemini Code Assist for individuals, Gemini CLI was replaced by Antigravity CLI on June 18, 2026; Standard and Enterprise licenses and paid API keys are unaffected."
"note": "For Google AI Pro and Ultra accounts, free Gemini Code Assist for individuals and Gemini Code Assist for GitHub, Gemini CLI was replaced by Antigravity CLI on June 18, 2026; Standard and Enterprise licenses and paid API keys are unaffected."
},
{
"id": "pi",
+46 -34
View File
@@ -15,7 +15,7 @@
},
{
"id": "haiku",
"label": "latest Haiku"
"label": "fast and efficient Haiku"
},
{
"id": "opusplan",
@@ -23,7 +23,7 @@
},
{
"id": "fable",
"label": "latest Fable"
"label": "Fable for your hardest tasks"
},
{
"id": "best",
@@ -79,22 +79,6 @@
"id": "gpt-6-luna-high",
"label": "GPT-6 Luna High Thinking"
},
{
"id": "gemini-3-8-flash-low",
"label": "Gemini 3.8 Flash Low"
},
{
"id": "gemini-3-8-flash-medium",
"label": "Gemini 3.8 Flash Medium"
},
{
"id": "gemini-3-8-flash-high",
"label": "Gemini 3.8 Flash High"
},
{
"id": "glm-5-3-low",
"label": "GLM-5.3 Low"
},
{
"id": "glm-5-3-high",
"label": "GLM-5.3 High"
@@ -115,18 +99,6 @@
"id": "claude-haiku-5-5-high",
"label": "Claude Haiku 5.5 High"
},
{
"id": "claude-fable-5-1-low",
"label": "Claude Fable 5.1 Low"
},
{
"id": "claude-fable-5-1-medium",
"label": "Claude Fable 5.1 Medium"
},
{
"id": "claude-fable-5-1-high",
"label": "Claude Fable 5.1 High"
},
{
"id": "gpt-6-astra-low",
"label": "GPT-6 Astra Low Thinking"
@@ -139,13 +111,45 @@
"id": "gpt-6-astra-high",
"label": "GPT-6 Astra High Thinking"
},
{
"id": "swe-2-flash-medium",
"label": "SWE-2 Flash Medium"
},
{
"id": "swe-2-flash-high",
"label": "SWE-2 Flash High"
},
{
"id": "claude-fable-5-2-low",
"label": "Claude Fable 5.2 Low"
},
{
"id": "claude-fable-5-2-medium",
"label": "Claude Fable 5.2 Medium"
},
{
"id": "claude-fable-5-2-high",
"label": "Claude Fable 5.2 High"
},
{
"id": "gemini-4-hydrogen-low",
"label": "Gemini 4 Hydrogen Low"
},
{
"id": "gemini-4-hydrogen-medium",
"label": "Gemini 4 Hydrogen Medium"
},
{
"id": "gemini-4-hydrogen-high",
"label": "Gemini 4 Hydrogen High"
},
{
"id": "gemini-4-neon-low",
"label": "Gemini 4 Neon Low"
},
{
"id": "gemini-4-neon-medium",
"label": "Gemini 4 Neon Medium"
},
{
"id": "gemini-4-neon-high",
"label": "Gemini 4 Neon High"
}
],
"codex": [
@@ -164,6 +168,14 @@
{
"id": "gpt-6-luna",
"label": "GPT-6 Luna"
},
{
"id": "gpt-6.2-astra",
"label": "GPT-6.2 Astra"
},
{
"id": "gpt-6.2-sol",
"label": "GPT-6.2 Sol"
}
],
"strengths": {
+2 -2
View File
@@ -1,6 +1,6 @@
{
"name": "Plan2Code",
"version": "3.1.3",
"version": "3.1.4",
"description": "A structured workflow of six steps (Pathfinder, Plan, Document, Implement, Review, Finalize) 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-18",
"releaseDate": "2026-11-20",
"mode": "utility"
}