feinai 0.5.6 → 0.5.8

package/README.md

@@ -165,7 +165,7 @@ tasks   — atomic work units with blocked_by, quality_gates, worktree
 events  — append-only audit log: {parent_process}:{pid}:{user}
 ```
 
-Every mutation is logged. Every agent is identified. Override identity with `$FEINA_USER`.
+Every mutation is logged. Every agent is identified. Override identity with `$FEINAI_USER`.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feinai",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "Task & spec manager for AI agents — parallel worktrees, live dashboard, SDD skills",
   "type": "module",
   "bin": {

package/skills/feinai-sdd/SKILL.md

@@ -3,7 +3,7 @@ name: feinai-sdd
 description: Use when working in spec-driven development (SDD) workflows that involve brainstorming, writing-plans, or subagent-driven-development AND the project has a `.tasca/tasca.db` file. Replaces creating markdown files in `docs/superpowers/specs/` and `docs/superpowers/plans/` with atomic `feinai` CLI calls, keeping state queryable, race-free, and audit-logged. Also use when the user asks to create a spec, add a task, claim work, or mark progress, in a project that uses tasca.
 ---
 
-# Tasca SDD integration
+# feinai SDD integration
 
 `feinai` is a CLI + local SQLite database for managing specs, plans, and tasks in
 SDD workflows. When a project has `.tasca/tasca.db`, you should write to that
@@ -20,7 +20,7 @@ just change *where the artifacts get stored*.
 Invoke when **all** of the following are true:
 
 1. The project has a `.tasca/tasca.db` file (walk up the directory tree from
-   the current working directory; tasca uses the same discovery pattern as git).
+   the current working directory; feinai uses the same discovery pattern as git).
    Check with: `feinai status` (exit code 0 = tasca is set up).
 2. You are about to:
    - Write a spec via the `brainstorming` skill, OR
@@ -41,7 +41,7 @@ Before any spec / plan / task write, run:
 feinai status 2>/dev/null
 ```
 
-- Exit code 0: tasca is active in this project → use this skill.
+- Exit code 0: feinai is active in this project → use this skill.
 - Exit code 2: `No .tasca/tasca.db found` → fall back to vanilla superpowers
   (or ask the user `feinai init` if it seems intended).
 - Command not found: feinai is not installed or not on PATH. Tell the user:
@@ -96,7 +96,7 @@ FEINAI_EOF
 
 ### What replaces what
 
-| Superpowers step | tasca equivalent |
+| Superpowers step | feinai equivalent |
 |---|---|
 | `Write(docs/superpowers/specs/YYYY-MM-DD-X-design.md, ...)` | `feinai spec add SPEC-NNN "title" --stdin <<<` content |
 | Spec self-review (re-read the markdown) | `feinai spec content SPEC-NNN` (returns the markdown) |
@@ -169,7 +169,7 @@ single response, the full payload: `description` (workplan), `quality_gates`,
 `packages`, `blocked_by`. **The subagent never has to read the plan markdown.**
 
 This is the single biggest token saving and the strongest correctness
-guarantee from using tasca: each subagent's context contains exactly the task
+guarantee from using feinai: each subagent's context contains exactly the task
 it's executing, nothing else.
 
 ---
@@ -248,7 +248,7 @@ human-readable rationale; the tasks are the executable state.
 
 ### ❌ Don't create `docs/superpowers/specs/*.md` files
 
-If tasca is active, those files become a source of drift. The spec lives in
+If feinai is active, those files become a source of drift. The spec lives in
 the database. If you need to publish the spec elsewhere (PR description, wiki,
 etc.), export it on demand: `feinai spec content SPEC-X > /tmp/spec.md`.
 
@@ -262,9 +262,9 @@ subagents that both `show` then act will collide. Always `feinai take`.
 The CLI handles concurrency, audit logging, and validation. Direct SQL
 mutations bypass the events table and leave the audit log incomplete.
 
-### ✅ Do set `FEINA_USER` for explicit subagent identity
+### ✅ Do set `FEINAI_USER` for explicit subagent identity
 
-When dispatching a subagent, pass `FEINA_USER=subagent-N` in its environment
+When dispatching a subagent, pass `FEINAI_USER=subagent-N` in its environment
 so the audit log distinguishes which subagent did what. Otherwise the actor
 field will read `bun:<pid>:<user>` for everyone.
 
