@tommy-ca/lazypi 0.8.0 → 0.9.0

package/README.md

@@ -13,7 +13,7 @@ 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. Optional extras (skill arguments, memory, MCP, interactive shell overlays, research loops, themes) install on demand with `pi 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 four-package optional tier (targeted LSP diagnostics, interactive shell overlays, autonomous research loops, structured todo tracking) installs on request with `--only optional`. Other extras (skill arguments, memory, MCP, themes) install on demand with `pi install`.
 
 That's it.  Once done - run `pi` and experience a feature rich coding agent experience.
 
@@ -54,11 +54,20 @@ There is nothing to "uninstall" for LazyPi itself — `npx` doesn't leave it aro
 
 Run the built-in health check with `npx @tommy-ca/lazypi doctor`.
 
-**Stale `bunx` after a release?** bun caches resolved package versions, so a
-bare `bunx @tommy-ca/lazypi` can keep serving the previous release until the
-cache is cleared. Run `bun pm cache rm`, pin `@tommy-ca/lazypi@latest`, and
-check `npx @tommy-ca/lazypi --version` to see which release is actually
-running.
+**Stale cached run after a release?** Both runners cache resolved versions: `bunx`
+serves from its package cache and `npx` reuses the extracted copy in
+`~/.npm/_npx`, so a bare `npx @tommy-ca/lazypi` / `bunx @tommy-ca/lazypi` can
+keep serving the previous release until the cache is cleared. Run
+`bun pm cache rm` (and/or delete the stale `~/.npm/_npx` entry), pin
+`@tommy-ca/lazypi@latest`, and check `npx @tommy-ca/lazypi --version` to see
+which release is actually running.
+
+**`lazypi: not found` when running npx inside the LazyPi repo?** npm exec
+matches the spec against the local tree, and the checkout itself is
+`@tommy-ca/lazypi@<version>` — so it skips the npx install and tries to run
+`lazypi` from `./node_modules/.bin`, which never exists for the project's own
+name. Run npx from any other directory (e.g. `~`); bunx and pinned-version
+specs behave the same way, so `cd` out of the checkout first.
 
 ## Site / docs
 

package/bin/lazypi.mjs

@@ -20,32 +20,36 @@ import {
 // ---------------------------------------------------------------------------
 // Catalog
 // ---------------------------------------------------------------------------
-// Categories. LazyPi installs every package by default — "lazy" means you get
-// the whole thing without thinking. Use the interactive picker or --only /
-// --except to narrow it.
-const CATEGORIES = ["core"];
+// Categories. LazyPi installs the core catalog by default — "lazy" means you
+// get the harness without thinking. The optional category holds evaluated
+// packages worth managing but not part of the default; include them via the
+// interactive picker or --only / --except.
+const CATEGORIES = ["core", "optional"];
 
 export const PACKAGES = [
-	{ id: "subagents", category: "core", source: "npm:pi-subagents", essential: true, description: "Sub-agent execution", hint: "Run isolated sub-agents for parallel work." },
-	{ id: "pi-ask-user", category: "core", source: "npm:pi-ask-user", essential: true, description: "Ask-user prompts", hint: "Interactive user questions for agent workflows." },
-	{ id: "pi-skillful", category: "core", source: "npm:pi-skillful", essential: true, description: "Skill visibility", hint: "Discover skills above the git root, hide unused skills, and expand /skill:name inline." },
-	{ id: "mention-skill", category: "core", source: "npm:@zigai/pi-mention-skill", essential: true, description: "$ skill mention", hint: "Fuzzy-search skills with $ and expand them into the prompt; hidden skills stay reachable." },
-	{ id: "goal", category: "core", source: "npm:@narumitw/pi-goal", essential: true, description: "Long-objective gate", hint: "Stop on done, blocked, or external wait for long tasks." },
+	{ id: "subagents", category: "core", source: "npm:pi-subagents", description: "Sub-agent execution", hint: "Run isolated sub-agents for parallel work." },
+	{ id: "pi-ask-user", category: "core", source: "npm:pi-ask-user", description: "Ask-user prompts", hint: "Interactive user questions for agent workflows." },
+	{ id: "pi-skillful", category: "core", source: "npm:pi-skillful", description: "Skill visibility", hint: "Discover skills above the git root, hide unused skills, and expand /skill:name inline." },
+	{ id: "mention-skill", category: "core", source: "npm:@zigai/pi-mention-skill", description: "$ skill mention", hint: "Fuzzy-search skills with $ and expand them into the prompt; hidden skills stay reachable." },
+	{ id: "goal", category: "core", source: "npm:@narumitw/pi-goal", description: "Long-objective gate", hint: "Stop on done, blocked, or external wait for long tasks." },
 	{
 		id: "btw",
 		category: "core",
 		source: "npm:@narumitw/pi-btw",
 		legacySources: ["npm:pi-btw"],
-		essential: true,
 		description: "Side-chat popover",
 		hint: "Ask quick questions without polluting your conversation history.",
 	},
-	{ id: "context-usage", category: "core", source: "npm:pi-context-usage", essential: true, description: "Context budget", hint: "See what is burning the context window before it fills." },
-	{ id: "simplify", category: "core", source: "npm:pi-simplify", essential: true, description: "Code simplify review", hint: "Reviews recently changed code for clarity, consistency, and maintainability." },
-	{ id: "web-access", category: "core", source: "npm:pi-web-access", essential: true, description: "Web search and page fetch", hint: "Built-in web search and URL fetching." },
-	{ id: "fff", category: "core", source: "npm:@ff-labs/pi-fff", essential: true, description: "FFF fuzzy search", hint: "Additive fffind / ffgrep / fff-multi-grep beside the built-in tools; /fff-health checks the index." },
-	{ id: "dynamic-workflows", category: "core", source: "npm:@quintinshaw/pi-dynamic-workflows", essential: true, description: "Workflow engine", hint: "Fan work out across subagents: /workflows TUI, deep-research, resume, token accounting." },
-	{ id: "ponytail", category: "core", source: "npm:@dietrichgebert/ponytail", essential: true, description: "Lazy senior dev mode", hint: "Enforces minimal, stdlib-first code; /ponytail review, audit, and a debt ledger." },
+	{ id: "context-usage", category: "core", source: "npm:pi-context-usage", description: "Context budget", hint: "See what is burning the context window before it fills." },
+	{ id: "simplify", category: "core", source: "npm:pi-simplify", description: "Code simplify review", hint: "Reviews recently changed code for clarity, consistency, and maintainability." },
+	{ id: "web-access", category: "core", source: "npm:pi-web-access", description: "Web search and page fetch", hint: "Built-in web search and URL fetching." },
+	{ id: "fff", category: "core", source: "npm:@ff-labs/pi-fff", description: "FFF fuzzy search", hint: "Additive fffind / ffgrep / fff-multi-grep beside the built-in tools; /fff-health checks the index." },
+	{ id: "dynamic-workflows", category: "core", source: "npm:@quintinshaw/pi-dynamic-workflows", description: "Workflow engine", hint: "Fan work out across subagents: /workflows TUI, deep-research, resume, token accounting." },
+	{ id: "ponytail", category: "core", source: "npm:@dietrichgebert/ponytail", description: "Lazy senior dev mode", hint: "Enforces minimal, stdlib-first code; /ponytail review, audit, and a debt ledger." },
+	{ id: "lsp", category: "optional", source: "npm:@narumitw/pi-lsp", description: "Targeted LSP diagnostics and fixes", hint: "lsp_diagnostics / lsp_fix with configurable language servers, started per call." },
+	{ id: "interactive-shell", category: "optional", source: "npm:pi-interactive-shell", description: "Interactive shell overlays", hint: "Run CLIs and agents in TUI overlays: interactive, hands-free, dispatch supervision." },
+	{ id: "autoresearch", category: "optional", source: "npm:pi-autoresearch", legacySources: ["git:github.com/davebcn87/pi-autoresearch"], description: "Autonomous experiment loops", hint: "Iterative optimization runs with hooks, finalize, and convergence tracking." },
+	{ id: "todos", category: "optional", source: "npm:pi-manage-todo-list", legacySources: ["git:github.com/tintinweb/pi-manage-todo-list"], description: "Structured todo tracking", hint: "Track multi-step work with live progress widgets and session persistence." },
 ];
 
 // ---------------------------------------------------------------------------
@@ -164,7 +168,7 @@ function resolveSelection(flags) {
 		validateSelectors(flags.except, "--except");
 		return new Set(PACKAGES.filter((p) => !matchesSelector(p, flags.except)).map((p) => p.id));
 	}
-	return new Set(PACKAGES.map((p) => p.id));
+	return new Set(PACKAGES.filter((p) => p.category === "core").map((p) => p.id));
 }
 
 // ---------------------------------------------------------------------------
@@ -192,20 +196,23 @@ ${bold("Install options:")}
   -V, --version       Show the installed version
 
 ${bold("Default behaviour:")}
-  - Every catalog package is installed (lazy on purpose).
-  - On a TTY, an interactive picker appears with everything pre-ticked;
+  - Every core catalog package is installed (lazy on purpose); optional
+    category packages are installed only when selected.
+  - On a TTY, an interactive picker appears with core pre-ticked;
     untick categories or packages before confirming.
   - With --yes, --only, or --except the picker is skipped.
 
 ${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
   Non-catalog extras (pi install npm:<source>): skill-args, memory, mcp,
-  interactive-shell, ralph-wiggum, curated-themes (65 dark themes)
+  ralph-wiggum, curated-themes (65 dark themes)
 
 ${bold("Examples:")}
-  npx @tommy-ca/lazypi                              # everything (interactive picker on a TTY)
-  npx @tommy-ca/lazypi --yes                        # everything, no prompt
-  npx @tommy-ca/lazypi --only core                  # just the core category
+  npx @tommy-ca/lazypi                              # core catalog (interactive picker on a TTY)
+  npx @tommy-ca/lazypi --yes                        # core catalog, no prompt
+  npx @tommy-ca/lazypi --only core,optional         # install optional tier too
+  npx @tommy-ca/lazypi --only optional              # just the optional tier
   npx @tommy-ca/lazypi --only subagents,fff         # individual package ids also work
   npx @tommy-ca/lazypi --only core --local          # core into the current project
   npx @tommy-ca/lazypi status
@@ -315,11 +322,6 @@ function readInstalledSources(local) {
 	return { sources, path: current.path, exists: true };
 }
 
-function runPi(args) {
-	const result = spawnCommand("pi", args, { stdio: "inherit" });
-	return result.status ?? 1;
-}
-
 function commandPath(name) {
 	const command = platform() === "win32" ? "where" : "which";
 	const probe = spawnCommand(command, [name], { encoding: "utf8" });
@@ -535,6 +537,8 @@ async function cmdInstall(flags) {
 		const choice = await askLazyOrPick(PACKAGES.length);
 		if (choice === "pick") {
 			selectedIds = await runPicker(selectedIds);
+		} else {
+			selectedIds = new Set(PACKAGES.map((p) => p.id));
 		}
 	}
 
@@ -751,7 +755,7 @@ async function cmdUpdate(flags) {
 
 	console.log(bold("pi update"));
 
-	return runPi(flags.local ? ["update", "--extensions"] : ["update"]);
+	return spawnCommand("pi", flags.local ? ["update", "--extensions"] : ["update"], { stdio: "inherit" }).status ?? 1;
 }
 
 // ---------------------------------------------------------------------------

package/package.json

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