@codyswann/lisa 2.121.1 → 2.123.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/plugins/src/expo/skills/directory-structure/SKILL.md

@@ -20,28 +20,40 @@ This skill ensures all new code follows the documented directory structure stand
 
 ## Root Directory Structure
 
+Expo SDK 55+/56 adopts the `/src` convention: all **application source** lives
+under `src/`, while config, assets, tests, and tooling stay at the project root.
+Older projects keep source at the root. The structure below shows the `/src`
+layout; for a root-layout project, read `src/<dir>` as `<dir>`. The `@/*`
+TypeScript path alias points at `./src/*` (or `./*` for root layout), so imports
+are identical either way. The validator and lint/coverage configs auto-detect a
+`src/` directory.
+
 ```
 <project-root>/
-├── app/                    # Expo Router - THIN WRAPPERS ONLY
-├── features/               # Feature modules - PRIMARY CODE LOCATION
-├── components/             # Shared components
-│   ├── ui/                 # GlueStack UI primitives
-│   ├── icons/              # Icon components
-│   ├── custom/             # Custom UI components
-│   └── [ComponentName]/    # Feature-agnostic components
-├── hooks/                  # Global hooks (with __tests__/)
-├── providers/              # Global React context providers (with __tests__/)
-├── stores/                 # Global state - Apollo reactive variables (with __tests__/)
-├── utils/                  # Utility functions (with __tests__/)
-├── types/                  # Global TypeScript types
-├── generated/              # Auto-generated GraphQL types (DO NOT EDIT)
-├── config/                 # Configuration files
-├── constants/              # Global constants
-├── assets/                 # Static assets (fonts/, icons/, css/)
-├── e2e/                    # End-to-end tests (fixtures/, pages/, tests/, utils/)
-├── scripts/                # Build and development scripts
-├── docs/                   # Documentation
-└── projects/               # Project-specific files (archive/)
+├── src/                    # APPLICATION SOURCE (SDK 55+/56 /src convention)
+│   ├── app/                # Expo Router - THIN WRAPPERS ONLY
+│   ├── features/           # Feature modules - PRIMARY CODE LOCATION
+│   ├── components/         # Shared components
+│   │   ├── ui/             # GlueStack UI primitives
+│   │   ├── icons/          # Icon components
+│   │   ├── custom/         # Custom UI components
+│   │   └── [ComponentName]/ # Feature-agnostic components
+│   ├── hooks/              # Global hooks (with __tests__/)
+│   ├── providers/          # Global React context providers (with __tests__/)
+│   ├── stores/             # Global state - Apollo reactive variables (with __tests__/)
+│   ├── utils/              # Utility functions (with __tests__/)
+│   ├── lib/                # Utility libraries / integrations
+│   ├── types/              # Global TypeScript types
+│   ├── generated/          # Auto-generated GraphQL types (DO NOT EDIT)
+│   ├── config/             # Configuration files
+│   └── constants/          # Global constants
+├── assets/                 # Static assets (fonts/, icons/, css/) — STAYS AT ROOT
+├── e2e/                    # End-to-end tests (fixtures/, pages/, tests/, utils/) — STAYS AT ROOT
+├── scripts/                # Build and development scripts — STAYS AT ROOT
+├── public/                 # Public web assets — STAYS AT ROOT
+├── __mocks__/              # Jest manual mocks — STAYS AT ROOT
+├── docs/                   # Documentation — STAYS AT ROOT
+└── projects/               # Project-specific files (archive/) — STAYS AT ROOT
 ```
 
 ## Feature Module Structure

package/plugins/src/expo/skills/directory-structure/scripts/validate_structure.py

@@ -298,8 +298,12 @@ def validate_naming_conventions(root: Path) -> List[ValidationResult]:
     """Validate file and directory naming conventions."""
     results = []
 
+    # Source lives under src/ for projects on the Expo SDK 55+/56 /src
+    # convention; fall back to the project root otherwise.
+    source_root = root / 'src' if (root / 'src').is_dir() else root
+
     # Feature directory names should be kebab-case
-    features_dir = root / 'features'
+    features_dir = source_root / 'features'
     if features_dir.exists():
         kebab_pattern = re.compile(r'^[a-z][a-z0-9]*(-[a-z0-9]+)*$')
         for item in features_dir.iterdir():
@@ -308,7 +312,7 @@ def validate_naming_conventions(root: Path) -> List[ValidationResult]:
                     results.append(ValidationResult(
                         passed=False,
                         message=f"Feature directory not in kebab-case",
-                        file_path=f"features/{item.name}",
+                        file_path=str(item.relative_to(root)),
                         suggestion=f"Rename to kebab-case (e.g., 'my-feature')"
                     ))
 
@@ -330,7 +334,7 @@ def validate_naming_conventions(root: Path) -> List[ValidationResult]:
                     ))
 
     # Check components directory (skip special subdirectories)
-    components_dir = root / 'components'
+    components_dir = source_root / 'components'
     if components_dir.exists():
         for item in components_dir.iterdir():
             # Skip special directories that are allowed to be lowercase
@@ -361,22 +365,27 @@ def run_validation(path: Path) -> ValidationReport:
     report = ValidationReport()
     root = find_project_root(path)
 
+    # Source lives under src/ for projects on the Expo SDK 55+/56 /src
+    # convention; fall back to the project root otherwise. relative_to(root)
+    # is still used for display so reported paths read as src/...
+    source_root = root / 'src' if (root / 'src').is_dir() else root
+
     print(f"Validating directory structure from: {root}\n")
 
     # Run all validations
     report.errors.extend(validate_test_file_placement(root))
     report.errors.extend(validate_naming_conventions(root))
-    report.errors.extend(validate_app_directory(root / 'app', root))
+    report.errors.extend(validate_app_directory(source_root / 'app', root))
 
     # Validate features
-    features_dir = root / 'features'
+    features_dir = source_root / 'features'
     if features_dir.exists():
         for feature in features_dir.iterdir():
             if feature.is_dir() and not feature.name.startswith('.'):
                 report.errors.extend(validate_feature_structure(feature, root))
 
     # Validate global components
-    components_dir = root / 'components'
+    components_dir = source_root / 'components'
     if components_dir.exists():
         for item in components_dir.iterdir():
             # Skip ui/, icons/, custom/ as they have different structure

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

package/typescript/copy-overwrite/.prettierignore

@@ -13,6 +13,7 @@ graphql
 generated
 public
 components/ui/
+src/components/ui/
 playwright-report/
 AGENTS.md
 CHANGELOG.md

package/typescript/copy-overwrite/eslint.ignore.config.json

@@ -20,6 +20,7 @@
     "graphql-generated/**",
     "generated/**",
     "components/ui/**",
+    "src/components/ui/**",
 
     "**/k6/**/*.js",
 
@@ -72,6 +73,7 @@
     "scripts/**",
 
     "lib/**/*.js",
+    "src/lib/**/*.js",
     "cdk.out/**",
 
     "audit.ignore.config.json",