@gradial/aci 0.1.39 → 0.1.41

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 0.1.41 - 2026-07-22
+
+### Fixed
+
+- First published release to actually ship the layout-default preservation and
+  validation fix in the CLI binary. Earlier binaries (through 0.1.39) predated
+  the fix, and the 0.1.40 meta package pinned platform CLI packages that were
+  never published, leaving its `aci` command unresolvable. The publish process
+  now stamps one release version into the SDK, all six platform packages, and
+  the README in lockstep, and gates publishing on registry verification of
+  every platform package.
+
+After upgrading, delete any `.aci/compiled` directory produced by an older
+compiler and rerun `aci content compile`. Existing compiled output is derived
+state and is not repaired in place.
+
+## 0.1.34 - 2026-07-20
+
+### Fixed
+
+- Preserve layout-default fragment references during `aci content compile`, so
+  shared site chrome such as navigation and footers is not silently omitted.
+- Reject malformed or dangling layout-default fragment references before local
+  compilation or managed publishing can produce or stage invalid artifacts.
+
+After upgrading, delete any `.aci/compiled` directory produced by an older
+compiler and rerun `aci content compile`. Existing compiled output is derived
+state and is not repaired in place.

package/README.md

@@ -1,6 +1,6 @@
 # Agentic Content Infrastructure SDK
 
-`@gradial/aci` `0.1.33` is a pre-1.0 public-surface reset for the ACI
+`@gradial/aci` `0.1.41` 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.33 zod@^4
+npm install @gradial/aci@0.1.41 zod@^4
 ```
 
 ## Root Import
@@ -85,13 +85,13 @@ go through an app-owned HTTP endpoint backed server-side by a `ContentProvider`.
 The first RC scaffold path is Next:
 
 ```bash
-npx @gradial/aci@0.1.33 init my-site --template next-starter
+npx @gradial/aci@0.1.41 init my-site --template next-starter
 ```
 
 List available templates:
 
 ```bash
