@gradial/aci 0.1.53-rc.3 → 0.1.53-rc.4

package/CHANGELOG.md

@@ -4,6 +4,9 @@
 
 ### Added
 
+- Public `aci schemas compile` and `aci error-pages prepare|emit` commands let
+  site build scripts compile code-owned artifacts without invoking SDK internals.
+
 - `AciRootProps` (the new name of `RootIdentityProps`, which stays as an
   alias) and `aciRootAttrs(props)`, exported from `@gradial/aci`.
 - The `rootIdentity` check covers every file that calls `createRegistry(`,

package/README.md

@@ -1,6 +1,6 @@
 # Agentic Content Infrastructure SDK
 
-`@gradial/aci` `0.1.53-rc.3` is a pre-1.0 public-surface reset for the ACI
+`@gradial/aci` `0.1.53-rc.4` 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.53-rc.3 zod@^4
+npm install @gradial/aci@0.1.53-rc.4 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.53-rc.3 init my-site --template next-starter
+npx @gradial/aci@0.1.53-rc.4 init my-site --template next-starter
 ```
 
 List available templates:
 
 ```bash
-npx @gradial/aci@0.1.53-rc.3 init --list
+npx @gradial/aci@0.1.53-rc.4 init --list
 ```
 
 ## Personalization: The One-Tag Install
@@ -223,3 +223,25 @@ From `packages/sdk`:
 pnpm run build
 pnpm run generate-starters
 ```
+
+## Public code-build commands
+
+Use the installed `aci` binary from npm scripts, not files beneath the package's
+`src`, `dist`, or `bin` directories:
+
+```json
+{
+  "scripts": {
+    "schemas:compile": "aci schemas compile",
+    "prebuild": "npm run schemas:compile",
+    "build": "aci error-pages prepare && next build && aci error-pages emit",
+    "content:compile": "npm run schemas:compile && aci content compile --content ./.content --out ./.aci/compiled"
+  }
+}
+```
+
+`schemas compile` reads the component/data registry paths from `.aci.yaml` and
+recompiles contracts without reading authored content. The error commands prepare
+code-owned analytics policy and emit the default hosting fallback (preserving a
+site-owned `public/500.html`). All three honor `--site-dir`; helper failures exit
+nonzero. Local development/content validation must explicitly compile content.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.53-rc.3",
+  "version": "0.1.53-rc.4",
   "repository": {
     "type": "git",
     "url": "https://github.com/gradial/bare-metal-go.git",
@@ -164,11 +164,11 @@
     "astro": "^6.4.8"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.53-rc.3",
-    "@gradial/aci-cli-darwin-x64": "0.1.53-rc.3",
-    "@gradial/aci-cli-linux-arm64": "0.1.53-rc.3",
-    "@gradial/aci-cli-linux-x64": "0.1.53-rc.3",
-    "@gradial/aci-cli-win32-arm64": "0.1.53-rc.3",
-    "@gradial/aci-cli-win32-x64": "0.1.53-rc.3"
+    "@gradial/aci-cli-darwin-arm64": "0.1.53-rc.4",
+    "@gradial/aci-cli-darwin-x64": "0.1.53-rc.4",
+    "@gradial/aci-cli-linux-arm64": "0.1.53-rc.4",
+    "@gradial/aci-cli-linux-x64": "0.1.53-rc.4",
+    "@gradial/aci-cli-win32-arm64": "0.1.53-rc.4",
+    "@gradial/aci-cli-win32-x64": "0.1.53-rc.4"
   }
 }

package/templates/astro/template/package.json.tmpl

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "astro dev --host 0.0.0.0",
-    "build": "node ./node_modules/@gradial/aci/src/cli/emit-error-pages.mjs prepare && astro build",
+    "build": "aci error-pages prepare && astro build",
     "preview": "ACI_CONTENT_ROOT=./.aci/compiled astro preview --host 0.0.0.0",
     "typecheck": "ACI_CONTENT_ROOT=./.aci/compiled astro check --tsconfig ./tsconfig.json",
     "test": "node --import tsx --test tests/**/*.test.ts",

package/templates/nextjs/template/package.json.tmpl

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "ACI_CONTENT_PROVIDER=file next dev -H 0.0.0.0",
-    "build": "node ./node_modules/@gradial/aci/src/cli/emit-error-pages.mjs prepare && next build && node ./node_modules/@gradial/aci/src/cli/emit-error-pages.mjs emit",
+    "build": "aci error-pages prepare && next build && aci error-pages emit",
     "preview": "next start -H 0.0.0.0",
     "typecheck": "tsc --noEmit",
     "test": "node --import tsx --test tests/**/*.test.ts",