@codyswann/lisa 2.24.0 → 2.25.1

package/plugins/src/wiki/templates/llm-wiki-contract.md

@@ -0,0 +1,60 @@
+# {{displayName}} — LLM Wiki Contract
+
+> Generated by the `lisa-wiki` plugin from `{{wikiRoot}}/lisa-wiki.config.json`.
+> kernelVersion: {{kernelVersion}} · schemaVersion: {{schemaVersion}} · rendered: {{generatedDate}}
+> This snapshot keeps the wiki self-describing **without** the plugin installed. Re-render with
+> `/setup --upgrade`; do not hand-edit — change the config instead.
+
+## Purpose
+{{purpose}}
+
+## What this is
+A git-native markdown knowledge base under `{{wikiRoot}}/`, owned by **{{org}}**, maintained by the
+lisa-wiki kernel. Three layers: immutable **raw sources** (`{{wikiRoot}}/sources/`), the LLM-owned
+**synthesis** layer (the category directories), and this **schema** layer (config + this contract).
+Repository mode: **{{mode}}**.
+
+## Layout
+- `{{wikiRoot}}/index.md` — navigation map of every page (read first).
+- `{{wikiRoot}}/log.md` — append-only operation ledger.
+- `{{wikiRoot}}/start-here.md` — orientation + purpose.
+- `{{wikiRoot}}/sources/` — provenance (source notes); layout: **{{sourceLayout}}**.
+- `{{wikiRoot}}/state/` — per-source ingestion cursors (JSON).
+- `{{wikiRoot}}/staff/` — digital-staff role pages (optional).
+- Synthesis categories: {{categories}}.
+
+## Ordered ingestion pipeline (never reorder)
+`source note → synthesis → index → log → verify → state → commit/PR`.
+State advances **only** after source notes + synthesis + index + log + verification all pass.
+Connectors write **only** their source note (+ run metadata); the kernel performs synthesis, index,
+log, verification, state advancement, and PR.
+
+## Standards
+- Frontmatter required on new/touched synthesis pages and source notes
+  (`type`, `created`, `updated`, `related`, `sources`[, `sensitivity`]).
+- `index.md` is a per-category table; `log.md` is an append-only table with the fixed operation
+  vocabulary: `INIT, SETUP, INGEST, CREATE, UPDATE, MERGE, DEPRECATE, LINT, QUERY, REBUILD-INDEX`.
+- Cite sources in plain text, e.g. `Source: {{wikiRoot}}/sources/<system>/<note>.md`.
+- Do not invent facts; weak or unverified material → `{{wikiRoot}}/open-questions/`.
+
+## Sources & connectors
+Enabled connectors: {{connectors}}.
+Universal sources every project may ingest: self + other registered projects' git/PR history,
+**project-scoped** memory, and roles. **Memory is project-scoped ONLY — never global/unrelated.**
+External-write connectors (e.g. Slack OAuth, CRM writeback) run only with explicit intent and never
+auto-merge. A bare full ingest runs every enabled non-external-write source.
+
+## Safety
+- Source retention: **{{sourceRetention}}**. Default sensitivity: **{{sensitivityDefault}}**.
+- Pre-commit: `git diff --check`, secret scan, tenant/contamination scan, touched-file guard.
+- Never commit secrets/OAuth artifacts. In wrapper/standalone modes, never stage child-repo contents.
+
+## Git
+{{prPolicy}}.
+
+## README
+Mode: **{{readmeMode}}** (rich keeps the public README; stub points to `/onboard-me`; preserve leaves it).
+
+## Commands
+`/ingest` · `/query` · `/lint` · `/setup` · `/migrate` · `/add-ingest` · `/add-role` · `/onboard-me` · `/doctor`
+(On Codex, invoke the matching `lisa-wiki-*` skills, e.g. `$lisa-wiki-ingest`.)

package/plugins/src/wiki/templates/log.md

@@ -0,0 +1,8 @@
+# {{displayName}} — Log
+
+> Append-only. One row per operation. Operations:
+> `INIT, SETUP, INGEST, CREATE, UPDATE, MERGE, DEPRECATE, LINT, QUERY, REBUILD-INDEX`.
+
+| Date | Operation | Target | Notes |
+|---|---|---|---|
+| {{generatedDate}} | SETUP | {{wikiRoot}}/ | Initialized {{displayName}} with the lisa-wiki kernel. |

