gazetta 0.7.0 → 0.8.0

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

@@ -9,8 +9,29 @@
  * a proper `{ jsonSchema, ... }` envelope.
  */
 import { z } from 'zod';
+import { IssueSchema } from './validation.js';
 /** Summary used in list responses (GET /api/templates). */
 export const TemplateSummarySchema = z.object({
     name: z.string(),
 });
+/**
+ * GET /api/templates/:name/impact (Validation Cut 6).
+ *
+ * One row per page or fragment that uses the template — top-level
+ * (manifest.template) AND nested inline components (recursive walk).
+ * `issues` is the scanner's per-item issue list; empty when the item
+ * is clean.
+ */
+export const TemplateImpactItemSchema = z.object({
+    kind: z.enum(['page', 'fragment']),
+    name: z.string(),
+    itemPath: z.string(),
+    issues: z.array(IssueSchema),
+});
+export const TemplateImpactResponseSchema = z.object({
+    template: z.string(),
+    items: z.array(TemplateImpactItemSchema),
+    /** Convenience: items.filter(i => i.issues.length > 0).length. */
+    affectedItemCount: z.number().int().nonnegative(),
+});
 //# sourceMappingURL=templates.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;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;CACjB,CAAC,CAAA"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAA;AAGF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;CAC7B,CAAC,CAAA;AAGF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;IACxC,kEAAkE;IAClE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAClD,CAAC,CAAA"}

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

