2026-09-28 19:37:41 -07:00
|
|
|
#!/usr/bin/env node
|
|
|
|
|
'use strict';
|
|
|
|
|
|
|
|
|
|
/**
|
2026-10-08 17:37:10 -07:00
|
|
|
* `plan2code`: open the Plan2Code dashboard skill in Claude Code, Devin or Codex, in the
|
2026-10-08 16:54:18 -07:00
|
|
|
* current directory.
|
2026-09-28 19:37:41 -07:00
|
|
|
*
|
|
|
|
|
* Runs one of:
|
|
|
|
|
* claude /plan2code --permission-mode bypassPermissions [extra args]
|
|
|
|
|
* devin --permission-mode bypass [extra args] -- /plan2code
|
2026-10-08 16:54:18 -07:00
|
|
|
* codex --dangerously-bypass-approvals-and-sandbox [extra args] $plan2code
|
2026-09-28 19:37:41 -07:00
|
|
|
*
|
2026-10-11 16:39:25 -07:00
|
|
|
* Codex starts a skill with `$name` rather than `/name`. When more than one CLI is installed
|
|
|
|
|
* it asks which one, with the last pick as the default; with only one installed it uses that.
|
|
|
|
|
* `--cli claude` / `--cli devin` / `--cli codex` skips the question. Before starting it asks
|
|
|
|
|
* which model to run, from the curated list in models.json (shipped with every install) plus
|
|
|
|
|
* any models the user added in User Preferences; Enter keeps the model the CLI last used, and
|
|
|
|
|
* `--model` (or Codex's `-m`) skips the question. Any other arguments are forwarded to the CLI.
|
|
|
|
|
* Self-contained, Node built-ins only: install.js copies this file to ~/.plan2code/bin/ and
|
|
|
|
|
* points the global shims at it.
|
2026-09-28 19:37:41 -07:00
|
|
|
*
|
|
|
|
|
* `--pick-folder` (passed by the desktop shortcut, never forwarded to the CLI) asks for the
|
|
|
|
|
* project folder with a native folder picker first, starting on the folder picked last time.
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
*
|
2026-10-16 19:28:11 -07:00
|
|
|
* `plan2code update` starts no agent: it re-runs the npx install with `--update`, which
|
|
|
|
|
* reinstalls whatever ~/.plan2code/install.json lists. Before an agent starts, one line says
|
|
|
|
|
* when a newer release is out (releaseNotice), read from the web console's cached release check
|
|
|
|
|
* and never waiting on the network.
|
|
|
|
|
*
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
* On a terminal it opens with a Planny banner (renderBanner) and colors its headings, numbers,
|
|
|
|
|
* defaults and errors (paint). Color is on only on a TTY (stdout and stderr each checked on
|
|
|
|
|
* its own) with NO_COLOR unset; piped runs print plain text and no banner.
|
2026-09-28 19:37:41 -07:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
const { spawn, spawnSync } = require('child_process');
|
|
|
|
|
const fs = require('fs');
|
|
|
|
|
const os = require('os');
|
|
|
|
|
const path = require('path');
|
|
|
|
|
const readline = require('readline');
|
|
|
|
|
|
|
|
|
|
const IS_WINDOWS = process.platform === 'win32';
|
|
|
|
|
const IS_MAC = process.platform === 'darwin';
|
|
|
|
|
const PICK_FOLDER_FLAG = '--pick-folder';
|
|
|
|
|
const CLI_FLAG = '--cli';
|
|
|
|
|
const STATE_FILE = path.join(os.homedir(), '.plan2code', 'launcher.json');
|
2026-10-02 20:51:34 -07:00
|
|
|
// Menus longer than this print compactly (id-only, two columns).
|
|
|
|
|
const MODELS_MENU_COMPACT_AT = 30;
|
2026-09-28 19:37:41 -07:00
|
|
|
const PICKER_PROMPT = 'Choose the project folder to open Plan2Code in';
|
2026-10-16 19:28:11 -07:00
|
|
|
const UPDATE_COMMAND = 'update';
|
|
|
|
|
// The same URL src/web-console/update-check.mjs exports as REPO_URL. This file may require
|
|
|
|
|
// nothing but Node built-ins (and update-check.mjs is ESM), so it keeps its own copy.
|
|
|
|
|
const REPO_URL = 'https://github.com/jparkerweb/plan2code.git';
|
|
|
|
|
// The web console's cached release check, and how long it counts as fresh (update-check.mjs
|
2026-10-18 15:39:24 -07:00
|
|
|
// CACHE_MS). PLAN2CODE_CONSOLE_HOME moves the console's files, as in files.mjs.
|
2026-10-16 19:28:11 -07:00
|
|
|
const CONSOLE_HOME = process.env.PLAN2CODE_CONSOLE_HOME || path.join(os.homedir(), '.plan2code', 'console');
|
|
|
|
|
const UPDATE_CACHE_FILE = path.join(CONSOLE_HOME, 'update-check.json');
|
|
|
|
|
const UPDATE_CACHE_MS = 60 * 60 * 1000;
|
2026-09-28 19:37:41 -07:00
|
|
|
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
// The escape values install.js's COLORS uses, copied: this file is installed alone and may
|
|
|
|
|
// require nothing but Node built-ins.
|
|
|
|
|
const ANSI = {
|
|
|
|
|
reset: '\x1b[0m',
|
|
|
|
|
bright: '\x1b[1m',
|
|
|
|
|
dim: '\x1b[2m',
|
|
|
|
|
cyan: '\x1b[36m',
|
|
|
|
|
green: '\x1b[32m',
|
|
|
|
|
yellow: '\x1b[33m',
|
|
|
|
|
red: '\x1b[31m',
|
|
|
|
|
magenta: '\x1b[35m',
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/** Wrappers that color text when `useColor` is true and return it plain otherwise. */
|
|
|
|
|
function paint(useColor) {
|
|
|
|
|
const wrap = (code) => (text) => (useColor ? code + text + ANSI.reset : String(text));
|
|
|
|
|
return {
|
|
|
|
|
bright: wrap(ANSI.bright),
|
|
|
|
|
dim: wrap(ANSI.dim),
|
|
|
|
|
cyan: wrap(ANSI.cyan),
|
|
|
|
|
green: wrap(ANSI.green),
|
|
|
|
|
yellow: wrap(ANSI.yellow),
|
|
|
|
|
red: wrap(ANSI.red),
|
|
|
|
|
magenta: wrap(ANSI.magenta),
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// Color only on a real terminal, and never when NO_COLOR is set to anything. Each stream
|
|
|
|
|
// asks for itself: `plan2code 2> err.log` from a terminal still logs plain errors.
|
|
|
|
|
const useColor = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
|
|
|
|
|
const c = paint(useColor);
|
|
|
|
|
const ce = paint(Boolean(process.stderr.isTTY) && !process.env.NO_COLOR);
|
|
|
|
|
|
|
|
|
|
// Planny waving hello, as install.js's MASCOT.wave draws him.
|
|
|
|
|
const MASCOT = [
|
|
|
|
|
' ╭───╮ ',
|
|
|
|
|
' │ ★ │╱ ',
|
|
|
|
|
' ╱│ ◡ │ ',
|
|
|
|
|
' ╰┬─┬╯ ',
|
|
|
|
|
];
|
|
|
|
|
|
|
|
|
|
/** Planny with the name and tagline beside his face; colored only through `p`. No trailing newline. */
|
|
|
|
|
function renderBanner(p) {
|
|
|
|
|
const beside = { 1: p.bright(p.cyan('Plan2Code')), 2: p.dim('Plan it, build it, ship it — with your AI agent.') };
|
|
|
|
|
return MASCOT.map((row, i) => (beside[i] ? `${p.magenta(row)} ${beside[i]}` : p.magenta(row))).join('\n');
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** The banner, on a terminal only: piped runs print exactly what they always have. */
|
|
|
|
|
function printIntro() {
|
|
|
|
|
if (!process.stdout.isTTY) return;
|
|
|
|
|
console.log('');
|
|
|
|
|
console.log(renderBanner(c));
|
|
|
|
|
console.log('');
|
|
|
|
|
}
|
|
|
|
|
|
2026-09-28 19:37:41 -07:00
|
|
|
/** The CLIs that can open the dashboard, in menu order. `args` builds the full argument list. */
|
|
|
|
|
const CLIS = [
|
|
|
|
|
{
|
|
|
|
|
id: 'claude',
|
|
|
|
|
label: 'Claude Code',
|
2026-10-11 16:39:25 -07:00
|
|
|
install: 'npm i -g @anthropic-ai/claude-code',
|
|
|
|
|
prompt: '/plan2code',
|
2026-09-28 19:37:41 -07:00
|
|
|
args: (extra) => ['/plan2code', '--permission-mode', 'bypassPermissions', ...extra],
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
id: 'devin',
|
|
|
|
|
label: 'Devin',
|
2026-10-11 16:39:25 -07:00
|
|
|
install: 'https://devin.ai',
|
|
|
|
|
prompt: '/plan2code',
|
2026-09-28 19:37:41 -07:00
|
|
|
args: (extra) => ['--permission-mode', 'bypass', ...extra, '--', '/plan2code'],
|
|
|
|
|
},
|
2026-10-08 16:54:18 -07:00
|
|
|
{
|
|
|
|
|
id: 'codex',
|
|
|
|
|
label: 'Codex',
|
2026-10-11 16:39:25 -07:00
|
|
|
install: 'npm i -g @openai/codex',
|
|
|
|
|
prompt: '$plan2code',
|
2026-10-08 16:54:18 -07:00
|
|
|
// Codex mentions a skill with `$name`; the prompt is its one positional argument.
|
|
|
|
|
args: (extra) => ['--dangerously-bypass-approvals-and-sandbox', ...extra, '$plan2code'],
|
|
|
|
|
},
|
2026-09-28 19:37:41 -07:00
|
|
|
];
|
|
|
|
|
|
2026-10-08 16:54:18 -07:00
|
|
|
/** What to do when no agent is installed: how to get one and how to run the skill from it. */
|
|
|
|
|
const SKILL_STEPS = [
|
|
|
|
|
'Plan2Code runs inside an AI coding agent. To use it:',
|
|
|
|
|
' 1. Install one: Claude Code (npm i -g @anthropic-ai/claude-code), Codex (npm i -g @openai/codex) or Devin (https://devin.ai).',
|
|
|
|
|
' 2. Open a new terminal and cd into the project you want to work on.',
|
|
|
|
|
' 3. Start your agent there, then type /plan2code (Claude Code, Devin) or $plan2code (Codex).',
|
|
|
|
|
];
|
|
|
|
|
|
2026-10-11 16:39:25 -07:00
|
|
|
/** The CLI ids as prose: "`claude`, `devin` or `codex`", or without the backticks for `quote` ''. */
|
|
|
|
|
function cliIdList(quote = '`') {
|
|
|
|
|
const ids = CLIS.map((cli) => quote + cli.id + quote);
|
2026-10-08 16:54:18 -07:00
|
|
|
return `${ids.slice(0, -1).join(', ')} or ${ids[ids.length - 1]}`;
|
|
|
|
|
}
|
|
|
|
|
|
2026-10-02 20:51:34 -07:00
|
|
|
// The curated menu ships beside this file (models.json, overwritten by every install); models
|
|
|
|
|
// the user adds in User Preferences live in ~/.plan2code/models.json and are merged in.
|
|
|
|
|
const SHIPPED_MODELS_FILE = path.join(__dirname, 'models.json');
|
|
|
|
|
const USER_MODELS_FILE = path.join(os.homedir(), '.plan2code', 'models.json');
|
|
|
|
|
|
2026-09-28 19:37:41 -07:00
|
|
|
/**
|
|
|
|
|
* The Explorer-style folder picker (IFileOpenDialog with FOS_PICKFOLDERS): address bar, paste a
|
|
|
|
|
* path, Quick Access, search. Windows PowerShell's FolderBrowserDialog is the old tree-only
|
|
|
|
|
* dialog, and Windows ships no other way to reach this one from a script, so it is compiled
|
|
|
|
|
* with Add-Type. Only the IFileOpenDialog methods up to GetResult are declared: the vtable
|
|
|
|
|
* slots after the last one called don't need to be.
|
|
|
|
|
*/
|
|
|
|
|
const WINDOWS_PICKER_SOURCE = `
|
|
|
|
|
using System;
|
|
|
|
|
using System.Runtime.InteropServices;
|
2026-10-02 20:51:34 -07:00
|
|
|
using System.Threading;
|
2026-09-28 19:37:41 -07:00
|
|
|
|
|
|
|
|
public static class Plan2CodeFolderPicker {
|
|
|
|
|
[ComImport, Guid("DC1C5A9C-E88A-4DDE-A5A1-60F82A20AEF7")]
|
|
|
|
|
private class FileOpenDialog {}
|
|
|
|
|
|
|
|
|
|
[ComImport, Guid("42F85136-DB7E-439C-85F1-E4075D135FC8"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
|
|
|
|
|
private interface IFileOpenDialog {
|
|
|
|
|
[PreserveSig] int Show(IntPtr owner);
|
|
|
|
|
void SetFileTypes(uint count, IntPtr specs);
|
|
|
|
|
void SetFileTypeIndex(uint index);
|
|
|
|
|
void GetFileTypeIndex(out uint index);
|
|
|
|
|
void Advise(IntPtr events, out uint cookie);
|
|
|
|
|
void Unadvise(uint cookie);
|
|
|
|
|
void SetOptions(uint options);
|
|
|
|
|
void GetOptions(out uint options);
|
|
|
|
|
void SetDefaultFolder(IShellItem item);
|
|
|
|
|
void SetFolder(IShellItem item);
|
|
|
|
|
void GetFolder(out IShellItem item);
|
|
|
|
|
void GetCurrentSelection(out IShellItem item);
|
|
|
|
|
void SetFileName([MarshalAs(UnmanagedType.LPWStr)] string name);
|
|
|
|
|
void GetFileName([MarshalAs(UnmanagedType.LPWStr)] out string name);
|
|
|
|
|
void SetTitle([MarshalAs(UnmanagedType.LPWStr)] string title);
|
|
|
|
|
void SetOkButtonLabel([MarshalAs(UnmanagedType.LPWStr)] string label);
|
|
|
|
|
void SetFileNameLabel([MarshalAs(UnmanagedType.LPWStr)] string label);
|
|
|
|
|
void GetResult(out IShellItem item);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
[ComImport, Guid("43826D1E-E718-42EE-BC55-A1E261C37BFE"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
|
|
|
|
|
private interface IShellItem {
|
|
|
|
|
void BindToHandler(IntPtr bindContext, ref Guid handler, ref Guid iid, out IntPtr result);
|
|
|
|
|
void GetParent(out IShellItem parent);
|
|
|
|
|
void GetDisplayName(uint form, [MarshalAs(UnmanagedType.LPWStr)] out string name);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
[DllImport("shell32.dll", CharSet = CharSet.Unicode, PreserveSig = false)]
|
|
|
|
|
private static extern void SHCreateItemFromParsingName(string path, IntPtr bindContext, ref Guid iid, out IShellItem item);
|
|
|
|
|
|
2026-10-02 20:51:34 -07:00
|
|
|
[DllImport("user32.dll", CharSet = CharSet.Unicode)]
|
|
|
|
|
private static extern IntPtr FindWindow(string className, string title);
|
|
|
|
|
|
|
|
|
|
[DllImport("user32.dll")]
|
|
|
|
|
private static extern bool SetWindowPos(IntPtr hWnd, IntPtr after, int x, int y, int w, int h, uint flags);
|
|
|
|
|
|
|
|
|
|
[DllImport("user32.dll")]
|
|
|
|
|
private static extern bool SetForegroundWindow(IntPtr hWnd);
|
|
|
|
|
|
|
|
|
|
[DllImport("user32.dll")]
|
|
|
|
|
private static extern int GetSystemMetrics(int index);
|
|
|
|
|
|
2026-10-19 15:56:52 -07:00
|
|
|
[DllImport("user32.dll")]
|
|
|
|
|
private static extern bool IsWindowVisible(IntPtr hWnd);
|
|
|
|
|
|
|
|
|
|
[DllImport("user32.dll")]
|
|
|
|
|
private static extern IntPtr GetForegroundWindow();
|
|
|
|
|
|
|
|
|
|
[DllImport("user32.dll")]
|
|
|
|
|
private static extern void SwitchToThisWindow(IntPtr hWnd, bool altTab);
|
|
|
|
|
|
|
|
|
|
[DllImport("user32.dll")]
|
|
|
|
|
private static extern void keybd_event(byte vk, byte scan, uint flags, UIntPtr extra);
|
|
|
|
|
|
2026-09-28 19:37:41 -07:00
|
|
|
private const uint FOS_PICKFOLDERS = 0x20;
|
|
|
|
|
private const uint FOS_FORCEFILESYSTEM = 0x40;
|
|
|
|
|
private const uint FOS_PATHMUSTEXIST = 0x800;
|
|
|
|
|
private const uint SIGDN_FILESYSPATH = 0x80058000;
|
|
|
|
|
private const int ERROR_CANCELLED = unchecked((int)0x800704C7);
|
|
|
|
|
|
2026-10-19 15:56:52 -07:00
|
|
|
// Windows refuses SetForegroundWindow from a background process (this one is spawned
|
|
|
|
|
// by the detached console server), so the dialog opened behind the browser. A tap of
|
|
|
|
|
// Alt counts as input from this process and lifts the lock for the call after it. The
|
|
|
|
|
// topmost flag below is ignored by this dialog (SetWindowPos succeeds, the bit stays
|
|
|
|
|
// off), so taking the foreground is what puts it in front.
|
2026-10-02 20:51:34 -07:00
|
|
|
private static void Raise(string title) {
|
2026-10-19 15:56:52 -07:00
|
|
|
IntPtr hwnd = IntPtr.Zero;
|
|
|
|
|
for (int i = 0; i < 200; i++) {
|
|
|
|
|
hwnd = FindWindow(null, title);
|
|
|
|
|
if (hwnd != IntPtr.Zero && IsWindowVisible(hwnd)) break;
|
|
|
|
|
hwnd = IntPtr.Zero;
|
2026-10-02 20:51:34 -07:00
|
|
|
Thread.Sleep(50);
|
|
|
|
|
}
|
2026-10-19 15:56:52 -07:00
|
|
|
if (hwnd == IntPtr.Zero) return;
|
|
|
|
|
int w = Math.Min(1100, GetSystemMetrics(0) - 80);
|
|
|
|
|
int h = Math.Min(750, GetSystemMetrics(1) - 80);
|
|
|
|
|
int x = (GetSystemMetrics(0) - w) / 2 + 40;
|
|
|
|
|
int y = (GetSystemMetrics(1) - h) / 2 + 40;
|
|
|
|
|
SetWindowPos(hwnd, new IntPtr(-1), x, y, w, h, 0x40);
|
|
|
|
|
for (int i = 0; i < 20 && GetForegroundWindow() != hwnd; i++) {
|
|
|
|
|
keybd_event(0x12, 0, 0, UIntPtr.Zero);
|
|
|
|
|
keybd_event(0x12, 0, 2, UIntPtr.Zero);
|
|
|
|
|
SetForegroundWindow(hwnd);
|
|
|
|
|
SwitchToThisWindow(hwnd, true);
|
|
|
|
|
Thread.Sleep(100);
|
|
|
|
|
}
|
2026-10-02 20:51:34 -07:00
|
|
|
}
|
|
|
|
|
|
2026-09-28 19:37:41 -07:00
|
|
|
public static string Pick(IntPtr owner, string title, string start) {
|
|
|
|
|
IFileOpenDialog dialog = (IFileOpenDialog)new FileOpenDialog();
|
|
|
|
|
try {
|
|
|
|
|
uint options;
|
|
|
|
|
dialog.GetOptions(out options);
|
|
|
|
|
dialog.SetOptions(options | FOS_PICKFOLDERS | FOS_FORCEFILESYSTEM | FOS_PATHMUSTEXIST);
|
|
|
|
|
dialog.SetTitle(title);
|
|
|
|
|
if (!string.IsNullOrEmpty(start)) {
|
|
|
|
|
try {
|
|
|
|
|
Guid iid = typeof(IShellItem).GUID;
|
|
|
|
|
IShellItem folder;
|
|
|
|
|
SHCreateItemFromParsingName(start, IntPtr.Zero, ref iid, out folder);
|
|
|
|
|
dialog.SetFolder(folder);
|
|
|
|
|
} catch (Exception) {}
|
|
|
|
|
}
|
2026-10-02 20:51:34 -07:00
|
|
|
Thread raiser = new Thread(delegate() { Raise(title); });
|
|
|
|
|
raiser.IsBackground = true;
|
|
|
|
|
raiser.Start();
|
2026-09-28 19:37:41 -07:00
|
|
|
int hr = dialog.Show(owner);
|
|
|
|
|
if (hr == ERROR_CANCELLED) return null;
|
|
|
|
|
Marshal.ThrowExceptionForHR(hr);
|
|
|
|
|
IShellItem result;
|
|
|
|
|
dialog.GetResult(out result);
|
|
|
|
|
string path;
|
|
|
|
|
result.GetDisplayName(SIGDN_FILESYSPATH, out path);
|
|
|
|
|
return path;
|
|
|
|
|
} finally {
|
|
|
|
|
Marshal.ReleaseComObject(dialog);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
`;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Resolve a command on PATH the way the shell would, including PATHEXT on Windows.
|
|
|
|
|
* Returns the full path, or null when it is not installed.
|
|
|
|
|
*/
|
|
|
|
|
function findOnPath(command) {
|
|
|
|
|
const dirs = (process.env.PATH || '').split(path.delimiter).filter(Boolean);
|
|
|
|
|
const extensions = IS_WINDOWS
|
|
|
|
|
? (process.env.PATHEXT || '.EXE;.CMD;.BAT;.COM').split(';').filter(Boolean)
|
|
|
|
|
: [''];
|
|
|
|
|
|
|
|
|
|
for (const dir of dirs) {
|
|
|
|
|
for (const ext of extensions) {
|
|
|
|
|
const candidate = path.join(dir.replace(/^"|"$/g, ''), command + ext);
|
|
|
|
|
try {
|
|
|
|
|
if (fs.statSync(candidate).isFile()) return candidate;
|
|
|
|
|
} catch {}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Quote one argument for cmd.exe. Only needed when the CLI is a .cmd/.bat wrapper, which Node
|
|
|
|
|
* refuses to spawn without a shell.
|
|
|
|
|
*/
|
|
|
|
|
function quoteForCmd(arg) {
|
|
|
|
|
if (arg && !/[\s"&|<>^%!()]/.test(arg)) return arg;
|
|
|
|
|
return `"${arg.replace(/"/g, '""')}"`;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function isDirectory(dir) {
|
|
|
|
|
try {
|
|
|
|
|
return fs.statSync(dir).isDirectory();
|
|
|
|
|
} catch {
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** `~/.plan2code/launcher.json`: `{ lastFolder, lastCli }`, either key possibly missing. */
|
|
|
|
|
function readState() {
|
|
|
|
|
try {
|
|
|
|
|
const state = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
|
|
|
|
|
if (state && typeof state === 'object') return state;
|
|
|
|
|
} catch {}
|
|
|
|
|
return {};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** Merge `changes` into the state file, keeping the keys it does not name. */
|
|
|
|
|
function saveState(changes) {
|
|
|
|
|
try {
|
|
|
|
|
fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true });
|
|
|
|
|
fs.writeFileSync(STATE_FILE, JSON.stringify({ ...readState(), ...changes }, null, 2) + '\n');
|
|
|
|
|
} catch {}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function readLastFolder() {
|
|
|
|
|
const { lastFolder } = readState();
|
|
|
|
|
return lastFolder && isDirectory(lastFolder) ? lastFolder : os.homedir();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function ask(prompt) {
|
|
|
|
|
const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
|
|
|
|
|
// readline swallows Ctrl+C while it owns the terminal; treat it as leaving.
|
|
|
|
|
rl.on('SIGINT', () => {
|
|
|
|
|
rl.close();
|
|
|
|
|
process.stdout.write('\n');
|
|
|
|
|
process.exit(130);
|
|
|
|
|
});
|
|
|
|
|
return new Promise((resolve) =>
|
|
|
|
|
rl.question(prompt, (answer) => {
|
|
|
|
|
rl.close();
|
|
|
|
|
resolve(answer);
|
|
|
|
|
})
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Split `--cli <name>` / `--cli=<name>` out of the arguments. Returns `{ cli, rest }`; `cli` is
|
|
|
|
|
* undefined when the flag is absent and '' when it has no value.
|
|
|
|
|
*/
|
|
|
|
|
function takeCliFlag(argv) {
|
|
|
|
|
const rest = [];
|
|
|
|
|
let cli;
|
|
|
|
|
for (let i = 0; i < argv.length; i++) {
|
|
|
|
|
const arg = argv[i];
|
|
|
|
|
if (arg === CLI_FLAG) {
|
|
|
|
|
cli = (argv[++i] || '').toLowerCase();
|
|
|
|
|
} else if (arg.startsWith(`${CLI_FLAG}=`)) {
|
|
|
|
|
cli = arg.slice(CLI_FLAG.length + 1).toLowerCase();
|
|
|
|
|
} else {
|
|
|
|
|
rest.push(arg);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
return { cli, rest };
|
|
|
|
|
}
|
|
|
|
|
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
/** With no menu to show, say which CLI is opening, on a terminal only. */
|
|
|
|
|
function announceCli(cli) {
|
|
|
|
|
if (process.stdout.isTTY) console.log(c.dim(`Opening with ${cli.label}…`));
|
|
|
|
|
}
|
|
|
|
|
|
2026-09-28 19:37:41 -07:00
|
|
|
/**
|
|
|
|
|
* Choose the CLI from those installed: the `--cli` pick, the only one installed, or a numbered
|
|
|
|
|
* menu defaulting to the last pick. Returns `{ cli }` with its resolved `path`, or `{ code }` (the
|
|
|
|
|
* exit code) after printing why none can be used.
|
|
|
|
|
*/
|
|
|
|
|
async function chooseCli(requested) {
|
|
|
|
|
const installed = CLIS.map((cli) => ({ ...cli, path: findOnPath(cli.id) })).filter((cli) => cli.path);
|
|
|
|
|
|
|
|
|
|
if (requested !== undefined) {
|
|
|
|
|
const known = CLIS.find((cli) => cli.id === requested);
|
|
|
|
|
if (!known) {
|
2026-10-11 16:39:25 -07:00
|
|
|
console.error(`${ce.red('plan2code:')} --cli takes ${cliIdList('')}${requested ? `, not "${requested}"` : ''}.`);
|
2026-09-28 19:37:41 -07:00
|
|
|
return { code: 2 };
|
|
|
|
|
}
|
|
|
|
|
const found = installed.find((cli) => cli.id === requested);
|
|
|
|
|
if (!found) {
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.error(`${ce.red('plan2code:')} the \`${known.id}\` CLI was not found on your PATH.`);
|
2026-10-11 16:39:25 -07:00
|
|
|
console.error('');
|
|
|
|
|
console.error(`To use ${known.label}:`);
|
|
|
|
|
console.error(` 1. Install it: ${known.install}`);
|
|
|
|
|
console.error(' 2. Open a new terminal and cd into the project you want to work on.');
|
|
|
|
|
console.error(` 3. Run \`plan2code --cli ${known.id}\` there, or start ${known.label} and type ${known.prompt}.`);
|
2026-09-28 19:37:41 -07:00
|
|
|
}
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
if (found) announceCli(found);
|
2026-09-28 19:37:41 -07:00
|
|
|
return found ? { cli: found } : { code: 127 };
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (installed.length === 0) {
|
2026-10-08 16:54:18 -07:00
|
|
|
console.error(`${ce.red('plan2code:')} none of ${cliIdList()} was found on your PATH.`);
|
|
|
|
|
console.error('');
|
|
|
|
|
for (const step of SKILL_STEPS) console.error(step);
|
|
|
|
|
console.error('');
|
|
|
|
|
console.error('Already have an agent? Open it in your project and type /plan2code ($plan2code in Codex), or install it and run `plan2code` again.');
|
2026-09-28 19:37:41 -07:00
|
|
|
return { code: 127 };
|
|
|
|
|
}
|
|
|
|
|
if (installed.length === 1 || !process.stdin.isTTY) {
|
|
|
|
|
const { lastCli } = readState();
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
const cli = installed.find((cli) => cli.id === lastCli) || installed[0];
|
|
|
|
|
if (installed.length === 1) announceCli(cli);
|
|
|
|
|
return { cli };
|
2026-09-28 19:37:41 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
const { lastCli } = readState();
|
|
|
|
|
const defaultIndex = Math.max(0, installed.findIndex((cli) => cli.id === lastCli));
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.log(c.bright('Plan2Code opens inside an AI coding agent. Pick which one to use:'));
|
|
|
|
|
console.log('');
|
|
|
|
|
installed.forEach((cli, i) =>
|
|
|
|
|
console.log(` ${c.cyan(`${i + 1})`)} ${cli.label}${cli.id === lastCli ? ` ${c.dim('(last used)')}` : ''}`)
|
|
|
|
|
);
|
2026-10-11 16:39:25 -07:00
|
|
|
console.log(c.dim('You can also skip this launcher and run `/plan2code` (`$plan2code` in Codex) straight from your agent.'));
|
2026-09-28 19:37:41 -07:00
|
|
|
for (;;) {
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
const answer = (await ask(`Choice ${c.green(`[${defaultIndex + 1}]`)}: `)).trim().toLowerCase();
|
2026-09-28 19:37:41 -07:00
|
|
|
if (!answer) return { cli: installed[defaultIndex] };
|
|
|
|
|
const byNumber = installed[Number(answer) - 1];
|
|
|
|
|
const byName = installed.find((cli) => cli.id === answer || cli.label.toLowerCase() === answer);
|
|
|
|
|
if (/^\d+$/.test(answer) && byNumber) return { cli: byNumber };
|
|
|
|
|
if (byName) return { cli: byName };
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.log(c.yellow(`Type a number from 1 to ${installed.length}, or press Enter for ${installed[defaultIndex].label}.`));
|
2026-09-28 19:37:41 -07:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-10-11 16:39:25 -07:00
|
|
|
/**
|
|
|
|
|
* True when the forwarded arguments already pick a model: `--model <name>` / `--model=<name>`,
|
|
|
|
|
* and for Codex also its short form, `-m <name>` / `-m=<name>` / `-m<name>`.
|
|
|
|
|
*/
|
|
|
|
|
function hasModelFlag(args, cliId) {
|
|
|
|
|
return args.some(
|
|
|
|
|
(arg) =>
|
|
|
|
|
arg === '--model' ||
|
|
|
|
|
arg.startsWith('--model=') ||
|
|
|
|
|
(cliId === 'codex' && arg.startsWith('-m'))
|
|
|
|
|
);
|
2026-09-28 19:37:41 -07:00
|
|
|
}
|
|
|
|
|
|
2026-10-02 20:51:34 -07:00
|
|
|
/** `[{ id, label }]` from a parsed models file for one CLI; anything malformed is skipped. */
|
|
|
|
|
function modelEntries(file, cliId) {
|
|
|
|
|
const list = file && Array.isArray(file[cliId]) ? file[cliId] : [];
|
|
|
|
|
return list.filter((m) => m && typeof m.id === 'string' && m.id.trim() && typeof m.label === 'string');
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** The shipped list first, then the user's additions the shipped list does not already have. */
|
|
|
|
|
function mergeModels(shipped, user) {
|
|
|
|
|
const seen = new Set(shipped.map((m) => m.id));
|
|
|
|
|
return [...shipped, ...user.filter((m) => !seen.has(m.id) && seen.add(m.id))];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function readJsonFile(file) {
|
|
|
|
|
try {
|
|
|
|
|
return JSON.parse(fs.readFileSync(file, 'utf8'));
|
|
|
|
|
} catch {
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** The model menu for one CLI: the curated list plus the user's additions from User Preferences. */
|
|
|
|
|
function listModels(cli) {
|
|
|
|
|
return mergeModels(
|
|
|
|
|
modelEntries(readJsonFile(SHIPPED_MODELS_FILE), cli.id),
|
|
|
|
|
modelEntries(readJsonFile(USER_MODELS_FILE), cli.id)
|
|
|
|
|
);
|
|
|
|
|
}
|
|
|
|
|
|
2026-09-28 19:37:41 -07:00
|
|
|
/**
|
2026-10-02 20:51:34 -07:00
|
|
|
* Ask which model to run: a numbered list with Enter keeping the model the CLI last used.
|
|
|
|
|
* A pick appends `--model <id>` to `extraArgs`. Without an interactive terminal there is
|
|
|
|
|
* nobody to ask, so it just says which model will be used, as it always has.
|
2026-09-28 19:37:41 -07:00
|
|
|
*/
|
2026-10-02 20:51:34 -07:00
|
|
|
async function chooseModel(cli, extraArgs) {
|
|
|
|
|
if (!process.stdin.isTTY) {
|
|
|
|
|
console.log(`${cli.label} will use the model you last used in it. To use a different model, open`);
|
|
|
|
|
console.log(`\`${cli.id}\` on its own and switch model there, or run \`plan2code --model <name>\`.`);
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
const models = listModels(cli);
|
|
|
|
|
if (!models.length) return;
|
|
|
|
|
|
2026-09-28 19:37:41 -07:00
|
|
|
console.log('');
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.log(c.bright(`Which model should ${cli.label} use?`));
|
2026-10-02 20:51:34 -07:00
|
|
|
if (models.length > MODELS_MENU_COMPACT_AT) {
|
|
|
|
|
// Labels off, ids in two columns: a long menu of full rows would bury
|
|
|
|
|
// the prompt above the fold.
|
|
|
|
|
const half = Math.ceil(models.length / 2);
|
|
|
|
|
for (let i = 0; i < half; i++) {
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
// Padded before coloring, so the escape codes never count toward the column width.
|
|
|
|
|
const left = ` ${i + 1}) ${models[i].id}`.padEnd(48);
|
|
|
|
|
const right = models[i + half] ? ` ${c.cyan(`${i + half + 1})`)} ${models[i + half].id}` : '';
|
|
|
|
|
console.log(left.replace(`${i + 1})`, c.cyan(`${i + 1})`)) + right);
|
2026-10-02 20:51:34 -07:00
|
|
|
}
|
|
|
|
|
} else {
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
models.forEach((model, i) => console.log(` ${c.cyan(`${i + 1})`)} ${model.id} — ${model.label}`));
|
2026-10-02 20:51:34 -07:00
|
|
|
}
|
|
|
|
|
for (;;) {
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
const answer = (await ask(`Choice ${c.green('[keep last used]')}: `)).trim().toLowerCase();
|
2026-10-02 20:51:34 -07:00
|
|
|
if (!answer) return;
|
|
|
|
|
const byNumber = models[Number(answer) - 1];
|
|
|
|
|
const byName = models.find((model) => model.id === answer || model.label.toLowerCase() === answer);
|
|
|
|
|
const model = (/^\d+$/.test(answer) && byNumber) || byName;
|
|
|
|
|
if (model) {
|
|
|
|
|
extraArgs.push('--model', model.id);
|
|
|
|
|
return;
|
|
|
|
|
}
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.log(c.yellow(`Type a number from 1 to ${models.length}, a model name, or press Enter to keep the last-used model.`));
|
2026-10-02 20:51:34 -07:00
|
|
|
}
|
2026-09-28 19:37:41 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* The native folder picker for this OS, as a command to run: it prints the chosen folder, or
|
|
|
|
|
* nothing when the person cancels. Null when this OS has no picker we can drive.
|
|
|
|
|
*/
|
|
|
|
|
function getPickerCommand(start) {
|
|
|
|
|
if (IS_WINDOWS) {
|
|
|
|
|
const script = [
|
|
|
|
|
"$ErrorActionPreference = 'Stop'",
|
|
|
|
|
'try {',
|
|
|
|
|
' [Console]::OutputEncoding = [Text.Encoding]::UTF8',
|
|
|
|
|
' Add-Type -AssemblyName System.Windows.Forms',
|
|
|
|
|
' [System.Windows.Forms.Application]::EnableVisualStyles()',
|
|
|
|
|
// A TopMost owner keeps the dialog in front of the console window that launched it.
|
|
|
|
|
' $owner = New-Object System.Windows.Forms.Form -Property @{ TopMost = $true; ShowInTaskbar = $false }',
|
|
|
|
|
' try {',
|
|
|
|
|
' Add-Type -TypeDefinition $env:PLAN2CODE_PICKER_SOURCE',
|
|
|
|
|
' $picked = [Plan2CodeFolderPicker]::Pick($owner.Handle, $env:PLAN2CODE_PICKER_PROMPT, $env:PLAN2CODE_PICKER_START)',
|
|
|
|
|
' } catch {',
|
|
|
|
|
// Add-Type is blocked under Constrained Language Mode and some AppLocker policies; the
|
|
|
|
|
// old tree dialog still works there.
|
|
|
|
|
' $dialog = New-Object System.Windows.Forms.FolderBrowserDialog',
|
|
|
|
|
' $dialog.Description = $env:PLAN2CODE_PICKER_PROMPT',
|
|
|
|
|
' $dialog.SelectedPath = $env:PLAN2CODE_PICKER_START',
|
|
|
|
|
' $picked = if ($dialog.ShowDialog($owner) -eq [System.Windows.Forms.DialogResult]::OK) { $dialog.SelectedPath } else { $null }',
|
|
|
|
|
' }',
|
|
|
|
|
' if ($picked) { $picked }',
|
|
|
|
|
'} catch { exit 3 }',
|
|
|
|
|
].join('\n');
|
|
|
|
|
return {
|
|
|
|
|
command: 'powershell.exe',
|
|
|
|
|
args: ['-NoProfile', '-NonInteractive', '-STA', '-ExecutionPolicy', 'Bypass', '-EncodedCommand', Buffer.from(script, 'utf16le').toString('base64')],
|
|
|
|
|
env: { PLAN2CODE_PICKER_PROMPT: PICKER_PROMPT, PLAN2CODE_PICKER_START: start, PLAN2CODE_PICKER_SOURCE: WINDOWS_PICKER_SOURCE },
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (IS_MAC) {
|
|
|
|
|
return {
|
|
|
|
|
command: 'osascript',
|
|
|
|
|
args: [
|
|
|
|
|
'-e', 'on run argv',
|
|
|
|
|
'-e', `POSIX path of (choose folder with prompt "${PICKER_PROMPT}" default location (POSIX file (item 1 of argv)))`,
|
|
|
|
|
'-e', 'end run',
|
|
|
|
|
start,
|
|
|
|
|
],
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (!process.env.DISPLAY && !process.env.WAYLAND_DISPLAY) return null;
|
|
|
|
|
if (findOnPath('zenity')) {
|
|
|
|
|
return { command: 'zenity', args: ['--file-selection', '--directory', `--title=${PICKER_PROMPT}`, `--filename=${start}${path.sep}`] };
|
|
|
|
|
}
|
|
|
|
|
if (findOnPath('kdialog')) {
|
|
|
|
|
return { command: 'kdialog', args: ['--title', PICKER_PROMPT, '--getexistingdirectory', start] };
|
|
|
|
|
}
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Ask for the project folder: the native picker when there is one, a typed path otherwise.
|
|
|
|
|
* Returns the folder, or null when the person cancelled.
|
|
|
|
|
*/
|
|
|
|
|
async function pickFolder() {
|
|
|
|
|
const start = readLastFolder();
|
|
|
|
|
const picker = getPickerCommand(start);
|
|
|
|
|
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.log('');
|
2026-09-28 19:37:41 -07:00
|
|
|
if (picker) {
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.log(c.dim('Pick a project folder in the window that just opened...'));
|
2026-09-28 19:37:41 -07:00
|
|
|
const result = spawnSync(picker.command, picker.args, {
|
|
|
|
|
encoding: 'utf8',
|
|
|
|
|
env: { ...process.env, ...picker.env },
|
|
|
|
|
stdio: ['ignore', 'pipe', 'pipe'],
|
|
|
|
|
windowsHide: true,
|
|
|
|
|
});
|
|
|
|
|
const folder = (result.stdout || '').trim();
|
|
|
|
|
// Pickers exit 0 or 1 with nothing printed when cancelled; anything else means the picker
|
|
|
|
|
// itself failed, so fall through to the typed prompt rather than giving up.
|
|
|
|
|
if (!result.error && folder && result.status === 0) return path.resolve(folder);
|
|
|
|
|
if (!result.error && !folder && (result.status === 0 || result.status === 1)) return null;
|
|
|
|
|
}
|
|
|
|
|
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
const answer = (await ask(`Project folder ${c.green(`[${start}]`)}: `)).trim().replace(/^["']|["']$/g, '');
|
2026-09-28 19:37:41 -07:00
|
|
|
if (!answer) return start;
|
|
|
|
|
return path.resolve(answer.replace(/^~(?=$|[\\/])/, os.homedir()));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// Exit codes from Ctrl+C (130 on POSIX, STATUS_CONTROL_C_EXIT on Windows) are the person
|
|
|
|
|
// leaving on purpose, not a failure worth holding the window open for.
|
|
|
|
|
const INTERRUPT_EXIT_CODES = new Set([130, 0xc000013a]);
|
|
|
|
|
let exiting = false;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Exit, but when launched from the desktop shortcut hold the window open on a failure first:
|
|
|
|
|
* the console closes with the process, taking the error message with it. Only the first call
|
|
|
|
|
* counts, since a failed spawn may report through both 'error' and 'exit'.
|
|
|
|
|
*/
|
|
|
|
|
async function exitWith(code, fromShortcut) {
|
|
|
|
|
if (exiting) return;
|
|
|
|
|
exiting = true;
|
|
|
|
|
if (fromShortcut && code !== 0 && !INTERRUPT_EXIT_CODES.has(code) && process.stdin.isTTY) {
|
|
|
|
|
await ask('Press Enter to close.');
|
|
|
|
|
}
|
|
|
|
|
process.exit(code);
|
|
|
|
|
}
|
|
|
|
|
|
2026-10-16 19:28:11 -07:00
|
|
|
/**
|
|
|
|
|
* Spawn a resolved command with `args`. A .cmd/.bat wrapper on Windows goes through cmd.exe,
|
|
|
|
|
* since Node refuses to spawn one without a shell.
|
|
|
|
|
*/
|
|
|
|
|
function spawnCommand(file, args, options) {
|
|
|
|
|
return IS_WINDOWS && /\.(cmd|bat)$/i.test(file)
|
|
|
|
|
? spawn(
|
|
|
|
|
process.env.ComSpec || 'cmd.exe',
|
|
|
|
|
['/d', '/s', '/c', `"${[file, ...args].map(quoteForCmd).join(' ')}"`],
|
|
|
|
|
{ ...options, windowsVerbatimArguments: true }
|
|
|
|
|
)
|
|
|
|
|
: spawn(file, args, options);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** `plan2code update`: the npx install with --update, passing npx's exit code through. No agent starts. */
|
|
|
|
|
function runUpdate() {
|
|
|
|
|
console.log('Updating Plan2Code...');
|
|
|
|
|
const npx = findOnPath('npx');
|
|
|
|
|
if (!npx) {
|
|
|
|
|
console.error(`${ce.red('plan2code:')} npx was not found on your PATH. It comes with Node.js 18+ (https://nodejs.org).`);
|
|
|
|
|
return process.exit(127);
|
|
|
|
|
}
|
|
|
|
|
const child = spawnCommand(npx, ['--yes', '--allow-git=all', `git+${REPO_URL}`, '--update'], { stdio: 'inherit' });
|
|
|
|
|
for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
|
|
|
|
|
process.on(signal, () => {});
|
|
|
|
|
}
|
|
|
|
|
child.on('error', (error) => {
|
|
|
|
|
console.error(`${ce.red('plan2code:')} failed to start npx: ${error.message}`);
|
|
|
|
|
process.exit(1);
|
|
|
|
|
});
|
|
|
|
|
child.on('exit', (code) => process.exit(code ?? 1));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** -1, 0 or 1 comparing two plain X.Y.Z versions; null unless both are X.Y.Z (as update-check.mjs). */
|
|
|
|
|
function compareVersions(a, b) {
|
|
|
|
|
const semver = /^\d+\.\d+\.\d+$/;
|
|
|
|
|
if (typeof a !== 'string' || typeof b !== 'string' || !semver.test(a) || !semver.test(b)) return null;
|
|
|
|
|
const x = a.split('.').map(Number);
|
|
|
|
|
const y = b.split('.').map(Number);
|
|
|
|
|
for (let i = 0; i < 3; i++) {
|
|
|
|
|
if (x[i] !== y[i]) return x[i] < y[i] ? -1 : 1;
|
|
|
|
|
}
|
|
|
|
|
return 0;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* One line when a newer release is out, from the console's cached check only. A missing or
|
|
|
|
|
* stale cache prints nothing and starts a detached refresh (the copied update-check.mjs) so
|
|
|
|
|
* the next start knows; the start never waits on it. Any error is swallowed: the notice must
|
|
|
|
|
* never stand between the person and their agent.
|
|
|
|
|
*/
|
|
|
|
|
async function releaseNotice() {
|
|
|
|
|
try {
|
|
|
|
|
const installed = (readJsonFile(path.join(__dirname, 'version.json')) || {}).version;
|
|
|
|
|
if (typeof installed !== 'string') return;
|
|
|
|
|
const cache = readJsonFile(UPDATE_CACHE_FILE);
|
|
|
|
|
if (cache && typeof cache.checkedAt === 'number' && Date.now() - cache.checkedAt < UPDATE_CACHE_MS) {
|
|
|
|
|
if (compareVersions(installed, cache.latest) === -1) {
|
|
|
|
|
console.log(c.yellow(`Plan2Code v${cache.latest} is out (you have v${installed}). Run: plan2code update`));
|
|
|
|
|
}
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
const checker = path.join(__dirname, 'update-check.mjs');
|
|
|
|
|
if (!fs.existsSync(checker)) return;
|
|
|
|
|
const refresh =
|
|
|
|
|
'import(process.argv[1]).then((m) => m.checkForUpdate({ installed: process.argv[2], cacheFile: process.argv[3] })).catch(() => {});';
|
|
|
|
|
const href = require('url').pathToFileURL(checker).href;
|
|
|
|
|
spawn(process.execPath, ['-e', refresh, href, installed, UPDATE_CACHE_FILE], {
|
|
|
|
|
detached: true,
|
|
|
|
|
stdio: 'ignore',
|
|
|
|
|
windowsHide: true,
|
|
|
|
|
}).unref();
|
|
|
|
|
} catch {}
|
|
|
|
|
}
|
|
|
|
|
|
2026-09-28 19:37:41 -07:00
|
|
|
async function launch() {
|
|
|
|
|
const argv = process.argv.slice(2);
|
2026-10-16 19:28:11 -07:00
|
|
|
if (argv[0] === UPDATE_COMMAND) return runUpdate();
|
2026-09-28 19:37:41 -07:00
|
|
|
const fromShortcut = argv.includes(PICK_FOLDER_FLAG);
|
|
|
|
|
const { cli: requestedCli, rest: extraArgs } = takeCliFlag(argv.filter((arg) => arg !== PICK_FOLDER_FLAG));
|
|
|
|
|
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
printIntro();
|
2026-10-16 19:28:11 -07:00
|
|
|
await releaseNotice();
|
2026-09-28 19:37:41 -07:00
|
|
|
const { cli, code } = await chooseCli(requestedCli);
|
|
|
|
|
if (!cli) return exitWith(code, fromShortcut);
|
|
|
|
|
saveState({ lastCli: cli.id });
|
|
|
|
|
|
|
|
|
|
let cwd = process.cwd();
|
|
|
|
|
if (fromShortcut) {
|
|
|
|
|
const folder = await pickFolder();
|
|
|
|
|
if (!folder) return process.exit(0);
|
|
|
|
|
if (!isDirectory(folder)) {
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.error(`${ce.red('plan2code:')} ${folder} is not a folder.`);
|
2026-09-28 19:37:41 -07:00
|
|
|
return exitWith(1, fromShortcut);
|
|
|
|
|
}
|
|
|
|
|
saveState({ lastFolder: folder });
|
|
|
|
|
cwd = folder;
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.log(`Opening Plan2Code in ${c.cyan(folder)}`);
|
2026-09-28 19:37:41 -07:00
|
|
|
}
|
|
|
|
|
|
2026-10-11 16:39:25 -07:00
|
|
|
if (!hasModelFlag(extraArgs, cli.id)) await chooseModel(cli, extraArgs);
|
2026-09-28 19:37:41 -07:00
|
|
|
|
|
|
|
|
const args = cli.args(extraArgs);
|
|
|
|
|
const options = { cwd, stdio: 'inherit' };
|
|
|
|
|
|
2026-10-16 19:28:11 -07:00
|
|
|
const child = spawnCommand(cli.path, args, options);
|
2026-09-28 19:37:41 -07:00
|
|
|
|
|
|
|
|
// Ctrl+C reaches the CLI directly through the shared console; keep this wrapper alive so it
|
|
|
|
|
// can hand back the CLI's exit status instead of dying first.
|
|
|
|
|
for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
|
|
|
|
|
process.on(signal, () => {});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
child.on('error', (error) => {
|
Sync upstream web console updates into v2.4.2: on-demand Cleanup of unused ~/.plan2code files, an UPDATE AVAILABLE banner from the release tags, a colored launcher with a Planny banner, Notes threads that keep the person's notes and read older reply shapes, the repo-local plan2code-model-update maintainer skill, and review fixes (413 for oversize bodies, notes kept on skip, scoped reconnect banner, live Overview tab, busy state on 409, menu keyboard focus, case-insensitive mentions)
2026-10-05 19:10:45 -07:00
|
|
|
console.error(`${ce.red('plan2code:')} failed to start ${cli.id}: ${error.message}`);
|
2026-09-28 19:37:41 -07:00
|
|
|
exitWith(1, fromShortcut);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
child.on('exit', (code, signal) => {
|
|
|
|
|
if (signal) {
|
|
|
|
|
process.removeAllListeners(signal);
|
|
|
|
|
process.kill(process.pid, signal);
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
exitWith(code ?? 0, fromShortcut);
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
2026-10-02 20:51:34 -07:00
|
|
|
// Run only when invoked directly; requiring the file (the tests do) is load-only.
|
|
|
|
|
if (require.main === module) launch();
|
|
|
|
|
|
2026-10-16 19:28:11 -07:00
|
|
|
module.exports = { mergeModels, modelEntries, renderBanner, paint, hasModelFlag, compareVersions };
|