@codyswann/lisa 2.23.2 → 2.25.0

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.

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] ?? {