Rename recall export to import, add CLI command groups

Rename `ctx recall export` to `ctx recall import` across the entire
codebase. From ctx's perspective, pulling Claude Code sessions into the
journal is an import, not an export. Rename touches source code, entity
types, config constants, YAML text, hook templates, tests, docs, recipes,
skills, specs, and context files.

Add Cobra command groups to organize `ctx --help` into labeled sections:
Getting Started, Context, Artifacts, Sessions, Runtime, Integration,
Diagnostics, and Utilities. Presentation-only change using Cobra's
AddGroup API -- zero command path or routing changes.

Add preamble box to root help output with ceremony instructions and
maintenance cadence. Hide site, serve, and system commands from help.

Update zero-silent-error-discard convention and add rename/refactor
documentation checklist to CONVENTIONS.md.

Signed-off-by: Jose Alekhinne <jose@ctx.ist>

Author: josealekhine

.context/ARCHITECTURE.md

@@ -114,7 +114,7 @@ upward from them. The `rc` package mediates config resolution;
 | `notify`      | Send fire-and-forget webhook notifications                                      |
 | `pad`         | Encrypted scratchpad CRUD with blob support and merge                           |
 | `permissions` | Permission snapshot/restore (golden images) for Claude Code                     |
-| `recall`      | Browse, export, lock/unlock AI session history                                  |
+| `recall`      | Browse, import, lock/unlock AI session history                                  |
 | `reindex`     | Regenerate indices for DECISIONS.md and LEARNINGS.md                            |
 | `remind`      | Session-scoped reminders surfaced at start                                      |
 | `serve`       | Serve static journal site locally via zensical                                  |
@@ -145,11 +145,11 @@ Five core flows define how data moves through the system:
    constitution compliance, required files, file age, entry count,
    missing packages) → returns report with warnings and violations.
 
-4. **`ctx recall export`**: User invokes with `--all` → `cli/recall`
+4. **`ctx recall import`**: User invokes with `--all` → `cli/recall`
    calls `parser.FindSessionsForCWD()` which scans
    `~/.claude/projects/` → parses JSONL transcripts → loads journal
    state → plans each session (new/regen/skip/locked) → formats as
-   Markdown → writes to `.context/journal/` → marks exported in state.
+   Markdown → writes to `.context/journal/` → marks imported in state.
 
 <!-- drift-check: grep -c 'ctx system check-' internal/assets/claude/hooks/hooks.json -->
 5. **Hook lifecycle**: Claude Code plugin fires hooks at 3 lifecycle
@@ -178,7 +178,7 @@ Five state machines govern lifecycle transitions:
    pending children remain) → Archived (via `ctx task archive` to
    `.context/archive/`).
 
-3. **Journal pipeline**: Exported (JSONL→MD via `recall export`) →
+3. **Journal pipeline**: Imported (JSONL→MD via `recall import`) →
    Enriched (YAML frontmatter, tags) → Normalized (soft-wrap, clean
    JSON) → Fences Verified (fence balance check) → Locked (prevent
    overwrite). Each stage tracked in `.context/journal/.state.json`;

.context/CONVENTIONS.md

@@ -163,9 +163,11 @@ DO NOT UPDATE FOR:
 
 - New CLI subcommand documentation checklist: When adding a new CLI subcommand, update docs in at least three places: (1) Feature page (e.g., docs/scratchpad.md) — commands table, usage section, skill/NL table. (2) CLI reference (docs/cli-reference.md) — full reference entry with args, flags, examples. (3) Relevant recipes — any recipe that covers the feature area. (4) zensical.toml — only if adding a new page.
 
+- Rename/refactor documentation checklist: When renaming a command, flag, function, or concept, scope ALL documentation impact before implementation. The project has three documentation anchors plus one tangential: (1) Docstrings in source code. (2) User-facing docs (`docs/`). (3) Recipes (`docs/recipes/`). (4) Blog posts and release notes — update command names but preserve historical prose. Also check: skills (`internal/assets/claude/skills/`), hook messages (`internal/assets/hooks/messages/`), YAML text files (`internal/assets/`), `.context/` files, and specs (`specs/`).
+
 - Always stage site/ when committing docs/ changes — the generated HTML is tracked in git with no CI build step.
 
