@inneranimalmedia/agentsam-sdk 2.6.4 → 2.6.7

package/packages/theme-floors-site/test/theme.test.mjs

@@ -2,10 +2,12 @@ import assert from 'node:assert/strict';
 import test from 'node:test';
 import { createTheme, createProductRow } from '../src/index.js';
 
-test('floors-site theme package exports installable contract', () => {
+test('floors-site theme package exports harvested (not installable) contract', () => {
   const theme = createTheme();
   assert.equal(theme.slug, "floors-site");
-  assert.equal(theme.installable, true);
+  assert.equal(theme.installable, false);
+  assert.equal(theme.lineage, "afm");
+  assert.equal(theme.family, "service-gallery");
   assert.equal(theme.package, "@inneranimalmedia/theme-floors-site");
   assert.ok(Array.isArray(theme.pages));
 });

package/packages/theme-fuelnfree-site/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "@inneranimalmedia/theme-fuelnfree-site",
-  "version": "0.1.0",
-  "description": "Real Fuel & Free Time legacy storefront pages \u2014 home, shop, about, and community.",
+  "name": "@inneranimalmedia/theme-ember",
+  "version": "2.6.7",
+  "description": "Real Fuel & Free Time legacy storefront pages — home, shop, about, and community.",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -25,7 +25,18 @@
     "kind": "theme",
     "slug": "fuelnfree-site",
     "galleryPath": "apps/theme-gallery-preview/themes/fuelnfree-site",
-    "installable": true,
-    "icon": "theme"
-  }
+    "installable": false,
+    "icon": "theme",
+    "lineage": "fnf",
+    "family": "editorial-commerce",
+    "normalization": "canonical_id_assigned",
+    "canonicalId": "ember",
+    "legacyPackageName": "@inneranimalmedia/theme-fuelnfree-site"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/theme-fuelnfree-site"
+  },
+  "private": true
 }

package/packages/theme-fuelnfree-site/src/harvest.json

@@ -2,12 +2,14 @@
   "harvest_batch": "theme-harvest-20260924",
   "app_path": "apps/fuelnfree-site",
   "harvest_path": "work/theme-harvest/fuelnfree-site",
-  "status": "scaffolded",
+  "status": "needs_normalization",
   "source_hash": "5ea35182b99816b9cb137a15f6ce7c361bfa932010759d3ac5bf74b1083895cf",
   "capabilities": [
     "cms.media",
     "cms.pages",
     "forms.leads",
     "theme.storefront.shell"
-  ]
+  ],
+  "lineage": "fnf",
+  "family": "editorial-commerce"
 }

package/packages/theme-fuelnfree-site/src/index.js

