@codyswann/lisa 1.82.2 → 1.83.1

package/dist/migrations/ensure-expo-postinstall.d.ts

@@ -0,0 +1,26 @@
+import type { Migration, MigrationContext, MigrationResult } from "./migration.interface.js";
+/**
+ * Migration: ensure Expo projects chain Lisa into their postinstall script.
+ *
+ * Some Expo projects (e.g. gsai frontend-v2, propswap/frontend) have a custom postinstall
+ * (`patch-package && ...`) that never invokes Lisa. Without the Lisa invocation, template
+ * application never runs on `bun install` after a Lisa bump. This migration prepends the
+ * standard Lisa invocation so template updates apply automatically on install.
+ */
+export declare class EnsureExpoPostinstallMigration implements Migration {
+    readonly name = "ensure-expo-postinstall";
+    readonly description = "Ensure Expo projects run Lisa in their postinstall script";
+    /**
+     * Check whether this migration should run on the project
+     * @param ctx - Migration context
+     * @returns True when an Expo project is missing the Lisa invocation in postinstall
+     */
+    applies(ctx: MigrationContext): Promise<boolean>;
+    /**
+     * Apply the migration, prepending the Lisa invocation to the project's postinstall
+     * @param ctx - Migration context
+     * @returns Result describing the action taken
+     */
+    apply(ctx: MigrationContext): Promise<MigrationResult>;
+}
+//# sourceMappingURL=ensure-expo-postinstall.d.ts.map

package/dist/migrations/ensure-expo-postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-expo-postinstall.d.ts","sourceRoot":"","sources":["../../src/migrations/ensure-expo-postinstall.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAuClC;;;;;;;GAOG;AACH,qBAAa,8BAA+B,YAAW,SAAS;IAC9D,QAAQ,CAAC,IAAI,6BAA6B;IAC1C,QAAQ,CAAC,WAAW,+DAC0C;IAE9D;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAetD;;;;OAIG;IACG,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAqC7D"}

package/dist/migrations/ensure-expo-postinstall.js

