whale-igniter 1.1.0 → 1.2.0

package/README.md

@@ -133,6 +133,12 @@ Available client snippets: `--client claude-code | cursor | zed | raw`.
 | `whale adopt review` | Walk through pending proposals interactively. |
 | `whale adopt status` | List proposals without entering review. |
 | `whale sync` | Regenerate CLAUDE.md + wiki from `intelligence/*.json`. |
+| `whale remember` | Friendly alias for `sync`: update project memory for AI assistants. |
+| `whale check` | Friendly health check: run `validate` and then `insights`. |
+| `whale improve` | Friendly Selene entry point: suggest project-wide improvements. |
+| `whale explain` | Friendly docs entry point: generate reports and wiki/context. |
+| `whale team` | Show active and available AI teammates. |
+| `whale team add <name>` | Add atlas, forge, scribe, lighthouse, or selene as an AI teammate. |
 | `whale watch` | Auto-regenerate on changes. Flags: `--once`, `--verbose`, `--debounce`. |
 | `whale validate` | Run validators. Non-zero exit on errors. |
 | `whale insights` | Local analyzers + recommendations. Flags: `--json`, `--category`, `--min-severity`. |

package/dist/commands/friendly.js

@@ -0,0 +1,39 @@
+import { docsCommand } from "./docs.js";
+import { insightsCommand } from "./insights.js";
+import { seleneSuggestCommand } from "./selene.js";
+import { syncCommand } from "./sync.js";
+import { validateCommand } from "./validate.js";
+import { wikiCommand } from "./wiki.js";
+import { ui } from "../ui/index.js";
+export async function rememberCommand(target) {
+    console.log();
+    console.log(ui.header("Whale Igniter", "remember"));
+    console.log(ui.muted("Updating project memory for AI assistants."));
+    await syncCommand(target);
+}
+export async function checkCommand(target) {
+    console.log();
+    console.log(ui.header("Whale Igniter", "check"));
+    console.log(ui.muted("Checking project health, then looking for useful recommendations."));
+    console.log();
+    await validateCommand(target);
+    const validationExit = process.exitCode;
+    await insightsCommand(target, {});
+    if (validationExit !== undefined) {
+        process.exitCode = validationExit;
+    }
+}
+export async function improveCommand() {
+    console.log();
+    console.log(ui.header("Whale Igniter", "improve"));
+    console.log(ui.muted("Asking Selene for project-wide improvement suggestions."));
+    await seleneSuggestCommand({ focus: "all" });
+}
+export async function explainCommand(target) {
+    console.log();
+    console.log(ui.header("Whale Igniter", "explain"));
+    console.log(ui.muted("Generating human-facing docs and AI-readable project context."));
+    console.log();
+    await docsCommand(target);
+    await wikiCommand(target);
+}

package/dist/commands/team.js

