@superblocksteam/vite-plugin-file-sync 2.0.140 → 2.0.141-next.0

package/dist/file-system-helpers.js.map

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

package/dist/migration/integration-write-policy.d.ts

@@ -0,0 +1,12 @@
+export type IntegrationWritePolicy = "allow" | "deny";
+export type ParseIntegrationWritePolicyResult = {
+    ok: true;
+    policy: Record<string, IntegrationWritePolicy> | undefined;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseIntegrationWritePolicy(input: unknown, options?: {
+    required?: boolean;
+}): ParseIntegrationWritePolicyResult;
+//# sourceMappingURL=integration-write-policy.d.ts.map

package/dist/migration/integration-write-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-write-policy.d.ts","sourceRoot":"","sources":["../../src/migration/integration-write-policy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,CAAC;AAItD,MAAM,MAAM,iCAAiC,GACzC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,SAAS,CAAA;CAAE,GACxE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,iCAAiC,CAsCnC"}

package/dist/migration/integration-write-policy.js

@@ -0,0 +1,31 @@
+const VALID_POLICIES = new Set(["allow", "deny"]);
+export function parseIntegrationWritePolicy(input, options = {}) {
+    if (input === undefined || input === null) {
+        if (options.required) {
+            return { ok: false, error: "policy object required" };
+        }
+        return { ok: true, policy: undefined };
+    }
+    if (typeof input !== "object" || Array.isArray(input)) {
+        return { ok: false, error: "policy object required" };
+    }
+    const entries = Object.entries(input);
+    if (entries.length === 0) {
+        if (options.required) {
+            return { ok: false, error: "policy object required" };
+        }
+        return { ok: true, policy: undefined };
+    }
+    const invalidEntries = entries.filter(([, value]) => typeof value !== "string" || !VALID_POLICIES.has(value));
+    if (invalidEntries.length > 0) {
+        return {
+            ok: false,
+            error: `Invalid policy values for: ${invalidEntries.map(([key]) => key).join(", ")}. Allowed: allow, deny`,
+        };
+    }
+    return {
+        ok: true,
+        policy: Object.fromEntries(entries.map(([key, value]) => [key, value])),
+    };
+}
+//# sourceMappingURL=integration-write-policy.js.map

package/dist/migration/integration-write-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-write-policy.js","sourceRoot":"","sources":["../../src/migration/integration-write-policy.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAMvE,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,UAAkC,EAAE;IAEpC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CACvE,CAAC;IACF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,8BAA8B,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB;SAC3G,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,MAAM,CAAC,WAAW,CACxB,OAAO,CAAC,GAAG,CACT,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAA+B,CAAU,CAClE,CACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,69 @@
+/**
+ * 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";
+export 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.
+ */
+export 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}.
+ */
+export 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;
+/**
+ * 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;
+//# 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,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,mBAAmB,EACnB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAClB,CAAC,MAAM,CAAC,CAAC;AAyBV,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;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,98 @@
+/**
+ * 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;
+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;
+}
+/** 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 }),
+    });
+}
+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":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,OAAO,EAEP,cAAc,EACd,KAAK,GAEN,MAAM,oBAAoB,CAAC;AAI5B,MAAM,UAAU,GAAG,kCAAkC,CAAC;AACtD,MAAM,WAAW,GAAG,kCAAkC,CAAC;AAyBvD,IAAI,YAAiC,CAAC;AACtC,IAAI,mBAAwC,CAAC;AAE7C,SAAS,eAAe;IACtB,YAAY,KAAK,OAAO;SACrB,QAAQ,CAAC,UAAU,CAAC;SACpB,aAAa,CAAC,wCAAwC,EAAE;QACvD,WAAW,EACT,mFAAmF;KACtF,CAAC,CAAC;IACL,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,sBAAsB;IAC7B,mBAAmB,KAAK,OAAO;SAC5B,QAAQ,CAAC,UAAU,CAAC;SACpB,aAAa,CAAC,+CAA+C,EAAE;QAC9D,WAAW,EACT,gIAAgI;KACnI,CAAC,CAAC;IACL,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,oBAAoB,CAClC,KAAqB,EACrB,OAA8B;IAE9B,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAG3C;IACC,sBAAsB,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAGrC;IACC,OAAO,SAAS,EAAE,CAAC,SAAS,CAAC,0BAA0B,EAAE;QACvD,UAAU,EAAE;YACV,sBAAsB,EAAE,UAAU,CAAC,UAAU;YAC7C,6BAA6B,EAAE,UAAU,CAAC,eAAe;SAC1D;KACF,CAAC,CAAC;AACL,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,qBAAqB,CACnC,IAAU,EACV,KAAqB,EACrB,OAA8B;IAE9B,IAAI,CAAC,QAAQ,CAAC,mBAAmB,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CACjC,IAAU,EACV,MAAyD;IAEzD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAChE,sEAAsE;QACtE,yEAAyE;QACzE,4EAA4E;QAC5E,IAAI,MAAM,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,YAAY,CAAC,sBAAsB,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,cAAc,CAAC,KAAK;YAC1B,OAAO,EAAE,uBAAuB,MAAM,CAAC,WAAW,EAAE;SACrD,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,CAAC;AACb,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"migration-routes.d.ts","sourceRoot":"","sources":["../../src/migration/migration-routes.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,EACL,iBAAiB,EAElB,MAAM,kDAAkD,CAAC;AAuB1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAwB9D,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC;IAC3C,qBAAqB,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAoBD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AA8d7B,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAglCN"}
+{"version":3,"file":"migration-routes.d.ts","sourceRoot":"","sources":["../../src/migration/migration-routes.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,EACL,iBAAiB,EAElB,MAAM,kDAAkD,CAAC;AAsB1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AA6B9D,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC;IAC3C,qBAAqB,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAoBD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AA8d7B,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAu9BN"}

package/dist/migration/migration-routes.js

@@ -5,13 +5,14 @@ import { parse as parseYaml } from "yaml";
 import { RESTART_EXIT_CODE, RESTART_SUPERVISED_ENV, } from "@superblocksteam/library-shared/restart-contract";
 import { LanguagePluginID } from "@superblocksteam/shared";
 import { getTelemetryInstance, isTelemetryInitialized, } from "@superblocksteam/telemetry";
-import { extractIntegrationIdsFromSource } from "../ai-service/agent/tools/apis/analysis.js";
 import { API_MIGRATION_ORIGINS, clearChecklist, clearChecklistItemsByOrigin, markChecklistCompleted, readPersistedChecklist, retryFailedSeedApiItemsFromChecklist, updateChecklistItem, } from "../ai-service/checklist/persisted-checklist-store.js";
 import { getErrorMeta } from "../util/logger.js";
 import { getFullstackTemplateDir } from "./get-fullstack-template-dir.js";
+import { parseIntegrationWritePolicy } from "./integration-write-policy.js";
 import { classifyIntegrationMutations } from "./migration-classifier.js";
+import { endMigrationRunSpan, markMigrationRunStage, recordMigrationStage, startMigrationRunSpan, } from "./migration-metrics.js";
 import { reconcileMigrationSessionOnBoot, rehydrateMigrationScratchOnBoot, } from "./migration-session-reconcile.js";
-import { analyzeV2BackupMutations, clearVerificationHistory, } from "./migration-verification.js";
+import { clearVerificationHistory } from "./migration-verification.js";
 import { migrateToFullstack, restoreFromV2Backup } from "./restructure.js";
 import { detectUnsupportedIntegrations } from "./unsupported-integrations.js";
 import { forEachYamlStep } from "./yaml-walk.js";
@@ -180,7 +181,7 @@ async function extractIntegrationsFromYamls(yamlPaths) {
         .map(([id, steps]) => ({
         id,
         displayName: id,
-        defaultPolicy: "ask",
+        defaultPolicy: "deny",
         mutationKind: classifyIntegrationMutations(steps),
     }));
 }
@@ -603,6 +604,14 @@ export function registerMigrationRoutes(server, options) {
                 }));
                 return;
             }
+            const parsedWritePolicy = parseIntegrationWritePolicy(body?.integrationWritePolicy);
+            if (!parsedWritePolicy.ok) {
+                res.statusCode = 400;
+                res.setHeader("Content-Type", "application/json");
+                res.end(JSON.stringify({ error: parsedWritePolicy.error }));
+                return;
+            }
+            const integrationWritePolicy = parsedWritePolicy.policy;
             if (!syncService) {
                 res.statusCode = 503;
                 res.end(JSON.stringify({
@@ -663,6 +672,12 @@ export function registerMigrationRoutes(server, options) {
             // Gates the actual `process.exit` below. Set only after a *successful*
             // flip so a thrown flip never triggers an in-place restart.
             let shouldSelfRestart = false;
+            const runSpan = startMigrationRunSpan({
+                generation: migrationGeneration,
+                willSelfRestart,
+            });
+            let runFailedStage;
+            let runError;
             inMemoryStatus = {
                 state: "backup",
                 startedAt: new Date().toISOString(),
@@ -678,12 +693,17 @@ export function registerMigrationRoutes(server, options) {
                 if (!backupCommitId) {
                     const msg = "Pre-migration backup did not produce a commitId; aborting.";
                     logger.error("[migrate-route] " + msg);
+                    recordMigrationStage("backup", "failure");
+                    markMigrationRunStage(runSpan, "backup", "failure");
+                    runFailedStage = "backup";
                     inMemoryStatus = { state: "failed", error: msg };
                     return;
                 }
                 logger.info("[migrate-route] Backup commit created", {
                     backupCommitId,
                 });
+                recordMigrationStage("backup", "success");
+                markMigrationRunStage(runSpan, "backup", "success");
                 await persistMigrationStateMetadata(stateFilePath, {
                     backupCommitId,
                     startedAt: inMemoryStatus.startedAt,
@@ -703,12 +723,17 @@ export function registerMigrationRoutes(server, options) {
                     appRootDirPath: appRootDir,
                     templateSourceDirPath: getFullstackTemplateDir(),
                     logger,
+                    ...(integrationWritePolicy !== undefined && {
+                        integrationWritePolicy,
+                    }),
                 });
                 restructured = true;
                 await persistMigrationStateMetadata(stateFilePath, {
                     backupCommitId,
                 });
                 logger.info("[migrate-route] Local restructure complete");
+                recordMigrationStage("restructure", "success");
+                markMigrationRunStage(runSpan, "restructure", "success");
                 inMemoryStatus = {
                     state: "flip",
                     backupCommitId,
@@ -738,6 +763,8 @@ export function registerMigrationRoutes(server, options) {
                 logger.info("[migrate-route] Template flip complete", {
                     migrationCommitId: flip.commitId,
                 });
+                recordMigrationStage("flip", "success");
+                markMigrationRunStage(runSpan, "flip", "success");
                 // After the flip, the SABS pod restarts and this process is
                 // replaced. If by chance we survive, leave in-memory status at
                 // `done` — the GET endpoint will derive `translating` /
@@ -751,24 +778,33 @@ export function registerMigrationRoutes(server, options) {
             }
             catch (error) {
                 const errorMsg = error instanceof Error ? error.message : String(error);
+                const failedStage = restructured
+                    ? "flip"
+                    : backupCommitId
+                        ? "restructure"
+                        : "backup";
                 logger.error("[migrate-route] Migration failed", getErrorMeta(error));
                 logger.info("[migrate-route] Migration context", {
-                    stage: restructured
-                        ? "flip"
-                        : backupCommitId
-                            ? "restructure"
-                            : "backup",
+                    stage: failedStage,
                     backupCommitId,
                     restructured,
                 });
+                recordMigrationStage(failedStage, "failure");
+                markMigrationRunStage(runSpan, failedStage, "failure");
+                runFailedStage = failedStage;
+                runError = error;
                 inMemoryStatus = {
                     state: "failed",
-                    error: `Migration failed at ${restructured ? "flip" : backupCommitId ? "restructure" : "backup"} stage: ${errorMsg}`,
+                    error: `Migration failed at ${failedStage} stage: ${errorMsg}`,
                     backupCommitId,
                     startedAt: inMemoryStatus.startedAt,
                 };
             }
             finally {
+                endMigrationRunSpan(runSpan, {
+                    failedStage: runFailedStage,
+                    error: runError,
+                });
                 if (!shouldSelfRestart) {
                     if (autoSyncPaused) {
                         try {
@@ -924,6 +960,7 @@ export function registerMigrationRoutes(server, options) {
             logger.info("[migrate-route] Completion checkpoint created", {
                 completionCommitId: completionCommit.commitId,
             });
+            recordMigrationStage("complete", "success");
             inMemoryStatus = {
                 state: "done",
                 startedAt: status.startedAt,
@@ -952,6 +989,7 @@ export function registerMigrationRoutes(server, options) {
                 status: updatedStatus,
             }));
         })().catch((error) => {
+            recordMigrationStage("complete", "failure");
             logger.error("[migrate-route] /sb-migration-complete failed", getErrorMeta(error));
             res.statusCode = 500;
             res.end(JSON.stringify({
@@ -974,26 +1012,13 @@ export function registerMigrationRoutes(server, options) {
             }))
                 return;
             const body = req.body;
-            if (!body?.policy ||
-                typeof body.policy !== "object" ||
-                Array.isArray(body.policy)) {
-                res.statusCode = 400;
-                res.setHeader("Content-Type", "application/json");
-                res.end(JSON.stringify({ error: "policy object required" }));
-                return;
-            }
-            const VALID_POLICIES = new Set([
-                "allow",
-                "ask",
-                "deny",
-            ]);
-            const invalidEntries = Object.entries(body.policy).filter(([, v]) => !VALID_POLICIES.has(v));
-            if (invalidEntries.length > 0) {
+            const parsedPolicy = parseIntegrationWritePolicy(body?.policy, {
+                required: true,
+            });
+            if (!parsedPolicy.ok) {
                 res.statusCode = 400;
                 res.setHeader("Content-Type", "application/json");
-                res.end(JSON.stringify({
-                    error: `Invalid policy values for: ${invalidEntries.map(([k]) => k).join(", ")}. Allowed: allow, ask, deny`,
-                }));
+                res.end(JSON.stringify({ error: parsedPolicy.error }));
                 return;
             }
             const scratchDirPath = join(appRootDir, SCRATCH_DIR_NAME);
@@ -1005,7 +1030,7 @@ export function registerMigrationRoutes(server, options) {
             catch {
                 parsed = {};
             }
-            parsed.integrationWritePolicy = body.policy;
+            parsed.integrationWritePolicy = parsedPolicy.policy;
             await mkdir(scratchDirPath, { recursive: true });
             await writeFile(stateFilePath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
             const status = await resolveStatus(appRootDir);
@@ -1072,99 +1097,6 @@ export function registerMigrationRoutes(server, options) {
             }));
         });
     });
-    // --- POST /sb-migration-allow-and-retry-api ----------------------------
-    // Sets every integration referenced by the named API to "allow" in the
-    // write policy, then flips the checklist item back to "pending" so Clark
-    // will re-run the verification tool on its next pass.
-    server.middlewares.use("/sb-migration-allow-and-retry-api", bodyParser.json({ strict: true }));
-    server.middlewares.use("/sb-migration-allow-and-retry-api", (req, res, next) => {
-        void (async () => {
-            if (!getIsInitialized())
-                return next();
-            if (!setupCorsAndValidateMethod({
-                req,
-                res,
-                allowedMethod: "POST",
-                allowHeaders: "Content-Type",
-            }))
-                return;
-            const body = req.body;
-            const apiName = body?.apiName;
-            if (typeof apiName !== "string" || !/^[a-zA-Z0-9_-]+$/.test(apiName)) {
-                res.statusCode = 400;
-                res.setHeader("Content-Type", "application/json");
-                res.end(JSON.stringify({
-                    error: "apiName must be a non-empty string containing only letters, digits, hyphens, or underscores",
-                }));
-                return;
-            }
-            // Read the source file to discover which integration UUIDs are referenced.
-            const sourcePath = join(appRootDir, "server", "apis", apiName, "api.ts");
-            let source;
-            try {
-                source = await readFile(sourcePath, "utf-8");
-            }
-            catch {
-                res.statusCode = 404;
-                res.setHeader("Content-Type", "application/json");
-                res.end(JSON.stringify({ error: `Source not found: ${sourcePath}` }));
-                return;
-            }
-            // Update the write policy: set any referenced integration to "allow".
-            const stateFilePath = join(appRootDir, SCRATCH_DIR_NAME, MIGRATION_STATE_FILE);
-            let parsed;
-            try {
-                parsed = JSON.parse(await readFile(stateFilePath, "utf-8"));
-            }
-            catch {
-                parsed = {};
-            }
-            const existingPolicy = parsed.integrationWritePolicy !== null &&
-                typeof parsed.integrationWritePolicy === "object" &&
-                !Array.isArray(parsed.integrationWritePolicy)
-                ? parsed.integrationWritePolicy
-                : {};
-            // Allow every integration the verifier will gate on. That's the
-            // *union* of v3-source IDs and v2-backup IDs — `runMigrationVerification`
-            // unions the two, so allowing only v3-source IDs here would leave a
-            // v2-only integration sitting at "ask", and `mostRestrictivePolicy`
-            // would keep returning `skipped_mutation` on retry, trapping the user
-            // in an unresolvable loop.
-            const v2BackupPath = join(appRootDir, SCRATCH_DIR_NAME, "v2-backup", "apis", apiName, "api.yaml");
-            const v2Analysis = await analyzeV2BackupMutations(v2BackupPath);
-            const updatedPolicy = { ...existingPolicy };
-            const allowSet = new Set([
-                ...extractIntegrationIdsFromSource(source),
-                ...v2Analysis.integrationIds,
-            ]);
-            for (const id of allowSet) {
-                updatedPolicy[id] = "allow";
-            }
-            parsed.integrationWritePolicy = updatedPolicy;
-            await writeFile(stateFilePath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
-            // Flip the checklist item back to pending so Clark will re-verify.
-            // Clear stale verification fields so classifyItem can't misclassify
-            // if the item transitions to completed via an unexpected path.
-            await updateChecklistItem({
-                appRootDirPath: appRootDir,
-                itemId: `api_${apiName}`,
-                status: "pending",
-                verificationOutcome: null,
-                verificationSkippedReason: null,
-                lastVerificationAt: new Date().toISOString(),
-            });
-            const status = await resolveStatus(appRootDir);
-            res.statusCode = 200;
-            res.setHeader("Content-Type", "application/json");
-            res.end(JSON.stringify({ ok: true, status }));
-        })().catch((error) => {
-            logger.error("[migrate-route] /sb-migration-allow-and-retry-api failed", getErrorMeta(error));
-            res.statusCode = 500;
-            res.end(JSON.stringify({
-                error: error instanceof Error ? error.message : String(error),
-            }));
-        });
-    });
     // --- POST /sb-migration-retry-api ----------------------------------------
     // Flips a single checklist item back to pending so Clark will re-run
     // verification on its next pass, without changing the integration write