@tommy-ca/lazypi 0.10.2 → 0.10.4

package/README.md

@@ -13,17 +13,43 @@ LazyPi will:
 1. Install `pi` for you if it isn't installed yet.
 2. Ask if you want to install all the packages or choose which to install.
 
-That setup is the harness core — isolated sub-agents, a structured ask gate, skill visibility, $ skill mention, a long-objective gate, side chat, context budgeting, code simplification review, web research, FFF search, a workflow engine for sub-agent fan-out, and ponytail discipline review. A five-package optional tier (targeted LSP diagnostics, interactive shell overlays, autonomous research loops, structured todo tracking, markdown-backed memory) installs on request with `--only optional`. Other extras (skill arguments, MCP, ralph-wiggum, themes) install on demand with `pi install`.
+That setup is the 12-package harness core. `--yes` installs those 12. On a TTY, Install everything installs all 17. Packages LazyPi dropped stay installable with `pi install`. LazyPi does not manage them. See the Catalog table and `docs/docs/philosophy.html`.
 
 That's it.  Once done - run `pi` and experience a feature rich coding agent experience.
 
 Install is **idempotent** — LazyPi reads your Pi settings and skips any package that is already installed, so re-running is safe.
 
+## Catalog
+
+`--yes` installs 12 core packages. TTY Install everything installs all 17.
+
+| id | category | why |
+| --- | --- | --- |
+| subagents | core | Isolated specialists instead of one bloated agent |
+| pi-ask-user | core | Stop and ask instead of guessing |
+| pi-skillful | core | Keep 4 to 6 skills visible. Hide the rest |
+| mention-skill | core | `$` mention is the one way to reach hidden skills |
+| goal | core | Long-objective gate. Not a checkbox list |
+| btw | core | Side chat that does not pollute history |
+| context-usage | core | See what is burning the window |
+| simplify | core | Review diffs for clarity after implementation |
+| web-access | core | Search and fetch instead of stale training data |
+| fff | core | Paged fuzzy search so grep does not flood the transcript |
+| dynamic-workflows | core | Fan work out across subagents |
+| ponytail | core | Stdlib-first discipline. Lean catalog as a habit |
+| lsp | optional | Targeted diagnostics. Cataloged, not default |
+| interactive-shell | optional | TUI overlays. Chrome, not control plane |
+| autoresearch | optional | Experiment loops. Convenience, not core |
+| todos | optional | Structured tracker. Optional because core forbids checkbox todos as default |
+| memory | optional | Git-backed memory. Infrastructure, not control plane |
+
+Dropped packages are outside this table. `pi install` still works. LazyPi does not manage them.
+
 ## Commands
 
 | Command | What it does |
 | --- | --- |
-| `npx @tommy-ca/lazypi` | Install all or selected catalog (interactive picker by default) |
+| `npx @tommy-ca/lazypi` | TTY Install everything is 17. `--yes` is the 12 core packages. Picker otherwise. |
 | `npx @tommy-ca/lazypi remove <id>` | Remove a catalog package by id (or pass a raw pi source) |
 | `npx @tommy-ca/lazypi status` | Show which catalog packages are installed, missing, or extra |
 | `npx @tommy-ca/lazypi update` | Run `pi update` for installed Pi packages |
@@ -71,7 +97,7 @@ specs behave the same way, so `cd` out of the checkout first.
 
 ## Site / docs
 