package/plugins/src/wiki/templates/page-types/architecture.md

@@ -0,0 +1,18 @@
+---
+type: architecture
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Overview
+
+## Components
+
+## Data flow
+
+## Constraints & decisions
+<!-- Link relevant decision/ pages; cite source notes -->

package/plugins/src/wiki/templates/page-types/concept.md

@@ -0,0 +1,18 @@
+---
+type: concept
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Definition
+
+## Key points
+
+## Evidence
+<!-- Cite source notes, e.g. Source: sources/<system>/<note>.md -->
+
+## Open questions

package/plugins/src/wiki/templates/page-types/decision.md

@@ -0,0 +1,18 @@
+---
+type: decision
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Context
+
+## Decision
+
+## Consequences
+
+## Status
+<!-- proposed | accepted | superseded -->

package/plugins/src/wiki/templates/page-types/entity.md

@@ -0,0 +1,19 @@
+---
+type: entity
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Overview
+
+## Key capabilities
+
+## Relationships
+<!-- People, products, systems this entity connects to -->
+
+## Context & evidence
+<!-- Cite source notes -->

package/plugins/src/wiki/templates/page-types/open-question.md

@@ -0,0 +1,18 @@
+---
+type: open-question
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## The question
+
+## What we know
+<!-- Cite source notes; this is where weak/unverified material lives until confirmed -->
+
+## What we still need
+
+## Owner

package/plugins/src/wiki/templates/page-types/playbook.md

@@ -0,0 +1,18 @@
+---
+type: playbook
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## When to use
+
+## Steps
+
+## Verification
+<!-- How to confirm it worked -->
+
+## Pitfalls

package/plugins/src/wiki/templates/page-types/project.md

@@ -0,0 +1,19 @@
+---
+type: project
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Repository
+<!-- | Field | Value | : local path, remote, default branch, HEAD, status -->
+
+## Technology signals
+
+## Structure signals
+
+## Notes & evidence
+<!-- Cite source notes, e.g. PR #/commit -->

package/plugins/src/wiki/templates/page-types/requirement.md

@@ -0,0 +1,19 @@
+---
+type: requirement
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+---
+
+# {{title}}
+
+## Summary
+
+## Acceptance criteria
+<!-- Gherkin: Given / When / Then -->
+
+## Out of scope
+
+## Notes & evidence
+<!-- Cite source notes -->

package/plugins/src/wiki/templates/page-types/staff.md

@@ -0,0 +1,26 @@
+---
+type: staff
+created: {{date}}
+updated: {{date}}
+related: []
+sources: []
+sensitivity: {{sensitivity}}
+---
+
+# {{role}} ({{id}})
+
+## Role
+<!-- Human or Agent; what this role is responsible for -->
+
+## Domain
+Owned categories: {{ownedCategories}}
+Owned connectors: {{ownedConnectors}}
+
+## Expertise
+{{expertise}}
+
+## Reports to
+
+## Notes
+<!-- The runnable subagent for this role lives at .claude/agents/{{id}}.md and .codex/agents/{{id}}.toml.
+     Whether it is ever invoked/scheduled is out of scope for the wiki. -->

package/plugins/src/wiki/templates/start-here.md

@@ -0,0 +1,24 @@
+# Start here — {{displayName}}
+
+## Purpose
+{{purpose}}
+
+## What this is
+A git-native LLM Wiki owned by **{{org}}** and maintained by the `lisa-wiki` kernel. It is the
+durable home for this project's knowledge (and documentation). Raw sources are preserved under
+`{{wikiRoot}}/sources/`; distilled knowledge lives in the category pages; the rules are in
+`{{wikiRoot}}/schema/llm-wiki-contract.md`.
+
+## How to use it
+- **New here?** Run `/onboard-me` (Codex: `$lisa-wiki-onboard-me`) for a guided tour + sample questions.
+- **Find/answer something:** `/query "<question>"` — cited answers from the wiki.
+- **Add knowledge:** `/ingest <url|file|prompt>` (Codex: `$lisa-wiki-ingest`), or `/ingest` with no
+  argument for a full ingest across all enabled non-external-write sources (external-write sources
+  require explicit intent).
+- **Browse:** [index.md](index.md).
+- **Check health:** `/lint`.
+
+## Map
+Synthesis categories: {{categories}}.
+Sources: `{{wikiRoot}}/sources/` · State: `{{wikiRoot}}/state/` · Contract:
+`{{wikiRoot}}/schema/llm-wiki-contract.md` · Log: `{{wikiRoot}}/log.md`.