@@ -1,7 +1,9 @@
-/** Deterministic installable theme contract for AgentSam gallery/CMS. */
+/** Harvested donor-derived theme wrapper — not installable until remaster gates pass. */
 const THEME = {
   "id": "theme.fuelnfree-site",
   "slug": "fuelnfree-site",
+  "lineage": "fnf",
+  "family": "editorial-commerce",
   "displayName": "Fuel & Free Time",
   "version": "0.1.0",
   "kind": "gallery-theme",
@@ -38,7 +40,7 @@ const THEME = {
     "mobile": "/themes/fuelnfree-site/demo/",
     "demoUrl": "/themes/fuelnfree-site/demo/"
   },
-  "installable": true,
+  "installable": false,
   "galleryPath": "apps/theme-gallery-preview/themes/fuelnfree-site",
   "capabilityHints": [
     "theme.storefront.shell"
@@ -67,7 +69,9 @@ export function createProductRow({ accountId = null, repositoryId = null, status
     package_name: theme.package,
     metadata: {
       origin: "gallery_mount",
-      normalization_state: status === "production" ? "promoted" : "portable-preview",
+      normalization_state: status === "production" ? "promoted" : "needs_normalization",
+      lineage: theme.lineage,
+      family: theme.family,
       package: theme.package,
       gallery_path: theme.galleryPath,
       preview_kind: theme.preview?.kind || "static",

package/packages/theme-fuelnfree-site/test/theme.test.mjs

@@ -2,10 +2,12 @@ import assert from 'node:assert/strict';
 import test from 'node:test';
 import { createTheme, createProductRow } from '../src/index.js';
 
-test('fuelnfree-site theme package exports installable contract', () => {
+test('fuelnfree-site theme package exports harvested (not installable) contract', () => {
   const theme = createTheme();
   assert.equal(theme.slug, "fuelnfree-site");
-  assert.equal(theme.installable, true);
+  assert.equal(theme.installable, false);
+  assert.equal(theme.lineage, "fnf");
+  assert.equal(theme.family, "editorial-commerce");
   assert.equal(theme.package, "@inneranimalmedia/theme-fuelnfree-site");
   assert.ok(Array.isArray(theme.pages));
 });

package/packages/theme-handyman-site/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "@inneranimalmedia/theme-handyman-site",
-  "version": "0.1.0",
-  "description": "Real Primeaux Handyman PWA build \u2014 mobile-first service site with estimates and project proof.",
+  "name": "@inneranimalmedia/theme-forge",
+  "version": "2.6.7",
+  "description": "Real Primeaux Handyman PWA build — mobile-first service site with estimates and project proof.",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -25,7 +25,18 @@
     "kind": "theme",
     "slug": "handyman-site",
     "galleryPath": "apps/theme-gallery-preview/themes/handyman-site",
-    "installable": true,
-    "icon": "theme"
-  }
+    "installable": false,
+    "icon": "theme",
+    "lineage": "phs",
+    "family": "trade-services",
+    "normalization": "canonical_id_assigned",
+    "canonicalId": "forge",
+    "legacyPackageName": "@inneranimalmedia/theme-handyman-site"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/theme-handyman-site"
+  },
+  "private": true
 }

package/packages/theme-handyman-site/src/harvest.json

@@ -2,9 +2,11 @@
   "harvest_batch": "theme-harvest-20260924",
   "app_path": "apps/handyman-site",
   "harvest_path": "work/theme-harvest/handyman-site",
-  "status": "scaffolded",
+  "status": "needs_normalization",
   "source_hash": "36a5a147cd70c0523a50466fad113cc265ee22a571e98b2fd67fde15ee795ea4",
   "capabilities": [
     "theme.storefront.shell"
-  ]
+  ],
+  "lineage": "phs",
+  "family": "trade-services"
 }

package/packages/theme-handyman-site/src/index.js

@@ -1,7 +1,9 @@
-/** Deterministic installable theme contract for AgentSam gallery/CMS. */
+/** Harvested donor-derived theme wrapper — not installable until remaster gates pass. */
 const THEME = {
   "id": "theme.handyman-site",
   "slug": "handyman-site",
+  "lineage": "phs",
+  "family": "trade-services",
   "displayName": "Primeaux Handyman Services",
   "version": "0.1.0",
   "kind": "gallery-theme",
@@ -40,7 +42,7 @@ const THEME = {
     "mobile": "/themes/handyman-site/demo/",
     "demoUrl": "/themes/handyman-site/demo/"
   },
-  "installable": true,
+  "installable": false,
   "galleryPath": "apps/theme-gallery-preview/themes/handyman-site",
   "capabilityHints": [
     "theme.storefront.shell"
@@ -69,7 +71,9 @@ export function createProductRow({ accountId = null, repositoryId = null, status
     package_name: theme.package,
     metadata: {
       origin: "gallery_mount",
-      normalization_state: status === "production" ? "promoted" : "portable-preview",
+      normalization_state: status === "production" ? "promoted" : "needs_normalization",
+      lineage: theme.lineage,
+      family: theme.family,
       package: theme.package,
       gallery_path: theme.galleryPath,
       preview_kind: theme.preview?.kind || "static",

package/packages/theme-handyman-site/test/theme.test.mjs

@@ -2,10 +2,12 @@ import assert from 'node:assert/strict';
 import test from 'node:test';
 import { createTheme, createProductRow } from '../src/index.js';
 
-test('handyman-site theme package exports installable contract', () => {
+test('handyman-site theme package exports harvested (not installable) contract', () => {
   const theme = createTheme();
   assert.equal(theme.slug, "handyman-site");
-  assert.equal(theme.installable, true);
+  assert.equal(theme.installable, false);
+  assert.equal(theme.lineage, "phs");
+  assert.equal(theme.family, "trade-services");
   assert.equal(theme.package, "@inneranimalmedia/theme-handyman-site");
   assert.ok(Array.isArray(theme.pages));
 });

package/packages/theme-insurance-site/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "@inneranimalmedia/theme-insurance-site",
-  "version": "0.1.0",
-  "description": "Real Chrystal Clear Insurance build \u2014 editorial insurance storefront with coverage storytelling and quote capture.",
+  "name": "@inneranimalmedia/theme-harbor",
+  "version": "2.6.7",
+  "description": "Real Chrystal Clear Insurance build — editorial insurance storefront with coverage storytelling and quote capture.",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -25,7 +25,18 @@
     "kind": "theme",
     "slug": "insurance-site",
     "galleryPath": "apps/theme-gallery-preview/themes/insurance-site",
-    "installable": true,
-    "icon": "theme"
-  }
+    "installable": false,
+    "icon": "theme",
+    "lineage": "cci",
+    "family": "professional-leadgen",
+    "normalization": "canonical_id_assigned",
+    "canonicalId": "harbor",
+    "legacyPackageName": "@inneranimalmedia/theme-insurance-site"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/theme-insurance-site"
+  },
+  "private": true
 }

package/packages/theme-insurance-site/src/harvest.json

@@ -2,9 +2,11 @@
   "harvest_batch": "theme-harvest-20260924",
   "app_path": "apps/insurance-site",
   "harvest_path": "work/theme-harvest/insurance-site",
-  "status": "scaffolded",
+  "status": "needs_normalization",
   "source_hash": "1e171081f5a06d7568554aedcc6a17fd17f102b4109e9b543895fca3879606c2",
   "capabilities": [
     "theme.storefront.shell"
-  ]
+  ],
+  "lineage": "cci",
+  "family": "professional-leadgen"
 }

package/packages/theme-insurance-site/src/index.js

@@ -1,7 +1,9 @@
-/** Deterministic installable theme contract for AgentSam gallery/CMS. */
+/** Harvested donor-derived theme wrapper — not installable until remaster gates pass. */
 const THEME = {
   "id": "theme.insurance-site",
   "slug": "insurance-site",
+  "lineage": "cci",
+  "family": "professional-leadgen",
   "displayName": "Chrystal Clear Insurance",
   "version": "0.1.0",
   "kind": "gallery-theme",
@@ -40,7 +42,7 @@ const THEME = {
     "mobile": "/themes/insurance-site/demo/",
     "demoUrl": "/themes/insurance-site/demo/"
   },
-  "installable": true,
+  "installable": false,
   "galleryPath": "apps/theme-gallery-preview/themes/insurance-site",
   "capabilityHints": [
     "theme.storefront.shell"
@@ -69,7 +71,9 @@ export function createProductRow({ accountId = null, repositoryId = null, status
     package_name: theme.package,
     metadata: {
       origin: "gallery_mount",
-      normalization_state: status === "production" ? "promoted" : "portable-preview",
+      normalization_state: status === "production" ? "promoted" : "needs_normalization",
+      lineage: theme.lineage,
+      family: theme.family,
       package: theme.package,
       gallery_path: theme.galleryPath,
       preview_kind: theme.preview?.kind || "static",

package/packages/theme-insurance-site/test/theme.test.mjs

@@ -2,10 +2,12 @@ import assert from 'node:assert/strict';
 import test from 'node:test';
 import { createTheme, createProductRow } from '../src/index.js';
 
-test('insurance-site theme package exports installable contract', () => {
+test('insurance-site theme package exports harvested (not installable) contract', () => {
   const theme = createTheme();
   assert.equal(theme.slug, "insurance-site");
-  assert.equal(theme.installable, true);
+  assert.equal(theme.installable, false);
+  assert.equal(theme.lineage, "cci");
+  assert.equal(theme.family, "professional-leadgen");
   assert.equal(theme.package, "@inneranimalmedia/theme-insurance-site");
   assert.ok(Array.isArray(theme.pages));
 });

package/packages/theme-scenes/README.md

@@ -0,0 +1,164 @@
+# @inneranimalmedia/theme-scenes
+
+Reusable **scene / shell / block** vocabulary for branded website experiences.
+
+| Layer | Owns |
+| --- | --- |
+| `@inneranimalmedia/agentsam-brand` | BrandPack — assets, tokens, roles, delivery |
+| **`@inneranimalmedia/theme-scenes`** | How brands compose into experiences |
+| Page content | What this page says/shows |
+| Demo adapters | Real product surfaces inside scenes |
+
+Scenes never hardcode CDN URLs, nav hrefs, or product copy. They consume `SECTION_CONTENT`, route refs, and asset roles.
+
+## Install
+
+Workspace package (private for now):
+
+```js
+import {
+  createWorkPreset,
+  compilePage,
+  createCopyBlock,
+  createActionBlock,
+  composeCardCollection,
+} from '@inneranimalmedia/theme-scenes';
+```
+
+## Hierarchy
+
+```
+PAGE_CONTENT
+  └── SECTION_CONTENT[]   → scene kind + theme + scroll + motion
+        └── SECTION_GROUP[]
+              └── CONTENT_BLOCK[]   copy | media | action | cards | demo | …
+```
+
+## Scene kinds (harvested from Work/Create HTML)
+
+| Former HTML piece | Scene / shell |
+| --- | --- |
+| Sticky glass headers | `shell.adaptive-header` |
+| Dark / light globe heroes | `hero.scroll-product` / `hero.editorial` + `visual.orbital-field` |
+| Light→dark gradient | `bridge.theme` |
+| Brand storyboard lanes | `gallery.storyboard` |
+| Icon marquee | `gallery.rail` (loop is one *behavior*) |
+| Service bento | `capability.grid` |
+| MeauxIDE mock | `product.demo` + `agentsam-mini-composer` |
+| MeauxSQL card | `product.demo` + `database-editor` |
+| Staggered tools | `product.stack` |
+| Chess / 3D stage | `interactive.stage` |
+| Footers | `shell.site-footer` |
+
+See `SCENE_ORIGIN` in `src/scenes/index.js`.
+
+## Laws
+
+1. No raw colors in scene contracts — use theme tokens / CSS vars.
+2. No hardcoded internal URLs — use `{ type: 'route', ref: '…' }`.
+3. No direct CDN URLs — use `{ assetRole: '…' }` + BrandPack resolver.
+4. No product copy inside generic scenes — inject via groups/blocks.
+5. No required card counts — empty collections disappear; adaptive layout.
+6. Major media slots support image / video / model / demo.
+7. Animated scenes declare reduced-motion behavior.
+8. Scenes declare theme intent (`surface`, `headerTone`, …).
+9. Product marketing uses real DemoAdapters, not fake UIs.
+10. Motion must communicate something (story/scrub), not decorate forever.
+
+## Quick example
+
+```js
+import {
+  createWorkPreset,
+  createCopyBlock,
+  createActionBlock,
+  createDemoBlock,
+  composeCardCollection,
+  compilePage,
+} from '@inneranimalmedia/theme-scenes';
+
+const page = createWorkPreset({
+  theme: 'inneranimal',
+  heroGroups: [{
+    blocks: [
+      createCopyBlock({
+        variant: 'display',
+        eyebrow: 'Selected Work',
+        title: 'Interface clarity.\nSystem discipline.',
+        body: 'Digital products with refined UI and production-grade foundations.',
+      }),
+      createActionBlock({
+        label: 'View the system',
+        target: { type: 'route', ref: 'product.agentsam' },
+      }),
+    ],
+  }],
+  agentsamGroups: [{
+    blocks: [
+      createCopyBlock({ title: 'AgentSam', body: 'Unified workspace shell.' }),
+      createDemoBlock('agentsam-mini-composer'),
+    ],
+  }],
+  productGroups: [{
+    blocks: [
+      composeCardCollection([
+        { title: 'Database', body: '…', target: { type: 'route', ref: 'product.database' } },
+        { title: 'Cloud', body: '…', target: { type: 'route', ref: 'product.cloud' } },
+      ]),
+    ],
+  }],
+});
+
+const plan = compilePage(page);
+// plan.sections[].demoHost, plan.cssVars, plan.validation
+```
+
+## Presets
+
+- `agency-home` — institutional flagship narrative  
+- `work` — Work page (dark or canvas hero via `heroTone`)  
+- `product` — single product landing  
+- `services` — capability grid  
+- `brand-story` — Create/guideline storyboard  
+
+```js
+import { createPreset, listPresets } from '@inneranimalmedia/theme-scenes';
+```
+
+## Themes
+
+`foundation` → `inneranimal` → `agentsam` / `autodidact`
+
+Semantic tokens only (`color.surface.canvas`, `type.display.xl`, …). `themeToCssVars()` emits `--scene-*` for hosts.
+
+## Scroll presets
+
+| Mode | Typical | Purpose |
+| --- | --- | --- |
+| `natural` | content height | ordinary |
+| `viewport` | ~100vh | focused statement |
+| `linger` | 120–160vh | visual + copy |
+| `sticky-story` | 180–260vh | narrative scrub |
+| `cinematic` | 240–320vh | flagship product |
+| `bridge` | 40–80vh | world transition |
+
+Hosts receive normalized `progress` 0→1 (`computeScrollProgress` / `stageAtProgress`).
+
+## Demo adapters
+
+| Adapter | Product surface |
+| --- | --- |
+| `agentsam-mini-composer` | AgentSam / MiniComposer |
+| `database-editor` | MeauxSQL-class DB editor |
+| `cad-viewer` | GLB turntable |
+| `generic-iframe` | last-resort embed |
+
+## Studio (next)
+
+Reusable `studio-shell` (navigator / canvas / inspector) sits *above* this package. Moon Glass mock → Brand Studio panels over BrandPack + theme-scenes — not another one-off HTML page. See AgentSam BrandPack README for the compiler side.
+
+## Tests
+
+```bash
+npm --prefix packages/theme-scenes test
+```

package/packages/theme-scenes/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@inneranimalmedia/theme-scenes",
+  "version": "2.6.7",
+  "description": "Reusable scene / shell / block vocabulary for branded website experiences. BrandPack owns look; theme-scenes owns composition.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22 <25"
+  },
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./contracts": "./src/contracts/index.js",
+    "./scenes": "./src/scenes/index.js",
+    "./shell": "./src/shell/index.js",
+    "./blocks": "./src/blocks/index.js",
+    "./visuals": "./src/visuals/index.js",
+    "./demos": "./src/demos/index.js",
+    "./themes": "./src/themes/index.js",
+    "./presets": "./src/presets/index.js",
+    "./registry": "./src/registry.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/theme-scenes"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agentsam",
+    "theme",
+    "scenes",
+    "sections",
+    "brand",
+    "cms"
+  ],
+  "agentsam": {
+    "kind": "theme-runtime",
+    "slug": "theme-scenes",
+    "depends_on": [
+      "@inneranimalmedia/agentsam-brand"
+    ]
+  }
+}

package/packages/theme-scenes/src/blocks/index.js

@@ -0,0 +1,30 @@
+/**
+ * Block helpers — scenes compose these; they never own brand URLs.
+ */
+
+export {
+  createCopyBlock,
+  createMediaBlock,
+  createActionBlock,
+  createCardsBlock,
+  createDemoBlock,
+  composeCardCollection,
+  BLOCK_KINDS,
+} from '../contracts/index.js';
+
+/** Resolve whether a block should render (empty collections disappear). */
+export function shouldRenderBlock(block) {
+  if (!block?.kind) return false;
+  if (block.kind === 'cards') return Array.isArray(block.items) && block.items.length > 0;
+  if (block.kind === 'copy') {
+    return Boolean(block.title || block.body || block.eyebrow || (block.bullets && block.bullets.length));
+  }
+  if (block.kind === 'action') return Boolean(block.label);
+  if (block.kind === 'demo') return Boolean(block.adapter);
+  if (block.kind === 'media') return Boolean(block.media?.assetRole || block.media?.ref);
+  return true;
+}
+
+export function filterRenderableBlocks(blocks = []) {
+  return blocks.filter(shouldRenderBlock);
+}