@superblocksteam/vite-plugin-file-sync 1.99.99-next.3 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/migration/mark-api-testing-denied.js

@@ -0,0 +1,80 @@
+import { readPersistedChecklist, updateChecklistItem, } from "../ai-service/checklist/persisted-checklist-store.js";
+import { getErrorMeta } from "../util/logger.js";
+import { recordTestingDenied } from "./migration-metrics.js";
+export function buildMigrationTestApiDenialContinuationPrompt(apiName, remainingUntestedApis = []) {
+    const remaining = remainingUntestedApis.filter((name) => name !== apiName);
+    const base = `The user denied permission to test the API "${apiName}". ` +
+        `This API is marked as needing manual verification. ` +
+        `Do NOT call testApi for it again and do NOT rewrite or modify it. `;
+    if (remaining.length > 0) {
+        return (base +
+            `Continue testing the remaining untested APIs: ${remaining.join(", ")}. ` +
+            `Call testApi for each of these APIs. ` +
+            `Continue translating and working on other migration tasks as needed.`);
+    }
+    return (base +
+        `There are no other untested APIs remaining. Continue translating and working on other migration tasks.`);
+}
+export async function markApiTestingDeniedOnMigrationChecklist(params) {
+    const { appRootDirPath, apiName } = params;
+    const itemId = `api_${apiName}`;
+    const checklist = await readPersistedChecklist(appRootDirPath);
+    const item = checklist?.items.find((row) => row.id === itemId);
+    // Skip rows that already reached a terminal state (positive outcome, or a
+    // `failed` row whose failureReason we must not clobber) OR that are mid-retry
+    // after runMigrationVerification returned `both_failed` (still in_progress and
+    // expected to be retried, not punted to manual verification).
+    if (!item ||
+        item.verificationOutcome ||
+        item.status === "failed" ||
+        item.verificationSkippedReason === "both_failed") {
+        recordTestingDenied(false);
+        return false;
+    }
+    await updateChecklistItem({
+        appRootDirPath,
+        itemId,
+        status: "completed",
+        verificationSkippedReason: "testing_denied",
+    });
+    recordTestingDenied(true);
+    return true;
+}
+function moveApiFromUntestedToDenied(apiTestingState, apiName) {
+    apiTestingState.untested.delete(apiName);
+    apiTestingState.denied.add(apiName);
+}
+/**
+ * Reconciles persisted checklist state with in-memory `apiTestingState` after
+ * a `testApi` permission denial. For migration turns, the checklist is updated
+ * first; in-memory state changes only after that persist resolves so a failed
+ * write cannot hide an API from manual-verification surfaces while the item
+ * stays `in_progress` on disk.
+ */
+export async function applyTestApiDenialSideEffects(params) {
+    const { apiName, appRootDirPath, isAppMigration, apiTestingState, logger } = params;
+    if (isAppMigration) {
+        try {
+            const marked = await markApiTestingDeniedOnMigrationChecklist({
+                appRootDirPath,
+                apiName,
+            });
+            if (apiTestingState) {
+                moveApiFromUntestedToDenied(apiTestingState, apiName);
+                logger.info(`[ai-service] testApi denied for ${apiName}, moved from untested to denied`);
+            }
+            if (marked) {
+                logger.info(`[ai-service] Marked ${apiName} completed with testing_denied after testApi denial`);
+            }
+        }
+        catch (error) {
+            logger.error(`[ai-service] Failed to mark ${apiName} testing_denied on checklist`, getErrorMeta(error));
+        }
+        return;
+    }
+    if (apiTestingState) {
+        moveApiFromUntestedToDenied(apiTestingState, apiName);
+        logger.info(`[ai-service] testApi denied for ${apiName}, moved from untested to denied`);
+    }
+}
+//# sourceMappingURL=mark-api-testing-denied.js.map

package/dist/migration/mark-api-testing-denied.js.map

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

package/dist/migration/migration-checklist.d.ts