@@ -294,8 +294,8 @@ field will read `bun:<pid>:<user>` for everyone.
 
 This skill is **additive**. The superpowers skills (`brainstorming`,
 `writing-plans`, `subagent-driven-development`, etc.) still run; they still
-own the process. tasca only changes the storage of the artifacts they produce.
+own the process. feinai only changes the storage of the artifacts they produce.
 
-If you start brainstorming and discover the project has no tasca DB, fall back
+If you start brainstorming and discover the project has no feinai DB, fall back
 to the normal superpowers behavior (markdown files). Do not silently switch
 storage strategy mid-project.

package/src/cli.ts

@@ -48,7 +48,7 @@ import {
   type OutputFormat,
 } from "./format";
 
-const VERSION = "0.5.6";
+const VERSION = "0.5.8";
 
 interface ParsedArgs {
   positional: string[];
@@ -123,10 +123,10 @@ function detectFormat(args: ParsedArgs): OutputFormat {
 }
 
 /**
- * Build a stable identifier for whoever is invoking feina.
+ * Build a stable identifier for whoever is invoking feinai.
  *
  * Priority:
- *   1. $FEINA_USER env var (explicit override — used by agents to identify themselves)
+ *   1. $FEINAI_USER env var (explicit override — used by agents to identify themselves)
  *   2. parent process name (on Linux via /proc/$PPID/comm) → "{parent_name}:{ppid}:{user}"
  *   3. fallback: "{user}@{hostname}"
  *
@@ -134,7 +134,7 @@ function detectFormat(args: ParsedArgs): OutputFormat {
  * from "bash:9999:m" in the events audit log without manual configuration.
  */
 function getCurrentUser(): string {
-  const override = process.env.FEINA_USER;
+  const override = process.env.FEINAI_USER;
   if (override) return override;
 
   const username = process.env.USER ?? userInfo().username ?? "unknown";
@@ -163,7 +163,7 @@ function getCurrentUser(): string {
 function ensureDb(): ReturnType<typeof openDb> {
   if (!findDbPath()) {
     console.error(
-      "Error: no .tasca/tasca.db found. Run 'feina init' to create one.",
+      "Error: no .tasca/tasca.db found. Run 'feinai init' to create one.",
     );
     process.exit(2);
   }
@@ -182,10 +182,10 @@ function readContentFromArgs(args: ParsedArgs): string | undefined {
 }
 
 function showHelp(): void {
-  console.log(`feina v\${VERSION} — task & spec manager for AI agents and humans
+  console.log(`feinai v\${VERSION} — task & spec manager for AI agents and humans
 
 USAGE:
-  feina <command> [options]
+  feinai <command> [options]
 
 DB MANAGEMENT:
   init [--force]                    Create .tasca/tasca.db in cwd
@@ -250,7 +250,7 @@ SERVER:
     --port <N>                      Port (default: 8272 — TASC on phone keypad)
     --host <addr>                   Bind host (default: 127.0.0.1)
   server --daemon / -d              Start detached (no job control noise)
-  server --down                     Stop the running feina server (by port)
+  server --down                     Stop the running feinai server (by port)
 
 GLOBAL FLAGS:
   --json                            Output as JSON
@@ -259,13 +259,19 @@ GLOBAL FLAGS:
   --version                         Show version
 
 ENV:
-  FEINA_USER                        Override owner/actor identity used in audit log
+  FEINAI_USER                        Override owner/actor identity used in audit log
 
-\x1b[34m\x1b[1m── Agent Integration ──────────────────────────────────────────────\x1b[0m
-  \x1b[36mTeach your AI agents to use \x1b[1mfeina\x1b[0m\x1b[36m as their single source of truth for\x1b[0m
-  \x1b[36mspecs, tasks, and plans.\x1b[0m
-  \x1b[36mOr load \x1b[1mfeina skills\x1b[0m\x1b[36m from the Claude Code skills marketplace:\x1b[0m
-\x1b[34m    \x1b[1;94mtasca-sdd\x1b[0m  \x1b[1;94mtasca-write-spec\x1b[0m  \x1b[1;94mtasca-write-tasks\x1b[0m  \x1b[1;94mtasca-dispatch\x1b[0m
+\x1b[34m\x1b[1m── Claude Code Skills ─────────────────────────────────────────────\x1b[0m
+  \x1b[36mActivate feinai skills for Claude Code (run once after install):\x1b[0m
+
+  \x1b[33mmkdir -p ~/.claude/skills\x1b[0m
+  \x1b[33mSKILLS=~/.bun/install/global/node_modules/feinai/skills\x1b[0m
+  \x1b[33mfor skill in feinai-sdd feinai-write-spec feinai-write-tasks feinai-dispatch feinai-implement; do\x1b[0m
+  \x1b[33m  ln -sf "$SKILLS/$skill" ~/.claude/skills/$skill\x1b[0m
+  \x1b[33mdone\x1b[0m
+
+  \x1b[36mSkills included:\x1b[0m
+\x1b[34m    \x1b[1;94mfeinai-sdd\x1b[0m  \x1b[1;94mfeinai-write-spec\x1b[0m  \x1b[1;94mfeinai-write-tasks\x1b[0m  \x1b[1;94mfeinai-dispatch\x1b[0m  \x1b[1;94mfeinai-implement\x1b[0m
 \x1b[34m\x1b[1m────────────────────────────────────────────────────────────────────\x1b[0m
 `);
 }
@@ -328,7 +334,7 @@ async function main(): Promise<void> {
         return;
       default:
         console.error(`Unknown command: ${command}`);
-        console.error("Run 'feina --help' for usage.");
+        console.error("Run 'feinai --help' for usage.");
         process.exit(1);
     }
   } catch (err) {
@@ -347,7 +353,7 @@ function cmdGit(rest: string[]): void {
   const opengitPath = resolve(__dirname, "opengit.sh");
 
   if (rest.length === 0) {
-    console.error("Usage: feina git <subcommand> [args...]");
+    console.error("Usage: feinai git <subcommand> [args...]");
     console.error("Runs opengit — safe git wrapper for parallel worktree workflows.");
     process.exit(1);
   }
@@ -383,12 +389,12 @@ async function cmdDestroy(args: ParsedArgs): Promise<void> {
 function cmdInit(args: ParsedArgs): void {
   const existing = findDbPath();
   if (existing && !args.flags.force) {
-    console.error(`feina DB already exists at ${existing}`);
+    console.error(`feinai DB already exists at ${existing}`);
     console.error(`Use --force to create a nested DB anyway.`);
     process.exit(1);
   }
   const path = initDb();
-  console.log(`Initialized feina DB at ${path}`);
+  console.log(`Initialized feinai DB at ${path}`);
 
   // Auto-add .tasca/ to .gitignore if inside a git repo
   if (existsSync(".git")) {
@@ -459,7 +465,7 @@ function cmdAdd(rest: string[], args: ParsedArgs, format: OutputFormat): void {
   const [id, ...subjectParts] = rest;
   if (!id || subjectParts.length === 0) {
     console.error(
-      "Usage: feina add <TASK-ID> <subject> [--spec ID] [--desc text] [--package X] [--gate X]",
+      "Usage: feinai add <TASK-ID> <subject> [--spec ID] [--desc text] [--package X] [--gate X]",
     );
     process.exit(1);
   }
@@ -479,7 +485,7 @@ function cmdAdd(rest: string[], args: ParsedArgs, format: OutputFormat): void {
 function cmdShow(rest: string[], format: OutputFormat): void {
   const [id] = rest;
   if (!id) {
-    console.error("Usage: feina show <TASK-ID>");
+    console.error("Usage: feinai show <TASK-ID>");
     process.exit(1);
   }
   const db = ensureDb();
@@ -510,7 +516,7 @@ function cmdShow(rest: string[], format: OutputFormat): void {
 function cmdTake(rest: string[], args: ParsedArgs, format: OutputFormat): void {
   const [id] = rest;
   if (!id) {
-    console.error("Usage: feina take <TASK-ID> [--owner name]");
+    console.error("Usage: feinai take <TASK-ID> [--owner name]");
     process.exit(1);
   }
   const db = ensureDb();
@@ -539,7 +545,7 @@ function cmdDone(rest: string[], args: ParsedArgs, format: OutputFormat): void {
   const [id] = rest;
   const result = args.options.result;
   if (!id || !result) {
-    console.error("Usage: feina done <TASK-ID> --result <text>");
+    console.error("Usage: feinai done <TASK-ID> --result <text>");
     process.exit(1);
   }
   const db = ensureDb();
@@ -551,7 +557,7 @@ function cmdFail(rest: string[], args: ParsedArgs, format: OutputFormat): void {
   const [id] = rest;
   const error = args.options.error;
   if (!id || !error) {
-    console.error("Usage: feina fail <TASK-ID> --error <text>");
+    console.error("Usage: feinai fail <TASK-ID> --error <text>");
     process.exit(1);
   }
   const db = ensureDb();
@@ -561,7 +567,7 @@ function cmdFail(rest: string[], args: ParsedArgs, format: OutputFormat): void {
 
 function cmdRelease(rest: string[], format: OutputFormat): void {
   const [id] = rest;
-  if (!id) { console.error("Usage: feina release <TASK-ID>"); process.exit(1); }
+  if (!id) { console.error("Usage: feinai release <TASK-ID>"); process.exit(1); }
   const db = ensureDb();
   const task = releaseTask(db, id, getCurrentUser());
   console.log(formatTask(task, format));
@@ -569,7 +575,7 @@ function cmdRelease(rest: string[], format: OutputFormat): void {
 
 function cmdReopen(rest: string[], format: OutputFormat): void {
   const [id] = rest;
-  if (!id) { console.error("Usage: feina reopen <TASK-ID>"); process.exit(1); }
+  if (!id) { console.error("Usage: feinai reopen <TASK-ID>"); process.exit(1); }
   const db = ensureDb();
   const task = reopenTask(db, id, getCurrentUser());
   console.log(formatTask(task, format));
@@ -579,7 +585,7 @@ function cmdBlock(rest: string[], args: ParsedArgs, format: OutputFormat): void
   const [id] = rest;
   const by = args.options.by;
   if (!id || !by) {
-    console.error("Usage: feina block <TASK-ID> --by <BLOCKER-ID>");
+    console.error("Usage: feinai block <TASK-ID> --by <BLOCKER-ID>");
     process.exit(1);
   }
   const db = ensureDb();
@@ -591,7 +597,7 @@ function cmdUnblock(rest: string[], args: ParsedArgs, format: OutputFormat): voi
   const [id] = rest;
   const dep = args.options.dep;
   if (!id || !dep) {
-    console.error("Usage: feina unblock <TASK-ID> --dep <BLOCKER-ID>");
+    console.error("Usage: feinai unblock <TASK-ID> --dep <BLOCKER-ID>");
     process.exit(1);
   }
   const db = ensureDb();
@@ -602,7 +608,7 @@ function cmdUnblock(rest: string[], args: ParsedArgs, format: OutputFormat): voi
 function cmdTaskEdit(rest: string[], args: ParsedArgs, format: OutputFormat): void {
   const [id] = rest;
   if (!id) {
-    console.error('Usage: feina task edit <TASK-ID> [--subject text] [--desc text] [--package name] [--gate cmd]');
+    console.error('Usage: feinai task edit <TASK-ID> [--subject text] [--desc text] [--package name] [--gate cmd]');
     console.error('       Supports --stdin and --file for --desc');
     process.exit(1);
   }
@@ -639,7 +645,7 @@ function cmdSpec(rest: string[], args: ParsedArgs, format: OutputFormat): void {
     case "show": {
       const [id] = subRest;
       if (!id) {
-        console.error("Usage: feina spec show <SPEC-ID> [--full]");
+        console.error("Usage: feinai spec show <SPEC-ID> [--full]");
         process.exit(1);
       }
       const spec = getSpec(db, id);
@@ -654,7 +660,7 @@ function cmdSpec(rest: string[], args: ParsedArgs, format: OutputFormat): void {
     case "content": {
       const [id] = subRest;
       if (!id) {
-        console.error("Usage: feina spec content <SPEC-ID>");
+        console.error("Usage: feinai spec content <SPEC-ID>");
         process.exit(1);
       }
       const spec = getSpec(db, id);
@@ -673,7 +679,7 @@ function cmdSpec(rest: string[], args: ParsedArgs, format: OutputFormat): void {
       const [id, ...titleParts] = subRest;
       if (!id || titleParts.length === 0) {
         console.error(
-          "Usage: feina spec add <SPEC-ID> <title> [--content text | --file path | --stdin]",
+          "Usage: feinai spec add <SPEC-ID> <title> [--content text | --file path | --stdin]",
         );
         process.exit(1);
       }
@@ -689,7 +695,7 @@ function cmdSpec(rest: string[], args: ParsedArgs, format: OutputFormat): void {
       const [id] = subRest;
       if (!id) {
         console.error(
-          "Usage: feina spec set-content <SPEC-ID> --content text | --file path | --stdin",
+          "Usage: feinai spec set-content <SPEC-ID> --content text | --file path | --stdin",
         );
         process.exit(1);
       }
@@ -705,7 +711,7 @@ function cmdSpec(rest: string[], args: ParsedArgs, format: OutputFormat): void {
     case "start": {
       const [id] = subRest;
       if (!id) {
-        console.error("Usage: feina spec start <SPEC-ID>");
+        console.error("Usage: feinai spec start <SPEC-ID>");
         process.exit(1);
       }
       console.log(formatSpec(startSpec(db, id, actor), format));
@@ -714,7 +720,7 @@ function cmdSpec(rest: string[], args: ParsedArgs, format: OutputFormat): void {
     case "done": {
       const [id] = subRest;
       if (!id) {
-        console.error("Usage: feina spec done <SPEC-ID> [--pr N] [--merged YYYY-MM-DD]");
+        console.error("Usage: feinai spec done <SPEC-ID> [--pr N] [--merged YYYY-MM-DD]");
         process.exit(1);
       }
       const spec = doneSpec(
@@ -729,7 +735,7 @@ function cmdSpec(rest: string[], args: ParsedArgs, format: OutputFormat): void {
     case "edit": {
       const [id] = subRest;
       if (!id) {
-        console.error("Usage: feina spec edit <SPEC-ID> [--title text]");
+        console.error("Usage: feinai spec edit <SPEC-ID> [--title text]");
         process.exit(1);
       }
       const spec = editSpec(db, id, { title: args.options.title }, actor);
@@ -738,19 +744,19 @@ function cmdSpec(rest: string[], args: ParsedArgs, format: OutputFormat): void {
     }
     case "archive": {
       const [id] = subRest;
-      if (!id) { console.error("Usage: feina spec archive <SPEC-ID>"); process.exit(1); }
+      if (!id) { console.error("Usage: feinai spec archive <SPEC-ID>"); process.exit(1); }
       console.log(formatSpec(archiveSpec(db, id, actor), format));
       return;
     }
     case "unarchive": {
       const [id] = subRest;
-      if (!id) { console.error("Usage: feina spec unarchive <SPEC-ID>"); process.exit(1); }
+      if (!id) { console.error("Usage: feinai spec unarchive <SPEC-ID>"); process.exit(1); }
       console.log(formatSpec(unarchiveSpec(db, id, actor), format));
       return;
     }
     case "delete": {
       const [id] = subRest;
-      if (!id) { console.error("Usage: feina spec delete <SPEC-ID>"); process.exit(1); }
+      if (!id) { console.error("Usage: feinai spec delete <SPEC-ID>"); process.exit(1); }
       console.log(JSON.stringify(deleteSpec(db, id, actor)));
       return;
     }
@@ -789,7 +795,7 @@ async function cmdServer(args: ParsedArgs): Promise<void> {
 
   // Verify DB exists before starting server (fast fail)
   if (!findDbPath()) {
-    console.error("Error: no .tasca/tasca.db found. Run 'feina init' first.");
+    console.error("Error: no .tasca/tasca.db found. Run 'feinai init' first.");
     process.exit(2);
   }
 
@@ -836,7 +842,7 @@ function cmdPlan(rest: string[], args: ParsedArgs, format: OutputFormat): void {
       const [specId] = subRest;
       if (!specId) {
         console.error(
-          "Usage: feina plan add <SPEC-ID> --content text | --file path | --stdin",
+          "Usage: feinai plan add <SPEC-ID> --content text | --file path | --stdin",
         );
         process.exit(1);
       }
@@ -852,7 +858,7 @@ function cmdPlan(rest: string[], args: ParsedArgs, format: OutputFormat): void {
     case "show": {
       const [specId] = subRest;
       if (!specId) {
-        console.error("Usage: feina plan show <SPEC-ID>");
+        console.error("Usage: feinai plan show <SPEC-ID>");
         process.exit(1);
       }
       const plan = getLatestPlan(db, specId);
@@ -866,7 +872,7 @@ function cmdPlan(rest: string[], args: ParsedArgs, format: OutputFormat): void {
     case "list": {
       const [specId] = subRest;
       if (!specId) {
-        console.error("Usage: feina plan list <SPEC-ID>");
+        console.error("Usage: feinai plan list <SPEC-ID>");
         process.exit(1);
       }
       console.log(formatPlanList(listPlans(db, specId), format));