-- Zero //nolint:errcheck policy — handle errors, don't suppress them. In test code: use t.Fatal(err) for setup errors, _ = os.Chdir(orig) for cleanup. In production code: use defer func() { _ = f.Close() }() for best-effort close. For gosec false positives: prefer config-level exclusions in .golangci.yml.
+- Zero silent error discard policy — handle every error, never suppress with `_ =` or `//nolint:errcheck`. In test code: use `t.Fatal(err)` for setup errors, use `t.Log(err)` for cleanup errors (not `_ =`). In production code: defer-close must log failures to stderr (`if err := f.Close(); err != nil { fmt.Fprintf(os.Stderr, "ctx: close %s: %v\n", path, err) }`), never `_ = f.Close()`. For write/read errors: return the error or log to stderr. For os.Remove/Rename: log to stderr at minimum. For gosec false positives: fix the code to satisfy the linter rather than adding nolint markers or config-level exclusions — the goal is zero golangci-lint suppressions. See TASKS.md EH.0–EH.5 for the full error handling cleanup plan.
 
 - Error constructors belong in internal/err, never in per-package err.go files — eliminates the broken-window pattern where agents add local errors when they see a local err.go exists.
 

.context/DECISIONS.md

@@ -971,7 +971,7 @@ See: `specs/injection-oversize-nudge.md`.
 
 **Status**: Accepted
 
-**Context**: The session/recall/journal system had three overlapping storage layers: `~/.claude/projects/` (raw JSONL transcripts, owned by Claude Code), `.context/sessions/` (JSONL copies + context snapshots), and `.context/journal/` (enriched markdown from `ctx recall export`). The recall pipeline reads directly from `~/.claude/projects/`, making `.context/sessions/` a dead-end write sink that nothing reads from. The auto-save hook copied transcripts to a directory nobody consumed. The `ctx session save` command created context snapshots that git already provides through version history. This was ~15 Go source files, a shell hook, ~20 config constants, and 30+ doc references supporting infrastructure with no consumers.
+**Context**: The session/recall/journal system had three overlapping storage layers: `~/.claude/projects/` (raw JSONL transcripts, owned by Claude Code), `.context/sessions/` (JSONL copies + context snapshots), and `.context/journal/` (enriched markdown from `ctx recall import`). The recall pipeline reads directly from `~/.claude/projects/`, making `.context/sessions/` a dead-end write sink that nothing reads from. The auto-save hook copied transcripts to a directory nobody consumed. The `ctx session save` command created context snapshots that git already provides through version history. This was ~15 Go source files, a shell hook, ~20 config constants, and 30+ doc references supporting infrastructure with no consumers.
 
 **Decision**: Remove `.context/sessions/` entirely. Two stores remain: raw transcripts (global, tool-owned in `~/.claude/projects/`) and enriched journal (project-local in `.context/journal/`).
 

.context/DETAILED_DESIGN.md

@@ -534,7 +534,7 @@ Consult specific sections when working on a module.
 
 ## internal/cli/journal
 
-**Purpose**: Analyze and publish exported AI session files to static sites or Obsidian vaults. Largest package in the codebase (24 source files).
+**Purpose**: Analyze and publish imported AI session files to static sites or Obsidian vaults. Largest package in the codebase (24 source files).
 
 **Key types**: `journalFrontmatter` (YAML: title, date, time, project, session_id, model, tokens, type, outcome, topics, key_files, summary), `journalEntry` (parsed file metadata), `groupedIndex` (aggregated entries by key with popularity flag), `topicData`, `keyFileData`, `typeData` (index structures)
 
@@ -851,14 +851,14 @@ Consult specific sections when working on a module.
 | `check-context-size` | UserPromptSubmit | (all) | Adaptive counter: silent 1–15, every 5th 16–30, every 3rd 30+. Per-session counter in temp file | Per-session |
 | `check-persistence` | UserPromptSubmit | (all) | Track .context/ mtime; silent 1–10, nudge at #20 if no modifications, then every 15 prompts since last mod | Per-session |
 | `check-ceremonies` | UserPromptSubmit | (all) | Scan last 3 journal entries for "ctx-remember" and "ctx-wrap-up" strings; nudge missing ceremonies | Daily |
-| `check-journal` | UserPromptSubmit | (all) | Stage 1: count .jsonl files newer than latest journal export. Stage 2: count unenriched entries via journal/state. Suggest `ctx recall export --all` and `/ctx-journal-enrich-all` | Daily |
+| `check-journal` | UserPromptSubmit | (all) | Stage 1: count .jsonl files newer than latest journal export. Stage 2: count unenriched entries via journal/state. Suggest `ctx recall import --all` and `/ctx-journal-enrich-all` | Daily |
 | `check-reminders` | UserPromptSubmit | (all) | Surface due reminders (After ≤ today) from reminders.json with dismiss commands | None (until dismissed) |
 | `check-version` | UserPromptSubmit | (all) | Compare binary version (ldflags) vs plugin.json major.minor; skip "dev" builds. Piggyback: check encryption key age vs `rc.KeyRotationDays()` | Daily |
 | `check-resources` | UserPromptSubmit | (all) | `sysinfo.Collect()` + `Evaluate()`; output ONLY at DANGER severity (mem≥90%, swap≥75%, disk≥95%, load≥1.5x CPUs) | None |
 | `check-knowledge` | UserPromptSubmit | (all) | DECISIONS entry count vs `rc.EntryCountDecisions()` (default 20), LEARNINGS vs `rc.EntryCountLearnings()` (default 30), CONVENTIONS lines vs `rc.ConventionLineCount()` (default 200). Suggest /ctx-consolidate | Daily |
 | `check-map-staleness` | UserPromptSubmit | (all) | Two conditions (both required): map-tracking.json `last_run` >30 days AND `git log --since=<last_run> -- internal/` has commits. Suggest /ctx-architecture | Daily |
 | `check-backup-age` | UserPromptSubmit | (all) | Check SMB mount (via GVFS path from `CTX_BACKUP_SMB_URL` env) + backup marker mtime (>2 days). Suggest `ctx system backup` | Daily |
