joycraft 0.6.9 → 0.6.11

package/README.md

@@ -78,6 +78,33 @@ Joycraft auto-detects your tech stack and creates:
 - **Context documents** in `docs/context/`: production map, dangerous assumptions, decision log, institutional knowledge, and troubleshooting guide
 - **Templates** including atomic spec, feature brief, implementation plan, boundary framework, and workflow templates for scenario generation and autofix loops
 
+### Git tracking: shared vs private
+
+By default Joycraft assumes you want to **commit** the harness so your whole team
+gets the same skills and workflow. Some teams prefer to keep the harness local
+and track only the docs. Choose a profile at init time:
+
+```bash
+npx joycraft init --gitignore=shared    # default — commit .claude/, .agents/, .pi/
+npx joycraft init --gitignore=private   # gitignore them; track only CLAUDE.md, AGENTS.md, docs/
+```
+
+Run interactively without the flag and `init` will ask. The choice is saved, so
+`npx joycraft upgrade` re-applies it automatically. To switch an existing
+project later (or decide from CI), pass the same flag to upgrade:
+`npx joycraft upgrade --gitignore=private`. `.gitignore` edits are
+append-only — Joycraft never rewrites or removes your existing lines.
+
+| Profile | Tracked in git | Gitignored |
+|---------|----------------|------------|
+| `shared` (default) | `CLAUDE.md`, `AGENTS.md`, `docs/`, `.claude/skills/`, `.agents/`, `.pi/` | hidden upgrade state only |
+| `private` | `CLAUDE.md`, `AGENTS.md`, `docs/` | `.claude/`, `.agents/`, `.pi/` |
+
+> Switching an existing project to `private` only updates `.gitignore`. If
+> harness files were already committed, untrack them with
+> `git rm -r --cached .claude .agents .pi` (Joycraft prints this reminder and
+> never runs git for you).
+
 ### Supported Stacks
 
 Node.js (npm/pnpm/yarn/bun), Python (poetry/pip/uv), Rust, Go, Swift, and generic (Makefile/Dockerfile).

package/dist/chunk-IELXGWSH.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+// src/package-version.ts
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function getPackageVersion() {
+  const pkgPath = join(__dirname, "..", "package.json");
+  const raw = readFileSync(pkgPath, "utf-8");
+  const pkg = JSON.parse(raw);
+  if (typeof pkg.version !== "string" || pkg.version.length === 0) {
+    throw new Error(`Joycraft package.json at ${pkgPath} is missing a version field`);
+  }
+  return pkg.version;
+}
+
+export {
+  getPackageVersion
+};
+//# sourceMappingURL=chunk-IELXGWSH.js.map

package/dist/chunk-IELXGWSH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/package-version.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport { dirname, join } from 'node:path';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport function getPackageVersion(): string {\n  const pkgPath = join(__dirname, '..', 'package.json');\n  const raw = readFileSync(pkgPath, 'utf-8');\n  const pkg = JSON.parse(raw) as { version?: unknown };\n  if (typeof pkg.version !== 'string' || pkg.version.length === 0) {\n    throw new Error(`Joycraft package.json at ${pkgPath} is missing a version field`);\n  }\n  return pkg.version;\n}\n"],"mappings":";;;AAAA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,SAAS,YAAY;AAE9B,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAEjD,SAAS,oBAA4B;AAC1C,QAAM,UAAU,KAAK,WAAW,MAAM,cAAc;AACpD,QAAM,MAAM,aAAa,SAAS,OAAO;AACzC,QAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,MAAI,OAAO,IAAI,YAAY,YAAY,IAAI,QAAQ,WAAW,GAAG;AAC/D,UAAM,IAAI,MAAM,4BAA4B,OAAO,6BAA6B;AAAA,EAClF;AACA,SAAO,IAAI;AACb;","names":[]}

package/dist/{chunk-63OWWRAJ.js → chunk-TD65VH2W.js}

@@ -7,6 +7,11 @@ import { createHash } from "crypto";
 var STATE_PATH = join(".claude", ".joycraft", "state.json");
 var LEGACY_VERSION_FILE = ".joycraft-version";
 var HASH_LENGTH = 16;
+var DEFAULT_GITIGNORE_PROFILE = "shared";
+function parseGitignoreProfile(value) {
+  const v = typeof value === "string" ? value.trim().toLowerCase() : value;
+  return v === "shared" || v === "private" ? v : null;
+}
 function hashContent(content) {
   return createHash("sha256").update(content).digest("hex");
 }
