@codyswann/lisa 2.101.1 → 2.103.0

package/README.md

@@ -164,3 +164,7 @@ Useful ingestion requests:
 - Ingest this design plan into the Lisa wiki.
 - Ingest these meeting notes.
 - Update the architecture overview from recent source changes.
+
+### Adding a wiki to a downstream project
+
+The wiki kernel ships as a separate plugin (`lisa-wiki`) that is `AVAILABLE` but not enabled by default. To bootstrap it in a project that already has Lisa installed, run `/lisa:wiki:install` (Claude) or `$lisa-wiki-install` (Codex). This shipped-with-base command flips `lisa-wiki@lisa` to enabled in `.claude/settings.json` and verifies the Codex skill overlay is current — but does not scaffold the wiki itself. After reload, follow up with `/setup:wiki` (Claude) or `$lisa-wiki-setup` (Codex) to create `wiki/` from `wiki/lisa-wiki.config.json`.

package/dist/utils/postinstall-trampoline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postinstall-trampoline.d.ts","sourceRoot":"","sources":["../../src/utils/postinstall-trampoline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAmC3C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AA6DD;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,OAAO,CASvC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,OAAO,GACd,OAAO,CAIT;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,SAAS,cAAc,EAAE,CAI3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAMjB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgCf"}
+{"version":3,"file":"postinstall-trampoline.d.ts","sourceRoot":"","sources":["../../src/utils/postinstall-trampoline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAmC3C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AA6DD;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,OAAO,CASvC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,OAAO,GACd,OAAO,CAYT;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,SAAS,cAAc,EAAE,CAI3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAMjB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/utils/postinstall-trampoline.js

@@ -143,6 +143,16 @@ export function shouldSchedulePostinstallReconciliation(dryRun) {
         return false;
     if (isRunningAsTrampoline())
         return false;
+    // Test runners (vitest, jest) frequently invoke `bun run` / `npm test` which
+    // sets `npm_package_json`, making `isRunningAsLifecycleScript()` true. The
+    // detached trampoline child then races against the test's temp-dir cleanup
+    // and dies with ENOENT when its cwd vanishes. Same principle as
+    // isRunningInCI's vitest/jest opt-out above — test runners are not real
+    // package-manager processes and the trampoline must not spawn from them.
+    if (readEnv("VITEST") !== undefined)
+        return false;
+    if (readEnv("JEST_WORKER_ID") !== undefined)
+        return false;
     return isRunningAsLifecycleScript();
 }
 /**

package/dist/utils/postinstall-trampoline.js.map

@@ -1 +1 @@
-{"version":3,"file":"postinstall-trampoline.js","sourceRoot":"","sources":["../../src/utils/postinstall-trampoline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"postinstall-trampoline.js","sourceRoot":"","sources":["../../src/utils/postinstall-trampoline.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -82,7 +82,7 @@
     "lodash": ">=4.18.1"
   },
   "name": "@codyswann/lisa",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
   "main": "dist/index.js",
   "exports": {

package/plugins/lisa/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Universal governance: agents, skills, commands, hooks, and rules for all projects.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa/commands/wiki/install.md

@@ -0,0 +1,7 @@
+---
+description: "Enable the LLM Wiki kernel (lisa-wiki plugin) in this project so its setup skill becomes discoverable. Edits .claude/settings.json to enable lisa-wiki@lisa and confirm the CodySwannGT/lisa marketplace, then verifies the Codex overlay (.codex/skills/lisa) already carries the wiki kernel. Does NOT scaffold the wiki itself — after install, reload the runtime and run /setup:wiki (Claude) or $lisa-wiki-setup (Codex)."
+allowed-tools: ["Skill"]
+argument-hint: ""
+---
+
+Use the /lisa:wiki-install skill to enable the lisa-wiki plugin in this project. $ARGUMENTS

package/plugins/lisa/rules/config-resolution.md

@@ -164,6 +164,7 @@ fi
 |-------|----------|---------|-------|
 | `tracker` | **yes** | — | Destination for ticket writes. One of `"jira"`, `"github"`, `"linear"`. Missing → fail with instruction to run the matching `/lisa:setup:*` skill. |
 | `source` | no | — | Default PRD source for batch skills (`/lisa:intake`) and arg-less single-PRD skills. One of `"notion"`, `"confluence"`, `"linear"`, `"github"`, `"jira"`. Explicit URLs/keys passed to a skill always win over `source`; this is a default, not a lock. |
+| `usage` | no | — | Optional token/cost pricing metadata consumed by the `usage-accounting` rule. Missing pricing never blocks a lifecycle flow; Lisa records token counts with `estimated_cost: null` when no trustworthy price source is configured. |
 
 ### Vendor sections
 

package/plugins/lisa/skills/wiki-install/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: wiki-install
+description: "Bootstrap the LLM Wiki kernel (lisa-wiki plugin) in a host project. Solves the chicken-and-egg gap: the base lisa plugin can install the wiki plugin so its setup skill becomes discoverable. Edits .claude/settings.json to enable lisa-wiki@lisa and confirm the CodySwannGT/lisa marketplace, then for Codex verifies whether the .codex/skills/lisa overlay already carries lisa-wiki-* skills (printed by Lisa's apply) and nudges the user to refresh the overlay if missing. Idempotent. Never auto-runs `lisa apply`. After this skill, reload the runtime and run /setup:wiki (Claude) or $lisa-wiki-setup (Codex) to scaffold the wiki itself."
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+
+# Install the LLM Wiki kernel
+
+This skill makes the `lisa-wiki` plugin visible in the current project so its scaffolder (`/setup:wiki` / `$lisa-wiki-setup`) can run. It does **not** scaffold the wiki itself — that is the wiki plugin's job. This skill only flips the install bit and verifies the Codex overlay carries the kernel.
+
+## Why this skill exists
+
+`lisa-wiki` is published as `AVAILABLE` (not `INSTALLED_BY_DEFAULT`) in Lisa's marketplace. A downstream project that never enabled it has no way to discover the wiki's setup command — a chicken-and-egg bootstrap gap. Because the base `lisa` plugin is auto-enabled everywhere, putting the bootstrap here is what makes the wiki reachable.
+
+## Asymmetry note
+
+The two runtimes work differently:
+
+- **Claude Code** loads plugin skills per-project through `.claude/settings.json` `enabledPlugins`. The wiki skills are invisible until `lisa-wiki@lisa` is enabled there. This skill makes that edit.
+- **Codex** loads Lisa skills through an overlay path (`src/codex/skills-installer.ts` runs from `Lisa.apply()` and copies every built `plugins/<p>/skills/<n>/` into `.codex/skills/lisa/`). Wiki skills land in that overlay automatically every time the project re-applies Lisa. This skill does not mutate Codex config — it only checks whether the overlay carries `lisa-wiki-setup` and tells the user how to refresh if missing.
+
+## Workflow
+
+### Step 1 — Verify we are in a project, not Lisa itself
+
+```bash
+cwd="$(pwd)"
+if [ -f "$cwd/.lisa-source" ] || { [ -d "$cwd/plugins/src/base" ] && [ -f "$cwd/.claude-plugin/marketplace.json" ]; }; then
+  echo "This is the Lisa monorepo itself — the base plugin's wiki kernel already lives here."
+  echo "Run /setup:wiki to scaffold a wiki, or invoke this skill from inside a downstream project."
+  exit 0
+fi
+```
+
+### Step 2 — Enable lisa-wiki@lisa in the Claude project settings
+
+Read `<cwd>/.claude/settings.json` (create with `{}` if absent). Then, using the **Edit** or **Write** tool with valid JSON (not jq one-liners that risk corrupting comments / formatting):
+
+1. Ensure `enabledPlugins` is an object.
+2. Set `enabledPlugins["lisa-wiki@lisa"] = true`.
+3. Ensure `extraKnownMarketplaces` is an object containing the entry below if it is not already present (do **not** overwrite an existing entry):
+
+   ```json
+   "CodySwannGT/lisa": {
+     "source": {
+       "source": "github",
+       "repo": "CodySwannGT/lisa"
+     }
+   }
+   ```
+
+4. Pretty-print the file with 2-space indentation and a trailing newline.
+
+If `enabledPlugins["lisa-wiki@lisa"]` was already `true`, log "Claude: lisa-wiki@lisa already enabled — no change." If not, log "Claude: enabled lisa-wiki@lisa in .claude/settings.json."
+
+**Do not** edit `.claude/settings.local.json` — that file is per-user and is not the right surface for a project-level enablement.
+
+### Step 3 — Verify the Codex overlay carries lisa-wiki
+
+```bash
+codex_wiki_setup=".codex/skills/lisa/lisa-wiki-setup/SKILL.md"
+if [ -f "$codex_wiki_setup" ]; then
+  echo "Codex: lisa-wiki overlay already present (found $codex_wiki_setup). Nothing to do for Codex."
+else
+  echo "Codex: lisa-wiki skills not found in .codex/skills/lisa/."
+  if [ -d ".agents" ] || [ -d ".codex" ]; then
+    echo "  → This project appears Codex-wired but its overlay is stale or predates lisa-wiki."
+    echo "  → Refresh it by running your project's Lisa apply command, e.g.:"
+    echo "       npx lisa --harness=codex ."
+    echo "    (or whatever shape your project uses to apply Lisa for Codex)."
+  else
+    echo "  → This project does not have a Codex installation yet (no .agents/ or .codex/). Skip if Codex parity is not needed."
+  fi
+fi
+```
+
+**Do not** invoke `lisa apply` automatically. `lisa apply` rewrites more than the wiki overlay; it must remain the user's explicit choice.
+
+### Step 4 — Hand off
+
+Print:
+
+```
+Wiki kernel install complete.
+
+Next steps:
+  • Reload your runtime so it picks up the newly-enabled plugin (Claude: /reload or restart the session; Codex: restart `codex`).
+  • Then run /setup:wiki (Claude) or $lisa-wiki-setup (Codex) to scaffold wiki/ in this project.
+```
+
+## Rules
+
+- Idempotent. Re-running produces no spurious changes once both flags are set.
+- Project-scoped only. Never touch `~/.codex/config.toml` or any user-global config.
+- Never run `lisa apply` on the user's behalf.
+- Never edit `.claude/settings.local.json` — it is user-scoped overrides.
+- Preserve human-authored content. Only flip the enablement key and add the marketplace entry if missing.
+
+## Related
+
+`lisa-wiki-setup` (the actual scaffolder, lives in the `lisa-wiki` plugin once enabled), `lisa-wiki-doctor`, `lisa-wiki-usage`.

package/plugins/lisa/skills/wiki-install/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "Wiki Install"
+short_description: "Bootstrap the LLM Wiki kernel (lisa-wiki plugin) in a host project"
+default_prompt:
+  - "Use $wiki-install: Bootstrap the LLM Wiki kernel (lisa-wiki plugin) in a host project."

package/plugins/lisa-cdk/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "AWS CDK-specific plugin",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-cdk/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "AWS CDK-specific Lisa plugin.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-expo/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-expo/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Expo and React Native-specific skills, agents, rules, and MCP servers.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Harper/Fabric-specific rules for TypeScript component apps",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Harper/Fabric-specific Lisa rules for TypeScript component apps.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "NestJS-specific skills and migration write-protection hooks.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, across Claude and Codex.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-rails/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Ruby on Rails-specific skills and hooks for RuboCop and ast-grep scanning on edit.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "TypeScript-specific hooks for formatting, linting, and ast-grep scanning on edit.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.101.1",
+  "version": "2.103.0",
   "description": "Distributable LLM Wiki kernel — ingest, query, lint, and maintain a git-native markdown knowledge base across Claude and Codex.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki/scripts/wiki-status.mjs

@@ -0,0 +1,310 @@
+#!/usr/bin/env node
+/**
+ * wiki-status.mjs — read-only Lisa wiki source freshness report.
+ *
+ * Usage: node wiki-status.mjs [--wiki <wikiRoot>] [--config <path>] [--json]
+ * Exit 0 = report rendered. Missing wiki/config are represented in the report.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadConfig, walkFiles } from "./_wiki-lib.mjs";
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_STALE_AFTER_DAYS = 7;
+
+const argv = process.argv.slice(2);
+const flag = name => argv.includes(name);
+const opt = name => {
+  const i = argv.indexOf(name);
+  return i !== -1 ? argv[i + 1] : undefined;
+};
+
+function relToCwd(filePath) {
+  return path.relative(process.cwd(), filePath).replaceAll(path.sep, "/");
+}
+
+function normalizeWikiPath(filePath) {
+  return filePath.replaceAll("\\", "/").replace(/^\.?\//, "");
+}
+
+function parseDate(value) {
+  if (!value || typeof value !== "string") return undefined;
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? undefined : date;
+}
+
+function newestDate(values) {
+  return values
+    .map(parseDate)
+    .filter(Boolean)
+    .sort((a, b) => b.getTime() - a.getTime())[0];
+}
+
+function readTextSafe(filePath) {
+  try {
+    return fs.readFileSync(filePath, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+function readJsonSafe(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch {
+    return undefined;
+  }
+}
+
+function enabledConnectors(config) {
+  const connectors = config?.connectors ?? {};
+  return Object.entries(connectors)
+    .filter(([, connectorConfig]) => connectorConfig?.enabled !== false)
+    .filter(
+      ([, connectorConfig]) => connectorConfig?.sideEffects !== "external-write"
+    )
+    .map(([name, connectorConfig]) => ({
+      name,
+      sideEffects: connectorConfig?.sideEffects ?? "unknown",
+    }))
+    .sort((a, b) => a.name.localeCompare(b.name));
+}
+
+function logSections(logText) {
+  const lines = logText.split("\n");
+  const sections = [];
+  let current;
+
+  for (const line of lines) {
+    const heading = line.match(/^##\s+(\d{4}-\d{2}-\d{2})(?:\s+-\s+(.*))?$/);
+    if (heading) {
+      if (current) sections.push(current);
+      current = {
+        date: heading[1],
+        title: heading[2] ?? "",
+        lines: [line],
+      };
+      continue;
+    }
+    if (current) current.lines.push(line);
+  }
+
+  if (current) sections.push(current);
+  return sections;
+}
+
+function connectorLogFacts(logText, connectorName) {
+  const sections = logSections(logText);
+  const escaped = connectorName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const quoted = new RegExp(`\`${escaped}\``, "i");
+  const bare = new RegExp(`\\b${escaped}\\b`, "i");
+
+  for (const section of [...sections].reverse()) {
+    const lines = section.lines.filter(
+      line => quoted.test(line) || bare.test(line)
+    );
+    if (lines.length === 0) continue;
+
+    const lower = lines.join("\n").toLowerCase();
+    const status = lower.includes("skipped")
+      ? "skipped"
+      : lower.includes("blocked") || lower.includes("failed")
+        ? "blocked"
+        : lower.includes("ingested") || lower.includes("refreshed")
+          ? "ingested"
+          : "observed";
+
+    return {
+      date: section.date,
+      status,
+      reason: lines.map(line => line.replace(/^-\s*/, "").trim()).join(" "),
+    };
+  }
+
+  return undefined;
+}
+
+function stateFacts(wikiRoot, connectorName) {
+  const stateDir = path.join(wikiRoot, "state", connectorName);
+  const files = walkFiles(stateDir, { ext: ".json" });
+  const states = files
+    .map(filePath => ({ filePath, data: readJsonSafe(filePath) }))
+    .filter(item => item.data);
+  const dated = states
+    .map(item => ({
+      ...item,
+      date:
+        parseDate(item.data.ingested_at) ??
+        parseDate(item.data.cursor?.lastIngest) ??
+        parseDate(item.data.updated_at),
+    }))
+    .sort((a, b) => (b.date?.getTime() ?? 0) - (a.date?.getTime() ?? 0));
+  const latest = dated[0] ?? states[0];
+  const sourceNotes = new Set();
+
+  for (const item of states) {
+    const notes = item.data.source_notes ?? item.data.sourceNotes ?? [];
+    if (Array.isArray(notes)) {
+      for (const note of notes) {
+        if (typeof note === "string") sourceNotes.add(normalizeWikiPath(note));
+      }
+    }
+    if (typeof item.data.source_note === "string") {
+      sourceNotes.add(normalizeWikiPath(item.data.source_note));
+    }
+  }
+
+  return {
+    stateFiles: files.map(filePath => relToCwd(filePath)),
+    latestObservedAt: latest?.date?.toISOString() ?? latest?.data?.ingested_at,
+    sourceNotes: [...sourceNotes],
+  };
+}
+
+function sourceFacts(wikiRoot, connectorName, configuredSourceNotes) {
+  const sourceDir = path.join(wikiRoot, "sources", connectorName);
+  const markdownFiles = walkFiles(sourceDir, { ext: ".md" }).map(relToCwd);
+  const wikiParent = path.dirname(wikiRoot);
+  const sourceNoteExists = note =>
+    fs.existsSync(path.resolve(note)) ||
+    fs.existsSync(path.resolve(wikiParent, note));
+  const existingConfigured = configuredSourceNotes.filter(note =>
+    sourceNoteExists(note)
+  );
+
+  return {
+    sourceNotes:
+      existingConfigured.length > 0
+        ? existingConfigured
+        : markdownFiles.map(normalizeWikiPath),
+  };
+}
+
+function nextActionFor(verdict, connectorName, reason) {
+  if (verdict === "fresh") return "No action needed.";
+  if (verdict === "skipped") {
+    return reason?.toLowerCase().includes("project-scoped memory")
+      ? "Provide project-scoped memory for this repo, or accept the expected skip."
+      : `Review the skip reason, then run /lisa-wiki:ingest --source ${connectorName} when available.`;
+  }
+  if (verdict === "blocked") {
+    return `Resolve the blocker, then run /lisa-wiki:ingest --source ${connectorName}.`;
+  }
+  return `Run /lisa-wiki:ingest --source ${connectorName}.`;
+}
+
+export function createWikiFreshnessReport({
+  configPath = "wiki/lisa-wiki.config.json",
+  wikiRoot,
+  now = new Date(),
+  staleAfterDays = DEFAULT_STALE_AFTER_DAYS,
+} = {}) {
+  const { config, configPath: resolvedConfigPath } = loadConfig(configPath);
+  const resolvedWikiRoot = path.resolve(wikiRoot ?? config?.wikiRoot ?? "wiki");
+  const logPath = path.join(resolvedWikiRoot, "log.md");
+  const logText = readTextSafe(logPath);
+  const connectors = enabledConnectors(config);
+  const staleAfterMs = staleAfterDays * DAY_MS;
+
+  const items = connectors.map(connector => {
+    const state = stateFacts(resolvedWikiRoot, connector.name);
+    const sources = sourceFacts(
+      resolvedWikiRoot,
+      connector.name,
+      state.sourceNotes
+    );
+    const log = connectorLogFacts(logText, connector.name);
+    const observedDate =
+      newestDate([state.latestObservedAt, log?.date]) ??
+      newestDate(
+        sources.sourceNotes.map(note => note.match(/\d{4}-\d{2}-\d{2}/)?.[0])
+      );
+    const hasState = state.stateFiles.length > 0;
+    const hasSourceNotes = sources.sourceNotes.length > 0;
+    const isStale =
+      observedDate && now.getTime() - observedDate.getTime() > staleAfterMs;
+
+    const verdict =
+      log?.status === "blocked"
+        ? "blocked"
+        : log?.status === "skipped" && !hasState && !hasSourceNotes
+          ? "skipped"
+          : !hasState && !hasSourceNotes
+            ? "never_ingested"
+            : !hasState || !hasSourceNotes || isStale
+              ? "stale"
+              : "fresh";
+
+    const evidence = [
+      ...sources.sourceNotes,
+      ...state.stateFiles,
+      fs.existsSync(logPath) ? relToCwd(logPath) : undefined,
+    ].filter(Boolean);
+
+    return {
+      connector: connector.name,
+      sideEffects: connector.sideEffects,
+      verdict,
+      evidence,
+      lastObserved: observedDate?.toISOString().slice(0, 10) ?? "unknown",
+      reason: verdict === "fresh" ? "" : (log?.reason ?? ""),
+      nextAction: nextActionFor(verdict, connector.name, log?.reason),
+    };
+  });
+
+  return {
+    generatedAt: now.toISOString(),
+    configPath: relToCwd(resolvedConfigPath),
+    wikiRoot: relToCwd(resolvedWikiRoot),
+    items,
+  };
+}
+
+export function renderWikiFreshnessReport(report) {
+  const lines = [
+    "# Lisa wiki source freshness",
+    "",
+    `Generated: ${report.generatedAt}`,
+    `Config: ${report.configPath}`,
+    `Wiki root: ${report.wikiRoot}`,
+    "",
+    "| Connector | Verdict | Last observed | Evidence | Next action |",
+    "| --- | --- | --- | --- | --- |",
+  ];
+
+  for (const item of report.items) {
+    const evidence =
+      item.evidence.length > 0
+        ? item.evidence.slice(0, 3).join("<br>")
+        : "none";
+    lines.push(
+      `| ${item.connector} | ${item.verdict} | ${item.lastObserved} | ${evidence} | ${item.nextAction} |`
+    );
+    if (item.reason && item.verdict !== "fresh") {
+      lines.push(
+        `| ${item.connector} | reason | ${item.lastObserved} | log | ${item.reason} |`
+      );
+    }
+  }
+
+  lines.push(
+    "",
+    "Integrity follow-up: run /lisa-wiki:lint separately for broken links, stale claims, or structure issues."
+  );
+
+  return `${lines.join("\n")}\n`;
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  const report = createWikiFreshnessReport({
+    configPath: opt("--config") ?? "wiki/lisa-wiki.config.json",
+    wikiRoot: opt("--wiki"),
+  });
+
+  if (flag("--json")) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    process.stdout.write(renderWikiFreshnessReport(report));
+  }
+}

