@gradial/aci 0.1.50 → 0.1.51-ssr.3

package/dist/testing/conformance/checks.js

@@ -230,8 +230,8 @@ export function checkPageEntry(ctx) {
     const hasForceDynamic = normalized.includes("dynamic = 'force-dynamic'") ||
         normalized.includes('dynamic = "force-dynamic"');
     results.push(hasForceDynamic
-        ? ok('pageEntry', 'page exports force-dynamic', rel)
-        : fail('pageEntry', 'page exports force-dynamic', rel + ' should export const dynamic = "force-dynamic"'));
+        ? ok('pageEntry', 'page exports force-dynamic for compiler snapshots', rel)
+        : fail('pageEntry', 'page exports force-dynamic for compiler snapshots', rel + ' should export const dynamic = "force-dynamic"'));
     const hasGenerateStaticParams = pageFile.content.includes('generateStaticParams');
     results.push(!hasGenerateStaticParams
         ? ok('pageEntry', 'page does not use generateStaticParams', rel)
@@ -239,7 +239,7 @@ export function checkPageEntry(ctx) {
     return results;
 }
 // ---------------------------------------------------------------------------
-// Check: middleware — presence and siteId (Next)
+// Check: middleware — provider-owned EdgeRouter exclusivity (Next)
 // ---------------------------------------------------------------------------
 export function checkMiddleware(ctx) {
     const results = [];
@@ -252,135 +252,11 @@ export function checkMiddleware(ctx) {
         'middleware.ts',
         'middleware.js',
     ]);
-    if (!middlewareFile) {
-        results.push(fail('middleware', 'next middleware.ts exists', 'expected src/middleware.ts or middleware.ts'));
-        return results;
-    }
-    const rel = relative(ctx.rootDir, middlewareFile.path);
-    results.push(ok('middleware', 'next middleware.ts exists', rel));
-    const usesSDKMiddleware = middlewareFile.content.includes('createGradialMiddleware') ||
-        middlewareFile.content.includes('@gradial/aci/next/middleware');
-    results.push(usesSDKMiddleware
-        ? ok('middleware', 'middleware uses createGradialMiddleware', rel)
-        : fail('middleware', 'middleware uses createGradialMiddleware', rel + ' should use createGradialMiddleware from @gradial/aci/next/middleware'));
-    // Middleware must NOT pass a siteId — the SDK reads process.env.ACI_SITE_ID
-    // internally. Any siteId arg is stale config that should be removed.
-    {
-        const label = 'middleware does not pass siteId';
-        const callIdx = middlewareFile.content.indexOf('createGradialMiddleware(');
-        const region = callIdx >= 0 ? middlewareFile.content.slice(callIdx) : middlewareFile.content;
-        const passesSiteId = /siteId\s*:/.test(region);
-        results.push(!passesSiteId
-            ? ok('middleware', label, rel)
-            : fail('middleware', label, `${rel}: remove siteId from createGradialMiddleware() — the SDK reads process.env.ACI_SITE_ID internally; the platform injects it per deployment`));
-    }
-    // Check that the middleware matcher is inlined (not imported) and matches
-    // the SDK's canonical value. Next.js requires config.matcher to be
-    // statically analyzable, so importing the matcher from the SDK breaks the
-    // build. Instead the template inlines the value and this check detects drift.
-    const canonicalMatcher = String.raw `[
-    '/((?!_next(?:/|$)|api(?:/|$)|collect(?:/|$)|gradial/assets(?:/|$)|favicon\\.ico$).*)',
-    {
-      source: '/:path*',
-      has: [{ type: 'header', key: 'x-gradial-framework-origin-auth' }],
-    },
-    {
-      source: '/:path*',
-      has: [{ type: 'header', key: 'x-baremetal-site-id' }],
-    },
-    {
-      source: '/:path*',
-      has: [{ type: 'header', key: 'x-baremetal-release-id' }],
-    },
-    {
-      source: '/:path*',
-      has: [{ type: 'header', key: 'x-aci-content-ref' }],
-    },
-    {
-      source: '/:path*',
-      has: [{ type: 'header', key: 'x-baremetal-content-base-url' }],
-    },
-    {
-      source: '/:path*',
-      has: [{ type: 'header', key: 'x-aci-content-path' }],
-    },
-    {
-      source: '/:path*',
-      has: [{ type: 'header', key: 'x-aci-routed-path' }],
-    },
-    {
-      source: '/:path*',
-      has: [{ type: 'header', key: 'x-aci-variant-key' }],
-    },
-    {
-      source: '/:path*',
-      has: [{ type: 'query', key: '__aci_content_path' }],
-    },
-  ]`;
-    // Check for actual import/usage of aciMiddlewareMatcher (not just a mention
-    // in a comment). Look for `matcher: aciMiddlewareMatcher` or
-    // `import { ... aciMiddlewareMatcher ... }`.
-    const hasImportedMatcher = /matcher\s*:\s*aciMiddlewareMatcher/.test(middlewareFile.content) ||
-        /import\s+.*aciMiddlewareMatcher.*from/.test(middlewareFile.content);
-    if (hasImportedMatcher) {
-        results.push(fail('middleware', 'middleware matcher is inlined (not imported)', rel + ' should inline the matcher value for Next.js static analysis; see @gradial/aci/next/middleware for the canonical value'));
-    }
-    else {
-        // Verify the inlined value matches the SDK canonical
-        const matcherLiteral = extractArrayPropertyLiteral(middlewareFile.content, 'matcher');
-        if (matcherLiteral) {
-            const normalizedInlined = matcherLiteral.replace(/\s+/g, '');
-            const normalizedCanonical = canonicalMatcher.replace(/\s+/g, '');
-            results.push(normalizedInlined === normalizedCanonical
-                ? ok('middleware', 'middleware matcher matches SDK canonical', rel)
-                : fail('middleware', 'middleware matcher matches SDK canonical', `${rel}: inlined matcher does not match SDK's aciMiddlewareMatcher; expected ${canonicalMatcher}`));
-        }
-        else {
-            results.push(fail('middleware', 'middleware matcher is defined', rel + ' should define config.matcher'));
-        }
+    if (middlewareFile) {
+        const rel = relative(ctx.rootDir, middlewareFile.path);
+        return [fail('middleware', 'customer middleware is absent', `${rel} conflicts with the provider-owned ACI EdgeRouter; remove it`)];
     }
-    return results;
-}
-function extractArrayPropertyLiteral(content, propertyName) {
-    const property = new RegExp(`\\b${propertyName}\\s*:`).exec(content);
-    if (!property)
-        return null;
-    const start = content.indexOf('[', property.index + property[0].length);
-    if (start < 0)
-        return null;
-    let depth = 0;
-    let quote = '';
-    let escaped = false;
-    for (let index = start; index < content.length; index += 1) {
-        const character = content[index];
-        if (quote) {
-            if (escaped) {
-                escaped = false;
-            }
-            else if (character === '\\') {
-                escaped = true;
-            }
-            else if (character === quote) {
-                quote = '';
-            }
-            continue;
-        }
-        if (character === "'" || character === '"' || character === '`') {
-            quote = character;
-            continue;
-        }
-        if (character === '[') {
-            depth += 1;
-            continue;
-        }
-        if (character === ']') {
-            depth -= 1;
-            if (depth === 0) {
-                return content.slice(start, index + 1);
-            }
-        }
-    }
-    return null;
+    return [ok('middleware', 'customer middleware is absent', 'routing is owned by the hosting provider ACI EdgeRouter')];
 }
 // ---------------------------------------------------------------------------
 // Check: noFileContentProvider — no direct FileContentProvider imports in app code
@@ -449,9 +325,9 @@ export function checkNoCustomContent(ctx) {
     return results;
 }
 // ---------------------------------------------------------------------------
-// Check: noLegacyAssetRoute — no legacy asset route pattern
+// Check: noRequestTimeAssetRoute — asset delivery is host-owned
 // ---------------------------------------------------------------------------
-export function checkNoLegacyAssetRoute(ctx) {
+export function checkNoRequestTimeAssetRoute(ctx) {
     const results = [];
     if (ctx.framework !== 'next') {
         return results;
@@ -459,35 +335,21 @@ export function checkNoLegacyAssetRoute(ctx) {
     const appRoot = existsSync(join(ctx.rootDir, 'src', 'app'))
         ? join(ctx.rootDir, 'src', 'app')
         : join(ctx.rootDir, 'app');
-    // The legacy pattern uses [releaseId] segment; the canonical pattern uses just [...path]
-    const legacyRoute = findFirstExisting(appRoot, [
+    const requestTimeAssetRoute = findFirstExisting(appRoot, [
         'gradial/assets/[releaseId]/[...path]/route.ts',
         'gradial/assets/[releaseId]/[...path]/route.tsx',
         'gradial/assets/[releaseId]/[...path]/route.js',
         'gradial/assets/[releaseId]/[...path]/route.jsx',
-    ]);
-    if (legacyRoute) {
-        results.push(fail('noLegacyAssetRoute', 'no legacy asset route with [releaseId] segment', 'found legacy route at ' + relative(ctx.rootDir, legacyRoute.path) + '; use gradial/assets/[...path]/route.ts instead'));
-    }
-    else {
-        results.push(ok('noLegacyAssetRoute', 'no legacy asset route with [releaseId] segment'));
-    }
-    // Verify the canonical asset route exists
-    const canonicalRoute = findFirstExisting(appRoot, [
         'gradial/assets/[...path]/route.ts',
         'gradial/assets/[...path]/route.tsx',
         'gradial/assets/[...path]/route.js',
         'gradial/assets/[...path]/route.jsx',
     ]);
-    if (canonicalRoute) {
-        results.push(ok('noLegacyAssetRoute', 'canonical asset route exists', relative(ctx.rootDir, canonicalRoute.path)));
-        const usesSDKHandler = canonicalRoute.content.includes('@gradial/aci/next/asset-route');
-        results.push(usesSDKHandler
-            ? ok('noLegacyAssetRoute', 'asset route uses SDK handler', relative(ctx.rootDir, canonicalRoute.path))
-            : fail('noLegacyAssetRoute', 'asset route uses SDK handler', relative(ctx.rootDir, canonicalRoute.path) + ' should import from @gradial/aci/next/asset-route'));
+    if (requestTimeAssetRoute) {
+        results.push(fail('noRequestTimeAssetRoute', 'no Next request-time asset route', 'found retired asset route at ' + relative(ctx.rootDir, requestTimeAssetRoute.path) + '; host gateways serve immutable assets directly'));
     }
     else {
-        results.push(fail('noLegacyAssetRoute', 'canonical asset route exists', 'expected gradial/assets/[...path]/route.ts'));
+        results.push(ok('noRequestTimeAssetRoute', 'no Next request-time asset route'));
     }
     return results;
 }
@@ -579,7 +441,7 @@ export const CHECK_REGISTRY = {
     middleware: checkMiddleware,
     noFileContentProvider: checkNoFileContentProvider,
     noCustomContent: checkNoCustomContent,
-    noLegacyAssetRoute: checkNoLegacyAssetRoute,
+    noRequestTimeAssetRoute: checkNoRequestTimeAssetRoute,
     buildSucceeds: checkBuildSucceeds,
     contentCompile: checkContentCompile,
     sdkVersion: checkSdkVersion,

package/dist/testing/conformance/index.d.ts

@@ -1,3 +1,3 @@
 export { conformancePreset, runConformanceChecks } from './preset.js';
-export { checkConfig, checkRegistry, checkPageEntry, checkMiddleware, checkNoFileContentProvider, checkNoCustomContent, checkNoLegacyAssetRoute, checkBuildSucceeds, checkContentCompile, checkSdkVersion, CHECK_REGISTRY, } from './checks.js';
+export { checkConfig, checkRegistry, checkPageEntry, checkMiddleware, checkNoFileContentProvider, checkNoCustomContent, checkNoRequestTimeAssetRoute, checkBuildSucceeds, checkContentCompile, checkSdkVersion, CHECK_REGISTRY, } from './checks.js';
 export type { ConformanceFramework, ConformanceCheckName, ConformancePresetOptions, ConformanceCheckResult, ConformanceResult, ConformanceContext, ConformanceCheckFn, } from './types.js';

package/dist/testing/conformance/index.js

@@ -1,2 +1,2 @@
 export { conformancePreset, runConformanceChecks } from './preset.js';
-export { checkConfig, checkRegistry, checkPageEntry, checkMiddleware, checkNoFileContentProvider, checkNoCustomContent, checkNoLegacyAssetRoute, checkBuildSucceeds, checkContentCompile, checkSdkVersion, CHECK_REGISTRY, } from './checks.js';
+export { checkConfig, checkRegistry, checkPageEntry, checkMiddleware, checkNoFileContentProvider, checkNoCustomContent, checkNoRequestTimeAssetRoute, checkBuildSucceeds, checkContentCompile, checkSdkVersion, CHECK_REGISTRY, } from './checks.js';

package/dist/testing/conformance/preset.js

@@ -27,7 +27,7 @@ const ALL_CHECKS = [
     'middleware',
     'noFileContentProvider',
     'noCustomContent',
-    'noLegacyAssetRoute',
+    'noRequestTimeAssetRoute',
     'sdkVersion',
     // Expensive checks last — these shell out
     'contentCompile',

package/dist/testing/conformance/types.d.ts

@@ -7,7 +7,7 @@
 /** Supported framework identifiers. */
 export type ConformanceFramework = 'next' | 'astro';
 /** Individual check names that can be enabled/disabled. */
-export type ConformanceCheckName = 'config' | 'registry' | 'pageEntry' | 'middleware' | 'noFileContentProvider' | 'noCustomContent' | 'noLegacyAssetRoute' | 'buildSucceeds' | 'contentCompile' | 'sdkVersion';
+export type ConformanceCheckName = 'config' | 'registry' | 'pageEntry' | 'middleware' | 'noFileContentProvider' | 'noCustomContent' | 'noRequestTimeAssetRoute' | 'buildSucceeds' | 'contentCompile' | 'sdkVersion';
 /**
  * Options for the conformance preset.
  *

package/dist/types/config.d.ts

@@ -1,4 +1,3 @@
-import type { RenderCapabilities } from './renderer.js';
 export interface Config {
     version: '1';
     siteId: string;
@@ -11,15 +10,12 @@ export interface Config {
     componentRegistry: string;
     dataRegistry?: string;
     layoutRegistry: string;
-    capabilities: RenderCapabilities;
     routes: RouteConfig;
     dam?: DAMConfig;
     externalDependencies?: ExternalDependency[];
-    rendererProtocol: 'http' | 'stdio-json';
 }
 export interface RouteConfig {
     cmsManaged: string;
-    frameworkOwned?: string[];
 }
 export interface ExternalDependency {
     name: string;

package/dist/types/index.d.ts

@@ -4,8 +4,6 @@ export * from './data.js';
 export * from './layout.js';
 export * from './page.js';
 export * from './rich-text.js';
-export * from './renderer.js';
-export * from './render-mode.js';
 export * from './image.js';
 export * from './video.js';
 export * from './media.js';

package/dist/types/index.js

@@ -4,8 +4,6 @@ export * from './data.js';
 export * from './layout.js';
 export * from './page.js';
 export * from './rich-text.js';
-export * from './renderer.js';
-export * from './render-mode.js';
 export * from './image.js';
 export * from './video.js';
 export * from './media.js';

package/dist/types/page.d.ts

@@ -1,4 +1,3 @@
-import type { VaryDimension } from './render-mode.js';
 import type { TaxonomyAssignments } from './data.js';
 export interface PageDocument {
     path: string;
@@ -29,15 +28,6 @@ export interface BlockNode {
     id: string;
     component: string;
     props: Record<string, unknown>;
-    renderHints: BlockRenderHints;
-    contentPath?: string;
-}
-export interface BlockRenderHints {
-    canStatic: boolean;
-    needsSSR: boolean;
-    isIsland: boolean;
-    islandMode?: 'ssr' | 'client';
-    varyDimensions?: VaryDimension[];
 }
 export interface FragmentRefNode {
     kind: 'fragment-ref';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.50",
+  "version": "0.1.51-ssr.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/gradial/bare-metal-go.git",
@@ -45,9 +45,9 @@
       "types": "./dist/providers/file.d.ts",
       "import": "./dist/providers/file.js"
     },
-    "./providers/s3": {
-      "types": "./dist/providers/s3.d.ts",
-      "import": "./dist/providers/s3.js"
+    "./providers/object": {
+      "types": "./dist/providers/object.d.ts",
+      "import": "./dist/providers/object.js"
     },
     "./dev": {
       "types": "./dist/dev/index.d.ts",
@@ -67,26 +67,6 @@
       "import": "./dist/next/config.js",
       "default": "./dist/next/config.js"
     },
-    "./next/middleware": {
-      "types": "./dist/next/middleware.d.ts",
-      "import": "./dist/next/middleware.js",
-      "default": "./dist/next/middleware.js"
-    },
-    "./next/vercel-personalization": {
-      "types": "./dist/next/vercel-personalization.d.ts",
-      "import": "./dist/next/vercel-personalization.js",
-      "default": "./dist/next/vercel-personalization.js"
-    },
-    "./next/vercel-collect-sdk-route": {
-      "types": "./dist/next/vercel-collect-sdk-route.d.ts",
-      "import": "./dist/next/vercel-collect-sdk-route.js",
-      "default": "./dist/next/vercel-collect-sdk-route.js"
-    },
-    "./next/asset-route": {
-      "types": "./dist/next/asset-route.d.ts",
-      "import": "./dist/next/asset-route.js",
-      "default": "./dist/next/asset-route.js"
-    },
     "./next/dev-refresh": {
       "types": "./dist/next/dev-refresh.d.ts",
       "import": "./dist/next/dev-refresh.js"
@@ -119,7 +99,7 @@
     }
   },
   "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json && node scripts/assert-render-proof-public-surface.mjs && node scripts/build-collect.mjs",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json && node scripts/assemble-dist.mjs && node scripts/build-collect.mjs",
     "test": "node --import tsx --test \"src/**/*.test.ts\" \"src/**/*.test.tsx\"",
     "build:collect": "node scripts/build-collect.mjs",
     "generate-default-error-page": "node scripts/generate-default-error-page.mjs",
@@ -136,16 +116,12 @@
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "@vercel/edge-config": "^1.4.3",
     "next": "^15.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "zod": "^4.0.0"
   },
   "peerDependenciesMeta": {
-    "@vercel/edge-config": {
-      "optional": true
-    },
     "next": {
       "optional": true
     },
@@ -170,11 +146,11 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.50",
-    "@gradial/aci-cli-darwin-x64": "0.1.50",
-    "@gradial/aci-cli-linux-arm64": "0.1.50",
-    "@gradial/aci-cli-linux-x64": "0.1.50",
-    "@gradial/aci-cli-win32-arm64": "0.1.50",
-    "@gradial/aci-cli-win32-x64": "0.1.50"
+    "@gradial/aci-cli-darwin-arm64": "0.1.51-ssr.3",
+    "@gradial/aci-cli-darwin-x64": "0.1.51-ssr.3",
+    "@gradial/aci-cli-linux-arm64": "0.1.51-ssr.3",
+    "@gradial/aci-cli-linux-x64": "0.1.51-ssr.3",
+    "@gradial/aci-cli-win32-arm64": "0.1.51-ssr.3",
+    "@gradial/aci-cli-win32-x64": "0.1.51-ssr.3"
   }
 }

package/src/cli/emit-error-pages.mjs

@@ -363,7 +363,6 @@ function postProcess(html, instrumentationTag) {
   // data-aci-assignments tag (REQ-11) in one sweep.
   out = out.replace(/<script\b[\s\S]*?<\/script>/gi, '');
   out = out.replace(/<link\b[^>]*rel="(?:preload|modulepreload|prefetch)"[^>]*>/gi, '');
-  out = out.replace(/<meta\b[^>]*name="aci-render-proof"[^>]*>/gi, '');
   out = inlineStylesheets(out);
   return stampInstrumentation(out, instrumentationTag);
 }

package/src/cli/verify-next-cdn-routes.mjs

@@ -31,12 +31,10 @@ function checkMissing(label, relativePath, message) {
   checks.push(`✓ ${label}`);
 }
 
-checkFile(
-  'middleware is configured',
+checkMissing(
+  'customer middleware is absent',
   'src/middleware.ts',
-  (content) => (content.includes('@gradial/aci/next/middleware') || content.includes('createGradialMiddleware'))
-    && !content.includes('|__r'),
-  'Expected src/middleware.ts to use @gradial/aci/next/middleware and not exclude __r; middleware blocks direct /__r requests.',
+  'The hosting provider injects the ACI EdgeRouter as the sole routing middleware.',
 );
 
 checkFile(
@@ -52,17 +50,16 @@ checkMissing(
   'Use src/app/[[...slug]]/page.tsx (optional catch-all). The required [...slug] form breaks file-provider local dev where "/" arrives with an empty slug.',
 );
 
-checkFile(
-  'canonical asset route exists',
+checkMissing(
+  'request-time asset route is removed',
   'src/app/gradial/assets/[...path]/route.ts',
-  (content) => content.includes('@gradial/aci/next/asset-route'),
-  'Expected the canonical asset route to use @gradial/aci/next/asset-route.',
+  'Host gateways serve immutable assets directly; do not proxy them through Next.',
 );
 
 checkMissing(
-  'legacy release-scoped asset route is removed',
+  'release-scoped request-time asset route is removed',
   'src/app/gradial/assets/[releaseId]/[...path]/route.ts',
-  'Release-scoped asset URLs are produced by withAci() rewrites into the canonical src/app/gradial/assets/[...path]/route.ts; do not add a [releaseId] route.',
+  'Host gateways serve immutable assets directly; do not add a release-scoped Next asset route.',
 );
 
 checkMissing(

package/src/types/config.ts

@@ -1,5 +1,3 @@
-import type { RenderCapabilities } from './renderer.js';
-
 export interface Config {
   version: '1';
   siteId: string;
@@ -12,16 +10,13 @@ export interface Config {
   componentRegistry: string;
   dataRegistry?: string;
   layoutRegistry: string;
-  capabilities: RenderCapabilities;
   routes: RouteConfig;
   dam?: DAMConfig;
   externalDependencies?: ExternalDependency[];
-  rendererProtocol: 'http' | 'stdio-json';
 }
 
 export interface RouteConfig {
   cmsManaged: string;
-  frameworkOwned?: string[];
 }
 
 export interface ExternalDependency {

package/src/types/index.ts

@@ -4,8 +4,6 @@ export * from './data.js';
 export * from './layout.js';
 export * from './page.js';
 export * from './rich-text.js';
-export * from './renderer.js';
-export * from './render-mode.js';
 export * from './image.js';
 export * from './video.js';
 export * from './media.js';

package/src/types/page.ts

@@ -1,4 +1,3 @@
-import type { VaryDimension } from './render-mode.js';
 import type { TaxonomyAssignments } from './data.js';
 
 export interface PageDocument {
@@ -30,16 +29,6 @@ export interface BlockNode {
   id: string;
   component: string;
   props: Record<string, unknown>;
-  renderHints: BlockRenderHints;
-  contentPath?: string;
-}
-
-export interface BlockRenderHints {
-  canStatic: boolean;
-  needsSSR: boolean;
-  isIsland: boolean;
-  islandMode?: 'ssr' | 'client';
-  varyDimensions?: VaryDimension[];
 }
 
 export interface FragmentRefNode {

package/templates/astro/template/.aci.yaml.tmpl

@@ -11,18 +11,7 @@ source:
 componentRegistry: ./src/cms/contracts/components/index.ts
 layoutRegistry: ./src/cms/contracts/layouts/index.ts
 
-capabilities:
-  staticRender: true
-  ssr: true
-  ssrIslands: true
-  clientIslands: true
-  fragmentRender: true
-
 routes:
   cmsManaged: "/[...slug]"
-  frameworkOwned:
-    - "/api/*"
-    - "/_astro/*"
-    - "/storybook/*"
 
 rendererProtocol: stdio-json

package/templates/common/.agents/skills/aci/SKILL.md

@@ -12,7 +12,7 @@ description: Onboarding, running builds, validating, and troubleshooting ACI sit
 # Astro is standard for new customer sites
 aci init my-site --template astro-starter
 
-# Next.js is for specific SSR properties
+# Next.js is for sites that need its framework/build ecosystem
 aci init my-site --template next-starter
 
 # With demo content, components, and stories
@@ -65,12 +65,11 @@ Each framework uses a packaged SDK adapter for ACI dev/build behavior:
 - **Astro**: `withAci()` in `astro.config.mjs`
 - **Next.js**: `withAci()` in `next.config.ts`
 
-These adapters own canonical ACI behavior: content watch/reload, local DAM
-derivative serving at `/.gradial-dam/*`, asset path rewrites, output mode,
-outputFileTracingRoot, base-path/build-mode/dist-dir env injection, CDN
-headers, and content-watch plugin. Repos should pass an empty `withAci()`
-call and rely on SDK defaults. Use `passthroughRoutes` only for
-site-specific non-CMS routes.
+These adapters own canonical local-dev and publish-time behavior: content
+watch/reload, local DAM derivative paths, optional direct asset-origin rewrites,
+standalone output, error-page payloads, and framework build integration. Repos
+should pass an empty `withAci()` call and rely on SDK defaults. Hosted CMS
+routing and immutable artifact delivery remain outside the framework.
 
 Only Next.js and Astro are supported. SvelteKit support has been removed.
 
@@ -140,10 +139,10 @@ Default checks validate:
 - `config` -- `withAci()` present in config
 - `registry` -- `createRegistry()` usage (no hand-rolled maps)
 - `pageEntry` -- `createPage(registry)` usage in catch-all route
-- `middleware` -- `createGradialMiddleware({ siteId })` with correct siteId
+- `middleware` -- no customer middleware implementing a second CMS decision path
 - `noFileContentProvider` -- no direct `FileContentProvider` imports in app code
 - `noCustomContent` -- no `src/lib/content.ts` shim
-- `noLegacyAssetRoute` -- no `[releaseId]` segment in asset route path
+- `noRequestTimeAssetRoute` -- no Next asset-delivery route; host gateways own immutable assets
 - `sdkVersion` -- SDK version compatibility
 
 Optional (disabled by default):

package/templates/common/.agents/skills/authoring/SKILL.md

@@ -702,10 +702,9 @@ files list.
 ## Deep Dive: SDK Server Functions
 
 Read `references/sdk-server-functions.md` for `@gradial/aci/next`
-server-side functions (`createPage`, `getSiteConfig`, `getFragment`,
-etc.), the three-tier content resolution chain, and the critical rule
-against importing `FileContentProvider` or `S3ContentProvider`
-directly in app code.
+server-side functions (`createPage`, `getSiteConfig`, `getFragment`, etc.), the
+compiler-input/local-file build boundary, and the rule against constructing
+content providers directly in app code.
 
 ## Deep Dive: Block Slots