my-patina 0.1.2 → 0.3.0

package/dist/cli.js

@@ -3,8 +3,8 @@
 // src/wizard.ts
 import * as p from "@clack/prompts";
 import chalk from "chalk";
-import { dirname as dirname4, join as join6, resolve } from "path";
-import { existsSync as existsSync5, mkdirSync as mkdirSync3, unlinkSync, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname4, join as join7, resolve } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
 import yaml3 from "js-yaml";
 
 // src/detect.ts
@@ -20,8 +20,8 @@ function loadProfile(root) {
 }
 
 // src/scaffold.ts
-import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join4, dirname as dirname3 } from "path";
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
+import { join as join5, dirname as dirname3 } from "path";
 import yaml2 from "js-yaml";
 
 // src/template.ts
@@ -178,16 +178,66 @@ function writeManagedFile(targetDir, relativePath, newContent, storedChecksums)
   return { outcome: "skipped", checksum: storedHash };
 }
 
+// src/state.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
+var STATE_FILENAME = ".patina-state.json";
+function normalizeChecksums(checksums) {
+  const result = {};
+  for (const [key, value] of Object.entries(checksums)) {
+    result[key.replace(/\\/g, "/")] = value;
+  }
+  return result;
+}
+function readState(root, profile) {
+  const statePath = join4(root, STATE_FILENAME);
+  if (existsSync4(statePath)) {
+    const raw = readFileSync4(statePath, "utf8");
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      throw new Error(
+        `Corrupt ${STATE_FILENAME}: failed to parse JSON. Fix or delete the file at ${statePath} and try again.`
+      );
+    }
+    const obj = parsed;
+    const rawChecksums = obj.checksums;
+    if (rawChecksums !== void 0 && (typeof rawChecksums !== "object" || Array.isArray(rawChecksums) || rawChecksums === null)) {
+      throw new Error(`Corrupt ${STATE_FILENAME}: 'checksums' must be an object at ${statePath}.`);
+    }
+    const checksums2 = normalizeChecksums(rawChecksums ?? {});
+    return { checksums: checksums2 };
+  }
+  const legacyChecksums = profile?._checksums;
+  const checksums = normalizeChecksums(legacyChecksums ?? {});
+  return { checksums };
+}
+function stripLegacyChecksums(profile) {
+  const { _checksums: _stripped, ...clean } = profile;
+  return clean;
+}
+function writeState(root, state) {
+  const normalized = {
+    checksums: normalizeChecksums(state.checksums)
+  };
+  writeFileSync2(
+    join4(root, STATE_FILENAME),
+    JSON.stringify(normalized, null, 2) + "\n",
+    "utf8"
+  );
+}
+
 // src/scaffold.ts
 function writeRaw(targetDir, relativePath, content) {
-  const full = join4(targetDir, relativePath);
+  const full = join5(targetDir, relativePath);
   mkdirSync2(dirname3(full), { recursive: true });
-  writeFileSync2(full, content, "utf8");
+  writeFileSync3(full, content, "utf8");
 }
 function touch(targetDir, relativePath) {
-  const full = join4(targetDir, relativePath);
+  const full = join5(targetDir, relativePath);
   mkdirSync2(dirname3(full), { recursive: true });
-  writeFileSync2(full, "", "utf8");
+  writeFileSync3(full, "", "utf8");
 }
 function profileToVars(profile, liProfileUrl) {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -216,7 +266,7 @@ function baseManagedFiles(vars, editor, targetDir) {
       mcpServers: {
         obsidian: {
           command: "npx",
-          args: ["-y", "mcp-obsidian@latest", join4(targetDir, vars.CONTENT_DIR).replace(/\\/g, "/")]
+          args: ["-y", "mcp-obsidian@latest", join5(targetDir, vars.CONTENT_DIR).replace(/\\/g, "/")]
         }
       }
     };
@@ -291,28 +341,28 @@ async function scaffold(opts) {
       writeRaw(targetDir, relativePath, content);
     }
   }
-  const profile = {
-    ...tempProfile,
-    _checksums: checksums
-  };
-  writeRaw(targetDir, "profile.yaml", yaml2.dump(profile));
-  writeRaw(targetDir, ".gitignore", ".obsidian/\n.DS_Store\n");
+  writeRaw(targetDir, "profile.yaml", yaml2.dump(tempProfile));
+  writeState(targetDir, { checksums });
+  writeRaw(targetDir, ".gitignore", `.obsidian/
+.DS_Store
+${STATE_FILENAME}
+`);
 }
 
 // src/validate.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, readdirSync } from "fs";