@@ -0,0 +1,80 @@
+import type { MigrationChecklistItem, MigrationChecklistOverallStatus, MigrationChecklistStatus } from "@superblocksteam/library-shared/types";
+type ChecklistStatus = MigrationChecklistStatus;
+export declare const MIGRATION_CHECKLIST_FILE = "checklist.json";
+declare const MIGRATION_CHECKLIST_VERSION = 1;
+interface MigrationChecklistState {
+    version: typeof MIGRATION_CHECKLIST_VERSION;
+    overallStatus: MigrationChecklistOverallStatus;
+    items: MigrationChecklistItem[];
+    lastUpdated: string;
+}
+export declare function isMigrationChecklistActive(appRootDirPath: string): Promise<boolean>;
+export declare function readMigrationChecklist(appRootDirPath: string): Promise<MigrationChecklistState | null>;
+export declare function seedMigrationChecklist(args: {
+    appRootDirPath: string;
+    apiChecklist: Array<{
+        name: string;
+        stubPath: string;
+    }>;
+}): Promise<MigrationChecklistState>;
+/**
+ * Ensure a migration checklist file exists, creating one if necessary.
+ *
+ * Used to bootstrap shared state for parallel sub-agents (see
+ * `spawnCodingSubagents`) in contexts where there is no upfront seeding
+ * step (e.g. third-party app migrations). Sub-agents and the main agent
+ * coordinate via the on-disk checklist to avoid races on the in-memory
+ * Clark context, so the file must exist before sub-agents run.
+ *
+ * If a file is already present, it is returned unchanged. Otherwise an
+ * `active` checklist is written using `seedItems` (which may be empty)
+ * — typically the caller passes the current in-memory checklist so any
+ * items the main agent has already added are not lost when subsequent
+ * `build_manageChecklist` calls switch over to the file-backed store.
+ */
+export declare function ensureMigrationChecklistInitialized(args: {
+    appRootDirPath: string;
+    seedItems?: Array<{
+        id?: string;
+        content: string;
+        status?: ChecklistStatus;
+        createdAt?: string;
+        failureReason?: string;
+    }>;
+}): Promise<MigrationChecklistState>;
+export declare function addMigrationChecklistItem(args: {
+    appRootDirPath: string;
+    content: string;
+    status?: ChecklistStatus;
+    origin?: MigrationChecklistItem["origin"];
+}): Promise<{
+    state: MigrationChecklistState;
+    item: MigrationChecklistItem;
+}>;
+export declare function updateMigrationChecklistItem(args: {
+    appRootDirPath: string;
+    itemId: string;
+    content?: string;
+    status?: ChecklistStatus;
+    failureReason?: string;
+    /** Pass `null` to explicitly clear the field. */
+    verificationSkippedReason?: MigrationChecklistItem["verificationSkippedReason"] | null;
+    /** Pass `null` to explicitly clear the field. */
+    verificationOutcome?: MigrationChecklistItem["verificationOutcome"] | null;
+    lastVerificationDiffPath?: string;
+    lastVerificationAt?: string;
+    /**
+     * Sub-agent worker that owns this item. Stamped by `spawnCodingSubagents`
+     * before fan-out so the UI can group items into batch rows; the agent does
+     * not set this directly.
+     */
+    workerId?: string;
+}): Promise<{
+    state: MigrationChecklistState;
+    item: MigrationChecklistItem;
+}>;
+export declare function markMigrationChecklistCompleted(args: {
+    appRootDirPath: string;
+}): Promise<MigrationChecklistState>;
+export {};
+//# sourceMappingURL=migration-checklist.d.ts.map

package/dist/migration/migration-checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-checklist.d.ts","sourceRoot":"","sources":["../../src/migration/migration-checklist.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACzB,MAAM,uCAAuC,CAAC;AAc/C,KAAK,eAAe,GAAG,wBAAwB,CAAC;AAChD,eAAO,MAAM,wBAAwB,mBAA2B,CAAC;AACjE,QAAA,MAAM,2BAA2B,IAA8B,CAAC;AAEhE,UAAU,uBAAuB;IAC/B,OAAO,EAAE,OAAO,2BAA2B,CAAC;IAC5C,aAAa,EAAE,+BAA+B,CAAC;IAC/C,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAaD,wBAAsB,0BAA0B,CAC9C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAWzC;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAGnC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mCAAmC,CAAC,IAAI,EAAE;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;CACJ,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAgCnC;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC3C,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,uBAAuB,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC,CAK5E;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,yBAAyB,CAAC,EACtB,sBAAsB,CAAC,2BAA2B,CAAC,GACnD,IAAI,CAAC;IACT,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,sBAAsB,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;IAC3E,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,uBAAuB,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC,CAI5E;AAmBD,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAInC"}

