@aotter/mantle-runtime 0.0.11-alpha.11

package/dist/runtime.d.ts

@@ -0,0 +1,132 @@
+import { type Manifest, type ProcedureManifest, type SchemaManifest, type SiteDefaults, type TriggerManifest, type ViewManifest } from "@aotter/mantle-spec";
+import type { AnyHandler } from "./domain/model/HandlerContext.js";
+import type { TemplateRegistry } from "./domain/model/TemplateRegistry.js";
+import type { AssetServer } from "./domain/port/AssetServer.js";
+import type { DatabaseDriver } from "./domain/port/DatabaseDriver.js";
+import type { DeferredHookDispatcher } from "./domain/port/DeferredHookDispatcher.js";
+import type { KvCache } from "./domain/port/KvCache.js";
+import type { MediaStorage } from "./domain/port/MediaStorage.js";
+import type { PublishOrchestrator } from "./domain/port/PublishOrchestrator.js";
+import type { SiteConfigRepository } from "./domain/port/SiteConfigRepository.js";
+import { type Clock } from "./domain/port/Clock.js";
+import { type IdGenerator } from "./domain/port/IdGenerator.js";
+import { type HandlerRegistry } from "./domain/port/HandlerRegistry.js";
+import { ArchiveUseCase, CreateDraftUseCase, DeleteEntryUseCase, GetEntryUseCase, ListEntriesUseCase, RequestPublishUseCase, UnpublishUseCase, UpdateDraftUseCase } from "./usecase/content/index.js";
+import { InvokeProcedureUseCase } from "./usecase/procedure/index.js";
+import { ExecuteViewUseCase } from "./usecase/view/index.js";
+import { ValidateBootUseCase } from "./usecase/boot/index.js";
+import { RunDeferredHookUseCase } from "./usecase/lifecycle/index.js";
+import { ComposeEntrySeoMetaUseCase, ComposeLlmsTxtUseCase, ComposeSitemapUseCase, PreviewEntryUseCase, RenderEntryLiveUseCase, RenderListLiveUseCase } from "./usecase/render/index.js";
+import { CommitMediaUploadUseCase, CreateMediaUploadUseCase } from "./usecase/media/index.js";
+import type { PublicPathResolver } from "./domain/service/PublicPathResolver.js";
+/**
+ * `createCmsRuntime` — assembly root. Per the clean-architecture
+ * convention, this file is the only place that wires concrete
+ * adapters (`infrastructure/persistence/*`, `infrastructure/render/*`)
+ * to use cases (`usecase/content/*`, etc.) via ports
+ * (`domain/port/*`).
+ *
+ * Adapters call this once at boot, pass the required ADR-0011 ports +
+ * the consumer's manifests + handlers + templates + siteDefaults, and
+ * receive a `CmsRuntime` they expose to their HTTP framework's
+ * routing layer.
+ *
+ * `bootInit()` runs migrations, seeds `siteDefaults`, and validates
+ * the manifest set against the registry. Throws `BootValidationError`
+ * on any boot diagnostic — adapters surface the error in their init
+ * logs.
+ */
+export interface CreateCmsRuntimeArgs {
+    readonly manifests: readonly Manifest[];
+    readonly handlers?: Readonly<Record<string, AnyHandler>>;
+    readonly templates?: TemplateRegistry;
+    readonly siteDefaults?: SiteDefaults;
+    /** Required ADR-0011 ports. */
+    readonly db: DatabaseDriver;
+    readonly kv: KvCache;
+    readonly assets: AssetServer;
+    /** Optional public-path resolver. When set, the publish pipeline
+     *  composes SEO/AEO meta on every entry render and the resolved
+     *  paths drive sitemap / hreflang sibling URLs. Adapters that
+     *  expose request-time render routes should also pass this through
+     *  so request-time HTML matches publish-time HTML. */
+    readonly publicPathResolver?: PublicPathResolver;
+    /** Optional media storage adapter. When unset, media MCP tools and
+     *  admin upload endpoints are not registered — uploads return 404 /
+     *  `MEDIA_NOT_CONFIGURED`. When set, the runtime wires
+     *  `CreateMediaUpload` + `CommitMediaUpload` use cases backed by
+     *  this adapter. The KV mapping for pending uploads reuses `args.kv`. */
+    readonly mediaStorage?: MediaStorage;
+    /** Whether the SVG mime is allowed in `CreateMediaUpload`. Default
+     *  false; object stores don't sanitize SVG payloads. */
+    readonly mediaAllowSvg?: boolean;
+    /** Optional override of the default 25 MB upload byte ceiling. */
+    readonly mediaMaxBytes?: number;
+    /** Optional deferred-delivery dispatcher for `after_*` lifecycle
+     *  hooks. When set, after-hooks are enqueued through it instead of
+     *  riding `ctx.waitUntil` / inline-await. Cloudflare adapter wires
+     *  a Workers-Queues-backed impl by default. Absent → existing
+     *  waitUntil → inline ladder applies. */
+    readonly deferredHookDispatcher?: DeferredHookDispatcher;
+    /** Optional clock — test seam. Defaults to `SystemClock`. */
+    readonly clock?: Clock;
+    /** Optional id generator — test seam. Defaults to `RandomUuidGenerator`. */
+    readonly idgen?: IdGenerator;
+}
+export interface CmsRuntime {
+    /** Required ADR-0011 ports — re-exposed so adapters can pass them downstream. */
+    readonly db: DatabaseDriver;
+    readonly kv: KvCache;
+    readonly assets: AssetServer;
+    /** Use cases (pre-wired with ports + clock + idgen). */
+    readonly createDraft: CreateDraftUseCase;
+    readonly updateDraft: UpdateDraftUseCase;
+    readonly getEntry: GetEntryUseCase;
+    readonly listEntries: ListEntriesUseCase;
+    readonly requestPublish: RequestPublishUseCase;
+    readonly unpublish: UnpublishUseCase;
+    readonly archive: ArchiveUseCase;
+    readonly deleteEntry: DeleteEntryUseCase;
+    readonly invokeProcedure: InvokeProcedureUseCase;
+    readonly executeView: ExecuteViewUseCase;
+    readonly composeLlmsTxt: ComposeLlmsTxtUseCase;
+    readonly composeSitemap: ComposeSitemapUseCase;
+    readonly composeEntrySeoMeta: ComposeEntrySeoMetaUseCase;
+    readonly renderEntryLive: RenderEntryLiveUseCase;
+    readonly renderListLive: RenderListLiveUseCase;
+    readonly previewEntry: PreviewEntryUseCase;
+    readonly validateBoot: ValidateBootUseCase;
+    readonly publishOrchestrator: PublishOrchestrator;
+    readonly siteConfig: SiteConfigRepository;
+    /** The resolver passed at boot, or `null` when the consumer didn't
+     *  supply one. Adapters use this to derive URLs (sitemap, SEO
+     *  hreflangs) without rebuilding the mapping. */
+    readonly publicPathResolver: PublicPathResolver | null;
+    /** Pre-wired media use cases when `mediaStorage` was supplied; null
+     *  otherwise. Adapters route admin endpoints + MCP tools off this. */
+    readonly media: {
+        readonly storage: MediaStorage;
+        readonly createUpload: CreateMediaUploadUseCase;
+        readonly commitUpload: CommitMediaUploadUseCase;
+    } | null;
+    /** Drive a deferred after-hook from an enqueued envelope. Adapter
+     *  queue consumers call `runDeferredHook.execute({ envelope, env })`
+     *  with the consume-side binding bag (different invocation than
+     *  the one that produced the envelope). */
+    readonly runDeferredHook: RunDeferredHookUseCase;
+    /** Adapter-helper bag. */
+    readonly registry: HandlerRegistry;
+    readonly templates: TemplateRegistry;
+    readonly schemasByName: ReadonlyMap<string, SchemaManifest>;
+    readonly proceduresByName: ReadonlyMap<string, ProcedureManifest>;
+    readonly viewsByName: ReadonlyMap<string, ViewManifest>;
+    readonly triggers: readonly TriggerManifest[];
+    readonly triggersByName: ReadonlyMap<string, TriggerManifest>;
+    readonly clock: Clock;
+    readonly idgen: IdGenerator;
+    /** Run migrations, seed siteDefaults, and validate boot. Adapters
+     *  call this once per isolate before routing requests. */
+    bootInit(): Promise<void>;
+}
+export declare function createCmsRuntime(args: CreateCmsRuntimeArgs): CmsRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,sBAAsB,EAEvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAUjF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;;0DAIsD;IACtD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD;;;;6EAIyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC;4DACwD;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;6CAIyC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IACzD,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;IACzD,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C;;qDAEiD;IACjD,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvD;0EACsE;IACtE,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAC/B,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;QAChD,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;KACjD,GAAG,IAAI,CAAC;IACT;;;+CAG2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IAEjD,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5D,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAClE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B;8DAC0D;IAC1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,UAAU,CAiLvE"}

