@gradial/aci 0.1.52 → 0.1.53-canary.693

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## Unreleased
+
+### Changed
+
+- Immutable code builds (`ACI_CODE_ARTIFACT_BUILD=1`) no longer read or compile
+  authored error-page content. Native client error seats use the shipped
+  default; publish resolves authored CDN error pages independently. Error
+  analytics policy is emitted as a separate code-owned instrumentation artifact
+  at the existing `.aci/compiled/error-pages/instrumentation.json` path so
+  SDK-first upgrades preserve custom analytics on deployed builders.
+
 ## 0.1.52
 
 ### Changed

package/README.md

@@ -1,6 +1,6 @@
 # Agentic Content Infrastructure SDK
 
-`@gradial/aci` `0.1.52` is a pre-1.0 public-surface reset for the ACI
+`@gradial/aci` `0.1.53-canary.693` is a pre-1.0 public-surface reset for the ACI
 client SDK. Breaking changes from the old `0.1.x` accidental surface are
 intentional: the root import is framework-neutral, framework runtime behavior is
 behind explicit subpaths, and the first required customer path is React/Next.
@@ -8,7 +8,7 @@ behind explicit subpaths, and the first required customer path is React/Next.
 ## Install
 
 ```bash
-npm install @gradial/aci@0.1.52 zod@^4
+npm install @gradial/aci@0.1.53-canary.693 zod@^4
 ```
 
 ## Root Import
@@ -137,13 +137,13 @@ host bundles select and serve immutable release artifacts.
 The first RC scaffold path is Next:
 
 ```bash
-npx @gradial/aci@0.1.52 init my-site --template next-starter
+npx @gradial/aci@0.1.53-canary.693 init my-site --template next-starter
 ```
 
 List available templates:
 
 ```bash
-npx @gradial/aci@0.1.52 init --list
+npx @gradial/aci@0.1.53-canary.693 init --list
 ```
 
 ## Personalization: The One-Tag Install

