@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/ecosystem.d.ts

@@ -0,0 +1,148 @@
+import type { GateResult } from "./gate.js";
+import { type PrFile } from "./heuristics.js";
+import type { CollisionCommentRecord } from "./storerows.js";
+import { type MigrationCollision } from "./migrations.js";
+/** The ecosystems a profile may select (`profile.toml`, key `ecosystem`). */
+export type EcosystemName = "django" | "none";
+/** One round's facts, as the dispatch pre-check call site knows them. */
+export interface EcosystemRound {
+    pr: number;
+    /** The PR's changed files (the files-API shape migrations.ts consumes). */
+    files: Array<{
+        filename: string;
+        status?: string;
+        patch?: string;
+    }>;
+    head_sha: string;
+    base_ref: string;
+    base_sha: string;
+}
+/** The I/O the pre-check may perform, passed per call by dispatch. Every
+ * write still rides the caller's gate-backed adapter (`createReview` is
+ * dispatch's own gated COMMENT route) — the seam adds no mutation path. */
+export interface EcosystemPreCheckIo {
+    logEvent(kind: string, pr: number | null, payload?: unknown): void;
+    /** Has this exact (head, collision set) already been commented?
+     * (Staleness-round dedupe — suppress the repost, never the check.) `unknown`
+     * — a comment row the ledger cannot read — also suppresses the post: a
+     * duplicate on the reviewed repo is the mutation this read exists to
+     * prevent, and an unreadable row cannot rule it out. */
+    migrationCollisionCommented(pr: number, fingerprint: string): CollisionCommentRecord;
+    /** Read-only marker reconciliation; absent adapters retain unknown delivery. */
+    findCollisionComment?(pr: number, marker: string, head: string): Promise<boolean>;
+    isDryRun?: boolean;
+    /** The gated COMMENT delivery — dispatch's `adapter.createReview`. */
+    createReview(pr: number, payload: {
+        commit_id: string;
+        event: "APPROVE" | "REQUEST_CHANGES" | "COMMENT";
+        body: string;
+    }, options?: {
+        purpose?: "migration_precheck";
+    }): Promise<GateResult>;
+    /** Every migration path on the base branch at a sha (read-only git).
+     * Absent ⇒ the Django check degrades (never a throw, never silence). */
+    listBaseMigrations?: (baseSha: string) => Promise<string[]>;
+    log?: (msg: string, extra?: unknown) => void;
+}
+/**
+ * What one round's pre-check concluded. THE off/degraded distinction lives in
+ * this union:
+ *
+ *   * `"off"`       — configured off (`ecosystem = "none"`): no check exists,
+ *                     nothing ran, nothing degraded, nothing to say.
+ *   * `"checked"`   — the check ran; `collisions` is what it found (usually
+ *                     empty, and already delivered as a COMMENT when not).
+ *                     `comment_withheld` marks the one checked round whose
+ *                     COMMENT was deliberately NOT posted: the ledger holds a
+ *                     comment row it cannot read. The caller owes the
+ *                     operator an anomaly for it — a withheld comment is
+ *                     quieter than a posted one, and the bar is "more
+ *                     reliable, never quieter".
+ *   * `"degraded"`  — the check EXISTS but could not run this round (no base
+ *                     reader, no base sha, or the base read threw) while the
+ *                     PR touches migrations. The never-quieter path:
+ *                     the caller raises the overseer anomaly and the round
+ *                     prompt un-muzzles the lens.
+ */
+export type EcosystemPreCheckOutcome = {
+    status: "off";
+} | {
+    status: "checked";
+    collisions: MigrationCollision[];
+    comment_withheld?: true;
+    /** The collisions' COMMENT is not known to be on the PR: withheld,
+     * guard-refused, or the gated call threw. The gate note then hands the
+     * remedy to the session instead of claiming it was posted. */
+    comment_undelivered?: true;
+} | {
+    status: "degraded";
+};
+/** The slice of a RoundOrder the gate note renders from — structural, so a
+ * full RoundOrder satisfies it as-is. */
+export interface GateNoteFacts {
+    migration_gate: boolean;
+    migration_precheck_degraded?: boolean;
+    migration_collisions?: MigrationCollision[] | undefined;
+    migration_collisions_undelivered?: boolean | undefined;
+}
+export interface Ecosystem {
+    readonly name: EcosystemName;
+    /** The tier-forcing gate (heuristics: forces sol-med and flags the round's
+     * `migration_gate`). Pure and total; `none` is constantly false. */
+    migrationGate(files: PrFile[]): boolean;
+    /**
+     * The round's pre-check, run by dispatch after the worktree is prepared and
+     * BEFORE the session hears about the round. Total: resolves with an outcome
+     * for every input, never throws — a failure inside is an event plus a
+     * degraded/checked outcome.
+     */
+    preCheck(io: EcosystemPreCheckIo, round: EcosystemRound): Promise<EcosystemPreCheckOutcome>;
+    /** The round prompt's entire `{{migration_gate_note}}` text. `none` renders
+     * `""` — a none round carries NO migration-gate prose at all. */
+    gateNote(facts: GateNoteFacts): string;
+    /** The round templates' `{{missing_migration_note}}`: the rule
+     * that tells the session to add pass-data-safety when models change with no
+     * migration. The placeholder sits on its own line after a paragraph, so
+     * the text carries its own leading blank line; `none` renders `""` — no
+     * Django rule and no stray blank line. */
+    readonly missingMigrationNote: string;
+}
+/**
+ * The GATE NOTES paragraph that carries the migration pre-check result to
+ * the session (rendered inside `migration_gate_note`, which all three round
+ * templates already print — no seed and no template edit needed).
+ *
+ * The daemon detected these collisions itself, before this round was ordered,
+ * and already posted the remedy as a COMMENT. Without this paragraph the
+ * session would re-derive the same fact from the diff and raise it as a
+ * blocker — the finding would be correct and the verdict wrong. So the note
+ * is imperative — the collision is
+ * settled mechanics, it is not a finding, and it never moves the verdict.
+ *
+ * Every filename-derived field is the PR author's (a migration name is
+ * `[^/]+`, backticks and newlines included), so each renders through
+ * `codePath`: it can never close its span or open a line of GATE NOTES.
+ */
+export declare function renderMigrationCollisionsNote(collisions: readonly MigrationCollision[], undelivered?: boolean): string;
+/**
+ * The GATE NOTES paragraph for a DEGRADED pre-check ("more reliable, never
+ * quieter"). When the daemon could not run the collision check at all —
+ * no base reader, no base sha, or the base read failed — the class must not
+ * fall between two stools: the daemon caught nothing AND the pass-data-safety
+ * addendum (packages/pi-plugin/src/include.ts) muzzles the lens. This note is the key that
+ * un-muzzles it for exactly this round: the addendum's withdrawal is
+ * conditional on the round prompt NOT carrying this text.
+ */
+export declare function renderMigrationPrecheckDegradedNote(): string;
+export declare const DJANGO_ECOSYSTEM: Ecosystem;
+/**
+ * Configured off. Not a degraded Django: nothing runs, nothing is read,
+ * nothing is logged, nothing is posted, no anomaly is raised, no prose is
+ * rendered, and the tier gate never fires. `{ status: "off" }` is the
+ * first-class answer that keeps every one of those a structural fact rather
+ * than a skipped branch.
+ */
+export declare const NONE_ECOSYSTEM: Ecosystem;
+/** The implementation a profile's `ecosystem` name selects. */
+export declare function ecosystemFor(name: EcosystemName): Ecosystem;
+//# sourceMappingURL=ecosystem.d.ts.map

