hypomnema 1.4.2 → 1.5.1

package/skills/crystallize/SKILL.md

@@ -11,14 +11,14 @@ When invoked to close a session — via an explicit close signal ("세션 종료
 
 ## What this does
 
-- **Close mode**: walks the checklist (session-state, project hot.md, root hot.md, session-log, open-questions(변경 시), log.md) plus a lint step, then writes via `crystallize.mjs --apply-session-close --payload=<path>` — which runs the lint gate automatically, **scoped to the files it writes** (debt elsewhere is a non-blocking notice). `--check-session-close` is a read-only dry-run of the **full** PreCompact gate (ADR 0046) — close files + scoped lint + design-history + feedback projection — sharing one function (`precompactGateStatus`) with the gate. A green check means no gate blocker needs a human fix, so it is the signal to declare the session closed (pass `--transcript-path` to widen the lint scope to this session's edited files exactly as the interactive hook does). It is not a hard guarantee: the live `/compact` can still differ on a context-≥70% prompt, `HYPO_SKIP_GATE`, or a transcript-scoped lint error the check did not see.
+- **Close mode**: walks the checklist (session-state, project hot.md, root hot.md, session-log, open-questions(변경 시), log.md) plus a lint step, then writes via `/hypo:crystallize` in `--apply-session-close --payload=<path>` mode — which runs the lint gate automatically, **scoped to the files it writes** (debt elsewhere is a non-blocking notice). `--check-session-close` is a read-only dry-run of the **full** PreCompact gate: close files + scoped lint + design-history + feedback projection, sharing one function (`precompactGateStatus`) with the gate. A green check means no gate blocker needs a human fix, so it is the signal to declare the session closed (pass `--transcript-path` to widen the lint scope to this session's edited files exactly as the interactive hook does). It is not a hard guarantee: the live `/compact` can still differ on a context-≥70% prompt, `HYPO_SKIP_GATE`, or a transcript-scoped lint error the check did not see.
 - **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.
 
 ---
 
 ## Step 1 — Locate package root
 
-Locate the Hypomnema package root (the directory two levels above this file (`skills/<name>/SKILL.md` → package root)).
+Bundled scripts here run via `${CLAUDE_PLUGIN_ROOT}/scripts/`. To resolve that package root: if `${CLAUDE_PLUGIN_ROOT}` is already an absolute path, use it; otherwise read `pkgRoot` from `~/.claude/hypo-pkg.json` (only when non-empty and the target script exists under it); otherwise use the `hypo@hypomnema` (or legacy `hypomnema@hypomnema`) installPath in `~/.claude/plugins/installed_plugins.json`; if none resolve, stop and tell the user to run `hypomnema upgrade --apply` or reinstall instead of guessing the cache layout.
 
 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`.
 
@@ -27,7 +27,7 @@ If the user specified a wiki directory, pass it as `--wiki-dir="<path>"`. Otherw
 ## Step 2 — Run crystallize scan
 
 ```bash
-node <package-root>/scripts/crystallize.mjs \
+node ${CLAUDE_PLUGIN_ROOT}/scripts/crystallize.mjs \
   [--wiki-dir="<path>"] \
   [--min-group=<n>] \
   [--json]
@@ -47,7 +47,7 @@ If `/hypo:crystallize` was invoked as a session-close action, run through this c
 
 ### Advisory reflections (run before the checklist below — advisory only)
 
-Surface each of these four to the user first. Every one is **advisory** (ADR 0029 identity guard): the user confirms or declines, and none performs an automatic action, writes a file on its own, or bypasses the mandatory gate.
+Surface each of these four to the user first. Every one is **advisory** (identity guard): the user confirms or declines, and none performs an automatic action, writes a file on its own, or bypasses the mandatory gate.
 
 - **Trivial-session check (#44)** — Was this session trivial (a single bug fix, a single-file edit, or Q&A with no durable artifact)? If so, recommend skipping session-close: *"이 세션은 trivial해 보입니다 — session-close를 건너뛸까요?"* A trivial skip is a recommendation, **not** a bypass: it must not mark the session closed, must not run `--mark-session-closed`, and must not claim `/compact` can pass. Any real close still requires all 5 mandatory files.
 - **ADR-candidate check (#41)** — Did this session make an architectural or design decision (a new pattern, a tradeoff, a convention)? If yes, ask whether it warrants an ADR and capture that intent in the session-log entry. If nothing rose to ADR level, you may record the literal marker `ADR 없음 — <one-line reason>` in that same session-log entry — but gate it on #42's bar, not this one: the marker is machine-read and W8 treats a session-log entry carrying `ADR 없음` (and no ADR reference) as a *no-design* session, excluding it from the design-history staleness check. So write `ADR 없음` only when the session had no design change at all. If it had a sub-ADR design shift (background / tradeoff / differentiation), append to design-history (#42a) instead — writing the marker there would suppress the W8 nudge that shift needs. **Never auto-write an ADR file** — the session-log note is the only action here.
@@ -67,11 +67,11 @@ When uncertain, surface the question rather than skip it. None of the four block
 After completing the checklist, verify it before reporting:
 
 ```bash
-node <package-root>/scripts/crystallize.mjs --check-session-close [--hypo-dir="<path>"]
+node ${CLAUDE_PLUGIN_ROOT}/scripts/crystallize.mjs --check-session-close [--hypo-dir="<path>"]
 ```
 
-This runs the **full** PreCompact gate via the shared `precompactGateStatus`
-(ADR 0046): close files (`missing` / `stale`) plus lint blockers, stale
+This runs the **full** PreCompact gate via the shared `precompactGateStatus`:
+close files (`missing` / `stale`) plus lint blockers, stale
 design-history, and feedback projection over-cap/conflict. Fix every `✗` it
 reports and re-run until it prints **"Compact-ready"** — that is the signal the
 session is closed. A close-files-only pass is not enough; the real `/compact`
@@ -92,7 +92,9 @@ main conversation id. Passing the wrong id causes `markerWritten: false` with
 `markerSkipReason: "transcript-unresolved"` or `"no-user-close-signal"`: the
 5 mandatory files are written (ok: true) but the Stop-chain marker is withheld,
 so the session is not actually closed and the Stop hook re-prompts. The correct
-id comes from the `[WIKI_AUTOCLOSE]` block reason or `$CLAUDE_SESSION_ID`.
+id comes from the `[WIKI_AUTOCLOSE]` block reason or the injected
+`$CLAUDE_CODE_SESSION_ID` (accept the legacy spelling via
+`${CLAUDE_CODE_SESSION_ID:-$CLAUDE_SESSION_ID}`).
 
 Once it passes, report each item with ✓:
 - ✓ session-state.md
@@ -100,11 +102,15 @@ Once it passes, report each item with ✓:
 - ✓ session-log entry
 - ✓ open-questions (or skipped if unchanged)
 - ✓ log.md entry
-- **marker written?** (required, if `--apply-session-close --session-id` was used): check `markerWritten` in the JSON output. If `true`, report "session-close marker written." If `false`, do NOT declare the session closed or complete. Instead report: "Files applied and verified (ok: true), but the session-close marker was not written (reason: `<markerSkipReason>`). The Stop-chain is still active. Re-run with the correct main-conversation `--session-id`."
+- **marker written?** (required, if `--apply-session-close --session-id` was used): check `markerWritten` in the JSON output. If `true`, report "session-close marker written." If `false`, do NOT declare the session closed or complete; recover per the `markerSkipReason` branch below.
 
 If `markerWritten: true` (or `--session-id` was not passed), ask: "Session closed. Would you like to also run knowledge synthesis now, or stop here?"
 
-If `markerWritten: false`, do NOT say "session closed." Surface the skip reason and instruct a re-run with the correct main-conversation `--session-id` (see the bullet above) before treating the session as closed.
+If `markerWritten: false`, do NOT say "session closed." Branch on `markerSkipReason`:
+
+- `no-user-close-signal`: files applied cleanly and the transcript resolved, but it carries no close phrase the gate recognizes (the user's close wording fell outside the close-signal set, e.g. "세션 마무리까지 진행해줘" / "세션 마무리 진행"). Re-running the same id will not help. Confirm intent once with `AskUserQuestion` (header "세션", one option **세션 마무리**); if the user picks it, that answer is a recognized close signal, so re-run the same `--apply-session-close … --session-id` command (idempotent no-op writes; the marker lands). If the user declines, leave the session unmarked. Do NOT change the close-signal matcher.
+- `transcript-unresolved` (wrong / background id): report "Files applied and verified (ok: true), but the marker was not written (reason: `<markerSkipReason>`). The Stop-chain is still active. Re-run with the correct main-conversation `--session-id`."
+- any other reason (`compact-gate-not-ok`, `commit-failed: …`, `marker-did-not-land`): surface it verbatim and resolve the underlying blocker before re-running.
 
 ---
 
@@ -141,4 +147,4 @@ evidence_strength: inferred
 
 ---
 
-> **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).
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]` so it stays connected in the graph. The observability audit scores sessions on search / ingest / feedback activity (recorded by `hypo-session-record`), not on these inline citations; run `/hypo:audit` to inspect and see [[pages/observability/_index]].

package/skills/graph/SKILL.md

@@ -14,7 +14,7 @@ You are running `/hypo:graph`. Build a wikilink dependency graph from all pages
 
 ## Step 1 — Locate package root
 
-Locate the Hypomnema package root (the directory two levels above this file (`skills/<name>/SKILL.md` → package root)).
+Bundled scripts here run via `${CLAUDE_PLUGIN_ROOT}/scripts/`. To resolve that package root: if `${CLAUDE_PLUGIN_ROOT}` is already an absolute path, use it; otherwise read `pkgRoot` from `~/.claude/hypo-pkg.json` (only when non-empty and the target script exists under it); otherwise use the `hypo@hypomnema` (or legacy `hypomnema@hypomnema`) installPath in `~/.claude/plugins/installed_plugins.json`; if none resolve, stop and tell the user to run `hypomnema upgrade --apply` or reinstall instead of guessing the cache layout.
 
 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`.
 
@@ -37,7 +37,7 @@ Optionally ask:
 ## Step 3 — Run graph
 
 ```bash
-node <package-root>/scripts/graph.mjs \
+node ${CLAUDE_PLUGIN_ROOT}/scripts/graph.mjs \
   [--wiki-dir="<path>"] \
   [--format=json|mermaid|dot] \
   [--min-edges=<n>]
@@ -55,4 +55,4 @@ 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).
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]` so it stays connected in the graph. The observability audit scores sessions on search / ingest / feedback activity (recorded by `hypo-session-record`), not on these inline citations; run `/hypo:audit` to inspect and see [[pages/observability/_index]].

package/skills/ingest/SKILL.md

@@ -14,7 +14,7 @@ You are running `/hypo:ingest`. Add a new source document to `sources/` and crea
 
 ## Step 1 — Locate package root
 
-Locate the Hypomnema package root (the directory two levels above this file (`skills/<name>/SKILL.md` → package root)).
+Bundled scripts here run via `${CLAUDE_PLUGIN_ROOT}/scripts/`. To resolve that package root: if `${CLAUDE_PLUGIN_ROOT}` is already an absolute path, use it; otherwise read `pkgRoot` from `~/.claude/hypo-pkg.json` (only when non-empty and the target script exists under it); otherwise use the `hypo@hypomnema` (or legacy `hypomnema@hypomnema`) installPath in `~/.claude/plugins/installed_plugins.json`; if none resolve, stop and tell the user to run `hypomnema upgrade --apply` or reinstall instead of guessing the cache layout.
 
 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`.
 
@@ -23,7 +23,7 @@ If the user specified a wiki directory, pass it as `--hypo-dir="<path>"`. Otherw
 ## Step 2 — Run ingest status check
 
 ```bash
-node <package-root>/scripts/ingest.mjs [--hypo-dir="<path>"] [--json]
+node ${CLAUDE_PLUGIN_ROOT}/scripts/ingest.mjs [--hypo-dir="<path>"] [--json]
 ```
 
 Options:
@@ -40,13 +40,13 @@ Before touching any source content, refuse to ingest secrets (`.env`, SSH keys,
 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>"
+   node ${CLAUDE_PLUGIN_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>"
+   node ${CLAUDE_PLUGIN_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.
@@ -104,4 +104,4 @@ Append an ingest entry to `<wiki-root>/log.md`:
 
 ---
 
-> **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).
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]` so it stays connected in the graph. The observability audit scores sessions on search / ingest / feedback activity (recorded by `hypo-session-record`), not on these inline citations; run `/hypo:audit` to inspect and see [[pages/observability/_index]].

package/skills/lint/SKILL.md

@@ -16,7 +16,7 @@ You are running `/hypo:lint`. Validate all wiki pages for frontmatter correctnes
 
 ## Step 1 — Locate package root
 
-Locate the Hypomnema package root (the directory two levels above this file (`skills/<name>/SKILL.md` → package root)).
+Bundled scripts here run via `${CLAUDE_PLUGIN_ROOT}/scripts/`. To resolve that package root: if `${CLAUDE_PLUGIN_ROOT}` is already an absolute path, use it; otherwise read `pkgRoot` from `~/.claude/hypo-pkg.json` (only when non-empty and the target script exists under it); otherwise use the `hypo@hypomnema` (or legacy `hypomnema@hypomnema`) installPath in `~/.claude/plugins/installed_plugins.json`; if none resolve, stop and tell the user to run `hypomnema upgrade --apply` or reinstall instead of guessing the cache layout.
 
 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`.
 
@@ -25,7 +25,7 @@ If the user specified a wiki directory, pass it as `--wiki-dir="<path>"`. Otherw
 ## Step 2 — Run lint
 
 ```bash
-node <package-root>/scripts/lint.mjs [--wiki-dir="<path>"] [--json] [--fix]
+node ${CLAUDE_PLUGIN_ROOT}/scripts/lint.mjs [--wiki-dir="<path>"] [--json] [--fix]
 ```
 
 Options:
@@ -56,4 +56,4 @@ For **missing required fields** (`title`, `type`): open the affected files and h
 
 ---
 
-> **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).
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]` so it stays connected in the graph. The observability audit scores sessions on search / ingest / feedback activity (recorded by `hypo-session-record`), not on these inline citations; run `/hypo:audit` to inspect and see [[pages/observability/_index]].

package/skills/query/SKILL.md

@@ -14,7 +14,7 @@ You are running `/hypo:query`. Full-text search across all wiki pages and projec
 
 ## Step 1 — Locate package root
 
-Locate the Hypomnema package root (the directory two levels above this file (`skills/<name>/SKILL.md` → package root)).
+Bundled scripts here run via `${CLAUDE_PLUGIN_ROOT}/scripts/`. To resolve that package root: if `${CLAUDE_PLUGIN_ROOT}` is already an absolute path, use it; otherwise read `pkgRoot` from `~/.claude/hypo-pkg.json` (only when non-empty and the target script exists under it); otherwise use the `hypo@hypomnema` (or legacy `hypomnema@hypomnema`) installPath in `~/.claude/plugins/installed_plugins.json`; if none resolve, stop and tell the user to run `hypomnema upgrade --apply` or reinstall instead of guessing the cache layout.
 
 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`.
 
@@ -31,7 +31,7 @@ Use the search terms from the user's message. If no query was provided, ask:
 ## Step 3 — Run query
 
 ```bash
-node <package-root>/scripts/query.mjs \
+node ${CLAUDE_PLUGIN_ROOT}/scripts/query.mjs \
   --q="<search terms>" \
   [--wiki-dir="<path>"] \
   [--limit=<n>] \
@@ -59,4 +59,4 @@ If zero results are returned, say so and offer to broaden the search or suggest
 
 ---
 
-> **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).
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]` so it stays connected in the graph. The observability audit scores sessions on search / ingest / feedback activity (recorded by `hypo-session-record`), not on these inline citations; run `/hypo:audit` to inspect and see [[pages/observability/_index]].

package/skills/verify/SKILL.md

@@ -14,7 +14,7 @@ You are running `/hypo:verify`. Check all wiki pages for `verify_by` and `verify
 
 ## Step 1 — Locate package root
 
-Locate the Hypomnema package root (the directory two levels above this file (`skills/<name>/SKILL.md` → package root)).
+Bundled scripts here run via `${CLAUDE_PLUGIN_ROOT}/scripts/`. To resolve that package root: if `${CLAUDE_PLUGIN_ROOT}` is already an absolute path, use it; otherwise read `pkgRoot` from `~/.claude/hypo-pkg.json` (only when non-empty and the target script exists under it); otherwise use the `hypo@hypomnema` (or legacy `hypomnema@hypomnema`) installPath in `~/.claude/plugins/installed_plugins.json`; if none resolve, stop and tell the user to run `hypomnema upgrade --apply` or reinstall instead of guessing the cache layout.
 
 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`.
 
@@ -23,7 +23,7 @@ If the user specified a wiki directory, pass it as `--wiki-dir="<path>"`. Otherw
 ## Step 2 — Run verify
 
 ```bash
-node <package-root>/scripts/verify.mjs \
+node ${CLAUDE_PLUGIN_ROOT}/scripts/verify.mjs \
   [--wiki-dir="<path>"] \
   [--file="<path>"] \
   [--json]
@@ -93,4 +93,4 @@ updated: <today YYYY-MM-DD>
 
 ---
 
-> **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).
+> **Citation convention.** When you reference a wiki page in your response, link it as `[[page-slug]]` so it stays connected in the graph. The observability audit scores sessions on search / ingest / feedback activity (recorded by `hypo-session-record`), not on these inline citations; run `/hypo:audit` to inspect and see [[pages/observability/_index]].

package/templates/SCHEMA.md

@@ -96,7 +96,7 @@ verify_by: <question to re-check at next review>
 verify_by_date: YYYY-MM-DD
 ```
 
-### 3.1. `feedback` type — projection fields (ADR 0031)
+### 3.1. `feedback` type — projection fields
 
 Feedback pages are the single source of truth for behavior corrections;
 `hypomnema feedback-sync` projects them one-way into Claude Code's `MEMORY.md`

package/templates/hypo-config.md

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

package/templates/hypo-guide.md

@@ -67,7 +67,7 @@ Trigger: explicit close mention, `/compact` request, or context limit approachin
 
 **Auto-trigger rule**: when the user sends a natural-language close signal — "세션 마무리하자", "오늘 여기까지", "이만 종료", "wrap up", "signing off", or equivalent — run the session close checklist immediately without waiting for an explicit `/compact` or `/hypo:crystallize`. If the intent is ambiguous, confirm with a single question before proceeding.
 
-**Proactive close offer** (ADR 0022 Layer 1): even when the user gives no close signal, offer to wrap up once a task is truly done — don't make them remember to. Fire `AskUserQuestion` **at the end of the assistant turn in which you report a task complete or verified**, when both hold:
+**Proactive close offer** (Layer 1): even when the user gives no close signal, offer to wrap up once a task is truly done — don't make them remember to. Fire `AskUserQuestion` **at the end of the assistant turn in which you report a task complete or verified**, when both hold:
 
 1. The session did substantial work — file mutations or multi-step changes, not Q&A only.
 2. The current user request did not already include a next task or tell you not to close.
@@ -82,13 +82,13 @@ Ask: *"이 작업이 마무리되었나요? 세션을 정리(crystallize)할까
 2. Update `projects/<name>/hot.md` (what was done, ≤500 words, overwrite)
 3. Append to `projects/<name>/session-log/YYYY-MM-DD.md` (daily shard, narrative entry, append-only)
 4. Update root `hot.md` pointer table + date
-5. Run `scripts/lint.mjs` and fix errors in files **you** touched — debt in other
+5. Run `/hypo:lint` and fix errors in files **you** touched — debt in other
    projects / shared pages you did not author is reported as a non-blocking
-   notice, not a gate. (The documented `crystallize.mjs --apply-session-close`
-   path runs this lint automatically, scoped to the files it writes.)
-6. Verify with `scripts/crystallize.mjs --check-session-close`: a dry-run of the
+   notice, not a gate. (The documented `/hypo:crystallize` session-close path
+   runs this lint automatically, scoped to the files it writes.)
+6. Verify with `/hypo:crystallize` in its `--check-session-close` mode: a dry-run of the
    **full** PreCompact gate (close files + lint + design-history + feedback
-   projection, ADR 0046), sharing one function with the gate. Only declare the
+   projection), sharing one function with the gate. Only declare the
    session closed once it prints **"Compact-ready"**. A "close files updated"
    check alone is not enough — the real `/compact` gate also blocks on a lint
    error in a close file or a feedback projection over-cap. (Not a hard
@@ -99,13 +99,13 @@ Ask: *"이 작업이 마무리되었나요? 세션을 정리(crystallize)할까
    diagnostic, JSON `scope: "project"`): green there means only that slug is
    close-complete, **not** that `/compact` is globally unblocked. Use the plain
    check for the go/no-go signal.
-7. Record the session-closed marker (ADR 0047). The Stop hook blocks until this
+7. Record the session-closed marker. The Stop hook blocks until this
    session's per-session marker exists, and a hand-edit close (writing the files
    directly + committing) never writes it; the marker is written only by the
-   crystallize writer, never by the hook (ADR 0022 bypass guard). Normal path:
-   close via `crystallize.mjs --apply-session-close --session-id=<id> --transcript-path=<path>`,
+   crystallize writer, never by the hook (bypass guard). Normal path:
+   close via `/hypo:crystallize` (`--apply-session-close --session-id=<id> --transcript-path=<path>`),
    which writes the marker once the gate is green. Hand-edit recovery: after
-   committing the files, run `crystallize.mjs --mark-session-closed --session-id=<id> --transcript-path=<path>`.
+   committing the files, run `/hypo:crystallize` (`--mark-session-closed --session-id=<id> --transcript-path=<path>`).
    Both writers gate the marker on the SAME `precompactGateStatus` as `/compact`,
    so the marker only lands when step 6 would print **"Compact-ready"**.
 
@@ -153,7 +153,7 @@ projects/<name>/
 
 Add to root `hot.md` active projects table.
 
-#### Auto-project offer (ADR 0023)
+#### Auto-project offer
 
 When SessionStart / CwdChanged injects a line like
 `[WIKI: cwd '<name>'에 매칭되는 프로젝트가 없습니다. 자동 생성할까요? (Y/n)]`,
@@ -166,8 +166,14 @@ ignore it:**
 2. **On Yes** — run the scaffold helper once (it substitutes tokens, creates
    the project files, adds the root `hot.md` row, and logs the entry):
    ```
-   node <pkg-root>/scripts/lib/project-create.mjs --name <slug> --working-dir "$(pwd)"
+   node ${CLAUDE_PLUGIN_ROOT}/scripts/lib/project-create.mjs --name <slug> --working-dir "$(pwd)"
    ```
+   To resolve that package root from this guide: if `${CLAUDE_PLUGIN_ROOT}` is
+   already an absolute path, use it; otherwise read `pkgRoot` from
+   `~/.claude/hypo-pkg.json` (only when non-empty and the script exists under it);
+   otherwise use the `hypo@hypomnema` (or legacy `hypomnema@hypomnema`) installPath
+   in `~/.claude/plugins/installed_plugins.json`; if none resolve, stop and tell the
+   user to run `hypomnema upgrade --apply` or reinstall instead of guessing.
    Then tell the user: "Created project `<name>` at
    `~/hypomnema/projects/<name>/`. Edit `index.md` to refine." Do **not** hand-write
    the five files — the helper keeps substitution and registration consistent.
@@ -219,7 +225,7 @@ ADRs are immutable once accepted. Mark deprecated/superseded but never edit cont
 
 Hypomnema v1.1.0 ships an **autonomy score** so you can see whether the wiki is actually being used per session, rather than just trusting that it is.
 
-- **Citation:** when a response uses a wiki page, link it inline as `[[page-slug]]`. The audit script counts citations as one signal of "the wiki was actually consulted".
+- **Citation:** when a response uses a wiki page, link it inline as `[[page-slug]]` to keep it connected in the graph. (The audit score is based on the tool and command usage below, not on these inline citations.)
 - **Tools that count:** `Grep`, `WebSearch`, `WebFetch`, and any `/hypo:query` / `/hypo:ingest` / `/hypo:feedback` invocation in the transcript.
 - **Classification (heuristic v0):**
   - `normal` — at least one search, no missed URL ingests
@@ -229,8 +235,8 @@ Hypomnema v1.1.0 ships an **autonomy score** so you can see whether the wiki is
   - `staleness-skip` — session older than the audit window (default 30d)
 - **Where it lives:**
   - Per-session transcript index: `<hypo-root>/.cache/sessions/index.jsonl` (written by the Stop hook `hypo-session-record.mjs`).
-  - Fallback source: `~/.claude/projects/<encoded>/*.jsonl` (used when the index is empty — see ADR 0019 if present in your wiki).
-  - Reports: `journal/weekly/<YYYY-Www>.md` (spec §6.4 SoT), generated by `node scripts/weekly-report.mjs --write`.
+  - Fallback source: `~/.claude/projects/<encoded>/*.jsonl` (used when the index is empty).
+  - Reports: `journal/weekly/<YYYY-Www>.md` (spec §6.4 SoT), generated by the `/hypo:audit` weekly report flow.
 - **Definitions:** the 0% / 100% endpoints, the formal score sketch, and open questions live in `pages/observability/_index.md`.
 
 Use `/hypo:audit` for a quick read of recent sessions; pass `--write` to commit the weekly report into the wiki.

package/templates/projects/_template/hot.md

@@ -21,7 +21,7 @@ tags: [hot-cache, project]
 ## Key Decisions
 
 <!-- Brief pointers to important ADRs or design choices -->
-<!-- [[decisions/0001-topic]] — decision summary -->
+<!-- [[decisions/NNNN-topic]] — decision summary -->
 
 ## Blockers / Open Questions
 

package/scripts/fix-status-verify.mjs

@@ -1,256 +0,0 @@
-#!/usr/bin/env node
-/**
- * fix-status-verify (CLI) — verify fix→test linkage + ADR-line evidence
- * against wiki spec claims.
- *
- * Phase 1: test-green half (anchors × spec status × runner results).
- * Phase 2 (A-sot): manifest validation + manifest↔anchor drift + ADR core
- * decision grep against the production corpus. See scripts/lib/fix-manifest.mjs
- * and scripts/lib/fix-status-verify.mjs headers.
- *
- * Usage:
- *   node scripts/fix-status-verify.mjs [--hypo-dir <path>]
- *                                      [--spec <path>]
- *                                      [--runner <path>]
- *                                      [--test-command "<cmd>"]
- *                                      [--json]
- *
- * Exit 0 if no error-level findings, 1 otherwise.
- */
-
-import { readFileSync, existsSync } from 'node:fs';
-import { join, dirname, resolve } from 'node:path';
-import { homedir } from 'node:os';
-import { spawnSync } from 'node:child_process';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import {
-  parseAnchors,
-  parseStatus,
-  parseRunnerOutput,
-  verifyMatrix,
-  isReferenceStub,
-  validateManifest,
-  checkManifestCoverage,
-  checkAdrLines,
-  FIX_MANIFEST,
-  NO_ADR,
-} from './lib/fix-status-verify.mjs';
-import { buildCorpusSearch } from './lib/adr-corpus.mjs';
-
-const REPO = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-
-// Production-code corpus for the ADR-line grep (spec §A amendment 2026-06-07:
-// templates/ ships via npm `files`, so prompt-driven fixes are verifiable).
-const CORPUS_DIRS = ['scripts', 'hooks', 'commands', 'skills', 'templates'];
-// MUST exclude the manifest itself — it holds every adrKeyLine as a literal and
-// would self-match, making ADR_LINE_MISSING impossible to ever fire.
-const CORPUS_EXCLUDE = ['scripts/lib/fix-manifest.mjs'];
-
-function parseArgs(argv) {
-  const out = {
-    hypoDir: process.env.HYPO_DIR || join(homedir(), 'hypomnema'),
-    spec: null,
-    runner: join(REPO, 'tests/runner.mjs'),
-    testCommand: 'npm test',
-    json: false,
-    manifest: null,
-  };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === '--hypo-dir') out.hypoDir = argv[++i];
-    else if (a === '--spec') out.spec = argv[++i];
-    else if (a === '--runner') out.runner = argv[++i];
-    else if (a === '--test-command') out.testCommand = argv[++i];
-    else if (a === '--manifest') out.manifest = argv[++i];
-    else if (a === '--json') out.json = true;
-    else if (a === '--help' || a === '-h') {
-      printHelp();
-      process.exit(0);
-    } else {
-      console.error(`unknown arg: ${a}`);
-      process.exit(2);
-    }
-  }
-  if (!out.spec) {
-    out.spec = join(out.hypoDir, 'projects/hypomnema/spec-v1.2.md');
-  }
-  return out;
-}
-
-function printHelp() {
-  console.log(
-    [
-      'fix-status-verify — Phase 1 (test-green half) of learned_behavior #6',
-      '',
-      'Options:',
-      '  --hypo-dir <path>        Wiki root (default: $HYPO_DIR or ~/hypomnema)',
-      '  --spec <path>            Override spec-v1.2.md path',
-      '  --runner <path>          Override tests/runner.mjs path',
-      '  --test-command "<cmd>"   Test invocation (default: "npm test")',
-      '  --json                   Emit machine-readable JSON report',
-      '',
-      'Exit 0 if no error findings, 1 otherwise.',
-      '',
-      'NOTE: The default --spec is a `type: reference` redirect stub (the real',
-      'spec moved to archive/). Running without --spec fails with STUB_SPEC by',
-      'design — pass --spec <real spec> to verify against actual claims.',
-      '',
-      'Phase 2 (A-sot): also greps each manifest adrKeyLine against the',
-      'production corpus (scripts/ hooks/ commands/ skills/ templates/) and',
-      'checks manifest↔anchor drift. NO_ADR rows skip the grep (test-green only).',
-    ].join('\n'),
-  );
-}
-
-function runTests(testCommand) {
-  // Parse simple command (no shell metacharacters supported in args; this is
-  // a maintainer tool, not a security boundary).
-  const parts = testCommand.split(/\s+/).filter(Boolean);
-  const [cmd, ...args] = parts;
-  const result = spawnSync(cmd, args, {
-    cwd: REPO,
-    encoding: 'utf-8',
-    env: { ...process.env, FORCE_COLOR: '0' },
-    maxBuffer: 64 * 1024 * 1024,
-  });
-  return {
-    stdout: result.stdout || '',
-    stderr: result.stderr || '',
-    exitCode: result.status,
-  };
-}
-
-function formatFinding(f) {
-  const icon = f.level === 'error' ? '✗' : '⚠';
-  // Some findings are not tied to a specific fix # (STUB_SPEC,
-  // TEST_RUN_NONZERO_EXIT). Only render the `fix #N` segment when present so
-  // they don't print `fix #undefined`.
-  const ref = f.fixNum != null ? ` fix #${f.fixNum}` : '';
-  return `  ${icon} [${f.class}]${ref}` + (f.testName ? ` (${f.testName})` : '') + `: ${f.detail}`;
-}
-
-async function main() {
-  const opts = parseArgs(process.argv.slice(2));
-
-  // Manifest source: built-in code constant by default (ADR 0036). --manifest
-  // <path.mjs> overrides for tests, which inject a fixture manifest matching
-  // their synthetic fixes so the real manifest does not couple to fixtures.
-  let manifest = FIX_MANIFEST;
-  if (opts.manifest) {
-    if (!existsSync(opts.manifest)) {
-      console.error(`manifest not found: ${opts.manifest}`);
-      process.exit(2);
-    }
-    const mod = await import(pathToFileURL(resolve(opts.manifest)).href);
-    manifest = mod.FIX_MANIFEST;
-  }
-
-  if (!existsSync(opts.spec)) {
-    console.error(`spec not found: ${opts.spec}`);
-    console.error('hint: pass --hypo-dir <path> or set $HYPO_DIR');
-    process.exit(2);
-  }
-  if (!existsSync(opts.runner)) {
-    console.error(`runner not found: ${opts.runner}`);
-    process.exit(2);
-  }
-
-  const specText = readFileSync(opts.spec, 'utf-8');
-  const runnerText = readFileSync(opts.runner, 'utf-8');
-
-  const anchors = parseAnchors(runnerText);
-  const status = parseStatus(specText);
-  const specIsStub = isReferenceStub(specText);
-
-  if (!opts.json) {
-    console.log(`fix-status-verify (Phase 1)`);
-    console.log(`  spec:   ${opts.spec}`);
-    console.log(`  runner: ${opts.runner}`);
-    console.log(`  ${status.size} positive status claim(s), ${anchors.size} anchor(s)`);
-    console.log(`  running: ${opts.testCommand}`);
-  }
-
-  const testRun = runTests(opts.testCommand);
-  const testResults = parseRunnerOutput(testRun.stdout + '\n' + testRun.stderr);
-
-  if (!opts.json) {
-    const passes = [...testResults.values()].filter((v) => v === 'pass').length;
-    const fails = [...testResults.values()].filter((v) => v === 'fail').length;
-    console.log(`  test run: ${passes} pass, ${fails} fail (exit ${testRun.exitCode})`);
-  }
-
-  const matrixResult = verifyMatrix({ anchors, status, testResults, specIsStub });
-  const findings = [...matrixResult.findings];
-
-  // Phase 2 (A-sot): manifest validation + ADR-line grep. validateManifest and
-  // checkAdrLines are spec-independent (manifest/code health) and run always;
-  // checkManifestCoverage keys off the spec status (a no-op under STUB_SPEC,
-  // where status is empty).
-  const needsCorpus = manifest.some((r) => r.adrKeyLine !== NO_ADR);
-  const adrSearch = needsCorpus
-    ? buildCorpusSearch({ repoRoot: REPO, includeDirs: CORPUS_DIRS, excludePaths: CORPUS_EXCLUDE })
-    : () => false;
-  const adrExists = (adrPath) => existsSync(join(opts.hypoDir, 'projects/hypomnema', adrPath));
-  findings.push(...validateManifest(manifest));
-  findings.push(...checkManifestCoverage({ manifest, anchors, status }));
-  findings.push(...checkAdrLines({ manifest, searchFn: adrSearch, adrExistsFn: adrExists }));
-
-  // CLI-level error: if the test command itself exited nonzero, the test run
-  // is not green even if the anchored tests happen to all pass in the parsed
-  // output. Surface as a synthetic error finding so `ok` flips false.
-  if (testRun.exitCode !== 0) {
-    findings.push({
-      level: 'error',
-      class: 'TEST_RUN_NONZERO_EXIT',
-      detail: `test command "${opts.testCommand}" exited ${testRun.exitCode}`,
-      exitCode: testRun.exitCode,
-    });
-  }
-  const ok = !findings.some((f) => f.level === 'error') && testRun.exitCode === 0;
-
-  const MANDATORY_NOTE =
-    'test-linkage + green + ADR-line grep (Phase 2): manifest evidence checked against production corpus';
-
-  if (opts.json) {
-    console.log(
-      JSON.stringify(
-        {
-          ok,
-          spec: opts.spec,
-          runner: opts.runner,
-          statusClaims: status.size,
-          anchorCount: anchors.size,
-          testsRan: testResults.size,
-          testExitCode: testRun.exitCode,
-          findings,
-          note: MANDATORY_NOTE,
-        },
-        null,
-        2,
-      ),
-    );
-  } else {
-    const errors = findings.filter((f) => f.level === 'error');
-    const warns = findings.filter((f) => f.level === 'warn');
-    if (errors.length === 0 && warns.length === 0) {
-      console.log(`  ✓ all ${status.size} claimed-merged fix(es) verified`);
-    } else {
-      if (errors.length) {
-        console.log(`\nerrors (${errors.length}):`);
-        for (const f of errors) console.log(formatFinding(f));
-      }
-      if (warns.length) {
-        console.log(`\nwarnings (${warns.length}):`);
-        for (const f of warns) console.log(formatFinding(f));
-      }
-    }
-    console.log(`\n(${MANDATORY_NOTE})`);
-  }
-
-  process.exit(ok ? 0 : 1);
-}
-
-main().catch((e) => {
-  console.error(e);
-  process.exit(2);
-});