gazetta 0.6.0 → 0.8.0

package/dist/admin-api/schemas/error.js

@@ -0,0 +1,79 @@
+/**
+ * Shared shape for admin-API error responses.
+ *
+ * Most error responses follow `{ code: ErrorCode, message: string }`.
+ * Error classes that carry typed extras (`STALE` carries `current` +
+ * `currentEtag`; `VALIDATION_FAILED` carries `issues`) declare their
+ * own schema in the relevant route module — those schemas extend the
+ * base shape, they don't replace it.
+ *
+ * # Why this exists
+ *
+ * Per `docs/audits/test-quality-with-ai.md` cycle 1: error-shape
+ * tautology was the highest-leverage finding. Tests asserted on
+ * status code only; mutation testing showed `code: 'BAD_REQUEST'`
+ * survives mutation to `code: ''` because no test asserts on the
+ * body's `code` field. The fix is structural — assert against the
+ * schema, not the observed shape.
+ *
+ * # Usage
+ *
+ * Tests assert on error responses through `ErrorResponseSchema`:
+ *
+ *   const body = ErrorResponseSchema.parse(await res.json())
+ *   expect(body.code).toBe('BAD_REQUEST')
+ *
+ * `parse` (not `safeParse`) is intentional — a malformed error body
+ * is itself a regression. Failing to round-trip through the schema
+ * is the assertion.
+ *
+ * # Extending
+ *
+ * Routes that emit a typed error variant declare a discriminated
+ * schema in their own module (e.g. `StaleResponseSchema` in
+ * `pages.ts`). The base `ErrorCodeSchema` enum lists every code
+ * the admin-API may emit; extend it when new error classes ship.
+ */
+import { z } from 'zod';
+/**
+ * Closed enum of every error code the admin-API emits.
+ *
+ * Adding a new error class = one new entry here + a route-module
+ * extension if the error carries typed extras. Keeping the enum
+ * closed prevents drift: a route that returns `code: 'NEW_THING'`
+ * without updating this enum fails schema validation in tests, which
+ * surfaces the missing entry before it ships.
+ */
+export const ErrorCodeSchema = z.enum([
+    'AI_ADAPTER_FAILED',
+    'AI_ADAPTER_UNAVAILABLE',
+    'ARCHIVED_NAME_CONFLICT',
+    'ASSET_MANIFEST_NOT_FOUND',
+    'BAD_REQUEST',
+    'FORBIDDEN',
+    'HOOK_CANCELLED',
+    'NOT_FOUND',
+    'PUBLISH_AUDIT_FAILED',
+    'STALE',
+    'UNAUTHENTICATED',
+    'VALIDATION_FAILED',
+]);
+/**
+ * Base error-response shape. Every admin-API error response
+ * round-trips through this OR a route-specific extension of it.
+ *
+ * Optional fields:
+ *   - `message` — human-readable; present on every error today, but
+ *     marked optional because the closed-enum `code` is the stable
+ *     contract; future error classes might omit `message` if the
+ *     code alone carries enough information.
+ *   - `missing` — `FORBIDDEN` responses carry the missing capability
+ *     list per `design-auth-rbac.md` Q3 lock; reserved at the base
+ *     so test assertions don't have to discriminate by code first.
+ */
+export const ErrorResponseSchema = z.object({
+    code: ErrorCodeSchema,
+    message: z.string().optional(),
+    missing: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=error.js.map

package/dist/admin-api/schemas/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,mBAAmB;IACnB,wBAAwB;IACxB,wBAAwB;IACxB,0BAA0B;IAC1B,aAAa;IACb,WAAW;IACX,gBAAgB;IAChB,WAAW;IACX,sBAAsB;IACtB,OAAO;IACP,iBAAiB;IACjB,mBAAmB;CACpB,CAAC,CAAA;AAGF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAA"}

package/dist/admin-api/schemas/fragments.d.ts

@@ -10,6 +10,8 @@ export declare const FragmentSummarySchema: z.ZodObject<{
     name: z.ZodString;
     template: z.ZodString;
     locales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    aliasOf: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type FragmentSummary = z.infer<typeof FragmentSummarySchema>;
 /** Body for POST /api/fragments (create). */

package/dist/admin-api/schemas/fragments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/fragments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,6CAA6C;AAC7C,eAAO,MAAM,2BAA2B;;;iBAKtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,iDAAiD;AACjD,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA"}
+{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/fragments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB;;;;;;iBAQhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,6CAA6C;AAC7C,eAAO,MAAM,2BAA2B;;;iBAKtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E,iDAAiD;AACjD,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA"}

package/dist/admin-api/schemas/fragments.js

@@ -10,6 +10,10 @@ export const FragmentSummarySchema = z.object({
     name: z.string(),
     template: z.string(),
     locales: z.array(z.string()).optional(),
+    /** Archive state per design-soft-delete.md Q1 A1. See pages schema. */
+    archived: z.boolean().optional(),
+    /** Alias target name when archived with aliasOf. */
+    aliasOf: z.string().optional(),
 });
 /** Body for POST /api/fragments (create). */
 export const CreateFragmentRequestSchema = z.object({

package/dist/admin-api/schemas/fragments.js.map

@@ -1 +1 @@
-{"version":3,"file":"fragments.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/fragments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAA;AAGF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,kFAAkF;IAClF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,gDAAgD;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAA;AAGF,iDAAiD;AACjD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAA"}
+{"version":3,"file":"fragments.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/fragments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,uEAAuE;IACvE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,oDAAoD;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAA;AAGF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,kFAAkF;IAClF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,gDAAgD;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAA;AAGF,iDAAiD;AACjD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAA"}

package/dist/admin-api/schemas/index.d.ts

@@ -15,11 +15,17 @@
  *   - POST /api/publish + /api/publish/stream (result + SSE progress union)
  *   - GET  /api/history + POST /api/history/{undo,restore} (revisions + restore)
  *   - POST /api/fetch (cross-target copy)
+ *   - DELETE /api/assets/:name (AssetRef + 409 AssetInUseResponse)
+ *   - GET  /api/system/cache/stats (CacheStats snapshot)
+ *   - GET  /api/audit (forensic event query + external-sink links)
+ *   - 409 VALIDATION_FAILED on save handlers + GET /api/validation/issues
  *
  * Add new endpoint modules here as they move to schema-validated contracts.
  */
+export * from './error.js';
 export * from './pages.js';
 export * from './fragments.js';
+export * from './archive.js';
 export * from './templates.js';
 export * from './fields.js';
 export * from './targets.js';
@@ -29,4 +35,8 @@ export * from './compare.js';
 export * from './publish.js';
 export * from './history.js';
 export * from './fetch.js';
+export * from './assets.js';
+export * from './system.js';
+export * from './audit.js';
+export * from './validation.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/admin-api/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/dist/admin-api/schemas/index.js

@@ -15,11 +15,17 @@
  *   - POST /api/publish + /api/publish/stream (result + SSE progress union)
  *   - GET  /api/history + POST /api/history/{undo,restore} (revisions + restore)
  *   - POST /api/fetch (cross-target copy)
+ *   - DELETE /api/assets/:name (AssetRef + 409 AssetInUseResponse)
+ *   - GET  /api/system/cache/stats (CacheStats snapshot)
+ *   - GET  /api/audit (forensic event query + external-sink links)
+ *   - 409 VALIDATION_FAILED on save handlers + GET /api/validation/issues
  *
  * Add new endpoint modules here as they move to schema-validated contracts.
  */
+export * from './error.js';
 export * from './pages.js';
 export * from './fragments.js';
+export * from './archive.js';
 export * from './templates.js';
 export * from './fields.js';
 export * from './targets.js';
@@ -29,4 +35,8 @@ export * from './compare.js';
 export * from './publish.js';
 export * from './history.js';
 export * from './fetch.js';
+export * from './assets.js';
+export * from './system.js';
+export * from './audit.js';
+export * from './validation.js';
 //# sourceMappingURL=index.js.map

package/dist/admin-api/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/dist/admin-api/schemas/pages.d.ts

@@ -28,6 +28,8 @@ export declare const PageSummarySchema: z.ZodObject<{
     route: z.ZodString;
     template: z.ZodString;
     locales: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+    aliasOf: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type PageSummary = z.infer<typeof PageSummarySchema>;
 /** Body for POST /api/pages (create). */

package/dist/admin-api/schemas/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,mFAAmF;AACnF,eAAO,MAAM,kBAAkB;;;;;;kBAQlB,CAAA;AACb,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,uDAAuD;AACvD,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,yCAAyC;AACzC,eAAO,MAAM,uBAAuB;;;;iBAOlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,mFAAmF;AACnF,eAAO,MAAM,kBAAkB;;;;;;kBAQlB,CAAA;AACb,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,uDAAuD;AACvD,eAAO,MAAM,iBAAiB;;;;;;;iBAgB5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,yCAAyC;AACzC,eAAO,MAAM,uBAAuB;;;;iBAOlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,6CAA6C;AAC7C,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/admin-api/schemas/pages.js

@@ -29,6 +29,17 @@ export const PageSummarySchema = z.object({
     route: z.string(),
     template: z.string(),
     locales: z.array(z.string()).optional(),
+    /**
+     * Archive state per design-soft-delete.md Q1 A1 / Q7 J1. When true,
+     * the admin tree renders the page greyed under the "Show archived
+     * (N)" filter toggle. Absent or false = live.
+     */
+    archived: z.boolean().optional(),
+    /**
+     * Alias target name when archived with aliasOf. Tree row appends
+     * "(archived → {aliasOf})" per Q7 J1 visualization.
+     */
+    aliasOf: z.string().optional(),
 });
 /** Body for POST /api/pages (create). */
 export const CreatePageRequestSchema = z.object({

package/dist/admin-api/schemas/pages.js.map

@@ -1 +1 @@
-{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,QAAQ,EAAE,CAAA;AAGb,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAA;AAGF,yCAAyC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,8EAA8E;IAC9E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,gDAAgD;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAA;AAGF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAA"}
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,QAAQ,EAAE,CAAA;AAGb,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAA;AAGF,yCAAyC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,8EAA8E;IAC9E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,gDAAgD;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAA;AAGF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAA"}

package/dist/admin-api/schemas/rename.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Zod schemas for /api/{pages,fragments}/:name/rename — single source
+ * of truth for request/response shapes per MCP discipline.
+ *
+ * Per `design-soft-delete.md`'s rename grilling:
+ *   - C1: two distinct 409 codes (NAME_COLLISION for live, ARCHIVED_NAME_CONFLICT for archived)
+ *   - H1: single composite `rename` audit event with metadata.flattenedAliases
+ *   - I1: 500 RENAME_PARTIAL with structured state for idempotent retry
+ */
+import { z } from 'zod';
+/**
+ * POST /api/{kind}/:name/rename body. `to` is required; `keepAlias`
+ * defaults to true (the typical rename-with-redirect intent). Setting
+ * `keepAlias: false` is rare — author wants the old URL to 404
+ * instead of 301 (e.g., name was sensitive and shouldn't redirect).
+ */
+export declare const RenameRequestSchema: z.ZodObject<{
+    to: z.ZodString;
+    keepAlias: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RenameRequest = z.infer<typeof RenameRequestSchema>;
+/** Standard ok response carrying the new name + flatten cascade trace. */
+export declare const RenameResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    name: z.ZodString;
+    fromName: z.ZodString;
+    flattenedAliases: z.ZodArray<z.ZodString>;
+    localeVariants: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type RenameResponse = z.infer<typeof RenameResponseSchema>;
+/**
+ * 409 body when the target name is already a live item. Author picks
+ * a different name and retries.
+ */
+export declare const NameCollisionSchema: z.ZodObject<{
+    code: z.ZodLiteral<"NAME_COLLISION">;
+    toName: z.ZodString;
+    conflictKind: z.ZodLiteral<"live">;
+}, z.core.$strip>;
+export type NameCollision = z.infer<typeof NameCollisionSchema>;
+/**
+ * 409 body when the target name is already an archived item. Cut 11's
+ * prompt UX consumes this to show the three-option modal.
+ */
+export declare const ArchivedNameConflictSchema: z.ZodObject<{
+    code: z.ZodLiteral<"ARCHIVED_NAME_CONFLICT">;
+    toName: z.ZodString;
+    conflictKind: z.ZodLiteral<"archived">;
+    archive: z.ZodObject<{
+        archivedAt: z.ZodOptional<z.ZodString>;
+        archivedBy: z.ZodOptional<z.ZodString>;
+        aliasOf: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ArchivedNameConflict = z.infer<typeof ArchivedNameConflictSchema>;
+/**
+ * 500 body when rename partially completed. Client retries the same
+ * request — each step is idempotent (create-new sees `to` exists,
+ * archive-old sees old already archived, flatten skips already-rewritten
+ * archives) per Q9 I1 lock.
+ */
+export declare const RenamePartialSchema: z.ZodObject<{
+    code: z.ZodLiteral<"RENAME_PARTIAL">;
+    completed: z.ZodArray<z.ZodEnum<{
+        "create-new": "create-new";
+        "archive-old": "archive-old";
+        "flatten-cascade": "flatten-cascade";
+    }>>;
+    remaining: z.ZodArray<z.ZodEnum<{
+        "create-new": "create-new";
+        "archive-old": "archive-old";
+        "flatten-cascade": "flatten-cascade";
+    }>>;
+    error: z.ZodString;
+}, z.core.$strip>;
+export type RenamePartial = z.infer<typeof RenamePartialSchema>;
+//# sourceMappingURL=rename.d.ts.map

package/dist/admin-api/schemas/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/rename.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;iBAK9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB;;;;;;iBAU/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;iBAK9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;iBAUrC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;iBAQ9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/admin-api/schemas/rename.js

@@ -0,0 +1,75 @@
+/**
+ * Zod schemas for /api/{pages,fragments}/:name/rename — single source
+ * of truth for request/response shapes per MCP discipline.
+ *
+ * Per `design-soft-delete.md`'s rename grilling:
+ *   - C1: two distinct 409 codes (NAME_COLLISION for live, ARCHIVED_NAME_CONFLICT for archived)
+ *   - H1: single composite `rename` audit event with metadata.flattenedAliases
+ *   - I1: 500 RENAME_PARTIAL with structured state for idempotent retry
+ */
+import { z } from 'zod';
+/**
+ * POST /api/{kind}/:name/rename body. `to` is required; `keepAlias`
+ * defaults to true (the typical rename-with-redirect intent). Setting
+ * `keepAlias: false` is rare — author wants the old URL to 404
+ * instead of 301 (e.g., name was sensitive and shouldn't redirect).
+ */
+export const RenameRequestSchema = z.object({
+    /** Target name. Must not collide with a live item; archived target produces ARCHIVED_NAME_CONFLICT. */
+    to: z.string().min(1),
+    /** When true (default), the old name is archived with `aliasOf: <to>`; render emits 301 + worker marker. */
+    keepAlias: z.boolean().default(true),
+});
+/** Standard ok response carrying the new name + flatten cascade trace. */
+export const RenameResponseSchema = z.object({
+    ok: z.literal(true),
+    /** New name (= request `to`). */
+    name: z.string(),
+    /** Old name (= request URL parameter). */
+    fromName: z.string(),
+    /** Names of archives whose aliasOf was rewritten from the old to the new name. */
+    flattenedAliases: z.array(z.string()),
+    /** Locales found at the renamed path (informational; for forensic queries). */
+    localeVariants: z.array(z.string()),
+});
+/**
+ * 409 body when the target name is already a live item. Author picks
+ * a different name and retries.
+ */
+export const NameCollisionSchema = z.object({
+    code: z.literal('NAME_COLLISION'),
+    toName: z.string(),
+    /** Discriminator — `'live'` distinguishes from ARCHIVED_NAME_CONFLICT in the same client switch. */
+    conflictKind: z.literal('live'),
+});
+/**
+ * 409 body when the target name is already an archived item. Cut 11's
+ * prompt UX consumes this to show the three-option modal.
+ */
+export const ArchivedNameConflictSchema = z.object({
+    code: z.literal('ARCHIVED_NAME_CONFLICT'),
+    toName: z.string(),
+    conflictKind: z.literal('archived'),
+    /** Pre-resolution snapshot for the prompt UI. */
+    archive: z.object({
+        archivedAt: z.string().optional(),
+        archivedBy: z.string().optional(),
+        aliasOf: z.string().optional(),
+    }),
+});
+/**
+ * 500 body when rename partially completed. Client retries the same
+ * request — each step is idempotent (create-new sees `to` exists,
+ * archive-old sees old already archived, flatten skips already-rewritten
+ * archives) per Q9 I1 lock.
+ */
+export const RenamePartialSchema = z.object({
+    code: z.literal('RENAME_PARTIAL'),
+    /** Steps that completed. Used by the client to surface progress. */
+    completed: z.array(z.enum(['create-new', 'archive-old', 'flatten-cascade'])),
+    /** Steps still to run. Idempotent retry will resume from these. */
+    remaining: z.array(z.enum(['create-new', 'archive-old', 'flatten-cascade'])),
+    /** Underlying error message for forensics. */
+    error: z.string(),
+});
+//# sourceMappingURL=rename.js.map

package/dist/admin-api/schemas/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/rename.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,uGAAuG;IACvG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,4GAA4G;IAC5G,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACrC,CAAC,CAAA;AAGF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,iCAAiC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,kFAAkF;IAClF,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,+EAA+E;IAC/E,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACpC,CAAC,CAAA;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,oGAAoG;IACpG,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CAChC,CAAC,CAAA;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACnC,iDAAiD;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;CACH,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,oEAAoE;IACpE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC5E,mEAAmE;IACnE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC5E,8CAA8C;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAA"}

package/dist/admin-api/schemas/site.d.ts

@@ -2,12 +2,13 @@
  * Zod schemas for /api/site — the site manifest shape as seen by the
  * admin UI.
  *
- * Mirrors what parseSiteManifest() emits plus the empty-target fallback
+ * Mirrors what siteConfigToManifest() emits plus the empty-target fallback
  * (which includes an otherwise-absent `targets: {}` field).
  */
 import { z } from 'zod';
 export declare const LocalesConfigSchema: z.ZodObject<{
     supported: z.ZodArray<z.ZodString>;
+    default: z.ZodOptional<z.ZodString>;
     fallbacks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     defaultPrefix: z.ZodOptional<z.ZodBoolean>;
     detection: z.ZodOptional<z.ZodBoolean>;
@@ -15,9 +16,9 @@ export declare const LocalesConfigSchema: z.ZodObject<{
 export declare const SiteManifestSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodOptional<z.ZodString>;
-    locale: z.ZodOptional<z.ZodString>;
     locales: z.ZodOptional<z.ZodObject<{
         supported: z.ZodArray<z.ZodString>;
+        default: z.ZodOptional<z.ZodString>;
         fallbacks: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         defaultPrefix: z.ZodOptional<z.ZodBoolean>;
         detection: z.ZodOptional<z.ZodBoolean>;

package/dist/admin-api/schemas/site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/site.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,mBAAmB;;;;;iBAK9B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAQrB,CAAA;AACV,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/site.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,mBAAmB;;;;;;iBAO9B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAOrB,CAAA;AACV,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/admin-api/schemas/site.js

@@ -2,12 +2,14 @@
  * Zod schemas for /api/site — the site manifest shape as seen by the
  * admin UI.
  *
- * Mirrors what parseSiteManifest() emits plus the empty-target fallback
+ * Mirrors what siteConfigToManifest() emits plus the empty-target fallback
  * (which includes an otherwise-absent `targets: {}` field).
  */
 import { z } from 'zod';
 export const LocalesConfigSchema = z.object({
     supported: z.array(z.string()),
+    /** Default locale; falls back to supported[0] when omitted. */
+    default: z.string().optional(),
     fallbacks: z.record(z.string(), z.string()).optional(),
     defaultPrefix: z.boolean().optional(),
     detection: z.boolean().optional(),
@@ -16,7 +18,6 @@ export const SiteManifestSchema = z
     .object({
     name: z.string(),
     version: z.string().optional(),
-    locale: z.string().optional(),
     locales: LocalesConfigSchema.optional(),
     systemPages: z.array(z.string()).optional(),
 })

package/dist/admin-api/schemas/site.js.map

@@ -1 +1 @@
-{"version":3,"file":"site.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/site.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,KAAK,EAAE,CAAA"}
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/site.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,KAAK,EAAE,CAAA"}

package/dist/admin-api/schemas/system.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Zod schema for /api/system/cache/stats — operational diagnostics
+ * for the admin's L4 `AdminCache`.
+ *
+ * Shape mirrors `CacheStats` from `cache/types.ts`. Required floor is
+ * (hits, misses, size); optional fields surface when the underlying
+ * provider tracks them (MemoryCache tracks all; future providers may
+ * not).
+ */
+import { z } from 'zod';
+export declare const CacheStatsResponseSchema: z.ZodObject<{
+    hits: z.ZodNumber;
+    misses: z.ZodNumber;
+    size: z.ZodNumber;
+    instance: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodNumber>;
+    evictions: z.ZodOptional<z.ZodNumber>;
+    bytesApproximate: z.ZodOptional<z.ZodNumber>;
+    oldestEntryAt: z.ZodOptional<z.ZodString>;
+    lastInvalidation: z.ZodOptional<z.ZodObject<{
+        prefix: z.ZodString;
+        at: z.ZodString;
+        source: z.ZodString;
+    }, z.core.$strip>>;
+    subscribeReconnects: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CacheStatsResponse = z.infer<typeof CacheStatsResponseSchema>;
+//# sourceMappingURL=system.d.ts.map

package/dist/admin-api/schemas/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/system.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;iBAuBnC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/admin-api/schemas/system.js

@@ -0,0 +1,35 @@
+/**
+ * Zod schema for /api/system/cache/stats — operational diagnostics
+ * for the admin's L4 `AdminCache`.
+ *
+ * Shape mirrors `CacheStats` from `cache/types.ts`. Required floor is
+ * (hits, misses, size); optional fields surface when the underlying
+ * provider tracks them (MemoryCache tracks all; future providers may
+ * not).
+ */
+import { z } from 'zod';
+export const CacheStatsResponseSchema = z.object({
+    hits: z.number().int().nonnegative(),
+    misses: z.number().int().nonnegative(),
+    size: z.number().int().nonnegative(),
+    /**
+     * Identity of the reporting cache instance. Operators querying
+     * `/api/system/cache/stats` in multi-instance deployments read this
+     * to know which pod / revision answered (the load balancer's choice
+     * can vary between requests).
+     */
+    instance: z.string().optional(),
+    errors: z.number().int().nonnegative().optional(),
+    evictions: z.number().int().nonnegative().optional(),
+    bytesApproximate: z.number().int().nonnegative().optional(),
+    oldestEntryAt: z.string().optional(),
+    lastInvalidation: z
+        .object({
+        prefix: z.string(),
+        at: z.string(),
+        source: z.string(),
+    })
+        .optional(),
+    subscribeReconnects: z.number().int().nonnegative().optional(),
+});
+//# sourceMappingURL=system.js.map

package/dist/admin-api/schemas/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/system.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACpD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC3D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,gBAAgB,EAAE,CAAC;SAChB,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;SACD,QAAQ,EAAE;IACb,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAA"}

package/dist/admin-api/schemas/targets.d.ts

@@ -18,6 +18,50 @@ export declare const TargetTypeSchema: z.ZodEnum<{
     dynamic: "dynamic";
 }>;
 export type TargetType = z.infer<typeof TargetTypeSchema>;
+/**
+ * AI alt-text capability for a target. Surfaced via /api/targets so
+ * the UI can render affordances based on configuration without probing
+ * via 503 fallback.
+ *
+ *   - `available`: true when the target has a configured adapter AND
+ *     credentials are present in the environment. False otherwise — the
+ *     UI hides AI affordances.
+ *   - `auto`: when `true` and `available`, upload flows fire suggest
+ *     after the upload completes. When `false`, suggestion is on-demand
+ *     only (detail-pane button).
+ */
+export declare const AltTextCapabilitySchema: z.ZodObject<{
+    available: z.ZodBoolean;
+    auto: z.ZodBoolean;
+}, z.core.$strip>;
+export type AltTextCapability = z.infer<typeof AltTextCapabilitySchema>;
+/**
+ * Per-capability runtime gap reason — surfaces in the admin's archive
+ * modal (capability-gap UX surface #2 per `feature-design-process.md`).
+ * `capability` is one of the closed-enum values from
+ * `runtime-capabilities.ts` (`'redirects' | 'gone-status'` today;
+ * extends as new capabilities ship). `reason` is human-readable; the
+ * modal renders it under the per-target capability badge.
+ */
+export declare const CapabilityGapSchema: z.ZodObject<{
+    capability: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type CapabilityGap = z.infer<typeof CapabilityGapSchema>;
+/**
+ * Runtime-capability inspection for a target — surface #2 of the
+ * four-point capability-gap UX pattern. `has` is the array of
+ * supported capabilities; `gaps` enumerates the missing ones with
+ * reasons. The admin UI renders per-target badges using both fields.
+ */
+export declare const TargetCapabilitiesSchema: z.ZodObject<{
+    has: z.ZodArray<z.ZodString>;
+    gaps: z.ZodArray<z.ZodObject<{
+        capability: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TargetCapabilitiesInfo = z.infer<typeof TargetCapabilitiesSchema>;
 /** Entry in the list response for GET /api/targets. */
 export declare const TargetInfoSchema: z.ZodObject<{
     name: z.ZodString;
@@ -31,6 +75,17 @@ export declare const TargetInfoSchema: z.ZodObject<{
         dynamic: "dynamic";
     }>;
     editable: z.ZodBoolean;
+    altText: z.ZodObject<{
+        available: z.ZodBoolean;
+        auto: z.ZodBoolean;
+    }, z.core.$strip>;
+    capabilities: z.ZodObject<{
+        has: z.ZodArray<z.ZodString>;
+        gaps: z.ZodArray<z.ZodObject<{
+            capability: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
 }, z.core.$strip>;
 export type TargetInfo = z.infer<typeof TargetInfoSchema>;
 //# sourceMappingURL=targets.d.ts.map

package/dist/admin-api/schemas/targets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,uBAAuB;;;;EAA6C,CAAA;AACjF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,gBAAgB;;;EAAgC,CAAA;AAC7D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,uDAAuD;AACvD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;iBAK3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,uBAAuB;;;;EAA6C,CAAA;AACjF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,gBAAgB;;;EAAgC,CAAA;AAC7D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;iBAGnC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE7E,uDAAuD;AACvD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;iBAa3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA"}