package/plugins/src/wiki/templates/state-readme.md

@@ -0,0 +1,20 @@
+# state/ — ingestion cursors
+
+JSON cursors that let ingestion resume incrementally — one file per source/connector at
+`state/<system>/*.json`. A cursor is advanced **only after** its source notes + synthesis + index +
+log + verification all pass (never before). Common envelope:
+
+```json
+{
+  "connector": "git",
+  "profile": "default",
+  "lastSuccessfulRunAt": "1970-01-01T00:00:00Z",
+  "cursor": {},
+  "sourceNotes": [],
+  "synthesisPages": [],
+  "schemaVersion": "1.0.0"
+}
+```
+
+The post-migration / post-setup verification report is written to
+`state/migration/doctor-report.json` by `/doctor`.

package/scripts/build-plugins.sh

@@ -24,28 +24,36 @@ inject_version() {
   fi
 }
 
-# Build base plugin
-BASE_OUT="$PLUGINS_DIR/lisa"
-rm -rf "$BASE_OUT"
-mkdir -p "$BASE_OUT"
-cp -r "$SRC_DIR/base/." "$BASE_OUT/"
-inject_version "$BASE_OUT/.claude-plugin/plugin.json"
-node "$ROOT_DIR/scripts/generate-codex-plugin-artifacts.mjs" "$BASE_OUT" "$VERSION"
-echo "Built plugins/lisa (v$VERSION)"
+# Build one plugin: copy plugins/src/<src_name> -> plugins/<out_name>, inject the
+# release version into its Claude manifest, then derive the Codex artifacts.
+build_plugin() {
+  local src_name="$1"
+  local out_name="$2"
+  local src="$SRC_DIR/$src_name"
+  if [ ! -d "$src" ]; then
+    echo "Skipping plugins/$out_name (no source at plugins/src/$src_name)"
+    return 0
+  fi
+  local out="$PLUGINS_DIR/$out_name"
+  rm -rf "$out"
+  mkdir -p "$out"
+  cp -r "$src/." "$out/"
+  inject_version "$out/.claude-plugin/plugin.json"
+  node "$ROOT_DIR/scripts/generate-codex-plugin-artifacts.mjs" "$out" "$VERSION"
+  echo "Built plugins/$out_name (v$VERSION)"
+}
+
+# Base plugin
+build_plugin base lisa
 
-# Build stack-specific plugins (NO base copy)
+# Stack-specific plugins (NO base copy)
 STACKS=(typescript expo nestjs cdk harper-fabric rails)
 for stack in "${STACKS[@]}"; do
-  STACK_SRC="$SRC_DIR/$stack"
-  if [ ! -d "$STACK_SRC" ]; then
-    echo "Skipping plugins/lisa-$stack (no source)"
-    continue
-  fi
-  OUT="$PLUGINS_DIR/lisa-$stack"
-  rm -rf "$OUT"
-  mkdir -p "$OUT"
-  cp -r "$STACK_SRC/." "$OUT/"
-  inject_version "$OUT/.claude-plugin/plugin.json"
-  node "$ROOT_DIR/scripts/generate-codex-plugin-artifacts.mjs" "$OUT" "$VERSION"
-  echo "Built plugins/lisa-$stack (v$VERSION)"
+  build_plugin "$stack" "lisa-$stack"
+done
+
+# Standalone plugins (not language stacks): each builds plugins/src/<name> -> plugins/lisa-<name>
+STANDALONE=(wiki)
+for name in "${STANDALONE[@]}"; do
+  build_plugin "$name" "lisa-$name"
 done