package/plugins/src/base/commands/wiki/install.md

@@ -0,0 +1,7 @@
+---
+description: "Enable the LLM Wiki kernel (lisa-wiki plugin) in this project so its setup skill becomes discoverable. Edits .claude/settings.json to enable lisa-wiki@lisa and confirm the CodySwannGT/lisa marketplace, then verifies the Codex overlay (.codex/skills/lisa) already carries the wiki kernel. Does NOT scaffold the wiki itself — after install, reload the runtime and run /setup:wiki (Claude) or $lisa-wiki-setup (Codex)."
+allowed-tools: ["Skill"]
+argument-hint: ""
+---
+
+Use the /lisa:wiki-install skill to enable the lisa-wiki plugin in this project. $ARGUMENTS

package/plugins/src/base/rules/config-resolution.md

@@ -164,6 +164,7 @@ fi
 |-------|----------|---------|-------|
 | `tracker` | **yes** | — | Destination for ticket writes. One of `"jira"`, `"github"`, `"linear"`. Missing → fail with instruction to run the matching `/lisa:setup:*` skill. |
 | `source` | no | — | Default PRD source for batch skills (`/lisa:intake`) and arg-less single-PRD skills. One of `"notion"`, `"confluence"`, `"linear"`, `"github"`, `"jira"`. Explicit URLs/keys passed to a skill always win over `source`; this is a default, not a lock. |
