@codyswann/lisa 2.219.0 → 2.220.0

package/all/copy-contents/gitignore

@@ -9,6 +9,8 @@ jspm_packages
 dist/
 dist
 .build/
+# NestJS pre-push AppModule boot-check scratch dir (untracked; keep out of `git add -A`)
+.build-boot/
 .serverless/
 .serverless
 cdk.out/
@@ -157,8 +159,11 @@ service-key.json
 # Task files
 .windsurfrules
 .taskmasterconfig
-!tasks/tasks.json
+# Ignore stray tasks.json anywhere, but keep the tracked tasks/tasks.json.
+# The broad ignore MUST precede the re-include — gitignore is last-match-wins,
+# so a `tasks.json` rule after `!tasks/tasks.json` would re-ignore it.
 tasks.json
+!tasks/tasks.json
 
 # AI Assistant and MCP
 **/.claude/settings.local.json

package/cdk/copy-overwrite/eslint.config.ts

@@ -7,11 +7,15 @@
  * ESLint 9 Flat Config - Main Entry Point (CDK)
  *
  * Thin wrapper around @codyswann/lisa eslint config factory.
- * Customize via eslint.config.local.ts and eslint.thresholds.json.
+ * Customize via eslint.config.local.ts, eslint.thresholds.json, and the
+ * optional (create-only) eslint.ignore.config.local.json — its `ignores` are
+ * merged into the ignore list so host customizations survive the
+ * copy-overwrite of eslint.ignore.config.json on each Lisa update.
  *
  * @see https://eslint.org/docs/latest/use/configure/configuration-files-new
  * @module eslint.config
  */
