hypomnema 1.0.1 → 1.2.0

package/scripts/verify.mjs

@@ -26,8 +26,8 @@ function parseArgs(argv) {
   const args = { hypoDir: null, file: null, json: false };
   for (const arg of argv.slice(2)) {
     if (arg.startsWith('--hypo-dir=')) args.hypoDir = expandHome(arg.slice(11));
-    else if (arg.startsWith('--file='))    args.file   = expandHome(arg.slice(7));
-    else if (arg === '--json')             args.json   = true;
+    else if (arg.startsWith('--file=')) args.file = expandHome(arg.slice(7));
+    else if (arg === '--json') args.json = true;
   }
   if (!args.hypoDir) args.hypoDir = resolveHypoRoot();
   return args;
@@ -55,7 +55,11 @@ 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(/\s*#.*$/, '').replace(/^["']|["']$/g, '');
+    fm[line.slice(0, idx).trim()] = line
+      .slice(idx + 1)
+      .trim()
+      .replace(/\s*#.*$/, '')
+      .replace(/^["']|["']$/g, '');
   }
   return fm;
 }
@@ -72,18 +76,22 @@ if (args.file) {
   files = [args.file];
 } else {
   const ignorePatterns = loadHypoIgnore(args.hypoDir);
-  const scanDirs = ['pages', 'projects'].map(d => join(args.hypoDir, d));
-  files = scanDirs.flatMap(d => collectMdFiles(d, [], args.hypoDir, ignorePatterns));
+  const scanDirs = ['pages', 'projects'].map((d) => join(args.hypoDir, d));
+  files = scanDirs.flatMap((d) => collectMdFiles(d, [], args.hypoDir, ignorePatterns));
 }
 
-const overdue  = [];
+const overdue = [];
 const upcoming = [];
-const missing  = [];
-const ok       = [];
+const missing = [];
+const ok = [];
 
 for (const file of files) {
   let content;
-  try { content = readFileSync(file, 'utf-8'); } catch { continue; }
+  try {
+    content = readFileSync(file, 'utf-8');
+  } catch {
+    continue;
+  }
   const fm = parseFrontmatter(content);
   if (!fm) continue;
 
@@ -152,16 +160,18 @@ if (ok.length > 0 && overdue.length === 0 && upcoming.length === 0) {
 }
 
 const summary = [
-  overdue.length  ? `${overdue.length} overdue`  : '',
+  overdue.length ? `${overdue.length} overdue` : '',
   upcoming.length ? `${upcoming.length} due soon` : '',
-  missing.length  ? `${missing.length} missing verify_by` : '',
-  ok.length       ? `${ok.length} ok` : '',
-].filter(Boolean).join(', ');
+  missing.length ? `${missing.length} missing verify_by` : '',
+  ok.length ? `${ok.length} ok` : '',
+]
+  .filter(Boolean)
+  .join(', ');
 
 console.log(`Result: ${summary || 'nothing to verify'}`);
 
 // Emit signal lines for overdue/upcoming pages so /hypo:verify skill can drive review
-const needsReview = [...overdue, ...upcoming].filter(p => p.verify_by);
+const needsReview = [...overdue, ...upcoming].filter((p) => p.verify_by);
 if (needsReview.length > 0) {
   console.log('');
   for (const p of needsReview) {

package/scripts/weekly-report.mjs

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+/**
+ * weekly-report.mjs — Weekly observability report (Lane E)
+ *
+ * Aggregates session-audit results into a Markdown report under
+ * `<hypo-dir>/journal/weekly/<YYYY-Www>.md` (spec §6.4 SoT).
+ *
+ * The autonomy score is heuristic on purpose — see
+ * pages/observability/_index.md for the definition and the 4-week
+ * baseline plan before we revisit LLM-judge classification.
+ *
+ * Usage:
+ *   node scripts/weekly-report.mjs [--hypo-dir=<path>] [--week=YYYY-Www]
+ *                                  [--limit N] [--write] [--json]
+ */
+
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { resolveHypoRoot, expandHome } from './lib/hypo-root.mjs';
+import { loadSessionEntries, auditEntries } from './session-audit.mjs';
+
+function parseArgs(argv) {
+  const args = {
+    hypoDir: null,
+    week: null,
+    limit: 200,
+    write: false,
+    json: false,
+    fallbackAll: false,
+  };
+  for (const arg of argv.slice(2)) {
+    if (arg.startsWith('--hypo-dir=')) args.hypoDir = expandHome(arg.slice(11));
+    else if (arg.startsWith('--week=')) args.week = arg.slice(7);
+    else if (arg.startsWith('--limit=')) args.limit = parseInt(arg.slice(8), 10) || 200;
+    else if (arg === '--write') args.write = true;
+    else if (arg === '--json') args.json = true;
+    else if (arg === '--fallback-all-projects') args.fallbackAll = true;
+  }
+  if (!args.hypoDir) args.hypoDir = resolveHypoRoot();
+  return args;
+}
+
+function isoWeek(date) {
+  // ISO-8601 week: Thursday in current week decides the year.
+  const d = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+  const dayNum = d.getUTCDay() || 7;
+  d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+  const week = Math.ceil(((d - yearStart) / 86400000 + 1) / 7);
+  return `${d.getUTCFullYear()}-W${String(week).padStart(2, '0')}`;
+}
+
+function parseWeekArg(spec) {
+  // Accepts YYYY-Www (ISO 8601). Returns the Monday of that ISO week, or
+  // null if the week number does not exist in that year (round-trips via
+  // isoWeek to reject W00, W54, and W53 in non-53-week years).
+  const m = String(spec).match(/^(\d{4})-W(\d{2})$/);
+  if (!m) return null;
+  const year = parseInt(m[1], 10);
+  const week = parseInt(m[2], 10);
+  if (week < 1 || week > 53) return null;
+  const jan4 = new Date(Date.UTC(year, 0, 4));
+  const jan4Dow = jan4.getUTCDay() || 7;
+  const week1Mon = new Date(jan4);
+  week1Mon.setUTCDate(jan4.getUTCDate() - (jan4Dow - 1));
+  const weekStart = new Date(week1Mon);
+  weekStart.setUTCDate(week1Mon.getUTCDate() + (week - 1) * 7);
+  if (isoWeek(weekStart) !== spec) return null;
+  return weekStart;
+}
+
+function filterToWeek(results, weekLabel) {
+  return results.filter((r) => {
+    if (!r.recorded_at) return false;
+    return isoWeek(new Date(r.recorded_at)) === weekLabel;
+  });
+}
+
+function tally(results) {
+  const out = {
+    normal: 0,
+    'search-0': 0,
+    'search-many': 0,
+    'ingest-missed': 0,
+    'staleness-skip': 0,
+  };
+  for (const r of results) out[r.classification] = (out[r.classification] || 0) + 1;
+  return out;
+}
+
+function autonomyScore(results) {
+  // Heuristic v0 (see pages/observability/_index.md §3 for the formal sketch).
+  // Numerator   = weighted "wiki was actually used" signals.
+  // Denominator = same signals expected (1 per non-stale session, plus URL→ingest opportunities).
+  let num = 0;
+  let den = 0;
+  for (const r of results) {
+    if (r.classification === 'staleness-skip') continue;
+    const m = r.metrics;
+    den += 1; // at minimum, expect *some* wiki engagement per real session
+    num += Math.min(m.search_count, 3) + m.ingest_count * 3 + m.feedback_count * 2;
+    if (m.urls > 0) {
+      // Each URL is a missed-ingest opportunity (weight 2). Numerator is *not*
+      // boosted here — `ingest_count` is already credited above; what URLs do
+      // is raise the bar for what "fully autonomous" looks like.
+      den += Math.min(m.urls, 5) * 2;
+    }
+  }
+  if (den === 0) return 0;
+  return Math.min(100, Math.max(0, Math.round((num / den) * 100)));
+}
+
+export function buildReport(
+  hypoDir,
+  { week, limit = 200, now = Date.now(), fallbackAll = false } = {},
+) {
+  const entries = loadSessionEntries(hypoDir, { fallbackAll });
+  const audited = auditEntries(entries, { limit, maxAgeDays: 365, now });
+  const weekLabel = week || isoWeek(new Date(now));
+  const weekResults = filterToWeek(audited, weekLabel);
+  const counts = tally(weekResults);
+  const score = autonomyScore(weekResults);
+  return { week: weekLabel, count: weekResults.length, counts, score, results: weekResults };
+}
+
+function renderMarkdown(report) {
+  const { week, count, counts, score, results } = report;
+  const today = new Date().toISOString().slice(0, 10);
+  const lines = [];
+  lines.push('---');
+  lines.push(`title: Observability — Week ${week}`);
+  lines.push('tags: [observability, autonomy, weekly]');
+  lines.push('type: weekly-journal');
+  lines.push(`week: ${week}`);
+  lines.push(`generated_by: manual`);
+  lines.push(`updated: ${today}`);
+  lines.push('---');
+  lines.push('');
+  lines.push(`# Observability — Week ${week}`);
+  lines.push('');
+  lines.push(
+    `> Generated by \`scripts/weekly-report.mjs\`. Heuristic definition: [[pages/observability/_index]].`,
+  );
+  lines.push('');
+  lines.push(`## Autonomy score (heuristic v0): **${score}%**`);
+  lines.push('');
+  lines.push(`Sessions audited: ${count}`);
+  lines.push('');
+  lines.push('| Classification | Count |');
+  lines.push('|---|---|');
+  for (const k of ['normal', 'search-0', 'search-many', 'ingest-missed', 'staleness-skip']) {
+    lines.push(`| ${k} | ${counts[k] || 0} |`);
+  }
+  lines.push('');
+  if (results.length === 0) {
+    lines.push(
+      '_No sessions recorded in this week. If this is unexpected, check `hooks/hypo-session-record.mjs` and `.cache/sessions/index.jsonl`._',
+    );
+  } else {
+    lines.push('## Sessions');
+    lines.push('');
+    lines.push('| Session | Class | search | ingest | urls | recorded |');
+    lines.push('|---|---|---|---|---|---|');
+    for (const r of results) {
+      const m = r.metrics;
+      lines.push(
+        `| ${r.session_id} | ${r.classification} | ${m.search_count} | ${m.ingest_count} | ${m.urls} | ${r.recorded_at || '—'} |`,
+      );
+    }
+  }
+  return lines.join('\n') + '\n';
+}
+
+function isMain() {
+  try {
+    return import.meta.url === `file://${process.argv[1]}`;
+  } catch {
+    return false;
+  }
+}
+
+if (isMain()) {
+  const args = parseArgs(process.argv);
+  if (args.week && !parseWeekArg(args.week)) {
+    console.error(`Error: invalid --week value "${args.week}" (expected YYYY-Www)`);
+    process.exit(2);
+  }
+  const report = buildReport(args.hypoDir, {
+    week: args.week,
+    limit: args.limit,
+    fallbackAll: args.fallbackAll,
+  });
+
+  if (args.json) {
+    console.log(JSON.stringify(report, null, 2));
+    process.exit(0);
+  }
+
+  const md = renderMarkdown(report);
+
+  if (args.write) {
+    const dir = join(args.hypoDir, 'journal', 'weekly');
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, `${report.week}.md`);
+    writeFileSync(path, md);
+    console.log(`✓ Wrote ${path}`);
+    console.log(`  Autonomy score: ${report.score}%  (sessions: ${report.count})`);
+  } else {
+    process.stdout.write(md);
+  }
+}

package/skills/crystallize/SKILL.md

@@ -1,15 +1,18 @@
 ---
-description: Surface synthesis candidates and consolidate scattered wiki knowledge into stable pages
+description: Close a session (steps 1~6) and, on request, consolidate scattered wiki knowledge into stable pages (steps 7~11)
 ---
 
-You are running `/hypo:crystallize`. Find pages that are ready to be consolidated into stable, cross-linked knowledge — then guide the synthesis.
+You are running `/hypo:crystallize`. The command serves two modes (spec §5.2.7 / §8.3):
+
+1. **Session close (steps 1~6)** — gate the 5 mandatory memory files plus open-questions (conditional) so `/compact` can pass.
+2. **Synthesis (steps 7~11)** — surface tag clusters, orphan pages, and drafts that are ready to consolidate.
+
+When invoked at the end of a session (or with phrases like "세션 종료", "wrap up"), run the session-close checklist first. The synthesis scan only runs after close is confirmed and the user agrees.
 
 ## What this does
 
-- Finds tag groups with ≥ N pages sharing the same tag (synthesis candidates)
-- Lists orphan pages (no outbound `[[wikilinks]]`)
-- Lists draft / stub pages that could be fleshed out
-- After the script runs, you help the user pick what to crystallize and do it
+- **Close mode**: walks the 6-step checklist (session-state, project hot.md, root hot.md, session-log, open-questions(변경 시), log.md) and verifies via `crystallize.mjs --check-session-close` — same gate the PreCompact hook runs.
+- **Synthesis mode**: finds tag clusters (≥ N pages), orphan pages (no outbound `[[wikilinks]]`), and draft / stub pages, then guides consolidation into `pages/syntheses/<topic>.md` with back-links and `index.md` updates.
 
 ---
 
@@ -49,7 +52,17 @@ If `/hypo:crystallize` was invoked as a session-close action, run through this c
 5. **open-questions** — only if `pages/open-questions.md` exists and questions were raised or resolved this session: move resolved ones out; add newly raised ones. Skip if unchanged.
 6. **log.md** — append a `session` entry to `<wiki-root>/log.md`.
 
-After completing the checklist, report each item with ✓ and ask: "Session closed. Would you like to also run knowledge synthesis now, or stop here?"
+After completing the checklist, verify it before reporting:
+
+```bash
+node <package-root>/scripts/crystallize.mjs --check-session-close [--hypo-dir="<path>"]
+```
+
+This runs the same strict check as the PreCompact hard gate (fix #17). Fix any
+file reported `missing` or `stale` and re-run until it passes — otherwise
+`/compact` will be blocked.
+
+Once it passes, report each item with ✓ and ask: "Session closed. Would you like to also run knowledge synthesis now, or stop here?"
 
 ---
 
@@ -83,3 +96,7 @@ evidence_strength: inferred
 
 3. Cross-link all source pages back to the synthesis with `[[wikilink]]`.
 4. Add the synthesis to `index.md` under `## Pages — Syntheses`.
+
+---
+
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]`. The observability audit counts citations toward the autonomy score — see [[pages/observability/_index]] (run `/hypo:audit` to inspect).

package/skills/graph/SKILL.md

@@ -52,3 +52,7 @@ node <package-root>/scripts/graph.mjs \
 - **dot**: wrap the output in a fenced code block tagged `dot` and suggest the user pipe it to `dot -Tsvg -o graph.svg`.
 
 If the graph has 0 edges, note that no `[[wikilinks]]` were found between pages.
+
+---
+
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]`. The observability audit counts citations toward the autonomy score — see [[pages/observability/_index]] (run `/hypo:audit` to inspect).

package/skills/ingest/SKILL.md

@@ -16,14 +16,14 @@ You are running `/hypo:ingest`. Add a new source document to `sources/` and crea
 
 Locate the Hypomnema package root (the directory two levels above this file (`skills/<name>/SKILL.md` → package root)).
 
-If the user specified a wiki directory, pass it as `--wiki-dir="<path>"`. Otherwise omit the flag and the script resolves the wiki root automatically via `HYPO_DIR` → `hypo-config.md` scan → `~/hypomnema`.
+If the user specified a wiki directory, pass it as `--hypo-dir="<path>"`. Otherwise omit the flag and the script resolves the wiki root automatically via `HYPO_DIR` → `hypo-config.md` scan → `~/hypomnema`.
 
 ---
 
 ## Step 2 — Run ingest status check
 
 ```bash
-node <package-root>/scripts/ingest.mjs [--wiki-dir="<path>"] [--json]
+node <package-root>/scripts/ingest.mjs [--hypo-dir="<path>"] [--json]
 ```
 
 Options:
@@ -33,7 +33,27 @@ Show the output verbatim.
 
 ---
 
-## Step 3 — Handle the source file
+## Step 3 — Privacy guard (`.hypoignore`)
+
+Before touching any source content, refuse to ingest secrets (`.env`, SSH keys, credentials). Run the guard for **both** the input path and the destination path:
+
+1. **If the user provided a file path**, check it (use an absolute path):
+
+   ```bash
+   node <package-root>/scripts/ingest.mjs [--hypo-dir="<path>"] --check="<absolute-input-path>"
+   ```
+
+2. **Always** check the destination `sources/<slug>.<ext>`:
+
+   ```bash
+   node <package-root>/scripts/ingest.mjs [--hypo-dir="<path>"] --check="sources/<slug>.<ext>"
+   ```
+
+If either command exits non-zero, **stop**: surface the `Refused: ...` message to the user and do not download, read, or save the source. The slug check matters because a user could rename a `.env` to an innocuous slug — the destination must still be blocked.
+
+---
+
+## Step 4 — Handle the source file
 
 **If the user provided a file or URL to ingest:**
 
@@ -46,7 +66,7 @@ List un-ingested sources from the script output and ask which one to process now
 
 ---
 
-## Step 4 — Synthesize a source-summary page
+## Step 5 — Synthesize a source-summary page
 
 For the chosen source, read its content and create `pages/<slug>.md` with the following frontmatter:
 
@@ -70,7 +90,7 @@ Cross-reference existing pages with `[[wikilink]]` syntax where relevant.
 
 ---
 
-## Step 5 — Update log.md
+## Step 6 — Update log.md
 
 Append an ingest entry to `<wiki-root>/log.md`:
 
@@ -81,3 +101,7 @@ Append an ingest entry to `<wiki-root>/log.md`:
 - summary: pages/<slug>.md
 - tags: <tags>
 ```
+
+---
+
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]`. The observability audit counts citations toward the autonomy score — see [[pages/observability/_index]] (run `/hypo:audit` to inspect).

package/skills/lint/SKILL.md

@@ -53,3 +53,7 @@ For **broken wikilinks**: list the affected files and ask if the user wants help
 For **missing `updated`**: suggest running with `--fix` to auto-add `updated: <today>` to each affected page's frontmatter. Note: `--fix` only repairs files that already have a valid, closed frontmatter block — files with no frontmatter or malformed frontmatter are skipped.
 
 For **missing required fields** (`title`, `type`): open the affected files and help the user fill them in.
+
+---
+
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]`. The observability audit counts citations toward the autonomy score — see [[pages/observability/_index]] (run `/hypo:audit` to inspect).

package/skills/query/SKILL.md

@@ -56,3 +56,7 @@ Read the top matching pages (up to 5) and produce a synthesized response:
 3. **Gaps** — if the wiki lacks coverage on the topic, note what is missing and suggest an ingest target.
 
 If zero results are returned, say so and offer to broaden the search or suggest using `/hypo:ingest` to add relevant sources.
+
+---
+
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]`. The observability audit counts citations toward the autonomy score — see [[pages/observability/_index]] (run `/hypo:audit` to inspect).

package/skills/verify/SKILL.md

@@ -90,3 +90,7 @@ updated: <today YYYY-MM-DD>
 ```
 
 3. Save the file. Do not remove or reorder existing entries.
+
+---
+
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]`. The observability audit counts citations toward the autonomy score — see [[pages/observability/_index]] (run `/hypo:audit` to inspect).

package/templates/.hypoignore

@@ -8,10 +8,27 @@
 *.zip
 *.tar.gz
 
-# Credentials and secrets
+# Credentials and secrets (§6.8 baseline)
 *.pem
 *.key
-*.env
+.env*
+*.p12
+*.pfx
+id_rsa*
+id_ed25519*
+*credentials*
+*secret*
+*token*
+*password*
+*passwd*
+
+# Build artifacts
+node_modules/
+dist/
+build/
+
+# Hypomnema runtime cache (session growth metrics, future index.jsonl, etc.)
+.cache/
 
 # Draft / scratch (uncomment to hide from hooks)
 # drafts/

package/templates/Home.md

@@ -19,6 +19,8 @@ tags: [wiki, home]
 - [[SCHEMA]] — type system reference
 - [[hypo-guide]] — operations guide
 
+> **Auto-ingest rule**: after any `WebFetch` / `WebSearch` that yields relevant knowledge, run `/hypo:ingest` immediately without waiting for an explicit request.
+
 ---
 
 ## Active Projects

package/templates/SCHEMA.md

@@ -2,7 +2,7 @@
 title: Wiki Schema
 type: schema
 updated: YYYY-MM-DD
-version: 1.0
+version: 2.0
 ---
 
 # Wiki Schema
@@ -61,6 +61,17 @@ Files responsible for session continuity — separate from the type taxonomy abo
 - Session start: root `hot.md` → project `hot.md` → `session-state.md`
 - Session close: update project `hot.md` (what was done) + `session-state.md` (what to do next) + root `hot.md`
 
+**Pointer table row format** (`hypo-hot-rebuild.mjs` parses this with a fixed regex — wrong col3 format causes the row to be silently skipped):
+
+```
+| <Project Name> | YYYY-MM-DD | [[projects/<slug>/hot]] |
+```
+
+Column semantics:
+- col 1 (name): preserved as-is from the existing row
+- col 2 (date): **ignored on read** — rebuilt from `projects/<slug>/hot.md` frontmatter `updated:` (falls back to today if the file is absent)
+- col 3 (wikilink): must be `[[projects/<slug>/hot]]` — no trailing path, no markdown link `[text](url)`. Extra trailing columns are discarded during canonical rebuild (not dropped).
+
 ---
 
 ## 3. Required Frontmatter Fields
@@ -85,15 +96,59 @@ verify_by: <question to re-check at next review>
 verify_by_date: YYYY-MM-DD
 ```
 
+### 3.1. `feedback` type — projection fields (ADR 0031)
+
+Feedback pages are the single source of truth for behavior corrections;
+`hypomnema feedback-sync` projects them one-way into Claude Code's `MEMORY.md`
+and `~/.claude/CLAUDE.md` `<learned_behaviors>`. They require:
+
+```yaml
+status: active | superseded | archived
+scope: global | project:<project-id>     # global → eligible for CLAUDE.md projection;
+                                         # <project-id> must exact-match the resolved
+                                         # project-id (default: cwd → `/`,`.` replaced
+                                         # with `-`; or pass `--project-id=<id>`).
+                                         # Mismatched scope = page is NOT projected
+                                         # into that project's MEMORY.md.
+tier: L1 | L2                            # L1 required for CLAUDE.md <learned_behaviors>
+targets: [project-memory, claude-learned] # which projection surfaces to derive
+sensitivity: public | sanitized          # `private` forbidden (wiki is git-pushed)
+priority: 1-5                            # over-cap sort key (higher first)
+memory_summary: <one line for the MEMORY.md index>
+reason: <why this rule is needed>
+source: session:YYYY-MM-DD | commit:<hash> | pr:<n> | https://...
+
+# conditional — required when `targets` includes `claude-learned`:
+global_summary: <one line for the <learned_behaviors> entry>
+promote_to_global: true                  # explicit opt-in to global projection
+```
+
+Edit the feedback page only — never hand-edit the generated
+`<!-- HYPO:FEEDBACK-SYNC:START … -->` managed blocks (sync detects tampering as a conflict).
+
 ---
 
 ## 4. Tag Vocabulary
 
-Use lowercase, hyphenated tags. Keep the vocabulary small and consistent.
-
-**Domain tags**: `ai`, `dev`, `ops`, `security`, `data`, `design`, `management`
-**Status tags**: `draft`, `stable`, `deprecated`, `needs-review`
-**Meta tags**: `wiki`, `index`, `operations`, `guide`, `schema`
+Use lowercase, hyphenated tags. Vocabulary is locked — `lint` blocks unknown tags
+and forbidden patterns (PascalCase, plurals, whitespace, generic words).
+Extend this list (and `~/hypomnema/SCHEMA.md`) before introducing a new tag.
+
+**Meta**: `wiki`, `index`, `pages`, `home`, `overview`, `guide`, `operations`, `schema`, `reference`, `hypo`, `commands`, `hot-cache`, `migration`
+**Workflow**: `automation`, `hooks`, `observability`, `autonomy`, `wiki-health`, `weekly`
+**Project**: `project`, `prd`, `adr`, `session-state`
+**Domain**: `ai`, `dev`, `ops`, `security`, `data`, `design`, `management`
+**Status**: `active`, `completed`, `archived`, `draft`, `stable`, `deprecated`, `needs-review`, `proposed`, `superseded`
+**Content classification**: `learning`, `tip`, `feedback`, `gotcha`, `concept`, `pattern`
+
+### Forbidden patterns
+
+| Pattern | Reason | Use instead |
+|---------|--------|-------------|
+| PascalCase (`Jenkins`, `Claude`) | Inconsistent casing | `jenkins`, `claude-code` |
+| Plurals (`learnings`, `tips`) | Singular form is canonical | `learning`, `tip` |
+| Generic (`general`, `misc`, `other`, `todo`) | No search value | Specific domain tag |
+| Whitespace (`llm wiki`) | Parse breakage | `llm-wiki` |
 
 ---
 

package/templates/gitignore

@@ -0,0 +1,5 @@
+# .gitignore — generated by hypo init
+# Excludes Hypomnema runtime files that contain machine-specific or session PII.
+
+# Runtime cache: sync-state.json contains hostname() and timestamps
+.cache/

package/templates/hot.md

@@ -14,6 +14,8 @@ tags: [wiki, operations]
 
 | Project | Last Session | Hot Cache |
 |---|---|---|
+<!-- Row format: | Project Name | YYYY-MM-DD | [[projects/slug/hot]] | -->
+<!-- col2 date is rebuilt from projects/<slug>/hot.md frontmatter on each session close -->
 
 ## Session Start Checklist
 

package/templates/hypo-config.md

@@ -1,7 +1,7 @@
 ---
 title: Hypomnema Config
 type: config
-version: "1.0.1"
+version: "1.2.0"
 created: YYYY-MM-DD
 ---