@pify/cli 0.2.2 → 0.3.1

package/README.md

@@ -24,6 +24,7 @@ pify setup --pi-version 0.84.4   # pin the version your team has tested
 pify setup --installer     # run pi's official interactive installer (ps1/sh)
 pify list                  # show the @pify catalog with install state
 pify install goal task     # short names resolve to @pify/goal, @pify/task
+pify install suite         # the whole suite in one go (also: core, agents)
 pify install goal -l -a    # project scope, pre-approved (CI-friendly)
 pify remove goal
 pify update                # update pi + every installed @pify package
@@ -63,14 +64,14 @@ pify completions powershell | Out-String | Invoke-Expression   # add to $PROFILE
 | `@pify/memory` | Persistent memory across pi sessions |
 | `@pify/plan-mode` | Read-only planning mode with approve-then-execute gate |
 | `@pify/pretty` | Prettier TUI rendering for tool calls, diffs, markdown |
-| `@pify/subagent` | Spawn scoped subagents from within a pi session |
+| `@pify/subagent` | Spawn scoped subagents, including by `@agent` mention |
 | `@pify/swarm` | Coordinate multiple pi agents working in parallel |
 | `@pify/task` | Task tracking: dependency graph, evidence-gated completion, reminders |
 | `@pify/todo` | Agent working-memory checklist: TodoWrite-style, next-item surfacing |
-| `@pify/usage` | Token and cost reporting: live footer, local-history dashboard |
+| `@pify/usage` | Token and cost reporting, plus what is filling the context window |
 | `@pify/workflow` | Deterministic agent orchestration: CC-style workflow scripts |
 | `@pify/worktree` | Safe git-worktree management with safety rails and merge-back |