package/dist/src/ecosystem.d.ts.map

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

package/dist/src/ecosystem.js

@@ -0,0 +1,338 @@
+// The ONE ecosystem pre-check seam.
+//
+// Everything framework-specific about a round — the tier-forcing migration
+// gate, the migration-number collision pre-check, and the round prompt's
+// migration-gate prose — talks to `Ecosystem`. No caller knows which framework
+// (if any) the reviewed repo uses: dispatch asks the seam, the templates ask
+// the seam, and the profile (`profiles/<name>/profile.toml`, loaded by
+// `packages/pi-plugin/src/profiles.ts`) picks the implementation.
+//
+// Exactly TWO implementations, both here:
+//
+//   * `DJANGO_ECOSYSTEM` — the migration collision pre-check (detection at
+//     the pinned base sha, remedy posted as a gated COMMENT,
+//     degraded-is-never-quieter), the `migrations/` tier gate, the MIGRATION
+//     GATE prompt prose, and the round templates' "add on a missing
+//     migration" rule (it names Django model fields). The detection/rendering
+//     pure functions live in packages/pi-plugin/src/migrations.ts — this object is the seam over
+//     them.
+//   * `NONE_ECOSYSTEM` — the clean CONFIGURED-OFF state, first-class and
+//     distinct from degradation: no pre-check runs (`{ status: "off" }` — an
+//     answer, not an error), no degraded path, no gate note, no anomaly, no
+//     tier forcing. A generic install's rounds carry no migration-gate prose
+//     at all.
+//
+// Shape notes (deliberate — the same discipline as src/memory/store.ts):
+//
+//   * Every method is TOTAL. `preCheck` resolves with an outcome for every
+//     input — a check that could not run is `{ status: "degraded" }`
+//     (refusal-as-answer), an ecosystem with no check is `{ status: "off" }`;
+//     only a broken caller contract could throw, and the Django
+//     implementation swallows even its own I/O failures into events.
+//   * "off" and "degraded" are DIFFERENT arms of the outcome union, never one
+//     boolean. Degraded is the never-quieter path (gate note +
+//     overseer anomaly + un-muzzled pass-data-safety); off is silence by
+//     configuration, and conflating them would either spam a non-Django repo
+//     with degradation noise or mute a Django repo's real degradation.
+//   * The seam takes its I/O per call (`EcosystemPreCheckIo`), so the
+//     implementations hold no state and dispatch keeps owning the store, the
+//     gate-backed adapter and the git seam — nothing here can grow a second
+//     mutation path.
+import { GitHubRequestError } from "./githubcore.js";
+import { codePath } from "./codespan.js";
+import { isMigrationPath, migrationGate as djangoMigrationGate, } from "./heuristics.js";
+import { collisionFingerprint, detectMigrationCollisions, collisionDependencyAdvice, renamedDependencyReplacement, renderMigrationCollisionComment, } from "./migrations.js";
+// ---- Django prose -----------------------------------------------------------
+// The migration gate is a data-safety signal: it forces the sol-med tier and
+// tells the session the DDL must be judged. It never escalates.
+const GATE_ON = "MIGRATION GATE: this PR touches migrations — pass-data-safety must judge the ORM operations and any supplied generated SQL for destructive mutation, concrete rebuild/locking risk, backfill safety, and rolling-deploy ordering. Ordinary Django ORM operations are acceptable and must not be rewritten as handwritten SQL merely for reviewability. Only a concrete migration hazard blocks; missing generated SQL or an unproven database algorithm does not.";
+const GATE_OFF = "no migration gate on this round";
+// The missing-migration add trigger for the three round templates: it is a
+// Django rule, so a `none` round omits it.
+const MISSING_MIGRATION_NOTE = "\n**Add on a missing migration.** If the diff changes a Django model's fields — a\n" +
+    "field added, removed or altered, or a changed `db_index`/`unique`/`choices`/\n" +
+    "`default` — and the PR carries **no migration file at all**, add\n" +
+    "`pass-data-safety` and give that as your one-line reason. The daemon's plan is\n" +
+    "path-shaped: `pass-data-safety` is selected on `migrations/`, `.sql`,\n" +
+    "`backfills/` and management commands, so the one case where the **absence** of a\n" +
+    "file is the defect is invisible to it. This is the team's longest-running\n" +
+    "migration complaint; the lens carries the rule, but only you can see that it\n" +
+    "needs to run.\n";
+/**
+ * The GATE NOTES paragraph that carries the migration pre-check result to
+ * the session (rendered inside `migration_gate_note`, which all three round
+ * templates already print — no seed and no template edit needed).
+ *
+ * The daemon detected these collisions itself, before this round was ordered,
+ * and already posted the remedy as a COMMENT. Without this paragraph the
+ * session would re-derive the same fact from the diff and raise it as a
+ * blocker — the finding would be correct and the verdict wrong. So the note
+ * is imperative — the collision is
+ * settled mechanics, it is not a finding, and it never moves the verdict.
+ *
+ * Every filename-derived field is the PR author's (a migration name is
+ * `[^/]+`, backticks and newlines included), so each renders through
+ * `codePath`: it can never close its span or open a line of GATE NOTES.
+ */
+export function renderMigrationCollisionsNote(collisions, undelivered = false) {
+    if (collisions.length === 0)
+        return "";
+    const lines = undelivered
+        ? [
+            "",
+            "",
+            "MIGRATION NUMBERING — REMEDY NOT DELIVERED, CARRY IT IN YOUR REVIEW. The",
+            "daemon checked this PR's migration numbers against the base branch at the",
+            "pinned base sha before this round was ordered and found the collision(s)",
+            "below, but its COMMENT with the remedy was NOT delivered to the PR this",
+            "round (withheld, refused by a posting guard, or the call failed):",
+            "",
+        ]
+        : [
+            "",
+            "",
+            "MIGRATION NUMBERING — ALREADY HANDLED, DO NOT RAISE IT. The daemon checked",
+            "this PR's migration numbers against the base branch at the pinned base sha",
+            "before this round was ordered, found the collision(s) below, and has already",
+            "posted the exact remedy to the PR as a COMMENT:",
+            "",
+        ];
+    for (const c of collisions) {
+        if (c.kind === "renamed-dependency") {
+            const stale = c.stale_dependency ?? "";
+            lines.push(`- ${codePath(c.pr_path)} references renamed ${codePath(`"${stale}"`)} → in its dependencies ${renamedDependencyReplacement(c)}, keeping every other entry` +
+                (c.renumber ? `; rename to ${codePath(c.target_path)}` : ""));
+            continue;
+        }
+        lines.push(`- ${codePath(c.pr_path)} collides with ${codePath(c.base_path)} → rename to ${codePath(c.target_path)}; ${collisionDependencyAdvice(c)}`);
+    }
+    if (undelivered) {
+        lines.push("", "So the author has not been told. Put this remedy in your review body, once,", 'in a short "Migration numbering (mechanics, not a blocker)" paragraph that', "states each rename and `dependencies` entry above. It is still mechanics:", "it is not a finding, not a blocker, never inline, and it never moves the", "verdict — a PR whose only migration problem is this numbering collision is", "still APPROVE-able on its merits. Everything else about these migrations is", "judged exactly as it always was.");
+        return lines.join("\n");
+    }
+    lines.push("", "This is mechanics, not review content: it is deterministic, it has exactly", "one remedy and it carries no design decision. It is **not a finding** — do", "not report it, do not post it inline or in the body, do not let any pass", "raise it, and above all do not let it become a `[blocker]` or move the", "verdict. A PR whose only migration problem is this numbering collision is", "still APPROVE-able on its merits. Everything else about these migrations —", "the DDL itself, ALGORITHM, backfill safety, rolling-deploy ordering — is", "judged exactly as it always was.");
+    return lines.join("\n");
+}
+/**
+ * The GATE NOTES paragraph for a DEGRADED pre-check ("more reliable, never
+ * quieter"). When the daemon could not run the collision check at all —
+ * no base reader, no base sha, or the base read failed — the class must not
+ * fall between two stools: the daemon caught nothing AND the pass-data-safety
+ * addendum (packages/pi-plugin/src/include.ts) muzzles the lens. This note is the key that
+ * un-muzzles it for exactly this round: the addendum's withdrawal is
+ * conditional on the round prompt NOT carrying this text.
+ */
+export function renderMigrationPrecheckDegradedNote() {
+    return [
+        "",
+        "",
+        "MIGRATION PRE-CHECK DID NOT RUN — CHECK COLLISIONS YOURSELF. The daemon",
+        "normally checks this PR's migration numbers against the base branch before",
+        "each round and posts the renumber remedy itself as a COMMENT. This round the",
+        "migration pre-check did not run (the base branch facts were unavailable or",
+        "the base read failed), so nothing has been checked and nothing has been",
+        "posted. YOU must check base-branch migration-number collisions yourself this",
+        "round: compare every migration this PR adds against the base branch's",
+        "migrations, and report a number the base already occupies as a normal",
+        "finding — with the remedy (the free target number and the exact",
+        "`dependencies` entry) stated. This lifts, for this round only, the standing",
+        "rule that base-branch numbering collisions are handled daemon-side.",
+    ].join("\n");
+}
+// ---- the two implementations ----------------------------------------------
+/**
+ * Django: the migration-number collision pre-check.
+ *
+ * A PR migration sitting on a number the base branch already took is
+ * deterministic, has exactly one remedy and carries no design content — so the
+ * daemon states the remedy itself, as a **COMMENT**. It is never a blocker, it
+ * consumes no verdict, and it does not touch the PR's lifecycle state. The
+ * write is `io.createReview`, i.e. the ordinary MutationGate path; in dry-run
+ * it lands in state/dryrun/ like every other intent.
+ *
+ * Every failure here is logged and swallowed: a round must never be lost to
+ * the pre-check. A degraded check must never be quieter than no check at all
+ * ("more reliable, never quieter"): the caller renders an
+ * explicit "the pre-check did not run — check collisions yourself" note into
+ * the round prompt, which is what conditionally un-muzzles pass-data-safety's
+ * withdrawn finding class for exactly that round (see packages/pi-plugin/src/include.ts,
+ * MIGRATION_NUMBERING_ADDENDUM), and raises the overseer anomaly.
+ */
+async function djangoPreCheck(io, round) {
+    const log = io.log ?? (() => { });
+    const touchesMigrations = round.files.some((f) => isMigrationPath(f.filename));
+    if (!io.listBaseMigrations || !round.base_sha) {
+        // Not a silent pass: the check is ~15% of all blockers and nothing else in
+        // the pipeline catches the class, so a round that could not run it says so.
+        if (touchesMigrations) {
+            io.logEvent("migration_precheck_skipped", round.pr, {
+                head_sha: round.head_sha,
+                reason: !io.listBaseMigrations ? "no_base_reader" : "no_base_sha",
+            });
+            return { status: "degraded" };
+        }
+        return { status: "checked", collisions: [] };
+    }
+    let collisions;
+    try {
+        const baseFiles = await io.listBaseMigrations(round.base_sha);
+        collisions = detectMigrationCollisions({ files: round.files, baseFiles });
+    }
+    catch (err) {
+        log(`dispatch: migration pre-check failed on #${round.pr}`, err);
+        io.logEvent("migration_precheck_failed", round.pr, {
+            head_sha: round.head_sha,
+            error: String(err),
+        });
+        return touchesMigrations ? { status: "degraded" } : { status: "checked", collisions: [] };
+    }
+    if (collisions.length === 0)
+        return { status: "checked", collisions };
+    io.logEvent("migration_collision_detected", round.pr, {
+        head_sha: round.head_sha,
+        base_ref: round.base_ref,
+        base_sha: round.base_sha,
+        collisions: collisions.map((c) => ({
+            pr_path: c.pr_path,
+            base_path: c.base_path,
+            target_path: c.target_path,
+        })),
+    });
+    const fingerprint = collisionFingerprint(round.head_sha, collisions);
+    // A staleness round re-runs at the same head and must not repost the same
+    // comment. Detection still runs and is still logged; only the duplicate
+    // COMMENT is suppressed.
+    const commented = io.migrationCollisionCommented(round.pr, fingerprint);
+    if (commented === "commented" || commented === "dryrun") {
+        log(`dispatch: #${round.pr} migration collision already commented at ${round.head_sha}`);
+        return {
+            status: "checked",
+            collisions,
+            ...(commented === "dryrun" ? { comment_undelivered: true } : {}),
+        };
+    }
+    const marker = `<!-- qcr-migration:${fingerprint} -->`;
+    if (commented === "unknown" || commented === "pending") {
+        try {
+            if (await io.findCollisionComment?.(round.pr, marker, round.head_sha)) {
+                io.logEvent("migration_collision_comment", round.pr, {
+                    head_sha: round.head_sha,
+                    fingerprint,
+                    executed: true,
+                    recovered: true,
+                });
+                return { status: "checked", collisions };
+            }
+        }
+        catch (err) {
+            log(`dispatch: #${round.pr} migration marker read unavailable`, err);
+        }
+        // The ledger holds a comment row it cannot read. Posting would risk the
+        // exact duplicate the dedupe exists to prevent, so the COMMENT is withheld
+        // — loudly, and with the check still counted as RUN: the collisions ride
+        // the round order into the gate note, so the session still hears them.
+        log(`dispatch: #${round.pr} migration collision comment withheld — ${commented === "pending" ? "an earlier delivery is unconfirmed" : "an earlier comment row is unreadable"}`);
+        io.logEvent("migration_collision_comment_withheld", round.pr, {
+            head_sha: round.head_sha,
+            fingerprint,
+            reason: commented === "pending" ? "unconfirmed_delivery" : "unreadable_comment_row",
+        });
+        return { status: "checked", collisions, comment_withheld: true, comment_undelivered: true };
+    }
+    let delivered = false;
+    try {
+        const body = renderMigrationCollisionComment({
+            collisions,
+            base_ref: round.base_ref,
+            base_sha: round.base_sha,
+        });
+        if (!io.isDryRun)
+            io.logEvent("migration_collision_comment_pending", round.pr, {
+                head_sha: round.head_sha,
+                fingerprint,
+            });
+        const result = await io.createReview(round.pr, {
+            commit_id: round.head_sha,
+            event: "COMMENT",
+            body: `${body}\n\n${marker}`,
+        }, { purpose: "migration_precheck" });
+        // Only a delivered (or, in dry-run, recorded) comment marks the
+        // fingerprint. A guard refusal returns without throwing and delivered
+        // nothing, so it must not consume the dedupe: the next round retries.
+        if (!result.executed && !result.dryRunFile) {
+            log(`dispatch: #${round.pr} migration collision comment refused (${result.blocked ?? "not executed"})`);
+            io.logEvent("migration_collision_comment_refused", round.pr, {
+                head_sha: round.head_sha,
+                fingerprint,
+                reason: result.blocked ?? "not_executed",
+            });
+        }
+        else {
+            delivered = result.executed;
+            io.logEvent("migration_collision_comment", round.pr, {
+                head_sha: round.head_sha,
+                fingerprint,
+                executed: result.executed,
+                dry_run_file: result.dryRunFile ?? null,
+            });
+        }
+    }
+    catch (err) {
+        // 408 is not a refusal: the request may have been accepted, so its
+        // delivery stays unknown and the pending event is reconciled by marker.
+        if (err instanceof GitHubRequestError &&
+            err.status >= 400 &&
+            err.status < 500 &&
+            err.status !== 408)
+            io.logEvent("migration_collision_comment_refused", round.pr, {
+                head_sha: round.head_sha,
+                fingerprint,
+                reason: String(err),
+            });
+        // The COMMENT failed, but the collisions are real, already detected and
+        // already logged — throwing them away here would leave the round's gate
+        // note empty while the addendum still muzzles the lens, i.e. NOBODY
+        // holding the class. The check RAN (not degraded); a refused comment
+        // retries on the next round because the fingerprint is only marked on
+        // success, while an uncertain delivery (pending, no refusal) is
+        // reconciled by marker and never resent.
+        log(`dispatch: migration pre-check failed on #${round.pr}`, err);
+        io.logEvent("migration_precheck_failed", round.pr, {
+            head_sha: round.head_sha,
+            stage: "create_review",
+            error: String(err),
+        });
+    }
+    return delivered
+        ? { status: "checked", collisions }
+        : { status: "checked", collisions, comment_undelivered: true };
+}
+export const DJANGO_ECOSYSTEM = {
+    name: "django",
+    migrationGate: (files) => djangoMigrationGate(files),
+    preCheck: djangoPreCheck,
+    missingMigrationNote: MISSING_MIGRATION_NOTE,
+    gateNote: (facts) => (facts.migration_gate ? GATE_ON : GATE_OFF) +
+        (facts.migration_precheck_degraded
+            ? renderMigrationPrecheckDegradedNote()
+            : renderMigrationCollisionsNote(facts.migration_collisions ?? [], facts.migration_collisions_undelivered === true)),
+};
+/**
+ * Configured off. Not a degraded Django: nothing runs, nothing is read,
+ * nothing is logged, nothing is posted, no anomaly is raised, no prose is
+ * rendered, and the tier gate never fires. `{ status: "off" }` is the
+ * first-class answer that keeps every one of those a structural fact rather
+ * than a skipped branch.
+ */
+export const NONE_ECOSYSTEM = {
+    name: "none",
+    migrationGate: () => false,
+    preCheck: async () => ({ status: "off" }),
+    gateNote: () => "",
+    missingMigrationNote: "",
+};
+/** The implementation a profile's `ecosystem` name selects. */
+export function ecosystemFor(name) {
+    return name === "django" ? DJANGO_ECOSYSTEM : NONE_ECOSYSTEM;
+}
+//# sourceMappingURL=ecosystem.js.map