package/dist/migration/migration-checklist.js

@@ -0,0 +1,150 @@
+import { access, mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { addChecklistItem, getPersistedChecklistPath, isChecklistActive as isMigrationChecklistActivePersisted, markChecklistCompleted, PERSISTED_CHECKLIST_FILE, PERSISTED_CHECKLIST_VERSION, readPersistedChecklist as readMigrationChecklistState, seedMigrationChecklistState, updateChecklistItem, } from "../ai-service/checklist/persisted-checklist-store.js";
+import { OperationQueue } from "../util/operation-queue.js";
+export const MIGRATION_CHECKLIST_FILE = PERSISTED_CHECKLIST_FILE;
+const MIGRATION_CHECKLIST_VERSION = PERSISTED_CHECKLIST_VERSION;
+const mutationQueues = new Map();
+function getMutationQueue(appRootDirPath) {
+    let queue = mutationQueues.get(appRootDirPath);
+    if (!queue) {
+        queue = new OperationQueue();
+        mutationQueues.set(appRootDirPath, queue);
+    }
+    return queue;
+}
+export async function isMigrationChecklistActive(appRootDirPath) {
+    return await isMigrationChecklistActivePersisted(appRootDirPath);
+}
+export async function readMigrationChecklist(appRootDirPath) {
+    const state = await readMigrationChecklistState(appRootDirPath);
+    if (!state) {
+        return null;
+    }
+    return {
+        version: state.version,
+        overallStatus: state.overallStatus,
+        items: state.items,
+        lastUpdated: state.lastUpdated,
+    };
+}
+export async function seedMigrationChecklist(args) {
+    const state = await seedMigrationChecklistState(args);
+    return state;
+}
+/**
+ * Ensure a migration checklist file exists, creating one if necessary.
+ *
+ * Used to bootstrap shared state for parallel sub-agents (see
+ * `spawnCodingSubagents`) in contexts where there is no upfront seeding
+ * step (e.g. third-party app migrations). Sub-agents and the main agent
+ * coordinate via the on-disk checklist to avoid races on the in-memory
+ * Clark context, so the file must exist before sub-agents run.
+ *
+ * If a file is already present, it is returned unchanged. Otherwise an
+ * `active` checklist is written using `seedItems` (which may be empty)
+ * — typically the caller passes the current in-memory checklist so any
+ * items the main agent has already added are not lost when subsequent
+ * `build_manageChecklist` calls switch over to the file-backed store.
+ */
+export async function ensureMigrationChecklistInitialized(args) {
+    return getMutationQueue(args.appRootDirPath).enqueue(async () => {
+        const existing = await readMigrationChecklist(args.appRootDirPath);
+        if (existing) {
+            return existing;
+        }
+        const now = new Date().toISOString();
+        const items = (args.seedItems ?? []).map((entry, index) => ({
+            id: entry.id ??
+                `item_${Date.now()}_${index}_${Math.random().toString(36).slice(2, 10)}`,
+            content: entry.content,
+            status: entry.status ?? "pending",
+            createdAt: entry.createdAt ?? now,
+            origin: "clark",
+            ...(entry.failureReason !== undefined && {
+                failureReason: entry.failureReason,
+            }),
+        }));
+        const state = {
+            version: MIGRATION_CHECKLIST_VERSION,
+            overallStatus: "active",
+            lastUpdated: now,
+            items,
+        };
+        await writeMigrationChecklist(args.appRootDirPath, {
+            ...state,
+        });
+        return state;
+    });
+}
+export async function addMigrationChecklistItem(args) {
+    const result = await addChecklistItem({
+        ...args,
+    });
+    return result;
+}
+export async function updateMigrationChecklistItem(args) {
+    return await updateChecklistItem({
+        ...args,
+    });
+}
+/**
+ * Flip every `seed_api` item currently in `failed` state back to
+ * `pending`, bump its `attemptCount`, and preserve the prior
+ * `failureReason` as `lastFailureReason` so the retry prompt can carry
+ * it. Used by `/sb-migration-retry-unresolved` to let the user trigger
+ * another pass once the auto-retry budget has been spent.
+ *
+ * Unlike `updateMigrationChecklistItem` this writes directly without
+ * going through the auto-retry transform — the user has already
+ * consented to an additional attempt, so budget enforcement doesn't
+ * apply.
+ */
+function getMigrationChecklistPath(appRootDirPath) {
+    return getPersistedChecklistPath(appRootDirPath);
+}
+export async function markMigrationChecklistCompleted(args) {
+    return await markChecklistCompleted({
+        appRootDirPath: args.appRootDirPath,
+    });
+}
+async function writeMigrationChecklist(appRootDirPath, state) {
+    const checklistPath = await resolveChecklistPathForWrite(appRootDirPath);
+    // Ensure the parent dir exists. v2→v3 migrations create `scratch/`
+    // up front in `restructure.ts`, but third-party app migrations have
+    // no equivalent step, so the first write through this path would
+    // otherwise fail with ENOENT.
+    await mkdir(dirname(checklistPath), { recursive: true });
+    await writeFile(checklistPath, JSON.stringify(state, null, 2) + "\n", "utf-8");
+}
+function getChecklistPathCandidates(appRootDirPath) {
+    const primary = getMigrationChecklistPath(appRootDirPath);
+    const parentCandidate = getMigrationChecklistPath(dirname(appRootDirPath));
+    if (primary === parentCandidate) {
+        return [primary];
+    }
+    return [primary, parentCandidate];
+}
+async function resolveChecklistPathForWrite(appRootDirPath) {
+    const candidates = getChecklistPathCandidates(appRootDirPath);
+    for (const candidate of candidates) {
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            // Keep checking.
+        }
+    }
+    for (const candidate of candidates) {
+        try {
+            await access(dirname(candidate));
+            return candidate;
+        }
+        catch {
+            // Keep checking.
+        }
+    }
+    return candidates[0] ?? getMigrationChecklistPath(appRootDirPath);
+}
+//# sourceMappingURL=migration-checklist.js.map