@@ -20,20 +25,30 @@ function readVersion(dir) {
     const raw = readFileSync(filePath, "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.version === "string" && typeof parsed.files === "object") {
-      return parsed;
+      const profile = parseGitignoreProfile(parsed.gitignoreProfile);
+      return {
+        version: parsed.version,
+        files: parsed.files,
+        ...profile ? { gitignoreProfile: profile } : {}
+      };
     }
     return null;
   } catch {
     return null;
   }
 }
-function writeVersion(dir, version, files) {
+function writeVersion(dir, version, files, gitignoreProfile) {
   const filePath = join(dir, STATE_PATH);
+  const profile = gitignoreProfile ?? readVersion(dir)?.gitignoreProfile;
   const truncated = {};
   for (const [path, hash] of Object.entries(files)) {
     truncated[path] = truncateHash(hash);
   }
-  const data = { version, files: truncated };
+  const data = {
+    version,
+    files: truncated,
+    ...profile ? { gitignoreProfile: profile } : {}
+  };
   mkdirSync(dirname(filePath), { recursive: true });
   writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
 }
@@ -49,10 +64,12 @@ function getLevel(dir) {
 export {
   STATE_PATH,
   LEGACY_VERSION_FILE,
+  DEFAULT_GITIGNORE_PROFILE,
+  parseGitignoreProfile,
   hashContent,
   truncateHash,
   readVersion,
   writeVersion,
   getLevel
 };
-//# sourceMappingURL=chunk-63OWWRAJ.js.map
+//# sourceMappingURL=chunk-TD65VH2W.js.map

package/dist/chunk-TD65VH2W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { join, dirname } from 'node:path';\nimport { createHash } from 'node:crypto';\n\n/**\n * Project-relative path to Joycraft's upgrade-state file.\n *\n * Hidden inside `.claude/` — the dir `init` always creates for every harness —\n * directly analogous to npm's own hidden lockfile at\n * `node_modules/.package-lock.json`. Never at the repo root, never committed\n * (init/upgrade gitignore it). The old root location was `.joycraft-version`\n * (see LEGACY_VERSION_FILE); `upgrade` migrates it on first run.\n */\nexport const STATE_PATH = join('.claude', '.joycraft', 'state.json');\n\n/** The pre-relocation root path. Kept only so `upgrade` can migrate it. */\nexport const LEGACY_VERSION_FILE = '.joycraft-version';\n\n/**\n * Length we truncate stored hashes to. Full SHA-256 is 64 hex chars; 16 hex\n * (64 bits) is ample to detect customization across ~100 managed files and\n * shrinks the state ~4×. Compare truncated-on-both-sides (see upgrade.ts).\n */\nconst HASH_LENGTH = 16;\n\n/**\n * How much of the Joycraft harness is tracked in git.\n * - `shared`  — commit skills/agents/pi so teammates get the workflow (default).\n * - `private` — gitignore .claude/, .agents/, .pi/; track only CLAUDE.md,\n *   AGENTS.md, and docs/.\n */\nexport type GitignoreProfile = 'shared' | 'private';\n\nexport const DEFAULT_GITIGNORE_PROFILE: GitignoreProfile = 'shared';\n\n/**\n * Narrow an arbitrary value to a GitignoreProfile, or null if unrecognized.\n * Strings are normalized (trim + lowercase) here so every call site — flag,\n * prompt, persisted state — gets the same case-insensitivity for free.\n */\nexport function parseGitignoreProfile(value: unknown): GitignoreProfile | null {\n  const v = typeof value === 'string' ? value.trim().toLowerCase() : value;\n  return v === 'shared' || v === 'private' ? v : null;\n}\n\nexport interface VersionInfo {\n  version: string;\n  files: Record<string, string>;\n  /**\n   * The gitignore profile chosen at init/upgrade. Absent on state written by\n   * Joycraft versions before this field existed — treat absent as `shared`.\n   */\n  gitignoreProfile?: GitignoreProfile;\n}\n\nexport function hashContent(content: string): string {\n  return createHash('sha256').update(content).digest('hex');\n}\n\n/** Truncate a (full) content hash to the stored length. Idempotent for already-short input. */\nexport function truncateHash(hash: string): string {\n  return hash.slice(0, HASH_LENGTH);\n}\n\nexport function readVersion(dir: string): VersionInfo | null {\n  const filePath = join(dir, STATE_PATH);\n  if (!existsSync(filePath)) return null;\n  try {\n    const raw = readFileSync(filePath, 'utf-8');\n    const parsed = JSON.parse(raw);\n    if (typeof parsed.version === 'string' && typeof parsed.files === 'object') {\n      // Sanitize the profile: ignore unknown/legacy values rather than\n      // returning them (absent or bogus → undefined, callers default to shared).\n      const profile = parseGitignoreProfile(parsed.gitignoreProfile);\n      return {\n        version: parsed.version,\n        files: parsed.files,\n        ...(profile ? { gitignoreProfile: profile } : {}),\n      };\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\nexport function writeVersion(\n  dir: string,\n  version: string,\n  files: Record<string, string>,\n  gitignoreProfile?: GitignoreProfile\n): void {\n  const filePath = join(dir, STATE_PATH);\n  // An omitted profile means \"no new decision\", not \"clear it\": preserve\n  // whatever is already persisted so call sites that only refresh\n  // version/hashes can never silently strip a saved choice.\n  const profile = gitignoreProfile ?? readVersion(dir)?.gitignoreProfile;\n  // Store truncated hashes — single source of truth for the on-disk shape.\n  const truncated: Record<string, string> = {};\n  for (const [path, hash] of Object.entries(files)) {\n    truncated[path] = truncateHash(hash);\n  }\n  const data: VersionInfo = {\n    version,\n    files: truncated,\n    ...(profile ? { gitignoreProfile: profile } : {}),\n  };\n  mkdirSync(dirname(filePath), { recursive: true });\n  writeFileSync(filePath, JSON.stringify(data, null, 2) + '\\n', 'utf-8');\n}\n\n/**\n * Detect the current Joycraft harness level for a project directory.\n * Returns 5 if Level 5 artifacts (autofix workflow + External Validation) are present, 4 otherwise.\n */\nexport function getLevel(dir: string): number {\n  const hasAutofix = existsSync(join(dir, '.github', 'workflows', 'autofix.yml'));\n  if (!hasAutofix) return 4;\n  const claudeMdPath = join(dir, 'CLAUDE.md');\n  if (!existsSync(claudeMdPath)) return 4;\n  const content = readFileSync(claudeMdPath, 'utf-8');\n  return content.includes('## External Validation') ? 5 : 4;\n}\n"],"mappings":";;;AAAA,SAAS,cAAc,eAAe,YAAY,iBAAiB;AACnE,SAAS,MAAM,eAAe;AAC9B,SAAS,kBAAkB;AAWpB,IAAM,aAAa,KAAK,WAAW,aAAa,YAAY;AAG5D,IAAM,sBAAsB;AAOnC,IAAM,cAAc;AAUb,IAAM,4BAA8C;AAOpD,SAAS,sBAAsB,OAAyC;AAC7E,QAAM,IAAI,OAAO,UAAU,WAAW,MAAM,KAAK,EAAE,YAAY,IAAI;AACnE,SAAO,MAAM,YAAY,MAAM,YAAY,IAAI;AACjD;AAYO,SAAS,YAAY,SAAyB;AACnD,SAAO,WAAW,QAAQ,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK;AAC1D;AAGO,SAAS,aAAa,MAAsB;AACjD,SAAO,KAAK,MAAM,GAAG,WAAW;AAClC;AAEO,SAAS,YAAY,KAAiC;AAC3D,QAAM,WAAW,KAAK,KAAK,UAAU;AACrC,MAAI,CAAC,WAAW,QAAQ,EAAG,QAAO;AAClC,MAAI;AACF,UAAM,MAAM,aAAa,UAAU,OAAO;AAC1C,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,QAAI,OAAO,OAAO,YAAY,YAAY,OAAO,OAAO,UAAU,UAAU;AAG1E,YAAM,UAAU,sBAAsB,OAAO,gBAAgB;AAC7D,aAAO;AAAA,QACL,SAAS,OAAO;AAAA,QAChB,OAAO,OAAO;AAAA,QACd,GAAI,UAAU,EAAE,kBAAkB,QAAQ,IAAI,CAAC;AAAA,MACjD;AAAA,IACF;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,aACd,KACA,SACA,OACA,kBACM;AACN,QAAM,WAAW,KAAK,KAAK,UAAU;AAIrC,QAAM,UAAU,oBAAoB,YAAY,GAAG,GAAG;AAEtD,QAAM,YAAoC,CAAC;AAC3C,aAAW,CAAC,MAAM,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,cAAU,IAAI,IAAI,aAAa,IAAI;AAAA,EACrC;AACA,QAAM,OAAoB;AAAA,IACxB;AAAA,IACA,OAAO;AAAA,IACP,GAAI,UAAU,EAAE,kBAAkB,QAAQ,IAAI,CAAC;AAAA,EACjD;AACA,YAAU,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAChD,gBAAc,UAAU,KAAK,UAAU,MAAM,MAAM,CAAC,IAAI,MAAM,OAAO;AACvE;AAMO,SAAS,SAAS,KAAqB;AAC5C,QAAM,aAAa,WAAW,KAAK,KAAK,WAAW,aAAa,aAAa,CAAC;AAC9E,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,eAAe,KAAK,KAAK,WAAW;AAC1C,MAAI,CAAC,WAAW,YAAY,EAAG,QAAO;AACtC,QAAM,UAAU,aAAa,cAAc,OAAO;AAClD,SAAO,QAAQ,SAAS,wBAAwB,IAAI,IAAI;AAC1D;","names":[]}

package/dist/chunk-VIVJUY6J.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import {
+  DEFAULT_GITIGNORE_PROFILE,
+  STATE_PATH,
+  parseGitignoreProfile
+} from "./chunk-TD65VH2W.js";
+
+// src/gitignore.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { createInterface } from "readline";
+var PRIVATE_PROFILE_IGNORES = [".claude/", ".agents/", ".pi/"];
+var PRIVATE_DIRS_DISPLAY = PRIVATE_PROFILE_IGNORES.join(", ");
+var PRIVATE_UNTRACK_COMMAND = `git rm -r --cached ${PRIVATE_PROFILE_IGNORES.map((d) => d.replace(/\/$/, "")).join(" ")}`;
+function ensureGitignoreEntries(targetDir, entries) {
+  const gitignorePath = join(targetDir, ".gitignore");
+  const current = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf-8") : "";
+  const present = new Set(current.split("\n").map((l) => l.trim()));
+  const missing = entries.filter((e) => !present.has(e.trim()));
+  if (missing.length === 0) return [];
+  const sep = current.length > 0 && !current.endsWith("\n") ? "\n" : "";
+  writeFileSync(gitignorePath, current + sep + missing.join("\n") + "\n", "utf-8");
+  return missing;
+}
+function applyGitignoreProfile(targetDir, profile) {
+  if (profile === "private") {
+    return ensureGitignoreEntries(targetDir, PRIVATE_PROFILE_IGNORES);
+  }
+  return ensureGitignoreEntries(targetDir, [STATE_PATH]);
+}
+function validateGitignoreFlag(flag) {
+  const parsed = parseGitignoreProfile(flag);
+  if (!parsed) {
+    throw new Error(`Unknown gitignore profile '${flag}'. Use 'shared' or 'private'.`);
+  }
+  return parsed;
+}
+async function promptGitignoreProfile(intro) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  console.log(intro);
+  console.log("  shared  \u2014 commit skills so your team gets the same workflow (default)");
+  console.log(`  private \u2014 gitignore ${PRIVATE_DIRS_DISPLAY}; track only CLAUDE.md, AGENTS.md, docs/`);
+  return new Promise((resolve) => {
+    const ask = () => {
+      rl.question(`Profile [shared/private] (${DEFAULT_GITIGNORE_PROFILE}): `, (answer) => {
+        if (answer.trim() === "") {
+          rl.close();
+          resolve(DEFAULT_GITIGNORE_PROFILE);
+          return;
+        }
+        const parsed = parseGitignoreProfile(answer);
+        if (parsed) {
+          rl.close();
+          resolve(parsed);
+          return;
+        }
+        console.log(
+          `Unrecognized answer '${answer.trim()}' \u2014 type 'shared' or 'private', or press Enter for ${DEFAULT_GITIGNORE_PROFILE}.`
+        );
+        ask();
+      });
+    };
+    ask();
+  });
+}
+async function resolveGitignoreProfile(opts) {
+  if (opts.flag !== void 0) {
+    return { profile: validateGitignoreFlag(opts.flag), decided: true };
+  }
+  if (opts.persisted) {
+    return { profile: opts.persisted, decided: true };
+  }
+  if (opts.interactive) {
+    return { profile: await promptGitignoreProfile(opts.promptIntro), decided: true };
+  }
+  return { profile: DEFAULT_GITIGNORE_PROFILE, decided: false };
+}
+
+export {
+  PRIVATE_DIRS_DISPLAY,
+  PRIVATE_UNTRACK_COMMAND,
+  applyGitignoreProfile,
+  validateGitignoreFlag,
+  resolveGitignoreProfile
+};
+//# sourceMappingURL=chunk-VIVJUY6J.js.map

package/dist/chunk-VIVJUY6J.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 * - `shared`  — ignore only the hidden upgrade-state file (current default).\n * - `private` — ignore the whole .claude/, .agents/, .pi/ trees. Since\n *   .claude/ already covers the state file, the writer skips the redundant\n *   state entry to avoid a dead line.\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);\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;AAmBO,SAAS,sBAAsB,WAAmB,SAAqC;AAC5F,MAAI,YAAY,WAAW;AACzB,WAAO,uBAAuB,WAAW,uBAAuB;AAAA,EAClE;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,4 +1,8 @@
 #!/usr/bin/env node
+import {
+  PRIVATE_DIRS_DISPLAY
+} from "./chunk-VIVJUY6J.js";
+import "./chunk-TD65VH2W.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -7,25 +11,36 @@ import { fileURLToPath } from "url";
 import { dirname, join } from "path";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+var GITIGNORE_OPTION_DESC = `Gitignore profile: 'shared' (commit skills) or 'private' (gitignore ${PRIVATE_DIRS_DISPLAY})`;
 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").action(async (dir, opts) => {
-  const { init } = await import("./init-35PB3SOQ.js");
-  await init(dir, { force: opts.force ?? false });
+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-TR43TRW2.js");
+  try {
+    await init(dir, { force: opts.force ?? false, gitignore: opts.gitignore });
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
 });
-program.command("upgrade").description("Upgrade installed Joycraft templates and skills to latest").argument("[dir]", "Target directory", ".").option("--yes", "Auto-accept all updates").action(async (dir, opts) => {
-  const { upgrade } = await import("./upgrade-G7PYJXEE.js");
-  await upgrade(dir, { yes: opts.yes ?? false });
+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-L3HSCFTV.js");
+  try {
+    await upgrade(dir, { yes: opts.yes ?? false, gitignore: opts.gitignore });
+  } catch (err) {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+  }
 });
 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-3QKXF5UX.js");
+  const { initAutofix } = await import("./init-autofix-N3P63CAT.js");
   await initAutofix(dir, opts);
 });
 program.command("check-version").description("Check if a newer version of Joycraft is available").action(async () => {
   try {
     const { readFileSync: readFileSync2, existsSync } = await import("fs");
     const { join: join2 } = await import("path");
-    const { STATE_PATH, LEGACY_VERSION_FILE } = await import("./version-HEQ42K47.js");
+    const { STATE_PATH, LEGACY_VERSION_FILE } = await import("./version-2FGZETKD.js");
     const statePath = existsSync(join2(process.cwd(), STATE_PATH)) ? join2(process.cwd(), STATE_PATH) : join2(process.cwd(), LEGACY_VERSION_FILE);
     const data = JSON.parse(readFileSync2(statePath, "utf-8"));
     const res = await fetch("https://registry.npmjs.org/joycraft/latest", { signal: AbortSignal.timeout(3e3) });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));\n\nconst program = new Command();\n\nprogram\n  .name('joycraft')\n  .description('Scaffold and upgrade AI development harnesses')\n  .version(pkg.version, '-v, --version');\n\nprogram\n  .command('init')\n  .description('Scaffold the Joycraft harness into the current project')\n  .argument('[dir]', 'Target directory', '.')\n  .option('--force', 'Overwrite existing files')\n  .action(async (dir: string, opts: { force?: boolean }) => {\n    const { init } = await import('./init.js');\n    await init(dir, { force: opts.force ?? false });\n  });\n\nprogram\n  .command('upgrade')\n  .description('Upgrade installed Joycraft templates and skills to latest')\n  .argument('[dir]', 'Target directory', '.')\n  .option('--yes', 'Auto-accept all updates')\n  .action(async (dir: string, opts: { yes?: boolean }) => {\n    const { upgrade } = await import('./upgrade.js');\n    await upgrade(dir, { yes: opts.yes ?? false });\n  });\n\nprogram\n  .command('init-autofix')\n  .description('Set up the Level 5 auto-fix loop with holdout scenarios')\n  .argument('[dir]', 'Target directory', '.')\n  .option('--scenarios-repo <name>', 'Name for scenarios repo')\n  .option('--app-id <id>', 'GitHub App ID for Joycraft Autofix')\n  .option('--force', 'Overwrite existing workflow files')\n  .option('--dry-run', 'Show what would be created without creating it')\n  .action(async (dir: string, opts: { scenariosRepo?: string; appId?: string; force?: boolean; dryRun?: boolean }) => {\n    const { initAutofix } = await import('./init-autofix.js');\n    await initAutofix(dir, opts);\n  });\n\nprogram\n  .command('check-version')\n  .description('Check if a newer version of Joycraft is available')\n  .action(async () => {\n    try {\n      const { readFileSync, existsSync } = await import('node:fs');\n      const { join } = await import('node:path');\n      const { STATE_PATH, LEGACY_VERSION_FILE } = await import('./version.js');\n      // Prefer the hidden state; fall back to the legacy root file for projects\n      // that have not been upgraded (which relocates it) yet.\n      const statePath = existsSync(join(process.cwd(), STATE_PATH))\n        ? join(process.cwd(), STATE_PATH)\n        : join(process.cwd(), LEGACY_VERSION_FILE);\n      const data = JSON.parse(readFileSync(statePath, 'utf-8'));\n      const res = await fetch('https://registry.npmjs.org/joycraft/latest', { signal: AbortSignal.timeout(3000) });\n      if (res.ok) {\n        const latest = ((await res.json()) as { version: string }).version;\n        if (data.version !== latest) {\n          console.log(`Joycraft ${latest} available (you have ${data.version}). Run: npm install -g joycraft`);\n        }\n      }\n    } catch {\n      // Silent — don't block session start\n    }\n  });\n\n// Start update check immediately so it runs in parallel with the command\nconst updateCheckPromise = (async (): Promise<string | null> => {\n  try {\n    const res = await fetch('https://registry.npmjs.org/joycraft/latest', {\n      signal: AbortSignal.timeout(3000)\n    });\n    if (res.ok) {\n      const latest = ((await res.json()) as { version: string }).version;\n      if (latest !== pkg.version) {\n        return `\\nJoycraft ${latest} available (you have ${pkg.version}). Run: npm install -g joycraft`;\n      }\n    }\n  } catch {\n    // Silent — don't block or error on network issues\n  }\n  return null;\n})();\n\n// Print update nudge after every command\nprogram.hook('postAction', async () => {\n  const message = await updateCheckPromise;\n  if (message) {\n    console.log(message);\n  }\n});\n\n// Show help when no arguments provided\nif (process.argv.length <= 2) {\n  program.outputHelp();\n  process.exit(0);\n}\n\nprogram.parse();\n"],"mappings":"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","names":["readFileSync","join"]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { readFileSync } from 'fs';\nimport { fileURLToPath } from 'url';\nimport { dirname, join } from 'path';\nimport { PRIVATE_DIRS_DISPLAY } from './gitignore.js';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));\n\nconst GITIGNORE_OPTION_DESC = `Gitignore profile: 'shared' (commit skills) or 'private' (gitignore ${PRIVATE_DIRS_DISPLAY})`;\n\nconst program = new Command();\n\nprogram\n  .name('joycraft')\n  .description('Scaffold and upgrade AI development harnesses')\n  .version(pkg.version, '-v, --version');\n\nprogram\n  .command('init')\n  .description('Scaffold the Joycraft harness into the current project')\n  .argument('[dir]', 'Target directory', '.')\n  .option('--force', 'Overwrite existing files')\n  .option('--gitignore <profile>', GITIGNORE_OPTION_DESC)\n  .action(async (dir: string, opts: { force?: boolean; gitignore?: string }) => {\n    const { init } = await import('./init.js');\n    try {\n      await init(dir, { force: opts.force ?? false, gitignore: opts.gitignore });\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('upgrade')\n  .description('Upgrade installed Joycraft templates and skills to latest')\n  .argument('[dir]', 'Target directory', '.')\n  .option('--yes', 'Auto-accept all updates')\n  .option('--gitignore <profile>', GITIGNORE_OPTION_DESC)\n  .action(async (dir: string, opts: { yes?: boolean; gitignore?: string }) => {\n    const { upgrade } = await import('./upgrade.js');\n    try {\n      await upgrade(dir, { yes: opts.yes ?? false, gitignore: opts.gitignore });\n    } catch (err) {\n      console.error(err instanceof Error ? err.message : String(err));\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('init-autofix')\n  .description('Set up the Level 5 auto-fix loop with holdout scenarios')\n  .argument('[dir]', 'Target directory', '.')\n  .option('--scenarios-repo <name>', 'Name for scenarios repo')\n  .option('--app-id <id>', 'GitHub App ID for Joycraft Autofix')\n  .option('--force', 'Overwrite existing workflow files')\n  .option('--dry-run', 'Show what would be created without creating it')\n  .action(async (dir: string, opts: { scenariosRepo?: string; appId?: string; force?: boolean; dryRun?: boolean }) => {\n    const { initAutofix } = await import('./init-autofix.js');\n    await initAutofix(dir, opts);\n  });\n\nprogram\n  .command('check-version')\n  .description('Check if a newer version of Joycraft is available')\n  .action(async () => {\n    try {\n      const { readFileSync, existsSync } = await import('node:fs');\n      const { join } = await import('node:path');\n      const { STATE_PATH, LEGACY_VERSION_FILE } = await import('./version.js');\n      // Prefer the hidden state; fall back to the legacy root file for projects\n      // that have not been upgraded (which relocates it) yet.\n      const statePath = existsSync(join(process.cwd(), STATE_PATH))\n        ? join(process.cwd(), STATE_PATH)\n        : join(process.cwd(), LEGACY_VERSION_FILE);\n      const data = JSON.parse(readFileSync(statePath, 'utf-8'));\n      const res = await fetch('https://registry.npmjs.org/joycraft/latest', { signal: AbortSignal.timeout(3000) });\n      if (res.ok) {\n        const latest = ((await res.json()) as { version: string }).version;\n        if (data.version !== latest) {\n          console.log(`Joycraft ${latest} available (you have ${data.version}). Run: npm install -g joycraft`);\n        }\n      }\n    } catch {\n      // Silent — don't block session start\n    }\n  });\n\n// Start update check immediately so it runs in parallel with the command\nconst updateCheckPromise = (async (): Promise<string | null> => {\n  try {\n    const res = await fetch('https://registry.npmjs.org/joycraft/latest', {\n      signal: AbortSignal.timeout(3000)\n    });\n    if (res.ok) {\n      const latest = ((await res.json()) as { version: string }).version;\n      if (latest !== pkg.version) {\n        return `\\nJoycraft ${latest} available (you have ${pkg.version}). Run: npm install -g joycraft`;\n      }\n    }\n  } catch {\n    // Silent — don't block or error on network issues\n  }\n  return null;\n})();\n\n// Print update nudge after every command\nprogram.hook('postAction', async () => {\n  const message = await updateCheckPromise;\n  if (message) {\n    console.log(message);\n  }\n});\n\n// Show help when no arguments provided\nif (process.argv.length <= 2) {\n  program.outputHelp();\n  process.exit(0);\n}\n\nprogram.parse();\n"],"mappings":"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","names":["readFileSync","join"]}

package/dist/{init-35PB3SOQ.js → init-TR43TRW2.js}

@@ -1,8 +1,13 @@
 #!/usr/bin/env node
 import {
-  ensureGitignoreEntry,
   getPackageVersion
-} from "./chunk-JVRMYMBC.js";
+} from "./chunk-IELXGWSH.js";
+import {
+  PRIVATE_DIRS_DISPLAY,
+  PRIVATE_UNTRACK_COMMAND,
+  applyGitignoreProfile,
+  resolveGitignoreProfile
+} from "./chunk-VIVJUY6J.js";
 import {
   CODEX_SKILLS,
   PI_AGENTS,
@@ -13,10 +18,12 @@ import {
   TEMPLATES
 } from "./chunk-W6AHAE7X.js";
 import {
+  DEFAULT_GITIGNORE_PROFILE,
   STATE_PATH,
   hashContent,
+  readVersion,
   writeVersion
-} from "./chunk-63OWWRAJ.js";
+} from "./chunk-TD65VH2W.js";
 
 // src/init.ts
 import { mkdirSync as mkdirSync2, existsSync as existsSync4, writeFileSync as writeFileSync2, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync, chmodSync } from "fs";
@@ -714,6 +721,12 @@ async function init(dir, opts) {
   const result = { created: [], skipped: [], modified: [], warnings: [] };
   const stack = await detectStack(targetDir);
   const isPi = existsSync4(join4(targetDir, ".pi"));
+  const { profile: gitignoreProfile } = await resolveGitignoreProfile({
+    flag: opts.gitignore,
+    persisted: readVersion(targetDir)?.gitignoreProfile,
+    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");
   let existingSkills = [];
@@ -833,8 +846,8 @@ async function init(dir, opts) {
   for (const [name, content] of Object.entries(PI_AGENTS)) {
     fileHashes[join4(".pi", "agents", name)] = hashContent(content);
   }
-  writeVersion(targetDir, getPackageVersion(), fileHashes);
-  ensureGitignoreEntry(targetDir, STATE_PATH);
+  writeVersion(targetDir, getPackageVersion(), fileHashes, gitignoreProfile);
+  applyGitignoreProfile(targetDir, gitignoreProfile);
   const hooksDir = join4(targetDir, ".claude", "hooks");
   ensureDir(hooksDir);
   const hookScript = `// Joycraft version check \u2014 runs on Claude Code session start
@@ -911,18 +924,20 @@ try {
   const hookResult = installSafeguardHooks(targetDir, [], opts.force, settingsMalformed);
   result.created.push(...hookResult.created);
   result.skipped.push(...hookResult.skipped);
-  const gitignorePath = join4(targetDir, ".gitignore");
-  if (existsSync4(gitignorePath)) {
-    const gitignore = readFileSync3(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/"
-      );
+  if (gitignoreProfile === "shared") {
+    const gitignorePath = join4(targetDir, ".gitignore");
+    if (existsSync4(gitignorePath)) {
+      const gitignore = readFileSync3(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/"
+        );
+      }
     }
   }
-  printSummary(result, stack, existingSkills, isPi);
+  printSummary(result, stack, existingSkills, isPi, gitignoreProfile);
 }
-function printSummary(result, stack, existingSkills = [], isPi = false) {
+function printSummary(result, stack, existingSkills = [], isPi = false, gitignoreProfile = DEFAULT_GITIGNORE_PROFILE) {
   console.log("\nJoycraft initialized!\n");
   if (stack.language !== "unknown") {
     const fw = stack.framework ? ` + ${stack.framework}` : "";
@@ -933,6 +948,11 @@ function printSummary(result, stack, existingSkills = [], isPi = false) {
   if (isPi) {
     console.log("  Detected agent: Pi");
   }
+  if (gitignoreProfile === "private") {
+    console.log(`  Gitignore profile: private (${PRIVATE_DIRS_DISPLAY} are gitignored \u2014 only CLAUDE.md, AGENTS.md, docs/ are tracked)`);
+  } else {
+    console.log("  Gitignore profile: shared (skills and docs are tracked for your team)");
+  }
   if (result.created.length > 0) {
     console.log(`
   Created ${result.created.length} file(s):`);
@@ -974,7 +994,12 @@ function printSummary(result, stack, existingSkills = [], isPi = false) {
   }
   console.log("    2. Try /joycraft-new-feature to start building with the spec-driven workflow");
   console.log("       (feature artifacts are written to docs/features/<slug>/ as you go)");
-  console.log("    3. Commit .claude/skills/ and docs/ so your team gets the same workflow");
+  if (gitignoreProfile === "private") {
+    console.log(`    3. Commit CLAUDE.md, AGENTS.md, and docs/ \u2014 ${PRIVATE_DIRS_DISPLAY} stay local (gitignored)`);
+    console.log(`       (if any harness files were already committed, run: ${PRIVATE_UNTRACK_COMMAND})`);
+  } else {
+    console.log("    3. Commit .claude/skills/ and docs/ so your team gets the same workflow");
+  }
   if (!isPi) {
     console.log("    Pi: Skills installed to .pi/skills/. Use /skill:joycraft-* to invoke.");
   }
@@ -983,4 +1008,4 @@ function printSummary(result, stack, existingSkills = [], isPi = false) {
 export {
   init
 };
-//# sourceMappingURL=init-35PB3SOQ.js.map
+//# sourceMappingURL=init-TR43TRW2.js.map