@codyswann/lisa 4.17.0 → 4.17.2

package/expo/copy-overwrite/scripts/check-lighthouse-details.mjs

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+// This file is managed by Lisa and IS replaced on each `lisa` run.
+// Do not edit directly — durable changes belong upstream in Lisa.
+
+/**
+ * Enforce performance budgets whose measurements Lighthouse CI cannot assert.
+ *
+ * `forced-reflow-insight` exposes its useful duration only in a nested detail
+ * table. Its score is effectively binary, so a score floor makes unchanged
+ * pages alternate between green and red as runner timing changes. LHCI writes
+ * the measurement into each LHR; this checker applies a real millisecond
+ * ceiling to every collected run.
+ * @module scripts/check-lighthouse-details
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+
+const AUDIT_ID = "forced-reflow-insight";
+const CONFIG_FILE = "lighthouserc-config.json";
+const REPORT_DIRECTORY = ".lighthouseci";
+const REPORT_PATTERN = /^lhr-.*\.json$/;
+const DEFAULT_MAX_FORCED_REFLOW_MS = 100;
+
+/**
+ * Read the bottom-up aggregate table from one forced-reflow audit.
+ * Lighthouse may prepend a top-level-function table derived from the same
+ * events, then appends the bottom-up aggregate. Summing every nested table
+ * would count those events twice.
+ * @param {unknown} details - Forced-reflow audit details
+ * @returns {number[]} Per-source aggregate measurements
+ */
+function readAggregateMeasurements(details) {
+  if (details === null || typeof details !== "object") {
+    return [];
+  }
+  const tables =
+    details.type === "table"
+      ? [details]
+      : Array.isArray(details.items)
+        ? details.items.filter(
+            item =>
+              item !== null && typeof item === "object" && item.type === "table"
+          )
+        : [];
+  const aggregate = tables.at(-1);
+  if (!aggregate || !Array.isArray(aggregate.items)) {
+    return [];
+  }
+  return aggregate.items.map((item, index) => {
+    const measurement = item?.reflowTime;
+    if (typeof measurement !== "number" || !Number.isFinite(measurement)) {
+      throw new Error(
+        `forced-reflow aggregate row ${index + 1} has no finite reflowTime`
+      );
+    }
+    return measurement;
+  });
+}
+
+/**
+ * Read the host threshold, falling back to Lisa's shipped default.
+ * @param {string} projectRoot - Host project root
+ * @returns {number} Maximum forced-reflow duration per Lighthouse run
+ */
+function readMaximum(projectRoot) {
+  const configPath = path.join(projectRoot, CONFIG_FILE);
+  if (!fs.existsSync(configPath)) {
+    return DEFAULT_MAX_FORCED_REFLOW_MS;
+  }
+  let config;
+  try {
+    config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+  } catch (error) {
+    throw new Error(
+      `${CONFIG_FILE} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  const configured =
+    config?.assertions?.forcedReflowInsight?.maxNumericValue ??
+    DEFAULT_MAX_FORCED_REFLOW_MS;
+  if (
+    typeof configured !== "number" ||
+    !Number.isFinite(configured) ||
+    configured < 0
+  ) {
+    throw new Error(
+      `${CONFIG_FILE} assertions.forcedReflowInsight.maxNumericValue must be a finite number at least 0`
+    );
+  }
+  return configured;
+}
+
+/**
+ * Load one Lighthouse result without allowing malformed evidence to pass.
+ * @param {string} reportPath - LHR path
+ * @returns {Record<string, unknown>} Parsed LHR
+ */
+function readReport(reportPath) {
+  try {
+    return JSON.parse(fs.readFileSync(reportPath, "utf8"));
+  } catch (error) {
+    throw new Error(
+      `${path.basename(reportPath)} is not a valid Lighthouse result: ${
+        error instanceof Error ? error.message : String(error)
+      }`
+    );
+  }
+}
+
+/** Run the detail budget against the current project. */
+function main() {
+  const projectRoot = process.cwd();
+  const maximum = readMaximum(projectRoot);
+  const reportDirectory = path.join(projectRoot, REPORT_DIRECTORY);
+  if (!fs.existsSync(reportDirectory)) {
+    throw new Error(
+      `${REPORT_DIRECTORY} is missing; Lighthouse produced no evidence`
+    );
+  }
+  const reportPaths = fs
+    .readdirSync(reportDirectory)
+    .filter(file => REPORT_PATTERN.test(file))
+    .sort()
+    .map(file => path.join(reportDirectory, file));
+  if (reportPaths.length === 0) {
+    throw new Error(`${REPORT_DIRECTORY} contains no Lighthouse result JSON`);
+  }
+
+  const failures = [];
+  let observedMaximum = 0;
+  for (const reportPath of reportPaths) {
+    const report = readReport(reportPath);
+    const audit = report?.audits?.[AUDIT_ID];
+    if (audit === null || typeof audit !== "object") {
+      failures.push(`${path.basename(reportPath)}: missing ${AUDIT_ID} audit`);
+      continue;
+    }
+    let measurements;
+    try {
+      measurements = readAggregateMeasurements(audit.details);
+    } catch (error) {
+      failures.push(
+        `${path.basename(reportPath)}: ${error instanceof Error ? error.message : String(error)}`
+      );
+      continue;
+    }
+    if (audit.score === 0 && measurements.length === 0) {
+      failures.push(
+        `${path.basename(reportPath)}: ${AUDIT_ID} failed without measurable reflowTime evidence`
+      );
+      continue;
+    }
+    const total = measurements.reduce(
+      (sum, measurement) => sum + measurement,
+      0
+    );
+    observedMaximum = Math.max(observedMaximum, total);
+    if (total > maximum) {
+      failures.push(
+        `${report.finalUrl ?? path.basename(reportPath)}: ${total.toFixed(1)} ms exceeds ${maximum} ms`
+      );
+    }
+  }
+
+  if (failures.length > 0) {
+    throw new Error(
+      `forced-reflow detail budget failed:\n${failures.map(failure => `- ${failure}`).join("\n")}`
+    );
+  }
+  console.log(
+    `lighthouse detail budget passed: ${reportPaths.length} report(s), forced reflow <= ${maximum} ms (max ${observedMaximum.toFixed(1)} ms)`
+  );
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(
+    `lighthouse detail budget failed: ${error instanceof Error ? error.message : String(error)}`
+  );
+  process.exitCode = 1;
+}

package/expo/create-only/lighthouserc-config.json

@@ -28,6 +28,7 @@
     "legacyJavascriptInsight": { "minScore": 0.4 },
     "speedIndex": { "minScore": 0.9 },
     "networkDependencyTreeInsight": { "minScore": 0.9 },
-    "duplicatedJavascriptInsight": { "minScore": 0.9 }
+    "duplicatedJavascriptInsight": { "minScore": 0.9 },
+    "forcedReflowInsight": { "maxNumericValue": 100 }
   }
 }

package/expo/create-only/lighthouserc.js

@@ -76,6 +76,7 @@ const defaults = {
     speedIndex: { minScore: 0.9 },
     networkDependencyTreeInsight: { minScore: 0.9 },
     duplicatedJavascriptInsight: { minScore: 0.9 },
+    forcedReflowInsight: { maxNumericValue: 100 },
   },
 };
 
@@ -141,6 +142,7 @@ const handledKeys = new Set([
   "fontDisplayInsight",
   "networkDependencyTreeInsight",
   "duplicatedJavascriptInsight",
+  "forcedReflowInsight",
 ]);
 
 /**
@@ -283,6 +285,11 @@ module.exports = {
           "warn",
           assertionOptions(a.duplicatedJavascriptInsight),
         ],
+        // Lighthouse exposes forced-reflow duration only in a nested detail
+        // table, while the preset assertion sees an all-or-nothing score. The
+        // shipped detail-budget checker enforces the configured millisecond
+        // ceiling after LHCI writes its reports.
+        "forced-reflow-insight": "off",
 
         // Dynamic overrides for any extra config keys not handled above.
         // Projects can tune or disable any preset assertion by adding it

package/expo/package-lisa/package.lisa.json

@@ -2,7 +2,7 @@
   "force": {
     "scripts": {
       "setup:deploy-key": "setup-deploy-key",
-      "lighthouse:check": "lhci autorun --collect.settings.chromeFlags='--no-sandbox --disable-gpu --headless'",
+      "lighthouse:check": "lhci autorun --collect.settings.chromeFlags='--no-sandbox --disable-gpu --headless' --assert.assertions.forced-reflow-insight=off && node scripts/check-lighthouse-details.mjs",
       "playwright:build": "expo export --platform web",
       "playwright:test": "bun run playwright:build && playwright test",
       "playwright:test:ui": "bun run playwright:build && playwright test --ui",

package/package.json

@@ -152,7 +152,7 @@
     "zod-validation-error": "^4.0.0"
   },
   "name": "@codyswann/lisa",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
   "main": "dist/index.js",
   "exports": {

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Universal governance: agents, skills, commands, hooks, and rules for all projects.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "AWS CDK-specific plugin",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "AWS CDK-specific Lisa plugin.",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "AWS CDK-specific plugin",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "AWS CDK-specific plugin",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "AWS CDK-specific plugin",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Expo and React Native-specific skills, agents, rules, and MCP servers.",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
   "author": {
     "name": "Cody Swann"

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

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

package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json

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

package/plugins/lisa-harper-fabric-agy/plugin.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "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": "4.17.0",
+  "version": "4.17.2",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, ast-grep scanning, and error-suppression blocking on edit",
   "author": {
     "name": "Cody Swann"