@codyswann/lisa 2.262.0 → 2.263.0

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "2.262.0",
+  "version": "2.263.0",
   "description": "Harper/Fabric-specific 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.262.0",
+  "version": "2.263.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.262.0",
+  "version": "2.263.0",
   "description": "NestJS-specific skills and migration write-protection hooks.",
   "author": {
     "name": "Cody Swann"

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

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

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

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.262.0",
+  "version": "2.263.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.262.0",
+  "version": "2.263.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-openclaw-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.262.0",
+  "version": "2.263.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-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.262.0",
+  "version": "2.263.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-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.262.0",
+  "version": "2.263.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-phaser/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "2.262.0",
+  "version": "2.263.0",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "2.262.0",
+  "version": "2.263.0",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-phaser-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "2.262.0",
+  "version": "2.263.0",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "2.262.0",
+  "version": "2.263.0",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-phaser",
-  "version": "2.262.0",
+  "version": "2.263.0",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "2.262.0",
+  "version": "2.263.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.262.0",
+  "version": "2.263.0",
   "description": "Ruby on Rails-specific skills and hooks for RuboCop and ast-grep scanning on edit.",
   "author": {
     "name": "Cody Swann"

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

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "2.262.0",
+  "version": "2.263.0",
   "description": "Ruby on Rails-specific hooks — RuboCop linting/formatting 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.262.0",
+  "version": "2.263.0",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
   "author": {
     "name": "Cody Swann"

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

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

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

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

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

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.262.0",
+  "version": "2.263.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.262.0",
+  "version": "2.263.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-agy/plugin.json

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

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

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

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

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

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

@@ -181,6 +181,7 @@ fi
 | `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. |
 | `projectRulesFile` | no | `.claude/rules/PROJECT_RULES.md` | Safe repo-relative Markdown path for hand-authored project rules. Independent of the learnings ledger — relocating the rules file never moves the ledger. |
 | `learnings.file` | no | `.lisa/PROJECT_LEARNINGS.md` | Safe repo-relative Markdown path for the machine-managed learnings ledger, overriding the `.lisa/` default. Rejected if it resolves inside any auto-loaded rules tree (`.claude/rules`, `.cursor/rules`, `.github/instructions`, `.agents/rules`) — the ledger must stay out of eager context. |
+| `health.schedule` | no | `off` | Health cadence contract: `off`, `daily`, or `weekly`. `lisa sync` populates the default with `_lisaSync.populated` provenance and rejects values outside this closed vocabulary. Runtime results live only at the gitignored `.lisa/health/latest.json`, never in either config file. |
 | `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. |
 | `wiki` | no | — | Wiki location for the `wiki-knowledge-source` rule. Omit for a local in-repo wiki (`wiki/`). See **Wiki source** below. |
 

package/scripts/verify-health-contract-built.mjs

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+/** Empirical proof for the shipped Health v1 contract and real built CLI. */
+import assert from "node:assert/strict";
+import { execFileSync } from "node:child_process";
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+
+let assertions = 0;
+const check = (condition, message) => {
+  assertions += 1;
+  assert.ok(condition, message);
+};
+const equal = (actual, expected, message) => {
+  assertions += 1;
+  assert.deepEqual(actual, expected, message);
+};
+
+const root = process.cwd();
+const project = await mkdtemp(path.join(tmpdir(), "lisa-health-built-"));
+try {
+  await writeFile(
+    path.join(project, ".lisa.config.json"),
+    `${JSON.stringify({ tracker: "github", github: { org: "acme", repo: "app" } }, null, 2)}\n`
+  );
+  execFileSync(
+    process.execPath,
+    [path.join(root, "dist/index.js"), "sync", project, "--json"],
+    {
+      cwd: root,
+      env: { ...process.env, LISA_SKIP_UPDATE_CHECK: "1" },
+      stdio: ["ignore", "pipe", "pipe"],
+    }
+  );
+  const config = JSON.parse(
+    await readFile(path.join(project, ".lisa.config.json"), "utf8")
+  );
+  equal(
+    config.health,
+    { schedule: "off" },
+    "sync populates only health.schedule"
+  );
+  equal(
+    config._lisaSync.populated["health.schedule"],
+    "off",
+    "sync records literal health.schedule provenance"
+  );
+  check(
+    config.health.latest === undefined,
+    "runtime health state stays out of config"
+  );
+  console.log("[EVIDENCE: health-v1-built-sync]");
+
+  const health = await import("@codyswann/lisa/health");
+  const deterministicFindings = [
+    {
+      check: "config.sync",
+      layer: "deterministic",
+      status: "warn",
+      reason: "A configuration advisory needs operator review.",
+    },
+  ];
+  const deterministic = health.validateHealthResult({
+    schemaVersion: 1,
+    runId: "health-run-new",
+    mode: "deterministic",
+    startedAt: "2026-07-20T12:00:00.000Z",
+    completedAt: "2026-07-20T12:01:00.000Z",
+    findings: deterministicFindings,
+    summary: health.summarizeHealthFindings(deterministicFindings),
+  });
+  equal(deterministic.summary.counts, { pass: 0, warn: 1, fail: 0 });
+  equal(deterministic.summary.verdict, "in band");
+  const fullFindings = [
+    {
+      check: "config.sync",
+      layer: "deterministic",
+      status: "pass",
+      reason: "Configuration is synchronized.",
+    },
+    {
+      check: "agent.review",
+      layer: "agentic",
+      status: "fail",
+      reason: "The agent review found actionable drift.",
+    },
+  ];
+  const full = health.validateHealthResult({
+    schemaVersion: 1,
+    runId: "health-run-full",
+    mode: "full",
+    startedAt: "2026-07-20T12:02:00.000Z",
+    completedAt: "2026-07-20T12:03:00.000Z",
+    findings: fullFindings,
+    summary: health.summarizeHealthFindings(fullFindings),
+  });
+  equal(full.summary.counts, { pass: 1, warn: 0, fail: 1 });
+  equal(full.summary.verdict, "drift detected");
+  check(
+    Object.isFrozen(full) && Object.isFrozen(full.findings),
+    "result is frozen"
+  );
+  console.log("[EVIDENCE: health-v1-built-contract]");
+
+  const neverRunProject = await mkdtemp(
+    path.join(tmpdir(), "lisa-health-never-")
+  );
+  try {
+    equal(await health.readLatestHealthResult(neverRunProject), {
+      status: "never-run",
+    });
+  } finally {
+    await rm(neverRunProject, { recursive: true, force: true });
+  }
+  equal(
+    (await health.writeLatestHealthResult(project, deterministic)).status,
+    "written"
+  );
+  equal(
+    (await health.writeLatestHealthResult(project, full)).status,
+    "written"
+  );
+  equal(
+    (await health.writeLatestHealthResult(project, deterministic)).status,
+    "unchanged"
+  );
+  const available = await health.readLatestHealthResult(project);
+  equal(available.status, "available");
+  equal(available.lastRun, full.completedAt);
+
+  await writeFile(path.join(project, ".lisa/health/latest.json"), "{malformed");
+  equal((await health.readLatestHealthResult(project)).status, "unreadable");
+  await writeFile(
+    path.join(project, ".lisa/health/latest.json"),
+    JSON.stringify({ ...full, schemaVersion: 2 })
+  );
+  equal((await health.readLatestHealthResult(project)).status, "unreadable");
+  console.log("[EVIDENCE: health-v1-built-storage]");
+  check(assertions > 0, "proof must execute assertions");
+  console.log(`health-v1 assertions=${assertions}`);
+} finally {
+  await rm(project, { recursive: true, force: true });
+}

package/ui/README.md

@@ -126,9 +126,14 @@ product features, secrets, or business logic is never proposed.
 When the engine lands, `starter.*` should join the `lisa sync` registry so
 the section above governs it like every other setting.
 
-## Health (planned — documented, not wired)
-
-The **Health** section answers two questions with different lifecycles:
+## Health (v1 contract available; consumers planned)
+
+The **Health** section answers two questions with different lifecycles. Health
+v1 now defines its shared result and persistence contract at
+`@codyswann/lisa/health`: completed results are validated and atomically stored
+at the gitignored `.lisa/health/latest.json`; `health.schedule` is the only v1
+configuration key and accepts `off`, `daily`, or `weekly`. The button, probes,
+console readback, and scheduler remain downstream work.
 
 **Is Lisa on the latest version?** — always-on status. Lisa's CLI already
 checks npm on every invocation; the console surfaces the result permanently