hypomnema 1.0.1 → 1.2.0

package/scripts/lint.mjs

@@ -18,6 +18,8 @@ import { join, relative, extname, basename } from 'path';
 import { resolveHypoRoot, expandHome } from './lib/hypo-root.mjs';
 import { SESSION_STATE_NEXT_HEADINGS } from '../hooks/hypo-shared.mjs';
 import { loadHypoIgnore, isIgnored } from './lib/hypo-ignore.mjs';
+import { parseSchemaVocab, checkForbidden, parseSchemaPageDirs } from './lib/schema-vocab.mjs';
+import { findDesignHistoryStale } from './lib/design-history-stale.mjs';
 
 // ── arg parsing ──────────────────────────────────────────────────────────────
 
@@ -25,8 +27,8 @@ function parseArgs(argv) {
   const args = { hypoDir: null, json: false, fix: false };
   for (const arg of argv.slice(2)) {
     if (arg.startsWith('--hypo-dir=')) args.hypoDir = expandHome(arg.slice(11));
-    else if (arg === '--json')         args.json = true;
-    else if (arg === '--fix')          args.fix  = true;
+    else if (arg === '--json') args.json = true;
+    else if (arg === '--fix') args.fix = true;
   }
   if (!args.hypoDir) args.hypoDir = resolveHypoRoot();
   return args;
@@ -41,11 +43,69 @@ function parseFrontmatter(content) {
   for (const line of m[1].split('\n')) {
     const idx = line.indexOf(':');
     if (idx < 0) continue;
-    fm[line.slice(0, idx).trim()] = line.slice(idx + 1).trim().replace(/^["']|["']$/g, '');
+    fm[line.slice(0, idx).trim()] = line
+      .slice(idx + 1)
+      .trim()
+      .replace(/^["']|["']$/g, '');
   }
   return fm;
 }
 
+function parseTagsField(rawValue) {
+  if (rawValue == null) return null;
+  const trimmed = String(rawValue).trim();
+  if (!trimmed) return [];
+  if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+    return trimmed
+      .slice(1, -1)
+      .split(',')
+      .map((t) => t.trim().replace(/^["']|["']$/g, ''))
+      .filter(Boolean);
+  }
+  return trimmed
+    .split(',')
+    .map((t) => t.trim().replace(/^["']|["']$/g, ''))
+    .filter(Boolean);
+}
+
+// type-conditional required fields (spec §6.3, SCHEMA.md §2)
+const TYPE_CONDITIONAL_FIELDS = {
+  prd: ['status', 'started'],
+  adr: ['source', 'status', 'date'],
+  'project-index': ['working_dir', 'status', 'started'],
+  'tool-eval': ['status'],
+  postmortem: ['outcome'],
+  learning: ['source'],
+  // feedback: ADR 0031 / fix #37 — projection SoT requires full classification
+  feedback: [
+    'status',
+    'scope',
+    'tier',
+    'targets',
+    'sensitivity',
+    'priority',
+    'memory_summary',
+    'reason',
+    'source',
+  ],
+  'prompt-pattern': ['source'],
+  'source-summary': ['sources'],
+  'weekly-journal': ['week'],
+};
+
+const TYPE_ENUM_FIELDS = {
+  prd: { status: ['draft', 'active', 'completed', 'cancelled', 'archived'] },
+  adr: { status: ['proposed', 'accepted', 'deprecated', 'superseded'] },
+  'tool-eval': { status: ['adopted', 'evaluating', 'rejected'] },
+  // feedback: ADR 0031 / fix #37 — sensitivity:private is forbidden (wiki is a
+  // git-pushed public surface)
+  feedback: {
+    status: ['active', 'superseded', 'archived'],
+    tier: ['L1', 'L2'],
+    sensitivity: ['public', 'sanitized'],
+  },
+};
+
 // ── page collector ────────────────────────────────────────────────────────────
 
 function collectPages(dir, root, pages = [], ignorePatterns = []) {
@@ -55,6 +115,11 @@ function collectPages(dir, root, pages = [], ignorePatterns = []) {
     if (isIgnored(full, root, ignorePatterns)) continue;
     const st = statSync(full);
     if (st.isDirectory()) {
+      // `_`-prefixed dirs (e.g. pages/feedback/_drafts) hold scaffolds / scratch
+      // not yet promoted to content — skip so incomplete frontmatter never errors
+      // (mirrors loadFeedbackPages in feedback-sync.mjs). `_`-prefixed *files*
+      // (e.g. _index.md) are still linted.
+      if (entry.startsWith('_')) continue;
       collectPages(full, root, pages, ignorePatterns);
     } else if (extname(entry) === '.md' && !entry.startsWith('.')) {
       pages.push({ path: full, rel: relative(root, full) });
@@ -87,11 +152,11 @@ function buildSlugMap(pages) {
 // wikilinks between them.
 function stripNonWikilinkRegions(content) {
   let out = content;
-  out = out.replace(/^[ \t]{0,3}```[\s\S]*?^[ \t]{0,3}```/gm, m => m.replace(/[^\n]/g, ' '));
-  out = out.replace(/^[ \t]{0,3}~~~[\s\S]*?^[ \t]{0,3}~~~/gm, m => m.replace(/[^\n]/g, ' '));
-  out = out.replace(/<!--[\s\S]*?-->/g, m => m.replace(/[^\n]/g, ' '));
-  out = out.replace(/``[^`\n]*``/g, m => ' '.repeat(m.length));
-  out = out.replace(/`[^`\n]*`/g, m => ' '.repeat(m.length));
+  out = out.replace(/^[ \t]{0,3}```[\s\S]*?^[ \t]{0,3}```/gm, (m) => m.replace(/[^\n]/g, ' '));
+  out = out.replace(/^[ \t]{0,3}~~~[\s\S]*?^[ \t]{0,3}~~~/gm, (m) => m.replace(/[^\n]/g, ' '));
+  out = out.replace(/<!--[\s\S]*?-->/g, (m) => m.replace(/[^\n]/g, ' '));
+  out = out.replace(/``[^`\n]*``/g, (m) => ' '.repeat(m.length));
+  out = out.replace(/`[^`\n]*`/g, (m) => ' '.repeat(m.length));
   return out;
 }
 
@@ -108,16 +173,33 @@ function extractWikilinks(content) {
 
 const REQUIRED_FIELDS = ['title', 'type'];
 const VALID_TYPES = [
-  'concept', 'source-summary', 'entity', 'tool-eval', 'prompt-pattern',
-  'playbook', 'learning', 'tip', 'feedback', 'reference', 'synthesis',
-  'weekly-journal', 'prd', 'adr', 'session-log', 'session-state',
-  'project-index', 'postmortem', 'open-questions', 'schema', 'source',
+  'concept',
+  'source-summary',
+  'entity',
+  'tool-eval',
+  'prompt-pattern',
+  'playbook',
+  'learning',
+  'tip',
+  'feedback',
+  'reference',
+  'synthesis',
+  'weekly-journal',
+  'prd',
+  'adr',
+  'session-log',
+  'session-state',
+  'project-index',
+  'postmortem',
+  'open-questions',
+  'schema',
+  'source',
 ];
 
 const issues = [];
 
-function issue(severity, rel, msg, fullPath = null) {
-  issues.push({ severity, file: rel, message: msg, path: fullPath });
+function issue(severity, rel, msg, fullPath = null, id = null) {
+  issues.push({ severity, file: rel, message: msg, path: fullPath, id });
 }
 
 function hasHeading(content, heading) {
@@ -128,18 +210,43 @@ function hasHeading(content, heading) {
 function lintSessionStateHeadings(content, rel) {
   if (!rel.match(/^projects\/[^/]+\/session-state\.md$/)) return;
 
-  if (!SESSION_STATE_NEXT_HEADINGS.some(heading => hasHeading(content, heading))) {
+  if (!SESSION_STATE_NEXT_HEADINGS.some((heading) => hasHeading(content, heading))) {
     issue(
       'error',
       rel,
-      `Missing required session-state heading: one of ${SESSION_STATE_NEXT_HEADINGS.map(h => `## ${h}`).join(', ')}`
+      `Missing required session-state heading: one of ${SESSION_STATE_NEXT_HEADINGS.map((h) => `## ${h}`).join(', ')}`,
     );
   }
 }
 
-function lintPage({ path, rel }, slugMap) {
+function lintPage({ path, rel }, slugMap, tagVocab, pageDirs) {
+  // Directory whitelist: a content page under pages/<subdir>/ must live in a
+  // SCHEMA-defined directory. Catches typo'd dirs (e.g. pages/learning/ vs the
+  // canonical pages/learnings/) regardless of frontmatter, since a directory
+  // absent from SCHEMA breaks wikilink resolution and crystallize routing.
+  // `_`-prefixed files (e.g. pages/observability/_index.md) are scaffold/section
+  // markers, not content — exempt them so packaged scaffold dirs that aren't a
+  // page *type* (e.g. observability, a topical grouping of reference pages) don't
+  // trip the guard. A real typo dir is created with content, not just an index.
+  // Skipped entirely when pageDirs is empty (SCHEMA.md or the table absent) for
+  // back-compat with minimal wikis — mirrors the tag-vocab check.
+  if (pageDirs && pageDirs.size > 0 && !basename(rel).startsWith('_')) {
+    const segs = rel.replace(/\\/g, '/').split('/');
+    if (segs[0] === 'pages' && segs.length > 2 && !pageDirs.has(segs[1])) {
+      issue(
+        'error',
+        rel,
+        `Undefined pages/ directory: "pages/${segs[1]}/" not in SCHEMA.md (likely a typo — defined: ${[...pageDirs].sort().join(', ')})`,
+      );
+    }
+  }
+
   let content;
-  try { content = readFileSync(path, 'utf-8'); } catch { return; }
+  try {
+    content = readFileSync(path, 'utf-8');
+  } catch {
+    return;
+  }
 
   if (!content.match(/^---\r?\n/)) {
     issue('warn', rel, 'No frontmatter found');
@@ -164,6 +271,63 @@ function lintPage({ path, rel }, slugMap) {
     issue('warn', rel, 'Missing frontmatter field: updated', path);
   }
 
+  // type-conditional required fields
+  if (fm.type && TYPE_CONDITIONAL_FIELDS[fm.type]) {
+    for (const field of TYPE_CONDITIONAL_FIELDS[fm.type]) {
+      if (!fm[field]) {
+        issue('error', rel, `Missing required field for type "${fm.type}": ${field}`);
+      }
+    }
+  }
+
+  // type-specific enum validation
+  if (fm.type && TYPE_ENUM_FIELDS[fm.type]) {
+    for (const [field, allowed] of Object.entries(TYPE_ENUM_FIELDS[fm.type])) {
+      if (fm[field] && !allowed.includes(fm[field])) {
+        issue(
+          'error',
+          rel,
+          `Invalid value for ${field} on type "${fm.type}": "${fm[field]}" (allowed: ${allowed.join(', ')})`,
+        );
+      }
+    }
+  }
+
+  // feedback: scope vocabulary + conditional claude-learned fields (ADR 0031)
+  if (fm.type === 'feedback') {
+    const scope = fm.scope || '';
+    if (scope && scope !== 'global' && !/^project:[a-z0-9][a-z0-9-]*$/.test(scope)) {
+      issue('error', rel, `Invalid feedback scope: "${scope}" (allowed: global | project:<slug>)`);
+    }
+    const fbTargets = parseTagsField(fm.targets) || [];
+    if (fbTargets.includes('claude-learned')) {
+      for (const field of ['global_summary', 'promote_to_global']) {
+        if (!fm[field]) {
+          issue(
+            'error',
+            rel,
+            `Missing required field for feedback with targets:claude-learned: ${field}`,
+          );
+        }
+      }
+    }
+  }
+
+  // tag vocabulary + forbidden patterns
+  const tags = parseTagsField(fm.tags);
+  if (tags && tagVocab && tagVocab.size > 0) {
+    for (const tag of tags) {
+      const forbidden = checkForbidden(tag);
+      if (forbidden) {
+        issue('error', rel, `Forbidden tag pattern (${forbidden}): "${tag}"`);
+        continue;
+      }
+      if (!tagVocab.has(tag)) {
+        issue('error', rel, `Unknown tag: "${tag}" (not in SCHEMA.md Tag Vocabulary)`);
+      }
+    }
+  }
+
   lintSessionStateHeadings(content, rel);
 
   for (const link of extractWikilinks(content)) {
@@ -178,17 +342,38 @@ function lintPage({ path, rel }, slugMap) {
 const args = parseArgs(process.argv);
 
 const ignorePatterns = loadHypoIgnore(args.hypoDir);
-const scanDirs = ['pages', 'projects'].map(d => join(args.hypoDir, d));
-const pages = scanDirs.flatMap(d => collectPages(d, args.hypoDir, [], ignorePatterns));
+const scanDirs = ['pages', 'projects', 'journal'].map((d) => join(args.hypoDir, d));
+const pages = scanDirs.flatMap((d) => collectPages(d, args.hypoDir, [], ignorePatterns));
 const slugMap = buildSlugMap(pages);
-
-for (const page of pages) lintPage(page, slugMap);
+const tagVocab = parseSchemaVocab(args.hypoDir);
+const pageDirs = parseSchemaPageDirs(args.hypoDir);
+
+for (const page of pages) lintPage(page, slugMap, tagVocab, pageDirs);
+
+// W8: design-history.md stale relative to session-log.md. Emitted once per
+// project (not per page) — runs outside the page loop. POSIX-separated path
+// literal (not path.join) so consumers can rely on `file.split('/')` shape
+// regardless of host OS — `hooks/hypo-personal-check.mjs:246` depends on this.
+for (const s of findDesignHistoryStale(args.hypoDir)) {
+  const gap = s.diffDays != null ? ` (${s.diffDays}일 차이)` : '';
+  issue(
+    'warn',
+    `projects/${s.project}/design-history.md`,
+    `design-history stale: session-log 최신=${s.lastSession} > design-history 최신=${s.lastDesignHistory}${gap} — projects/${s.project}/design-history.md에 설계 변경 사항을 append 하세요`,
+    null,
+    'W8',
+  );
+}
 
 if (args.fix) {
   const today = new Date().toISOString().slice(0, 10);
   const fixed = new Set();
   for (const iss of issues) {
-    if (iss.severity === 'warn' && iss.message === 'Missing frontmatter field: updated' && iss.path) {
+    if (
+      iss.severity === 'warn' &&
+      iss.message === 'Missing frontmatter field: updated' &&
+      iss.path
+    ) {
       const content = readFileSync(iss.path, 'utf-8');
       const fmMatch = /^---\r?\n[\s\S]*?\r?\n---/.exec(content);
       if (fmMatch) {
@@ -196,25 +381,47 @@ if (args.fix) {
         const closingTag = `${lineEnding}---`;
         const insertAt = fmMatch.index + fmMatch[0].lastIndexOf(closingTag);
         if (insertAt < 0) continue;
-        const fixedContent = content.slice(0, insertAt) + `${lineEnding}updated: ${today}` + content.slice(insertAt);
+        const fixedContent =
+          content.slice(0, insertAt) + `${lineEnding}updated: ${today}` + content.slice(insertAt);
         writeFileSync(iss.path, fixedContent);
         fixed.add(iss.path);
       }
     }
   }
   if (fixed.size > 0) {
-    issues.splice(0, issues.length, ...issues.filter(
-      i => !(i.severity === 'warn' && i.message === 'Missing frontmatter field: updated' && fixed.has(i.path))
-    ));
+    issues.splice(
+      0,
+      issues.length,
+      ...issues.filter(
+        (i) =>
+          !(
+            i.severity === 'warn' &&
+            i.message === 'Missing frontmatter field: updated' &&
+            fixed.has(i.path)
+          ),
+      ),
+    );
   }
 }
 
-const errors = issues.filter(i => i.severity === 'error');
-const warns  = issues.filter(i => i.severity === 'warn');
+const errors = issues.filter((i) => i.severity === 'error');
+const warns = issues.filter((i) => i.severity === 'warn');
 
 if (args.json) {
-  const toOut = ({ severity, file, message }) => ({ severity, file, message });
-  console.log(JSON.stringify({ ok: errors.length === 0, errors: errors.map(toOut), warns: warns.map(toOut), total: issues.length }, null, 2));
+  const toOut = ({ severity, file, message, id }) =>
+    id ? { severity, file, message, id } : { severity, file, message };
+  console.log(
+    JSON.stringify(
+      {
+        ok: errors.length === 0,
+        errors: errors.map(toOut),
+        warns: warns.map(toOut),
+        total: issues.length,
+      },
+      null,
+      2,
+    ),
+  );
 } else {
   if (issues.length === 0) {
     console.log('✓ No lint issues found');

package/scripts/query.mjs

@@ -27,9 +27,9 @@ function parseArgs(argv) {
   const args = { hypoDir: null, query: null, limit: 10, json: false };
   for (const arg of argv.slice(2)) {
     if (arg.startsWith('--hypo-dir=')) args.hypoDir = expandHome(arg.slice(11));
-    else if (arg.startsWith('--q='))     args.query  = arg.slice(4);
-    else if (arg.startsWith('--limit=')) args.limit  = parseInt(arg.slice(8), 10) || 10;
-    else if (arg === '--json')           args.json   = true;
+    else if (arg.startsWith('--q=')) args.query = arg.slice(4);
+    else if (arg.startsWith('--limit=')) args.limit = parseInt(arg.slice(8), 10) || 10;
+    else if (arg === '--json') args.json = true;
   }
   if (!args.hypoDir) args.hypoDir = resolveHypoRoot();
   return args;
@@ -57,12 +57,17 @@ function parseFrontmatter(content) {
   for (const line of m[1].split('\n')) {
     const idx = line.indexOf(':');
     if (idx < 0) continue;
-    fm[line.slice(0, idx).trim()] = line.slice(idx + 1).trim().replace(/^["']|["']$/g, '');
+    fm[line.slice(0, idx).trim()] = line
+      .slice(idx + 1)
+      .trim()
+      .replace(/^["']|["']$/g, '');
   }
   return fm;
 }
 
-function escapeRegex(s) { return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); }
+function escapeRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
 
 function scoreAndExcerpt(content, terms) {
   const lower = content.toLowerCase();
@@ -73,7 +78,7 @@ function scoreAndExcerpt(content, terms) {
   const lines = content.split('\n');
   let excerpt = '';
   for (const line of lines) {
-    if (terms.some(t => line.toLowerCase().includes(t))) {
+    if (terms.some((t) => line.toLowerCase().includes(t))) {
       excerpt = line.trim().slice(0, 120);
       break;
     }
@@ -92,18 +97,28 @@ if (!args.query) {
 
 const terms = args.query.toLowerCase().split(/\s+/).filter(Boolean);
 const ignorePatterns = loadHypoIgnore(args.hypoDir);
-const scanDirs = ['pages', 'projects'].map(d => join(args.hypoDir, d));
-const files = scanDirs.flatMap(d => collectMdFiles(d, args.hypoDir, [], ignorePatterns));
+const scanDirs = ['pages', 'projects'].map((d) => join(args.hypoDir, d));
+const files = scanDirs.flatMap((d) => collectMdFiles(d, args.hypoDir, [], ignorePatterns));
 
 const results = [];
 
 for (const { path, rel } of files) {
   let content;
-  try { content = readFileSync(path, 'utf-8'); } catch { continue; }
+  try {
+    content = readFileSync(path, 'utf-8');
+  } catch {
+    continue;
+  }
   const { score, excerpt } = scoreAndExcerpt(content, terms);
   if (score === 0) continue;
   const fm = parseFrontmatter(content);
-  results.push({ slug: rel.replace(/\.md$/, ''), title: fm.title || rel, type: fm.type || '', score, excerpt });
+  results.push({
+    slug: rel.replace(/\.md$/, ''),
+    title: fm.title || rel,
+    type: fm.type || '',
+    score,
+    excerpt,
+  });
 }
 
 results.sort((a, b) => b.score - a.score);
@@ -114,6 +129,7 @@ if (args.json) {
 } else {
   if (top.length === 0) {
     console.log(`No results for: ${args.query}`);
+    console.log(`→ 관련 페이지가 없습니다. 새 지식이 있다면 /hypo:ingest 로 추가해 보세요.`);
   } else {
     console.log(`Found ${results.length} result(s) for "${args.query}" (showing ${top.length}):\n`);
     for (const r of top) {

package/scripts/resume.mjs

@@ -23,9 +23,9 @@ import { resolveHypoRoot, expandHome } from './lib/hypo-root.mjs';
 function parseArgs(argv) {
   const args = { hypoDir: null, project: null, json: false };
   for (const arg of argv.slice(2)) {
-    if (arg.startsWith('--hypo-dir='))  args.hypoDir = expandHome(arg.slice(11));
+    if (arg.startsWith('--hypo-dir=')) args.hypoDir = expandHome(arg.slice(11));
     else if (arg.startsWith('--project=')) args.project = arg.slice(10);
-    else if (arg === '--json')           args.json    = true;
+    else if (arg === '--json') args.json = true;
   }
   if (!args.hypoDir) args.hypoDir = resolveHypoRoot();
   return args;
@@ -40,8 +40,11 @@ function resolveActiveProject(hypoDir) {
   const content = readFileSync(hotPath, 'utf-8');
   // Canonical hot.md uses wikilinks: | name | date | [[projects/slug/hot]] |
   // Pick the most recent row by the date column when present.
-  const wikiRows = [...content.matchAll(/\|\s*([^|]+?)\s*\|\s*(\d{4}-\d{2}-\d{2})?\s*\|\s*\[\[projects\/([^\]/]+)\/[^\]]+\]\]/g)]
-    .map(m => ({ name: m[1].trim(), date: m[2] || '', slug: m[3] }));
+  const wikiRows = [
+    ...content.matchAll(
+      /\|\s*([^|]+?)\s*\|\s*(\d{4}-\d{2}-\d{2})?\s*\|\s*\[\[projects\/([^\]/]+)\/[^\]]+\]\]/g,
+    ),
+  ].map((m) => ({ name: m[1].trim(), date: m[2] || '', slug: m[3] }));
   if (wikiRows.length > 0) {
     wikiRows.sort((a, b) => b.date.localeCompare(a.date));
     return wikiRows[0].slug;
@@ -60,7 +63,10 @@ function resolveActiveProject(hypoDir) {
     const ssPath = join(projectsDir, p, 'session-state.md');
     if (!existsSync(ssPath)) continue;
     const mtime = statSync(ssPath).mtimeMs;
-    if (mtime > latestMtime) { latestMtime = mtime; latest = p; }
+    if (mtime > latestMtime) {
+      latestMtime = mtime;
+      latest = p;
+    }
   }
   return latest;
 }