my-patina 0.7.0 → 0.9.0

package/dist/cli.js

@@ -7,7 +7,7 @@ import { Command } from "commander";
 import * as p from "@clack/prompts";
 import chalk from "chalk";
 import { dirname as dirname4, join as join7, resolve } from "path";
-import { existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync7, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync8, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
 import yaml3 from "js-yaml";
 
 // src/detect.ts
@@ -23,7 +23,7 @@ function loadProfile(root) {
 }
 
 // src/scaffold.ts
-import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync3, existsSync as existsSync5, readFileSync as readFileSync6 } from "fs";
 import { join as join5, dirname as dirname3 } from "path";
 import yaml2 from "js-yaml";
 
@@ -64,7 +64,8 @@ var LI_COMMANDS = [
 ];
 var LI_MANAGED_PATHS = [
   ...LI_COMMANDS.map((c) => `.claude/commands/${c}`),
-  ".claude/modules/linkedin/manifest.md"
+  ".claude/modules/linkedin/manifest.md",
+  ".claude/modules/linkedin/CLAUDE.md"
 ];
 var CONTENT_FILE_NAMES = [
   "INSTRUCTIONS.md",
@@ -91,6 +92,10 @@ var linkedinModule = {
       ".claude/modules/linkedin/manifest.md",
       render(tpl("modules/linkedin/manifest.md"), vars)
     ]);
+    files.push([
+      ".claude/modules/linkedin/CLAUDE.md",
+      render(tpl("modules/linkedin/CLAUDE.md"), vars)
+    ]);
     return files;
   },
   contentFiles(vars, contentDir) {
@@ -109,12 +114,53 @@ var linkedinModule = {
     const updated = { ...profile };
     delete updated.linkedin;
     return updated;
+  },
+  launchTasks: [
+    {
+      id: "open-drafts",
+      label: "Show open LinkedIn drafts",
+      template: "- Show any LinkedIn section drafts in `{{CONTENT_DIR}}/linkedin/` that have content to review."
+    }
+  ],
+  readmeBlock(vars) {
+    return [
+      "## LinkedIn module",
+      "",
+      "Drafts and refines your LinkedIn profile from your graph.",
+      "",
+      "### Folder additions",
+      "",
+      "```",
+      `${vars.CONTENT_DIR}/linkedin/`,
+      "  INSTRUCTIONS.md              \u2014 module rules and guidance",
+      "  LinkedIn Current State.md    \u2014 your current live profile copy",
+      "  LinkedIn About.md            \u2014 draft for the About section",
+      "  LinkedIn Headline.md         \u2014 draft for your headline",
+      "  LinkedIn Experience.md       \u2014 draft for your experience entries",
+      "  LinkedIn Skills.md           \u2014 draft for your skills section",
+      "  LinkedIn Featured.md         \u2014 draft for featured content",
+      "  LinkedIn Activity.md         \u2014 draft for activity/posts section",
+      "```",
+      "",
+      "### Commands",
+      "",
+      "| Command | What it does |",
+      "|---------|-------------|",
+      "| `/li-all` | Run all LinkedIn section drafts in sequence |",
+      "| `/li-about` | Draft or refine your LinkedIn About section |",
+      "| `/li-headline` | Draft or refine your LinkedIn headline |",
+      "| `/li-experience` | Draft or refine your LinkedIn experience entries |",
+      "| `/li-skills` | Draft or refine your LinkedIn skills section |",
+      "| `/li-featured` | Draft or refine your LinkedIn featured content |",
+      "| `/li-activity` | Draft or refine your LinkedIn activity section |"
+    ].join("\n");
   }
 };
 
 // src/modules/resume/index.ts
 var RESUME_MANAGED_PATHS = [
   ".claude/commands/resume-refresh.md",
+  ".claude/modules/resume/CLAUDE.md",
   ".claude/modules/resume/manifest.md"
 ];
 var CONTENT_FILE_NAMES2 = [
@@ -129,10 +175,10 @@ var resumeModule = {
   managedPaths: RESUME_MANAGED_PATHS,
   contentFileNames: CONTENT_FILE_NAMES2,
   managedFiles(vars) {
-    const [commandPath, manifestPath] = RESUME_MANAGED_PATHS;
     return [
-      [commandPath, render(tpl("modules/resume/commands/resume-refresh.md"), vars)],
-      [manifestPath, render(tpl("modules/resume/manifest.md"), vars)]
+      [".claude/commands/resume-refresh.md", render(tpl("modules/resume/commands/resume-refresh.md"), vars)],
+      [".claude/modules/resume/CLAUDE.md", render(tpl("modules/resume/CLAUDE.md"), vars)],
+      [".claude/modules/resume/manifest.md", render(tpl("modules/resume/manifest.md"), vars)]
     ];
   },
   contentFiles(vars, contentDir) {
@@ -140,6 +186,35 @@ var resumeModule = {
       `${contentDir}/resume/${file}`,
       render(tpl(`modules/resume/graph/${file}`), vars)
     ]);
+  },
+  launchTasks: [
+    {
+      id: "resume-stale-check",
+      label: "Flag resume if it may be out of date",
+      template: "- Compare `{{CONTENT_DIR}}/resume/Resume Working Draft.md` against recent notes and flag if the resume looks out of date."
+    }
+  ],
+  readmeBlock(vars) {
+    return [
+      "## Resume module",
+      "",
+      "Keeps your resume current by synthesising it from your graph.",
+      "",
+      "### Folder additions",
+      "",
+      "```",
+      `${vars.CONTENT_DIR}/resume/`,
+      "  INSTRUCTIONS.md              \u2014 module rules and guidance",
+      "  Resume Working Draft.md      \u2014 the resume you are actively editing",
+      "  Resume Last Submitted.md     \u2014 the version you last sent to an employer",
+      "```",
+      "",
+      "### Commands",
+      "",
+      "| Command | What it does |",
+      "|---------|-------------|",
+      "| `/resume-refresh` | Refresh your resume working draft from your graph |"
+    ].join("\n");
   }
   // Resume has no module-specific profile fields — no onAdd/onRemove needed.
 };