@@ -0,0 +1,95 @@
+import * as path from "node:path";
+import { readJsonOrNull, writeJson } from "../utils/json-utils.js";
+const PACKAGE_JSON = "package.json";
+const LISA_INVOCATION = "node node_modules/@codyswann/lisa/dist/index.js --yes --skip-git-check . 2>/dev/null || true";
+const LISA_MARKER = "node_modules/@codyswann/lisa/dist/index.js";
+/**
+ * Read package.json, returning null if missing
+ * @param projectDir - Project directory containing package.json
+ * @returns Parsed package.json or null when absent/invalid
+ */
+async function readPackageJson(projectDir) {
+    return readJsonOrNull(path.join(projectDir, PACKAGE_JSON));
+}
+/**
+ * Compose the new postinstall, prepending the Lisa invocation to any existing command
+ * @param existing - Existing postinstall script (may be undefined)
+ * @returns The composed postinstall script
+ */
+function composePostinstall(existing) {
+    const trimmed = existing?.trim();
+    if (!trimmed) {
+        return LISA_INVOCATION;
+    }
+    return `${LISA_INVOCATION} && ${trimmed}`;
+}
+/**
+ * Migration: ensure Expo projects chain Lisa into their postinstall script.
+ *
+ * Some Expo projects (e.g. gsai frontend-v2, propswap/frontend) have a custom postinstall
+ * (`patch-package && ...`) that never invokes Lisa. Without the Lisa invocation, template
+ * application never runs on `bun install` after a Lisa bump. This migration prepends the
+ * standard Lisa invocation so template updates apply automatically on install.
+ */
+export class EnsureExpoPostinstallMigration {
+    name = "ensure-expo-postinstall";
+    description = "Ensure Expo projects run Lisa in their postinstall script";
+    /**
+     * Check whether this migration should run on the project
+     * @param ctx - Migration context
+     * @returns True when an Expo project is missing the Lisa invocation in postinstall
+     */
+    async applies(ctx) {
+        if (!ctx.detectedTypes.includes("expo")) {
+            return false;
+        }
+        const pkg = await readPackageJson(ctx.projectDir);
+        if (!pkg) {
+            return false;
+        }
+        const postinstall = pkg.scripts?.postinstall;
+        if (postinstall && postinstall.includes(LISA_MARKER)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Apply the migration, prepending the Lisa invocation to the project's postinstall
+     * @param ctx - Migration context
+     * @returns Result describing the action taken
+     */
+    async apply(ctx) {
+        const pkgPath = path.join(ctx.projectDir, PACKAGE_JSON);
+        const pkg = await readPackageJson(ctx.projectDir);
+        if (!pkg) {
+            return { name: this.name, action: "noop" };
+        }
+        const currentScripts = pkg.scripts ?? {};
+        const newPostinstall = composePostinstall(currentScripts.postinstall);
+        const nextPkg = {
+            ...pkg,
+            scripts: { ...currentScripts, postinstall: newPostinstall },
+        };
+        const message = currentScripts.postinstall
+            ? `Chained Lisa into existing postinstall: ${newPostinstall}`
+            : `Set postinstall to Lisa invocation: ${newPostinstall}`;
+        if (ctx.dryRun) {
+            ctx.logger.dry(`Would update package.json scripts.postinstall`);
+            return {
+                name: this.name,
+                action: "applied",
+                changedFiles: [PACKAGE_JSON],
+                message,
+            };
+        }
+        await writeJson(pkgPath, nextPkg);
+        ctx.logger.success(message);
+        return {
+            name: this.name,
+            action: "applied",
+            changedFiles: [PACKAGE_JSON],
+            message,
+        };
+    }
+}
+//# sourceMappingURL=ensure-expo-postinstall.js.map

package/dist/migrations/ensure-expo-postinstall.js.map

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

package/dist/migrations/ensure-tsconfig-local-includes.d.ts

@@ -0,0 +1,26 @@
+import type { Migration, MigrationContext, MigrationResult } from "./migration.interface.js";
+/**
+ * Migration: backfill missing include/exclude in existing tsconfig.local.json files.
+ *
+ * Before PR #373, include/exclude lived in tsconfig.json. After they moved to
+ * tsconfig.local.json (create-only), existing projects kept their include-less local
+ * tsconfig and typecheck began compiling tests, worktrees, etc. This migration injects
+ * the canonical defaults for any key that is missing without touching existing values.
+ */
+export declare class EnsureTsconfigLocalIncludesMigration implements Migration {
+    readonly name = "ensure-tsconfig-local-includes";
+    readonly description = "Backfill include/exclude in tsconfig.local.json for projects upgraded past PR #373";
+    /**
+     * Check whether this migration should run on the project
+     * @param ctx - Migration context
+     * @returns True when tsconfig.local.json exists but is missing include or exclude
+     */
+    applies(ctx: MigrationContext): Promise<boolean>;
+    /**
+     * Apply the migration, injecting any missing include/exclude keys
+     * @param ctx - Migration context
+     * @returns Result describing the action taken
+     */
+    apply(ctx: MigrationContext): Promise<MigrationResult>;
+}
+//# sourceMappingURL=ensure-tsconfig-local-includes.d.ts.map

package/dist/migrations/ensure-tsconfig-local-includes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-tsconfig-local-includes.d.ts","sourceRoot":"","sources":["../../src/migrations/ensure-tsconfig-local-includes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AA8ElC;;;;;;;GAOG;AACH,qBAAa,oCAAqC,YAAW,SAAS;IACpE,QAAQ,CAAC,IAAI,oCAAoC;IACjD,QAAQ,CAAC,WAAW,wFACmE;IAEvF;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAStD;;;;OAIG;IACG,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAgD7D"}

package/dist/migrations/ensure-tsconfig-local-includes.js

@@ -0,0 +1,125 @@
+import * as path from "node:path";
+import * as fse from "fs-extra";
+import { readJsonOrNull, writeJson } from "../utils/json-utils.js";
+const TSCONFIG_LOCAL = "tsconfig.local.json";
+/**
+ * Preferred order of project types for sourcing include/exclude defaults.
+ * The first type in detectedTypes matching this list is used.
+ */
+const TEMPLATE_PRIORITY = [
+    "expo",
+    "cdk",
+    "nestjs",
+    "npm-package",
+    "typescript",
+];
+/**
+ * Fallback defaults when the template file cannot be read (matches typescript/create-only)
+ */
+const FALLBACK_DEFAULTS = {
+    include: ["src/**/*"],
+    exclude: ["node_modules", ".build", "dist", "**/*.test.ts", "**/*.spec.ts"],
+};
+/**
+ * Return the template project type to read defaults from, or null if none applies
+ * @param detectedTypes - Detected project types for the destination project
+ * @returns The highest-priority matching project type, or null when none match
+ */
+function pickTemplateType(detectedTypes) {
+    for (const type of TEMPLATE_PRIORITY) {
+        if (detectedTypes.includes(type)) {
+            return type;
+        }
+    }
+    return null;
+}
+/**
+ * Load include/exclude defaults from a Lisa template tsconfig.local.json
+ * @param lisaDir - Lisa installation directory
+ * @param type - Project type whose template to read
+ * @returns The template's include/exclude, or the fallback defaults when absent
+ */
+async function loadTemplateDefaults(lisaDir, type) {
+    const templatePath = path.join(lisaDir, type, "create-only", TSCONFIG_LOCAL);
+    const template = await readJsonOrNull(templatePath);
+    if (!template) {
+        return FALLBACK_DEFAULTS;
+    }
+    return {
+        include: template.include ?? FALLBACK_DEFAULTS.include,
+        exclude: template.exclude ?? FALLBACK_DEFAULTS.exclude,
+    };
+}
+/**
+ * Migration: backfill missing include/exclude in existing tsconfig.local.json files.
+ *
+ * Before PR #373, include/exclude lived in tsconfig.json. After they moved to
+ * tsconfig.local.json (create-only), existing projects kept their include-less local
+ * tsconfig and typecheck began compiling tests, worktrees, etc. This migration injects
+ * the canonical defaults for any key that is missing without touching existing values.
+ */
+export class EnsureTsconfigLocalIncludesMigration {
+    name = "ensure-tsconfig-local-includes";
+    description = "Backfill include/exclude in tsconfig.local.json for projects upgraded past PR #373";
+    /**
+     * Check whether this migration should run on the project
+     * @param ctx - Migration context
+     * @returns True when tsconfig.local.json exists but is missing include or exclude
+     */
+    async applies(ctx) {
+        const tsconfigLocalPath = path.join(ctx.projectDir, TSCONFIG_LOCAL);
+        const existing = await readJsonOrNull(tsconfigLocalPath);
+        if (!existing) {
+            return false;
+        }
+        return existing.include === undefined || existing.exclude === undefined;
+    }
+    /**
+     * Apply the migration, injecting any missing include/exclude keys
+     * @param ctx - Migration context
+     * @returns Result describing the action taken
+     */
+    async apply(ctx) {
+        const tsconfigLocalPath = path.join(ctx.projectDir, TSCONFIG_LOCAL);
+        const existing = await readJsonOrNull(tsconfigLocalPath);
+        if (!existing) {
+            return { name: this.name, action: "noop" };
+        }
+        const templateType = pickTemplateType(ctx.detectedTypes);
+        const defaults = templateType
+            ? await loadTemplateDefaults(ctx.lisaDir, templateType)
+            : FALLBACK_DEFAULTS;
+        const patched = {
+            ...existing,
+            ...(existing.include === undefined ? { include: defaults.include } : {}),
+            ...(existing.exclude === undefined ? { exclude: defaults.exclude } : {}),
+        };
+        const missing = [
+            ...(existing.include === undefined ? ["include"] : []),
+            ...(existing.exclude === undefined ? ["exclude"] : []),
+        ];
+        if (missing.length === 0) {
+            return { name: this.name, action: "noop" };
+        }
+        const message = `Injected ${missing.join(", ")} into tsconfig.local.json`;
+        if (ctx.dryRun) {
+            ctx.logger.dry(`Would update tsconfig.local.json: ${missing.join(", ")}`);
+            return {
+                name: this.name,
+                action: "applied",
+                changedFiles: [TSCONFIG_LOCAL],
+                message,
+            };
+        }
+        await fse.ensureDir(path.dirname(tsconfigLocalPath));
+        await writeJson(tsconfigLocalPath, patched);
+        ctx.logger.success(message);
+        return {
+            name: this.name,
+            action: "applied",
+            changedFiles: [TSCONFIG_LOCAL],
+            message,
+        };
+    }
+}
+//# sourceMappingURL=ensure-tsconfig-local-includes.js.map

package/dist/migrations/ensure-tsconfig-local-includes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-tsconfig-local-includes.js","sourceRoot":"","sources":["../../src/migrations/ensure-tsconfig-local-includes.ts"],"names":[],"mappings":"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"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,32 @@
+import type { Migration, MigrationContext, MigrationResult } from "./migration.interface.js";
+export type { Migration, MigrationAction, MigrationContext, MigrationResult, } from "./migration.interface.js";
+export { EnsureExpoPostinstallMigration } from "./ensure-expo-postinstall.js";
+export { EnsureTsconfigLocalIncludesMigration } from "./ensure-tsconfig-local-includes.js";
+/**
+ * Registry that runs applicable migrations against a destination project
+ */
+export declare class MigrationRegistry {
+    private readonly migrations;
+    /**
+     * Initialize registry with provided or default migrations
+     * @param migrations - Optional array of migrations (uses defaults if omitted)
+     */
+    constructor(migrations?: readonly Migration[]);
+    /**
+     * Get all registered migrations
+     * @returns All migrations in registration order
+     */
+    getAll(): readonly Migration[];
+    /**
+     * Run every migration whose `applies` returns true
+     * @param ctx - Migration context
+     * @returns Aggregated results from every registered migration
+     */
+    runAll(ctx: MigrationContext): Promise<readonly MigrationResult[]>;
+}
+/**
+ * Create the default migration registry
+ * @returns New MigrationRegistry with all default migrations registered
+ */
+export declare function createMigrationRegistry(): MigrationRegistry;
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAE3F;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAElD;;;OAGG;gBACS,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE;IAO7C;;;OAGG;IACH,MAAM,IAAI,SAAS,SAAS,EAAE;IAI9B;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;CAazE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D"}

package/dist/migrations/index.js

@@ -0,0 +1,53 @@
+import { EnsureExpoPostinstallMigration } from "./ensure-expo-postinstall.js";
+import { EnsureTsconfigLocalIncludesMigration } from "./ensure-tsconfig-local-includes.js";
+export { EnsureExpoPostinstallMigration } from "./ensure-expo-postinstall.js";
+export { EnsureTsconfigLocalIncludesMigration } from "./ensure-tsconfig-local-includes.js";
+/**
+ * Registry that runs applicable migrations against a destination project
+ */
+export class MigrationRegistry {
+    migrations;
+    /**
+     * Initialize registry with provided or default migrations
+     * @param migrations - Optional array of migrations (uses defaults if omitted)
+     */
+    constructor(migrations) {
+        this.migrations = migrations ?? [
+            new EnsureTsconfigLocalIncludesMigration(),
+            new EnsureExpoPostinstallMigration(),
+        ];
+    }
+    /**
+     * Get all registered migrations
+     * @returns All migrations in registration order
+     */
+    getAll() {
+        return this.migrations;
+    }
+    /**
+     * Run every migration whose `applies` returns true
+     * @param ctx - Migration context
+     * @returns Aggregated results from every registered migration
+     */
+    async runAll(ctx) {
+        const results = [];
+        for (const migration of this.migrations) {
+            const shouldRun = await migration.applies(ctx);
+            if (!shouldRun) {
+                results.push({ name: migration.name, action: "skipped" });
+                continue;
+            }
+            const result = await migration.apply(ctx);
+            results.push(result);
+        }
+        return results;
+    }
+}
+/**
+ * Create the default migration registry
+ * @returns New MigrationRegistry with all default migrations registered
+ */
+export function createMigrationRegistry() {
+    return new MigrationRegistry();
+}
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAa3F,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAE3F;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACX,UAAU,CAAuB;IAElD;;;OAGG;IACH,YAAY,UAAiC;QAC3C,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI;YAC9B,IAAI,oCAAoC,EAAE;YAC1C,IAAI,8BAA8B,EAAE;SACrC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,GAAqB;QAChC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC1D,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,IAAI,iBAAiB,EAAE,CAAC;AACjC,CAAC"}

package/dist/migrations/migration.interface.d.ts

@@ -0,0 +1,48 @@
+import type { ProjectType } from "../core/config.js";
+import type { ILogger } from "../logging/index.js";
+/**
+ * Action performed by a migration run
+ */
+export type MigrationAction = "applied" | "skipped" | "noop";
+/**
+ * Context passed to migrations at runtime
+ */
+export interface MigrationContext {
+    /** Destination project directory */
+    readonly projectDir: string;
+    /** Lisa installation directory (where templates live) */
+    readonly lisaDir: string;
+    /** Project types detected for the destination project */
+    readonly detectedTypes: readonly ProjectType[];
+    /** If true, describe what would change without modifying files */
+    readonly dryRun: boolean;
+    /** Logger for user-facing output */
+    readonly logger: ILogger;
+}
+/**
+ * Result of running a migration
+ */
+export interface MigrationResult {
+    readonly name: string;
+    readonly action: MigrationAction;
+    readonly changedFiles?: readonly string[];
+    readonly message?: string;
+}
+/**
+ * One-time idempotent transform applied to an existing project
+ */
+export interface Migration {
+    readonly name: string;
+    readonly description: string;
+    /**
+     * Whether this migration should run on this project.
+     * @param ctx Migration context
+     */
+    applies(ctx: MigrationContext): Promise<boolean>;
+    /**
+     * Apply the migration. Must be idempotent.
+     * @param ctx Migration context
+     */
+    apply(ctx: MigrationContext): Promise<MigrationResult>;
+}
+//# sourceMappingURL=migration.interface.d.ts.map

package/dist/migrations/migration.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.interface.d.ts","sourceRoot":"","sources":["../../src/migrations/migration.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,yDAAyD;IACzD,QAAQ,CAAC,aAAa,EAAE,SAAS,WAAW,EAAE,CAAC;IAE/C,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACxD"}

package/dist/migrations/migration.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migration.interface.js.map

package/dist/migrations/migration.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.interface.js","sourceRoot":"","sources":["../../src/migrations/migration.interface.ts"],"names":[],"mappings":""}

package/package.json

@@ -76,7 +76,7 @@
     "lodash": ">=4.18.1"
   },
   "name": "@codyswann/lisa",
-  "version": "1.82.2",
+  "version": "1.83.1",
   "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": "1.82.2",
+  "version": "1.83.1",
   "description": "Universal governance — agents, skills, commands, hooks, and rules for all projects",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa/agents/jira-agent.md

@@ -2,6 +2,8 @@
 name: jira-agent
 description: JIRA lifecycle agent. Reads tickets, determines intent (Bug → Implement/Fix, Story/Task → Implement/Build, Epic → Plan, Spike → Implement/Investigate), delegates to the appropriate flow, syncs progress at milestones, and posts evidence at completion.
 skills:
+  - jira-read-ticket
+  - jira-write-ticket
   - jira-sync
   - jira-evidence
   - jira-verify
@@ -17,13 +19,20 @@ You are a JIRA lifecycle agent. Your job is to read a JIRA ticket, determine wha
 
 ### 1. Read the Ticket
 
-Read the ticket fully using the Atlassian MCP tools or CLI:
-- Description, comments, attachments, linked issues
-- Epic parent, subtasks, story points
-- Current status, assignee, labels
-- Extract any credentials, URLs, or reproduction steps from the ticket body
+Invoke the `jira-read-ticket` skill with the ticket key. This is mandatory — do NOT read the ticket ad-hoc via MCP calls. The skill fetches the primary ticket AND its full graph in one pass:
 
-If you cannot access the ticket, stop and report what access is needed.
+- Full description, acceptance criteria, Validation Journey
+- All comments in chronological order
+- All metadata (status, assignee, labels, components, fix version, priority, story points, sprint)
+- Remote links — PRs (with state and unresolved review comments via `gh`), Confluence pages, dashboards
+- Every linked ticket (`blocks`, `is blocked by`, `relates to`, `duplicates`, `clones`) with their descriptions, statuses, and recent comments
+- Epic parent — full description, comments, and acceptance criteria
+- Epic siblings — so you see in-flight related work before starting
+- Subtasks
+
+Pass the resulting context bundle verbatim to every downstream agent. Extract credentials, URLs, and reproduction steps from the bundle. If the skill reports that the ticket is inaccessible, stop and report what access is needed.
+
+**Never act on a ticket in isolation.** If the bundle shows open blockers, flag them and stop. If it shows an epic sibling in progress with a different assignee, surface that before proceeding so work isn't duplicated.
 
 ### 2. Validate Ticket Quality
 
@@ -97,7 +106,7 @@ Based on the milestone, suggest (but don't auto-transition):
 ## Rules
 
 - Never auto-transition ticket status — always suggest and let the human confirm
-- Always read the full ticket before determining intent — don't rely on ticket type alone
-- If the ticket references other tickets, read those too for context
+- Always read the full ticket graph via `jira-read-ticket` before determining intent — don't rely on ticket type alone
+- Never create or materially edit a ticket by calling MCP write tools directly — always delegate to `jira-write-ticket` so relationships, Gherkin criteria, and metadata gates are enforced
 - If sign-in credentials are in the ticket, extract and pass them to the flow
 - If the ticket has a Validation Journey section, pass it to the verifier agent

package/plugins/lisa/agents/spec-conformance-specialist.md

@@ -0,0 +1,49 @@
+---
+name: spec-conformance-specialist
+description: "Spec conformance specialist agent. Verifies shipped work matches its spec exactly — acceptance criteria, Out of Scope, Technical Approach, Validation Journey assertions, and deliverables. Produces a coverage matrix, flags scope creep separately from misses, and issues a verdict (CONFORMS / PARTIAL / DIVERGES). Runs alongside verification-specialist and product-specialist during the verification phase; they catch different failure modes."
+skills:
+  - spec-conformance
+  - jira-read-ticket
+---
+
+# Spec Conformance Specialist Agent
+
+You are a spec conformance specialist. Your job is to prove that the shipped work matches its spec **exactly** — nothing more, nothing less.
+
+## Scope
+
+You answer one question: **Does what shipped match what was asked?**
+
+That is distinct from two adjacent questions that other agents own:
+
+| Question | Owner |
+|----------|-------|
+| Does the system actually run and produce correct observable output? | `verification-specialist` |
+| Is the user experience coherent and are error states humane? | `product-specialist` |
+| Does every line of shipped code trace back to a requirement, and is nothing missing from the spec? | **you** |
+
+You depend on `verification-specialist`'s empirical evidence — you do not gather it yourself. If their report is not available, request it before producing a verdict.
+
+## Process
+
+Follow the `spec-conformance` skill end-to-end:
+
+1. Resolve the spec source (plan file, JIRA key, Linear, GitHub issue, PRD).
+2. Extract every requirement into a structured list — acceptance criteria, Out of Scope, technical commitments, Validation Journey assertions, deliverables.
+3. Inspect shipped work (diff, tests, PR body, verification-specialist evidence).
+4. Build the coverage matrix — every requirement gets a row with a status.
+5. Detect scope creep and untraceable changes separately.
+6. Produce the verdict.
+
+## Output
+
+Return the structured report defined in the skill. Never summarize or drop rows. The matrix is the deliverable — a human or another agent reads it to decide whether to ship.
+
+## Rules
+
+- **Require empirical evidence.** A requirement is not `MATCH` because code exists. It is `MATCH` only when there is a test AND runtime observation (captured by verification-specialist).
+- **Scope creep is a distinct failure.** Do not fold `SCOPE_CREEP_VIOLATION` into "missing" or "untraceable." Scope creep means Out of Scope was violated — it blocks shipping.
+- **Untraceable changes get surfaced, not judged.** Refactors and test helpers often land here. Surface them so the human can confirm intent; do not automatically fail.
+- **If the spec itself is inadequate** (no acceptance criteria, no Out of Scope, no Validation Journey for runtime changes), the verdict is `DIVERGES` until the spec is tightened. Do not paper over an ambiguous spec with a generous match.
+- **Never gather empirical evidence yourself.** That is verification-specialist's job. You read their report. If it's missing, block and ask.
+- **Never approve your own work.** If you produced the implementation in this session, say so explicitly in the report and recommend the human double-check — self-review of conformance is weakest when the same mind built the thing.

package/plugins/lisa/agents/verification-specialist.md

@@ -4,6 +4,7 @@ description: Verification specialist agent. Discovers project tooling and execut
 skills:
   - verification-lifecycle
   - jira-journey
+  - spec-conformance
 ---
 
 # Verification Specialist Agent

package/plugins/lisa/commands/jira/read-ticket.md

@@ -0,0 +1,7 @@
+---
+description: "Read a JIRA ticket with full scope — metadata, comments, remote PRs, linked tickets, epic siblings, subtasks"
+allowed-tools: ["Skill"]
+argument-hint: "<TICKET-ID>"
+---
+
+Use the /lisa:jira-read-ticket skill to fetch the full scope of the JIRA ticket and its related graph. $ARGUMENTS

package/plugins/lisa/commands/jira/write-ticket.md

@@ -0,0 +1,7 @@
+---
+description: "Create or update a JIRA ticket with enforced relationships, Gherkin criteria, and metadata quality gates"
+allowed-tools: ["Skill"]
+argument-hint: "[TICKET-ID | <create-intent-description>]"
+---
+
+Use the /lisa:jira-write-ticket skill to create or update the JIRA ticket with full relationship discovery and quality enforcement. $ARGUMENTS

package/plugins/lisa/commands/spec-conformance.md

@@ -0,0 +1,7 @@
+---
+description: "Verify shipped work matches its spec — coverage matrix with scope-creep detection and verdict"
+allowed-tools: ["Skill"]
+argument-hint: "[plan-file | TICKET-KEY | issue-url]"
+---
+
+Use the /lisa:spec-conformance skill to compare shipped work against its spec and produce a coverage matrix with verdict. $ARGUMENTS

package/plugins/lisa/skills/jira-create/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: jira-create
 description: This skill should be used when creating JIRA epics, stories, and tasks from code files or descriptions. It analyzes the provided input, determines the appropriate issue hierarchy, and creates issues with comprehensive quality requirements including test-first development and documentation.
-allowed-tools: ["Read", "Glob", "LS", "mcp__atlassian__createJiraIssue", "mcp__atlassian__getVisibleJiraProjects", "mcp__atlassian__getJiraProjectIssueTypesMetadata", "mcp__atlassian__getAccessibleAtlassianResources"]
+allowed-tools: ["Read", "Glob", "LS", "Skill", "mcp__atlassian__getVisibleJiraProjects", "mcp__atlassian__getJiraProjectIssueTypesMetadata", "mcp__atlassian__getAccessibleAtlassianResources"]
 ---
 
 # Create JIRA Issues from $ARGUMENTS
@@ -93,3 +93,9 @@ Default project: from jira-cli config (override via arguments)
 Exclude unless requested: migration plans, performance tests
 
 Execute the analysis and create the complete JIRA structure with proper parent-child relationships.
+
+## Delegation to jira-write-ticket
+
+For every individual ticket that will be created, delegate to the `jira-write-ticket` skill rather than calling `mcp__atlassian__createJiraIssue` directly. `jira-write-ticket` enforces description quality (Gherkin acceptance criteria, stakeholder/developer/assistant sections), relationship discovery (`blocks`, `is blocked by`, `relates to`, remote PR/Confluence/dashboard links), epic parent validation, and post-create verification.
+
+This skill's role is to analyze the input and decide the hierarchy (which epics, which stories, which tasks, in what parent-child structure). `jira-write-ticket` handles the actual write with full quality gates.