@codyswann/lisa 2.178.6 → 2.179.0

package/eslint-plugin-phaser/rules/require-shutdown-cleanup.js

@@ -0,0 +1,191 @@
+/**
+ * This file is managed by Lisa.
+ * Do not edit directly — changes will be overwritten on the next `lisa` run.
+ */
+
+/**
+ * ESLint rule: require-shutdown-cleanup
+ *
+ * A Phaser Scene is reused across restarts, and listeners registered on objects
+ * that OUTLIVE the scene (this.input, this.scale, this.game.events, window,
+ * document) are NOT auto-removed on shutdown — they leak and double-fire after a
+ * restart. (Listeners on this.events are auto-cleaned, so they're exempt.)
+ *
+ * This rule flags a class that registers such a persistent external listener but
+ * provides no cleanup path. Cleanup is satisfied by EITHER:
+ * - a `shutdown()` method on the class, OR
+ * - a `this.events.once('shutdown', ...)` / `Phaser.Scenes.Events.SHUTDOWN`
+ *   handler registered in the class.
+ * @module eslint-plugin-phaser/rules/require-shutdown-cleanup
+ */
+
+/**
+ * Resolve a property/method key node to its string name.
+ * @param {object} key - An Identifier or Literal key node
+ * @returns {string|null} The key name, or null if not resolvable
+ */
+function keyName(key) {
+  if (!key) return null;
+  if (key.type === "Identifier") return key.name;
+  if (key.type === "Literal") return String(key.value);
+  return null;
+}
+
+/**
+ * Decode a MemberExpression chain into its root node and ordered property names.
+ * @param {object} node - A MemberExpression node
+ * @returns {{root: object, props: (string|null)[]}} Root node and property names
+ */
+function memberInfo(node) {
+  const props = [];
+  /**
+   * Walk up the member chain, collecting property names.
+   * @param {object} cur - Current node in the chain
+   * @returns {object} The non-member root node
+   */
+  const walk = cur => {
+    if (cur && cur.type === "MemberExpression") {
+      props.unshift(
+        cur.property && cur.property.type === "Identifier"
+          ? cur.property.name
+          : null
+      );
+      return walk(cur.object);
+    }
+    return cur;
+  };
+  return { root: walk(node), props };
+}
+
+/**
+ * Whether a call registers a listener on an emitter that outlives the scene.
+ * @param {object} node - A CallExpression node
+ * @returns {boolean} True for a persistent external listener registration
+ */
+function isLeakyListener(node) {
+  if (node.callee.type !== "MemberExpression") return false;
+  const method =
+    node.callee.property.type === "Identifier"
+      ? node.callee.property.name
+      : null;
+  // window/document/globalThis.addEventListener — external, outlives the scene.
+  if (method === "addEventListener") {
+    const obj = node.callee.object;
+    return (
+      obj.type === "Identifier" &&
+      (obj.name === "window" ||
+        obj.name === "document" ||
+        obj.name === "globalThis")
+    );
+  }
+  if (method !== "on") return false;
+  const { root, props } = memberInfo(node.callee);
+  if (root.type !== "ThisExpression") return false;
+  // this.input(.keyboard|.gamepad|.mouse)?.on(...) and this.scale.on(...)
+  if (props[0] === "input" || props[0] === "scale") return true;
+  // this.game.events.on(...) — the global game emitter.
+  if (props[0] === "game" && props[1] === "events") return true;
+  return false;
+}
+
+/**
+ * Whether a call registers a scene 'shutdown' handler (in-place cleanup).
+ * @param {object} node - A CallExpression node
+ * @returns {boolean} True for this.events.on/once('shutdown'|SHUTDOWN, ...)
+ */
+function isShutdownHandler(node) {
+  if (node.callee.type !== "MemberExpression") return false;
+  const method =
+    node.callee.property.type === "Identifier"
+      ? node.callee.property.name
+      : null;
+  if (method !== "on" && method !== "once") return false;
+  const { root, props } = memberInfo(node.callee);
+  if (root.type !== "ThisExpression" || props[0] !== "events") return false;
+  const arg = node.arguments[0];
+  if (!arg) return false;
+  if (arg.type === "Literal" && arg.value === "shutdown") return true;
+  // Phaser.Scenes.Events.SHUTDOWN
+  if (arg.type === "MemberExpression" && arg.property.type === "Identifier") {
+    return arg.property.name === "SHUTDOWN";
+  }
+  return false;
+}
+
+/**
+ * Whether a class body declares a `shutdown` method or field.
+ * @param {object} classNode - A ClassDeclaration/ClassExpression node
+ * @returns {boolean} True if a `shutdown` member exists
+ */
+function hasShutdownMember(classNode) {
+  return classNode.body.body.some(
+    el =>
+      (el.type === "MethodDefinition" || el.type === "PropertyDefinition") &&
+      keyName(el.key) === "shutdown"
+  );
+}
+
+module.exports = {
+  meta: {
+    type: "problem",
+    docs: {
+      description:
+        "Require a shutdown cleanup path when a Scene registers persistent external listeners",
+      category: "Best Practices",
+      recommended: true,
+    },
+    fixable: null,
+    schema: [],
+    messages: {
+      requireShutdown:
+        "This Scene registers a persistent external listener (this.input/scale/game.events or window/document) but has no cleanup. Add a shutdown() method, or this.events.once('shutdown', () => ...), and .off() every listener there — they are not auto-removed and will leak across scene restarts.",
+    },
+  },
+
+  create(context) {
+    const classStack = [];
+
+    /**
+     * Push class scope state on entry.
+     * @param {object} node - The class node being entered
+     * @returns {void}
+     */
+    const enterClass = node =>
+      classStack.push({
+        node,
+        leaky: [],
+        hasShutdown: hasShutdownMember(node),
+      });
+
+    /**
+     * Report uncleaned listeners on class exit.
+     * @returns {void}
+     */
+    const exitClass = () => {
+      const frame = classStack.pop();
+      if (!frame.hasShutdown && frame.leaky.length > 0) {
+        for (const leakyNode of frame.leaky) {
+          context.report({ node: leakyNode, messageId: "requireShutdown" });
+        }
+      }
+    };
+
+    return {
+      ClassDeclaration: enterClass,
+      ClassExpression: enterClass,
+      "ClassDeclaration:exit": exitClass,
+      "ClassExpression:exit": exitClass,
+      CallExpression(node) {
+        if (classStack.length === 0) return;
+        const frame = classStack[classStack.length - 1];
+        if (isShutdownHandler(node)) {
+          frame.hasShutdown = true;
+          return;
+        }
+        if (isLeakyListener(node)) {
+          frame.leaky.push(node);
+        }
+      },
+    };
+  },
+};

