@kevin0181/memoc 1.4.0 → 1.4.2

package/bin/cli.js

@@ -263,6 +263,23 @@ function archiveLegacySystems(dir, mark) {
   mark('move', `${path.relative(dir, systemsPath)} -> ${path.relative(dir, archivePath)}`);
 }
 
+function isDefaultLegacyWikiDirectory(dirPath) {
+  let entries = [];
+  try {
+    entries = fs.readdirSync(dirPath).filter(name => !name.startsWith('.'));
+  } catch {
+    return false;
+  }
+  if (entries.length !== 1 || entries[0] !== 'README.md') return false;
+
+  const src = safeRead(path.join(dirPath, 'README.md'));
+  const name = path.basename(dirPath);
+  if (name === 'sources') return src.includes('# Sources') && src.includes('Provenance records');
+  if (name === 'topics') return src.includes('# Topics') && src.includes('Synthesized topic pages');
+  if (name === 'global') return src.includes('# Global') && src.includes('Project-wide principles');
+  return false;
+}
+
 function migrateKnowledgeWiki(dir, mark) {
   const wikiDir = path.join(dir, '.memoc', 'wiki');
   const knowledgeDir = path.join(wikiDir, 'knowledge');
@@ -283,6 +300,16 @@ function migrateKnowledgeWiki(dir, mark) {
       try {
         const st = fs.statSync(dest);
         if (st.isFile() && isDefaultKnowledgeScaffold(dest)) fs.unlinkSync(dest);
+        else if (st.isDirectory() && fs.statSync(src).isDirectory()) {
+          if (isDefaultLegacyWikiDirectory(src)) {
+            fs.rmSync(src, { recursive: true, force: true });
+            mark('remove', `${path.relative(dir, src)} (legacy wiki scaffold)`);
+          } else {
+            const archived = movePathUnique(src, path.join(dir, '.memoc', 'raw', 'legacy-wiki-root', from));
+            mark('move', `${path.relative(dir, src)} -> ${path.relative(dir, archived)} (legacy wiki dir)`);
+          }
+          continue;
+        }
         else continue;
       } catch {
         continue;
@@ -293,10 +320,48 @@ function migrateKnowledgeWiki(dir, mark) {
   }
 }
 
+function migrateKnowledgeLayerLinks(filePath) {
+  if (!fs.existsSync(filePath)) return false;
+  const before = safeRead(filePath);
+  if (!before) return false;
+
+  let after = before;
+  const normalized = filePath.replace(/\\/g, '/');
+
+  if (/\/wiki\/knowledge\/(sources|glossary|questions|lint)\.md$/.test(normalized)) {
+    after = after
+      .replace(/\]\(index\.md\)/g, '](../index.md)')
+      .replace(/\]\(\.\.\/raw\/README\.md\)/g, '](../../raw/README.md)');
+  }
+
+  if (/\/wiki\/knowledge\/global\/README\.md$/.test(normalized)) {
+    after = after
+      .replace(/\]\(\.\.\/index\.md\)/g, '](../../index.md)')
+      .replace(/\]\(\.\.\/\.\.\/00-project-brief\.md\)/g, '](../../../00-project-brief.md)')
+      .replace(/\]\(\.\.\/\.\.\/06-project-rules\.md\)/g, '](../../../06-project-rules.md)');
+  }
+
+  if (after === before) return false;
+  write(filePath, after);
+  return true;
+}
+
+function migrateRawKnowledgeLinks(filePath) {
+  if (!fs.existsSync(filePath)) return false;
+  const before = safeRead(filePath);
+  if (!before) return false;
+  const after = before
+    .replace(/\]\(\.\.\/wiki\/sources\/README\.md\)/g, '](../wiki/knowledge/sources/README.md)')
+    .replace(/\]\(\.\.\/\.\.\/wiki\/sources\/README\.md\)/g, '](../../wiki/knowledge/sources/README.md)');
+  if (after === before) return false;
+  write(filePath, after);
+  return true;
+}
+
 function isDefaultKnowledgeScaffold(filePath) {
   const src = safeRead(filePath);
   const name = path.basename(filePath);
-  if (name === 'sources.md') return src.includes('# Sources') && src.includes('_No sources recorded yet._');
+  if (name === 'sources.md') return src.includes('# Sources') && src.includes('_No sources recorded yet.');
   if (name === 'glossary.md') return src.includes('# Glossary') && src.includes('_No terms defined yet.');
   if (name === 'questions.md') return src.includes('# Open Questions') && src.includes('_No open questions yet._');
   if (name === 'lint.md') return src.includes('# Wiki Lint') && src.includes('_No issues found._');
@@ -2539,6 +2604,28 @@ function run(dir, forceUpdate, action = 'update') {
     }
     ensureWikiScaffoldLinks(memDir, mark);
 
+    const knowledgeLayerFiles = [
+      path.join(memDir, 'wiki/knowledge/sources.md'),
+      path.join(memDir, 'wiki/knowledge/glossary.md'),
+      path.join(memDir, 'wiki/knowledge/questions.md'),
+      path.join(memDir, 'wiki/knowledge/lint.md'),
+      path.join(memDir, 'wiki/knowledge/global/README.md'),
+    ];
+    for (const fp of knowledgeLayerFiles) {
+      if (migrateKnowledgeLayerLinks(fp)) mark('update', `${path.relative(dir, fp)} (wiki links)`);
+    }
+
+    const rawLinkFiles = [
+      path.join(memDir, 'raw/README.md'),
+      path.join(memDir, 'raw/files/README.md'),
+      path.join(memDir, 'raw/urls/README.md'),
+      path.join(memDir, 'raw/conversations/README.md'),
+      path.join(memDir, 'raw/docs/README.md'),
+    ];
+    for (const fp of rawLinkFiles) {
+      if (migrateRawKnowledgeLinks(fp)) mark('update', `${path.relative(dir, fp)} (raw links)`);
+    }
+
     const legacyReferenceFiles = [
       path.join(memDir, '02-current-project-state.md'),
       path.join(memDir, '04-handoff.md'),
@@ -2943,7 +3030,7 @@ ${warnings.length ? warnings.map(x => `- ${x}`).join('\n') : '_None._'}
 
 ## Related
 
-- [Wiki Index](index.md)
+- [Wiki Index](../index.md)
 - [Sources](sources.md)
 - [Topics](topics/README.md)
 - [Open Questions](questions.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevin0181/memoc",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Give AI agents a memory. Scaffolds session-to-session context for Claude Code, Codex, Cursor, and more.",
   "keywords": [
     "ai",