+| `usage` | no | — | Optional token/cost pricing metadata consumed by the `usage-accounting` rule. Missing pricing never blocks a lifecycle flow; Lisa records token counts with `estimated_cost: null` when no trustworthy price source is configured. |
 
 ### Vendor sections
 

package/plugins/src/base/skills/wiki-install/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: wiki-install
+description: "Bootstrap the LLM Wiki kernel (lisa-wiki plugin) in a host project. Solves the chicken-and-egg gap: the base lisa plugin can install the wiki plugin so its setup skill becomes discoverable. Edits .claude/settings.json to enable lisa-wiki@lisa and confirm the CodySwannGT/lisa marketplace, then for Codex verifies whether the .codex/skills/lisa overlay already carries lisa-wiki-* skills (printed by Lisa's apply) and nudges the user to refresh the overlay if missing. Idempotent. Never auto-runs `lisa apply`. After this skill, reload the runtime and run /setup:wiki (Claude) or $lisa-wiki-setup (Codex) to scaffold the wiki itself."
+allowed-tools: ["Bash", "Read", "Write", "Edit"]
+---
+
+# Install the LLM Wiki kernel
+
+This skill makes the `lisa-wiki` plugin visible in the current project so its scaffolder (`/setup:wiki` / `$lisa-wiki-setup`) can run. It does **not** scaffold the wiki itself — that is the wiki plugin's job. This skill only flips the install bit and verifies the Codex overlay carries the kernel.
+
+## Why this skill exists
+
+`lisa-wiki` is published as `AVAILABLE` (not `INSTALLED_BY_DEFAULT`) in Lisa's marketplace. A downstream project that never enabled it has no way to discover the wiki's setup command — a chicken-and-egg bootstrap gap. Because the base `lisa` plugin is auto-enabled everywhere, putting the bootstrap here is what makes the wiki reachable.
+
+## Asymmetry note
+
+The two runtimes work differently:
+
+- **Claude Code** loads plugin skills per-project through `.claude/settings.json` `enabledPlugins`. The wiki skills are invisible until `lisa-wiki@lisa` is enabled there. This skill makes that edit.
+- **Codex** loads Lisa skills through an overlay path (`src/codex/skills-installer.ts` runs from `Lisa.apply()` and copies every built `plugins/<p>/skills/<n>/` into `.codex/skills/lisa/`). Wiki skills land in that overlay automatically every time the project re-applies Lisa. This skill does not mutate Codex config — it only checks whether the overlay carries `lisa-wiki-setup` and tells the user how to refresh if missing.
+
+## Workflow
+
+### Step 1 — Verify we are in a project, not Lisa itself
+
+```bash
+cwd="$(pwd)"
+if [ -f "$cwd/.lisa-source" ] || { [ -d "$cwd/plugins/src/base" ] && [ -f "$cwd/.claude-plugin/marketplace.json" ]; }; then
+  echo "This is the Lisa monorepo itself — the base plugin's wiki kernel already lives here."
+  echo "Run /setup:wiki to scaffold a wiki, or invoke this skill from inside a downstream project."
+  exit 0
+fi
+```
+
+### Step 2 — Enable lisa-wiki@lisa in the Claude project settings
+
+Read `<cwd>/.claude/settings.json` (create with `{}` if absent). Then, using the **Edit** or **Write** tool with valid JSON (not jq one-liners that risk corrupting comments / formatting):
+
+1. Ensure `enabledPlugins` is an object.
+2. Set `enabledPlugins["lisa-wiki@lisa"] = true`.
+3. Ensure `extraKnownMarketplaces` is an object containing the entry below if it is not already present (do **not** overwrite an existing entry):
+
+   ```json
+   "CodySwannGT/lisa": {
+     "source": {
+       "source": "github",
+       "repo": "CodySwannGT/lisa"
+     }
+   }
+   ```
+
+4. Pretty-print the file with 2-space indentation and a trailing newline.
+
+If `enabledPlugins["lisa-wiki@lisa"]` was already `true`, log "Claude: lisa-wiki@lisa already enabled — no change." If not, log "Claude: enabled lisa-wiki@lisa in .claude/settings.json."
+
+**Do not** edit `.claude/settings.local.json` — that file is per-user and is not the right surface for a project-level enablement.
+
+### Step 3 — Verify the Codex overlay carries lisa-wiki
+
+```bash
+codex_wiki_setup=".codex/skills/lisa/lisa-wiki-setup/SKILL.md"
+if [ -f "$codex_wiki_setup" ]; then
+  echo "Codex: lisa-wiki overlay already present (found $codex_wiki_setup). Nothing to do for Codex."
+else
+  echo "Codex: lisa-wiki skills not found in .codex/skills/lisa/."
+  if [ -d ".agents" ] || [ -d ".codex" ]; then
+    echo "  → This project appears Codex-wired but its overlay is stale or predates lisa-wiki."
+    echo "  → Refresh it by running your project's Lisa apply command, e.g.:"
+    echo "       npx lisa --harness=codex ."
+    echo "    (or whatever shape your project uses to apply Lisa for Codex)."
+  else
+    echo "  → This project does not have a Codex installation yet (no .agents/ or .codex/). Skip if Codex parity is not needed."
+  fi
+fi
+```
+
+**Do not** invoke `lisa apply` automatically. `lisa apply` rewrites more than the wiki overlay; it must remain the user's explicit choice.
+
+### Step 4 — Hand off
+
+Print:
+
+```
+Wiki kernel install complete.
+
+Next steps:
+  • Reload your runtime so it picks up the newly-enabled plugin (Claude: /reload or restart the session; Codex: restart `codex`).
+  • Then run /setup:wiki (Claude) or $lisa-wiki-setup (Codex) to scaffold wiki/ in this project.
+```
+
+## Rules
+
+- Idempotent. Re-running produces no spurious changes once both flags are set.
+- Project-scoped only. Never touch `~/.codex/config.toml` or any user-global config.
+- Never run `lisa apply` on the user's behalf.
+- Never edit `.claude/settings.local.json` — it is user-scoped overrides.
+- Preserve human-authored content. Only flip the enablement key and add the marketplace entry if missing.
+
+## Related
+
+`lisa-wiki-setup` (the actual scaffolder, lives in the `lisa-wiki` plugin once enabled), `lisa-wiki-doctor`, `lisa-wiki-usage`.

