@codyswann/lisa 2.93.0 → 2.95.0

package/plugins/lisa/scripts/queue-health-classification.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+/**
+ * Shared queue-health classification helpers for `/lisa:queue-status`.
+ *
+ * Queue readers normalize vendor-specific lifecycle data into the small set of
+ * signals below so queue-status can distinguish quiet, healthy, stuck, and
+ * misconfigured queues without inventing a second lifecycle vocabulary.
+ */
+
+export const QUEUE_HEALTH_VERDICTS = [
+  "IDLE",
+  "HEALTHY",
+  "ATTENTION_NEEDED",
+  "MISCONFIGURED",
+];
+
+/**
+ * @typedef {"IDLE" | "HEALTHY" | "ATTENTION_NEEDED" | "MISCONFIGURED"} QueueHealthVerdict
+ *
+ * @typedef {{
+ *   readonly queueResolved?: boolean
+ *   readonly namespaceAdopted?: boolean
+ *   readonly readyCount?: number
+ *   readonly activeCount?: number
+ *   readonly blockedCount?: number
+ *   readonly stalledCount?: number
+ *   readonly resolutionError?: string | null
+ * }} QueueHealthInput
+ */
+
+/**
+ * Classify a queue using the same high-level concepts intake and repair-intake
+ * already rely on:
+ * - queue must resolve from config;
+ * - lifecycle namespace must be adopted/present;
+ * - blocked or stalled work means operator attention is needed;
+ * - otherwise ready or active work is healthy;
+ * - otherwise the queue is truly idle.
+ *
+ * @param {QueueHealthInput} input
+ * @returns {{
+ *   readonly verdict: QueueHealthVerdict
+ *   readonly reasons: readonly string[]
+ *   readonly counts: Readonly<{
+ *     ready: number
+ *     active: number
+ *     blocked: number
+ *     stalled: number
+ *     attentionNeeded: number
+ *   }>
+ * }}
+ */
+export function classifyQueueHealth(input = {}) {
+  const counts = {
+    ready: normalizeCount(input.readyCount),
+    active: normalizeCount(input.activeCount),
+    blocked: normalizeCount(input.blockedCount),
+    stalled: normalizeCount(input.stalledCount),
+  };
+  const attentionNeeded = counts.blocked + counts.stalled;
+
+  if (input.queueResolved === false || hasContent(input.resolutionError)) {
+    return {
+      verdict: "MISCONFIGURED",
+      reasons: ["queue-unresolved"],
+      counts: {
+        ...counts,
+        attentionNeeded,
+      },
+    };
+  }
+
+  if (input.namespaceAdopted === false) {
+    return {
+      verdict: "MISCONFIGURED",
+      reasons: ["lifecycle-namespace-absent"],
+      counts: {
+        ...counts,
+        attentionNeeded,
+      },
+    };
+  }
+
+  if (attentionNeeded > 0) {
+    return {
+      verdict: "ATTENTION_NEEDED",
+      reasons: [
+        counts.blocked > 0 ? "blocked-work-present" : null,
+        counts.stalled > 0 ? "stalled-work-present" : null,
+      ].filter(Boolean),
+      counts: {
+        ...counts,
+        attentionNeeded,
+      },
+    };
+  }
+
+  if (counts.ready > 0 || counts.active > 0) {
+    return {
+      verdict: "HEALTHY",
+      reasons: [
+        counts.ready > 0 ? "ready-work-present" : null,
+        counts.active > 0 ? "active-work-in-flight" : null,
+      ].filter(Boolean),
+      counts: {
+        ...counts,
+        attentionNeeded,
+      },
+    };
+  }
+
+  return {
+    verdict: "IDLE",
+    reasons: ["no-actionable-work"],
+    counts: {
+      ...counts,
+      attentionNeeded,
+    },
+  };
+}
+
+/**
+ * Combine individual queue verdicts into the overall queue-status verdict.
+ *
+ * @param {readonly { verdict: QueueHealthVerdict }[]} sections
+ * @returns {QueueHealthVerdict}
+ */
+export function computeOverallQueueVerdict(sections) {
+  const verdicts = sections.map(section => section.verdict);
+
+  if (verdicts.includes("MISCONFIGURED")) {
+    return "MISCONFIGURED";
+  }
+  if (verdicts.includes("ATTENTION_NEEDED")) {
+    return "ATTENTION_NEEDED";
+  }
+  if (verdicts.includes("HEALTHY")) {
+    return "HEALTHY";
+  }
+  return "IDLE";
+}
+
+/**
+ * @param {number | null | undefined} value
+ * @returns {number}
+ */
+function normalizeCount(value) {
+  return Number.isFinite(value) && value > 0 ? Math.trunc(value) : 0;
+}
+
+/**
+ * @param {string | null | undefined} value
+ * @returns {boolean}
+ */
+function hasContent(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-cdk",
-  "version": "2.93.0",
+  "version": "2.95.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.93.0",
+  "version": "2.95.0",
   "description": "AWS CDK-specific Lisa plugin.",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-expo",
-  "version": "2.93.0",
+  "version": "2.95.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.93.0",
+  "version": "2.95.0",
   "description": "Expo and 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.93.0",
+  "version": "2.95.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.93.0",
+  "version": "2.95.0",
   "description": "Harper/Fabric-specific Lisa 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.93.0",
+  "version": "2.95.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.93.0",
+  "version": "2.95.0",
   "description": "NestJS-specific skills and migration write-protection hooks.",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.93.0",
+  "version": "2.95.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.93.0",
+  "version": "2.95.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-rails/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-rails",
-  "version": "2.93.0",
+  "version": "2.95.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.93.0",
+  "version": "2.95.0",
   "description": "Ruby on Rails-specific skills and hooks for RuboCop 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.93.0",
+  "version": "2.95.0",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.93.0",
+  "version": "2.95.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.93.0",
+  "version": "2.95.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/src/base/scripts/automation-status-expected-fleet.mjs

@@ -8,6 +8,13 @@
  * truth.
  */
 
+import {
+  resolveBuildQueueArgument,
+  resolveGithubRepoRef,
+  resolvePrdQueueArgument,
+  resolvePrdSource,
+} from "./queue-contract-resolution.mjs";
+
 export const AUTOMATION_EXPECTED_CADENCES = {
   "intake-repair": {
     human: "every 60 minutes",
@@ -33,11 +40,6 @@ export const AUTOMATION_EXPECTED_CADENCES = {
 
 export const EXPLORATORY_QA_STACK_PRIORITY = ["expo", "rails", "harper-fabric"];
 
-const GITHUB_REMOTE_PATTERNS = [
-  /github\.com[:/](?<owner>[^/]+)\/(?<repo>[^/.]+?)(?:\.git)?$/,
-  /^git@github\.com:(?<owner>[^/]+)\/(?<repo>[^/.]+?)(?:\.git)?$/,
-];
-
 /**
  * @typedef {{
  *   readonly id: string
@@ -229,83 +231,6 @@ function createUnsupportedEntry(identity, id, reason) {
   };
 }
 
-/**
- * @param {Record<string, any>} config
- * @param {string | undefined} source
- * @returns {string}
- */
-function resolvePrdQueueArgument(config, source) {
-  switch (source) {
-    case "github":
-      requireGithubRepo(config);
-      return "github intake_mode=prd";
-    case "linear":
-      requireLinearWorkspace(config);
-      return "linear";
-    case "notion": {
-      const databaseId = config.notion?.prdDatabaseId;
-      if (!databaseId) {
-        throw new Error(
-          "Unable to resolve the PRD queue: notion.prdDatabaseId is required when source=notion."
-        );
-      }
-      return databaseId;
-    }
-    case "confluence": {
-      const parentPageId = config.confluence?.parentPageId;
-      const spaceKey = config.confluence?.spaceKey;
-      if (!parentPageId && !spaceKey) {
-        throw new Error(
-          "Unable to resolve the PRD queue: confluence.parentPageId or confluence.spaceKey is required when source=confluence."
-        );
-      }
-      return parentPageId ?? spaceKey;
-    }
-    case "jira": {
-      const project = config.jira?.project;
-      if (!project) {
-        throw new Error(
-          "Unable to resolve the PRD queue: jira.project is required when source=jira."
-        );
-      }
-      return project;
-    }
-    default:
-      throw new Error(
-        "Unable to resolve the PRD queue from config. Set source or use tracker=github self-host with github.org/github.repo."
-      );
-  }
-}
-
-/**
- * @param {Record<string, any>} config
- * @param {string | undefined} tracker
- * @returns {string}
- */
-function resolveBuildQueueArgument(config, tracker) {
-  switch (tracker) {
-    case "github":
-      requireGithubRepo(config);
-      return "github intake_mode=build";
-    case "linear":
-      requireLinearWorkspace(config);
-      return "linear";
-    case "jira": {
-      const project = config.jira?.project;
-      if (!project) {
-        throw new Error(
-          "Unable to resolve the build queue: jira.project is required when tracker=jira."
-        );
-      }
-      return project;
-    }
-    default:
-      throw new Error(
-        "Unable to resolve the build queue from config. tracker must be github, linear, or jira."
-      );
-  }
-}
-
 /**
  * @param {Record<string, any>} config
  * @param {string | undefined} source
@@ -343,56 +268,6 @@ function resolveRepairQueueArgument(config, source, tracker) {
   );
 }
 
-/**
- * @param {Record<string, any>} config
- * @returns {string | undefined}
- */
-function resolvePrdSource(config) {
-  if (typeof config.source === "string" && config.source.length > 0) {
-    return config.source;
-  }
-
-  if (
-    config.tracker === "github" &&
-    config.github?.org &&
-    config.github?.repo
-  ) {
-    return "github";
-  }
-
-  return undefined;
-}
-
-/**
- * @param {Record<string, any>} config
- * @param {string | undefined} gitRemoteUrl
- * @returns {{ readonly owner: string, readonly repo: string } | null}
- */
-function resolveGithubRepoRef(config, gitRemoteUrl) {
-  const owner = config.github?.org;
-  const repo = config.github?.repo;
-
-  if (owner && repo) {
-    return { owner, repo };
-  }
-
-  if (!gitRemoteUrl) {
-    return null;
-  }
-
-  for (const pattern of GITHUB_REMOTE_PATTERNS) {
-    const match = gitRemoteUrl.match(pattern);
-    if (match?.groups?.owner && match.groups.repo) {
-      return {
-        owner: match.groups.owner,
-        repo: match.groups.repo,
-      };
-    }
-  }
-
-  return null;
-}
-
 /**
  * @param {Record<string, any>} config
  */