-npx @gradial/aci@0.1.33 init --list
+npx @gradial/aci@0.1.41 init --list
 ```
 
 ## Personalization: The One-Tag Install

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,7 @@
     "templates/common",
     "templates/nextjs",
     "templates/astro",
+    "CHANGELOG.md",
     "README.md"
   ],
   "bin": {
@@ -127,12 +128,12 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "@gradial/aci-cli-darwin-arm64": "0.1.39",
-    "@gradial/aci-cli-darwin-x64": "0.1.39",
-    "@gradial/aci-cli-linux-arm64": "0.1.39",
-    "@gradial/aci-cli-linux-x64": "0.1.39",
-    "@gradial/aci-cli-win32-arm64": "0.1.39",
-    "@gradial/aci-cli-win32-x64": "0.1.39"
+    "@gradial/aci-cli-darwin-arm64": "0.1.41",
+    "@gradial/aci-cli-darwin-x64": "0.1.41",
+    "@gradial/aci-cli-linux-arm64": "0.1.41",
+    "@gradial/aci-cli-linux-x64": "0.1.41",
+    "@gradial/aci-cli-win32-arm64": "0.1.41",
+    "@gradial/aci-cli-win32-x64": "0.1.41"
   },
   "scripts": {
     "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",

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

@@ -0,0 +1,28 @@
+version: "1"
+siteId: "site_astro"
+domain: "meridian.local"
+framework: astro
+
+source:
+  root: "./"
+  outDir: "dist"
+  publicDir: "public"
+
+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/.content/config/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Allow: /

package/templates/common/.content/config/site.json

@@ -0,0 +1,197 @@
+{
+  "$type": "site",
+  "id": "meridian",
+  "status": "published",
+  "title": "Meridian",
+  "domain": "www.meridian.local",
+  "defaultLocale": "en-us",
+  "locales": ["en-us"],
+  "overlayResolution": ["locale", "audience"],
+  "brandHref": "/",
+  "brandLogo": {
+    "src": "/assets/meridian-logo.svg",
+    "alt": "Meridian"
+  },
+  "seo": {
+    "title": "Meridian",
+    "description": "Global satellite internet from anywhere on Earth.",
+    "siteName": "Meridian"
+  },
+  "personalization": {
+    "collect": true,
+    "consentPreset": "c15t",
+    "consentCategories": "measurement,marketing"
+  },
+  "navigation": [
+    {
+      "id": "home",
+      "label": "Home",
+      "href": "/"
+    },
+    {
+      "id": "plans",
+      "label": "Plans",
+      "href": "/plans/"
+    },
+    {
+      "id": "devices",
+      "label": "Devices",
+      "href": "/devices/"
+    },
+    {
+      "id": "business",
+      "label": "Business",
+      "href": "/business/"
+    },
+    {
+      "id": "blog",
+      "label": "Blog",
+      "href": "/blog/"
+    },
+    {
+      "id": "about",
+      "label": "About",
+      "href": "/about/"
+    }
+  ],
+  "utilities": [
+    {
+      "id": "sign-in",
+      "label": "Sign in",
+      "href": "/sign-in/",
+      "variant": "ghost"
+    },
+    {
+      "id": "contact-sales",
+      "label": "Contact sales",
+      "href": "/contact-sales/",
+      "variant": "primary"
+    }
+  ],
+  "footer": {
+    "columns": [
+      {
+        "id": "products",
+        "title": "Products",
+        "links": [
+          {
+            "id": "plans",
+            "label": "Plans",
+            "href": "/plans/"
+          },
+          {
+            "id": "devices",
+            "label": "Devices",
+            "href": "/devices/"
+          },
+          {
+            "id": "coverage",
+            "label": "Coverage",
+            "href": "/coverage/"
+          }
+        ]
+      },
+      {
+        "id": "solutions",
+        "title": "Solutions",
+        "links": [
+          {
+            "id": "business",
+            "label": "Business",
+            "href": "/business/"
+          },
+          {
+            "id": "maritime",
+            "label": "Maritime",
+            "href": "/business/maritime/"
+          },
+          {
+            "id": "aerospace",
+            "label": "Aerospace",
+            "href": "/business/aerospace/"
+          }
+        ]
+      },
+      {
+        "id": "resources",
+        "title": "Resources",
+        "links": [
+          {
+            "id": "blog",
+            "label": "Blog",
+            "href": "/blog/"
+          },
+          {
+            "id": "documentation",
+            "label": "Documentation",
+            "href": "/docs/"
+          },
+          {
+            "id": "support",
+            "label": "Support",
+            "href": "/support/"
+          }
+        ]
+      },
+      {
+        "id": "company",
+        "title": "Company",
+        "links": [
+          {
+            "id": "about",
+            "label": "About us",
+            "href": "/about/"
+          },
+          {
+            "id": "careers",
+            "label": "Careers",
+            "href": "/careers/"
+          },
+          {
+            "id": "contact",
+            "label": "Contact",
+            "href": "/contact/"
+          }
+        ]
+      }
+    ],
+    "social": [
+      {
+        "id": "x",
+        "label": "X",
+        "href": "https://x.com/meridian",
+        "icon": "X"
+      },
+      {
+        "id": "linkedin",
+        "label": "LinkedIn",
+        "href": "https://www.linkedin.com/company/meridian",
+        "icon": "in"
+      },
+      {
+        "id": "youtube",
+        "label": "YouTube",
+        "href": "https://www.youtube.com/meridian",
+        "icon": "YT"
+      }
+    ],
+    "legalLinks": [
+      {
+        "id": "terms",
+        "label": "Terms of Service",
+        "href": "/terms/"
+      },
+      {
+        "id": "privacy",
+        "label": "Privacy Policy",
+        "href": "/privacy/"
+      },
+      {
+        "id": "security",
+        "label": "Security",
+        "href": "/security/"
+      }
+    ],
+    "copyright": "Copyright (c) 2026 Meridian Satellite Networks, Inc. All rights reserved."
+  }
+}

package/templates/common/.content/dam/folders/seed/ast_site_about_hero/asset.json

@@ -0,0 +1,9 @@
+{
+  "$type": "dam.asset",
+  "schemaVersion": 1,
+  "assetId": "ast_site_about_hero",
+  "createdAt": "2026-06-01T00:00:00Z",
+  "createdBy": "local-seed",
+  "updatedAt": "2026-06-01T00:00:00Z",
+  "updatedBy": "local-seed"
+}

package/templates/common/.content/dam/folders/seed/ast_site_about_hero/editorial.json

@@ -0,0 +1,14 @@
+{
+  "$type": "dam.editorial",
+  "schemaVersion": 1,
+  "title": "Meridian about hero",
+  "description": "Seeded hero image for the Meridian about page.",
+  "altText": "Satellite ground station at twilight",
+  "tags": ["meridian", "hero", "ground-station", "satellite"],
+  "properties": {
+    "source": "unsplash",
+    "sourceUrl": "https://images.unsplash.com/photo-1516849841032-87cbac4d88f7?w=1920&q=80"
+  },
+  "customFields": {},
+  "notes": "Downloaded for the local DAM bridge harness."
+}

package/templates/common/.content/dam/folders/seed/ast_site_about_hero/governance.json

@@ -0,0 +1,23 @@
+{
+  "$type": "dam.governance",
+  "schemaVersion": 1,
+  "asset": {
+    "status": "active",
+    "legalHold": false,
+    "retention": {
+      "policy": "local-seed"
+    },
+    "publicationRestriction": "none"
+  },
+  "versions": {
+    "v0001": {
+      "status": "approved",
+      "approvedAt": "2026-06-01T00:00:00Z",
+      "approvedBy": "local-seed",
+      "license": {
+        "kind": "unsplash-local-fixture"
+      },
+      "publicationRestriction": "none"
+    }
+  }
+}

package/templates/common/.content/dam/folders/seed/ast_site_about_hero/versions/v0001.json

@@ -0,0 +1,37 @@
+{
+  "$type": "dam.assetVersion",
+  "schemaVersion": 1,
+  "versionId": "v0001",
+  "blob": {
+    "sha256": "fb3260e8286ea8231ea1c77b9c0be92d6edd9026565731eb14cfdcfd6b1b75b3",
+    "key": ".gradial-dam/blobs/sha256/fb/32/fb3260e8286ea8231ea1c77b9c0be92d6edd9026565731eb14cfdcfd6b1b75b3",
+    "byteSize": 14255,
+    "mime": "image/jpeg",
+    "originalFilename": "about-hero.jpg",
+    "checksumSource": "server-computed"
+  },
+  "technical": {
+    "dimensions": {
+      "width": 1200,
+      "height": 600
+    },
+    "duration": null,
+    "exif": {},
+    "iptc": {},
+    "xmp": {},
+    "video": null,
+    "audio": null,
+    "document": null,
+    "analysis": {
+      "saliency": null,
+      "faces": [],
+      "objects": [],
+      "segments": [],
+      "textRegions": [],
+      "logoRegions": [],
+      "safeAreas": []
+    }
+  },
+  "createdAt": "2026-06-01T00:00:00Z",
+  "createdBy": "local-seed"
+}

package/templates/common/.content/dam/folders/seed/ast_site_home_hero/asset.json

@@ -0,0 +1,9 @@
+{
+  "$type": "dam.asset",
+  "schemaVersion": 1,
+  "assetId": "ast_site_home_hero",
+  "createdAt": "2026-06-01T00:00:00Z",
+  "createdBy": "local-seed",
+  "updatedAt": "2026-06-01T00:00:00Z",
+  "updatedBy": "local-seed"
+}

package/templates/common/.content/dam/folders/seed/ast_site_home_hero/editorial.json

@@ -0,0 +1,14 @@
+{
+  "$type": "dam.editorial",
+  "schemaVersion": 1,
+  "title": "Meridian home hero",
+  "description": "Seeded hero image for the Meridian home page.",
+  "altText": "Earth from space with satellite constellation",
+  "tags": ["meridian", "hero", "space", "earth"],
+  "properties": {
+    "source": "unsplash",
+    "sourceUrl": "https://images.unsplash.com/photo-1451187580459-43490279c0fa?w=1920&q=80"
+  },
+  "customFields": {},
+  "notes": "Downloaded for the local DAM bridge harness."
+}

package/templates/common/.content/dam/folders/seed/ast_site_home_hero/governance.json

@@ -0,0 +1,23 @@
+{
+  "$type": "dam.governance",
+  "schemaVersion": 1,
+  "asset": {
+    "status": "active",
+    "legalHold": false,
+    "retention": {
+      "policy": "local-seed"
+    },
+    "publicationRestriction": "none"
+  },
+  "versions": {
+    "v0001": {
+      "status": "approved",
+      "approvedAt": "2026-06-01T00:00:00Z",
+      "approvedBy": "local-seed",
+      "license": {
+        "kind": "unsplash-local-fixture"
+      },
+      "publicationRestriction": "none"
+    }
+  }
+}

package/templates/common/.content/dam/folders/seed/ast_site_home_hero/versions/v0001.json

@@ -0,0 +1,37 @@
+{
+  "$type": "dam.assetVersion",
+  "schemaVersion": 1,
+  "versionId": "v0001",
+  "blob": {
+    "sha256": "a0f506689de9b15a7055f70103a3f02cd3ba105771ae2de6754df2ede1210d3a",
+    "key": ".gradial-dam/blobs/sha256/a0/f5/a0f506689de9b15a7055f70103a3f02cd3ba105771ae2de6754df2ede1210d3a",
+    "byteSize": 15601,
+    "mime": "image/jpeg",
+    "originalFilename": "home-hero.jpg",
+    "checksumSource": "server-computed"
+  },
+  "technical": {
+    "dimensions": {
+      "width": 1200,
+      "height": 600
+    },
+    "duration": null,
+    "exif": {},
+    "iptc": {},
+    "xmp": {},
+    "video": null,
+    "audio": null,
+    "document": null,
+    "analysis": {
+      "saliency": null,
+      "faces": [],
+      "objects": [],
+      "segments": [],
+      "textRegions": [],
+      "logoRegions": [],
+      "safeAreas": []
+    }
+  },
+  "createdAt": "2026-06-01T00:00:00Z",
+  "createdBy": "local-seed"
+}

package/templates/common/.content/fragments/navbar/_index.json

@@ -0,0 +1,25 @@
+{
+  "$type": "fragment",
+  "fragmentId": "navbar",
+  "component": "site-navigation",
+  "props": {
+    "brandHref": "/",
+    "brandLabel": "Meridian",
+    "brandLogo": {
+      "src": "/assets/meridian-logo.svg",
+      "alt": "Meridian"
+    },
+    "navigation": [
+      { "id": "home", "label": "Home", "href": "/" },
+      { "id": "plans", "label": "Plans", "href": "/plans/" },
+      { "id": "devices", "label": "Devices", "href": "/devices/" },
+      { "id": "business", "label": "Business", "href": "/business/" },
+      { "id": "blog", "label": "Blog", "href": "/blog/" },
+      { "id": "about", "label": "About", "href": "/about/" }
+    ],
+    "utilities": [
+      { "id": "sign-in", "label": "Sign in", "href": "/sign-in/", "variant": "ghost" },
+      { "id": "contact-sales", "label": "Contact sales", "href": "/contact-sales/", "variant": "primary" }
+    ]
+  }
+}

package/templates/common/.content/fragments/site-footer/_index.json

@@ -0,0 +1,62 @@
+{
+  "$type": "fragment",
+  "fragmentId": "site-footer",
+  "component": "site-footer",
+  "props": {
+    "brandHref": "/",
+    "brandLabel": "Meridian",
+    "brandLogo": {
+      "src": "/assets/meridian-logo.svg",
+      "alt": "Meridian"
+    },
+    "columns": [
+      {
+        "id": "products",
+        "title": "Products",
+        "links": [
+          { "id": "plans", "label": "Plans", "href": "/plans/" },
+          { "id": "devices", "label": "Devices", "href": "/devices/" },
+          { "id": "coverage", "label": "Coverage", "href": "/coverage/" }
+        ]
+      },
+      {
+        "id": "solutions",
+        "title": "Solutions",
+        "links": [
+          { "id": "business", "label": "Business", "href": "/business/" },
+          { "id": "maritime", "label": "Maritime", "href": "/business/maritime/" },
+          { "id": "aerospace", "label": "Aerospace", "href": "/business/aerospace/" }
+        ]
+      },
+      {
+        "id": "resources",
+        "title": "Resources",
+        "links": [
+          { "id": "blog", "label": "Blog", "href": "/blog/" },
+          { "id": "documentation", "label": "Documentation", "href": "/docs/" },
+          { "id": "support", "label": "Support", "href": "/support/" }
+        ]
+      },
+      {
+        "id": "company",
+        "title": "Company",
+        "links": [
+          { "id": "about", "label": "About us", "href": "/about/" },
+          { "id": "careers", "label": "Careers", "href": "/careers/" },
+          { "id": "contact", "label": "Contact", "href": "/contact/" }
+        ]
+      }
+    ],
+    "social": [
+      { "id": "x", "label": "X", "href": "https://x.com/meridian", "icon": "X" },
+      { "id": "linkedin", "label": "LinkedIn", "href": "https://www.linkedin.com/company/meridian", "icon": "in" },
+      { "id": "youtube", "label": "YouTube", "href": "https://www.youtube.com/meridian", "icon": "YT" }
+    ],
+    "legalLinks": [
+      { "id": "terms", "label": "Terms of Service", "href": "/terms/" },
+      { "id": "privacy", "label": "Privacy Policy", "href": "/privacy/" },
+      { "id": "security", "label": "Security", "href": "/security/" }
+    ],
+    "copyright": "Copyright (c) 2026 Meridian Satellite Networks, Inc. All rights reserved."
+  }
+}

package/templates/common/.content/pages/about/_index.json

@@ -0,0 +1,51 @@
+{
+  "$type": "page",
+  "id": "meridian-about",
+  "status": "published",
+  "layout": "default",
+  "metadata": {
+    "title": "About Meridian",
+    "description": "Meridian is building the next generation of satellite internet to connect the unconnected.",
+    "canonical": "https://www.meridian.local/about"
+  },
+  "regions": {
+    "main": [
+      {
+        "id": "about-hero",
+        "component": "home_hero",
+        "props": {
+          "eyebrow": "About us",
+          "headline": "Connecting the edges of the world.",
+          "description": "Meridian designs, builds, and operates low-orbit satellites and ground terminals that bring reliable broadband to places traditional networks cannot reach.",
+          "ctaLabel": "Back to home",
+          "ctaHref": "/",
+          "image": {
+            "$type": "dam.assetRef",
+            "assetId": "ast_site_about_hero",
+            "alt": "Meridian network coverage map with soft gradient"
+          }
+        }
+      },
+      {
+        "id": "about-actions",
+        "component": "container",
+        "props": {
+          "className": "items-center justify-center text-center",
+          "content": [
+            {
+              "id": "home-link",
+              "component": "button",
+              "props": {
+                "label": "Return home",
+                "href": "/",
+                "variant": "primary",
+                "icon": "arrow_forward",
+                "iconPosition": "after"
+              }
+            }
+          ]
+        }
+      }
+    ]
+  }
+}

package/templates/nextjs/template/.aci.yaml

@@ -0,0 +1,26 @@
+version: "1"
+siteId: "site_nextjs"
+domain: "meridian.local"
+framework: next
+
+source:
+  root: "./"
+
+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/*"
+    - "/_next/*"
+    - "/.gradial-dam/*"
+
+rendererProtocol: stdio-json

package/templates/nextjs/template/src/middleware.ts

@@ -0,0 +1,7 @@
+import { createGradialMiddleware } from '@gradial/aci/next/middleware';
+
+export default createGradialMiddleware();
+
+export const config = {
+  matcher: ['/((?!_next(?:/|$)|api(?:/|$)|gradial/assets(?:/|$)|favicon\\.ico$).*)'],
+};