package/dist/migration/migration-checklist.js.map

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

package/dist/migration/migration-classifier.d.ts

@@ -0,0 +1,4 @@
+export type MutationClassification = "read" | "write" | "unknown";
+export declare function classifyYamlStepMutation(step: Record<string, unknown>): MutationClassification;
+export declare function classifyIntegrationMutations(steps: Record<string, unknown>[]): MutationClassification;
+//# sourceMappingURL=migration-classifier.d.ts.map

package/dist/migration/migration-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-classifier.d.ts","sourceRoot":"","sources":["../../src/migration/migration-classifier.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AA2ClE,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,sBAAsB,CA+CxB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC/B,sBAAsB,CASxB"}

package/dist/migration/migration-classifier.js

@@ -0,0 +1,87 @@
+import { LanguagePluginID } from "@superblocksteam/shared";
+const LANGUAGE_PLUGIN_IDS = new Set(Object.values(LanguagePluginID));
+const SQL_WRITE_KEYWORDS = [
+    "INSERT",
+    "UPDATE",
+    "DELETE",
+    "CREATE",
+    "DROP",
+    "TRUNCATE",
+    "ALTER",
+    "REPLACE",
+    "MERGE",
+];
+const HTTP_MUTATION_METHODS = new Set(["DELETE", "PUT", "PATCH", "POST"]);
+// `SELECT ... INTO new_table` creates a table — a write — so SELECT alone
+// isn't a safe early-return signal.
+const SELECT_INTO_RE = /\bSELECT\b[\s\S]*?\bINTO\b/i;
+function isSqlWrite(query) {
+    // Strip surrounding backticks — v2 YAML bodies may be template-literal
+    // wrapped (e.g. `` `INSERT INTO ...` ``).
+    const trimmed = query.trim().replace(/^`|`$/g, "").trim();
+    if (/^\s*SELECT\b/i.test(trimmed) &&
+        !trimmed.includes(";") &&
+        !SELECT_INTO_RE.test(trimmed)) {
+        return false;
+    }
+    if (SELECT_INTO_RE.test(trimmed))
+        return true;
+    return SQL_WRITE_KEYWORDS.some((kw) => new RegExp(`(^|\\s|;)${kw}\\s`, "i").test(trimmed));
+}
+function isDynamic(value) {
+    return value.includes("{{") || value.includes("${");
+}
+export function classifyYamlStepMutation(step) {
+    const integration = step["integration"];
+    if (typeof integration === "string" && LANGUAGE_PLUGIN_IDS.has(integration)) {
+        // v2 javascript/python blocks are sandboxed transforms — they cannot
+        // invoke data integrations directly. File-referenced bodies are not
+        // statically inspectable here; treat as read so migration verification
+        // is not blocked on skipped_mutation.
+        return "read";
+    }
+    const pluginConfig = Object.entries(step).find(([key, val]) => key !== "integration" &&
+        key !== "name" &&
+        val !== null &&
+        typeof val === "object" &&
+        !Array.isArray(val))?.[1];
+    if (!pluginConfig)
+        return "unknown";
+    const httpMethod = typeof pluginConfig.httpMethod === "string"
+        ? pluginConfig.httpMethod
+        : typeof pluginConfig.method === "string"
+            ? pluginConfig.method
+            : null;
+    if (httpMethod !== null) {
+        return HTTP_MUTATION_METHODS.has(httpMethod.toUpperCase())
+            ? "write"
+            : "read";
+    }
+    const sqlBody = typeof pluginConfig.body === "string"
+        ? pluginConfig.body
+        : typeof pluginConfig.sqlBody === "string"
+            ? pluginConfig.sqlBody
+            : typeof pluginConfig.query === "string"
+                ? pluginConfig.query
+                : null;
+    if (sqlBody !== null) {
+        if (isDynamic(sqlBody))
+            return "unknown";
+        return isSqlWrite(sqlBody) ? "write" : "read";
+    }
+    return "unknown";
+}
+export function classifyIntegrationMutations(steps) {
+    let sawUnknown = false;
+    for (const step of steps) {
+        const result = classifyYamlStepMutation(step);
+        if (result === "write")
+            return "write";
+        if (result === "unknown")
+            sawUnknown = true;
+    }
+    if (steps.length === 0)
+        return "unknown";
+    return sawUnknown ? "unknown" : "read";
+}
+//# sourceMappingURL=migration-classifier.js.map