-| `@pify/yolo` | Auto-approve everything, with an undo trail |
+| `@pify/yolo` | A safety gradient from auto-approve to ask-about-anything, with an undo trail |
 
 The catalog ships inside the CLI and refreshes (at most daily) from [`catalog.json` on `main`](https://github.com/pifydev/cli/blob/main/catalog.json), so newly published packages appear without a CLI update. A fetched catalog is validated before use — every entry must stay inside the `@pify` scope — and any invalid document is discarded entirely. Overrides: `PIFY_CATALOG_URL` (remote URL), `PIFY_OFFLINE=1` or `PI_OFFLINE=1` (skip all network lookups).
 

package/catalog.json

@@ -1,5 +1,5 @@
 {
-  "version": 15,
+  "version": 17,
   "org": "pifydev",
   "scope": "@pify",
   "remote": "https://raw.githubusercontent.com/pifydev/cli/main/catalog.json",
@@ -8,7 +8,7 @@
       "name": "ask-question",
       "npm": "@pify/ask-question",
       "repo": "https://github.com/pifydev/ask-question",
-      "description": "CC AskUserQuestion-shaped tool on built-in dialogs: 1-4 questions, multi-select, Other free-text",
+      "description": "CC AskUserQuestion-shaped tool on built-in dialogs: 1-4 questions, multi-select, Other free-text, /ask history",
       "status": "published"
     },
     {
@@ -22,35 +22,35 @@
       "name": "goal",
       "npm": "@pify/goal",
       "repo": "https://github.com/pifydev/goal",
-      "description": "Pin a session goal and keep the agent anchored to it: settled-idle continuation with safety limits",
+      "description": "Pin a session goal and keep the agent anchored: ordered steps, safety limits, evidence-gated completion with an optional independent audit",
       "status": "published"
     },
     {
       "name": "memory",
       "npm": "@pify/memory",
       "repo": "https://github.com/pifydev/memory",
-      "description": "Persistent memory: two-tier markdown storage, FTS5 search, secret-scanned writes",
+      "description": "Persistent memory across sessions: two-tier markdown, FTS5 search, secret-scanned writes, opt-in LLM consolidation",
       "status": "published"
     },
     {
       "name": "plan-mode",
       "npm": "@pify/plan-mode",
       "repo": "https://github.com/pifydev/plan-mode",
-      "description": "Read-only planning mode with an enforced approve-then-execute gate: tool policy, plan files, fresh-session handoff",
+      "description": "Read-only planning with an approve-then-execute gate: enforced tool policy, tracked plan steps, saved-plan library, HTML export",
       "status": "published"
     },
     {
       "name": "pretty",
       "npm": "@pify/pretty",
       "repo": "https://github.com/pifydev/pretty",
-      "description": "Compact theme-aware rendering for built-in tools: summaries, highlighted reads, colorized diffs",
+      "description": "Compact theme-aware rendering for built-in tools: summaries, highlighted reads, colorized diffs, configurable caps",
       "status": "published"
     },
     {
       "name": "subagent",
       "npm": "@pify/subagent",
       "repo": "https://github.com/pifydev/subagent",
-      "description": "Spawn scoped subagents: agent_run/agent_result, custom agent types, turn caps and tool allowlists",
+      "description": "Spawn scoped subagents: agent_run/agent_result, @agent mentions, custom agent types, turn caps and tool allowlists",
       "status": "published"
     },
     {
@@ -78,14 +78,14 @@
       "name": "usage",
       "npm": "@pify/usage",
       "repo": "https://github.com/pifydev/usage",
-      "description": "Token and cost reporting: live footer, local-history dashboard with per-project costs, opt-in provider quota",
+      "description": "Token and cost reporting: live footer, local-history dashboard with per-project costs, and /usage context showing what fills the window",
       "status": "published"
     },
     {
       "name": "workflow",
       "npm": "@pify/workflow",
       "repo": "https://github.com/pifydev/workflow",
-      "description": "Deterministic agent orchestration: CC-style workflow scripts with agent()/parallel()/pipeline()",
+      "description": "Deterministic agent orchestration: CC-style scripts with agent()/parallel()/pipeline(), schema-validated results, gates, and resume",
       "status": "published"
     },
     {
@@ -99,8 +99,50 @@
       "name": "yolo",
       "npm": "@pify/yolo",
       "repo": "https://github.com/pifydev/yolo",
-      "description": "One toggle to auto-approve everything, with an undo trail: three-tier bash guard, file pre-images",
+      "description": "A safety gradient from auto-approve-everything to ask-about-anything: four modes, secret-file gate, undo trail with git checkpoints",
       "status": "published"
     }
+  ],
+  "bundles": [
+    {
+      "name": "suite",
+      "description": "Every published @pify extension",
+      "packages": [
+        "ask-question",
+        "btw",
+        "goal",
+        "memory",
+        "plan-mode",
+        "pretty",
+        "subagent",
+        "swarm",
+        "task",
+        "todo",
+        "usage",
+        "workflow",
+        "worktree",
+        "yolo"
+      ]
+    },
+    {
+      "name": "core",
+      "description": "The everyday four: task tracking, planning, memory, and a safety gate",
+      "packages": [
+        "todo",
+        "plan-mode",
+        "memory",
+        "yolo"
+      ]
+    },
+    {
+      "name": "agents",
+      "description": "The agent stack: subagents, parallel fan-out, scripted workflows, worktrees",
+      "packages": [
+        "subagent",
+        "swarm",
+        "workflow",
+        "worktree"
+      ]
+    }
   ]
 }

package/dist/cli.js

@@ -492,8 +492,38 @@ function validateCatalog(data) {
     if (typeof p.npm !== "string" || !p.npm.startsWith("@pify/")) return false;
     if (p.status !== "published" && p.status !== "planned") return false;
   }
+  if (c.bundles !== void 0) {
+    if (!Array.isArray(c.bundles)) return false;
+    const known = new Set(c.packages.map((p) => p.name));
+    for (const entry of c.bundles) {
+      if (typeof entry !== "object" || entry === null) return false;
+      const b = entry;
+      if (typeof b.name !== "string" || !/^[a-z0-9-]+$/.test(b.name)) return false;
+      if (typeof b.description !== "string") return false;
+      if (!Array.isArray(b.packages) || b.packages.length === 0) return false;
+      for (const member of b.packages) {
+        if (typeof member !== "string" || !known.has(member)) return false;
+      }
+    }
+  }
   return true;
 }
