claude-launchpad 0.13.1 → 0.14.1

package/README.md

@@ -201,7 +201,7 @@ claude-launchpad memory
 
 If memory is not installed, it runs interactive setup. If installed, it shows stats. Requires native deps first: `npm install better-sqlite3 sqlite-vec`.
 
-Every session, Claude loads what it needs to know and extracts new knowledge when you finish. Stale facts fade on their own. Knowledge Claude actually uses gets reinforced. Each project has its own isolated memory, and you can sync it across machines via private GitHub Gist.
+Every session, Claude loads what it needs to know and stores new knowledge as it works. Stale facts fade on their own. Knowledge Claude actually uses gets reinforced. Each project has its own isolated memory, and you can sync it across machines via private GitHub Gist.
 
 Browse everything with `--dashboard` -- a terminal UI with vim navigation, filtering, and search.
 

package/dist/cli.js

@@ -534,8 +534,10 @@ DerivedData/
 }
 
 // src/commands/init/generators/skill-enhance.ts
+var ENHANCE_SKILL_VERSION = 4;
 function generateEnhanceSkill() {
   return [
+    `<!-- lp-enhance-version: ${ENHANCE_SKILL_VERSION} -->`,
     "---",
     "name: lp-enhance",
     "description: |",
@@ -555,9 +557,11 @@ function generateEnhanceSkill() {
     "1. Read CLAUDE.md (if it exists)",
     "2. Read .claude/settings.json (hooks, permissions, MCP)",
     "3. Read .claude/rules/*.md (existing rules)",
-    "4. Scan src/ directory structure (top-level dirs, key files)",
-    "5. Read package.json / go.mod / pyproject.toml for stack detection",
-    "6. Check for monorepo indicators (workspaces, nx.json, lerna.json)",
+    "4. Read .claudeignore (if it exists)",
+    "5. Scan src/ directory structure (top-level dirs, key files)",
+    "6. Read package.json / go.mod / pyproject.toml for stack detection",
+    "7. Check for monorepo indicators (workspaces, nx.json, lerna.json)",
+    "8. Check scenarios/ directory for existing eval scenarios",
     "",
     "**Done when:** you have a mental model of the stack, architecture, and existing config.",
     "",
@@ -584,7 +588,9 @@ function generateEnhanceSkill() {
     "",
     "1. Create or update .claude/rules/ files for overflow content",
     "2. Generate path-scoped rules if the project has distinct areas (see below)",
-    "3. Verify line count is under 200",
+    "3. Review .claudeignore and print suggestions (see below)",
+    "4. Generate 2-3 custom eval scenarios in scenarios/custom/ (see below)",
+    "5. Verify line count is under 200",
     "",
     "**Rules:**",
     "- Don't remove existing content, only add or improve",
@@ -596,8 +602,9 @@ function generateEnhanceSkill() {
     "1. Run `claude-launchpad doctor` to check the score improved",
     "2. Print suggested hooks (exact JSON) for .claude/settings.json but don't modify it",
     "3. Print suggested MCP servers if external services detected (Postgres, Redis, Stripe, etc.)",
+    '4. If eval scenarios were generated, print: "Run this in your terminal (not inside Claude Code): `claude-launchpad eval --scenarios scenarios/ --runs 1`"',
     "",
-    "**Done when:** doctor score is equal or higher, suggestions printed.",
+    "**Done when:** doctor score is equal or higher, suggestions printed, eval scenarios created if applicable.",
     "",
     "## Path-scoped rules generation",
     "",
@@ -657,6 +664,72 @@ function generateEnhanceSkill() {
     "- If no SessionStart hook exists, suggest one that injects TASKS.md",
     "- DO NOT modify settings.json directly. Print exact JSON to add.",
     "",
+    "## .claudeignore review",
+    "",
+    "Read .claudeignore and check if the patterns make sense for the detected stack:",
+    "",
+    "**Always flag:**",
+    "- Missing node_modules/ (JS/TS projects)",
+    "- Missing __pycache__/ or .venv/ (Python projects)",
+    "- Missing target/ (Rust/Java projects)",
+    "- Missing .env / .env.* patterns",
+    "- Missing lock files (pnpm-lock.yaml, package-lock.json, yarn.lock, etc.)",
+    "- Missing coverage/ directory",
+    "- Large generated files that waste context (*.min.js, *.map, migrations/)",
+    "",
+    "**Never flag:**",
+    "- Patterns the user clearly added intentionally",
+    "- Test fixtures or seed data (might be needed for context)",
+    "",
+    "If .claudeignore is missing entirely, create one with sensible defaults for the detected stack.",
+    "If it exists but has gaps, print suggested additions. Do NOT modify it directly.",
+    "",
+    "## Eval scenario generation",
+    "",
+    "After improving CLAUDE.md, generate 2-3 custom eval scenarios that test whether Claude follows the project's specific rules. Write them as YAML files in scenarios/ at the project root.",
+    "",
+    "**Scenario YAML format:**",
+    "```yaml",
+    "name: custom/scenario-name",
+    "description: What this scenario tests",
+    "setup:",
+    "  files:",
+    "    - path: src/example.ts",
+    "      content: |",
+    "        // Starter file that tempts Claude to break a rule",
+    "  instructions: |",
+    "    The specific rule from CLAUDE.md being tested.",
+    'prompt: "A task that would tempt Claude to break the rule"',
+    "checks:",
+    "  - type: grep",
+    '    pattern: "expected_pattern"',
+    "    target: src/example.ts",
+    "    expect: present",
+    "    points: 5",
+    "    label: What this check verifies",
+    "  - type: file-exists",
+    "    target: path/to/expected/file",
+    "    expect: present",
+    "    points: 5",
+    "    label: What this check verifies",
+    "passingScore: 7",
+    "runs: 3",
+    "```",
+    "",
+    "**How to choose scenarios:**",
+    "1. Pick the 2-3 most important rules from ## Off-Limits and ## Conventions",
+    "2. Design a task that naturally tempts Claude to break each rule",
+    "3. Write checks that verify compliance (grep for patterns, file-exists for structure)",
+    "",
+    "**Check types available:** `grep` (pattern in file), `file-exists` (present/absent), `max-lines` (file length)",
+    "",
+    "**Examples of good custom scenarios:**",
+    '- Off-limits says "never use any" \u2192 task asks to build types, check for no `any` keyword',
+    '- Convention says "max 400 lines per file" \u2192 task asks to generate a large module, check line count',
+    '- Off-limits says "no raw SQL" \u2192 task asks to add a query, check for ORM usage',
+    "",
+    "**Skip if:** scenarios/ already has 3+ YAML files, or CLAUDE.md has no project-specific rules worth testing.",
+    "",
     "## Other advanced configuration",
     "",
     "- If the project uses external APIs, suggest sandbox.network.allowedDomains",
@@ -1241,6 +1314,16 @@ async function analyzeRules(config) {
       message: "No /lp-enhance skill found \u2014 use it inside Claude Code to AI-complete your CLAUDE.md",
       fix: "Run `claude-launchpad init` or `doctor --fix` to generate the skill"
     });
+  } else {
+    const installedVersion = await getSkillVersion(projectRoot);
+    if (installedVersion !== null && installedVersion < ENHANCE_SKILL_VERSION) {
+      issues.push({
+        analyzer: "Rules",
+        severity: "low",
+        message: `/lp-enhance skill is outdated (v${installedVersion}, latest v${ENHANCE_SKILL_VERSION})`,
+        fix: "Run `doctor --fix` to update the skill"
+      });
+    }
   }
   if (config.rules.length === 0) {
     issues.push({
@@ -1280,6 +1363,23 @@ async function analyzeRules(config) {
   const score = Math.max(0, 100 - issues.length * 10);
   return { name: "Rules", issues, score };
 }
+async function getSkillVersion(projectRoot) {
+  const paths = [
+    join4(projectRoot, ".claude", "skills", "lp-enhance", "SKILL.md"),
+    join4(homedir2(), ".claude", "skills", "lp-enhance", "SKILL.md")
+  ];
+  for (const p of paths) {
+    try {
+      const content = await readFile3(p, "utf-8");
+      const match = content.match(/<!-- lp-enhance-version: (\d+) -->/);
+      if (match) return parseInt(match[1], 10);
+      return 0;
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
 
 // src/commands/doctor/analyzers/permissions.ts
 async function analyzePermissions(config) {
@@ -1441,7 +1541,7 @@ var MEMORY_MCP_TOOLS = [
 function hasMemoryIndicators(config) {
   const hasMcpServer = config.mcpServers.some((s) => s.name === "agentic-memory");
   const hasHookRef = config.hooks.some(
-    (h) => h.command?.includes("memory context") || h.command?.includes("memory extract")
+    (h) => h.command?.includes("memory context")
   );
   return hasMcpServer || hasHookRef;
 }
@@ -1459,15 +1559,15 @@ async function analyzeMemory(config) {
       fix: "Add a SessionStart hook that runs `memory context` to inject relevant memories"
     });
   }
-  const hasStopHook = config.hooks.some(
+  const hasStaleStopHook = config.hooks.some(
     (h) => h.event === "Stop" && h.command?.includes("memory extract")
   );
-  if (!hasStopHook) {
+  if (hasStaleStopHook) {
     issues.push({
       analyzer: "Memory",
-      severity: "medium",
-      message: "No Stop hook with memory extract for session learnings",
-      fix: "Add a Stop hook that runs `memory extract` to capture session insights"
+      severity: "low",
+      message: "Deprecated Stop hook found (memory extract) \u2014 auto-extraction was removed, Claude stores memories directly via MCP tools",
+      fix: "Run `doctor --fix` to remove the stale Stop hook"
     });
   }
   const autoMemoryDisabled = config.settings?.autoMemoryEnabled === false;
@@ -1641,11 +1741,13 @@ var FIX_TABLE = [
   { analyzer: "Permissions", match: "Sandbox not enabled", fix: (root) => addSandboxSettings(root) },
   { analyzer: "Permissions", match: ".env is protected by hooks but not in .claudeignore", fix: (root) => addEnvToClaudeignore(root) },
   { analyzer: "Rules", match: "No /lp-enhance skill", fix: (root) => createEnhanceSkill(root) },
+  { analyzer: "Rules", match: "lp-enhance skill is outdated", fix: (root) => updateEnhanceSkill(root) },
   { analyzer: "Settings", match: "Deprecated includeCoAuthoredBy", fix: (root) => migrateAttribution(root) },
   { analyzer: "Hooks", match: "SessionStart", fix: (root) => addSessionStartHook(root) },
+  { analyzer: "Memory", match: "Deprecated Stop hook", fix: (root) => removeStaleStopHook(root) },
   { analyzer: "Memory", match: "autoMemoryEnabled not disabled", fix: (root) => disableAutoMemory(root) },
   { analyzer: "Memory", match: "MCP tool permission", fix: (root) => addMemoryToolPermissions(root) },
-  { analyzer: "Memory", match: "CLAUDE.md missing memory guidance", fix: (root) => addClaudeMdSection(root, "## Memory", "Use agentic-memory to persist knowledge across sessions:\n- Memories are automatically injected at session start and extracted at session end\n- Save non-obvious decisions, gotchas, and deferred issues\n- NEVER store credentials, API keys, tokens, or secrets in memories\n- Check memory for relevant context before starting work") }
+  { analyzer: "Memory", match: "CLAUDE.md missing memory guidance", fix: (root) => addClaudeMdSection(root, "## Memory", "Use agentic-memory to persist knowledge across sessions:\n- Memories are automatically injected at session start\n- STORE IMMEDIATELY when: a dependency strategy changes, an architecture decision is made, a convention is established, a bug pattern is discovered, or a feature is killed/added\n- Use memory_search before memory_store to check for duplicates\n- NEVER store credentials, API keys, tokens, or secrets in memories") }
 ];
 async function tryFix(issue, root, detected) {
   const entry = FIX_TABLE.find(
@@ -1888,6 +1990,36 @@ async function createEnhanceSkill(root) {
   log.success("Generated /lp-enhance skill (.claude/skills/lp-enhance/)");
   return true;
 }
+async function updateEnhanceSkill(root) {
+  const projectPath = join5(root, ".claude", "skills", "lp-enhance", "SKILL.md");
+  const globalPath = join5(homedir3(), ".claude", "skills", "lp-enhance", "SKILL.md");
+  const targetPath = await fileExists(projectPath) ? projectPath : await fileExists(globalPath) ? globalPath : null;
+  if (!targetPath) return false;
+  await writeFile2(targetPath, generateEnhanceSkill());
+  log.success("Updated /lp-enhance skill to latest version");
+  return true;
+}
+async function removeStaleStopHook(root) {
+  const settings = await readSettingsJson(root);
+  const hooks = settings.hooks;
+  if (!hooks?.Stop) return false;
+  const stopHooks = hooks.Stop;
+  const filtered = stopHooks.filter((h) => {
+    const innerHooks = h.hooks;
+    return !innerHooks?.some(
+      (ih) => typeof ih.command === "string" && ih.command.includes("memory extract")
+    );
+  });
+  if (filtered.length === stopHooks.length) return false;
+  if (filtered.length === 0) {
+    delete hooks.Stop;
+  } else {
+    hooks.Stop = filtered;
+  }
+  await writeSettingsJson(root, settings);
+  log.success("Removed deprecated Stop hook (memory extract)");
+  return true;
+}
 
 // src/commands/doctor/watcher.ts
 import { readdir as readdir2, stat } from "fs/promises";
@@ -2695,7 +2827,7 @@ function createMemoryCommand() {
         log.info("Skipped.");
         return;
       }
-      const { runInstall } = await import("./install-H6GW4P6K.js");
+      const { runInstall } = await import("./install-4GQ57KCQ.js");
       await runInstall({});
     } else {
       const { requireMemoryDeps } = await import("./require-deps-NKRCPVAO.js");
@@ -2711,13 +2843,6 @@ function createMemoryCommand() {
     }).helpCommand(false),
     { hidden: true }
   );
-  memory.addCommand(
-    new Command4("extract").description("Extract facts from transcript (hook handler)").action(async () => {
-      const { runExtract } = await import("./extract-HMAN7RW4.js");
-      await runExtract();
-    }).helpCommand(false),
-    { hidden: true }
-  );
   memory.addCommand(
     new Command4("serve").description("Start MCP server (Claude Code)").action(async () => {
       const { startServer } = await import("./commands/memory/server.js");
@@ -2741,7 +2866,7 @@ function createMemoryCommand() {
 }
 
 // src/cli.ts
-var program = new Command5().name("claude-launchpad").description("CLI toolkit that makes Claude Code setups measurably good").version("0.13.1", "-v, --version").action(async () => {
+var program = new Command5().name("claude-launchpad").description("CLI toolkit that makes Claude Code setups measurably good").version("0.14.1", "-v, --version").action(async () => {
   const hasConfig = await fileExists(join11(process.cwd(), "CLAUDE.md")) || await fileExists(join11(process.cwd(), ".claude", "settings.json"));
   if (hasConfig) {
     await program.commands.find((c) => c.name() === "doctor")?.parseAsync([], { from: "user" });