@percher/core 0.3.0 → 0.4.1

package/dist/commands/publish.d.ts

@@ -1,7 +1,7 @@
 import { type App, type BuildProblem, type Deployment } from "@percher/client";
-import { z } from "zod/v3";
+import { z } from "zod";
 import type { Context } from "../context";
-import { type DeployPhase, type ErrorClass } from "../error-classifier";
+import type { DeployPhase, ErrorClass } from "../error-classifier";
 import { type PublishRecovery, type PublishStatus } from "../recovery";
 export declare const publishInputSchema: z.ZodObject<{
     force: z.ZodOptional<z.ZodBoolean>;
@@ -10,21 +10,7 @@ export declare const publishInputSchema: z.ZodObject<{
     dryRun: z.ZodOptional<z.ZodBoolean>;
     noCache: z.ZodOptional<z.ZodBoolean>;
     waitForLive: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    message?: string | undefined;
-    force?: boolean | undefined;
-    dryRun?: boolean | undefined;
-    preview?: boolean | undefined;
-    noCache?: boolean | undefined;
-    waitForLive?: boolean | undefined;
-}, {
-    message?: string | undefined;
-    force?: boolean | undefined;
-    dryRun?: boolean | undefined;
-    preview?: boolean | undefined;
-    noCache?: boolean | undefined;
-    waitForLive?: boolean | undefined;
-}>;
+}, z.core.$strip>;
 export type PublishInput = z.infer<typeof publishInputSchema>;
 export interface PublishTiming {
     totalSeconds: number;
@@ -91,6 +77,29 @@ export interface PublishResult {
     qrDataUri?: string;
     loginUrl?: string;
     loginCode?: string;
+    /**
+     * FUTURE16 Fas 3 — opaque device-code returned alongside `loginUrl`
+     * on the MCP `auth_pending` path. The agent passes this verbatim to
+     * `percher_wait_for_auth({ deviceCode, publishArgs })` to short-poll
+     * the exchange. Echoed in `recovery.args.deviceCode` too — both slots
+     * carry the same value so a literal-recovery-following agent doesn't
+     * need to read top-level fields. Absent on every other code-path.
+     */
+    deviceCode?: string;
+    /**
+     * FUTURE16 Fas 3 — recommended seconds between `exchangeDeviceCode`
+     * polls when the agent runs its own poll loop instead of using
+     * `percher_wait_for_auth`. The wait tool defaults to this value
+     * already; the field exists for transparency / debugging.
+     */
+    pollIntervalSec?: number;
+    /**
+     * FUTURE16 Fas 3 — ISO-8601 deadline after which the device-code is
+     * dead and the exchange will return `AUTHORIZATION_PENDING` forever.
+     * `percher_wait_for_auth` enforces this internally and returns
+     * `auth_failed` with `reason: "expired"` if hit.
+     */
+    expiresAt?: string;
     app?: App;
     deployment?: Deployment;
     timing?: PublishTiming;
@@ -114,14 +123,46 @@ export interface PublishResult {
      * Absent (not just `false`) when we couldn't fetch the timeline —
      * makes "we don't know" distinguishable from "we know it wasn't a
      * cache hit."
+     *
+     * @deprecated FUTURE11 Fas 4 — prefer {@link cacheStatus} when
+     * available. `cacheHit: true` ↔ `cacheStatus === "image_reused"`,
+     * but the boolean cannot distinguish layer-hit from fresh-build.
      */
     cacheHit?: boolean;
+    /**
+     * FUTURE11 Fas 4 — three-valued cache status:
+     *   - `"image_reused"` — content-hash hit, build skipped entirely.
+     *   - `"layer_hit"` — fresh build ran, BuildKit reused ≥50% of steps.
+     *   - `"fresh"` — fresh build, ≤50% of steps cached.
+     *
+     * Absent on pre-Fas-4 deploys (server hasn't reported it); CLI
+     * falls back to `cacheHit` in that case.
+     */
+    cacheStatus?: "image_reused" | "layer_hit" | "fresh";
+    /**
+     * Phase 7.8 follow-up — true when the CLI's pre-upload cache-probe
+     * matched a prior live deploy and we redeployed via /rerun instead
+     * of streaming the tarball through the upload + queue path. Implies
+     * `cacheHit: true` on the resulting build (the image_cache reuses
+     * the source deploy's image), but the two flags answer different
+     * questions: `cacheHit` = "the build skipped because the image
+     * matched"; `cacheReused` = "we never even uploaded — the publish
+     * call short-circuited on a content-hash probe."
+     */
+    cacheReused?: boolean;
     /**
      * Public-prefix vars referenced in source but absent from the env store.
      * Populated on live and failed paths. Absent when the scan didn't run
      * (dry-run, pre-auth failure) or when all refs are covered.
      */
     missingBuildEnvKeys?: string[];
+    /**
+     * Phase 7.9 — publish-wide trace ID. Stable across the CLI retry
+     * chain so an operator can grep CLI/API/worker logs by a single key.
+     * Absent only on early exits that never minted one (dry-run,
+     * config-validation failure before the upload phase).
+     */
+    traceId?: string;
     /**
      * Machine-readable next-step for AI agents. Always present — `nextAction`
      * is `"none"` on success. Treat `nextAction` values as a stable enum

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

@@ -1 +1 @@
-{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,GAAG,EACR,KAAK,YAAY,EAEjB,KAAK,UAAU,EAIhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAiB,MAAM,qBAAqB,CAAC;AAEvF,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAUnB,MAAM,aAAa,CAAC;AASrB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAyB7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAoJD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,YAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CA+B5F"}
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"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"}