+import { existsSync } from "fs";
 import { createRequire } from "module";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -31,11 +35,29 @@ const thresholdsConfig = require("./eslint.thresholds.json");
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-export default [
+// Merge the optional project-owned eslint.ignore.config.local.json (create-only,
+// never copy-overwritten) so host ignore customizations are not wiped when Lisa
+// overwrites eslint.ignore.config.json on update.
+const localIgnores: string[] = existsSync(
+  path.join(__dirname, "eslint.ignore.config.local.json")
+)
+  ? (require("./eslint.ignore.config.local.json").ignores ?? [])
+  : [];
+
+// Annotate with the factory's return type so `tsc --noEmit` under
+// `declaration: true` does not surface @eslint/core's `RulesConfig` in the
+// emitted declaration (TS2883). Do NOT import `Linter` from "eslint" directly —
+// that trips knip's unlisted-dependency check.
+const config: ReturnType<typeof getCdkConfig> = [
   ...getCdkConfig({
     tsconfigRootDir: __dirname,
-    ignorePatterns: ignoreConfig.ignores || defaultIgnores,
+    ignorePatterns: [
+      ...(ignoreConfig.ignores || defaultIgnores),
+      ...localIgnores,
+    ],
     thresholds: { ...defaultThresholds, ...thresholdsConfig },
   }),
   ...localConfig,
 ];
+
+export default config;

package/cdk/copy-overwrite/eslint.slow.config.ts

@@ -9,14 +9,41 @@
  * Thin wrapper around @codyswann/lisa slow eslint config factory.
  * Run periodically via `lint:slow` rather than on every lint pass.
  *
+ * The optional (create-only) eslint.ignore.config.local.json `ignores` are
+ * merged into the ignore list so host customizations survive the
+ * copy-overwrite of eslint.ignore.config.json on each Lisa update.
+ *
  * @see https://github.com/import-js/eslint-plugin-import
  * @module eslint.slow.config
  */
+import { existsSync } from "fs";
 import { createRequire } from "module";
+import path from "path";
+import { fileURLToPath } from "url";
 
 import { getSlowConfig } from "@codyswann/lisa/eslint/slow";
 
 const require = createRequire(import.meta.url);
 const ignoreConfig = require("./eslint.ignore.config.json");
 
-export default getSlowConfig({ ignorePatterns: ignoreConfig.ignores || [] });
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Merge the optional project-owned eslint.ignore.config.local.json (create-only,
+// never copy-overwritten) so host ignore customizations are not wiped when Lisa
+// overwrites eslint.ignore.config.json on update.
+const localIgnores: string[] = existsSync(
+  path.join(__dirname, "eslint.ignore.config.local.json")
+)
+  ? (require("./eslint.ignore.config.local.json").ignores ?? [])
+  : [];
+
+// Annotate with the factory's return type so `tsc --noEmit` under
+// `declaration: true` does not surface @eslint/core's `RulesConfig` in the
+// emitted declaration (TS2883). Do NOT import `Linter` from "eslint" directly —
+// that trips knip's unlisted-dependency check.
+const config: ReturnType<typeof getSlowConfig> = getSlowConfig({
+  ignorePatterns: [...(ignoreConfig.ignores || []), ...localIgnores],
+});
+
+export default config;

package/dist/core/learnings-document.d.ts

@@ -0,0 +1,22 @@
+/** Pure parsing and rendering for the canonical project-learnings document. */
+import { type LearningEntry } from "./learnings-contract.js";
+/**
+ * Render the complete file in one stable, machine-readable Markdown form.
+ * @param entries - Validated entries to serialize
+ * @returns Canonical Markdown plus JSONL document
+ */
+export declare function renderLearningsFile(entries: readonly LearningEntry[]): string;
+/**
+ * Parse and revalidate an existing file before it participates in a write.
+ * @param content - Existing learnings document
+ * @returns Revalidated entries from the document
+ */
+export declare function parseLearningsFile(content: string): LearningEntry[];
+/**
+ * Enforce the shared entry-count and model-agnostic token upper bounds.
+ * @param content - Canonical document
+ * @param entryCount - Number of entries in the document
+ * @param context - Error-message prefix
+ */
+export declare function assertDocumentBudget(content: string, entryCount: number, context: string): void;
+//# sourceMappingURL=learnings-document.d.ts.map

package/dist/core/learnings-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings-document.d.ts","sourceRoot":"","sources":["../../src/core/learnings-document.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AAWjC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAG7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAsBnE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,IAAI,CAYN"}

package/dist/core/learnings-document.js

@@ -0,0 +1,106 @@
+/** Pure parsing and rendering for the canonical project-learnings document. */
+import { LEARNINGS_CONTRACT, estimateLearningTokens, } from "./learnings-contract.js";
+import { validateLearningEntry } from "./learnings-entry.js";
+const FILE_HEADER = `# Project Learnings
+
+<!-- lisa-learnings-contract:v${LEARNINGS_CONTRACT.version} -->
+
+`;
+const JSON_FENCE_START = "```jsonl\n";
+const JSON_FENCE_END = "\n```\n";
+/**
+ * Render the complete file in one stable, machine-readable Markdown form.
+ * @param entries - Validated entries to serialize
+ * @returns Canonical Markdown plus JSONL document
+ */
+export function renderLearningsFile(entries) {
+    const lines = entries.map(entry => JSON.stringify(entry)).join("\n");
+    return `${FILE_HEADER}${JSON_FENCE_START}${lines}${JSON_FENCE_END}`;
+}
+/**
+ * Parse and revalidate an existing file before it participates in a write.
+ * @param content - Existing learnings document
+ * @returns Revalidated entries from the document
+ */
+export function parseLearningsFile(content) {
+    if (estimateLearningTokens(content) > LEARNINGS_CONTRACT.maxTokens) {
+        throw new Error(`Project learnings payload exceeds maxTokens ${LEARNINGS_CONTRACT.maxTokens}`);
+    }
+    if (!content.startsWith(`${FILE_HEADER}${JSON_FENCE_START}`) ||
+        !content.endsWith(JSON_FENCE_END)) {
+        throw new Error("Invalid project learnings file format");
+    }
+    const jsonStart = FILE_HEADER.length + JSON_FENCE_START.length;
+    const jsonEnd = content.length - JSON_FENCE_END.length;
+    const entries = parseJsonLines(content.slice(jsonStart, jsonEnd)).map(validateParsedLearningEntry);
+    if (new Set(entries.map(entry => entry.id)).size !== entries.length) {
+        throw new Error("Invalid project learnings payload: duplicate ids");
+    }
+    assertDocumentBudget(content, entries.length, "Project learnings payload");
+    return entries;
+}
+/**
+ * Enforce the shared entry-count and model-agnostic token upper bounds.
+ * @param content - Canonical document
+ * @param entryCount - Number of entries in the document
+ * @param context - Error-message prefix
+ */
+export function assertDocumentBudget(content, entryCount, context) {
+    if (entryCount > LEARNINGS_CONTRACT.maxEntries) {
+        throw new Error(`${context} exceeds maxEntries: measured ${entryCount}, allowed ${LEARNINGS_CONTRACT.maxEntries}`);
+    }
+    const estimatedTokens = estimateLearningTokens(content);
+    if (estimatedTokens > LEARNINGS_CONTRACT.maxTokens) {
+        throw new Error(`${context} exceeds maxTokens ${LEARNINGS_CONTRACT.maxTokens} (measured ${estimatedTokens})`);
+    }
+}
+/**
+ * Add a stable entry identifier to validation failures.
+ * @param candidate - Parsed JSONL value
+ * @param index - Zero-based JSONL entry index
+ * @returns Validated learning entry
+ */
+function validateParsedLearningEntry(candidate, index) {
+    try {
+        return validateLearningEntry(candidate);
+    }
+    catch (error) {
+        const id = readDiagnosticEntryId(candidate);
+        const label = id === undefined ? `entry ${index + 1}` : `entry ${JSON.stringify(id)}`;
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid learning ${label}: ${detail}`);
+    }
+}
+/**
+ * Read a parsed entry id only when it is an inert own data property.
+ * @param candidate - Parsed JSONL value
+ * @returns Safe diagnostic id, when present
+ */
+function readDiagnosticEntryId(candidate) {
+    if (candidate === null || typeof candidate !== "object") {
+        return undefined;
+    }
+    const descriptor = Object.getOwnPropertyDescriptor(candidate, "id");
+    return descriptor !== undefined &&
+        "value" in descriptor &&
+        typeof descriptor.value === "string"
+        ? descriptor.value
+        : undefined;
+}
+/**
+ * Parse the strict JSONL payload with a stable, user-facing error.
+ * @param payload - JSONL payload
+ * @returns Parsed unknown entry values
+ */
+function parseJsonLines(payload) {
+    if (payload === "") {
+        return [];
+    }
+    try {
+        return payload.split("\n").map(line => JSON.parse(line));
+    }
+    catch {
+        throw new Error("Invalid project learnings JSONL payload");
+    }
+}
+//# sourceMappingURL=learnings-document.js.map

package/dist/core/learnings-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learnings-document.js","sourceRoot":"","sources":["../../src/core/learnings-document.ts"],"names":[],"mappings":"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"}

package/dist/core/learnings-writer.d.ts

@@ -1,4 +1,3 @@
-import { type LearningEntry } from "./learnings-contract.js";
 /**
  * Persist one already-selected learning without generating or truncating it.
  * @param projectRoot - Absolute path to the host project root
@@ -6,17 +5,6 @@ import { type LearningEntry } from "./learnings-contract.js";
  * @returns Absolute path to the persisted learnings file
  */
 export declare function persistLearningEntry(projectRoot: string, candidate: unknown): Promise<string>;
-/**
- * Render the complete file in one stable, machine-readable Markdown form.
- * @param entries - Validated entries to serialize
- * @returns Canonical Markdown plus JSONL document
- */
-export declare function renderLearningsFile(entries: readonly LearningEntry[]): string;
-/**
- * Parse and revalidate an existing file before it participates in a write.
- * @param content - Existing learnings document
- * @returns Revalidated entries from the document
- */
-export declare function parseLearningsFile(content: string): LearningEntry[];
+export { parseLearningsFile, renderLearningsFile, } from "./learnings-document.js";
 export { validateLearningEntry } from "./learnings-entry.js";
 //# sourceMappingURL=learnings-writer.d.ts.map

package/dist/core/learnings-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"learnings-writer.d.ts","sourceRoot":"","sources":["../../src/core/learnings-writer.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AAqBjC;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAG7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAsBnE;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"learnings-writer.d.ts","sourceRoot":"","sources":["../../src/core/learnings-writer.ts"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/core/learnings-writer.js

@@ -2,18 +2,11 @@
 import * as fse from "fs-extra";
 import { rename, writeFile } from "node:fs/promises";
 import * as path from "node:path";
-import { LEARNINGS_CONTRACT, estimateLearningTokens, } from "./learnings-contract.js";
+import { assertDocumentBudget, parseLearningsFile, renderLearningsFile, } from "./learnings-document.js";
 import { validateLearningEntry } from "./learnings-entry.js";
 import { assertSafeLearningParents, readExistingLearnings, resolveSafeLearningTarget, } from "./learnings-file-safety.js";
 import { withLearningTargetLock } from "./learnings-lock.js";
 import { readProjectConfig, resolveProjectLearningsFile, } from "./project-config.js";
-const FILE_HEADER = `# Project Learnings
-
-<!-- lisa-learnings-contract:v${LEARNINGS_CONTRACT.version} -->
-
-`;
-const JSON_FENCE_START = "```jsonl\n";
-const JSON_FENCE_END = "\n```\n";
 /**
  * Persist one already-selected learning without generating or truncating it.
  * @param projectRoot - Absolute path to the host project root
@@ -47,37 +40,7 @@ export async function persistLearningEntry(projectRoot, candidate) {
         return target;
     });
 }
-/**
- * Render the complete file in one stable, machine-readable Markdown form.
- * @param entries - Validated entries to serialize
- * @returns Canonical Markdown plus JSONL document
- */
-export function renderLearningsFile(entries) {
-    const lines = entries.map(entry => JSON.stringify(entry)).join("\n");
-    return `${FILE_HEADER}${JSON_FENCE_START}${lines}${JSON_FENCE_END}`;
-}
-/**
- * Parse and revalidate an existing file before it participates in a write.
- * @param content - Existing learnings document
- * @returns Revalidated entries from the document
- */
-export function parseLearningsFile(content) {
-    if (estimateLearningTokens(content) > LEARNINGS_CONTRACT.maxTokens) {
-        throw new Error(`Project learnings payload exceeds maxTokens ${LEARNINGS_CONTRACT.maxTokens}`);
-    }
-    if (!content.startsWith(`${FILE_HEADER}${JSON_FENCE_START}`) ||
-        !content.endsWith(JSON_FENCE_END)) {
-        throw new Error("Invalid project learnings file format");
-    }
-    const jsonStart = FILE_HEADER.length + JSON_FENCE_START.length;
-    const jsonEnd = content.length - JSON_FENCE_END.length;
-    const entries = parseJsonLines(content.slice(jsonStart, jsonEnd)).map(validateLearningEntry);
-    if (new Set(entries.map(entry => entry.id)).size !== entries.length) {
-        throw new Error("Invalid project learnings payload: duplicate ids");
-    }
-    assertDocumentBudget(content, entries.length, "Project learnings payload");
-    return entries;
-}
+export { parseLearningsFile, renderLearningsFile, } from "./learnings-document.js";
 export { validateLearningEntry } from "./learnings-entry.js";
 /**
  * Build and budget-check the next canonical document.
@@ -94,35 +57,4 @@ function buildNextDocument(entries, entry) {
     assertDocumentBudget(rendered, nextEntries.length, "Learnings file");
     return rendered;
 }
-/**
- * Enforce the shared entry-count and model-agnostic token upper bounds.
- * @param content - Canonical document
- * @param entryCount - Number of entries in the document
- * @param context - Error-message prefix
- */
-function assertDocumentBudget(content, entryCount, context) {
-    if (entryCount > LEARNINGS_CONTRACT.maxEntries) {
-        throw new Error(`${context} exceeds maxEntries ${LEARNINGS_CONTRACT.maxEntries}`);
-    }
-    const estimatedTokens = estimateLearningTokens(content);
-    if (estimatedTokens > LEARNINGS_CONTRACT.maxTokens) {
-        throw new Error(`${context} exceeds maxTokens ${LEARNINGS_CONTRACT.maxTokens} (measured ${estimatedTokens})`);
-    }
-}
-/**
- * Parse the strict JSONL payload with a stable, user-facing error.
- * @param payload - JSONL payload
- * @returns Parsed unknown entry values
- */
-function parseJsonLines(payload) {
-    if (payload === "") {
-        return [];
-    }
-    try {
-        return payload.split("\n").map(line => JSON.parse(line));
-    }
-    catch {
-        throw new Error("Invalid project learnings JSONL payload");
-    }
-}
 //# sourceMappingURL=learnings-writer.js.map

package/dist/core/learnings-writer.js.map

@@ -1 +1 @@
-{"version":3,"file":"learnings-writer.js","sourceRoot":"","sources":["../../src/core/learnings-writer.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,GAAG;;gCAEY,kBAAkB,CAAC,OAAO;;CAEzD,CAAC;AACF,MAAM,gBAAgB,GAAG,YAAY,CAAC;AACtC,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,SAAkB;IAElB,MAAM,KAAK,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,iBAAiB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,yBAAyB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9E,MAAM,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,OAAO,sBAAsB,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC3E,MAAM,QAAQ,GACZ,QAAQ,KAAK,SAAS;YACpB,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,MAAM,CACtE,CAAC;QACF,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,MAAM,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5D,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;gBAAS,CAAC;YACT,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAiC;IACnE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,GAAG,WAAW,GAAG,gBAAgB,GAAG,KAAK,GAAG,cAAc,EAAE,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,IAAI,sBAAsB,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,SAAS,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CACb,+CAA+C,kBAAkB,CAAC,SAAS,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,IACE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,gBAAgB,EAAE,CAAC;QACxD,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EACjC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;IACvD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CACnE,qBAAqB,CACtB,CAAC;IACF,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC3E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;GAKG;AACH,SAAS,iBAAiB,CACxB,OAAiC,EACjC,KAAoB;IAEpB,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,WAAW,GAAG,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC3D,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAChC,CAAC;IACF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAClD,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAC3B,OAAe,EACf,UAAkB,EAClB,OAAe;IAEf,IAAI,UAAU,GAAG,kBAAkB,CAAC,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,uBAAuB,kBAAkB,CAAC,UAAU,EAAE,CACjE,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,eAAe,GAAG,kBAAkB,CAAC,SAAS,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,sBAAsB,kBAAkB,CAAC,SAAS,cAAc,eAAe,GAAG,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}
+{"version":3,"file":"learnings-writer.js","sourceRoot":"","sources":["../../src/core/learnings-writer.ts"],"names":[],"mappings":"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"}

package/expo/copy-overwrite/eslint.config.ts

@@ -7,12 +7,16 @@
  * ESLint 9 Flat Config - Main Entry Point (Expo)
  *
  * Thin wrapper around @codyswann/lisa eslint config factory.
- * Customize via eslint.config.local.ts and eslint.thresholds.json.
+ * Customize via eslint.config.local.ts, eslint.thresholds.json, and the
+ * optional (create-only) eslint.ignore.config.local.json — its `ignores` are
+ * merged into the ignore list so host customizations survive the
+ * copy-overwrite of eslint.ignore.config.json on each Lisa update.
  *
  * @see https://eslint.org/docs/latest/use/configure/configuration-files-new
  * @module eslint.config
  */
 import { existsSync } from "fs";
+import { createRequire } from "module";
 import path from "path";
 import { fileURLToPath } from "url";
 
@@ -26,6 +30,7 @@ import ignoreConfig from "./eslint.ignore.config.json" with { type: "json" };
 import thresholdsConfig from "./eslint.thresholds.json" with { type: "json" };
 import localConfig from "./eslint.config.local";
 
+const require = createRequire(import.meta.url);
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
@@ -33,12 +38,30 @@ const __dirname = path.dirname(__filename);
 // ui-standards, and view-memo overrides target `src/...` instead of the root.
 const sourceRoot = existsSync(path.join(__dirname, "src", "app")) ? "src/" : "";
 
-export default [
+// Merge the optional project-owned eslint.ignore.config.local.json (create-only,
+// never copy-overwritten) so host ignore customizations are not wiped when Lisa
+// overwrites eslint.ignore.config.json on update.
+const localIgnores: string[] = existsSync(
+  path.join(__dirname, "eslint.ignore.config.local.json")
+)
+  ? (require("./eslint.ignore.config.local.json").ignores ?? [])
+  : [];
+
+// Annotate with the factory's return type so `tsc --noEmit` under
+// `declaration: true` does not surface @eslint/core's `RulesConfig` in the
+// emitted declaration (TS2883). Do NOT import `Linter` from "eslint" directly —
+// that trips knip's unlisted-dependency check.
+const config: ReturnType<typeof getExpoConfig> = [
   ...getExpoConfig({
     tsconfigRootDir: __dirname,
-    ignorePatterns: ignoreConfig.ignores || defaultIgnores,
+    ignorePatterns: [
+      ...(ignoreConfig.ignores || defaultIgnores),
+      ...localIgnores,
+    ],
     thresholds: { ...defaultThresholds, ...thresholdsConfig },
     sourceRoot,
   }),
   ...localConfig,
 ];
+
+export default config;

package/expo/copy-overwrite/eslint.slow.config.ts

@@ -9,10 +9,41 @@
  * Thin wrapper around @codyswann/lisa slow eslint config factory.
  * Run periodically via `lint:slow` rather than on every lint pass.
  *
+ * The optional (create-only) eslint.ignore.config.local.json `ignores` are
+ * merged into the ignore list so host customizations survive the
+ * copy-overwrite of eslint.ignore.config.json on each Lisa update.
+ *
  * @see https://github.com/import-js/eslint-plugin-import
  * @module eslint.slow.config
  */
+import { existsSync } from "fs";
+import { createRequire } from "module";
+import path from "path";
+import { fileURLToPath } from "url";
+
 import { getSlowConfig } from "@codyswann/lisa/eslint/slow";
+
 import ignoreConfig from "./eslint.ignore.config.json" with { type: "json" };
 
-export default getSlowConfig({ ignorePatterns: ignoreConfig.ignores || [] });
+const require = createRequire(import.meta.url);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Merge the optional project-owned eslint.ignore.config.local.json (create-only,
+// never copy-overwritten) so host ignore customizations are not wiped when Lisa
+// overwrites eslint.ignore.config.json on update.
+const localIgnores: string[] = existsSync(
+  path.join(__dirname, "eslint.ignore.config.local.json")
+)
+  ? (require("./eslint.ignore.config.local.json").ignores ?? [])
+  : [];
+
+// Annotate with the factory's return type so `tsc --noEmit` under
+// `declaration: true` does not surface @eslint/core's `RulesConfig` in the
+// emitted declaration (TS2883). Do NOT import `Linter` from "eslint" directly —
+// that trips knip's unlisted-dependency check.
+const config: ReturnType<typeof getSlowConfig> = getSlowConfig({
+  ignorePatterns: [...(ignoreConfig.ignores || []), ...localIgnores],
+});
+
+export default config;

package/expo/copy-overwrite/scripts/check-e2e-coverage.mjs

@@ -81,7 +81,7 @@ export function enumerateRoutes(files) {
   const routes = files
     .map(file => routeFromFile(file))
     .filter(route => route !== null);
-  return [...new Set(routes)].sort();
+  return [...new Set(routes)].sort((a, b) => a.localeCompare(b));
 }
 
 /**

package/expo/create-only/e2e.thresholds.json

@@ -1,8 +1,9 @@
 {
+  "_comment": "Shipped defaults are 0/0 so adopting Lisa on a brownfield Expo app does not red-gate CI before any e2e specs exist. Treat these as a ratchet: raise each value toward 100 as Playwright/Maestro coverage grows, and never lower an achieved floor. This file is create-only — Lisa writes it once and never overwrites your tuned values.",
   "playwright": {
-    "routes": 80
+    "routes": 0
   },
   "maestro": {
-    "routes": 80
+    "routes": 0
   }
 }

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

@@ -98,14 +98,16 @@
       "@isaacs/brace-expansion": "^5.0.1",
       "eslint-plugin-react-hooks": "^7.0.0",
       "fast-xml-parser": "^5.3.6",
-      "tar": ">=7.5.11"
+      "tar": ">=7.5.11",
+      "websocket-driver": ">=0.7.5"
     },
     "overrides": {
       "@isaacs/brace-expansion": "^5.0.1",
       "eslint-plugin-react-hooks": "^7.0.0",
       "fast-xml-parser": "^5.3.6",
       "zod-validation-error": "^4.0.0",
-      "tar": ">=7.5.11"
+      "tar": ">=7.5.11",
+      "websocket-driver": ">=0.7.5"
     }
   },
   "defaults": {

package/harper-fabric/copy-overwrite/eslint.config.ts

@@ -7,11 +7,16 @@
  * ESLint 9 Flat Config
  *
  * Thin wrapper around @codyswann/lisa Harper/Fabric config factory.
- * Customize via eslint.config.local.ts and eslint.thresholds.json.
+ * Customize via eslint.config.local.ts, eslint.thresholds.json, and the
+ * optional (create-only) eslint.ignore.config.local.json — its `ignores` are
+ * merged into the ignore list so host customizations survive the
+ * copy-overwrite of eslint.ignore.config.json on each Lisa update.
  *
  * @see https://eslint.org/docs/latest/use/configure/configuration-files-new
  * @module eslint.config
  */
+import { existsSync } from "fs";
+import { createRequire } from "module";
 import path from "path";
 import { fileURLToPath } from "url";
 
@@ -25,17 +30,34 @@ import ignoreConfig from "./eslint.ignore.config.json" with { type: "json" };
 import thresholdsConfig from "./eslint.thresholds.json" with { type: "json" };
 import localConfig from "./eslint.config.local";
 
+const require = createRequire(import.meta.url);
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-export default [
+// Merge the optional project-owned eslint.ignore.config.local.json (create-only,
+// never copy-overwritten) so host ignore customizations are not wiped when Lisa
+// overwrites eslint.ignore.config.json on update.
+const localIgnores: string[] = existsSync(
+  path.join(__dirname, "eslint.ignore.config.local.json")
+)
+  ? (require("./eslint.ignore.config.local.json").ignores ?? [])
+  : [];
+
+// Annotate with the factory's return type so `tsc --noEmit` under
+// `declaration: true` does not surface @eslint/core's `RulesConfig` in the
+// emitted declaration (TS2883). Do NOT import `Linter` from "eslint" directly —
+// that trips knip's unlisted-dependency check.
+const config: ReturnType<typeof getHarperFabricConfig> = [
   ...getHarperFabricConfig({
     tsconfigRootDir: __dirname,
     ignorePatterns: [
       ...defaultHarperFabricIgnores,
       ...(ignoreConfig.ignores || []),
+      ...localIgnores,
     ],
     thresholds: { ...defaultThresholds, ...thresholdsConfig },
   }),
   ...localConfig,
 ];
+
+export default config;

package/nestjs/copy-overwrite/eslint.config.ts

@@ -7,11 +7,16 @@
  * ESLint 9 Flat Config - Main Entry Point (NestJS)
  *
  * Thin wrapper around @codyswann/lisa eslint config factory.
- * Customize via eslint.config.local.ts and eslint.thresholds.json.
+ * Customize via eslint.config.local.ts, eslint.thresholds.json, and the
+ * optional (create-only) eslint.ignore.config.local.json — its `ignores` are
+ * merged into the ignore list so host customizations survive the
+ * copy-overwrite of eslint.ignore.config.json on each Lisa update.
  *
  * @see https://eslint.org/docs/latest/use/configure/configuration-files-new
  * @module eslint.config
  */
+import { existsSync } from "fs";
+import { createRequire } from "module";
 import path from "path";
 import { fileURLToPath } from "url";
 
@@ -25,14 +30,33 @@ import ignoreConfig from "./eslint.ignore.config.json" with { type: "json" };
 import thresholdsConfig from "./eslint.thresholds.json" with { type: "json" };
 import localConfig from "./eslint.config.local";
 
+const require = createRequire(import.meta.url);
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-export default [
+// Merge the optional project-owned eslint.ignore.config.local.json (create-only,
+// never copy-overwritten) so host ignore customizations are not wiped when Lisa
+// overwrites eslint.ignore.config.json on update.
+const localIgnores: string[] = existsSync(
+  path.join(__dirname, "eslint.ignore.config.local.json")
+)
+  ? (require("./eslint.ignore.config.local.json").ignores ?? [])
+  : [];
+
+// Annotate with the factory's return type so `tsc --noEmit` under
+// `declaration: true` does not surface @eslint/core's `RulesConfig` in the
+// emitted declaration (TS2883). Do NOT import `Linter` from "eslint" directly —
+// that trips knip's unlisted-dependency check.
+const config: ReturnType<typeof getNestjsConfig> = [
   ...getNestjsConfig({
     tsconfigRootDir: __dirname,
-    ignorePatterns: ignoreConfig.ignores || defaultIgnores,
+    ignorePatterns: [
+      ...(ignoreConfig.ignores || defaultIgnores),
+      ...localIgnores,
+    ],
     thresholds: { ...defaultThresholds, ...thresholdsConfig },
   }),
   ...localConfig,
 ];
+
+export default config;