@codyswann/lisa 4.57.1 → 4.57.3

package/expo/copy-overwrite/scripts/classify-maestro-failures.mjs

@@ -626,7 +626,7 @@ function countOccurrences(haystack, needle) {
 
 /**
  * Tally every marker across a run's debug artifacts, per flow.
- * @param {readonly {path: string, text: string}[]} artifacts - Debug artifacts
+ * @param {Iterable<{path: string, text: string}>} artifacts - Debug artifacts, iterated once
  * @param {readonly {flow: string, keys: readonly string[]}[]} flowKeys - Flows in the report
  * @param {readonly string[]} markers - Markers to count
  * @returns {{perFlow: Map<string, object>, unattributed: object}} Tallies
@@ -723,20 +723,72 @@ export function deviceVerdict(tallies, baselines, markers) {
  * Absence is normal and silent: a run that crashed before Maestro started, or a
  * caller that has not wired the flag, simply yields no evidence — and with no
  * evidence nothing is ever a device fault.
+ *
+ * LAZY, and that is load-bearing rather than a micro-optimisation. This used to
+ * build an array holding every file's text at once. A real iOS debug tree is
+ * 3.5 GB across 540 files — `device-simulator.log` alone reaches 235 MB for a
+ * single flow — so the array exhausted the V8 heap and the classifier died with
+ * `FATAL ERROR: Reached heap limit` inside `fs.readFileSync`. Measured on a
+ * 44-flow iOS leg, 2026-09-11.
+ *
+ * That crash was invisible: the workflow used `|| true` and `exit 0`
+ * so the classifier could never fail the job — deliberately, and the
+ * suite beside this file pins that — and the docblock above says absence of
+ * evidence is normal. So an OOM produces exactly the observable of a run with
+ * nothing to classify. On the measured run, the leg's ONE failure was a
+ * simulator launch failure — precisely the device fault this classifier exists
+ * to name — and it went unnamed because the classifier had died.
+ *
+ * Yielding one artifact at a time caps peak memory at the largest single file
+ * instead of their sum, and each text becomes garbage as soon as
+ * {@link tallyDeviceMarkers} has counted it.
+ *
+ * The return is a RE-ITERABLE iterable, not a one-shot generator: `run()`
+ * computes this once and passes it through `classifyRun` for every report, so a
+ * generator would be empty for the second report onward — a silent
+ * evidence-loss bug in place of a loud crash, which would be worse than what it
+ * replaced.
  * @param {string | null} debugRoot - Absolute path of the debug-output directory
  * @param {{listFiles: Function, readFile: Function}} io - Injected readers
- * @returns {{path: string, text: string}[]} Artifacts
+ * @returns {Iterable<{path: string, text: string}>} Artifacts, read on demand
  */
 export function readDebugArtifacts(debugRoot, { listFiles, readFile }) {
   if (!debugRoot) return [];
-  const artifacts = [];
-  for (const file of listFiles(debugRoot) ?? []) {
-    if (isOpaque(file)) continue;
-    const text = readFile(file);
-    if (text === null) continue;
-    artifacts.push({ path: file, text });
-  }
-  return artifacts;
+  return {
+    *[Symbol.iterator]() {
+      for (const file of listFiles(debugRoot) ?? []) {
+        if (isOpaque(file)) continue;
+        const text = readFile(file);
+        // `readFile` returns null for absent, unreadable AND too-large-to-
+        // string files alike. The last is the one that grows back into the bug
+        // above — Node refuses a string past its maximum length, and a
+        // device log that crosses it would drop out of the evidence silently.
+        if (text === null) {
+          reportUnreadableArtifact(file);
+          continue;
+        }
+        yield { path: file, text };
+      }
+    },
+  };
+}
+
+/**
+ * Say on stderr that an artifact could not be read.
+ *
+ * Not a throw: a missing or unreadable artifact must not fail the run, for the
+ * same reason the step absorbs a non-zero exit. But it must not be silent
+ * either — an artifact that drops out of the evidence takes its markers with
+ * it, and a device fault it alone witnessed then reads as a flow failure.
+ * stderr rather than the markdown, so it reaches the job log without becoming
+ * part of the classification that a consumer parses.
+ * @param {string} file - Path of the artifact that could not be read
+ */
+function reportUnreadableArtifact(file) {
+  process.stderr.write(
+    `classify-maestro-failures: could not read ${path.basename(file)} — ` +
+      `its markers are NOT counted in this classification.\n`
+  );
 }
 
 /**
@@ -869,7 +921,7 @@ function resolveFlowPath(reported, { projectRoot, maestroRoot, readFile }) {
  * @param {readonly string[]} [options.signInMarkers] - Project sign-in markers
  * @param {readonly unknown[]} [options.knownIntermittent] - Raw registry entries
  * @param {string} [options.platform] - Arm the report came from
- * @param {readonly {path: string, text: string}[]} [options.debugArtifacts] - Run observation
+ * @param {Iterable<{path: string, text: string}>} [options.debugArtifacts] - Run observation
  * @param {readonly string[]} [options.deviceFaultMarkers] - Presence-decided device faults
  * @param {readonly string[]} [options.deviceInstabilityMarkers] - Count-decided device faults
  * @returns {{failures: object[], deviceRunEvidence: object[]}} The report's verdict
@@ -1115,9 +1167,9 @@ export function loadConfig(projectRoot) {
 /**
  * Classify every named report against one project checkout.
  *
- * The debug-output tree is read ONCE and shared across the named reports: it is
- * the observation of a single run, and re-walking it per report would only cost
- * time. A retry arm writes into the same tree, which is correct — retries only
+ * The debug-output iterable is shared across the named reports. Each report
+ * reads it lazily so artifact text is not retained between reports.
+ * A retry arm writes into the same tree, which is correct — retries only
  * re-run flows that already failed, so its evidence is about those same flows.
  * @param {readonly string[]} reportPaths - Report paths
  * @param {{projectRoot: string, platform: string | null, debugRoot?: string | null}} context - Run context

package/package.json

@@ -187,7 +187,7 @@
     "zod-validation-error": "^4.0.0"
   },
   "name": "@codyswann/lisa",
-  "version": "4.57.1",
+  "version": "4.57.3",
   "description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
   "main": "dist/index.js",
   "exports": {
@@ -336,7 +336,7 @@
     "test": "tests"
   },
   "types": "./dist/index.d.ts",
-  "lisaReleaseCommit": "d37678626b85c4e09555a15d73ed7ac286722e04",
-  "gitHead": "d37678626b85c4e09555a15d73ed7ac286722e04",
-  "lisaReleaseTag": "v4.57.1"
+  "lisaReleaseCommit": "3fed4f391b9a6f13a80fcd6c11cb5c16837269c9",
+  "gitHead": "3fed4f391b9a6f13a80fcd6c11cb5c16837269c9",
+  "lisaReleaseTag": "v4.57.3"
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "4.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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.57.1",
+  "version": "4.57.3",
   "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": "4.57.1",
+  "version": "4.57.3",
   "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": "4.57.1",
+  "version": "4.57.3",
   "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": "4.57.1",
+  "version": "4.57.3",
   "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": "4.57.1",
+  "version": "4.57.3",
   "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": "4.57.1",
+  "version": "4.57.3",
   "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": "4.57.1",
+  "version": "4.57.3",
   "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": "4.57.1",
+  "version": "4.57.3",
   "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"