joycraft 0.6.15 → 0.6.17

package/dist/{chunk-YE4LWG2O.js → chunk-GWDLD7SH.js}

@@ -24,7 +24,7 @@ function ensureGitignoreEntries(targetDir, entries) {
 }
 function applyGitignoreProfile(targetDir, profile) {
   if (profile === "private") {
-    return ensureGitignoreEntries(targetDir, PRIVATE_PROFILE_IGNORES);
+    return ensureGitignoreEntries(targetDir, [...PRIVATE_PROFILE_IGNORES, STATE_PATH]);
   }
   return ensureGitignoreEntries(targetDir, [STATE_PATH]);
 }
@@ -77,10 +77,11 @@ async function resolveGitignoreProfile(opts) {
 }
 
 export {
+  PRIVATE_PROFILE_IGNORES,
   PRIVATE_DIRS_DISPLAY,
   PRIVATE_UNTRACK_COMMAND,
   applyGitignoreProfile,
   validateGitignoreFlag,
   resolveGitignoreProfile
 };
-//# sourceMappingURL=chunk-YE4LWG2O.js.map
+//# sourceMappingURL=chunk-GWDLD7SH.js.map

package/dist/chunk-GWDLD7SH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gitignore.ts"],"sourcesContent":["import { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { createInterface } from 'node:readline';\nimport {\n  STATE_PATH,\n  parseGitignoreProfile,\n  DEFAULT_GITIGNORE_PROFILE,\n  type GitignoreProfile,\n} from './version.js';\n\n/**\n * The harness directories the `private` profile gitignores. Tracking only\n * CLAUDE.md, AGENTS.md, and docs/ means everything under these three dirs\n * stays local. `.claude/` already covers the hidden state file.\n *\n * Single source of truth: every user-facing string that names these dirs\n * (prompts, summaries, the untrack hint, CLI help) derives from this list via\n * the constants below, so adding a harness dir can't leave stale messages.\n */\nexport const PRIVATE_PROFILE_IGNORES = ['.claude/', '.agents/', '.pi/'];\n\n/** Human-readable list of the private-profile dirs, for prompts and summaries. */\nexport const PRIVATE_DIRS_DISPLAY = PRIVATE_PROFILE_IGNORES.join(', ');\n\n/** Copy-pasteable command to untrack already-committed harness files. */\nexport const PRIVATE_UNTRACK_COMMAND = `git rm -r --cached ${PRIVATE_PROFILE_IGNORES.map((d) => d.replace(/\\/$/, '')).join(' ')}`;\n\n/**\n * Append-only, create-if-absent, idempotent .gitignore writer.\n *\n * Mirrors the \"append over modify when touching user files\" principle: it never\n * rewrites, reorders, or removes existing lines — it only appends the entries\n * not already present (matched exactly, after trimming). One read + at most one\n * write per call. Returns the entries actually added (empty when everything was\n * already present).\n */\nexport function ensureGitignoreEntries(targetDir: string, entries: string[]): string[] {\n  const gitignorePath = join(targetDir, '.gitignore');\n  const current = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf-8') : '';\n  const present = new Set(current.split('\\n').map((l) => l.trim()));\n  const missing = entries.filter((e) => !present.has(e.trim()));\n  if (missing.length === 0) return [];\n\n  // Append on their own lines, tolerating a file that may or may not end in \\n.\n  const sep = current.length > 0 && !current.endsWith('\\n') ? '\\n' : '';\n  writeFileSync(gitignorePath, current + sep + missing.join('\\n') + '\\n', 'utf-8');\n  return missing;\n}\n\n/** Single-entry convenience wrapper around ensureGitignoreEntries. */\nexport function ensureGitignoreEntry(targetDir: string, line: string): boolean {\n  return ensureGitignoreEntries(targetDir, [line]).length > 0;\n}\n\n/**\n * Apply a gitignore profile's entries to the project's .gitignore.\n *\n * The hidden upgrade-state file (`STATE_PATH`) is tool-managed, regenerated on\n * every init/upgrade, and must never be committed — under BOTH profiles. It now\n * lives at `docs/.joycraft/state.json`; since `docs/` is always tracked, the\n * state entry is no longer covered transitively by any harness-dir ignore, so\n * both profiles list it explicitly.\n *\n * - `shared`  — ignore only the hidden state file (commit the harness dirs).\n * - `private` — ignore the .claude/, .agents/, .pi/ trees AND the state file.\n *\n * Append-only and idempotent (via ensureGitignoreEntries), so re-running\n * init/upgrade never duplicates entries. Returns the list of lines actually\n * added this call.\n */\nexport function applyGitignoreProfile(targetDir: string, profile: GitignoreProfile): string[] {\n  if (profile === 'private') {\n    return ensureGitignoreEntries(targetDir, [...PRIVATE_PROFILE_IGNORES, STATE_PATH]);\n  }\n  // `shared`: only the hidden state file, matching long-standing behavior.\n  return ensureGitignoreEntries(targetDir, [STATE_PATH]);\n}\n\n/** A resolved profile plus how it was arrived at. */\nexport interface ResolvedGitignoreProfile {\n  profile: GitignoreProfile;\n  /**\n   * True when the profile is an actual decision: a --gitignore flag, a\n   * persisted choice, or an interactive answer. False when it is the\n   * non-interactive fallback default — callers must NOT persist a fallback,\n   * or the one-time prompt would be permanently suppressed for the project.\n   */\n  decided: boolean;\n}\n\n/** Validate a raw --gitignore flag value. Throws the user-facing error on unknown values. */\nexport function validateGitignoreFlag(flag: string): GitignoreProfile {\n  const parsed = parseGitignoreProfile(flag);\n  if (!parsed) {\n    throw new Error(`Unknown gitignore profile '${flag}'. Use 'shared' or 'private'.`);\n  }\n  return parsed;\n}\n\n/**\n * Prompt for a gitignore profile. An empty answer takes the default; an\n * unrecognized answer re-asks instead of being silently coerced — a typo must\n * not get persisted as a permanent choice.\n */\nasync function promptGitignoreProfile(intro: string): Promise<GitignoreProfile> {\n  const rl = createInterface({ input: process.stdin, output: process.stdout });\n  console.log(intro);\n  console.log('  shared  — commit skills so your team gets the same workflow (default)');\n  console.log(`  private — gitignore ${PRIVATE_DIRS_DISPLAY}; track only CLAUDE.md, AGENTS.md, docs/`);\n  return new Promise((resolve) => {\n    const ask = (): void => {\n      rl.question(`Profile [shared/private] (${DEFAULT_GITIGNORE_PROFILE}): `, (answer) => {\n        if (answer.trim() === '') {\n          rl.close();\n          resolve(DEFAULT_GITIGNORE_PROFILE);\n          return;\n        }\n        const parsed = parseGitignoreProfile(answer);\n        if (parsed) {\n          rl.close();\n          resolve(parsed);\n          return;\n        }\n        console.log(\n          `Unrecognized answer '${answer.trim()}' — type 'shared' or 'private', or press Enter for ${DEFAULT_GITIGNORE_PROFILE}.`\n        );\n        ask();\n      });\n    };\n    ask();\n  });\n}\n\n/**\n * Resolve the gitignore profile by precedence — the single resolver shared by\n * init and upgrade so the two commands can never drift:\n *   1. --gitignore flag (validated; throws on unknown value)\n *   2. profile persisted in state.json (re-init / upgrade keep the prior choice)\n *   3. interactive prompt (the caller decides when prompting is allowed)\n *   4. fallback default `shared`, reported with decided=false\n */\nexport async function resolveGitignoreProfile(opts: {\n  /** Raw --gitignore value from the CLI, if provided. */\n  flag?: string;\n  /** Profile previously persisted in state.json, if any. */\n  persisted?: GitignoreProfile;\n  /** Whether prompting is allowed (TTY, and the command permits interaction). */\n  interactive: boolean;\n  /** First line printed above the prompt; init and upgrade word it differently. */\n  promptIntro: string;\n}): Promise<ResolvedGitignoreProfile> {\n  if (opts.flag !== undefined) {\n    return { profile: validateGitignoreFlag(opts.flag), decided: true };\n  }\n  if (opts.persisted) {\n    return { profile: opts.persisted, decided: true };\n  }\n  if (opts.interactive) {\n    return { profile: await promptGitignoreProfile(opts.promptIntro), decided: true };\n  }\n  return { profile: DEFAULT_GITIGNORE_PROFILE, decided: false };\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,YAAY,cAAc,qBAAqB;AACxD,SAAS,YAAY;AACrB,SAAS,uBAAuB;AAiBzB,IAAM,0BAA0B,CAAC,YAAY,YAAY,MAAM;AAG/D,IAAM,uBAAuB,wBAAwB,KAAK,IAAI;AAG9D,IAAM,0BAA0B,sBAAsB,wBAAwB,IAAI,CAAC,MAAM,EAAE,QAAQ,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC;AAWxH,SAAS,uBAAuB,WAAmB,SAA6B;AACrF,QAAM,gBAAgB,KAAK,WAAW,YAAY;AAClD,QAAM,UAAU,WAAW,aAAa,IAAI,aAAa,eAAe,OAAO,IAAI;AACnF,QAAM,UAAU,IAAI,IAAI,QAAQ,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAChE,QAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,KAAK,CAAC,CAAC;AAC5D,MAAI,QAAQ,WAAW,EAAG,QAAO,CAAC;AAGlC,QAAM,MAAM,QAAQ,SAAS,KAAK,CAAC,QAAQ,SAAS,IAAI,IAAI,OAAO;AACnE,gBAAc,eAAe,UAAU,MAAM,QAAQ,KAAK,IAAI,IAAI,MAAM,OAAO;AAC/E,SAAO;AACT;AAuBO,SAAS,sBAAsB,WAAmB,SAAqC;AAC5F,MAAI,YAAY,WAAW;AACzB,WAAO,uBAAuB,WAAW,CAAC,GAAG,yBAAyB,UAAU,CAAC;AAAA,EACnF;AAEA,SAAO,uBAAuB,WAAW,CAAC,UAAU,CAAC;AACvD;AAeO,SAAS,sBAAsB,MAAgC;AACpE,QAAM,SAAS,sBAAsB,IAAI;AACzC,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,8BAA8B,IAAI,+BAA+B;AAAA,EACnF;AACA,SAAO;AACT;AAOA,eAAe,uBAAuB,OAA0C;AAC9E,QAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,UAAQ,IAAI,KAAK;AACjB,UAAQ,IAAI,8EAAyE;AACrF,UAAQ,IAAI,8BAAyB,oBAAoB,0CAA0C;AACnG,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,MAAM,MAAY;AACtB,SAAG,SAAS,6BAA6B,yBAAyB,OAAO,CAAC,WAAW;AACnF,YAAI,OAAO,KAAK,MAAM,IAAI;AACxB,aAAG,MAAM;AACT,kBAAQ,yBAAyB;AACjC;AAAA,QACF;AACA,cAAM,SAAS,sBAAsB,MAAM;AAC3C,YAAI,QAAQ;AACV,aAAG,MAAM;AACT,kBAAQ,MAAM;AACd;AAAA,QACF;AACA,gBAAQ;AAAA,UACN,wBAAwB,OAAO,KAAK,CAAC,2DAAsD,yBAAyB;AAAA,QACtH;AACA,YAAI;AAAA,MACN,CAAC;AAAA,IACH;AACA,QAAI;AAAA,EACN,CAAC;AACH;AAUA,eAAsB,wBAAwB,MASR;AACpC,MAAI,KAAK,SAAS,QAAW;AAC3B,WAAO,EAAE,SAAS,sBAAsB,KAAK,IAAI,GAAG,SAAS,KAAK;AAAA,EACpE;AACA,MAAI,KAAK,WAAW;AAClB,WAAO,EAAE,SAAS,KAAK,WAAW,SAAS,KAAK;AAAA,EAClD;AACA,MAAI,KAAK,aAAa;AACpB,WAAO,EAAE,SAAS,MAAM,uBAAuB,KAAK,WAAW,GAAG,SAAS,KAAK;AAAA,EAClF;AACA,SAAO,EAAE,SAAS,2BAA2B,SAAS,MAAM;AAC9D;","names":[]}

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   PRIVATE_DIRS_DISPLAY
-} from "./chunk-YE4LWG2O.js";
+} from "./chunk-GWDLD7SH.js";
 import "./chunk-34IWIKXS.js";
 
 // src/cli.ts