package/dist/src/ecosystem.js.map

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

package/dist/src/engine/agentdir.d.ts

@@ -0,0 +1,5 @@
+import type { PiHostOptions } from "./pisdk.js";
+/** What the process route's pi reads from the agent dir's settings.json and an
+ * SDK host must be given instead (it takes in-memory settings only). */
+export declare function agentDirSettings(agentDir: string): PiHostOptions["settings"];
+//# sourceMappingURL=agentdir.d.ts.map

package/dist/src/engine/agentdir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentdir.d.ts","sourceRoot":"","sources":["../../../src/engine/agentdir.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;wEACwE;AACxE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC,CAe5E"}

package/dist/src/engine/agentdir.js

@@ -0,0 +1,21 @@
+// What a pi agent dir hands an SDK host. The process route's pi reads these from
+// the dir's files; an SDK host takes in-memory settings only.
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+/** What the process route's pi reads from the agent dir's settings.json and an
+ * SDK host must be given instead (it takes in-memory settings only). */
+export function agentDirSettings(agentDir) {
+    try {
+        const s = JSON.parse(readFileSync(join(agentDir, "settings.json"), "utf8"));
+        return {
+            ...(s["retry"] !== undefined ? { retry: s["retry"] } : {}),
+            ...(typeof s["httpIdleTimeoutMs"] === "number"
+                ? { httpIdleTimeoutMs: s["httpIdleTimeoutMs"] }
+                : {}),
+        };
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=agentdir.js.map

package/dist/src/engine/agentdir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentdir.js","sourceRoot":"","sources":["../../../src/engine/agentdir.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,8DAA8D;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;wEACwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAGzE,CAAC;QACF,OAAO;YACL,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,OAAO,CAAC,CAAC,mBAAmB,CAAC,KAAK,QAAQ;gBAC5C,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,mBAAmB,CAAC,EAAE;gBAC/C,CAAC,CAAC,EAAE,CAAC;SACqB,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}