-import { join as join5, relative, sep, basename } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync5, 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 existsSync4(join5(cwd, "profile.yaml")) ? cwd : null;
+  return existsSync5(join6(cwd, "profile.yaml")) ? cwd : null;
 }
 function listMarkdownFiles(dir) {
-  if (!existsSync4(dir)) return [];
+  if (!existsSync5(dir)) return [];
   const results = [];
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    const fullPath = join5(dir, entry.name);
+    const fullPath = join6(dir, entry.name);
     if (entry.isDirectory()) {
       results.push(...listMarkdownFiles(fullPath));
     } else if (entry.isFile() && entry.name.endsWith(".md")) {
@@ -365,14 +415,14 @@ function parseExclusions(markdown) {
   return [...new Set(items)];
 }
 function checkSkillNotes(root, profile) {
-  const contentDir = join5(root, profile.content_dir ?? "graph");
-  const notesDir = join5(contentDir, NOTES);
-  const skillsDir = join5(contentDir, SKILLS);
+  const contentDir = join6(root, profile.content_dir ?? "graph");
+  const notesDir = join6(contentDir, NOTES);
+  const skillsDir = join6(contentDir, SKILLS);
   const noteFiles = listMarkdownFiles(notesDir);
   const noteSlugs = new Set(noteFiles.map((f) => basename(f, ".md")));
   const issues = [];
   for (const skillFile of listMarkdownFiles(skillsDir)) {
-    const content = readFileSync4(skillFile, "utf8");
+    const content = readFileSync5(skillFile, "utf8");
     const links = extractWikiLinks(content);
     for (const { target, line } of links) {
       if (!noteSlugs.has(target)) {
@@ -388,9 +438,9 @@ function checkSkillNotes(root, profile) {
   return issues;
 }
 function checkWikiLinks(root, profile) {
-  const contentDir = join5(root, profile.content_dir ?? "graph");
-  const notesDir = join5(contentDir, NOTES);
-  const postsDir = join5(contentDir, POSTS);
+  const contentDir = join6(root, profile.content_dir ?? "graph");
+  const notesDir = join6(contentDir, NOTES);
+  const postsDir = join6(contentDir, POSTS);
   const noteFiles = listMarkdownFiles(notesDir);
   const noteSlugs = new Set(noteFiles.map((f) => basename(f, ".md")));
   const issues = [];
@@ -399,7 +449,7 @@ function checkWikiLinks(root, profile) {
     ...listMarkdownFiles(postsDir)
   ];
   for (const file of filesToScan) {
-    const content = readFileSync4(file, "utf8");
+    const content = readFileSync5(file, "utf8");
     const links = extractWikiLinks(content);
     for (const { target, line } of links) {
       if (!noteSlugs.has(target)) {
@@ -415,15 +465,15 @@ function checkWikiLinks(root, profile) {
   return issues;
 }
 function checkExclusions(root, profile) {
-  const contentDir = join5(root, profile.content_dir ?? "graph");
-  const notesDir = join5(contentDir, NOTES);
-  const exclusionsPath = join5(notesDir, "exclusions.md");
-  if (!existsSync4(exclusionsPath)) return [];
-  const content = readFileSync4(exclusionsPath, "utf8");
+  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 = readFileSync5(exclusionsPath, "utf8");
   const items = parseExclusions(content);
   if (items.length === 0) return [];
-  const skillsDir = join5(contentDir, SKILLS);
-  const postsDir = join5(contentDir, POSTS);
+  const skillsDir = join6(contentDir, SKILLS);
+  const postsDir = join6(contentDir, POSTS);
   const filesToScan = [
     ...listMarkdownFiles(skillsDir),
     ...listMarkdownFiles(postsDir)
@@ -431,7 +481,7 @@ function checkExclusions(root, profile) {
   const issues = [];
   const seen = /* @__PURE__ */ new Set();
   for (const file of filesToScan) {
-    const fileContent = readFileSync4(file, "utf8");
+    const fileContent = readFileSync5(file, "utf8");
     const lines = fileContent.split("\n");
     for (let i = 0; i < lines.length; i++) {
       const lineText = lines[i];
@@ -464,11 +514,11 @@ function validate(root, profile) {
     if (a.file > b.file) return 1;
     return (a.line ?? 0) - (b.line ?? 0);
   });
-  const contentDir = join5(root, profile.content_dir ?? "graph");
+  const contentDir = join6(root, profile.content_dir ?? "graph");
   const scannedFiles = /* @__PURE__ */ new Set([
-    ...listMarkdownFiles(join5(contentDir, NOTES)),
-    ...listMarkdownFiles(join5(contentDir, SKILLS)),
-    ...listMarkdownFiles(join5(contentDir, POSTS))
+    ...listMarkdownFiles(join6(contentDir, NOTES)),
+    ...listMarkdownFiles(join6(contentDir, SKILLS)),
+    ...listMarkdownFiles(join6(contentDir, POSTS))
   ]);
   return {
     ok: allIssues.length === 0,
@@ -662,12 +712,12 @@ async function runInstall(cwd) {
   p.outro(chalk.hex("#94A3B8")("Run claude from inside your patina to get started."));
 }
 function writeProfile(cwd, profile) {
-  const full = join6(cwd, "profile.yaml");
-  writeFileSync3(full, yaml3.dump(profile), "utf8");
+  const full = join7(cwd, "profile.yaml");
+  writeFileSync4(full, yaml3.dump(profile), "utf8");
 }
 function removeManagedFileIfUnmodified(targetDir, rel, stored) {
-  const fullPath = join6(targetDir, rel);
-  if (!existsSync5(fullPath)) return "deleted";
+  const fullPath = join7(targetDir, rel);
+  if (!existsSync6(fullPath)) return "deleted";
   const currentHash = hashFile(fullPath);
   const storedHash = stored[rel];
   if (storedHash && currentHash !== storedHash) {
@@ -724,7 +774,7 @@ function applyProfileUpdate(cwd, profile, fields) {
     }
   };
   const vars = profileToVars(updatedProfile);
-  const stored = profile._checksums ?? {};
+  const stored = readState(cwd, profile).checksums;
   const newChecksums = {};
   const files = [
     ...baseManagedFiles(vars, updatedProfile.editor, cwd),
@@ -746,9 +796,10 @@ function applyProfileUpdate(cwd, profile, fields) {
       newChecksums[rel] = hash;
     }
   }
-  updatedProfile._checksums = newChecksums;
-  writeProfile(cwd, updatedProfile);
-  return { profile: updatedProfile, updated, skipped };
+  writeState(cwd, { checksums: newChecksums });
+  const profileToWrite = stripLegacyChecksums(updatedProfile);
+  writeProfile(cwd, profileToWrite);
+  return { profile: profileToWrite, updated, skipped };
 }
 async function runUpdateProfile(cwd, profile) {
   console.log("");
@@ -822,7 +873,7 @@ async function runUpdateProfile(cwd, profile) {
   p.outro(chalk.hex("#94A3B8")("Profile updated."));
 }
 function applyModuleChanges(cwd, profile, toAdd, toRemove, moduleInputs) {
-  const stored = profile._checksums ?? {};
+  const stored = readState(cwd, profile).checksums;
   const newChecksums = { ...stored };
   let updatedProfile = { ...profile, modules: [...profile.modules ?? []] };
   const added = [];
@@ -846,10 +897,10 @@ function applyModuleChanges(cwd, profile, toAdd, toRemove, moduleInputs) {
       }
     }
     for (const [relativePath, content] of moduleContentFiles(module, vars, contentDir)) {
-      const fullPath = join6(cwd, relativePath);
-      if (!existsSync5(fullPath)) {
+      const fullPath = join7(cwd, relativePath);
+      if (!existsSync6(fullPath)) {
         mkdirSync3(dirname4(fullPath), { recursive: true });
-        writeFileSync3(fullPath, content, "utf8");
+        writeFileSync4(fullPath, content, "utf8");
         added.push(relativePath);
       }
     }
@@ -874,9 +925,10 @@ function applyModuleChanges(cwd, profile, toAdd, toRemove, moduleInputs) {
       updatedProfile = def.onRemove(updatedProfile);
     }
   }
-  updatedProfile._checksums = newChecksums;
-  writeProfile(cwd, updatedProfile);
-  return { profile: updatedProfile, added, skipped: skippedFiles, deleted, kept };
+  writeState(cwd, { checksums: newChecksums });
+  const finalProfile = stripLegacyChecksums(updatedProfile);
+  writeProfile(cwd, finalProfile);
+  return { profile: finalProfile, added, skipped: skippedFiles, deleted, kept };
 }
 async function runUpdateModules(cwd, profile) {
   const currentModules = profile.modules ?? [];

package/dist/templates/CLAUDE.md

@@ -29,7 +29,7 @@ The graph is the source of truth. Nothing gets added to generated content unless
 
 ## How it works
 
-**Adding evidence:** Run `/include` and describe something you've done. Claude asks a few questions and writes a note to `{{CONTENT_DIR}}/notes/`.
+**Adding evidence:** Run `/add` and describe something you've done. Claude asks a few questions and writes a note to `{{CONTENT_DIR}}/notes/`.
 
 **Reviewing skills:** Run `/skill-search` to audit your notes for skill gaps, project completions, and stale entries.
 

package/dist/templates/graph/notes/README.md

@@ -12,7 +12,7 @@ Notes here are **first-class evidence** — weighted the same as weekly summarie
 
 ## How to add a note
 
-Run `/include <description>` and Claude will ask clarifying questions and write the note for you.
+Run `/add <description>` and Claude will ask clarifying questions and write the note for you.
 
 ## File naming
 

package/package.json

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