@@ -0,0 +1,101 @@
+/**
+ * Zod schemas for the validation response. The save handlers return a 409
+ * with `ValidationFailedResponseSchema` when save-delta validation finds
+ * error-severity issues. Cut 2 adds the `/api/validation/issues` GET shape
+ * for the background scanner's accumulated state.
+ */
+import { z } from 'zod';
+export declare const SeveritySchema: z.ZodEnum<{
+    error: "error";
+    info: "info";
+    warn: "warn";
+}>;
+export type Severity = z.infer<typeof SeveritySchema>;
+export declare const IssueSchema: z.ZodObject<{
+    validator: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warn: "warn";
+    }>;
+    message: z.ZodString;
+    itemPath: z.ZodString;
+    contentPath: z.ZodOptional<z.ZodString>;
+    suppressible: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type Issue = z.infer<typeof IssueSchema>;
+/**
+ * 409 response body when save-delta validation blocks a write.
+ *
+ * `code` is a stable string for client dispatch; `issues` is the full set
+ * found (both `error` and below — the client decides what to render).
+ */
+export declare const ValidationFailedResponseSchema: z.ZodObject<{
+    code: z.ZodLiteral<"VALIDATION_FAILED">;
+    issues: z.ZodArray<z.ZodObject<{
+        validator: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warn: "warn";
+        }>;
+        message: z.ZodString;
+        itemPath: z.ZodString;
+        contentPath: z.ZodOptional<z.ZodString>;
+        suppressible: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ValidationFailedResponse = z.infer<typeof ValidationFailedResponseSchema>;
+/**
+ * GET /api/validation/issues — current accumulated issues from the background
+ * scanner (Cut 2). The drawer fetches this on admin load + on save SSE; it
+ * doesn't run scans itself.
+ */
+export declare const ValidationIssuesResponseSchema: z.ZodObject<{
+    issues: z.ZodArray<z.ZodObject<{
+        validator: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warn: "warn";
+        }>;
+        message: z.ZodString;
+        itemPath: z.ZodString;
+        contentPath: z.ZodOptional<z.ZodString>;
+        suppressible: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type ValidationIssuesResponse = z.infer<typeof ValidationIssuesResponseSchema>;
+/**
+ * POST /api/publish/audit — run pre-publish-stage validators against the
+ * items operator is about to publish. Cut 4.
+ */
+export declare const PublishAuditRequestSchema: z.ZodObject<{
+    target: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            page: "page";
+            fragment: "fragment";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PublishAuditRequest = z.infer<typeof PublishAuditRequestSchema>;
+export declare const PublishAuditResponseSchema: z.ZodObject<{
+    issues: z.ZodArray<z.ZodObject<{
+        validator: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warn: "warn";
+        }>;
+        message: z.ZodString;
+        itemPath: z.ZodString;
+        contentPath: z.ZodOptional<z.ZodString>;
+        suppressible: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    strict: z.ZodBoolean;
+}, z.core.$strip>;
+export type PublishAuditResponse = z.infer<typeof PublishAuditResponseSchema>;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,cAAc;;;;EAAoC,CAAA;AAC/D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,WAAW;;;;;;;;;;;iBAOtB,CAAA;AACF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;iBAGzC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAErF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;iBAKzC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAErF;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;iBAUpC,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;iBAKrC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA"}

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

@@ -0,0 +1,57 @@
+/**
+ * Zod schemas for the validation response. The save handlers return a 409
+ * with `ValidationFailedResponseSchema` when save-delta validation finds
+ * error-severity issues. Cut 2 adds the `/api/validation/issues` GET shape
+ * for the background scanner's accumulated state.
+ */
+import { z } from 'zod';
+export const SeveritySchema = z.enum(['error', 'warn', 'info']);
+export const IssueSchema = z.object({
+    validator: z.string(),
+    severity: SeveritySchema,
+    message: z.string(),
+    itemPath: z.string(),
+    contentPath: z.string().optional(),
+    suppressible: z.boolean().optional(),
+});
+/**
+ * 409 response body when save-delta validation blocks a write.
+ *
+ * `code` is a stable string for client dispatch; `issues` is the full set
+ * found (both `error` and below — the client decides what to render).
+ */
+export const ValidationFailedResponseSchema = z.object({
+    code: z.literal('VALIDATION_FAILED'),
+    issues: z.array(IssueSchema),
+});
+/**
+ * GET /api/validation/issues — current accumulated issues from the background
+ * scanner (Cut 2). The drawer fetches this on admin load + on save SSE; it
+ * doesn't run scans itself.
+ */
+export const ValidationIssuesResponseSchema = z.object({
+    /** All current issues across the site, flat list. UI groups by `itemPath`. */
+    issues: z.array(IssueSchema),
+    /** Total count (== issues.length) — convenience field for the dot/badge. */
+    total: z.number().int().nonnegative(),
+});
+/**
+ * POST /api/publish/audit — run pre-publish-stage validators against the
+ * items operator is about to publish. Cut 4.
+ */
+export const PublishAuditRequestSchema = z.object({
+    /** Destination target name. Drives `publishAudit.strict` lookup. */
+    target: z.string(),
+    /** Items being published — mirrors the publish request shape. */
+    items: z.array(z.object({
+        kind: z.enum(['page', 'fragment']),
+        name: z.string(),
+    })),
+});
+export const PublishAuditResponseSchema = z.object({
+    /** All issues found at pre-publish stage, with strict promotion already applied. */
+    issues: z.array(IssueSchema),
+    /** True when target's `publishAudit.strict` is set — surfaced for the UI. */
+    strict: z.boolean(),
+});
+//# sourceMappingURL=validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAG/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,cAAc;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;CAC7B,CAAC,CAAA;AAGF;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,8EAA8E;IAC9E,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;IAC5B,4EAA4E;IAC5E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACtC,CAAC,CAAA;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,oEAAoE;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,iEAAiE;IACjE,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC,CACH;CACF,CAAC,CAAA;AAGF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,oFAAoF;IACpF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;IAC5B,6EAA6E;IAC7E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAA"}

package/dist/admin-api/source-context.d.ts

@@ -8,7 +8,8 @@
  * source storage + siteDir pair; tomorrow it can be built from a
  * TargetRegistry's selected editable target with no changes to routes.
  */
-import type { StorageProvider, SiteManifest } from '../types.js';
+import type { GazettaManifest, StorageProvider, SiteManifest } from '../types.js';
+import type { AdminCache } from '../cache/types.js';
 import { type ContentRoot } from '../content-root.js';
 import { type Site, type LoadSiteOptions } from '../site-loader.js';
 import type { TargetRegistry } from '../targets.js';
@@ -25,7 +26,7 @@ export interface SourceContext {
      */
     readonly siteDir: string;
     /**
-     * Absolute path to the project's site directory — where site.yaml lives,
+     * Absolute path to the project's site directory — where site.config.ts lives,
      * and the parent of `templates/` and `admin/`. Independent of storage
      * rooting: always the on-disk project path, even when the content storage
      * is target-rooted elsewhere.
@@ -44,21 +45,43 @@ export interface SourceContext {
     /**
      * Optional history provider for recording revisions on save. Absent
      * when history is disabled for this target (via
-     * `history.enabled: false` in site.yaml) or when history isn't
+     * `history.enabled: false` in site.config.ts) or when history isn't
      * wired at the caller (tests, legacy setups). Save routes check for
      * presence before recording — no-op if absent.
      */
     readonly history?: HistoryProvider;
     /**
-     * Project-level site manifest — read once from sites/{name}/site.yaml
+     * Project-level site manifest — read once from sites/{name}/site.config.ts
      * at boot. Routes pass this to loadSite({ manifest }) so content
-     * discovery works without a target-level site.yaml.
+     * discovery works without a target-level site.config.ts.
      */
     readonly manifest?: SiteManifest;
+    /**
+     * Project-level Gazetta manifest — read once from gazetta.config.ts at
+     * boot. Carries cross-site defaults inherited via the three-rung chain
+     * (gazetta → site → target). Absent when no `gazetta.config.ts` exists.
+     */
+    readonly gazettaManifest?: GazettaManifest;
+    /**
+     * Per-source `AdminCache` instance — already wrapped via `forSite()`
+     * so keys are scoped to this source's site name. Always present;
+     * `createSourceContext` lazily builds a `MemoryCache` when the caller
+     * doesn't supply one.
+     *
+     * Routes that read site-derived data (page summaries, fragment lists,
+     * dependents) read this cache through `loadSiteFromSource` — every
+     * load of the same source returns a `Site` whose `cache` field is the
+     * same instance, so consumers share entries across requests.
+     *
+     * Save handlers invalidate via `source.cache.invalidatePrefix('pages:')`
+     * etc. on writes (Cut 4).
+     */
+    readonly cache: AdminCache;
 }
 /**
  * Load a site from a SourceContext. Passes the project-level manifest
- * so loadSite doesn't need a target-level site.yaml.
+ * so loadSite doesn't need a target-level site config file. Forwards
+ * the source's per-site cache so every load shares one cache instance.
  */
 export declare function loadSiteFromSource(source: SourceContext, opts?: Partial<LoadSiteOptions>): Promise<Site>;
 export interface CreateSourceContextOptions {
@@ -68,13 +91,32 @@ export interface CreateSourceContextOptions {
     /** Absolute project site directory. Defaults to `siteDir` for backward compat. */
     projectSiteDir?: string;
     history?: HistoryProvider;
-    /** Project-level site manifest — passed to loadSite so targets don't need site.yaml. */
+    /** Project-level site manifest — passed to loadSite so targets don't need their own site config. */
     manifest?: SiteManifest;
+    /** Optional gazetta-level manifest; first rung of the three-rung config chain. */
+    gazettaManifest?: GazettaManifest;
+    /**
+     * Pre-built unscoped `AdminCache` — typically the operator's
+     * gazetta.config.ts default or per-site override (Path X). When
+     * provided, `createSourceContext` wraps it with `forSite()` using
+     * the manifest's site name. When absent, a fresh `MemoryCache()`
+     * is built and wrapped.
+     *
+     * The wrapping happens here (not at every loadSite call) so all
+     * loads of the same source share one site-scoped cache instance.
+     */
+    cache?: AdminCache;
+    /**
+     * Site name used for `forSite()` key scoping. Defaults to
+     * `manifest.name`. Required when `manifest` is absent and the
+     * caller still wants a site-scoped cache.
+     */
+    siteName?: string;
 }
 export declare function createSourceContext(opts: CreateSourceContextOptions): SourceContext;
 /**
  * Build a HistoryProvider for a resolved target. Returns `undefined`
- * when history is disabled (via site.yaml `history.enabled: false`).
+ * when history is disabled (via site.config.ts `history.enabled: false`).
  * Injected via `SourceContextFromRegistryOptions.buildHistory` so the
  * source-context module stays agnostic of target-config parsing — the
  * caller (admin-api boot) owns the enabled/retention decision.
@@ -91,7 +133,7 @@ export interface SourceContextFromRegistryOptions {
      */
     siteDir?: string;
     /**
-     * Absolute project site directory — where site.yaml lives. Required.
+     * Absolute project site directory — where site.config.ts lives. Required.
      * This is independent of the target's storage rooting.
      */
     projectSiteDir: string;
@@ -99,6 +141,8 @@ export interface SourceContextFromRegistryOptions {
     buildHistory?: BuildHistory;
     /** Project-level site manifest. */
     manifest?: SiteManifest;
+    /** Optional gazetta-level manifest. */
+    gazettaManifest?: GazettaManifest;
 }
 /**
  * Construct a SourceContext from a TargetRegistry, picking the given target
@@ -121,7 +165,17 @@ export declare function createSourceContextFromRegistry(opts: SourceContextFromR
  * The resolver is called once per handler invocation; implementations can
  * memoize where appropriate.
  */
-export type SourceContextResolver = (targetName: string | undefined) => SourceContext | Promise<SourceContext>;
+export interface SourceContextResolver {
+    (targetName: string | undefined): SourceContext | Promise<SourceContext>;
+    /**
+     * Walk every SourceContext the resolver has memoized. The static
+     * resolver yields its single context; the registry resolver yields
+     * every per-target context built on-demand. Used by `gazetta dev`'s
+     * file watcher to invalidate AdminCache entries on out-of-band
+     * manifest changes (git pull, manual edit, e2e test wipes).
+     */
+    forEachBuilt(fn: (source: SourceContext) => void | Promise<void>): Promise<void>;
+}
 /** Static resolver — always returns the given SourceContext regardless of requested target. */
 export declare function staticSourceResolver(source: SourceContext): SourceContextResolver;
 export interface RegistrySourceResolverOptions {
@@ -147,6 +201,8 @@ export interface RegistrySourceResolverOptions {
     buildHistory?: BuildHistory;
     /** Project-level site manifest. */
     manifest?: SiteManifest;
+    /** Optional gazetta-level manifest. */
+    gazettaManifest?: GazettaManifest;
 }
 /**
  * Registry-backed resolver — picks the named target (or the registry's

package/dist/admin-api/source-context.d.ts.map

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

package/dist/admin-api/source-context.js

@@ -8,16 +8,40 @@
  * source storage + siteDir pair; tomorrow it can be built from a
  * TargetRegistry's selected editable target with no changes to routes.
  */
+import { memoryCache } from '../cache/factories.js';
+import { forSite } from '../cache/per-site.js';
 import { createContentRoot } from '../content-root.js';
 import { loadSite } from '../site-loader.js';
 /**
  * Load a site from a SourceContext. Passes the project-level manifest
- * so loadSite doesn't need a target-level site.yaml.
+ * so loadSite doesn't need a target-level site config file. Forwards
+ * the source's per-site cache so every load shares one cache instance.
  */
 export function loadSiteFromSource(source, opts) {
-    return loadSite({ contentRoot: source.contentRoot, manifest: source.manifest, ...opts });
+    return loadSite({
+        contentRoot: source.contentRoot,
+        manifest: source.manifest,
+        cache: source.cache,
+        ...opts,
+    });
 }
 export function createSourceContext(opts) {
+    // Site-scoped cache: wrap the operator-supplied (or fresh) instance
+    // once, here, so every loadSiteFromSource() call shares it. Per the
+    // single-Site-per-process invariant, the source's site name is
+    // stable for the process lifetime.
+    //
+    // Fallback chain:
+    //   1. opts.cache  — caller owns lifetime explicitly (preferred)
+    //   2. opts.manifest.cache — operator's instance from gazetta.config
+    //      defaults.cache (hoisted into site.cache by applyGazettaDefaults
+    //      in the loader). Without this fallback the operator's tuned
+    //      cache is silently ignored on the registry / direct-loadSite
+    //      paths that pass `manifest` but not `cache`.
+    //   3. fresh memoryCache() — single-Site-per-process invariant means
+    //      each process gets its own; safe default.
+    const siteName = opts.siteName ?? opts.manifest?.name ?? 'unnamed';
+    const cache = forSite(opts.cache ?? opts.manifest?.cache ?? memoryCache(), siteName);
     return {
         storage: opts.storage,
         siteDir: opts.siteDir,
@@ -25,6 +49,8 @@ export function createSourceContext(opts) {
         contentRoot: createContentRoot(opts.storage, opts.siteDir),
         history: opts.history,
         manifest: opts.manifest,
+        gazettaManifest: opts.gazettaManifest,
+        cache,
     };
 }
 /**
@@ -42,13 +68,18 @@ export function createSourceContextFromRegistry(opts) {
             projectSiteDir: opts.projectSiteDir,
             history: opts.buildHistory?.(name, storage),
             manifest: opts.manifest,
+            gazettaManifest: opts.gazettaManifest,
         }),
         targetName: name,
     };
 }
 /** Static resolver — always returns the given SourceContext regardless of requested target. */
 export function staticSourceResolver(source) {
-    return () => source;
+    const resolve = ((_targetName) => source);
+    resolve.forEachBuilt = async (fn) => {
+        await fn(source);
+    };
+    return resolve;
 }
 /**
  * Registry-backed resolver — picks the named target (or the registry's
@@ -58,7 +89,7 @@ export function staticSourceResolver(source) {
  */
 export function registrySourceResolver(opts) {
     const cache = new Map();
-    return async (targetName) => {
+    const resolve = (async (targetName) => {
         const name = targetName ?? opts.registry.defaultEditable();
         const cached = cache.get(name);
         if (cached)
@@ -66,7 +97,7 @@ export function registrySourceResolver(opts) {
         // Cross-target reads may hit targets that weren't pre-initialized by
         // the bootstrap (dev only inits the editable local target by default).
         // If the target is configured but its provider hasn't been built yet,
-        // let the caller lazy-init. Unknown targets (not in site.yaml at all)
+        // let the caller lazy-init. Unknown targets (not in site.config.ts at all)
         // fall through so registry.get throws a clean UnknownTargetError.
         const isConfigured = opts.registry.list().includes(name);
         if (opts.lazyInit && isConfigured) {
@@ -84,9 +115,16 @@ export function registrySourceResolver(opts) {
             buildHistory: opts.buildHistory,
             siteDir: opts.siteDir,
             manifest: opts.manifest,
+            gazettaManifest: opts.gazettaManifest,
         });
         cache.set(name, ctx);
         return ctx;
+    });
+    resolve.forEachBuilt = async (fn) => {
+        for (const ctx of cache.values()) {
+            await fn(ctx);
+        }
     };
+    return resolve;
 }
 //# sourceMappingURL=source-context.js.map

package/dist/admin-api/source-context.js.map

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

package/dist/ai/adapter-scaffold.d.ts

@@ -0,0 +1,63 @@
+import type { AltGenerateInput, AltTextAdapter } from '../alt/adapter.js';
+/** Approximate characters-per-output-token for max-tokens derivation. */
+export declare const CHARS_PER_TOKEN = 4;
+/** Floor for derived max-tokens; ensures small maxChars still gives the model room. */
+export declare const MIN_MAX_TOKENS = 64;
+/**
+ * Provider-specific request closure passed to the scaffold. The closure
+ * makes the actual SDK call and returns the response text.
+ *
+ * The scaffold supplies:
+ *   - `bytes` / `mime` from prepared input
+ *   - `systemPrompt` already prepended with operator override (if any)
+ *   - `maxTokens` already resolved (operator override OR derived from maxChars)
+ *   - `userPrompt` from the suggester's compose-prompt output (the
+ *     base prompt minus operator's prepend; useful for OpenAI/Ollama
+ *     which split system vs. user)
+ *   - `request` original AltRequest for adapters that want maxChars / locale
+ *   - `signal` AbortSignal forwarded from caller
+ */
+export interface ProviderCallInput {
+    bytes: Uint8Array;
+    mime: string;
+    systemPrompt: string;
+    maxTokens: number;
+    request: AltGenerateInput['request'];
+    signal?: AbortSignal;
+}
+export interface AdapterScaffoldOptions {
+    /** Stable identifier for diagnostics ('anthropic', 'openai', 'ollama'). */
+    name: string;
+    /** MIME types the underlying provider accepts. */
+    supportedMimes: ReadonlySet<string>;
+    /** Operator-supplied system prompt; prepended to the system-composed prompt. */
+    operatorSystemPrompt?: string;
+    /** Operator-supplied max tokens; overrides derivation from maxChars. */
+    operatorMaxTokens?: number;
+    /** Provider-specific refusal markers; layered on top of shared markers. */
+    refusalMarkers: readonly string[];
+    /**
+     * Provider SDK call. Returns response text on success; throws on
+     * transport / API failure. Aborts should propagate as-is so the
+     * suggester's `signal.aborted` check returns null.
+     */
+    callProvider(input: ProviderCallInput): Promise<string>;
+    /**
+     * True for the SDK's user-abort exception type. Different SDKs throw
+     * different abort types; the scaffold lets each provider declare
+     * which one to pass through unchanged.
+     */
+    isAbortError(err: unknown): boolean;
+    /**
+     * Optional human-readable context appended to error messages
+     * (e.g., "Is Ollama running at http://localhost:11434?").
+     */
+    errorContextSuffix?: string;
+}
+/**
+ * Build an `AltTextAdapter` from provider-specific configuration. Owns
+ * the orchestration so per-provider files contribute only the SDK call
+ * and shape parsing.
+ */
+export declare function buildAltAdapterFromScaffold(opts: AdapterScaffoldOptions): AltTextAdapter;
+//# sourceMappingURL=adapter-scaffold.d.ts.map

package/dist/ai/adapter-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-scaffold.d.ts","sourceRoot":"","sources":["../../src/ai/adapter-scaffold.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAExF,yEAAyE;AACzE,eAAO,MAAM,eAAe,IAAI,CAAA;AAChC,uFAAuF;AACvF,eAAO,MAAM,cAAc,KAAK,CAAA;AAEhC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACnC,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,2EAA2E;IAC3E,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvD;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAA;IACnC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,sBAAsB,GAAG,cAAc,CAyDxF"}

package/dist/ai/adapter-scaffold.js

@@ -0,0 +1,89 @@
+/**
+ * Shared scaffolding for `AltTextAdapter` implementations.
+ *
+ * Per Phase 4 of the Path X migration: the three v1.5 providers (Anthropic,
+ * OpenAI, Ollama) share substantial orchestration — operator-supplied
+ * prompt prepending, max-tokens derivation, refusal-marker layering, error
+ * translation. This module owns those shared concerns; per-provider files
+ * contribute only the provider-specific call (`callProvider`), abort
+ * detection (`isAbortError`), and refusal markers (`refusalMarkers`).
+ *
+ * # SOLID
+ *
+ *   - SRP: this module owns the alt-text adapter orchestration. Provider
+ *     files own the SDK call + response parsing.
+ *   - OCP: adding a fourth provider supplies a `callProvider` closure;
+ *     no edits to scaffolding.
+ *   - LSP: every adapter built via this scaffold honors the
+ *     `AltTextAdapter` contract identically.
+ *   - DIP: scaffold depends on `AltTextAdapter`, `AltGenerateInput`,
+ *     `AltSuggestion` — abstractions, not provider SDK types.
+ */
+import { AIAdapterFailedError, AIError } from './errors.js';
+import { detectRefusal } from './refusal.js';
+/** Approximate characters-per-output-token for max-tokens derivation. */
+export const CHARS_PER_TOKEN = 4;
+/** Floor for derived max-tokens; ensures small maxChars still gives the model room. */
+export const MIN_MAX_TOKENS = 64;
+/**
+ * Build an `AltTextAdapter` from provider-specific configuration. Owns
+ * the orchestration so per-provider files contribute only the SDK call
+ * and shape parsing.
+ */
+export function buildAltAdapterFromScaffold(opts) {
+    const operatorSystemPrompt = opts.operatorSystemPrompt;
+    const operatorMaxTokens = opts.operatorMaxTokens;
+    return {
+        name: opts.name,
+        supports(mime) {
+            return opts.supportedMimes.has(mime);
+        },
+        async generate(input, signal) {
+            // max_tokens: operator override > derived from maxChars.
+            const maxTokens = operatorMaxTokens ?? Math.max(MIN_MAX_TOKENS, Math.ceil(input.request.maxChars / CHARS_PER_TOKEN));
+            // System prompt: operator-supplied prepends to the system-composed
+            // prompt (per design-ai.md "Prompt composition"). Empty/absent
+            // operator prompt → just the system-composed.
+            const systemPrompt = operatorSystemPrompt ? `${operatorSystemPrompt}\n\n${input.prompt}` : input.prompt;
+            let text;
+            try {
+                text = await opts.callProvider({
+                    bytes: input.bytes,
+                    mime: input.mime,
+                    systemPrompt,
+                    maxTokens,
+                    request: input.request,
+                    signal,
+                });
+            }
+            catch (err) {
+                // Aborts pass through — suggester checks `signal.aborted` and
+                // returns null. Wrapping into AIAdapterFailedError would lose
+                // the abort signal.
+                if (opts.isAbortError(err))
+                    throw err;
+                // AI-domain errors thrown by the provider's response-parsing
+                // (e.g., AIInvalidResponseError when the SDK returns no text
+                // block) pass through unchanged. Only transport / SDK-level
+                // failures get wrapped as AIAdapterFailedError.
+                if (err instanceof AIError)
+                    throw err;
+                const suffix = opts.errorContextSuffix ? `. ${opts.errorContextSuffix}` : '';
+                if (err instanceof Error) {
+                    throw new AIAdapterFailedError(`${opts.name} alt-text generation failed: ${err.message}${suffix}`, {
+                        cause: err,
+                    });
+                }
+                throw new AIAdapterFailedError(`${opts.name} alt-text generation failed: unknown error${suffix}`);
+            }
+            const trimmed = text.trim();
+            const refusal = detectRefusal(trimmed, opts.refusalMarkers);
+            return {
+                text: trimmed,
+                refused: refusal.refused,
+                refusalReason: refusal.reason,
+            };
+        },
+    };
+}
+//# sourceMappingURL=adapter-scaffold.js.map

package/dist/ai/adapter-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-scaffold.js","sourceRoot":"","sources":["../../src/ai/adapter-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAG5C,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAChC,uFAAuF;AACvF,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAA;AAuDhC;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAA4B;IACtE,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAA;IACtD,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAA;IAEhD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,CAAC,IAAY;YACnB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACtC,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,KAAuB,EAAE,MAAoB;YAC1D,yDAAyD;YACzD,MAAM,SAAS,GACb,iBAAiB,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAA;YAEpG,mEAAmE;YACnE,+DAA+D;YAC/D,8CAA8C;YAC9C,MAAM,YAAY,GAAG,oBAAoB,CAAC,CAAC,CAAC,GAAG,oBAAoB,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAA;YAEvG,IAAI,IAAY,CAAA;YAChB,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;oBAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,YAAY;oBACZ,SAAS;oBACT,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,MAAM;iBACP,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,8DAA8D;gBAC9D,8DAA8D;gBAC9D,oBAAoB;gBACpB,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;oBAAE,MAAM,GAAG,CAAA;gBACrC,6DAA6D;gBAC7D,6DAA6D;gBAC7D,4DAA4D;gBAC5D,gDAAgD;gBAChD,IAAI,GAAG,YAAY,OAAO;oBAAE,MAAM,GAAG,CAAA;gBACrC,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;gBAC5E,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;oBACzB,MAAM,IAAI,oBAAoB,CAAC,GAAG,IAAI,CAAC,IAAI,gCAAgC,GAAG,CAAC,OAAO,GAAG,MAAM,EAAE,EAAE;wBACjG,KAAK,EAAE,GAAG;qBACX,CAAC,CAAA;gBACJ,CAAC;gBACD,MAAM,IAAI,oBAAoB,CAAC,GAAG,IAAI,CAAC,IAAI,6CAA6C,MAAM,EAAE,CAAC,CAAA;YACnG,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;YAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;YAC3D,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,aAAa,EAAE,OAAO,CAAC,MAAM;aAC9B,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}