package/package.json

@@ -43,7 +43,8 @@
   "workspaces": [
     "eslint-plugin-code-organization",
     "eslint-plugin-component-structure",
-    "eslint-plugin-ui-standards"
+    "eslint-plugin-ui-standards",
+    "eslint-plugin-phaser"
   ],
   "files": [
     "dist",
@@ -63,7 +64,8 @@
     ".claude-plugin",
     "eslint-plugin-code-organization",
     "eslint-plugin-component-structure",
-    "eslint-plugin-ui-standards"
+    "eslint-plugin-ui-standards",
+    "eslint-plugin-phaser"
   ],
   "trustedDependencies": [
     "@ast-grep/cli",
@@ -91,7 +93,7 @@
     "ws": ">=8.20.1"
   },
   "name": "@codyswann/lisa",
-  "version": "2.178.6",
+  "version": "2.179.0",
   "description": "Claude Code governance framework that applies guardrails, guidance, and automated enforcement to projects",
   "main": "dist/index.js",
   "exports": {

package/phaser/package-lisa/package.lisa.json

@@ -64,13 +64,21 @@
     "scripts": {
       "dev": "vite",
       "build": "vite build",
-      "preview": "vite preview"
+      "preview": "vite preview",
+      "test:e2e": "playwright test",
+      "size": "size-limit"
     },
     "dependencies": {
-      "phaser": "^4.1.0"
+      "phaser": "^4.2.0"
     },
     "devDependencies": {
-      "vite": "^6.3.1"
+      "vite": "^8.0.0",
+      "vite-plugin-pwa": "^1.3.0",
+      "@playwright/test": "^1.56.1",
+      "free-tex-packer-core": "^0.3.8",
+      "audiosprite": "^0.7.2",
+      "size-limit": "^12.1.0",
+      "@size-limit/preset-app": "^12.1.0"
     }
   },
   "remove": {

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "description": "AWS CDK-specific plugin",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa",
-  "version": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.0",
   "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": "2.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.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.178.6",
+  "version": "2.179.0",
   "description": "Phaser 4 game-development rules for TypeScript projects",
   "author": {
     "name": "Cody Swann"