@@ -15,7 +15,7 @@ var GITIGNORE_OPTION_DESC = `Gitignore profile: 'shared' (commit skills) or 'pri
 var program = new Command();
 program.name("joycraft").description("Scaffold and upgrade AI development harnesses").version(pkg.version, "-v, --version");
 program.command("init").description("Scaffold the Joycraft harness into the current project").argument("[dir]", "Target directory", ".").option("--force", "Overwrite existing files").option("--gitignore <profile>", GITIGNORE_OPTION_DESC).action(async (dir, opts) => {
-  const { init } = await import("./init-LXSMLAY5.js");
+  const { init } = await import("./init-OO77DURX.js");
   try {
     await init(dir, { force: opts.force ?? false, gitignore: opts.gitignore });
   } catch (err) {
@@ -24,7 +24,7 @@ program.command("init").description("Scaffold the Joycraft harness into the curr
   }
 });
 program.command("upgrade").description("Upgrade installed Joycraft templates and skills to latest").argument("[dir]", "Target directory", ".").option("--yes", "Auto-accept all updates").option("--gitignore <profile>", GITIGNORE_OPTION_DESC).action(async (dir, opts) => {
-  const { upgrade } = await import("./upgrade-P3JZS7NM.js");
+  const { upgrade } = await import("./upgrade-VKQ54KRD.js");
   try {
     await upgrade(dir, { yes: opts.yes ?? false, gitignore: opts.gitignore });
   } catch (err) {
@@ -33,7 +33,7 @@ program.command("upgrade").description("Upgrade installed Joycraft templates and
   }
 });
 program.command("init-autofix").description("Set up the Level 5 auto-fix loop with holdout scenarios").argument("[dir]", "Target directory", ".").option("--scenarios-repo <name>", "Name for scenarios repo").option("--app-id <id>", "GitHub App ID for Joycraft Autofix").option("--force", "Overwrite existing workflow files").option("--dry-run", "Show what would be created without creating it").action(async (dir, opts) => {
-  const { initAutofix } = await import("./init-autofix-OZW5ITFI.js");
+  const { initAutofix } = await import("./init-autofix-6GMXHF5F.js");
   await initAutofix(dir, opts);
 });
 program.command("check-version").description("Check if a newer version of Joycraft is available").action(async () => {

package/dist/{init-LXSMLAY5.js → init-OO77DURX.js}

@@ -7,7 +7,7 @@ import {
   PRIVATE_UNTRACK_COMMAND,
   applyGitignoreProfile,
   resolveGitignoreProfile
-} from "./chunk-YE4LWG2O.js";
+} from "./chunk-GWDLD7SH.js";
 import {
   CODEX_SKILLS,
   PI_AGENTS,
@@ -16,7 +16,7 @@ import {
   PI_SKILLS,
   SKILLS,
   TEMPLATES
-} from "./chunk-XOMQIK4U.js";
+} from "./chunk-3JVMOJTA.js";
 import {
   DEFAULT_GITIGNORE_PROFILE,
   STATE_PATH,
@@ -27,8 +27,8 @@ import {
 } from "./chunk-34IWIKXS.js";
 
 // src/init.ts
-import { mkdirSync as mkdirSync2, existsSync as existsSync4, writeFileSync as writeFileSync2, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync, chmodSync } from "fs";
-import { join as join4, basename, resolve, dirname } from "path";
+import { mkdirSync as mkdirSync2, existsSync as existsSync5, writeFileSync as writeFileSync3, readFileSync as readFileSync4, readdirSync as readdirSync2, statSync, chmodSync } from "fs";
+import { join as join5, basename, resolve, dirname } from "path";
 
 // src/detect.ts
 import { readFileSync, existsSync, readdirSync } from "fs";
@@ -313,7 +313,7 @@ import { existsSync as existsSync2 } from "fs";
 import { join as join2 } from "path";
 var PRIVATE_SETUP_NOTE_MARKER = "After cloning, run";
 function generatePrivateSetupNote() {
-  return `> **Private setup:** The harness dirs (\`.claude/\`, \`.agents/\`, \`.pi/\`) are gitignored in this repo, so they aren't committed. ${PRIVATE_SETUP_NOTE_MARKER} \`npx joycraft init\` to regenerate the skill files locally.`;
+  return `> **Private setup:** The harness dirs (\`.claude/\`, \`.agents/\`, \`.pi/\`) are gitignored in this repo, so they aren't committed. ${PRIVATE_SETUP_NOTE_MARKER} \`npx joycraft init\` to regenerate the skill files locally \u2014 it only creates missing files and leaves your committed \`CLAUDE.md\`, \`AGENTS.md\`, and \`docs/\` untouched (use \`--force\` only if you deliberately want to regenerate them).`;
 }
 function generateCommandsBlock(stack) {
   const lines = ["```bash"];
@@ -365,7 +365,9 @@ ${generateCommandsBlock(stack)}
 
 **Default execution mode:** batch
 
-_How \`/joycraft-implement\` wraps up after each spec. \`joycraft-decompose\` reads this line (absent \u21D2 \`batch\`) and recommends a per-spec mode you approve. Modes: \`batch\` (implement a cluster, wrap once at the end), \`checkpoint\` (commit + status bump after each spec), \`isolated\` (fresh context per spec \u2014 on Pi, the \`joycraft-implement-loop\` driver). Change the value above to set your project default._`;
+_How \`/joycraft-implement\` wraps up after each spec. \`joycraft-decompose\` reads this line (absent \u21D2 \`batch\`) and recommends a per-spec mode you approve. Modes: \`batch\` (implement a cluster, wrap once at the end), \`checkpoint\` (commit + status bump after each spec), \`isolated\` (fresh context per spec \u2014 on Pi, the \`joycraft-implement-loop\` driver). Change the value above to set your project default._
+
+**Deferred work \u2192 \`docs/backlog/\`.** Ideas and follow-ups you surface mid-sprint but can't take on now go to \`docs/backlog/\` (one file per item) so the current spec stays focused without losing the thread. Promote an entry to a Feature Brief under \`docs/features/<slug>/\` when you're ready to build it.`;
 }
 function generateArchitectureSection() {
   return `## Architecture
@@ -487,7 +489,9 @@ function generateExternalApiSafetySection() {
 function generateDevelopmentSection(stack) {
   return `## Development
 
-${generateCommandsBlock2(stack)}`;
+${generateCommandsBlock2(stack)}
+
+**Deferred work \u2192 \`docs/backlog/\`.** Ideas and follow-ups surfaced mid-sprint that can't be taken on now go to \`docs/backlog/\` (one file per item) so the current spec stays focused. Promote an entry to a Feature Brief under \`docs/features/<slug>/\` when ready to build it.`;
 }
 function generateArchitectureSection2() {
   return `## Architecture
@@ -713,25 +717,113 @@ function installSafeguardHooks(targetDir, customPatterns = [], force = false, sk
   return result;
 }
 
+// src/tsconfig.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
+var PI_EXCLUDE = ".pi";
+function stripJsonComments(text) {
+  return text.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
+}
+function alreadyExcludesPi(rawText) {
+  try {
+    const parsed = JSON.parse(stripJsonComments(rawText));
+    if (!Array.isArray(parsed.exclude)) return false;
+    return parsed.exclude.some(
+      (e) => typeof e === "string" && (e === PI_EXCLUDE || e === "./.pi" || e === ".pi/**")
+    );
+  } catch {
+    return false;
+  }
+}
+function insertPiExclude(rawText) {
+  const excludeArrayRe = /("exclude"\s*:\s*\[)(\s*)/;
+  if (excludeArrayRe.test(rawText)) {
+    return rawText.replace(excludeArrayRe, (_m, open, ws) => {
+      const sep = ws.includes("\n") ? ws : " ";
+      return `${open}${sep}"${PI_EXCLUDE}",${ws.includes("\n") ? "" : " "}`;
+    });
+  }
+  const includeArrayRe = /("include"\s*:\s*\[[^\]]*\])/;
+  if (includeArrayRe.test(rawText)) {
+    return rawText.replace(includeArrayRe, (m) => `${m},
+  "exclude": ["${PI_EXCLUDE}"]`);
+  }
+  const lastBrace = rawText.lastIndexOf("}");
+  if (lastBrace > 0 && rawText.slice(0, lastBrace).includes(":")) {
+    const before = rawText.slice(0, lastBrace).replace(/\s*$/, "");
+    const after = rawText.slice(lastBrace);
+    const needsComma = !before.endsWith(",") && !before.endsWith("{");
+    return `${before}${needsComma ? "," : ""}
+  "exclude": ["${PI_EXCLUDE}"]
+${after}`;
+  }
+  return null;
+}
+function ensurePiExcludedFromTsconfig(targetDir) {
+  const path = join4(targetDir, "tsconfig.json");
+  if (!existsSync4(path)) return { status: "no-tsconfig" };
+  let rawText;
+  try {
+    rawText = readFileSync3(path, "utf-8");
+  } catch {
+    return { status: "skipped", reason: "tsconfig.json could not be read" };
+  }
+  if (alreadyExcludesPi(rawText)) {
+    return { status: "already-present", path };
+  }
+  const updated = insertPiExclude(rawText);
+  if (updated === null || updated === rawText) {
+    return {
+      status: "skipped",
+      reason: 'could not safely edit tsconfig.json \u2014 add ".pi" to its "exclude" array manually so the Pi extension stays out of your TypeScript build'
+    };
+  }
+  if (!alreadyExcludesPi(updated)) {
+    return {
+      status: "skipped",
+      reason: 'tsconfig.json edit could not be verified \u2014 add ".pi" to its "exclude" array manually'
+    };
+  }
+  try {
+    writeFileSync2(path, updated, "utf-8");
+  } catch {
+    return { status: "skipped", reason: "tsconfig.json could not be written" };
+  }
+  return { status: "added", path };
+}
+
 // src/init.ts
+var BACKLOG_README = `# Backlog
+
+Deferred work lives here \u2014 ideas and follow-ups you surface mid-sprint but
+can't take on in the current feature. Capturing them keeps the current spec
+focused without losing the thread.
+
+- One file per item: \`docs/backlog/YYYY-MM-DD-<short-name>.md\`.
+- Joycraft skills (\`/joycraft-interview\`, \`/joycraft-new-feature\`,
+  \`/joycraft-design\`) offer to write entries here \u2014 always with your
+  confirmation, never automatically.
+- Promote an item by turning it into a Feature Brief under
+  \`docs/features/<slug>/\` when you're ready to build it.
+`;
 function ensureDir(dir) {
-  if (!existsSync4(dir)) {
+  if (!existsSync5(dir)) {
     mkdirSync2(dir, { recursive: true });
   }
 }
 function writeFile(path, content, force, result) {
-  if (existsSync4(path) && !force) {
+  if (existsSync5(path) && !force) {
     result.skipped.push(path);
     return;
   }
-  writeFileSync2(path, content, "utf-8");
+  writeFileSync3(path, content, "utf-8");
   result.created.push(path);
 }
 async function init(dir, opts) {
   const targetDir = resolve(dir);
   const result = { created: [], skipped: [], modified: [], warnings: [] };
   const stack = await detectStack(targetDir);
-  const isPi = existsSync4(join4(targetDir, ".pi"));
+  const isPi = existsSync5(join5(targetDir, ".pi"));
   const harnesses = await resolveHarnesses(process.stdin.isTTY === true);
   const wants = (h) => harnesses.includes(h);
   if (harnesses.length === 0) {
@@ -746,14 +838,16 @@ async function init(dir, opts) {
     interactive: process.stdin.isTTY === true,
     promptIntro: "\nHow should Joycraft files be tracked in git?"
   });
-  ensureDir(join4(targetDir, "docs", "context"));
-  const skillsDir = join4(targetDir, ".claude", "skills");
+  ensureDir(join5(targetDir, "docs", "context"));
+  ensureDir(join5(targetDir, "docs", "backlog"));
+  writeFile(join5(targetDir, "docs", "backlog", "README.md"), BACKLOG_README, opts.force, result);
+  const skillsDir = join5(targetDir, ".claude", "skills");
   let existingSkills = [];
-  if (wants("claude") && existsSync4(skillsDir)) {
+  if (wants("claude") && existsSync5(skillsDir)) {
     existingSkills = readdirSync2(skillsDir).filter((name) => {
       if (name.startsWith("joycraft-")) return false;
       if (name.startsWith(".")) return false;
-      const fullPath = join4(skillsDir, name);
+      const fullPath = join5(skillsDir, name);
       try {
         return statSync(fullPath).isDirectory();
       } catch {
@@ -764,32 +858,32 @@ async function init(dir, opts) {
   if (wants("claude")) {
     for (const [filename, content] of Object.entries(SKILLS)) {
       const skillName = filename.replace(/\.md$/, "");
-      const skillDir = join4(skillsDir, skillName);
+      const skillDir = join5(skillsDir, skillName);
       ensureDir(skillDir);
-      writeFile(join4(skillDir, "SKILL.md"), content, opts.force, result);
+      writeFile(join5(skillDir, "SKILL.md"), content, opts.force, result);
     }
   }
   if (wants("codex")) {
-    const codexSkillsDir = join4(targetDir, ".agents", "skills");
+    const codexSkillsDir = join5(targetDir, ".agents", "skills");
     for (const [filename, content] of Object.entries(CODEX_SKILLS)) {
       const skillName = filename.replace(/\.md$/, "");
-      const skillDir = join4(codexSkillsDir, skillName);
+      const skillDir = join5(codexSkillsDir, skillName);
       ensureDir(skillDir);
-      writeFile(join4(skillDir, "SKILL.md"), content, opts.force, result);
+      writeFile(join5(skillDir, "SKILL.md"), content, opts.force, result);
     }
   }
   if (wants("pi")) {
-    const piSkillsDir = join4(targetDir, ".pi", "skills");
+    const piSkillsDir = join5(targetDir, ".pi", "skills");
     for (const [filename, content] of Object.entries(PI_SKILLS)) {
       const skillName = filename.replace(/\.md$/, "");
-      const skillDir = join4(piSkillsDir, skillName);
+      const skillDir = join5(piSkillsDir, skillName);
       ensureDir(skillDir);
-      writeFile(join4(skillDir, "SKILL.md"), content, opts.force, result);
+      writeFile(join5(skillDir, "SKILL.md"), content, opts.force, result);
     }
-    const piScriptsDir = join4(targetDir, ".pi", "scripts", "joycraft");
+    const piScriptsDir = join5(targetDir, ".pi", "scripts", "joycraft");
     ensureDir(piScriptsDir);
     for (const [name, content] of Object.entries(PI_SCRIPTS)) {
-      const scriptPath = join4(piScriptsDir, name);
+      const scriptPath = join5(piScriptsDir, name);
       writeFile(scriptPath, content, opts.force, result);
       if (name !== "README.md") {
         try {
@@ -798,78 +892,89 @@ async function init(dir, opts) {
         }
       }
     }
-    const piExtDir = join4(targetDir, ".pi", "extensions");
+    const piExtDir = join5(targetDir, ".pi", "extensions");
     ensureDir(piExtDir);
     for (const [name, content] of Object.entries(PI_EXTENSIONS)) {
-      writeFile(join4(piExtDir, name), content, opts.force, result);
+      writeFile(join5(piExtDir, name), content, opts.force, result);
     }
-    const piAgentsDir = join4(targetDir, ".pi", "agents");
+    const piAgentsDir = join5(targetDir, ".pi", "agents");
     ensureDir(piAgentsDir);
     for (const [name, content] of Object.entries(PI_AGENTS)) {
-      writeFile(join4(piAgentsDir, name), content, opts.force, result);
+      writeFile(join5(piAgentsDir, name), content, opts.force, result);
     }
   }
-  const templatesDir = join4(targetDir, "docs", "templates");
+  const templatesDir = join5(targetDir, "docs", "templates");
   ensureDir(templatesDir);
   for (const [filename, content] of Object.entries(TEMPLATES)) {
-    ensureDir(dirname(join4(templatesDir, filename)));
-    writeFile(join4(templatesDir, filename), content, opts.force, result);
+    ensureDir(dirname(join5(templatesDir, filename)));
+    writeFile(join5(templatesDir, filename), content, opts.force, result);
   }
-  const claudeMdPath = join4(targetDir, "CLAUDE.md");
-  if (existsSync4(claudeMdPath) && !opts.force) {
+  const claudeMdPath = join5(targetDir, "CLAUDE.md");
+  if (existsSync5(claudeMdPath) && !opts.force) {
     result.skipped.push(claudeMdPath);
   } else {
     const projectName = basename(targetDir);
     const content = generateCLAUDEMd(projectName, stack, existingSkills, {
       privateProfile: gitignoreProfile === "private"
     });
-    writeFileSync2(claudeMdPath, content, "utf-8");
+    writeFileSync3(claudeMdPath, content, "utf-8");
     result.created.push(claudeMdPath);
   }
-  const agentsMdPath = join4(targetDir, "AGENTS.md");
-  if (existsSync4(agentsMdPath) && !opts.force) {
+  const agentsMdPath = join5(targetDir, "AGENTS.md");
+  if (existsSync5(agentsMdPath) && !opts.force) {
     result.skipped.push(agentsMdPath);
   } else {
     const projectName = basename(targetDir);
     const content = generateAgentsMd(projectName, stack, gitignoreProfile === "private");
-    writeFileSync2(agentsMdPath, content, "utf-8");
+    writeFileSync3(agentsMdPath, content, "utf-8");
     result.created.push(agentsMdPath);
   }
   const fileHashes = {};
   if (wants("claude")) {
     for (const [filename, content] of Object.entries(SKILLS)) {
       const skillName = filename.replace(/\.md$/, "");
-      fileHashes[join4(".claude", "skills", skillName, "SKILL.md")] = hashContent(content);
+      fileHashes[join5(".claude", "skills", skillName, "SKILL.md")] = hashContent(content);
     }
   }
   if (wants("codex")) {
     for (const [filename, content] of Object.entries(CODEX_SKILLS)) {
       const skillName = filename.replace(/\.md$/, "");
-      fileHashes[join4(".agents", "skills", skillName, "SKILL.md")] = hashContent(content);
+      fileHashes[join5(".agents", "skills", skillName, "SKILL.md")] = hashContent(content);
     }
   }
   for (const [filename, content] of Object.entries(TEMPLATES)) {
-    fileHashes[join4("docs", "templates", filename)] = hashContent(content);
+    fileHashes[join5("docs", "templates", filename)] = hashContent(content);
   }
   if (wants("pi")) {
     for (const [filename, content] of Object.entries(PI_SKILLS)) {
       const skillName = filename.replace(/\.md$/, "");
-      fileHashes[join4(".pi", "skills", skillName, "SKILL.md")] = hashContent(content);
+      fileHashes[join5(".pi", "skills", skillName, "SKILL.md")] = hashContent(content);
     }
     for (const [name, content] of Object.entries(PI_SCRIPTS)) {
-      fileHashes[join4(".pi", "scripts", "joycraft", name)] = hashContent(content);
+      fileHashes[join5(".pi", "scripts", "joycraft", name)] = hashContent(content);
     }
     for (const [name, content] of Object.entries(PI_EXTENSIONS)) {
-      fileHashes[join4(".pi", "extensions", name)] = hashContent(content);
+      fileHashes[join5(".pi", "extensions", name)] = hashContent(content);
     }
     for (const [name, content] of Object.entries(PI_AGENTS)) {
-      fileHashes[join4(".pi", "agents", name)] = hashContent(content);
+      fileHashes[join5(".pi", "agents", name)] = hashContent(content);
     }
   }
   writeVersion(targetDir, getPackageVersion(), fileHashes, gitignoreProfile, harnesses);
   applyGitignoreProfile(targetDir, gitignoreProfile);
+  if (wants("pi")) {
+    const outcome = ensurePiExcludedFromTsconfig(targetDir);
+    if (outcome.status === "added") {
+      result.modified.push(outcome.path);
+      result.warnings.push(
+        'Added ".pi" to tsconfig.json "exclude" so the Pi extension stays out of your TypeScript build.'
+      );
+    } else if (outcome.status === "skipped") {
+      result.warnings.push(outcome.reason);
+    }
+  }
   if (wants("claude")) {
-    const hooksDir = join4(targetDir, ".claude", "hooks");
+    const hooksDir = join5(targetDir, ".claude", "hooks");
     ensureDir(hooksDir);
     const hookScript = `// Joycraft version check \u2014 runs on Claude Code session start
 import { readFileSync } from 'node:fs';
@@ -883,13 +988,13 @@ try {
   }
 } catch {}
 `;
-    writeFile(join4(hooksDir, "joycraft-version-check.mjs"), hookScript, opts.force, result);
-    const settingsPath = join4(targetDir, ".claude", "settings.json");
+    writeFile(join5(hooksDir, "joycraft-version-check.mjs"), hookScript, opts.force, result);
+    const settingsPath = join5(targetDir, ".claude", "settings.json");
     let settings = {};
     let settingsMalformed = false;
-    if (existsSync4(settingsPath)) {
+    if (existsSync5(settingsPath)) {
       try {
-        settings = JSON.parse(readFileSync3(settingsPath, "utf-8"));
+        settings = JSON.parse(readFileSync4(settingsPath, "utf-8"));
       } catch {
         settingsMalformed = true;
         result.warnings.push(
@@ -922,13 +1027,13 @@ try {
         });
       }
       if (!hasJoycraftHook || envMissing) {
-        writeFileSync2(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+        writeFileSync3(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
         if (!result.created.includes(settingsPath)) result.created.push(settingsPath);
       }
       const permissions = generatePermissions(stack);
-      if (existsSync4(settingsPath)) {
+      if (existsSync5(settingsPath)) {
         try {
-          settings = JSON.parse(readFileSync3(settingsPath, "utf-8"));
+          settings = JSON.parse(readFileSync4(settingsPath, "utf-8"));
         } catch {
           result.warnings.push(
             "settings.json became unreadable after hook merge \u2014 skipping permissions merge.\n    Fix the JSON in .claude/settings.json and re-run init."
@@ -947,7 +1052,7 @@ try {
         for (const rule of permissions.deny) {
           if (!perms.deny.includes(rule)) perms.deny.push(rule);
         }
-        writeFileSync2(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+        writeFileSync3(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
       }
     }
     const hookResult = installSafeguardHooks(targetDir, [], opts.force, settingsMalformed);
@@ -955,9 +1060,9 @@ try {
     result.skipped.push(...hookResult.skipped);
   }
   if (gitignoreProfile === "shared" && wants("claude")) {
-    const gitignorePath = join4(targetDir, ".gitignore");
-    if (existsSync4(gitignorePath)) {
-      const gitignore = readFileSync3(gitignorePath, "utf-8");
+    const gitignorePath = join5(targetDir, ".gitignore");
+    if (existsSync5(gitignorePath)) {
+      const gitignore = readFileSync4(gitignorePath, "utf-8");
       if (/^\.claude\/?$/m.test(gitignore) || /^\.claude\/\*$/m.test(gitignore)) {
         result.warnings.push(
           ".claude/ is in your .gitignore \u2014 teammates won't get Joycraft skills.\n    Add this line to .gitignore to fix: !.claude/skills/"
@@ -1041,4 +1146,4 @@ function printSummary(result, stack, existingSkills = [], isPi = false, gitignor
 export {
   init
 };
-//# sourceMappingURL=init-LXSMLAY5.js.map
+//# sourceMappingURL=init-OO77DURX.js.map