-The site at [lazypi.org](https://lazypi.org) lives in `docs/` and is a Jekyll site compiled by GitHub Pages automatically on push to `master`.
+The Jekyll source lives in `docs/`. This fork does not enable GitHub Pages, and [lazypi.org](https://lazypi.org) still serves the upstream installer.
 
 To preview locally (requires Ruby + Bundler):
 
@@ -106,4 +132,4 @@ before treating releases as automated.
 
 ---
 
-For the full list of included packages and optional extras, see [lazypi.org](https://lazypi.org).
+The catalog table above is the npm list. `docs/docs/philosophy.html` explains membership. Run `npx @tommy-ca/lazypi` to install.

package/bin/lazypi.mjs

@@ -175,7 +175,7 @@ function validateSelectors(list, label) {
 	if (bad.length > 0) {
 		console.error(red(`Unknown ${label}: ${bad.join(", ")}`));
 		console.error(`Valid categories: ${CATEGORIES.join(", ")}`);
-		console.error(`Valid package ids:  ${[...ids].join(", ")}`);
+		console.error(`Valid package ids: ${[...ids].join(", ")}`);
 		return false;
 	}
 	return true;
@@ -185,7 +185,7 @@ function matchesSelector(pkg, selectors) {
 	return selectors.some((name) => name === pkg.category || name === pkg.id);
 }
 
-function resolveSelection(flags) {
+export function resolveSelection(flags) {
 	if (flags.only) {
 		if (!validateSelectors(flags.only, "--only")) return null;
 		return new Set(PACKAGES.filter((p) => matchesSelector(p, flags.only)).map((p) => p.id));
@@ -231,8 +231,8 @@ ${bold("Default behaviour:")}
 ${bold("Categories:")}
   core         the harness control plane: sub-agents, workflows, ask gate, skill visibility, $ mention, goal, side chat, context budget, simplify, web research, fff search, ponytail discipline
   optional     only when selected (--only optional, picker, or the everything flow): lsp diagnostics, interactive-shell overlays, autoresearch loops, todo tracking, markdown memory
-  Non-catalog extras (pi install npm:<source>): skill-args, mcp,
-  ralph-wiggum, curated-themes (65 dark themes)
+  (Dropped packages such as skill-args, mcp, ralph-wiggum, curated-themes are
+  outside the catalog — pi install npm:<source> still works for them.)
 
 ${bold("Examples:")}
   npx @tommy-ca/lazypi                              # core catalog (interactive picker on a TTY)
@@ -253,9 +253,47 @@ export function buildSpawnOptions(options = {}, _platformName = platform()) {
 	return { ...options };
 }
 
+function isWindowsCmdOrBat(resolved, platformName = platform()) {
+	return platformName === "win32" && /\.(cmd|bat)$/i.test(String(resolved));
+}
+
+const CMD_QUOTE_RE = /[\s&|<>^%!"()]/;
+
+export function quoteCmdArg(value, { always = false } = {}) {
+	const text = String(value);
+	if (!always && text !== "" && !CMD_QUOTE_RE.test(text)) return text;
+	return `"${text.replaceAll("%", "%%").replaceAll('"', '""')}"`;
+}
+
+export function windowsComSpec(env = process.env) {
+	const comspec = env.ComSpec;
+	if (comspec && /(^|[\\/])cmd\.exe$/i.test(comspec)) return comspec;
+	const root = env.SystemRoot || "C:\\Windows";
+	return `${root}\\System32\\cmd.exe`;
+}
+
+export function pickWindowsWhereHit(stdout) {
+	const lines = String(stdout ?? "").split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+	return lines.find((line) => /\.(cmd|bat|exe|com)$/i.test(line)) ?? lines[0] ?? null;
+}
+
+export function windowsSpawnArgv(resolved, args = [], platformName = platform()) {
+	if (isWindowsCmdOrBat(resolved, platformName)) {
+		return {
+			command: windowsComSpec(),
+			args: ["/d", "/s", "/c", "call", quoteCmdArg(resolved, { always: true }), ...args.map((arg) => quoteCmdArg(arg))],
+		};
+	}
+	return { command: resolved, args: [...args] };
+}
+
 function spawnCommand(command, args = [], options = {}) {
 	const resolved = command === "pi" || command === "npm" ? commandPath(command) ?? command : command;
-	return spawnSync(resolved, args, buildSpawnOptions(options));
+	const spawned = windowsSpawnArgv(resolved, args);
+	const spawnOptions = isWindowsCmdOrBat(resolved)
+		? { ...buildSpawnOptions(options), shell: false, windowsVerbatimArguments: true }
+		: buildSpawnOptions(options);
+	return spawnSync(spawned.command, spawned.args, spawnOptions);
 }
 
 function hasCmd(name) {
@@ -355,6 +393,7 @@ function commandPath(name) {
 	const command = platform() === "win32" ? "where" : "which";
 	const probe = spawnSync(command, [name], buildSpawnOptions({ encoding: "utf8" }));
 	if (probe.status !== 0) return null;
+	if (platform() === "win32") return pickWindowsWhereHit(probe.stdout);
 	const first = String(probe.stdout ?? "").split(/\r?\n/).map((line) => line.trim()).find(Boolean);
 	return first || null;
 }
@@ -531,6 +570,11 @@ async function ensurePi(flags) {
 	if (hasCmd("pi")) return true;
 
 	log.warn("Could not find the `pi` command on PATH.");
+	if (!flags.yes && !isInteractive()) {
+		log.error("Install Pi first (`npm install -g @earendil-works/pi-coding-agent`), then re-run `npx @tommy-ca/lazypi`.");
+		return false;
+	}
+
 	const ok = flags.yes || (await confirm("Install Pi now with `npm install -g @earendil-works/pi-coding-agent`?", true));
 	if (!ok) {
 		log.error("Install Pi first, then re-run `npx @tommy-ca/lazypi`.");
@@ -761,9 +805,15 @@ function cmdStatus(flags) {
 	);
 
 	printHeader(`Installed from LazyPi catalog (${installed.length}/${PACKAGES.length}):`);
+	const coreTotal = PACKAGES.filter((pkg) => pkg.category === "core").length;
+	const optionalTotal = PACKAGES.filter((pkg) => pkg.category === "optional").length;
+	const coreInstalled = installed.filter((pkg) => pkg.category === "core").length;
+	const optionalInstalled = installed.filter((pkg) => pkg.category === "optional").length;
+	console.log(dim(`  core ${coreInstalled}/${coreTotal}, optional ${optionalInstalled}/${optionalTotal}`));
 	if (installed.length === 0) console.log(dim("  none"));
 	for (const pkg of installed) {
-		console.log(`  ${green("✓")} [${pkg.category}] ${pkg.id.padEnd(20)} ${dim(pkg.source)}`);
+		const installedSource = [...sources].find((src) => sourcesMatch(pkg.source, src)) ?? pkg.source;
+		console.log(`  ${green("✓")} [${pkg.category}] ${pkg.id.padEnd(20)} ${dim(installedSource)}`);
 	}
 
 	printHeader(`Installed with legacy catalog sources (${legacy.length}):`);
@@ -816,7 +866,7 @@ function cmdDoctor(flags) {
 	let problems = 0;
 	let warnings = 0;
 	const pass = (msg) => console.log(`  ${green("✓")} ${msg}`);
-	const warn = (msg, { fatal = true } = {}) => {
+	const warn = (msg, { fatal = false } = {}) => {
 		console.log(`  ${yellow("!")} ${msg}`);
 		if (fatal) problems++;
 		else warnings++;
@@ -854,7 +904,10 @@ function cmdDoctor(flags) {
 	else if (error) fail(`${path} is not valid JSON — ${error}`);
 	else {
 		pass(`${path} is readable`);
-		const unpinnedGit = [...sources].filter((src) => /^git:github\.com\/[^/@]+\/[^@\s]+$/.test(src));
+		const unpinnedGit = [...sources].filter((src) => {
+			if (!/^git:github\.com\/[^/@]+\/[^@\s]+$/.test(src)) return false;
+			return !PACKAGES.some((pkg) => sourcesMatch(pkg.source, src) || isLegacySourceForPackage(pkg, src));
+		});
 		for (const src of unpinnedGit) warn(`${src} is an unpinned git head — pin it to a commit for reproducible installs`, { fatal: false });
 	}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tommy-ca/lazypi",
-  "version": "0.10.2",
+  "version": "0.10.4",
   "description": "Opinionated one-shot installer for a full-featured Pi coding agent setup.",
   "license": "MIT",
   "repository": {