package/dist/runtime.js

@@ -0,0 +1,142 @@
+import { partitionManifests, } from "@aotter/mantle-spec";
+import { SystemClock } from "./domain/port/Clock.js";
+import { RandomUuidGenerator, } from "./domain/port/IdGenerator.js";
+import { buildHandlerRegistry, } from "./domain/port/HandlerRegistry.js";
+import { ArchiveUseCase, CreateDraftUseCase, DeleteEntryUseCase, GetEntryUseCase, ListEntriesUseCase, RequestPublishUseCase, UnpublishUseCase, UpdateDraftUseCase, } from "./usecase/content/index.js";
+import { InvokeBuiltinUseCase, InvokeProcedureUseCase, } from "./usecase/procedure/index.js";
+import { ExecuteViewUseCase } from "./usecase/view/index.js";
+import { ValidateBootUseCase } from "./usecase/boot/index.js";
+import { RunDeferredHookUseCase, RunLifecycleHooksUseCase, } from "./usecase/lifecycle/index.js";
+import { ComposeEntrySeoMetaUseCase, ComposeLlmsTxtUseCase, ComposeSitemapUseCase, PreviewEntryUseCase, RenderEntryLiveUseCase, RenderListLiveUseCase, } from "./usecase/render/index.js";
+import { CommitMediaUploadUseCase, CreateMediaUploadUseCase, } from "./usecase/media/index.js";
+import { TemplateRegistry as TemplateRegistryImpl } from "./domain/model/TemplateRegistry.js";
+import { TriggerIndex } from "./domain/service/TriggerIndex.js";
+import { DatabaseEntryRepository } from "./infrastructure/persistence/DatabaseEntryRepository.js";
+import { DatabaseSiteConfigRepository } from "./infrastructure/persistence/DatabaseSiteConfigRepository.js";
+import { LifecycleHookingEntryRepository } from "./infrastructure/persistence/LifecycleHookingEntryRepository.js";
+import { HtmlPublishOrchestrator } from "./infrastructure/render/index.js";
+import { CANONICAL_MIGRATIONS } from "./infrastructure/boot/index.js";
+export function createCmsRuntime(args) {
+    const partitioned = partitionManifests([...args.manifests]);
+    const schemasByName = new Map();
+    for (const s of partitioned.schemas)
+        schemasByName.set(s.metadata.name, s);
+    const proceduresByName = new Map();
+    for (const p of partitioned.procedures)
+        proceduresByName.set(p.metadata.name, p);
+    const viewsByName = new Map();
+    for (const v of partitioned.views)
+        viewsByName.set(v.metadata.name, v);
+    const triggersByName = new Map();
+    for (const t of partitioned.triggers)
+        triggersByName.set(t.metadata.name, t);
+    const registry = buildHandlerRegistry(args.handlers ?? {});
+    const templates = args.templates ?? new TemplateRegistryImpl();
+    const clock = args.clock ?? SystemClock;
+    const idgen = args.idgen ?? RandomUuidGenerator;
+    // Repositories: DB-backed inner + lifecycle-hook decorator. Every
+    // mutation through `entries` (create / update / delete / archive /
+    // transitionStatus) fires the matching Triggers via
+    // `RunLifecycleHooksUseCase`. Symmetric chokepoint per POC ADR-0014:
+    // MCP, admin, and builtin paths all hit the same wrapped repository.
+    const innerEntries = new DatabaseEntryRepository(args.db);
+    const triggerIndex = new TriggerIndex(partitioned.triggers);
+    const siteConfig = new DatabaseSiteConfigRepository(args.db);
+    // `entries` is filled below — assigned via `let` so the lifecycle
+    // hooks (which run procedures, which can themselves write entries
+    // via builtin handlers) close over the wrapped repo, not the bare
+    // DB-backed one. Without this every builtin write inside a hook
+    // would skip the decorator and silently bypass downstream hooks.
+    let entries;
+    const entriesProxy = {
+        create: (a) => entries.create(a),
+        get: (id) => entries.get(id),
+        update: (a) => entries.update(a),
+        delete: (a) => entries.delete(a),
+        archive: (a) => entries.archive(a),
+        transitionStatus: (a) => entries.transitionStatus(a),
+        list: (a) => entries.list(a),
+        findByDataField: (a) => entries.findByDataField(a),
+        findByDataFields: (a) => entries.findByDataFields(a),
+    };
+    const invokeBuiltin = new InvokeBuiltinUseCase(entriesProxy, schemasByName, clock, idgen, siteConfig);
+    const invokeProcedure = new InvokeProcedureUseCase(registry, invokeBuiltin);
+    const lifecycleHooks = new RunLifecycleHooksUseCase(triggerIndex, proceduresByName, (req) => invokeProcedure.execute(req));
+    entries = new LifecycleHookingEntryRepository(innerEntries, triggerIndex, lifecycleHooks, args.deferredHookDispatcher);
+    const runDeferredHook = new RunDeferredHookUseCase(lifecycleHooks);
+    const publicPathResolver = args.publicPathResolver ?? null;
+    const composeEntrySeoMeta = new ComposeEntrySeoMetaUseCase(args.db);
+    const composeLlmsTxt = new ComposeLlmsTxtUseCase(args.db);
+    const publishOrchestrator = new HtmlPublishOrchestrator(args.db, args.kv, publicPathResolver, composeEntrySeoMeta, composeLlmsTxt, schemasByName);
+    // Content / view / boot use cases. They see `entries` only as the
+    // chokepoint port — hook firing is invisible to them.
+    const createDraft = new CreateDraftUseCase(entries, schemasByName, clock, idgen, siteConfig);
+    const updateDraft = new UpdateDraftUseCase(entries, schemasByName, clock, siteConfig);
+    const getEntry = new GetEntryUseCase(entries);
+    const listEntries = new ListEntriesUseCase(entries, schemasByName);
+    const contentPublishEffects = { publishOrchestrator, siteConfig, templates };
+    const requestPublish = new RequestPublishUseCase(entries, schemasByName, clock, contentPublishEffects, siteConfig);
+    const unpublish = new UnpublishUseCase(entries, schemasByName, clock, contentPublishEffects);
+    const archive = new ArchiveUseCase(entries, schemasByName, clock, contentPublishEffects);
+    const deleteEntry = new DeleteEntryUseCase(entries);
+    const executeView = new ExecuteViewUseCase(args.db);
+    const composeSitemap = new ComposeSitemapUseCase(args.db);
+    const renderEntryLive = new RenderEntryLiveUseCase(args.db, templates, publicPathResolver, composeEntrySeoMeta, schemasByName);
+    const renderListLive = new RenderListLiveUseCase(args.db, templates, schemasByName);
+    const previewEntry = new PreviewEntryUseCase(args.db, templates, publicPathResolver, composeEntrySeoMeta, schemasByName);
+    const validateBoot = new ValidateBootUseCase();
+    const media = args.mediaStorage
+        ? {
+            storage: args.mediaStorage,
+            createUpload: new CreateMediaUploadUseCase(args.mediaStorage, args.kv, clock, siteConfig, { allowSvg: args.mediaAllowSvg ?? false, maxBytes: args.mediaMaxBytes }),
+            commitUpload: new CommitMediaUploadUseCase(args.mediaStorage, args.kv, clock, { maxBytes: args.mediaMaxBytes }),
+        }
+        : null;
+    return {
+        db: args.db,
+        kv: args.kv,
+        assets: args.assets,
+        createDraft,
+        updateDraft,
+        getEntry,
+        listEntries,
+        requestPublish,
+        unpublish,
+        archive,
+        deleteEntry,
+        invokeProcedure,
+        executeView,
+        composeLlmsTxt,
+        composeSitemap,
+        composeEntrySeoMeta,
+        renderEntryLive,
+        renderListLive,
+        previewEntry,
+        validateBoot,
+        publishOrchestrator,
+        siteConfig,
+        publicPathResolver,
+        media,
+        runDeferredHook,
+        registry,
+        templates,
+        schemasByName,
+        proceduresByName,
+        viewsByName,
+        triggers: partitioned.triggers,
+        triggersByName,
+        clock,
+        idgen,
+        async bootInit() {
+            await args.db.migrations.runAll(CANONICAL_MIGRATIONS);
+            await siteConfig.seed(args.siteDefaults);
+            const siteLocales = await siteConfig.readLocales();
+            validateBoot.assert({
+                manifests: args.manifests,
+                registry,
+                siteLocales,
+            });
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/usecase/boot/ValidateBootUseCase.d.ts

@@ -0,0 +1,57 @@
+import { type Diagnostic, type Manifest } from "@aotter/mantle-spec";
+import type { HandlerRegistry } from "../../domain/port/HandlerRegistry.js";
+/**
+ * `ValidateBootUseCase` — Loop 3 of the SDK authoring contract (see
+ * ADR-0007). Walks the parsed manifest set + in-memory handler
+ * registry; refuses to proceed if any load-bearing invariant is
+ * violated. Per ADR-0007: "process exit non-zero, do not serve" — a
+ * missing handler ref must surface as a deploy failure, not a runtime
+ * 500 to a customer.
+ *
+ * In Cloudflare Workers context "process exit" maps to: throw at
+ * runtime module-init so `wrangler tail` reports the init error and
+ * subsequent requests get the runtime's generic 500 (instead of
+ * unevaluated handlers being exercised).
+ *
+ * v0.1.0 invariants:
+ *   - Every `Procedure.handler.ref` is in the supplied registry.
+ *   - Every `Procedure.handler.builtin.schema` resolves to a declared
+ *     Schema (`BUILTIN_HANDLER_SCHEMA_UNKNOWN`). Builtin op execution
+ *     itself ships in `InvokeBuiltinUseCase`.
+ *   - Every `Trigger.target.procedure` resolves to a manifest.
+ *   - Every `http` Trigger has a unique `(method, path)` pair and a
+ *     `/api/` prefix.
+ *   - Every `Trigger.source.kind: lifecycle` watches a declared Schema
+ *     (`LIFECYCLE_SCHEMA_UNKNOWN`). The hook runtime is the
+ *     `LifecycleHookingEntryRepository` decorator.
+ *   - Locale + translates cross-Schema invariants (ADR-0010) hold.
+ */
+export type ValidateBootResponse = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly diagnostics: readonly Diagnostic[];
+};
+export interface ValidateBootRequest {
+    readonly manifests: readonly Manifest[];
+    readonly registry: HandlerRegistry;
+    /** Site config locales (ADR-0010). Empty/absent enables the
+     *  zero-locale-site path: any localized Schema fails boot with
+     *  `SCHEMA_LOCALIZED_REQUIRES_SITE_LOCALES`. The runtime's
+     *  bootInit reads this from `site_config` before validating. */
+    readonly siteLocales?: readonly string[];
+}
+export declare class ValidateBootUseCase {
+    execute(request: ValidateBootRequest): ValidateBootResponse;
+    /** Validate; on failure, throw `BootValidationError`. */
+    assert(request: ValidateBootRequest): void;
+}
+/**
+ * Single Error wrapping every boot diagnostic. The runtime throws this
+ * during `bootInit`; adapters surface it in their init logs.
+ */
+export declare class BootValidationError extends Error {
+    readonly diagnostics: readonly Diagnostic[];
+    constructor(diagnostics: readonly Diagnostic[]);
+}
+//# sourceMappingURL=ValidateBootUseCase.d.ts.map

package/dist/usecase/boot/ValidateBootUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateBootUseCase.d.ts","sourceRoot":"","sources":["../../../src/usecase/boot/ValidateBootUseCase.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,QAAQ,EAId,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAG5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC;;;oEAGgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB;IAkG3D,yDAAyD;IACzD,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;CAI3C;AA+ED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAChB,WAAW,EAAE,SAAS,UAAU,EAAE;gBAAlC,WAAW,EAAE,SAAS,UAAU,EAAE;CAW/D"}

package/dist/usecase/boot/ValidateBootUseCase.js

@@ -0,0 +1,181 @@
+import { bootDiagnostic, partitionManifests, checkLocaleAndTranslates, } from "@aotter/mantle-spec";
+import { mcpToolNameSegment } from "../../domain/service/McpToolNaming.js";
+export class ValidateBootUseCase {
+    execute(request) {
+        const partitioned = partitionManifests([...request.manifests]);
+        const proceduresByName = new Map();
+        for (const p of partitioned.procedures)
+            proceduresByName.set(p.metadata.name, p);
+        const schemasByName = new Map();
+        for (const s of partitioned.schemas)
+            schemasByName.set(s.metadata.name, s);
+        const diagnostics = [];
+        const procedureCandidates = [...proceduresByName.keys()];
+        const schemaCandidates = [...schemasByName.keys()];
+        const handlerCandidates = request.registry.list();
+        // 1. Procedure handler refs + builtin schema cross-resolution.
+        for (const p of partitioned.procedures) {
+            const h = p.spec.handler;
+            if (h.kind === "ref" && !request.registry.has(h.ref)) {
+                diagnostics.push(bootDiagnostic({
+                    code: "HANDLER_NOT_REGISTERED",
+                    severity: "error",
+                    path: `manifest:Procedure/${p.metadata.name}#/spec/handler/ref`,
+                    value: h.ref,
+                    expected: `a function registered via the handlers option / sdk.registerHandler('${h.ref}', fn)`,
+                    candidates: handlerCandidates,
+                    message: `Procedure '${p.metadata.name}' declares handler.ref '${h.ref}' but no handler is registered for that key. Wire it in your project's handlers map: { '${h.ref}': ... }.`,
+                }));
+            }
+            if (h.kind === "builtin" && !schemasByName.has(h.schema)) {
+                diagnostics.push(bootDiagnostic({
+                    code: "BUILTIN_HANDLER_SCHEMA_UNKNOWN",
+                    severity: "error",
+                    path: `manifest:Procedure/${p.metadata.name}#/spec/handler/schema`,
+                    value: h.schema,
+                    expected: "name of a declared Schema",
+                    candidates: schemaCandidates,
+                    message: `Procedure '${p.metadata.name}' (handler.kind: builtin) targets unknown Schema '${h.schema}'.`,
+                }));
+            }
+        }
+        // 2. Trigger.target.procedure resolves.
+        for (const t of partitioned.triggers) {
+            if (!proceduresByName.has(t.spec.target.procedure)) {
+                diagnostics.push(bootDiagnostic({
+                    code: "TRIGGER_TARGET_PROCEDURE_UNKNOWN",
+                    severity: "error",
+                    path: `manifest:Trigger/${t.metadata.name}#/spec/target/procedure`,
+                    value: t.spec.target.procedure,
+                    expected: "name of a declared Procedure",
+                    candidates: procedureCandidates,
+                    message: `Trigger '${t.metadata.name}' targets unknown Procedure '${t.spec.target.procedure}'.`,
+                }));
+            }
+            if (t.spec.source.kind === "lifecycle") {
+                if (!schemasByName.has(t.spec.source.schema)) {
+                    diagnostics.push(bootDiagnostic({
+                        code: "LIFECYCLE_SCHEMA_UNKNOWN",
+                        severity: "error",
+                        path: `manifest:Trigger/${t.metadata.name}#/spec/source/schema`,
+                        value: t.spec.source.schema,
+                        expected: "name of a declared Schema",
+                        candidates: schemaCandidates,
+                        message: `Trigger '${t.metadata.name}' watches unknown Schema '${t.spec.source.schema}'.`,
+                    }));
+                }
+            }
+        }
+        // 3. HTTP trigger uniqueness + /api/ prefix.
+        diagnostics.push(...checkHttpRouteCollisions(partitioned.triggers));
+        diagnostics.push(...checkHttpRoutePrefix(partitioned.triggers));
+        // 4. MCP tool-name collision (POC PR #48): per-collection tool
+        //    emission lowercases + kebab→snake the Schema name; two
+        //    Schemas that mangle to the same suffix would silently
+        //    overwrite each other in `tools/list`.
+        diagnostics.push(...checkMcpToolNameCollisions(partitioned.schemas));
+        // 5. Locale + translates cross-Schema invariants.
+        diagnostics.push(...checkLocaleAndTranslates({
+            schemas: partitioned.schemas,
+            phase: "boot",
+            siteLocales: request.siteLocales,
+        }));
+        if (diagnostics.length === 0)
+            return { ok: true };
+        return { ok: false, diagnostics };
+    }
+    /** Validate; on failure, throw `BootValidationError`. */
+    assert(request) {
+        const result = this.execute(request);
+        if (!result.ok)
+            throw new BootValidationError(result.diagnostics);
+    }
+}
+function checkHttpRouteCollisions(triggers) {
+    const seen = new Map();
+    const out = [];
+    for (const t of triggers) {
+        if (t.spec.source.kind !== "http")
+            continue;
+        const key = `${t.spec.source.method} ${t.spec.source.path}`;
+        const prior = seen.get(key);
+        if (prior) {
+            out.push(bootDiagnostic({
+                code: "TRIGGER_PATH_COLLISION",
+                severity: "error",
+                path: `manifest:Trigger/${t.metadata.name}#/spec/source`,
+                value: key,
+                expected: `unique (method, path) across http Triggers (also declared by '${prior}')`,
+                message: `Trigger '${t.metadata.name}' shares route ${key} with Trigger '${prior}'.`,
+            }));
+        }
+        else {
+            seen.set(key, t.metadata.name);
+        }
+    }
+    return out;
+}
+function checkHttpRoutePrefix(triggers) {
+    const out = [];
+    for (const t of triggers) {
+        if (t.spec.source.kind !== "http")
+            continue;
+        const path = t.spec.source.path;
+        if (!path.startsWith("/api/")) {
+            out.push(bootDiagnostic({
+                code: "TRIGGER_PATH_INVALID",
+                severity: "error",
+                path: `manifest:Trigger/${t.metadata.name}#/spec/source/path`,
+                value: path,
+                expected: "path starting with '/api/'",
+                message: `Trigger '${t.metadata.name}' has path '${path}' — http Trigger ` +
+                    `paths MUST start with '/api/' so adapters can route public ` +
+                    `pages and Procedure endpoints without ambiguity.`,
+            }));
+        }
+    }
+    return out;
+}
+function checkMcpToolNameCollisions(schemas) {
+    const seen = new Map();
+    const out = [];
+    for (const s of schemas) {
+        const segment = mcpToolNameSegment(s.metadata.name);
+        const prior = seen.get(segment);
+        if (prior && prior !== s.metadata.name) {
+            out.push(bootDiagnostic({
+                code: "MCP_TOOL_NAME_COLLISION",
+                severity: "error",
+                path: `manifest:Schema/${s.metadata.name}#/metadata/name`,
+                value: segment,
+                expected: `Schema name unique after kebab→snake mangling (collides with '${prior}')`,
+                message: `Schema '${s.metadata.name}' mangles to MCP tool suffix '${segment}', ` +
+                    `which already comes from Schema '${prior}'. Rename one of the Schemas ` +
+                    `(e.g. avoid mixing '${prior}' and '${s.metadata.name}') so per-collection ` +
+                    `MCP tool emission stays unambiguous.`,
+            }));
+        }
+        else if (!prior) {
+            seen.set(segment, s.metadata.name);
+        }
+    }
+    return out;
+}
+/**
+ * Single Error wrapping every boot diagnostic. The runtime throws this
+ * during `bootInit`; adapters surface it in their init logs.
+ */
+export class BootValidationError extends Error {
+    diagnostics;
+    constructor(diagnostics) {
+        const summary = diagnostics
+            .map((d) => `  - ${d.code} (phase: ${d.phase}) at ${d.path}: ${d.message}`)
+            .join("\n");
+        super(`Runtime boot validation failed (${diagnostics.length} error(s)):\n${summary}\n\n` +
+            `See ADR-0007 (boot-time fail-fast) for context. Diagnostics also ` +
+            `available on the .diagnostics field of this error for programmatic handling.`);
+        this.diagnostics = diagnostics;
+        this.name = "BootValidationError";
+    }
+}
+//# sourceMappingURL=ValidateBootUseCase.js.map

package/dist/usecase/boot/ValidateBootUseCase.js.map

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

package/dist/usecase/boot/index.d.ts

@@ -0,0 +1,2 @@
+export { ValidateBootUseCase, BootValidationError, type ValidateBootRequest, type ValidateBootResponse, } from "./ValidateBootUseCase.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/usecase/boot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/usecase/boot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC"}

package/dist/usecase/boot/index.js

@@ -0,0 +1,2 @@
+export { ValidateBootUseCase, BootValidationError, } from "./ValidateBootUseCase.js";
+//# sourceMappingURL=index.js.map

package/dist/usecase/boot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usecase/boot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC"}

package/dist/usecase/content/ArchiveUseCase.d.ts

@@ -0,0 +1,20 @@
+import { type SchemaManifest } from "@aotter/mantle-spec";
+import type { EntryRow } from "../../domain/model/EntryRow.js";
+import type { Clock } from "../../domain/port/Clock.js";
+import type { EntryRepository } from "../../domain/port/EntryRepository.js";
+import type { ArchiveRequest } from "../dto/content/index.js";
+import { type ContentPublishEffects } from "./ContentPublishEffects.js";
+/**
+ * `ArchiveUseCase` — flip an entry to `'archived'`. Per the simple-
+ * lifecycle state machine, draft and published rows can both be
+ * archived; archived rows go back to draft via `Unpublish`.
+ */
+export declare class ArchiveUseCase {
+    private readonly entries;
+    private readonly schemas;
+    private readonly clock;
+    private readonly effects?;
+    constructor(entries: EntryRepository, schemas: ReadonlyMap<string, SchemaManifest>, clock: Clock, effects?: ContentPublishEffects | undefined);
+    execute(request: ArchiveRequest): Promise<EntryRow>;
+}
+//# sourceMappingURL=ArchiveUseCase.d.ts.map

package/dist/usecase/content/ArchiveUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchiveUseCase.d.ts","sourceRoot":"","sources":["../../../src/usecase/content/ArchiveUseCase.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AAOpC;;;;GAIG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAHR,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5C,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,qBAAqB,YAAA;IAG5C,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;CA8B1D"}

package/dist/usecase/content/ArchiveUseCase.js

@@ -0,0 +1,47 @@
+import { canTransition, DiagnosticError, } from "@aotter/mantle-spec";
+import { unpublishCache, } from "./ContentPublishEffects.js";
+import { illegalTransitionDiagnostic, notFoundDiagnostic, withConflictDiagnostic, } from "./diagnostics.js";
+/**
+ * `ArchiveUseCase` — flip an entry to `'archived'`. Per the simple-
+ * lifecycle state machine, draft and published rows can both be
+ * archived; archived rows go back to draft via `Unpublish`.
+ */
+export class ArchiveUseCase {
+    entries;
+    schemas;
+    clock;
+    effects;
+    constructor(entries, schemas, clock, effects) {
+        this.entries = entries;
+        this.schemas = schemas;
+        this.clock = clock;
+        this.effects = effects;
+    }
+    async execute(request) {
+        const opPath = `usecase/Archive/${request.id}`;
+        const existing = await this.entries.get(request.id);
+        if (!existing) {
+            throw new DiagnosticError(notFoundDiagnostic(opPath, "<unknown>", request.id));
+        }
+        const schema = this.schemas.get(existing.collection);
+        if (!canTransition(schema, existing.status, "archived")) {
+            throw new DiagnosticError(illegalTransitionDiagnostic(opPath, existing.status, "archived"));
+        }
+        // Pin OCC to the version we just fetched so the guard above
+        // (canTransition against existing.status) and the chokepoint
+        // assertion see the same snapshot. Caller-supplied
+        // request.expectedVersion is deprecated — kept on the DTO for
+        // backwards compat but no longer load-bearing.
+        const archived = await withConflictDiagnostic(opPath, () => this.entries.archive({
+            id: request.id,
+            collection: existing.collection,
+            expectedVersion: existing.version,
+            now: this.clock.now(),
+            hookContext: request.ctx,
+            originalInput: request.originalInput,
+        }));
+        await unpublishCache(this.effects, archived.id);
+        return archived;
+    }
+}
+//# sourceMappingURL=ArchiveUseCase.js.map