package/dist/migration/migration-classifier.js.map

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

package/dist/migration/migration-metrics.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Dev-server-side telemetry for the v2 -> v3 (Clark) migration.
+ *
+ * The server owns the lifecycle counters (attempted / completed / aborted). The
+ * dev server owns the *mechanical* migration that actually rewrites the app, so
+ * here we record:
+ *
+ *   - per-stage outcomes of `/sb-migrate-to-fullstack` (backup, restructure,
+ *     flip) and `/sb-migration-complete` finalization, and
+ *   - per-API verification outcomes (passed / diverged / ...), which today only
+ *     exist as a log line.
+ *
+ * Metrics use the OTel API directly (there is no dev-server `metricsClient`
+ * wrapper). A run span ties the mechanical stages together on one trace so
+ * per-stage latency and failures are attributable. Instruments are created
+ * lazily so telemetry init order never matters.
+ */
+import { type Span } from "@opentelemetry/api";
+import type { VerificationOutcome } from "./migration-verification.js";
+/** Mechanical migration stages driven by the dev server. */
+export type MigrationStage = "backup" | "complete" | "flip" | "restructure";
+type MigrationStageOutcome = "failure" | "success";
+/**
+ * Verification outcome kinds emitted by `runMigrationVerification`. Derived
+ * from `VerificationOutcome["kind"]` (type-only import — erased at runtime,
+ * so no import cycle) rather than hand-mirrored, so adding an outcome kind
+ * can never silently desync the metric from the log.
+ */
+type MigrationVerificationKind = VerificationOutcome["kind"];
+/**
+ * Pipeline side carried by the transient outcomes (`timeout` /
+ * `disconnected`). Derived from the outcome union for the same
+ * no-silent-desync reason as {@link MigrationVerificationKind}.
+ */
+type MigrationVerificationSide = Extract<VerificationOutcome, {
+    side: unknown;
+}>["side"];
+/** Records the outcome of one mechanical migration stage. */
+export declare function recordMigrationStage(stage: MigrationStage, outcome: MigrationStageOutcome): void;
+/**
+ * Records one per-API verification outcome. Takes the outcome itself (not
+ * just its kind) so sided outcomes can never lose `side` at the call site:
+ * a v2 timeout (stalled editor-client chain — user keeps the tab focused)
+ * and a v3 timeout (SDK/orchestrator stall — infra look) have different
+ * remediations, so oncall needs the split on the dashboard. Only `kind` and
+ * `side` become labels — everything else on an outcome (e.g. free-form
+ * `reason` strings) is unbounded and potentially sensitive, so it stays out.
+ */
+export declare function recordMigrationVerification(outcome: {
+    kind: MigrationVerificationKind;
+    side?: MigrationVerificationSide;
+}): void;
+/** Records a migration testApi denial that attempted to stamp testing_denied. */
+export declare function recordTestingDenied(marked: boolean): void;
+/** Records a markApiManuallyVerified invocation outcome. */
+export declare function recordManualVerify(result: "already_verified" | "verified"): void;
+/**
+ * Starts the parent span for a `/sb-migrate-to-fullstack` run. The caller owns
+ * ending it (via {@link endMigrationRunSpan}) because the run may end by the
+ * process self-restarting after the flip.
+ */
+export declare function startMigrationRunSpan(attributes: {
+    generation: number;
+    willSelfRestart: boolean;
+}): Span;
+/** Marks a stage boundary on the run span with its elapsed time. */
+export declare function markMigrationRunStage(span: Span, stage: MigrationStage, outcome: MigrationStageOutcome): void;
+/** Ends the run span, recording success or the failing stage. */
+export declare function endMigrationRunSpan(span: Span, result: {
+    failedStage?: MigrationStage;
+    error?: unknown;
+}): void;
+export {};
+//# sourceMappingURL=migration-metrics.d.ts.map