@@ -258,6 +333,28 @@ function mergeSections(existing, newSections, storedChecksums, relativePath, ove
   }
   return { content: result, sections: outcomes };
 }
+function removeSection(id, content) {
+  const sections = parseSections(content);
+  const section = sections.find((s) => s.id === id);
+  if (!section) return content;
+  const { start, end } = section;
+  let before = content.slice(0, start);
+  before = before.replace(/(\r?\n)+$/, "");
+  let after = content.slice(end);
+  after = after.replace(/^(\r?\n)+/, "");
+  let result;
+  if (before === "" && after === "") {
+    result = "";
+  } else if (before === "") {
+    result = after;
+  } else if (after === "") {
+    result = before;
+  } else {
+    result = before + "\n\n" + after;
+  }
+  result = result.replace(/\n{3,}/g, "\n\n");
+  return result;
+}
 function inspectSections(relativePath, existing, storedChecksums) {
   const sections = parseSections(existing);
   const editedIds = [];
@@ -387,6 +484,66 @@ function writeState(root, state) {
   );
 }
 
+// src/launch-tasks.ts
+var BASE_LAUNCH_TASKS = [
+  {
+    id: "today-focus",
+    label: "Ask what to focus on today",
+    template: "- Ask the user what they want to focus on today and note it before proceeding."
+  },
+  {
+    id: "recent-notes",
+    label: "Summarise notes changed in the last 7 days",
+    template: "- Summarise any notes in `{{CONTENT_DIR}}/notes/` modified in the last 7 days, one line each."
+  },
+  {
+    id: "open-posts",
+    label: "List unfinished posts",
+    template: "- List any drafts in `{{CONTENT_DIR}}/posts/` that look unfinished and offer to continue one."
+  }
+];
+function availableLaunchTasks(modules) {
+  const tasks = BASE_LAUNCH_TASKS.map((t) => ({
+    nsId: `base/${t.id}`,
+    label: t.label,
+    template: t.template,
+    source: "base"
+  }));
+  for (const moduleId of modules) {
+    const def = getModule(moduleId);
+    if (def?.launchTasks) {
+      for (const t of def.launchTasks) {
+        tasks.push({
+          nsId: `${moduleId}/${t.id}`,
+          label: t.label,
+          template: t.template,
+          source: moduleId
+        });
+      }
+    }
+  }
+  return tasks;
+}
+function renderLaunchSection(selectedNsIds, modules) {
+  if (!selectedNsIds || selectedNsIds.length === 0) return null;
+  const avail = availableLaunchTasks(modules);
+  const availMap = new Map(avail.map((t) => [t.nsId, t]));
+  const resolved = selectedNsIds.map((id) => availMap.get(id)).filter((t) => t !== void 0);
+  if (resolved.length === 0) return null;
+  return ["## Launch tasks", "", ...resolved.map((t) => t.template)].join("\n");
+}
+function pruneLaunchTasks(selectedNsIds, modules) {
+  if (!selectedNsIds || selectedNsIds.length === 0) return [];
+  const avail = new Set(availableLaunchTasks(modules).map((t) => t.nsId));
+  return selectedNsIds.filter((id) => avail.has(id));
+}
+function launchSelectionError(values) {
+  if (values.length > 5) {
+    return "You can select at most 5 launch tasks.";
+  }
+  return void 0;
+}
+
 // src/scaffold.ts
 function writeRaw(targetDir, relativePath, content) {
   const full = join5(targetDir, relativePath);
@@ -417,6 +574,11 @@ function validateManifestFrontmatter(moduleName, content) {
 }
 function profileToVars(profile, liProfileUrl) {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const modulesSection = (profile.modules ?? []).length ? profile.modules.map((id) => {
+    const def = getModule(id);
+    const label2 = def?.label ?? id;
+    return `- [${label2} module context](.claude/modules/${id}/CLAUDE.md)`;
+  }).join("\n") : "_No modules installed._";
   return {
     PATINA_NAME: profile.patina_name,
     USER_NAME: profile.name,
@@ -431,11 +593,13 @@ function profileToVars(profile, liProfileUrl) {
     STALENESS_THRESHOLD: (() => {
       const d = Number(profile.staleness_threshold_days ?? 30);
       return String(Number.isFinite(d) && d > 0 ? d : 30);
-    })()
+    })(),
+    MODULES_SECTION: modulesSection
   };
 }
 function baseManagedFiles(vars, editor, targetDir) {
   const files = [
+    ["README.md", render(tpl("README.md"), vars)],
     ["CLAUDE.md", render(tpl("CLAUDE.md"), vars)],
     [".claude/settings.json", tpl(".claude/settings.json")],
     [".claude/commands/add.md", render(tpl(".claude/commands/add.md"), vars)],
@@ -472,7 +636,8 @@ async function scaffold(opts) {
     editor,
     modules,
     liProfileUrl,
-    contentDir
+    contentDir,
+    launchTasks = []
   } = opts;
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   const tempProfile = {
@@ -486,13 +651,27 @@ async function scaffold(opts) {
     modules,
     content_dir: contentDir,
     created: today,
+    ...launchTasks.length ? { launch_tasks: launchTasks } : {},
     ...modules.includes("linkedin") && liProfileUrl ? { linkedin: { profile_url: liProfileUrl } } : {}
   };
   const vars = profileToVars(tempProfile, liProfileUrl);
   mkdirSync2(targetDir, { recursive: true });
   const checksums = {};
+  const baseFiles = baseManagedFiles(vars, editor, targetDir);
+  const readmePath = join5(targetDir, "README.md");
+  const filteredBaseFiles = baseFiles.filter(([rel]) => {
+    if (rel === "README.md") {
+      if (existsSync5(readmePath)) {
+        const existing = readFileSync6(readmePath, "utf8");
+        if (!hasFences(existing)) {
+          return false;
+        }
+      }
+    }
+    return true;
+  });
   const managedFiles = [
-    ...baseManagedFiles(vars, editor, targetDir),
+    ...filteredBaseFiles,
     ...modules.flatMap((m) => moduleManagedFiles(m, vars))
   ];
   for (const module of modules) {
@@ -506,6 +685,27 @@ async function scaffold(opts) {
       checksums[`${relativePath}:${s.id}`] = s.newChecksum;
     }
   }
+  for (const module of modules) {
+    const def = getModule(module);
+    if (def?.readmeBlock) {
+      const block = renderSection(module, def.readmeBlock(vars));
+      const result = writeManagedFile(targetDir, "README.md", block, checksums);
+      checksums["README.md"] = result.checksum;
+      for (const s of result.sections ?? []) {
+        checksums[`README.md:${s.id}`] = s.newChecksum;
+      }
+    }
+  }
+  const rawLaunch = renderLaunchSection(launchTasks, modules);
+  const expandedLaunch = rawLaunch ? render(rawLaunch, vars) : null;
+  if (expandedLaunch) {
+    const launchBlock = renderSection("launch", expandedLaunch);
+    const result = writeManagedFile(targetDir, "CLAUDE.md", launchBlock, checksums);
+    checksums["CLAUDE.md"] = result.checksum;
+    for (const s of result.sections ?? []) {
+      checksums[`CLAUDE.md:${s.id}`] = s.newChecksum;
+    }
+  }
   const baseDirs = ["notes", "skills", "posts"];
   for (const dir of baseDirs) {
     touch(targetDir, `${contentDir}/${dir}/.gitkeep`);
@@ -526,16 +726,16 @@ ${STATE_FILENAME}
 }
 
 // src/validate.ts
-import { existsSync as existsSync5, readFileSync as readFileSync6, readdirSync } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync7, readdirSync } from "fs";
 import { join as join6, relative, sep, basename } from "path";
 var NOTES = CONTENT_SUBDIRS[0];
 var SKILLS = CONTENT_SUBDIRS[1];
 var POSTS = CONTENT_SUBDIRS[2];
 function findPatinaRoot(cwd) {
-  return existsSync5(join6(cwd, "profile.yaml")) ? cwd : null;
+  return existsSync6(join6(cwd, "profile.yaml")) ? cwd : null;
 }
 function listMarkdownFiles(dir) {
-  if (!existsSync5(dir)) return [];
+  if (!existsSync6(dir)) return [];
   const results = [];
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
     const fullPath = join6(dir, entry.name);
@@ -598,7 +798,7 @@ function checkSkillNotes(root, profile) {
   const noteSlugs = new Set(noteFiles.map((f) => basename(f, ".md")));
   const issues = [];
   for (const skillFile of listMarkdownFiles(skillsDir)) {
-    const content = readFileSync6(skillFile, "utf8");
+    const content = readFileSync7(skillFile, "utf8");
     const links = extractWikiLinks(content);
     for (const { target, line } of links) {
       if (!noteSlugs.has(target)) {
@@ -625,7 +825,7 @@ function checkWikiLinks(root, profile) {
     ...listMarkdownFiles(postsDir)
   ];
   for (const file of filesToScan) {
-    const content = readFileSync6(file, "utf8");
+    const content = readFileSync7(file, "utf8");
     const links = extractWikiLinks(content);
     for (const { target, line } of links) {
       if (!noteSlugs.has(target)) {
@@ -644,8 +844,8 @@ function checkExclusions(root, profile) {
   const contentDir = join6(root, profile.content_dir ?? "graph");
   const notesDir = join6(contentDir, NOTES);
   const exclusionsPath = join6(notesDir, "exclusions.md");
-  if (!existsSync5(exclusionsPath)) return [];
-  const content = readFileSync6(exclusionsPath, "utf8");
+  if (!existsSync6(exclusionsPath)) return [];
+  const content = readFileSync7(exclusionsPath, "utf8");
   const items = parseExclusions(content);
   if (items.length === 0) return [];
   const skillsDir = join6(contentDir, SKILLS);
@@ -657,7 +857,7 @@ function checkExclusions(root, profile) {
   const issues = [];
   const seen = /* @__PURE__ */ new Set();
   for (const file of filesToScan) {
-    const fileContent = readFileSync6(file, "utf8");
+    const fileContent = readFileSync7(file, "utf8");
     const lines = fileContent.split("\n");
     for (let i = 0; i < lines.length; i++) {
       const lineText = lines[i];
@@ -742,6 +942,58 @@ function label(text2) {
 var MULTISELECT_HINT = `
   ${chalk.hex("#64748B")("\u2191\u2193 to move  \xB7  space to select  \xB7  enter to confirm")}`;
 var OPTIONAL_HINT = ` ${chalk.dim.italic("optional, but helps a lot \u2014 hit enter to skip")}`;
+function applyLaunchBlock(cwd, launchTasks, modules, vars, checksums, overwrite) {
+  const updated = [];
+  const skipped = [];
+  const keptSections = [];
+  const rawLaunch = renderLaunchSection(launchTasks, modules);
+  if (rawLaunch) {
+    const block = renderSection("launch", render(rawLaunch, vars));
+    const result = writeManagedFile(cwd, "CLAUDE.md", block, checksums, overwrite);
+    checksums["CLAUDE.md"] = result.checksum;
+    for (const s of result.sections ?? []) {
+      const sKey = `CLAUDE.md:${s.id}`;
+      if (s.outcome !== "skipped") checksums[sKey] = s.newChecksum;
+      else keptSections.push(sKey);
+    }
+    if (result.outcome === "skipped") skipped.push("CLAUDE.md");
+    else updated.push("CLAUDE.md");
+  } else {
+    const claudePath = join7(cwd, "CLAUDE.md");
+    if (existsSync7(claudePath)) {
+      const before = readFileSync8(claudePath, "utf8");
+      const editedIds = inspectSections("CLAUDE.md", before, checksums);
+      if (!editedIds.includes("launch") || overwrite?.has("launch")) {
+        const after = removeSection("launch", before);
+        if (after !== before) {
+          writeFileSync4(claudePath, after, "utf8");
+          checksums["CLAUDE.md"] = hashContent(after);
+          delete checksums["CLAUDE.md:launch"];
+          updated.push("CLAUDE.md");
+        }
+      } else {
+        keptSections.push("CLAUDE.md:launch");
+        skipped.push("CLAUDE.md");
+      }
+    }
+  }
+  return { updated, skipped, keptSections };
+}
+async function promptLaunchTasks(avail, initial) {
+  const selected = await p.multiselect({
+    message: `Which tasks should run every time you launch Patina?${MULTISELECT_HINT}`,
+    options: avail.map((t) => ({
+      value: t.nsId,
+      label: t.label,
+      hint: chalk.hex("#64748B")(t.source)
+    })),
+    initialValues: initial,
+    required: false,
+    validate: launchSelectionError
+  });
+  if (p.isCancel(selected)) onCancel();
+  return Array.isArray(selected) ? selected : [];
+}
 async function main() {
   printBanner();
   const cwd = process.cwd();
@@ -848,6 +1100,18 @@ async function runInstall(cwd) {
     });
     liProfileUrl = typeof url === "string" ? url : "";
   }
+  let launchTasks = [];
+  const availTasks = availableLaunchTasks(modules);
+  if (availTasks.length > 0) {
+    const setupLaunch = await p.confirm({
+      message: "Would you like to set up launch tasks?",
+      initialValue: false
+    });
+    if (p.isCancel(setupLaunch)) onCancel();
+    if (setupLaunch) {
+      launchTasks = await promptLaunchTasks(availTasks, []);
+    }
+  }
   const slug = slugify(identity.patinaName);
   const targetDir = resolve(cwd, slug);
   const s = p.spinner();
@@ -870,7 +1134,8 @@ async function runInstall(cwd) {
       editor: setup.editor,
       modules,
       liProfileUrl,
-      contentDir: "graph"
+      contentDir: "graph",
+      launchTasks
     });
     s.stop(chalk.green("Done."));
   } catch (err) {
@@ -893,8 +1158,8 @@ function writeProfile(cwd, profile) {
 }
 function removeManagedFileIfUnmodified(targetDir, rel, stored) {
   const fullPath = join7(targetDir, rel);
-  if (!existsSync6(fullPath)) return "deleted";
-  const fileContent = readFileSync7(fullPath, "utf8");
+  if (!existsSync7(fullPath)) return "deleted";
+  const fileContent = readFileSync8(fullPath, "utf8");
   if (hasFences(fileContent)) {
     const editedIds = inspectSections(rel, fileContent, stored);
     if (editedIds.length > 0) {
@@ -916,10 +1181,11 @@ async function runUpdate(cwd) {
   p.intro(chalk.hex("#94A3B8")(`Found: ${chalk.bold.white(profile.patina_name || "patina")}`));
   p.note(
     [
-      `${chalk.hex("#64748B")("Name:")}    ${profile.name}`,
-      `${chalk.hex("#64748B")("Title:")}   ${profile.title || "\u2014"}`,
-      `${chalk.hex("#64748B")("Company:")} ${profile.work?.company_name || "\u2014"}`,
-      `${chalk.hex("#64748B")("Modules:")} ${profile.modules?.join(", ") || "none"}`
+      `${chalk.hex("#64748B")("Name:")}         ${profile.name}`,
+      `${chalk.hex("#64748B")("Title:")}        ${profile.title || "\u2014"}`,
+      `${chalk.hex("#64748B")("Company:")}      ${profile.work?.company_name || "\u2014"}`,
+      `${chalk.hex("#64748B")("Modules:")}      ${profile.modules?.join(", ") || "none"}`,
+      `${chalk.hex("#64748B")("Launch tasks:")} ${profile.launch_tasks?.length ?? 0}`
     ].join("\n"),
     label("Current profile")
   );
@@ -928,6 +1194,7 @@ async function runUpdate(cwd) {
     options: [
       { value: "profile", label: "Update personal info" },
       { value: "modules", label: "Add or remove modules" },
+      { value: "launch-tasks", label: "Set up launch tasks", hint: chalk.hex("#64748B")("tasks Claude runs every session") },
       { value: "validate", label: "Run health check", hint: chalk.hex("#64748B")("check for broken links and excluded items") },
       { value: "nothing", label: "Nothing \u2014 just checking" }
     ]
@@ -940,6 +1207,8 @@ async function runUpdate(cwd) {
     await runUpdateProfile(cwd, profile);
   } else if (action === "modules") {
     await runUpdateModules(cwd, profile);
+  } else if (action === "launch-tasks") {
+    await runUpdateLaunchTasks(cwd, profile);
   } else if (action === "validate") {
     await runValidate(cwd, profile);
   }
@@ -985,6 +1254,45 @@ function applyProfileUpdate(cwd, profile, fields, overwrite) {
       updated.push(rel);
     }
   }
+  for (const module of updatedProfile.modules) {
+    const def = getModule(module);
+    if (def?.readmeBlock) {
+      const readmePath = join7(cwd, "README.md");
+      const readmeExists = existsSync7(readmePath);
+      const readmeHasFences = readmeExists ? hasFences(readFileSync8(readmePath, "utf8")) : false;
+      if (!readmeExists || readmeHasFences) {
+        const block = renderSection(module, def.readmeBlock(vars));
+        const result = writeManagedFile(cwd, "README.md", block, newChecksums, overwrite);
+        newChecksums["README.md"] = result.checksum;
+        for (const s of result.sections ?? []) {
+          const sKey = `README.md:${s.id}`;
+          if (s.outcome !== "skipped") newChecksums[sKey] = s.newChecksum;
+          else {
+            newChecksums[sKey] = stored[sKey] ?? "";
+            keptSections.push(sKey);
+          }
+        }
+        if (result.outcome === "skipped") {
+          skipped.push(`README.md:${module}`);
+        } else if (result.outcome !== "updated" || result.sections?.some((s) => s.id === module && s.outcome !== "unchanged")) {
+          updated.push(`README.md:${module}`);
+        }
+      }
+    }
+  }
+  if (updatedProfile.launch_tasks?.length) {
+    const launchResult = applyLaunchBlock(
+      cwd,
+      updatedProfile.launch_tasks,
+      updatedProfile.modules,
+      vars,
+      newChecksums,
+      overwrite
+    );
+    updated.push(...launchResult.updated);
+    skipped.push(...launchResult.skipped);
+    keptSections.push(...launchResult.keptSections);
+  }
   for (const [rel, hash] of Object.entries(stored)) {
     if (!(rel in newChecksums)) {
       newChecksums[rel] = hash;
@@ -1079,8 +1387,8 @@ async function runUpdateProfile(cwd, profile) {
   for (const [rel, content] of previewFiles) {
     if (hasFences(content)) {
       const fullPath = join7(cwd, rel);
-      if (existsSync6(fullPath)) {
-        const existingContent = readFileSync7(fullPath, "utf8");
+      if (existsSync7(fullPath)) {
+        const existingContent = readFileSync8(fullPath, "utf8");
         const editedIds = inspectSections(rel, existingContent, storedChecksums);
         for (const sectionId of editedIds) {
           const confirmed = await p.confirm({
@@ -1142,12 +1450,28 @@ function applyModuleChanges(cwd, profile, toAdd, toRemove, moduleInputs) {
     }
     for (const [relativePath, content] of moduleContentFiles(module, vars, contentDir)) {
       const fullPath = join7(cwd, relativePath);
-      if (!existsSync6(fullPath)) {
+      if (!existsSync7(fullPath)) {
         mkdirSync3(dirname4(fullPath), { recursive: true });
         writeFileSync4(fullPath, content, "utf8");
         added.push(relativePath);
       }
     }
+    if (def?.readmeBlock) {
+      const readmePath = join7(cwd, "README.md");
+      const readmeExists = existsSync7(readmePath);
+      const readmeHasFences = readmeExists ? hasFences(readFileSync8(readmePath, "utf8")) : false;
+      if (!readmeExists || readmeHasFences) {
+        const block = renderSection(module, def.readmeBlock(vars));
+        const result = writeManagedFile(cwd, "README.md", block, newChecksums);
+        newChecksums["README.md"] = result.checksum;
+        for (const s of result.sections ?? []) {
+          newChecksums[`README.md:${s.id}`] = s.newChecksum;
+        }
+        if (result.outcome !== "skipped") added.push(`README.md:${module}`);
+      } else {
+        kept.push("README.md");
+      }
+    }
     if (!updatedProfile.modules.includes(module)) {
       updatedProfile.modules = [...updatedProfile.modules, module];
     }
@@ -1168,16 +1492,103 @@ function applyModuleChanges(cwd, profile, toAdd, toRemove, moduleInputs) {
         kept.push(rel);
       }
     }
+    const readmePath = join7(cwd, "README.md");
+    if (existsSync7(readmePath)) {
+      const before = readFileSync8(readmePath, "utf8");
+      const editedIds = inspectSections("README.md", before, stored);
+      if (!editedIds.includes(module)) {
+        const after = removeSection(module, before);
+        if (after !== before) {
+          writeFileSync4(readmePath, after, "utf8");
+          newChecksums["README.md"] = hashContent(after);
+          delete newChecksums[`README.md:${module}`];
+          deleted.push(`README.md:${module}`);
+        }
+      } else {
+        keptSections.push(`README.md:${module}`);
+      }
+    }
     updatedProfile.modules = updatedProfile.modules.filter((m) => m !== module);
     if (def?.onRemove) {
       updatedProfile = def.onRemove(updatedProfile);
     }
   }
+  const prunedTasks = pruneLaunchTasks(updatedProfile.launch_tasks, updatedProfile.modules);
+  updatedProfile = { ...updatedProfile, launch_tasks: prunedTasks.length ? prunedTasks : void 0 };
+  const finalVars = profileToVars(updatedProfile);
+  for (const [rel, content] of baseManagedFiles(finalVars, updatedProfile.editor, cwd)) {
+    const result = writeManagedFile(cwd, rel, content, newChecksums);
+    newChecksums[rel] = result.checksum;
+    for (const s of result.sections ?? []) {
+      const sKey = `${rel}:${s.id}`;
+      if (s.outcome !== "skipped") newChecksums[sKey] = s.newChecksum;
+      else {
+        newChecksums[sKey] = newChecksums[sKey] ?? "";
+        keptSections.push(sKey);
+      }
+    }
+  }
+  const launchResult = applyLaunchBlock(cwd, updatedProfile.launch_tasks ?? [], updatedProfile.modules, finalVars, newChecksums);
+  keptSections.push(...launchResult.keptSections);
   writeState(cwd, { checksums: newChecksums });
   const finalProfile = stripLegacyChecksums(updatedProfile);
   writeProfile(cwd, finalProfile);
   return { profile: finalProfile, added, skipped: skippedFiles, deleted, kept, keptSections };
 }
+function applyLaunchTaskUpdate(cwd, profile, launchTasks, overwrite) {
+  const updatedProfile = {
+    ...profile,
+    launch_tasks: launchTasks.length ? launchTasks : void 0
+  };
+  const vars = profileToVars(updatedProfile);
+  const stored = readState(cwd, profile).checksums;
+  const newChecksums = { ...stored };
+  const { updated, skipped, keptSections } = applyLaunchBlock(
+    cwd,
+    launchTasks,
+    profile.modules ?? [],
+    vars,
+    newChecksums,
+    overwrite
+  );
+  writeState(cwd, { checksums: newChecksums });
+  const profileToWrite = stripLegacyChecksums(updatedProfile);
+  writeProfile(cwd, profileToWrite);
+  return { profile: profileToWrite, updated, skipped, keptSections };
+}
+async function runUpdateLaunchTasks(cwd, profile) {
+  const avail = availableLaunchTasks(profile.modules ?? []);
+  const initial = pruneLaunchTasks(profile.launch_tasks, profile.modules ?? []);
+  const overwriteSet = /* @__PURE__ */ new Set();
+  const claudePath = join7(cwd, "CLAUDE.md");
+  if (existsSync7(claudePath)) {
+    const storedChecksums = readState(cwd, profile).checksums;
+    const existingContent = readFileSync8(claudePath, "utf8");
+    const editedIds = inspectSections("CLAUDE.md", existingContent, storedChecksums);
+    if (editedIds.includes("launch")) {
+      const confirmed = await p.confirm({
+        message: `Section 'launch' in CLAUDE.md has been manually edited. Overwrite?`,
+        initialValue: false
+      });
+      if (p.isCancel(confirmed)) onCancel();
+      if (confirmed) overwriteSet.add("launch");
+    }
+  }
+  const selected = await promptLaunchTasks(avail, initial);
+  const { updated, skipped, keptSections } = applyLaunchTaskUpdate(cwd, profile, selected, overwriteSet);
+  const summaryLines = [];
+  if (updated.length > 0) {
+    summaryLines.push(chalk.hex("#94A3B8")(`Updated: ${updated.join(", ")}`));
+  }
+  if (keptSections.length > 0) {
+    summaryLines.push(chalk.hex("#FFAB2E")(`Kept your edits: ${keptSections.join(", ")}`));
+  }
+  if (skipped.length > 0) {
+    summaryLines.push(chalk.hex("#FFAB2E")(`Kept your edits: ${skipped.join(", ")}`));
+  }
+  p.note(summaryLines.join("\n") || "No changes.", label("Done"));
+  p.outro(chalk.hex("#94A3B8")("Launch tasks updated."));
+}
 async function runUpdateModules(cwd, profile) {
   const currentModules = profile.modules ?? [];
   const selected = await p.multiselect({
@@ -1201,6 +1612,16 @@ async function runUpdateModules(cwd, profile) {
     p.outro(chalk.hex("#94A3B8")("No changes \u2014 modules unchanged."));
     return;
   }
+  const changeLines = [];
+  for (const m of toAdd) {
+    const def = getModule(m);
+    changeLines.push(`Adding ${def?.label ?? m}: appends a section to README.md, adds a link to CLAUDE.md`);
+  }
+  for (const m of toRemove) {
+    const def = getModule(m);
+    changeLines.push(`Removing ${def?.label ?? m}: removes its section from README.md and its link from CLAUDE.md`);
+  }
+  p.note(changeLines.join("\n"), label("Planned changes"));
   let liProfileUrl;
   if (toAdd.includes("linkedin") && !profile.linkedin?.profile_url) {
     const url = await p.text({

package/dist/templates/CLAUDE.md

@@ -69,3 +69,9 @@ Skip any area with nothing stale. If everything is fresh, say so in one line. Ke
 |---------|-------------|
 | `/add <description>` | Add a skill, project, or experience to your graph |
 | `/reflect [slug]` | Review your graph for gaps, completions, and stale skills — also runs all installed module hooks |
+
+## Modules
+
+<!-- patina:modules:start -->
+{{MODULES_SECTION}}
+<!-- patina:modules:end -->

package/dist/templates/README.md

@@ -0,0 +1,12 @@
+# {{PATINA_NAME}}
+
+<!-- patina:base:start -->
+This is your patina — a personal knowledge base for your professional story.
+
+- Profile and config live in `profile.yaml` and `CLAUDE.md`.
+- Your notes, skills, and posts live in `{{CONTENT_DIR}}/`.
+
+## Installed modules
+
+Module-specific sections are appended below as you install modules.
+<!-- patina:base:end -->

package/dist/templates/modules/linkedin/CLAUDE.md

@@ -0,0 +1,35 @@
+# LinkedIn Module Context
+
+This module helps you draft and refine your LinkedIn profile using your patina graph as the source of truth.
+
+## Folder structure
+
+```
+{{CONTENT_DIR}}/linkedin/
+  INSTRUCTIONS.md              — module-specific rules and guidance
+  LinkedIn Current State.md    — your current live profile copy
+  LinkedIn About.md            — draft for the About section
+  LinkedIn Headline.md         — draft for your headline
+  LinkedIn Experience.md       — draft for your experience entries
+  LinkedIn Skills.md           — draft for your skills section
+  LinkedIn Featured.md         — draft for featured content
+  LinkedIn Activity.md         — draft for activity/posts section
+```
+
+## Slash commands
+
+| Command | What it does |
+|---------|-------------|
+| `/li-all` | Run all LinkedIn section drafts in sequence |
+| `/li-about` | Draft or refine your LinkedIn About section |
+| `/li-headline` | Draft or refine your LinkedIn headline |
+| `/li-experience` | Draft or refine your LinkedIn experience entries |
+| `/li-skills` | Draft or refine your LinkedIn skills section |
+| `/li-featured` | Draft or refine your LinkedIn featured content |
+| `/li-activity` | Draft or refine your LinkedIn activity section |
+
+## How it works
+
+LinkedIn commands read your `{{CONTENT_DIR}}/` graph — notes, skills, and posts — and draft profile copy grounded in that evidence. They never invent claims not supported by your notes.
+
+The `/reflect` command also runs the LinkedIn reflect hook (`/li-all`) to keep your drafts current.

package/dist/templates/modules/resume/CLAUDE.md

@@ -0,0 +1,24 @@
+# Resume Module Context
+
+This module helps you keep your resume current by synthesising it from your patina graph.
+
+## Folder structure
+
+```
+{{CONTENT_DIR}}/resume/
+  INSTRUCTIONS.md              — module-specific rules and guidance
+  Resume Working Draft.md      — the resume you are actively editing
+  Resume Last Submitted.md     — the version you last sent to an employer
+```
+
+## Slash commands
+
+| Command | What it does |
+|---------|-------------|
+| `/resume-refresh` | Refresh your resume working draft from your graph |
+
+## How it works
+
+The `/resume-refresh` command reads your `{{CONTENT_DIR}}/` graph — notes, skills, and experience — and updates your Resume Working Draft to reflect your current professional state. It never overwrites Resume Last Submitted; that file is yours to update manually when you send an application.
+
+The working draft is compared against the last submitted version so you can see what has changed before sending.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-patina",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Personal professional knowledge graph — setup and management",
   "type": "module",
   "bin": {