-| `mark-journal` | (plumbing) | — | `ctx system mark-journal <file> <stage> [--check]`. Valid stages: exported, enriched, normalized, fences_verified, locked | N/A |
+| `mark-journal` | (plumbing) | — | `ctx system mark-journal <file> <stage> [--check]`. Valid stages: imported, enriched, normalized, fences_verified, locked | N/A |
 | `cleanup-tmp` | SessionEnd | (all) | Remove files >15 days old from `secureTempDir()`. Silent side-effect, no output | N/A |
 
 **Hook output protocol**:

.context/GLOSSARY.md

@@ -28,7 +28,7 @@ DO NOT UPDATE FOR:
 | Read order             | The priority sequence in which context files are loaded and presented to agents. Defined by `config.FileReadOrder`. Higher priority files are loaded first and survive token budget cuts.                   |
 | Token budget           | Maximum estimated token count for assembled context. Default 8000. Configurable via `CTX_TOKEN_BUDGET`, `.ctxrc`, or `--budget` flag. Uses 4-chars-per-token heuristic.                                 |
 | Curated tier           | The `.context/*.md` files: manually maintained, token-budgeted, loaded by `ctx agent`. Contrast with full-dump tier.                                                                                        |
-| Full-dump tier         | The `.context/journal/` directory: exported session transcripts. Not auto-loaded; used for archaeology when curated context is insufficient. Browse with `ctx recall`.                                       |
+| Full-dump tier         | The `.context/journal/` directory: imported session transcripts. Not auto-loaded; used for archaeology when curated context is insufficient. Browse with `ctx recall`.                                       |
 | Compaction             | The process of archiving completed tasks and cleaning up context files. Run via `ctx compact`. Moves completed tasks to archive; preserves phase structure.                                                 |
 | Entry header           | The timestamped heading format used in DECISIONS.md and LEARNINGS.md: `## [YYYY-MM-DD-HHMMSS] Title`. Parsed by `config.RegExEntryHeader`.                                                                  |
 | Index table            | The auto-generated markdown table at the top of DECISIONS.md and LEARNINGS.md (between `<!-- INDEX:START -->` and `<!-- INDEX:END -->` markers). Updated by `ctx add` and `ctx decision/learnings reindex`. |

.context/architecture-dia-data-flows.md

@@ -91,13 +91,13 @@ User              cli/drift            context           drift.Detect
   │  Formatted report│                    │                    │                  │
 ```
 
-## 4. `ctx recall export` — Session Export Pipeline
+## 4. `ctx recall import` — Session Import Pipeline
 
 ```
 User           cli/recall        recall/parser        journal/state          FS
   │                │                    │                    │                 │
   │  ctx recall    │                    │                    │                 │
-  │  export --all  │                    │                    │                 │
+  │  import --all  │                    │                    │                 │
   │ ─────────────► │                    │                    │                 │
   │                │  FindSessionsFor   │                    │                 │
   │                │  CWD(cwd)          │                    │                 │
@@ -120,10 +120,10 @@ User           cli/recall        recall/parser        journal/state          FS
   │                │  Format as Markdown                      │                 │
   │                │  Write to .context/journal/              │                 │
   │                │ ──────────────────────────────────────────────────────────►│
-  │                │  MarkExported()                          │                 │
+  │                │  MarkImported()                          │                 │
   │                │ ──────────────────────────────────────► │                 │
   │  ◄────────────                                           │                 │
