@intelligo-dev/cli 1.0.0-beta.1

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AASF,wBAAgB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,WAAW,EAAE,CAkHpE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAK5D;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAE1D"}

package/dist/commands/doctor.js

@@ -0,0 +1,129 @@
+/**
+ * `intelligo doctor` — report the problems that are invisible until
+ * they are an incident.
+ *
+ * The checks here were each chosen because something in this codebase
+ * actually went wrong that way, not because they sounded thorough.
+ */
+import path from "node:path";
+import { existsSync } from "node:fs";
+import { inspectMigrationChain, readMigrationChain } from "../migrations.js";
+import { readManifest } from "../manifest.js";
+import { MIGRATION_LOCATIONS, resolveMigrationsDir, } from "../migrations-dir.js";
+/** Variables the app cannot boot without. */
+const REQUIRED_ENV = [
+    "DATABASE_URL",
+    "BETTER_AUTH_SECRET",
+    "NEXT_PUBLIC_APP_URL",
+];
+export function runChecks(options = {}) {
+    const root = options.root ?? process.cwd();
+    const env = options.env ?? process.env;
+    const results = [];
+    // 1. Migration chain — the journal/disk drift that made the .sql
+    //    files documentation rather than a provisioning mechanism.
+    const migrationsDir = resolveMigrationsDir(root);
+    if (!migrationsDir) {
+        results.push({
+            name: "migrations",
+            status: "warn",
+            detail: `No migrations directory (looked in ${MIGRATION_LOCATIONS.join(", ")}) — run from the workspace root, with @intelligo-dev/core installed?`,
+        });
+    }
+    else {
+        const chain = readMigrationChain(migrationsDir);
+        const problems = inspectMigrationChain(chain);
+        if (problems.length === 0) {
+            results.push({
+                name: "migrations",
+                status: "ok",
+                detail: `${chain.files.length} migrations, all registered in the journal`,
+            });
+        }
+        else {
+            for (const p of problems) {
+                results.push({
+                    name: "migrations",
+                    status: p.level === "error" ? "error" : "warn",
+                    detail: p.message,
+                });
+            }
+        }
+    }
+    // 2. Required environment.
+    const missing = REQUIRED_ENV.filter((k) => !env[k]);
+    results.push(missing.length === 0
+        ? {
+            name: "env",
+            status: "ok",
+            detail: `${REQUIRED_ENV.length} required variables present`,
+        }
+        : {
+            name: "env",
+            status: "error",
+            detail: `Missing: ${missing.join(", ")}`,
+        });
+    // 3. Billing product. The engine has no built-in default since the
+    //    Career catalogue moved out; an unset product means every plan
+    //    lookup returns nothing and quotas silently read as zero.
+    results.push(env.INTELLIGO_BILLING_PRODUCT
+        ? {
+            name: "billing",
+            status: "ok",
+            detail: `Product: ${env.INTELLIGO_BILLING_PRODUCT}`,
+        }
+        : {
+            name: "billing",
+            status: "warn",
+            detail: "INTELLIGO_BILLING_PRODUCT unset — the composition root must call " +
+                "setDefaultProductSlug(), or plan lookups resolve to nothing",
+        });
+    // 4. Chat route's scaffold contract. The registry's chat item ships
+    //    app/api/chat/route.ts, which imports @/lib/intelligo (the
+    //    composition root) and expects @/lib/plans to have registered a
+    //    plan catalogue — both are scaffold-provided consumer files, not
+    //    registry files. Installing chat into a hand-rolled app without
+    //    them is a build error that only shows up at `next build`.
+    const chatRoute = path.join(root, "app/api/chat/route.ts");
+    if (existsSync(chatRoute)) {
+        const missingScaffold = ["lib/intelligo.ts", "lib/plans.ts"].filter((rel) => !existsSync(path.join(root, rel)));
+        results.push(missingScaffold.length === 0
+            ? {
+                name: "chat",
+                status: "ok",
+                detail: "app/api/chat/route.ts has lib/intelligo.ts + lib/plans.ts",
+            }
+            : {
+                name: "chat",
+                status: "error",
+                detail: `app/api/chat/route.ts needs ${missingScaffold.join(" and ")} — ` +
+                    "create them from the CLI's app-scaffold templates " +
+                    "(packages/cli/templates/app-scaffold)",
+            });
+    }
+    // 5. Generated source. A conflict — template and consumer both
+    //    moved — is the one state an upgrade cannot resolve on its own.
+    const manifest = readManifest(root);
+    if (manifest) {
+        const features = Object.keys(manifest.features);
+        results.push({
+            name: "generated",
+            status: "ok",
+            detail: features.length === 0
+                ? "manifest present, no features generated"
+                : `${features.length} feature(s): ${features.join(", ")} — run \`intelligo upgrade --check\` for detail`,
+        });
+    }
+    return results;
+}
+export function formatResults(results) {
+    const icon = { ok: "✓", warn: "!", error: "✗" };
+    return results
+        .map((r) => `${icon[r.status]} ${r.name.padEnd(12)} ${r.detail}`)
+        .join("\n");
+}
+/** Process exit code: non-zero when any check errored. */
+export function exitCodeFor(results) {
+    return results.some((r) => r.status === "error") ? 1 : 0;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/migrate-check.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `intelligo migrate --check`
+ *
+ * Answers "would deploying this code against that database work?"
+ * without changing anything. Two failure modes matter and neither is
+ * visible from the code alone:
+ *
+ *   - migrations the database has not applied yet (deploying now runs
+ *     code against an older schema);
+ *   - migrations the database has applied that this checkout does not
+ *     contain (the database is ahead — usually a rollback in progress).
+ *
+ * Drizzle records applied migrations in `drizzle.__drizzle_migrations`
+ * by content hash. A database provisioned with `db:push` has the
+ * schema but no rows there at all, which this reports distinctly:
+ * "unmanaged" is a different problem from "behind", and baselining is
+ * the fix (see the migrations README).
+ */
+export type MigrateCheckResult = {
+    /** Journal tags this checkout knows about, in order. */
+    chain: string[];
+    /** Applied according to the database. */
+    applied: string[];
+    /** In the chain but not applied — a deploy would run against an older schema. */
+    pending: string[];
+    /** Applied but absent from this checkout — the database is ahead. */
+    unknown: string[];
+    /**
+     * True when the migrations table is empty or missing while the
+     * schema exists — a push-provisioned database that needs baselining.
+     */
+    unmanaged: boolean;
+};
+/** Drizzle hashes the file contents with sha256. */
+export declare function hashMigration(sql: string): string;
+type QueryFn = (sql: string) => Promise<Array<{
+    hash: string;
+}>>;
+export declare function migrateCheck(migrationsDir: string, query: QueryFn): Promise<MigrateCheckResult>;
+export declare function formatMigrateCheck(r: MigrateCheckResult): string;
+/** Non-zero when deploying this code would run against a stale schema. */
+export declare function migrateCheckExitCode(r: MigrateCheckResult): number;
+export {};
+//# sourceMappingURL=migrate-check.d.ts.map

package/dist/commands/migrate-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-check.d.ts","sourceRoot":"","sources":["../../src/commands/migrate-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iFAAiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAEjE,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,kBAAkB,CAAC,CA2C7B;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CA4BhE;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAElE"}

package/dist/commands/migrate-check.js

@@ -0,0 +1,92 @@
+/**
+ * `intelligo migrate --check`
+ *
+ * Answers "would deploying this code against that database work?"
+ * without changing anything. Two failure modes matter and neither is
+ * visible from the code alone:
+ *
+ *   - migrations the database has not applied yet (deploying now runs
+ *     code against an older schema);
+ *   - migrations the database has applied that this checkout does not
+ *     contain (the database is ahead — usually a rollback in progress).
+ *
+ * Drizzle records applied migrations in `drizzle.__drizzle_migrations`
+ * by content hash. A database provisioned with `db:push` has the
+ * schema but no rows there at all, which this reports distinctly:
+ * "unmanaged" is a different problem from "behind", and baselining is
+ * the fix (see the migrations README).
+ */
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { readMigrationChain } from "../migrations.js";
+/** Drizzle hashes the file contents with sha256. */
+export function hashMigration(sql) {
+    return createHash("sha256").update(sql).digest("hex");
+}
+export async function migrateCheck(migrationsDir, query) {
+    const chain = readMigrationChain(migrationsDir);
+    const hashToTag = new Map();
+    for (const tag of chain.journalTags) {
+        const file = path.join(migrationsDir, `${tag}.sql`);
+        try {
+            hashToTag.set(hashMigration(readFileSync(file, "utf8")), tag);
+        }
+        catch {
+            // readMigrationChain already reports files the journal names but
+            // that are not on disk; nothing to hash here.
+        }
+    }
+    let rows = [];
+    let tableMissing = false;
+    try {
+        rows = await query(`SELECT hash FROM drizzle.__drizzle_migrations ORDER BY created_at`);
+    }
+    catch {
+        tableMissing = true;
+    }
+    const appliedHashes = new Set(rows.map((r) => r.hash));
+    const applied = [];
+    const unknown = [];
+    for (const hash of appliedHashes) {
+        const tag = hashToTag.get(hash);
+        if (tag)
+            applied.push(tag);
+        else
+            unknown.push(hash.slice(0, 12));
+    }
+    const appliedTags = new Set(applied);
+    const pending = chain.journalTags.filter((t) => !appliedTags.has(t));
+    return {
+        chain: chain.journalTags,
+        applied,
+        pending,
+        unknown,
+        unmanaged: tableMissing || appliedHashes.size === 0,
+    };
+}
+export function formatMigrateCheck(r) {
+    const lines = [];
+    if (r.unmanaged) {
+        lines.push(`! This database has no migration records. If it was provisioned with ` +
+            `db:push, baseline it before running migrate — otherwise migrate will ` +
+            `try to apply all ${r.chain.length} migrations. See ` +
+            `packages/core/src/db/migrations/README.md`);
+    }
+    if (r.unknown.length > 0) {
+        lines.push(`✗ Database is ahead: ${r.unknown.length} applied migration(s) are not in ` +
+            `this checkout (${r.unknown.join(", ")})`);
+    }
+    if (r.pending.length > 0) {
+        lines.push(`✗ ${r.pending.length} migration(s) pending: ${r.pending.join(", ")}`);
+    }
+    else if (!r.unmanaged) {
+        lines.push(`✓ Up to date (${r.applied.length}/${r.chain.length} applied)`);
+    }
+    return lines.join("\n");
+}
+/** Non-zero when deploying this code would run against a stale schema. */
+export function migrateCheckExitCode(r) {
+    return r.pending.length > 0 || r.unknown.length > 0 ? 1 : 0;
+}
+//# sourceMappingURL=migrate-check.js.map

package/dist/commands/migrate-check.js.map

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

package/dist/commands/upgrade-check.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `intelligo upgrade --check`
+ *
+ * Reports what a template upgrade would do, and does nothing. The
+ * promise in ADR-0002 is that dependency upgrades never overwrite
+ * consumer source, so the interesting output is not "these files
+ * changed upstream" but "these changed upstream AND you have edited
+ * them" — the set where the consumer has to make a decision.
+ */
+export type UpgradeItem = {
+    feature: string;
+    path: string;
+    /**
+     * - `current`    — generated file matches the current template
+     * - `outdated`   — template changed; the local copy is untouched, so
+     *                  re-generating is safe
+     * - `conflict`   — template changed AND the consumer edited the file
+     * - `customized` — consumer edited it; template unchanged
+     * - `deleted`    — consumer removed it
+     */
+    state: "current" | "outdated" | "conflict" | "customized" | "deleted";
+};
+export type UpgradeReport = {
+    installedVersion: Record<string, string>;
+    templateVersion: Record<string, string>;
+    items: UpgradeItem[];
+};
+export type UpgradeCheckOptions = {
+    appRoot: string;
+    templatesDir: string;
+};
+export declare function upgradeCheck(options: UpgradeCheckOptions): UpgradeReport;
+export declare function formatUpgradeReport(r: UpgradeReport): string;
+/**
+ * Non-zero only on conflicts. An outdated-but-untouched file is not a
+ * problem to fail a build over; a file that changed on both sides is a
+ * decision someone has to make.
+ */
+export declare function upgradeCheckExitCode(r: UpgradeReport): number;
+//# sourceMappingURL=upgrade-check.d.ts.map

package/dist/commands/upgrade-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-check.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;CACvE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAwDxE;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CA0B5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAE7D"}

package/dist/commands/upgrade-check.js

@@ -0,0 +1,91 @@
+/**
+ * `intelligo upgrade --check`
+ *
+ * Reports what a template upgrade would do, and does nothing. The
+ * promise in ADR-0002 is that dependency upgrades never overwrite
+ * consumer source, so the interesting output is not "these files
+ * changed upstream" but "these changed upstream AND you have edited
+ * them" — the set where the consumer has to make a decision.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { readCatalogue } from "./add.js";
+import { hashContents, readManifest } from "../manifest.js";
+export function upgradeCheck(options) {
+    const manifest = readManifest(options.appRoot);
+    if (!manifest) {
+        return { installedVersion: {}, templateVersion: {}, items: [] };
+    }
+    const catalogue = readCatalogue(options.templatesDir);
+    const report = {
+        installedVersion: {},
+        templateVersion: {},
+        items: [],
+    };
+    for (const [feature, entry] of Object.entries(manifest.features)) {
+        const spec = catalogue[feature];
+        report.installedVersion[feature] = entry.templateVersion;
+        if (spec)
+            report.templateVersion[feature] = spec.templateVersion;
+        const targetToTemplate = new Map((spec?.files ?? []).map((f) => [f.target, f.template]));
+        for (const file of entry.files) {
+            const abs = path.join(options.appRoot, file.path);
+            if (!existsSync(abs)) {
+                report.items.push({ feature, path: file.path, state: "deleted" });
+                continue;
+            }
+            const localHash = hashContents(readFileSync(abs, "utf8"));
+            const customized = localHash !== file.hash;
+            const templateRel = targetToTemplate.get(file.path);
+            let templateChanged = false;
+            if (templateRel) {
+                const templateHash = hashContents(readFileSync(path.join(options.templatesDir, templateRel), "utf8"));
+                templateChanged = templateHash !== file.hash;
+            }
+            report.items.push({
+                feature,
+                path: file.path,
+                state: templateChanged
+                    ? customized
+                        ? "conflict"
+                        : "outdated"
+                    : customized
+                        ? "customized"
+                        : "current",
+            });
+        }
+    }
+    return report;
+}
+export function formatUpgradeReport(r) {
+    if (r.items.length === 0) {
+        return "No generated files recorded — nothing to upgrade.";
+    }
+    const label = {
+        current: "✓ up to date",
+        outdated: "↑ template changed — safe to re-run `intelligo add`",
+        conflict: "! template changed AND you edited it — review the diff",
+        customized: "= yours (template unchanged)",
+        deleted: "✗ removed by you",
+    };
+    const lines = [];
+    for (const [feature, installed] of Object.entries(r.installedVersion)) {
+        const latest = r.templateVersion[feature];
+        lines.push(latest && latest !== installed
+            ? `${feature}: ${installed} → ${latest}`
+            : `${feature}: ${installed}`);
+        for (const item of r.items.filter((i) => i.feature === feature)) {
+            lines.push(`  ${label[item.state]}  ${item.path}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Non-zero only on conflicts. An outdated-but-untouched file is not a
+ * problem to fail a build over; a file that changed on both sides is a
+ * decision someone has to make.
+ */
+export function upgradeCheckExitCode(r) {
+    return r.items.some((i) => i.state === "conflict") ? 1 : 0;
+}
+//# sourceMappingURL=upgrade-check.js.map

package/dist/commands/upgrade-check.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @intelligo-dev/cli — operational commands for an Intelligo application.
+ *
+ * Exported as functions as well as a binary so CI can call the checks
+ * directly (see the migration-chain gate) without shelling out.
+ */
+export { runChecks, formatResults, exitCodeFor, type CheckResult, type DoctorOptions, } from "./commands/doctor.js";
+export { migrateCheck, hashMigration, formatMigrateCheck, migrateCheckExitCode, type MigrateCheckResult, } from "./commands/migrate-check.js";
+export { readMigrationChain, inspectMigrationChain, type MigrationChain, type ChainProblem, } from "./migrations.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,kBAAkB,GACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @intelligo-dev/cli — operational commands for an Intelligo application.
+ *
+ * Exported as functions as well as a binary so CI can call the checks
+ * directly (see the migration-chain gate) without shelling out.
+ */
+export { runChecks, formatResults, exitCodeFor, } from "./commands/doctor.js";
+export { migrateCheck, hashMigration, formatMigrateCheck, migrateCheckExitCode, } from "./commands/migrate-check.js";
+export { readMigrationChain, inspectMigrationChain, } from "./migrations.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,GAGZ,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GAErB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GAGtB,MAAM,iBAAiB,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Generated-source manifest.
+ *
+ * Intelligo generates starting source into the consumer's repository
+ * and then stops owning it (ADR-0002). That promise needs a mechanism,
+ * because "never overwrite a customized file" requires knowing which
+ * files were generated, from which template version, and whether the
+ * consumer has since edited them.
+ *
+ * The manifest records a content hash per generated file at the moment
+ * it was written. A file whose hash still matches was not touched and
+ * can be re-generated safely; one whose hash differs is the consumer's
+ * code now, and an upgrade may only show them a diff.
+ *
+ * Deliberately not a lockfile of package versions: it tracks template
+ * provenance, not dependencies.
+ */
+export declare const MANIFEST_FILE = "intelligo.manifest.json";
+export type GeneratedFile = {
+    /** Path relative to the consumer application root. */
+    path: string;
+    /** sha256 of the contents Intelligo wrote. */
+    hash: string;
+};
+export type FeatureEntry = {
+    templateVersion: string;
+    files: GeneratedFile[];
+};
+export type Manifest = {
+    schemaVersion: 1;
+    frameworkVersion: string;
+    features: Record<string, FeatureEntry>;
+};
+export declare function hashContents(contents: string): string;
+export declare function emptyManifest(frameworkVersion: string): Manifest;
+export declare function readManifest(appRoot: string): Manifest | null;
+export declare function writeManifest(appRoot: string, manifest: Manifest): void;
+/**
+ * What happened to a generated file since it was written.
+ *
+ * `customized` is the state the whole mechanism exists to detect: the
+ * consumer owns that file now, and an upgrade must not touch it.
+ */
+export type FileState = "unchanged" | "customized" | "deleted";
+export type FileStatus = {
+    path: string;
+    state: FileState;
+};
+export declare function inspectFile(appRoot: string, file: GeneratedFile): FileStatus;
+export declare function inspectFeature(appRoot: string, entry: FeatureEntry): FileStatus[];
+/**
+ * Record a feature's generated files, replacing any previous entry for
+ * the same feature — re-generating is how a consumer accepts a new
+ * template version, and the recorded hashes must then describe what is
+ * actually on disk.
+ */
+export declare function recordFeature(manifest: Manifest, feature: string, templateVersion: string, files: GeneratedFile[]): Manifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,eAAO,MAAM,aAAa,4BAA4B,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAC1B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,aAAa,EAAE,CAAC,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC,CAAC;AAEF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAAC,gBAAgB,EAAE,MAAM,GAAG,QAAQ,CAEhE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAI7D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAKvE;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,UAAU,CAS5E;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,GAClB,UAAU,EAAE,CAEd;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,aAAa,EAAE,GACrB,QAAQ,CAQV"}

package/dist/manifest.js

@@ -0,0 +1,65 @@
+/**
+ * Generated-source manifest.
+ *
+ * Intelligo generates starting source into the consumer's repository
+ * and then stops owning it (ADR-0002). That promise needs a mechanism,
+ * because "never overwrite a customized file" requires knowing which
+ * files were generated, from which template version, and whether the
+ * consumer has since edited them.
+ *
+ * The manifest records a content hash per generated file at the moment
+ * it was written. A file whose hash still matches was not touched and
+ * can be re-generated safely; one whose hash differs is the consumer's
+ * code now, and an upgrade may only show them a diff.
+ *
+ * Deliberately not a lockfile of package versions: it tracks template
+ * provenance, not dependencies.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+export const MANIFEST_FILE = "intelligo.manifest.json";
+export function hashContents(contents) {
+    return createHash("sha256").update(contents).digest("hex");
+}
+export function emptyManifest(frameworkVersion) {
+    return { schemaVersion: 1, frameworkVersion, features: {} };
+}
+export function readManifest(appRoot) {
+    const file = path.join(appRoot, MANIFEST_FILE);
+    if (!existsSync(file))
+        return null;
+    return JSON.parse(readFileSync(file, "utf8"));
+}
+export function writeManifest(appRoot, manifest) {
+    writeFileSync(path.join(appRoot, MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}\n`);
+}
+export function inspectFile(appRoot, file) {
+    const abs = path.join(appRoot, file.path);
+    if (!existsSync(abs))
+        return { path: file.path, state: "deleted" };
+    const current = hashContents(readFileSync(abs, "utf8"));
+    return {
+        path: file.path,
+        state: current === file.hash ? "unchanged" : "customized",
+    };
+}
+export function inspectFeature(appRoot, entry) {
+    return entry.files.map((f) => inspectFile(appRoot, f));
+}
+/**
+ * Record a feature's generated files, replacing any previous entry for
+ * the same feature — re-generating is how a consumer accepts a new
+ * template version, and the recorded hashes must then describe what is
+ * actually on disk.
+ */
+export function recordFeature(manifest, feature, templateVersion, files) {
+    return {
+        ...manifest,
+        features: {
+            ...manifest.features,
+            [feature]: { templateVersion, files },
+        },
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAoBvD,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,gBAAwB;IACpD,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,QAAkB;IAC/D,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACjC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACzC,CAAC;AACJ,CAAC;AAeD,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAmB;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAEnE,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,KAAmB;IAEnB,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAkB,EAClB,OAAe,EACf,eAAuB,EACvB,KAAsB;IAEtB,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE;YACR,GAAG,QAAQ,CAAC,QAAQ;YACpB,CAAC,OAAO,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;SACtC;KACF,CAAC;AACJ,CAAC"}

package/dist/migrations-dir.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Where the framework's migration chain lives, relative to the
+ * directory the CLI is run from.
+ *
+ * Two layouts are real: the framework repository itself, where core is
+ * a workspace package, and a consumer application, where core arrives
+ * from the registry and ships its migrations inside the package (they
+ * are in `files`, next to `dist`). The first match wins, so a checkout
+ * that has both — the framework repo — reads its own source.
+ */
+export declare const MIGRATION_LOCATIONS: readonly ["packages/core/src/db/migrations", "node_modules/@intelligo-dev/core/src/db/migrations"];
+export declare function resolveMigrationsDir(root: string): string | null;
+//# sourceMappingURL=migrations-dir.d.ts.map

package/dist/migrations-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations-dir.d.ts","sourceRoot":"","sources":["../src/migrations-dir.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,oGAGtB,CAAC;AAEX,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE"}

package/dist/migrations-dir.js

@@ -0,0 +1,25 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+/**
+ * Where the framework's migration chain lives, relative to the
+ * directory the CLI is run from.
+ *
+ * Two layouts are real: the framework repository itself, where core is
+ * a workspace package, and a consumer application, where core arrives
+ * from the registry and ships its migrations inside the package (they
+ * are in `files`, next to `dist`). The first match wins, so a checkout
+ * that has both — the framework repo — reads its own source.
+ */
+export const MIGRATION_LOCATIONS = [
+    "packages/core/src/db/migrations",
+    "node_modules/@intelligo-dev/core/src/db/migrations",
+];
+export function resolveMigrationsDir(root) {
+    for (const relative of MIGRATION_LOCATIONS) {
+        const dir = path.join(root, relative);
+        if (existsSync(dir))
+            return dir;
+    }
+    return null;
+}
+//# sourceMappingURL=migrations-dir.js.map