package/dist/migration/migration-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-metrics.d.ts","sourceRoot":"","sources":["../../src/migration/migration-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAGL,KAAK,IAAI,EAIV,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAKvE,4DAA4D;AAC5D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC;AAE5E,KAAK,qBAAqB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD;;;;;GAKG;AACH,KAAK,yBAAyB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;GAIG;AACH,KAAK,yBAAyB,GAAG,OAAO,CACtC,mBAAmB,EACnB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAClB,CAAC,MAAM,CAAC,CAAC;AA+CV,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,IAAI,EAAE,yBAAyB,CAAC;IAChC,IAAI,CAAC,EAAE,yBAAyB,CAAC;CAClC,GAAG,IAAI,CAKP;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAEzD;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,GAAG,UAAU,GACtC,IAAI,CAEN;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,IAAI,CAOP;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAEN;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE;IAAE,WAAW,CAAC,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACxD,IAAI,CAiBN"}

package/dist/migration/migration-metrics.js

@@ -0,0 +1,124 @@
+/**
+ * Dev-server-side telemetry for the v2 -> v3 (Clark) migration.
+ *
+ * The server owns the lifecycle counters (attempted / completed / aborted). The
+ * dev server owns the *mechanical* migration that actually rewrites the app, so
+ * here we record:
+ *
+ *   - per-stage outcomes of `/sb-migrate-to-fullstack` (backup, restructure,
+ *     flip) and `/sb-migration-complete` finalization, and
+ *   - per-API verification outcomes (passed / diverged / ...), which today only
+ *     exist as a log line.
+ *
+ * Metrics use the OTel API directly (there is no dev-server `metricsClient`
+ * wrapper). A run span ties the mechanical stages together on one trace so
+ * per-stage latency and failures are attributable. Instruments are created
+ * lazily so telemetry init order never matters.
+ */
+import { metrics, SpanStatusCode, trace, } from "@opentelemetry/api";
+const METER_NAME = "superblocks.dev-server.migration";
+const TRACER_NAME = "superblocks.dev-server.migration";
+let stageCounter;
+let verificationCounter;
+let testingDeniedCounter;
+let manualVerifyCounter;
+function getStageCounter() {
+    stageCounter ??= metrics
+        .getMeter(METER_NAME)
+        .createCounter("superblocks_dev_server.migration.stage", {
+        description: "Outcome of each mechanical migration stage (backup, restructure, flip, complete).",
+    });
+    return stageCounter;
+}
+function getVerificationCounter() {
+    verificationCounter ??= metrics
+        .getMeter(METER_NAME)
+        .createCounter("superblocks_dev_server.migration.verification", {
+        description: "Per-API migration verification outcomes by kind; transient kinds (timeout, disconnected) also carry the pipeline side (v2/v3).",
+    });
+    return verificationCounter;
+}
+function getTestingDeniedCounter() {
+    testingDeniedCounter ??= metrics
+        .getMeter(METER_NAME)
+        .createCounter("superblocks_dev_server.migration.testing_denied", {
+        description: "testApi permission denials during migration that stamp or skip testing_denied on the checklist.",
+    });
+    return testingDeniedCounter;
+}
+function getManualVerifyCounter() {
+    manualVerifyCounter ??= metrics
+        .getMeter(METER_NAME)
+        .createCounter("superblocks_dev_server.migration.manual_verify", {
+        description: "User-confirmed manual verification of migration APIs via markApiManuallyVerified.",
+    });
+    return manualVerifyCounter;
+}
+/** Records the outcome of one mechanical migration stage. */
+export function recordMigrationStage(stage, outcome) {
+    getStageCounter().add(1, { stage, outcome });
+}
+/**
+ * Records one per-API verification outcome. Takes the outcome itself (not
+ * just its kind) so sided outcomes can never lose `side` at the call site:
+ * a v2 timeout (stalled editor-client chain — user keeps the tab focused)
+ * and a v3 timeout (SDK/orchestrator stall — infra look) have different
+ * remediations, so oncall needs the split on the dashboard. Only `kind` and
+ * `side` become labels — everything else on an outcome (e.g. free-form
+ * `reason` strings) is unbounded and potentially sensitive, so it stays out.
+ */
+export function recordMigrationVerification(outcome) {
+    getVerificationCounter().add(1, {
+        kind: outcome.kind,
+        ...(outcome.side !== undefined && { side: outcome.side }),
+    });
+}
+/** Records a migration testApi denial that attempted to stamp testing_denied. */
+export function recordTestingDenied(marked) {
+    getTestingDeniedCounter().add(1, { marked: String(marked) });
+}
+/** Records a markApiManuallyVerified invocation outcome. */
+export function recordManualVerify(result) {
+    getManualVerifyCounter().add(1, { result });
+}
+function getTracer() {
+    return trace.getTracer(TRACER_NAME);
+}
+/**
+ * Starts the parent span for a `/sb-migrate-to-fullstack` run. The caller owns
+ * ending it (via {@link endMigrationRunSpan}) because the run may end by the
+ * process self-restarting after the flip.
+ */
+export function startMigrationRunSpan(attributes) {
+    return getTracer().startSpan("migration.dev_server.run", {
+        attributes: {
+            "migration.generation": attributes.generation,
+            "migration.will_self_restart": attributes.willSelfRestart,
+        },
+    });
+}
+/** Marks a stage boundary on the run span with its elapsed time. */
+export function markMigrationRunStage(span, stage, outcome) {
+    span.addEvent(`migration.stage.${stage}`, { outcome });
+}
+/** Ends the run span, recording success or the failing stage. */
+export function endMigrationRunSpan(span, result) {
+    if (result.failedStage) {
+        span.setAttribute("migration.failed_stage", result.failedStage);
+        // Record only the error *type*, never its message or stack: migration
+        // errors can carry payload fragments (tokens, signed URLs), and the full
+        // sanitized detail already goes to the logger. Datadog gets the class name.
+        if (result.error instanceof Error) {
+            span.setAttribute("migration.error_type", result.error.name);
+        }
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: `migration failed at ${result.failedStage}`,
+        });
+    }
+    else {
+        span.setStatus({ code: SpanStatusCode.OK });
+    }
+    span.end();
+}
+//# sourceMappingURL=migration-metrics.js.map

package/dist/migration/migration-metrics.js.map

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