package/scripts/check-plugins-sync.sh

@@ -35,7 +35,7 @@ if ! git diff --quiet -- plugins/; then
   echo "  overwrites the change." >&2
   echo "" >&2
   echo "  Fix:" >&2
-  echo "    1. Make your edit under plugins/src/<base|stack>/..." >&2
+  echo "    1. Make your edit under plugins/src/<base|stack|standalone (e.g. wiki)>/..." >&2
   echo "    2. Run: bun run build:plugins" >&2
   echo "    3. Commit both plugins/src and the regenerated plugins/lisa*." >&2
   # Leave the tree dirty so the diff is inspectable locally; CI fails on exit.
@@ -43,3 +43,40 @@ if ! git diff --quiet -- plugins/; then
 fi
 
 echo "✓ Plugin artifacts are in sync with plugins/src."
+
+# Marketplace coverage: every built plugin directory (plugins/lisa, plugins/lisa-*)
+# must be registered in .claude-plugin/marketplace.json, and every marketplace
+# entry must point at a directory that exists. The reproducibility check above
+# only proves artifacts match plugins/src — it does NOT prove a built plugin is
+# actually published. lisa-harper-fabric shipped built-but-unpublished for
+# exactly this reason: install-claude-plugins.sh tried "lisa-harper-fabric@lisa"
+# but the marketplace never advertised it, so resolution failed at install time.
+MARKETPLACE="$ROOT_DIR/.claude-plugin/marketplace.json"
+marketplace_fail=0
+
+# Every built plugin dir needs a marketplace entry whose source points to it.
+while IFS= read -r dir; do
+  name="$(basename "$dir")"
+  if ! jq -e --arg src "./plugins/$name" '.plugins[] | select(.source == $src)' "$MARKETPLACE" >/dev/null; then
+    echo "✗ Built plugin plugins/$name is not registered in .claude-plugin/marketplace.json (expected source \"./plugins/$name\")." >&2
+    marketplace_fail=1
+  fi
+done < <(find "$ROOT_DIR/plugins" -maxdepth 1 -mindepth 1 -type d ! -name src | sort)
+
+# Every marketplace entry must point at a directory that exists.
+while IFS= read -r src; do
+  if [ ! -d "$ROOT_DIR/$src" ]; then
+    echo "✗ marketplace.json entry source \"$src\" does not exist as a built plugin directory." >&2
+    marketplace_fail=1
+  fi
+done < <(jq -r '.plugins[].source' "$MARKETPLACE")
+
+if [ "$marketplace_fail" -ne 0 ]; then
+  echo "" >&2
+  echo "  Every plugins/lisa* directory must be registered in .claude-plugin/marketplace.json" >&2
+  echo "  and every marketplace source must point to a real built directory. Edit the manifest" >&2
+  echo "  at .claude-plugin/marketplace.json, then re-run: bun run check:plugins" >&2
+  exit 1
+fi
+
+echo "✓ Marketplace registers every built plugin."

package/scripts/generate-codex-plugin-artifacts.mjs

@@ -297,6 +297,28 @@ function metadataFor(pluginName) {
         "Improve this Rails model",
       ],
     },
+    "lisa-wiki": {
+      displayName: "LLM Wiki",
+      description:
+        "Distributable LLM Wiki kernel — ingest, query, lint, and maintain a git-native markdown knowledge base across Claude and Codex.",
+      shortDescription: "LLM Wiki knowledge base",
+      longDescription:
+        "A config-driven, git-native LLM Wiki: ingest sources (git, PRs, project-scoped memory, Jira, Slack, docs, …) into durable markdown, query with citations, lint integrity, onboard users, absorb existing documentation, and scaffold domain-expert role subagents. Distributed for both Claude Code and Codex.",
+      category: "Productivity",
+      capabilities: ["Interactive", "Write"],
+      keywords: [
+        "wiki",
+        "knowledge-base",
+        "ingest",
+        "documentation",
+        "llm-wiki",
+      ],
+      defaultPrompt: [
+        "Onboard me to this project",
+        "Ingest the latest sources into the wiki",
+        "Query the wiki",
+      ],
+    },
   };
   return (
     map[pluginName] ?? {