oh-my-llmwikimode 1.2.0 → 1.4.0

package/bin/llmwiki.js

@@ -13,6 +13,7 @@ import {
   buildCodexPresenceStatus,
   launchCodexPresenceHudTmux,
 } from "../src/codex/presence.js";
+import { installCodexHudAutostart } from "../src/codex/hud-install.js";
 import { buildCuratorBrowserData } from "../src/curator/browser-data.js";
 import { proposeConsolidation, readCuratorQueue, suggestLessonCandidate } from "../src/curator/queue.js";
 import { generateWeeklyDigest, getDigest, listDigests } from "../src/librarian/weekly-digest.js";
@@ -37,6 +38,8 @@ import { buildIndex, ensureWikiStructure, getWikiPaths, promoteEntry, rejectEntr
 import { queryWiki } from "../src/wiki/query.js";
 import { buildWikiContext } from "../src/wiki/context.js";
 import { recommendWikiContext } from "../src/wiki/context-trigger.js";
+import { buildProjectDashboard, writeProjectDashboard } from "../src/wiki/project-dashboard.js";
+import { CANONICAL_PROJECT_SLUG } from "../src/wiki/project-identity.js";
 import { routeWikiSave } from "../src/wiki/save-routing.js";
 import {
   appendSearchFailure,
@@ -66,7 +69,6 @@ import {
   updateSemanticIndex,
 } from "../src/wiki/semantic-index.js";
 import { semanticSearch } from "../src/wiki/semantic-search.js";
-import { SearchService } from "../src/eos/search/service.js";
 import {
   applyClassification,
   getClassificationSuggestion,
@@ -79,7 +81,9 @@ import {
   importExternalWorkerReceipt,
   listExternalWorkerDispatches,
   listExternalWorkerProfiles,
-} from "../src/eos/external-workers/index.js";
+  readExternalWorkerArtifacts,
+  SearchService,
+} from "../src/eos/public/cli.js";
 import {
   listLibrarianReports,
   runLibrarianOrchestration,
@@ -102,11 +106,11 @@ const COMMANDS = {
   },
   status: {
     usage: "llmwiki status [--format hud|--json] [options]",
-    description: "Show Wiki Mode presence status for Codex-friendly local integrations.",
+    description: "Show Oh My LLM Wiki Mode presence status for Codex-friendly local integrations.",
   },
   hud: {
     usage: "llmwiki hud [--watch|--tmux] [--interval 1] [options]",
-    description: "Show a standalone Wiki Mode HUD line without modifying Codex or OMX.",
+    description: "Show a standalone Oh My LLM Wiki Mode HUD line without modifying Codex or OMX.",
   },
   query: {
     usage: "llmwiki query [options] <query>",
@@ -172,6 +176,10 @@ const COMMANDS = {
     usage: "llmwiki raw <list|status|validate> [options]",
     description: "List raw contents, show raw statistics, or validate raw directory structure.",
   },
+  dashboard: {
+    usage: "llmwiki dashboard <generate|preview> [--project oh-my-llmwikimode] [options]",
+    description: "Generate or preview a user-facing project dashboard.",
+  },
   "lesson-proposal": {
     usage: "llmwiki lesson-proposal <analyze|list|show|apply> [options]",
     description: "Analyze usage events, list proposals, show a proposal, or apply a proposal to create a lesson.",
@@ -181,11 +189,11 @@ const COMMANDS = {
     description: "Analyze drafts, list, show, apply, or reject review-required project classification suggestions.",
   },
   codex: {
-    usage: "llmwiki codex <status|skill|write-skill|should-context|context|capture|save> [options]",
-    description: "Expose a safe local Codex skill/CLI bridge without plugin, MCP, marketplace, or config mutation.",
+    usage: "llmwiki codex <status|skill|write-skill|install-hud|should-context|context|capture|save> [options]",
+    description: "Expose a safe local Codex skill/CLI bridge; passive commands are non-mutating, while install-hud is explicit repair.",
   },
   "eos-worker": {
-    usage: "llmwiki eos-worker <profiles|dispatch|receipt> [options]",
+    usage: "llmwiki eos-worker <status|profiles|dispatch|receipt> [options]",
     description: "Manage artifact-only Eos external worker dispatches and receipts.",
   },
   librarian: {
@@ -209,15 +217,18 @@ function globalOptionsHelp() {
   return [
     "Options:",
     `  --wiki-root <path>  Wiki root directory (default: ${DEFAULT_WIKI_ROOT})`,
-    "  --project <name>    Target project for ingest/store (creates projects/<name>/inbox/)",
+    "  --project <name>    Target project for ingest/store; codex save defaults to knowledge/projects/<name>/",
     "  --tags <tags>       Comma-separated tags for ingest/todo add",
     "  --output-dir <path> Explicit output directory (codex write-skill only)",
+    "  --codex-home <path> Explicit Codex home for codex install-hud",
+    "  --use-default-codex-home Allow codex install-hud to write the default CODEX_HOME/~/.codex",
+    "  --dry-run           Preview codex install-hud without writing files",
     "  --browser-data      Rebuild .system/browser-data.json (rebuild only)",
     "  --limit <n>         Number of audit entries to print (audit only)",
     "  --json              Output JSON",
     "  --format <format>   Output format for supported commands (context, hud)",
-    "  --watch             Continuously refresh the Wiki Mode HUD (hud only)",
-    "  --tmux              Open the Wiki Mode HUD in a tmux/psmux pane (hud only)",
+    "  --watch             Continuously refresh the Oh My LLM Wiki Mode HUD (hud only)",
+    "  --tmux              Open the Oh My LLM Wiki Mode HUD in a tmux/psmux pane (hud only)",
     "  --interval <sec>    HUD refresh interval in seconds (default: 1)",
     "  --related <paths>    Comma-separated related entries (curator suggest-lesson)",
     "  --entries <paths>    Comma-separated entries (curator propose-consolidation)",
@@ -422,6 +433,9 @@ function parseArgs(argv) {
     location: null,
     mode: null,
     outputDir: null,
+    codexHome: null,
+    useDefaultCodexHome: false,
+    dryRun: false,
     packId: null,
     agentProfileId: "main-opencode",
     approvedBy: null,
@@ -585,6 +599,35 @@ function parseArgs(argv) {
       continue;
     }
 
+    if (token === "--dry-run") {
+      parsed.dryRun = true;
+      continue;
+    }
+
+    if (token === "--codex-home") {
+      const codexHome = argv[index + 1];
+      if (!codexHome) {
+        return { ...parsed, error: "--codex-home requires a path" };
+      }
+      parsed.codexHome = codexHome;
+      index += 1;
+      continue;
+    }
+
+    if (token === "--use-default-codex-home") {
+      parsed.useDefaultCodexHome = true;
+      continue;
+    }
+
+    if (token.startsWith("--codex-home=")) {
+      const codexHome = token.slice("--codex-home=".length);
+      if (!codexHome) {
+        return { ...parsed, error: "--codex-home requires a path" };
+      }
+      parsed.codexHome = codexHome;
+      continue;
+    }
+
     if (token === "--limit") {
       const limit = argv[index + 1];
       if (!limit) {
@@ -749,6 +792,7 @@ function parseArgs(argv) {
       continue;
     }
 
+
     if (token === "--output-dir") {
       const outputDir = argv[index + 1];
       if (!outputDir) {
@@ -829,7 +873,7 @@ function parseArgs(argv) {
 
     if (token === "--project") {
       const project = argv[index + 1];
-      if (!project) {
+      if (!project || project.startsWith("--")) {
         return { ...parsed, error: "--project requires a name" };
       }
       parsed.project = project;
@@ -1530,6 +1574,28 @@ function runRaw(parsed) {
   return { success: false, error: `Unknown raw subcommand: ${action}` };
 }
 
+function runDashboard(parsed) {
+  const action = parsed.args[0] || "preview";
+  const options = {
+    project: parsed.project || CANONICAL_PROJECT_SLUG,
+  };
+
+  if (action === "preview") {
+    const result = buildProjectDashboard(parsed.wikiRoot, options);
+    return {
+      ...result,
+      output: result.dashboard,
+      message: `Dashboard preview generated for ${result.project}.`,
+    };
+  }
+
+  if (action === "generate") {
+    return writeProjectDashboard(parsed.wikiRoot, options);
+  }
+
+  return { success: false, error: `Unknown dashboard subcommand: ${action}` };
+}
+
 function runSearchFeedback(parsed) {
   const action = parsed.args[0] || "list";
 
@@ -1745,7 +1811,7 @@ async function runCodex(parsed) {
       bridge,
       message: [
         "Codex local bridge is available.",
-        "No plugin install, MCP registration, marketplace mutation, config mutation, or auto-push is performed.",
+        "Passive commands perform no plugin install, MCP registration, marketplace mutation, config mutation, or auto-push; codex install-hud is explicit repair only.",
       ].join(" "),
     };
   }
@@ -1764,7 +1830,22 @@ async function runCodex(parsed) {
     return writeCodexSkillBridge(parsed.wikiRoot, parsed.outputDir);
   }
 
-    if (action === "should-context") {
+  if (action === "install-hud") {
+    if (!parsed.dryRun && !parsed.codexHome && !parsed.useDefaultCodexHome) {
+      return {
+        success: false,
+        error:
+          "codex install-hud writes Codex hook/config files; pass --codex-home <path> or --use-default-codex-home for non-dry-run installs.",
+      };
+    }
+    return installCodexHudAutostart({
+      wikiRoot: parsed.wikiRoot,
+      codexHome: parsed.codexHome,
+      dryRun: parsed.dryRun,
+    });
+  }
+
+  if (action === "should-context") {
     const query = parsed.query || parsed.args.slice(1).join(" ").trim();
     if (!query) {
       return { success: false, error: "codex should-context requires --query or a positional query" };
@@ -1876,7 +1957,7 @@ async function runCodex(parsed) {
       return { success: false, error: "codex save requires --summary or a positional summary" };
     }
 
-    const location = parsed.location || "drafts";
+    const location = parsed.location || (parsed.project ? "knowledge" : "drafts");
     if (!["drafts", "knowledge", "reviewing"].includes(location)) {
       return { success: false, error: "codex save --location must be drafts, knowledge, or reviewing" };
     }
@@ -1963,6 +2044,20 @@ async function runEosWorker(parsed) {
     };
   }
 
+  if (area === "status") {
+    const artifacts = await readExternalWorkerArtifacts(parsed.wikiRoot);
+    return {
+      success: true,
+      runtime_status: "artifact_only",
+      wikiRoot: parsed.wikiRoot,
+      summary: artifacts.summary,
+      paths: artifacts.paths,
+      executed: false,
+      live_execution: false,
+      message: "External worker artifact status loaded; no worker execution performed.",
+    };
+  }
+
   if (area === "dispatch") {
     if (action === "list") {
       return {
@@ -2067,6 +2162,7 @@ const HANDLERS = {
   "semantic-search": runSemanticSearch,
   "semantic-index": runSemanticIndex,
   raw: runRaw,
+  dashboard: runDashboard,
   "lesson-proposal": runLessonProposal,
   classify: runClassify,
   codex: runCodex,

package/docs/CODEX_INTEGRATION_BRIDGE.md

@@ -13,7 +13,10 @@ path for other users.
 - Local-first only.
 - Read-only by default.
 - Review-required wiki management outputs only.
-- No Codex config mutation.
+- Passive status/context/capture commands do not mutate Codex config.
+- Only the explicit `codex install-hud` repair command may mutate Codex
+  hook/config files, and non-dry-run installs require either `--codex-home
+  <path>` or `--use-default-codex-home`.
 - No plugin installation.
 - No MCP registration.
 - No marketplace metadata mutation.
@@ -34,17 +37,18 @@ llmwiki codex capture --wiki-root "<your-wiki-root>" --type solution_candidate -
 llmwiki codex save --wiki-root "<your-wiki-root>" --location drafts --summary "<summary>" --details "<details>" --json
 llmwiki codex skill --wiki-root "<your-wiki-root>"
 llmwiki codex write-skill --wiki-root "<your-wiki-root>" --output-dir "<explicit-local-dir>"
+llmwiki codex install-hud --wiki-root "<your-wiki-root>" --codex-home "<your-codex-home>" --dry-run --json
 ```
 
-## Wiki Mode HUD presence
+## Oh My LLM Wiki Mode HUD presence
 
 The Codex bridge also exposes a standalone, non-invasive presence line:
 
 ```text
-[Wiki Mode] Connected | v1.1.0 | Review Queue 0
+[Oh My LLM Wiki Mode] Connected | v1.2.0 | Review Queue 0
 ```
 
-Use it when you want a human-readable confirmation that the local Wiki Mode
+Use it when you want a human-readable confirmation that the local Oh My LLM Wiki Mode
 bridge can see the selected wiki root:
 
 ```bash
@@ -52,7 +56,7 @@ llmwiki status --wiki-root "<your-wiki-root>" --format hud
 llmwiki hud --wiki-root "<your-wiki-root>"
 ```
 
-For an attached tmux/psmux Codex session, the Wiki Mode HUD can run in its own
+For an attached tmux/psmux Codex session, the Oh My LLM Wiki Mode HUD can run in its own
 small pane without modifying Codex, OMX, or their statusline renderers:
 
 ```bash
@@ -62,7 +66,14 @@ llmwiki hud --wiki-root "<your-wiki-root>" --tmux
 The Codex plugin scaffold includes a `SessionStart` hook that runs this HUD
 startup path automatically when the plugin is installed and the session is
 inside tmux/psmux. The hook exits silently outside tmux/psmux and skips
-duplicate startup when a `Wiki Mode HUD` pane already exists.
+duplicate startup when an `Oh My LLM Wiki Mode HUD` pane already exists.
+The scaffold follows Codex plugin hook discovery rules by declaring
+`"hooks": "./hooks.json"` in `.codex-plugin/plugin.json`; installing/enabling
+the plugin still requires the user to review and trust bundled hooks in Codex.
+The hook command resolves its script from `PLUGIN_ROOT`/`CLAUDE_PLUGIN_ROOT`/
+`CODEX_PLUGIN_ROOT`, not from the active repository working directory, and
+treats HUD import/startup failures as best-effort debug output instead of
+failing the Codex hook.
 
 `Review Queue` counts local review-required Wiki Mode artifacts, including
 Codex captures and local curator/graph review cards. This is intentionally
@@ -120,6 +131,7 @@ user explicitly asks to embed one machine's resolved absolute path.
 
    - `.codex-plugin/plugin.json`
    - `skills/llmwiki-local-bridge/SKILL.md`
+   - `hooks.json`
    - `scripts/llmwiki-codex.ps1`
    - `README.md`
 
@@ -132,3 +144,13 @@ Plugin or MCP integration can be considered later only as a separate, explicit
 scope with fresh safety tests. This bridge is the safe starting point and must
 not be expanded into marketplace, account, hosted sync, or hidden execution
 work without a new plan.
+
+### Explicit HUD repair command
+
+The Codex plugin normally owns HUD autostart through its bundled `SessionStart` hook. If a local Codex hook installation needs repair, use the explicit command below. `--dry-run` previews the files and trust state without writing anything:
+
+```bash
+llmwiki codex install-hud --wiki-root "<your-wiki-root>" --codex-home "<your-codex-home>" --dry-run --json
+```
+
+Without `--dry-run`, the command may write a local Codex hook script, merge `hooks.json`, and add matching trust metadata to `config.toml`. Non-dry-run installs require an explicit target with `--codex-home <path>` or an explicit default-home acknowledgement with `--use-default-codex-home`. It reports `mutates_codex_config: true` so callers never confuse it with passive status/context commands.

package/docs/KNOWLEDGE_FOLDER_TAXONOMY.md

@@ -0,0 +1,106 @@
+# LLM Wiki Project Folder Taxonomy
+
+Status: draft migration contract for the Knowledge UX Hygiene + Dashboard
+Ultragoal.
+
+## Goal
+
+Make project knowledge folders readable for a Korean user while keeping enough
+English signal for automation and cross-tool integrations.
+
+Canonical folder labels use this pattern:
+
+```text
+<Korean label>_<English machine hint>
+```
+
+Example:
+
+```text
+개발-진행-기록_dev-history/
+```
+
+## Canonical labels
+
+| Current folder | Canonical label | Purpose |
+| --- | --- | --- |
+| `!대시보드` | `!대시보드_dashboard` | User-facing entry point and daily summary |
+| `0_omx 핸드오프` | `0_omx-핸드오프_omx-handoff` | OMX / Codex handoff plans and run instructions |
+| `개발-진행-기록` | `개발-진행-기록_dev-history` | Work logs, roadmap updates, implementation and release history |
+| `개발-진행-기록/로드맵` | `개발-진행-기록_dev-history/로드맵_roadmap` | Roadmaps and planning timeline |
+| `개발-진행-기록/구현-보고` | `개발-진행-기록_dev-history/구현-보고_implementation-reports` | Implementation reports |
+| `개발-진행-기록/검증-로그` | `개발-진행-기록_dev-history/검증-로그_verification-logs` | Verification logs and QA evidence |
+| `개발-진행-기록/릴리즈-로그` | `개발-진행-기록_dev-history/릴리즈-로그_release-logs` | Release logs and publishing notes |
+| `이슈-및-문제` | `이슈-및-문제_issues` | Issues, bugs, active tasks, and improvement proposals |
+| `이슈-및-문제/활성-과제` | `이슈-및-문제_issues/활성-과제_active` | Active work items |
+| `이슈-및-문제/issues` | `이슈-및-문제_issues/버그-이슈_bugs` | Bug reports and defect investigations |
+| `이슈-및-문제/improvements` | `이슈-및-문제_issues/개선-제안_improvements` | Improvement proposals |
+| `아키텍처-및-설계` | `아키텍처-및-설계_architecture-design` | Architecture, design, and decisions |
+| `가이드-및-정책` | `가이드-및-정책_guides-policies` | User guides, policies, and operating models |
+| `완료-보고` | `완료-보고_completion-reports` | Completion reports and milestone summaries |
+| `테스트-및-QA` | `테스트-및-QA_testing-qa` | Test plans and QA checklists |
+| `아카이브` | `아카이브_archive` | Superseded or historical entries |
+| `워크데스크-기능` | `워크데스크-기능_workdesk-features` | Existing Workdesk / Work Harbor feature notes |
+
+## Non-destructive migration plan
+
+Do not mass-rename folders in the first implementation pass. Renaming first can
+break:
+
+- existing markdown links,
+- current `.system/index.json` and `.system/graph.json` references,
+- OpenCode plugin assumptions,
+- Codex bridge search results,
+- user muscle memory.
+
+Instead:
+
+1. Add a canonical mapping table in code or configuration.
+2. Teach save routing to accept both current and canonical labels.
+3. Generate review-required migration proposals for existing folders.
+4. Provide a safe move command or script that:
+   - resolves old and new paths,
+   - updates markdown links when possible,
+   - records an audit event,
+   - runs `llmwiki rebuild --browser-data`,
+   - reports changed paths.
+5. Only then allow explicit migration.
+
+## Compatibility rules
+
+- Current folders remain valid input paths.
+- Canonical labels are preferred for new output once the router is ready.
+- Search should find entries regardless of old or canonical folder names.
+- Curator proposals may suggest moves, but must not move or delete files without
+  explicit review.
+- Dashboard links should tolerate both old and canonical paths during transition.
+
+## Filename policy preview
+
+This taxonomy pairs with a later save-routing story:
+
+```text
+YYYY-MM-DD-short-readable-topic.md
+```
+
+Examples:
+
+- `2026-05-27-codex-eos-npm-v1.1.0-release.md`
+- `2026-05-27-knowledge-dashboard-contract.md`
+- `save-routing-devlog-classification-improvement.md`
+
+Avoid:
+
+- timestamp-only titles,
+- whole conversation titles,
+- random root-level files,
+- mojibake filenames.
+
+## Acceptance criteria
+
+This taxonomy story is complete when:
+
+- The current-to-canonical mapping is documented.
+- The migration path is explicitly non-destructive.
+- Existing OpenCode and Codex usage are named as compatibility constraints.
+- Later stories can implement routing and dashboard generation from this table.

package/docs/KNOWLEDGE_UX_DASHBOARD_CONTRACT.md

@@ -0,0 +1,111 @@
+# LLM Wiki Knowledge UX Dashboard Contract
+
+Status: draft contract for the Knowledge UX Hygiene + Dashboard Ultragoal.
+
+## Purpose
+
+This contract defines the first user-facing dashboard slice for the
+`oh-my-llmwikimode` project knowledge area. `llm-wiki-mode` and
+`llmwikimode` remain legacy aliases for runtime inputs. It is intentionally a
+contract first:
+implementation may follow in later Ultragoal stories, but the daily view should
+stay stable enough that a user can check the project without reading the whole
+wiki.
+
+## Baseline inventory
+
+Snapshot source: local wiki root `C:\Users\USER\Documents\llm-wiki`.
+
+- Canonical project area: `knowledge/projects/oh-my-llmwikimode`
+- Legacy project area: `knowledge/projects/llm-wiki-mode` remains readable and
+  must not be bulk moved without a review-required migration plan.
+- Markdown entries under the project area: about 177
+- Current top-level project folders:
+  - `!대시보드`
+  - `0_omx 핸드오프`
+  - `가이드-및-정책`
+  - `개발-진행-기록`
+  - `아카이브`
+  - `아키텍처-및-설계`
+  - `완료-보고`
+  - `워크데스크-기능`
+  - `이슈-및-문제`
+  - `테스트-및-QA`
+- Current dashboard files:
+  - `!대시보드/00-시작-여기.md`
+  - `!대시보드/오늘의-작업.md`
+  - `!대시보드/로드맵-및-개발-방향.md`
+  - `!대시보드/시행착오-및-해결-기록.md`
+  - `!대시보드/템플릿/*.md`
+- Current CLI presence: `Wiki Mode Connected | v1.1.0 | Review Queue 128`
+- Current lint baseline: 245 errors and 79 warnings across the broader wiki
+  snapshot, mainly missing `title` / `source` / `status` and invalid status enum
+  values.
+
+## Daily user dashboard fields
+
+The dashboard should answer five questions in under one minute:
+
+1. What needs attention now?
+2. What changed recently?
+3. What is waiting for review?
+4. Is the wiki healthy enough to trust?
+5. What should I do next?
+
+Recommended sections:
+
+| Section | User value | Source |
+| --- | --- | --- |
+| Today focus | Shows the top 1-3 current actions | Active issues, latest triage, recent completion logs |
+| Recent project changes | Shows latest releases, devlogs, and verification logs | `개발-진행-기록*`, `완료-보고*` |
+| Review queue | Shows review-required candidates and curator proposals | `llmwiki status`, `llmwiki curator list` |
+| Hygiene warnings | Shows lint/encoding/routing risk summary | `llmwiki lint`, hygiene proposal artifacts |
+| Next actions | Shows recommended safe next steps | Current triage + dashboard policy |
+
+## Display principles
+
+- Korean first, English suffix when it improves machine routing.
+- The user dashboard should hide raw draft noise by default.
+- Dashboard entries should link to deeper documents instead of copying long
+  reports.
+- The dashboard should state when a section is generated from stale data.
+- Review-required items must stay visibly review-required.
+
+## Non-goals for this dashboard slice
+
+- No hosted sync.
+- No account, marketplace, or payment flows.
+- No hidden execution.
+- No automatic deletion, automatic promotion, or automatic merge.
+- No Eos personal assistant or Discord bridge implementation.
+
+## Compatibility expectations
+
+- Existing OpenCode plugin usage must continue to work.
+- Existing Codex bridge / CLI usage must continue to work.
+- Existing folder names must not be destructively mass-renamed in this first
+  slice.
+- Migration to Korean-first English-suffix folder labels should happen through a
+  compatibility and proposal layer first.
+
+## Completion evidence for this contract
+
+The first Ultragoal story is complete when:
+
+- The baseline inventory is recorded.
+- The daily dashboard fields are explicitly defined.
+- The current risks are named without mutating existing user documents.
+- The contract is searchable from the project wiki or repo docs.
+
+## Regeneration command
+
+Later implementation stories can refresh the user dashboard with:
+
+```sh
+llmwiki dashboard generate --project oh-my-llmwikimode
+```
+
+The command writes a review-required dashboard entry under the project dashboard
+folder and does not delete, promote, merge, or auto-approve source entries.
+Legacy aliases `llm-wiki-mode` and `llmwikimode` are accepted by the CLI and
+route to the canonical project slug.

package/docs/KNOWLEDGE_UX_MIGRATION_NOTES.md

@@ -0,0 +1,43 @@
+# Knowledge UX Migration Notes
+
+These notes explain how to adopt the Korean-first project knowledge UX without
+breaking current OpenCode or Codex bridge usage.
+
+## Migration posture
+
+- Do not bulk-rename existing project folders first.
+- Keep old paths readable while new writes prefer the bilingual taxonomy from
+  `docs/KNOWLEDGE_FOLDER_TAXONOMY.md`.
+- Use `oh-my-llmwikimode` as the canonical project slug for new runtime writes.
+  `llm-wiki-mode` and `llmwikimode` are accepted legacy aliases and should be
+  routed to the canonical slug instead of creating split project folders.
+- Use router-generated placements for new project knowledge, then let curator
+  proposal cards identify old entries that may be moved later.
+- Use dashboard generation as the user's daily entry point instead of asking the
+  user to inspect every raw draft.
+
+## Safe command sequence
+
+```powershell
+node bin/llmwiki.js doctor --wiki-root "C:\Users\USER\Documents\llm-wiki" --json
+node bin/llmwiki.js rebuild --wiki-root "C:\Users\USER\Documents\llm-wiki" --browser-data
+node bin/llmwiki.js dashboard preview --wiki-root "C:\Users\USER\Documents\llm-wiki" --project oh-my-llmwikimode --json
+node bin/llmwiki.js dashboard generate --wiki-root "C:\Users\USER\Documents\llm-wiki" --project oh-my-llmwikimode
+```
+
+Compatibility smoke may also run the same dashboard preview with
+`--project llm-wiki-mode` and `--project llmwikimode`; both aliases must resolve
+to the canonical project dashboard.
+
+## Compatibility checks
+
+OpenCode remains compatible because the plugin server entry point and wiki root
+contracts are unchanged. Codex remains compatible because the CLI bridge and HUD
+are non-invasive: they report status, context, and review-required write paths
+without mutating Codex config or the OMX status line.
+
+## Current verification evidence
+
+- Targeted tests: `node --test test/project-dashboard.test.js test/cli.test.js test/wiki-save-routing.test.js test/lint.test.js test/doctor.test.js test/curator-proposals.test.js`
+- Documentation consistency: `npm run verify:docs`
+- Real wiki checks: `llmwiki rebuild`, `llmwiki query`, `llmwiki doctor`, `llmwiki status`