@codyswann/lisa 2.121.1 → 2.122.0

package/plugins/lisa-wiki-cursor/templates/llm-wiki-contract.md

@@ -0,0 +1,72 @@
+# {{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}}.
+
+## Answering questions (query-first)
+When you need to answer a question about this project — its code, architecture, decisions, domain
+concepts, conventions, or documentation — reach for the wiki **first**: run `/query "<question>"`
+(Codex: `$lisa-wiki-query`) before ad-hoc code search, grep, or a web lookup. The wiki is the
+curated, cited source of truth for this project, so a query is usually faster and more accurate than
+re-deriving the answer from raw files.
+
+This is the **primary** method, not the only one. If `/query` returns nothing relevant, the answer
+is not in the wiki yet, or the question is about live/uncommitted state, fall back to reading the
+code, browsing `{{wikiRoot}}/index.md`, or other tools — and consider `/ingest` to capture any
+durable knowledge you had to reconstruct so the next query succeeds.
+
+## 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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/lisa-wiki-cursor/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/plugins/lisa-wiki-cursor/templates/wrapper-gitignore.txt

@@ -0,0 +1,19 @@
+# BEGIN: AI GUARDRAILS WIKI
+# Managed by the lisa-wiki kernel. Do not edit between these markers — re-run
+# /lisa-wiki:setup (or the equivalent script) to update. Patterns outside the
+# block are preserved untouched. The "WIKI" suffix lets this block coexist
+# with the base lisa plugin's "# BEGIN: AI GUARDRAILS" block when both are
+# installed (the copy-contents strategy keys on the marker suffix).
+
+# Claude Code per-session git worktrees. Each Claude session that needs an
+# isolated working copy spawns one under .claude/worktrees/ (via
+# `git worktree add`). They are transient, large (often hundreds of MB each),
+# and per-developer; they must never be committed.
+/.claude/worktrees/
+
+# Codex CLI per-session worktrees (Codex equivalent of the above).
+/.codex/worktrees/
+
+# Lisa backup snapshots (created by `lisa` runs).
+/.lisabak/
+# END: AI GUARDRAILS WIKI

package/scripts/build-plugins.sh

@@ -43,17 +43,19 @@ build_plugin() {
   echo "Built plugins/$out_name (v$VERSION)"
 }
 
-# Generate a Pattern B per-agent variant for the base plugin only.
-# Variants are derived from the built Claude artifact at plugins/lisa/
-# and land at plugins/lisa-<agent>/.
+# Generate a Pattern B per-agent variant for a built plugin.
+# Variants are derived from a built Claude artifact at plugins/<src_name>/
+# and land at plugins/<out_name>/.
 build_per_agent_variant() {
   local agent="$1"
-  local src="$PLUGINS_DIR/lisa"
+  local src_name="$2"
+  local out_name="$3"
+  local src="$PLUGINS_DIR/$src_name"
   if [ ! -d "$src" ]; then
-    echo "Skipping per-agent variant lisa-$agent (no plugins/lisa source)"
+    echo "Skipping per-agent variant $out_name (no plugins/$src_name source)"
     return 0
   fi
-  local out="$PLUGINS_DIR/lisa-$agent"
+  local out="$PLUGINS_DIR/$out_name"
   node "$ROOT_DIR/scripts/generate-${agent}-plugin-artifacts.mjs" "$src" "$out" "$VERSION"
 }
 
@@ -72,12 +74,27 @@ for name in "${STANDALONE[@]}"; do
   build_plugin "$name" "lisa-$name"
 done
 
-# Pattern B per-agent variants of the base Lisa plugin.
-# Codex is NOT generated as a separate plugins/lisa-codex/ artifact — Codex
-# reads .codex-plugin/plugin.json from plugins/lisa/ directly (the existing
-# dual-pointer pattern, preserved per
+# Pattern B per-agent variants. Codex is NOT generated as a separate
+# plugins/lisa-codex/ artifact — Codex reads .codex-plugin/plugin.json from the
+# Claude artifact directly (the existing dual-pointer pattern, preserved per
 # wiki/architecture/pattern-b-fan-out-spec.md).
+#
+# Fan out EVERY built Claude plugin (base + every stack + standalones) to each
+# per-agent runtime so cursor/agy/copilot reach parity with Claude/Codex on
+# stack-specific functionality, not just the base governance plugin. The base
+# keeps its short name `lisa-<agent>`; every other plugin becomes
+# `<plugin>-<agent>` (e.g. lisa-typescript-cursor).
 PER_AGENT_VARIANTS=(cursor agy copilot)
+FANOUT_SOURCES=(lisa)
+for stack in "${STACKS[@]}"; do FANOUT_SOURCES+=("lisa-$stack"); done
+for name in "${STANDALONE[@]}"; do FANOUT_SOURCES+=("lisa-$name"); done
 for agent in "${PER_AGENT_VARIANTS[@]}"; do
-  build_per_agent_variant "$agent"
+  for src_name in "${FANOUT_SOURCES[@]}"; do
+    if [ "$src_name" = "lisa" ]; then
+      out_name="lisa-$agent"
+    else
+      out_name="$src_name-$agent"
+    fi
+    build_per_agent_variant "$agent" "$src_name" "$out_name"
+  done
 done