@@ -0,0 +1,83 @@
+import { resolveTarget } from "../utils/paths.js";
+import { loadConfig, saveConfig } from "../utils/config.js";
+import { getPack } from "../utils/registry.js";
+import { ui } from "../ui/index.js";
+const PERSONAS = {
+    atlas: {
+        role: "Product strategy",
+        verb: "decides",
+        next: "whale decision"
+    },
+    forge: {
+        role: "Implementation architecture",
+        verb: "builds",
+        next: "whale create component Hero"
+    },
+    scribe: {
+        role: "Documentation and project memory",
+        verb: "documents",
+        next: "whale explain"
+    },
+    lighthouse: {
+        role: "Quality and validation",
+        verb: "guards",
+        next: "whale check"
+    },
+    selene: {
+        role: "AI suggestions and audits",
+        verb: "enriches",
+        next: "whale improve"
+    }
+};
+function isPersonaName(name) {
+    return Object.prototype.hasOwnProperty.call(PERSONAS, name);
+}
+export async function teamListCommand(targetArg) {
+    const target = resolveTarget(targetArg);
+    const config = await loadConfig(target);
+    const installed = new Set(config.packs ?? []);
+    console.log();
+    console.log(ui.header("Whale Igniter", "team"));
+    console.log();
+    console.log(ui.section("Your AI team"));
+    for (const [name, persona] of Object.entries(PERSONAS)) {
+        const mark = installed.has(name) ? ui.ok(name) : ui.muted(`${ui.glyph.bullet} ${name}`);
+        const state = installed.has(name) ? ui.muted("active") : ui.muted("available");
+        console.log(`  ${mark.padEnd(18)} ${persona.role} ${ui.muted("— " + persona.verb)} ${state}`);
+    }
+    console.log();
+    console.log(ui.next("whale team add atlas      add a teammate"));
+    console.log(ui.next("whale remember            update project memory"));
+}
+export async function teamAddCommand(name) {
+    const personaName = name.toLowerCase();
+    if (!isPersonaName(personaName)) {
+        console.log(ui.fail(`Unknown teammate: "${name}"`));
+        console.log(ui.muted("Available teammates: atlas, forge, scribe, lighthouse, selene"));
+        process.exitCode = 1;
+        return;
+    }
+    const target = resolveTarget();
+    const pack = getPack(personaName);
+    const persona = PERSONAS[personaName];
+    if (!pack) {
+        console.log(ui.fail(`No pack found for teammate "${personaName}".`));
+        process.exitCode = 1;
+        return;
+    }
+    const config = await loadConfig(target);
+    config.packs = config.packs ?? [];
+    if (config.packs.includes(personaName)) {
+        console.log(ui.warn(`${personaName} is already on your AI team.`));
+        console.log(ui.next(persona.next));
+        return;
+    }
+    config.packs.push(personaName);
+    await saveConfig(target, config);
+    console.log(ui.ok(`${ui.code(personaName)} joined your AI team`));
+    console.log(`  ${ui.kv("role", persona.role, { keyWidth: 8 })}`);
+    console.log(`  ${ui.kv("pack", pack.kind, { keyWidth: 8 })}`);
+    console.log();
+    console.log(ui.next(`${persona.next}    ${ui.muted("try this next")}`));
+    console.log(ui.next(`whale remember    ${ui.muted("update project memory for agents")}`));
+}

package/dist/index.js

@@ -17,6 +17,8 @@ import { createComponentCommand } from "./commands/createComponent.js";
 import { seleneDescribeCommand, seleneAuditCommand, seleneSuggestCommand, seleneApplyCommand, seleneStatusCommand, seleneCacheClearCommand } from "./commands/selene.js";
 import { mcpServeCommand, mcpConfigCommand } from "./commands/mcp.js";
 import { watchCommand } from "./commands/watch.js";
+import { rememberCommand, checkCommand, improveCommand, explainCommand } from "./commands/friendly.js";
+import { teamAddCommand, teamListCommand } from "./commands/team.js";
 import { PACKAGE_VERSION } from "./version.js";
 const program = new Command();
 program
@@ -40,6 +42,22 @@ program
     .command("sync [target]")
     .description("Regenerate CLAUDE.md and the LLM Wiki from intelligence/*.json.")
     .action(syncCommand);
+program
+    .command("remember [target]")
+    .description("Update project memory for AI assistants (friendly alias for sync).")
+    .action((target) => rememberCommand(target));
+program
+    .command("check [target]")
+    .description("Check project health and recommendations (validate + insights).")
+    .action((target) => checkCommand(target));
+program
+    .command("improve")
+    .description("Ask Selene for project-wide improvement suggestions.")
+    .action(() => improveCommand());
+program
+    .command("explain [target]")
+    .description("Generate human docs and AI-readable context (docs + wiki).")
+    .action((target) => explainCommand(target));
 program
     .command("add <pack>")
     .description("Install a Whale operational pack.")
@@ -190,6 +208,19 @@ component
     .command("list")
     .description("List components registered in the catalog.")
     .action(componentListCommand);
+const team = program
+    .command("team")
+    .description("Manage your AI team (friendly layer for operational packs).");
+team
+    .command("add <teammate>")
+    .description("Add atlas, forge, scribe, lighthouse, or selene to this project.")
+    .action((name) => teamAddCommand(name));
+team
+    .command("list [target]")
+    .description("Show available and active teammates.")
+    .action((target) => teamListCommand(target));
+team
+    .action(() => teamListCommand());
 const mcp = program
     .command("mcp")
     .description("Run or configure the Whale MCP server (for Claude Code, Cursor, Zed, etc.).");

package/dist/version.js

@@ -1 +1 @@
-export const PACKAGE_VERSION = "1.1.0";
+export const PACKAGE_VERSION = "1.2.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whale-igniter",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "CLI-first operational intelligence. Bootstraps and adopts AI-readable project context so agents like Claude Code, Codex and Cursor understand your design system from the first commit. Includes an MCP server, a file watcher, deterministic insights, and an opt-in AI bridge (Selene).",
   "type": "module",
   "main": "./dist/index.js",