+function findBundle(catalog, name) {
+  const wanted = name.trim().toLowerCase();
+  if (catalog.packages.some((p) => p.name === wanted)) return null;
+  return catalog.bundles?.find((b) => b.name === wanted) ?? null;
+}
+function expandBundles(catalog, names) {
+  const expanded = [];
+  for (const name of names) {
+    const bundle = findBundle(catalog, name);
+    const members = bundle ? bundle.packages : [name];
+    for (const member of members) {
+      if (!expanded.includes(member)) expanded.push(member);
+    }
+  }
+  return expanded;
+}
 async function loadCatalog(opts = {}) {
   const bundled = loadBundledCatalog();
   const cached = readCache();
@@ -659,7 +689,12 @@ async function install(names, opts) {
     throw usageError("Missing package name.", "Usage: pify install <name...> [-l] [-a]");
   }
   const catalog = await loadCatalog();
-  const targets = names.map((name) => resolveInstallTarget(catalog, name));
+  for (const name of names) {
+    const bundle = findBundle(catalog, name);
+    if (bundle) step(`${bundle.name}: ${bundle.packages.length} packages \u2014 ${bundle.description}`);
+  }
+  const expanded = expandBundles(catalog, names);
+  const targets = expanded.map((name) => resolveInstallTarget(catalog, name));
   for (const target of targets) {
     if (target.explicit && (!target.inCatalog || target.status !== "published")) {
       warn(`${target.npm} is not in the catalog (or not marked published); installing anyway.`);
@@ -1288,7 +1323,11 @@ function parseArgsOptionsFor(spec) {
 
 // src/completions.ts
 function packageNames() {
-  return loadBundledCatalog().packages.map((p) => p.name);
+  const catalog = loadBundledCatalog();
+  return [
+    ...catalog.packages.map((p) => p.name),
+    ...(catalog.bundles ?? []).map((b) => b.name)
+  ];
 }
 function allNames(spec) {
   return [spec.name, ...spec.aliases];
@@ -1451,7 +1490,7 @@ Usage:
 
 Commands:
   setup                  Install the pi coding agent (safe to re-run)
-  install <name...>      Install @pify packages by short name
+  install <name...>      Install @pify packages, or a bundle (suite|core|agents)
   remove <name...>       Remove installed @pify packages
   update [pi|<name...>]  Update pi and installed @pify packages
   list                   Show the @pify catalog with install state
@@ -1526,6 +1565,11 @@ Install @pify packages by short name. Names resolve against the Pify catalog
 (goal -> npm:@pify/goal); the install itself is delegated to pi install.
 Exact version pins are accepted (goal@0.3.0); range specifiers are refused.
 
+A bundle name installs several at once \u2014 pify install suite (everything),
+core (todo, plan-mode, memory, yolo), or agents (subagent, swarm, workflow,
+worktree). Bundle members are resolved exactly like typed names, and a
+package name always wins over a bundle with the same name.
+
 Options:
   -l, --local            Project scope (.pi/settings.json, .pi/npm)
   -a, --approve          Forward --approve to pi (scripted -l installs)

package/dist/index.d.ts

@@ -11,6 +11,12 @@ interface CatalogPackage {
     /** "published" once it exists on the npm registry; "planned" before that. */
     status: "published" | "planned";
 }
+/** A named set of packages installable in one go, e.g. `pify install suite`. */
+interface CatalogBundle {
+    name: string;
+    description: string;
+    packages: string[];
+}
 interface Catalog {
     version: number;
     org: string;
@@ -18,6 +24,8 @@ interface Catalog {
     /** URL of the always-current catalog on the org's main branch. */
     remote: string;
     packages: CatalogPackage[];
+    /** Optional (v0.3): older CLIs ignore this key and keep working. */
+    bundles?: CatalogBundle[];
 }
 declare function loadBundledCatalog(): Catalog;
 /**
@@ -29,6 +37,13 @@ declare function loadBundledCatalog(): Catalog;
  * radius of a compromised remote to "packages the org itself published".
  */
 declare function validateCatalog(data: unknown): data is Catalog;
+/** The bundle by that name, or null. Package names always win over bundles. */
+declare function findBundle(catalog: Catalog, name: string): CatalogBundle | null;
+/**
+ * Expand bundle names into their members, keeping order and dropping
+ * duplicates — installing `suite goal` must not install goal twice.
+ */
+declare function expandBundles(catalog: Catalog, names: string[]): string[];
 /**
  * Load the catalog. Resolution chain, newest `version` wins:
  * bundled snapshot (offline floor) -> ~/.pify cache -> remote fetch.
@@ -244,4 +259,4 @@ declare class PifyError extends Error {
     constructor(message: string, code?: ExitCodeValue, hint?: string);
 }
 
-export { COMMAND_SPECS, COMPLETION_SHELLS, type Catalog, type CatalogPackage, type CommandSpec, type CompletionShell, ExitCode, type FlagSpec, GLOBAL_FLAGS, INDEX_TS, type InstallSpec, type InstallTarget, type InstalledPifyPackage, NODE_FLOOR, PI_PACKAGE, type PiSettings, type PiStatus, PifyError, README_MD, TESTED_PI_VERSION, type TemplateVars, VERSION, agentDir, assertSafeArg, compareSemver, fetchLatestPiVersion, generateCompletion, installPi, installedPifyPackages, installedVersionOnDisk, interpolate, isOffline, loadBundledCatalog, loadCatalog, npmInstallPiArgs, officialInstallerCommand, packageJsonTemplate, parseArgsOptionsFor, parseInstallSpec, piStatus, readSettings, refreshCatalog, resolveInstallTarget, resolvePifyName, updatePi, validateCatalog, which };
+export { COMMAND_SPECS, COMPLETION_SHELLS, type Catalog, type CatalogBundle, type CatalogPackage, type CommandSpec, type CompletionShell, ExitCode, type FlagSpec, GLOBAL_FLAGS, INDEX_TS, type InstallSpec, type InstallTarget, type InstalledPifyPackage, NODE_FLOOR, PI_PACKAGE, type PiSettings, type PiStatus, PifyError, README_MD, TESTED_PI_VERSION, type TemplateVars, VERSION, agentDir, assertSafeArg, compareSemver, expandBundles, fetchLatestPiVersion, findBundle, generateCompletion, installPi, installedPifyPackages, installedVersionOnDisk, interpolate, isOffline, loadBundledCatalog, loadCatalog, npmInstallPiArgs, officialInstallerCommand, packageJsonTemplate, parseArgsOptionsFor, parseInstallSpec, piStatus, readSettings, refreshCatalog, resolveInstallTarget, resolvePifyName, updatePi, validateCatalog, which };

package/dist/index.js

@@ -150,8 +150,38 @@ function validateCatalog(data) {
     if (typeof p.npm !== "string" || !p.npm.startsWith("@pify/")) return false;
     if (p.status !== "published" && p.status !== "planned") return false;
   }
+  if (c.bundles !== void 0) {
+    if (!Array.isArray(c.bundles)) return false;
+    const known = new Set(c.packages.map((p) => p.name));
+    for (const entry of c.bundles) {
+      if (typeof entry !== "object" || entry === null) return false;
+      const b = entry;
+      if (typeof b.name !== "string" || !/^[a-z0-9-]+$/.test(b.name)) return false;
+      if (typeof b.description !== "string") return false;
+      if (!Array.isArray(b.packages) || b.packages.length === 0) return false;
+      for (const member of b.packages) {
+        if (typeof member !== "string" || !known.has(member)) return false;
+      }
+    }
+  }
   return true;
 }
+function findBundle(catalog, name) {
+  const wanted = name.trim().toLowerCase();
+  if (catalog.packages.some((p) => p.name === wanted)) return null;
+  return catalog.bundles?.find((b) => b.name === wanted) ?? null;
+}
+function expandBundles(catalog, names) {
+  const expanded = [];
+  for (const name of names) {
+    const bundle = findBundle(catalog, name);
+    const members = bundle ? bundle.packages : [name];
+    for (const member of members) {
+      if (!expanded.includes(member)) expanded.push(member);
+    }
+  }
+  return expanded;
+}
 async function loadCatalog(opts = {}) {
   const bundled = loadBundledCatalog();
   const cached = readCache();
@@ -644,7 +674,11 @@ function parseArgsOptionsFor(spec) {
 
 // src/completions.ts
 function packageNames() {
-  return loadBundledCatalog().packages.map((p) => p.name);
+  const catalog = loadBundledCatalog();
+  return [
+    ...catalog.packages.map((p) => p.name),
+    ...(catalog.bundles ?? []).map((b) => b.name)
+  ];
 }
 function allNames(spec) {
   return [spec.name, ...spec.aliases];
@@ -921,7 +955,9 @@ export {
   agentDir,
   assertSafeArg,
   compareSemver,
+  expandBundles,
   fetchLatestPiVersion,
+  findBundle,
   generateCompletion,
   installPi,
   installedPifyPackages,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pify/cli",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "Front door for the Pify suite: install and update the pi coding agent, manage @pify packages, and scaffold Pi Packages",
   "keywords": [
     "pify",