package/plugins/src/wiki/scripts/wiki-status.mjs

@@ -0,0 +1,310 @@
+#!/usr/bin/env node
+/**
+ * wiki-status.mjs — read-only Lisa wiki source freshness report.
+ *
+ * Usage: node wiki-status.mjs [--wiki <wikiRoot>] [--config <path>] [--json]
+ * Exit 0 = report rendered. Missing wiki/config are represented in the report.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadConfig, walkFiles } from "./_wiki-lib.mjs";
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_STALE_AFTER_DAYS = 7;
+
+const argv = process.argv.slice(2);
+const flag = name => argv.includes(name);
+const opt = name => {
+  const i = argv.indexOf(name);
+  return i !== -1 ? argv[i + 1] : undefined;
+};
+
+function relToCwd(filePath) {
+  return path.relative(process.cwd(), filePath).replaceAll(path.sep, "/");
+}
+
+function normalizeWikiPath(filePath) {
+  return filePath.replaceAll("\\", "/").replace(/^\.?\//, "");
+}
+
+function parseDate(value) {
+  if (!value || typeof value !== "string") return undefined;
+  const date = new Date(value);
+  return Number.isNaN(date.getTime()) ? undefined : date;
+}
+
+function newestDate(values) {
+  return values
+    .map(parseDate)
+    .filter(Boolean)
+    .sort((a, b) => b.getTime() - a.getTime())[0];
+}
+
+function readTextSafe(filePath) {
+  try {
+    return fs.readFileSync(filePath, "utf8");
+  } catch {
+    return "";
+  }
+}
+
+function readJsonSafe(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+  } catch {
+    return undefined;
+  }
+}
+
+function enabledConnectors(config) {
+  const connectors = config?.connectors ?? {};
+  return Object.entries(connectors)
+    .filter(([, connectorConfig]) => connectorConfig?.enabled !== false)
+    .filter(
+      ([, connectorConfig]) => connectorConfig?.sideEffects !== "external-write"
+    )
+    .map(([name, connectorConfig]) => ({
+      name,
+      sideEffects: connectorConfig?.sideEffects ?? "unknown",
+    }))
+    .sort((a, b) => a.name.localeCompare(b.name));
+}
+
+function logSections(logText) {
+  const lines = logText.split("\n");
+  const sections = [];
+  let current;
+
+  for (const line of lines) {
+    const heading = line.match(/^##\s+(\d{4}-\d{2}-\d{2})(?:\s+-\s+(.*))?$/);
+    if (heading) {
+      if (current) sections.push(current);
+      current = {
+        date: heading[1],
+        title: heading[2] ?? "",
+        lines: [line],
+      };
+      continue;
+    }
+    if (current) current.lines.push(line);
+  }
+
+  if (current) sections.push(current);
+  return sections;
+}
+
+function connectorLogFacts(logText, connectorName) {
+  const sections = logSections(logText);
+  const escaped = connectorName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const quoted = new RegExp(`\`${escaped}\``, "i");
+  const bare = new RegExp(`\\b${escaped}\\b`, "i");
+
+  for (const section of [...sections].reverse()) {
+    const lines = section.lines.filter(
+      line => quoted.test(line) || bare.test(line)
+    );
+    if (lines.length === 0) continue;
+
+    const lower = lines.join("\n").toLowerCase();
+    const status = lower.includes("skipped")
+      ? "skipped"
+      : lower.includes("blocked") || lower.includes("failed")
+        ? "blocked"
+        : lower.includes("ingested") || lower.includes("refreshed")
+          ? "ingested"
+          : "observed";
+
+    return {
+      date: section.date,
+      status,
+      reason: lines.map(line => line.replace(/^-\s*/, "").trim()).join(" "),
+    };
+  }
+
+  return undefined;
+}
+
+function stateFacts(wikiRoot, connectorName) {
+  const stateDir = path.join(wikiRoot, "state", connectorName);
+  const files = walkFiles(stateDir, { ext: ".json" });
+  const states = files
+    .map(filePath => ({ filePath, data: readJsonSafe(filePath) }))
+    .filter(item => item.data);
+  const dated = states
+    .map(item => ({
+      ...item,
+      date:
+        parseDate(item.data.ingested_at) ??
+        parseDate(item.data.cursor?.lastIngest) ??
+        parseDate(item.data.updated_at),
+    }))
+    .sort((a, b) => (b.date?.getTime() ?? 0) - (a.date?.getTime() ?? 0));
+  const latest = dated[0] ?? states[0];
+  const sourceNotes = new Set();
+
+  for (const item of states) {
+    const notes = item.data.source_notes ?? item.data.sourceNotes ?? [];
+    if (Array.isArray(notes)) {
+      for (const note of notes) {
+        if (typeof note === "string") sourceNotes.add(normalizeWikiPath(note));
+      }
+    }
+    if (typeof item.data.source_note === "string") {
+      sourceNotes.add(normalizeWikiPath(item.data.source_note));
+    }
+  }
+
+  return {
+    stateFiles: files.map(filePath => relToCwd(filePath)),
+    latestObservedAt: latest?.date?.toISOString() ?? latest?.data?.ingested_at,
+    sourceNotes: [...sourceNotes],
+  };
+}
+
+function sourceFacts(wikiRoot, connectorName, configuredSourceNotes) {
+  const sourceDir = path.join(wikiRoot, "sources", connectorName);
+  const markdownFiles = walkFiles(sourceDir, { ext: ".md" }).map(relToCwd);
+  const wikiParent = path.dirname(wikiRoot);
+  const sourceNoteExists = note =>
+    fs.existsSync(path.resolve(note)) ||
+    fs.existsSync(path.resolve(wikiParent, note));
+  const existingConfigured = configuredSourceNotes.filter(note =>
+    sourceNoteExists(note)
+  );
+
+  return {
+    sourceNotes:
+      existingConfigured.length > 0
+        ? existingConfigured
+        : markdownFiles.map(normalizeWikiPath),
+  };
+}
+
+function nextActionFor(verdict, connectorName, reason) {
+  if (verdict === "fresh") return "No action needed.";
+  if (verdict === "skipped") {
+    return reason?.toLowerCase().includes("project-scoped memory")
+      ? "Provide project-scoped memory for this repo, or accept the expected skip."
+      : `Review the skip reason, then run /lisa-wiki:ingest --source ${connectorName} when available.`;
+  }
+  if (verdict === "blocked") {
+    return `Resolve the blocker, then run /lisa-wiki:ingest --source ${connectorName}.`;
+  }
+  return `Run /lisa-wiki:ingest --source ${connectorName}.`;
+}
+
+export function createWikiFreshnessReport({
+  configPath = "wiki/lisa-wiki.config.json",
+  wikiRoot,
+  now = new Date(),
+  staleAfterDays = DEFAULT_STALE_AFTER_DAYS,
+} = {}) {
+  const { config, configPath: resolvedConfigPath } = loadConfig(configPath);
+  const resolvedWikiRoot = path.resolve(wikiRoot ?? config?.wikiRoot ?? "wiki");
+  const logPath = path.join(resolvedWikiRoot, "log.md");
+  const logText = readTextSafe(logPath);
+  const connectors = enabledConnectors(config);
+  const staleAfterMs = staleAfterDays * DAY_MS;
+
+  const items = connectors.map(connector => {
+    const state = stateFacts(resolvedWikiRoot, connector.name);
+    const sources = sourceFacts(
+      resolvedWikiRoot,
+      connector.name,
+      state.sourceNotes
+    );
+    const log = connectorLogFacts(logText, connector.name);
+    const observedDate =
+      newestDate([state.latestObservedAt, log?.date]) ??
+      newestDate(
+        sources.sourceNotes.map(note => note.match(/\d{4}-\d{2}-\d{2}/)?.[0])
+      );
+    const hasState = state.stateFiles.length > 0;
+    const hasSourceNotes = sources.sourceNotes.length > 0;
+    const isStale =
+      observedDate && now.getTime() - observedDate.getTime() > staleAfterMs;
+
+    const verdict =
+      log?.status === "blocked"
+        ? "blocked"
+        : log?.status === "skipped" && !hasState && !hasSourceNotes
+          ? "skipped"
+          : !hasState && !hasSourceNotes
+            ? "never_ingested"
+            : !hasState || !hasSourceNotes || isStale
+              ? "stale"
+              : "fresh";
+
+    const evidence = [
+      ...sources.sourceNotes,
+      ...state.stateFiles,
+      fs.existsSync(logPath) ? relToCwd(logPath) : undefined,
+    ].filter(Boolean);
+
+    return {
+      connector: connector.name,
+      sideEffects: connector.sideEffects,
+      verdict,
+      evidence,
+      lastObserved: observedDate?.toISOString().slice(0, 10) ?? "unknown",
+      reason: verdict === "fresh" ? "" : (log?.reason ?? ""),
+      nextAction: nextActionFor(verdict, connector.name, log?.reason),
+    };
+  });
+
+  return {
+    generatedAt: now.toISOString(),
+    configPath: relToCwd(resolvedConfigPath),
+    wikiRoot: relToCwd(resolvedWikiRoot),
+    items,
+  };
+}
+
+export function renderWikiFreshnessReport(report) {
+  const lines = [
+    "# Lisa wiki source freshness",
+    "",
+    `Generated: ${report.generatedAt}`,
+    `Config: ${report.configPath}`,
+    `Wiki root: ${report.wikiRoot}`,
+    "",
+    "| Connector | Verdict | Last observed | Evidence | Next action |",
+    "| --- | --- | --- | --- | --- |",
+  ];
+
+  for (const item of report.items) {
+    const evidence =
+      item.evidence.length > 0
+        ? item.evidence.slice(0, 3).join("<br>")
+        : "none";
+    lines.push(
+      `| ${item.connector} | ${item.verdict} | ${item.lastObserved} | ${evidence} | ${item.nextAction} |`
+    );
+    if (item.reason && item.verdict !== "fresh") {
+      lines.push(
+        `| ${item.connector} | reason | ${item.lastObserved} | log | ${item.reason} |`
+      );
+    }
+  }
+
+  lines.push(
+    "",
+    "Integrity follow-up: run /lisa-wiki:lint separately for broken links, stale claims, or structure issues."
+  );
+
+  return `${lines.join("\n")}\n`;
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  const report = createWikiFreshnessReport({
+    configPath: opt("--config") ?? "wiki/lisa-wiki.config.json",
+    wikiRoot: opt("--wiki"),
+  });
+
+  if (flag("--json")) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    process.stdout.write(renderWikiFreshnessReport(report));
+  }
+}