-  │  "Exported N"  │                    │                    │                 │
+  │  "Imported N"  │                    │                    │                 │
 ```
 
 ## 5. Hook Lifecycle (Claude Code Plugin)

.context/archive/decisions-consolidated-2026-02-22.md

@@ -63,7 +63,7 @@ lost if not captured.
 
 ## [2026-01-20-140000] Session Filename Format: YYYY-MM-DD-HHMMSS-topic.md
 
-**Status**: Superseded (removed in v0.4.0 — `.context/sessions/` eliminated; journal entries use `ctx recall export` naming)
+**Status**: Superseded (removed in v0.4.0 — `.context/sessions/` eliminated; journal entries use `ctx recall import` naming)
 
 **Context**: Multiple sessions per day would overwrite each other.
 Also, multiple compacts in the same minute could collide.
@@ -302,7 +302,7 @@ what can be loaded. But nothing should be truly lost.
 
 **Status**: Accepted
 
-**Context**: T2.1 requested ctx recall export --update to preserve enrichments during re-export
+**Context**: T2.1 requested ctx recall import --update to preserve enrichments during re-import
 
 **Decision**: No --update flag needed for export — default is the update mode
 

.context/archive/learnings-consolidated-2026-02-22.md

@@ -381,7 +381,7 @@ and an agentId field.
 
 ## [2026-02-03-063337] Claude Code JSONL format changed: slug field removed in v2.1.29+
 
-**Context**: ctx recall export --all --force was skipping February 2026 sessions. 
+**Context**: ctx recall import --all --force was skipping February 2026 sessions. 
 Investigation revealed sessions like c9f12373 had 0 slug fields but 19 
 sessionId fields.
 
@@ -502,13 +502,13 @@ passes command args.
 
 **Lesson**: Use `YYYY-MM-DD-HHMM-<topic>.md` format to prevent overwrites.
 
-**Application**: Historical reference only. Journal entries now use `ctx recall export` naming.
+**Application**: Historical reference only. Journal entries now use `ctx recall import` naming.
 
 ---
 
 ## [2026-01-20-120000] Two Tiers of Persistence
 
-> **Note**: `.context/sessions/` removed in v0.4.0. Two tiers remain but the full-dump tier is now `~/.claude/projects/` (raw JSONL) + `.context/journal/` (enriched markdown via `ctx recall export`).
+> **Note**: `.context/sessions/` removed in v0.4.0. Two tiers remain but the full-dump tier is now `~/.claude/projects/` (raw JSONL) + `.context/journal/` (enriched markdown via `ctx recall import`).
 
 **Context**: User wanted to ensure nothing is lost when session ends.
 
@@ -533,7 +533,7 @@ passes command args.
 - **Auto-load**: Works via `PreToolUse` hook running `ctx agent`
 - **Auto-save**: Did NOT exist
 
-**Original solution**: `SessionEnd` hook that copies transcript to `.context/sessions/`. Removed in v0.4.0 because Claude Code already retains transcripts and `ctx recall export` reads them directly.
+**Original solution**: `SessionEnd` hook that copies transcript to `.context/sessions/`. Removed in v0.4.0 because Claude Code already retains transcripts and `ctx recall import` reads them directly.
 
 ---
 

.context/archive/tasks-2026-02-03.md

@@ -15,9 +15,9 @@ Archived from TASKS.md
   #priority:low #added:2026-01-28
 - [x] Write AST-based test that warns if CLI functions use fmt.Print* instead of
   cmd.Print* #added:2026-01-29-171351 #done:2026-01-31
-- [x] feat: `ctx recall export` - export sessions to editable journal files
-  - `ctx recall export <session-id>` - export one session
-  - `ctx recall export --all` - export all sessions
+- [x] feat: `ctx recall import` - import sessions to editable journal files
+  - `ctx recall import <session-id>` - import one session
+  - `ctx recall import --all` - import all sessions
   - Skip existing files (user may have edited), `--force` to overwrite
   - Output to `.context/journal/YYYY-MM-DD-slug-shortid.md`
     #added:2026-01-28 #done:2026-01-31

.context/archive/tasks-2026-02-21.md

@@ -54,13 +54,13 @@
       `--keep-frontmatter=false` implies `--regenerate`.
       Files: `internal/cli/recall/cmd.go`, `run.go`
       #priority:medium #added:2026-02-20 #done:2026-02-21
-- [x] T2.8: Ergonomics — bare `ctx recall export` prints help (not error).
+- [x] T2.8: Ergonomics — bare `ctx recall import` prints help (not error).
       Files: `internal/cli/recall/cmd.go`, `run.go`
       #priority:medium #added:2026-02-20 #done:2026-02-21
 - [x] T2.9: Tests — safe-default, --regenerate, confirmation, --yes,
-      --dry-run, lock/export integration (locked skipped by default, by
+      --dry-run, lock/import integration (locked skipped by default, by
       --force, dry-run shows locked), --keep-frontmatter=false, default
-      preservation. 16 lock tests in `lock_test.go`, 7 new export tests
+      preservation. 16 lock tests in `lock_test.go`, 7 new import tests
       in `run_test.go`, 4 `discardFrontmatter()` unit tests.
       Files: `internal/cli/recall/run_test.go`, `lock_test.go`, `recall_test.go`
       #priority:medium #added:2026-02-21 #done:2026-02-21