package/dist/cli/emit-error-pages.d.mts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+export function prepareCodeArtifact(root: string | undefined, content: any): Promise<string>;
 /**
  * D-15 policy resolution for the 500.html instrumentation tag (page_type
  * "error"; self-contained inline delivery — this copy is a real static
@@ -17,9 +18,9 @@ export function resolveInstrumentationTag(root: string | undefined, content: any
 /**
  * D-16 prepare-phase artifact: serializes BOTH kinds' instrumentation tags
  * (tenant module when present, SDK default otherwise) into
- * error-pages/instrumentation.json under the compiled content root. The
- * AWS-lane code capsule packs source/.aci/compiled/**, so the Go publish
- * materializer reads this file from the capsule and stamps the kind-matching
+ * error-pages/instrumentation.json under the selected transport root. Code
+ * builds retain .aci/compiled/error-pages/instrumentation.json so deployed
+ * builders retain it and the Go publish materializer stamps the kind-matching
  * tag into the CDN error artifacts — the tag crosses the JS→Go boundary as
  * data. Serialization failures (bind/method-shorthand exports, FIND-006)
  * throw before anything is written.

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

@@ -3,6 +3,10 @@
 // specs/features/authorable-error-pages, T3/T11; REQ-10/REQ-11/REQ-14, D-9,
 // D-16).
 //
+// ACI_CODE_ARTIFACT_BUILD=1 makes both phases content-independent: prepare
+// serializes only the code-owned policy at its existing .aci/compiled path.
+// Emit uses the shipped default without resolving authored error-page bindings.
+//
 // Two phases. The Next template wires both around `next build`; the Astro
 // template runs only `prepare` before `astro build` (its 404/500 seats
 // render through the framework, but the D-16 instrumentation artifact must
@@ -16,8 +20,8 @@
 //     leaves the shipped default in play (REQ-4, warn posture). Then writes
 //     error-pages/instrumentation.json (both kinds' serialized tags) into
 //     the compiled content root so the tag crosses the JS→Go boundary as
-//     data: the AWS-lane code capsule packs source/.aci/compiled/** and the
-//     Go publish materializer stamps the kind-matching tag into the CDN
+//     data: builders retain the instrumentation file at its existing capsule
+//     path, and the Go publish materializer stamps the kind-matching tag into the CDN
 //     error artifacts (D-16). An unserializable tenant push fails the build
 //     loudly here (delta FIND-006).
 //
@@ -84,7 +88,18 @@ function hasCompiledContent() {
 // ---------------------------------------------------------------------------
 // prepare
 // ---------------------------------------------------------------------------
+// Retain the deployed transport path for SDK-first upgrades. This file is
+// executable policy, not a compiled page snapshot; do not compile content here.
+export async function prepareCodeArtifact(root = siteRoot, content) {
+    return writeInstrumentationArtifact(root, content, path.join(root, '.aci', 'compiled'));
+}
 async function prepare() {
+    if (process.env.ACI_CODE_ARTIFACT_BUILD === '1') {
+        // Code artifacts carry executable policy only. The selected content and
+        // its error-page bindings belong to preview/publish, never this build.
+        await prepareCodeArtifact();
+        return;
+    }
     if (hasCompiledContent()) {
         log(`compiled content present at ${contentRoot}`);
     }
@@ -292,9 +307,9 @@ async function resolveInstrumentationPush(root = siteRoot) {
 /**
  * D-16 prepare-phase artifact: serializes BOTH kinds' instrumentation tags
  * (tenant module when present, SDK default otherwise) into
- * error-pages/instrumentation.json under the compiled content root. The
- * AWS-lane code capsule packs source/.aci/compiled/**, so the Go publish
- * materializer reads this file from the capsule and stamps the kind-matching
+ * error-pages/instrumentation.json under the selected transport root. Code
+ * builds retain .aci/compiled/error-pages/instrumentation.json so deployed
+ * builders retain it and the Go publish materializer stamps the kind-matching
  * tag into the CDN error artifacts — the tag crosses the JS→Go boundary as
  * data. Serialization failures (bind/method-shorthand exports, FIND-006)
  * throw before anything is written.
@@ -353,7 +368,9 @@ async function emit() {
         log('public/500.html already provided by the site; leaving it untouched (skip-if-present)');
         return;
     }
-    const { route, defaultHtml } = await resolveCatchAllRoute();
+    const { route, defaultHtml } = process.env.ACI_CODE_ARTIFACT_BUILD === '1'
+        ? { route: null, defaultHtml: (await sdkContent()).defaultErrorPageHtml() }
+        : await resolveCatchAllRoute();
     let instrumentationTag;
     try {
         instrumentationTag = await resolveInstrumentationTag();

package/dist/next/config.js

@@ -3,6 +3,7 @@ import { join, relative } from 'path';
 import { createRequire } from 'module';
 import { createContentWatchWebpackPlugin } from './content-watch.js';
 import { buildErrorSeatPayload } from './error-seat-payload.js';
+import { defaultErrorPageFragmentHtml } from '../content/default-error-page.js';
 const require = createRequire(import.meta.url);
 export function withAci(nextConfig = {}, options = {}) {
     if (process.env.TURBOPACK) {
@@ -20,7 +21,11 @@ export function withAci(nextConfig = {}, options = {}) {
     // serialization failures warn and serialize the shipped default (REQ-4);
     // under enforce they fail the build closed, and unknown posture values
     // fail closed too. Present-but-broken bindings fail closed always (REQ-5).
-    const errorSeat = buildErrorSeatPayload(undefined, process.env.ACI_ERROR_PAGES_POSTURE);
+    // A code artifact is independent of every content snapshot. Authored error
+    // bindings are validated when previewing/publishing the selected content.
+    const errorSeat = process.env.ACI_CODE_ARTIFACT_BUILD === '1'
+        ? { payload: { defaulted: true, defaultHtml: defaultErrorPageFragmentHtml() }, warnings: [], errors: [] }
+        : buildErrorSeatPayload(undefined, process.env.ACI_ERROR_PAGES_POSTURE);
     if (errorSeat.errors.length > 0) {
         throw new Error(`ACI errorPages bindings are invalid (site.json#errorPages):\n- ${errorSeat.errors.join('\n- ')}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.52",
+  "version": "0.1.53-canary.693",
   "repository": {
     "type": "git",
     "url": "https://github.com/gradial/bare-metal-go.git",
@@ -160,11 +160,11 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.52",
-    "@gradial/aci-cli-darwin-x64": "0.1.52",
-    "@gradial/aci-cli-linux-arm64": "0.1.52",
-    "@gradial/aci-cli-linux-x64": "0.1.52",
-    "@gradial/aci-cli-win32-arm64": "0.1.52",
-    "@gradial/aci-cli-win32-x64": "0.1.52"
+    "@gradial/aci-cli-darwin-arm64": "0.1.53-canary.693",
+    "@gradial/aci-cli-darwin-x64": "0.1.53-canary.693",
+    "@gradial/aci-cli-linux-arm64": "0.1.53-canary.693",
+    "@gradial/aci-cli-linux-x64": "0.1.53-canary.693",
+    "@gradial/aci-cli-win32-arm64": "0.1.53-canary.693",
+    "@gradial/aci-cli-win32-x64": "0.1.53-canary.693"
   }
 }

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

@@ -3,6 +3,10 @@
 // specs/features/authorable-error-pages, T3/T11; REQ-10/REQ-11/REQ-14, D-9,
 // D-16).
 //
+// ACI_CODE_ARTIFACT_BUILD=1 makes both phases content-independent: prepare
+// serializes only the code-owned policy at its existing .aci/compiled path.
+// Emit uses the shipped default without resolving authored error-page bindings.
+//
 // Two phases. The Next template wires both around `next build`; the Astro
 // template runs only `prepare` before `astro build` (its 404/500 seats
 // render through the framework, but the D-16 instrumentation artifact must
@@ -16,8 +20,8 @@
 //     leaves the shipped default in play (REQ-4, warn posture). Then writes
 //     error-pages/instrumentation.json (both kinds' serialized tags) into
 //     the compiled content root so the tag crosses the JS→Go boundary as
-//     data: the AWS-lane code capsule packs source/.aci/compiled/** and the
-//     Go publish materializer stamps the kind-matching tag into the CDN
+//     data: builders retain the instrumentation file at its existing capsule
+//     path, and the Go publish materializer stamps the kind-matching tag into the CDN
 //     error artifacts (D-16). An unserializable tenant push fails the build
 //     loudly here (delta FIND-006).
 //
@@ -92,7 +96,19 @@ function hasCompiledContent() {
 // prepare
 // ---------------------------------------------------------------------------
 
+// Retain the deployed transport path for SDK-first upgrades. This file is
+// executable policy, not a compiled page snapshot; do not compile content here.
+export async function prepareCodeArtifact(root = siteRoot, content) {
+  return writeInstrumentationArtifact(root, content, path.join(root, '.aci', 'compiled'));
+}
+
 async function prepare() {
+  if (process.env.ACI_CODE_ARTIFACT_BUILD === '1') {
+    // Code artifacts carry executable policy only. The selected content and
+    // its error-page bindings belong to preview/publish, never this build.
+    await prepareCodeArtifact();
+    return;
+  }
   if (hasCompiledContent()) {
     log(`compiled content present at ${contentRoot}`);
   } else {
@@ -308,9 +324,9 @@ async function resolveInstrumentationPush(root = siteRoot) {
 /**
  * D-16 prepare-phase artifact: serializes BOTH kinds' instrumentation tags
  * (tenant module when present, SDK default otherwise) into
- * error-pages/instrumentation.json under the compiled content root. The
- * AWS-lane code capsule packs source/.aci/compiled/**, so the Go publish
- * materializer reads this file from the capsule and stamps the kind-matching
+ * error-pages/instrumentation.json under the selected transport root. Code
+ * builds retain .aci/compiled/error-pages/instrumentation.json so deployed
+ * builders retain it and the Go publish materializer stamps the kind-matching
  * tag into the CDN error artifacts — the tag crosses the JS→Go boundary as
  * data. Serialization failures (bind/method-shorthand exports, FIND-006)
  * throw before anything is written.
@@ -375,7 +391,9 @@ async function emit() {
     return;
   }
 
-  const { route, defaultHtml } = await resolveCatchAllRoute();
+  const { route, defaultHtml } = process.env.ACI_CODE_ARTIFACT_BUILD === '1'
+    ? { route: null, defaultHtml: (await sdkContent()).defaultErrorPageHtml() }
+    : await resolveCatchAllRoute();
   let instrumentationTag;
   try {
     instrumentationTag = await resolveInstrumentationTag();