journal

Manage the project journal. The journal is the primary knowledge trail — it captures decisions, discoveries, trade-offs, risks, connections, and gaps across sessions.

Parse $ARGUMENTS:

• Empty or "status": Show journal status
• "new TYPE topic": Create a new journal entry (e.g., new DECISION chose-event-driven)
• "search QUERY": Search existing entries by topic or tag

Action: Status (default)

1. Determine the active workspace:

   • If working in a workspace, use it
   • Otherwise, use the most recently modified directory under workspaces/ (excluding instructions/)

2. In the workspace's journal/ directory:

   • Count total entries
   • Count entries by type (DECISION, DISCOVERY, TRADE-OFF, RISK, CONNECTION, GAP, AMENDMENT)
   • List the 5 most recent entries with their date, type, and topic (from frontmatter)
   • Show the highest entry number (for next entry reference)

3. Present as a compact summary.

Action: New Entry

1. Parse the TYPE and topic from arguments. Valid types: DECISION, DISCOVERY, TRADE-OFF, RISK, CONNECTION, GAP, AMENDMENT.

2. Reserve the next slot via .claude/hooks/lib/journal-reserve.js::reserveJournalSlotSigned(repoDir, {dir, identity, type, topic}) — dir is the REPO-RELATIVE journal directory (journal, or workspaces/<name>/journal); identity is optional (defaults via operator-id.js::resolveIdentity). This computes the slot from max(disk high-water, fold-accepted reservation high-water) AND emits the signed journal-slot-reservation coordination-log record that journal-write-guard.js folds — without the record, the Write halt-and-reports "slot unreserved" even after a manual reservation. On {ok: true} it returns {reservation: {slot, filename, verified_id, person_id, display_id, type, topic, slug}, record}; the filename carries <display_id> to keep concurrent reservations on the same seq distinguishable, and frontmatter verified_id is authoritative for attribution scans. On {ok: false} surface error + reason verbatim and STOP — do not write the entry unreserved (the pure reserveJournalSlot(dir, opts) computation remains available for dry runs only).