whale-igniter 1.3.7 → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to Whale Igniter are documented here.
+
+## 1.4.0 - 2026-06-03
+
+### Added
+
+- Local UI theme engine for generated landing pages, with Atlas, Harbor, and Aurora themes.
+- `whale themes list` for browsing shipped themes.
+- Capability-gated `whale ignite` splash with color, Unicode, and plain fallbacks.
+- README Data & privacy section, generated-output ownership note, and font attribution.
+
+### Changed
+
+- Generated landing CSS now emits theme-driven custom properties for color, typography, structure, interaction, and motion.
+- Selene response cache writes now ensure `.whale/` is ignored in the target project's `.gitignore`.
+- Reworded older brand-planning docs to avoid vague status language.
+
+### Verified
+
+- Selene API keys are read from environment variables and used only in provider request headers.
+- Selene cache stores response text under `.whale/selene/cache`; it does not store API keys.
+- No font binaries are shipped.
+- No telemetry or analytics code is present.

package/README.md

@@ -43,6 +43,8 @@ my-app/
 
 The agent doesn't guess anymore. It reads.
 
+Generated output belongs to you. Files created by Whale Igniter, including generated HTML, CSS, CLAUDE.md, AGENTS.md, wiki pages, and copied theme files, are yours to use and modify; they are not restricted by this project's MIT license.
+
 ---
 
 ## What agents can read — and write
@@ -148,6 +150,20 @@ whale selene describe src/components/Button.tsx
 
 ---
 
+## Data & privacy
+
+Whale Igniter runs offline by default. Core flows such as themes, drift detection, wiki generation, MCP, and local project analysis do not require an API key and do not send project data over the network.
+
+AI features are opt-in. When you enable Selene API mode, Whale sends the prompt and project context to the selected provider, Anthropic or OpenAI, under that provider's terms. You are responsible for reviewing context before sending it and for keeping secrets or sensitive data out of prompts.
+
+API keys are read from environment variables only: `ANTHROPIC_API_KEY` or `OPENAI_API_KEY`. The key is used only in request headers, and Whale does not log it, write it to config, or persist it on disk.
+
+Selene's local cache stores response text under `.whale/selene/cache` in the target project. It does not store API keys. Whale also ensures `.whale/` is ignored by the target project's `.gitignore` when writing Selene cache entries.
+
+Whale Igniter has no telemetry or analytics.
+
+---
+
 ## Requirements
 
 - Node ≥ 20
@@ -155,6 +171,12 @@ whale selene describe src/components/Button.tsx
 
 ---
 
+## Credits
+
+Brand assets reference JetBrains Mono (SIL Open Font License 1.1) and Special Elite (Apache License 2.0). No font binaries are shipped.
+
+---
+
 ## Links
 
 - Roadmap: [`docs/ROADMAP.md`](docs/ROADMAP.md)

package/dist/selene/cache.js

@@ -44,6 +44,7 @@ export async function writeCache(target, model, prompt, text) {
     const key = cacheKey(model, prompt);
     const dir = path.join(target, CACHE_DIR_REL);
     await fs.ensureDir(dir);
+    await ensureWhaleGitignore(target);
     const entry = {
         key,
         model,
@@ -66,3 +67,13 @@ export async function clearCache(target) {
     }
     return removed;
 }
+async function ensureWhaleGitignore(target) {
+    const gitignore = path.join(target, ".gitignore");
+    const entry = ".whale/";
+    const existing = (await fs.pathExists(gitignore)) ? await fs.readFile(gitignore, "utf8") : "";
+    const lines = existing.split(/\r?\n/).map((line) => line.trim());
+    if (lines.includes(entry))
+        return;
+    const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+    await fs.appendFile(gitignore, `${prefix}${entry}\n`, "utf8");
+}

package/dist/ui/splash.js

@@ -6,7 +6,7 @@
  *   2. Unicode, no color       — same layout, no color
  *   3. Plain                   — single ASCII line, no glyphs
  *
- * Rules: no chalk imports, no direct env var reads, no "premium".
+ * Rules: no chalk imports, no direct env var reads, no vague status copy.
  * Uses `capabilities()` from capabilities.js and `ui` atoms.
  */
 import { capabilities } from "./capabilities.js";

package/dist/version.js

@@ -1 +1 @@
-export const PACKAGE_VERSION = "1.3.7";
+export const PACKAGE_VERSION = "1.4.0";

package/docs/ROADMAP.md

@@ -85,7 +85,7 @@ reveals that the next plan needs revising, we revise it before shipping.
 - **Test coverage.** 44 unit tests + MCP smoke test that spawns the
   server and exercises real protocol calls end-to-end.
 
-### v1.1 — Premium runtime UI
+### v1.1 — Polished runtime UI
 
 The terminal output became the product surface. Commands stopped reaching
 for chalk directly; every command now consumes a semantic UI layer where
@@ -96,7 +96,7 @@ pair) and the active theme decides what each intent looks like.
   with ASCII fallbacks), blocks (header, section, kv, panel, summary,
   next, ok/fail/warn/note), theme dispatcher. Commands import from `ui/`
   rather than chalk; chalk is now confined to the theme module.
-- **Single premium theme — graphite.** Cyan accent, charcoal grays, three
+- **Single polished theme — graphite.** Cyan accent, charcoal grays, three
   text-hierarchy levels. Structure ready for v1.2's multi-theme without
   touching any command.
 - **Capability detection.** Auto-detects color and Unicode support; falls

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "whale-igniter",
-  "version": "1.3.7",
+  "version": "1.4.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",
@@ -14,6 +14,7 @@
     "themes",
     "ui-references",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     "docs/ROADMAP.md"
   ],