@inneranimalmedia/agentsam-sdk 2.6.5 → 2.6.7

package/apps/client-cms-editor/reference/harvest/plans/STOREFRONT-SURFACE-MAP.md

@@ -0,0 +1,140 @@
+# Inner Animals Storefront Surface Map
+
+This file exists so the storefront can be harvested as a coherent website/theme rather than as disconnected React files.
+
+## Current route surfaces
+
+| Surface | Source |
+| --- | --- |
+| Home | `app/page.tsx` + `app/components/Storefront.tsx` |
+| Shop | `app/shop/page.tsx` |
+| Collection | `app/collections/[slug]/page.tsx` |
+| Product | `app/product/[slug]/page.tsx` |
+| Journal index | `app/journal/page.tsx` |
+| Journal detail | `app/journal/[slug]/page.tsx` |
+| Story | `app/story/page.tsx` |
+| Shared storefront data | `app/storefront-data.ts` |
+| Shared storefront styles | `app/storefront.css` |
+| Layout | `app/layout.tsx` |
+
+The CMS editor is deliberately separate at `app/studio/page.tsx`.
+
+## Harvest goal
+
+Preserve enough source to reconstruct the entire public-facing experience:
+
+- page composition
+- content hierarchy
+- navigation behavior
+- product cards
+- product detail behavior
+- collection behavior
+- journal surfaces
+- story/brand narrative
+- footer
+- responsive behavior
+- styles/tokens
+- sample data shape
+
+Do not reduce this to screenshots or static HTML if the React behavior can be preserved.
+
+## Theme normalization target
+
+The eventual reusable theme should separate four concerns.
+
+### 1. Layout/presentation
+
+Reusable visual implementation:
+
+- site header
+- hero
+- section shells
+- product grid/card
+- editorial/journal grid
+- product detail layout
+- story layout
+- footer
+- responsive rules
+
+### 2. CMS block/section definitions
+
+The old implementation does not need to already be perfectly block-oriented.
+
+Normalize later into stable section/block contracts, for example:
+
+- announcement bar
+- navigation
+- cinematic hero
+- instinct/use navigation
+- product collection/grid
+- manifesto
+- archetype collection
+- film/story feature
+- journal feed
+- community/gallery
+- newsletter/community CTA
+- footer
+- product detail
+- editorial article
+
+### 3. Content bindings
+
+Replace baked-in content with explicit structured bindings:
+
+- brand name/mark
+- nav
+- hero copy/media
+- collections
+- products
+- archetypes
+- journal entries
+- story sections
+- CTAs
+- footer links
+- SEO metadata
+
+Historical content can remain as demo/sample content but should be clearly marked as such.
+
+### 4. Commerce/provider data
+
+Product/catalog truth must eventually come from the ecommerce/CMS host contract, not from the theme package itself.
+
+The theme may ship sample data for preview, but sample data must never masquerade as production inventory/catalog authority.
+
+## Preservation rule
+
+The harvest export copies all route/component/data/style files listed in this document before normalization.
+
+That intentionally favors preserving too much source at the donor stage rather than prematurely deleting behavior that later turns out to be useful.
+
+## What not to import as theme authority
+
+Do not make the theme own:
+
+- authentication
+- account/session logic
+- CMS persistence
+- publishing
+- inventory truth
+- order truth
+- payment/provider credentials
+- Worker bindings
+- D1/R2 resources
+- deployment commands
+
+The theme is a presentation/layout/content-binding package.
+
+## Gallery target
+
+Once normalized, the theme should be able to appear as a real live example with:
+
+- desktop preview
+- mobile preview
+- route/page list
+- source provenance
+- feature list
+- normalization status
+- installability status
+- CMS block compatibility status
+
+Previewing it must remain side-effect free.

package/apps/client-cms-editor/reference/harvest/plans/THEME-INNERANIMALS-HARVEST.md

@@ -0,0 +1,137 @@
+# Inner Animals Theme / Layout Harvest
+
+## Goal
+
+Turn the useful public storefront and visual/layout language in this donor into a reusable theme/preset candidate without making the donor repo or its content the runtime authority.
+
+Potential destination:
+
+`packages/theme-inneranimals-site`
+
+Potential gallery destination:
+
+`apps/theme-gallery-preview/themes/inneranimals-site`
+
+## Current donor source
+
+The latest merged source separates the public website from the CMS editor.
+
+Public/theme donor:
+
+- `app/page.tsx`
+- `app/components/Storefront.tsx`
+- `app/storefront-data.ts`
+- `app/storefront.css`
+- `app/layout.tsx`
+- `app/shop/page.tsx`
+- `app/collections/[slug]/page.tsx`
+- `app/product/[slug]/page.tsx`
+- `app/journal/page.tsx`
+- `app/journal/[slug]/page.tsx`
+- `app/story/page.tsx`
+
+CMS editor donor remains separate at `app/studio/page.tsx`.
+
+See `STOREFRONT-SURFACE-MAP.md` for the route-to-theme mapping.
+
+## Preserve
+
+Preserve source-level evidence for:
+
+- section ordering
+- navigation patterns
+- hero treatment
+- typography hierarchy
+- spacing rhythm
+- palette/token choices
+- footer patterns
+- content widths
+- responsive behavior
+- product/store behavior
+- collection behavior
+- journal/editorial behavior
+- story/brand narrative behavior
+- reusable component/template ideas
+
+The harvest export intentionally copies the original source and CSS intact so no layout behavior is lost before normalization.
+
+## Normalize later
+
+The real theme implementation should separate:
+
+### Theme contract
+
+- tokens
+- typography
+- colors
+- radii
+- spacing
+- motion defaults
+- container rules
+- section presets
+
+### Content bindings
+
+- nav links
+- hero copy/media
+- CTAs
+- collections
+- product fields
+- archetypes
+- journal entries
+- story content
+- footer links
+
+### CMS blocks
+
+If the old source is not truly block-oriented, do not fake it during harvest.
+
+Normalize during implementation into explicit blocks/sections.
+
+## Content rule
+
+Historical Inner Animals copy may be useful for a live historical preview, but should not silently become generic scaffold copy for unrelated customer sites.
+
+The reusable package should distinguish:
+
+- design/layout preset,
+- sample/demo content,
+- customer content.
+
+## Side-effect rule
+
+Installing or previewing the theme must not:
+
+- publish it,
+- sync it,
+- upload assets,
+- overwrite an active customer theme,
+- change a CMS publication.
+
+A future theme command should keep these steps distinct:
+
+```
+inspect
+preview
+install/stage
+apply
+sync
+publish
+```
+
+Only the explicitly invoked mutating step may alter its declared target.
+
+## Gallery value
+
+Keep the historical donor as a real showcase example.
+
+A future gallery entry should communicate:
+
+- historical source/provenance
+- available pages/surfaces
+- whether the item is previewable
+- whether it is installable
+- whether it has been normalized into CMS blocks
+- which capabilities are real versus visual/demo-only
+
+This lets AgentSam advertise real prior systems without misrepresenting prototype behavior as production capability.

package/apps/client-cms-editor/reference/harvest/plans/TOOLING-LAB.md

@@ -0,0 +1,63 @@
+# Studio CMS Harvest Tooling Lab
+
+Purpose: use this historical CMS/storefront as both donor material and a repeatable acceptance fixture for AgentSam tooling.
+
+Ownership rule:
+account_id -> site_id -> brand/routes/layouts/navigation/content/assets/drafts/publications.
+There is intentionally no tenant_id and no workspace_id in the local CMS scaffold.
+
+Local harvester:
+scripts/harvest_local_cms.py
+
+It creates:
+../studio-cms-editor-harvest-export/local/inneranimals-cms.sqlite
+
+It extracts:
+- public storefront brand tokens
+- editor-shell tokens as a separate reference profile
+- public routes and layout candidates
+- public header/footer navigation
+- products, archetypes, and journal sample content
+- external asset references
+- provenance and hashes
+- prototype-risk findings
+- empty local draft/change/publication tables
+
+Tooling acceptance runner:
+scripts/harvest_tooling_lab.py
+
+Default safe profile exercises:
+- AgentSam CLI availability
+- AgentSam site-scrape unit tests with no network
+- Brand processor discovery
+- Brand role catalog
+- Brand template catalog
+- AutoRAG setup using deterministic fixture embeddings
+- AutoRAG local SQLite semantic probe
+- local knowledge index planning
+- SQLite integrity
+
+Local-full additionally attempts:
+- Brand ingest into an isolated fixture
+- Brand build into isolated fixture output
+
+Optional public network test:
+pass --scrape-url explicitly.
+No repo-root is supplied to the scraper, so it stays local-only and does not upload to R2.
+
+Hard safety boundary:
+the tooling lab never deploys, publishes, syncs a site, uploads to R2, writes remote Vectorize, or writes Cloudflare Images.
+
+The fixture has its own disposable Git repository and .agentsam directory so test runs do not contaminate the donor repo or the real SDK repository.
+
+Suggested command:
+
+python3 scripts/harvest_tooling_lab.py --sdk /Users/samprimeaux/agentsam-sdk --replace-export --replace-db
+
+For the wider product, use the same acceptance fixture on:
+- local CLI / desktop
+- CI
+- Docker
+- a persistent VM or container lane
+
+Cloudflare should remain an explicit graduation target rather than a side effect of local harvesting.

package/apps/client-cms-editor/reference/harvest/plans/harvest-manifest.json

@@ -0,0 +1,97 @@
+{
+  "schema": "studio-cms-editor.harvest.v1",
+  "source": {
+    "repository": "SamPrimeaux/studio-cms-editor",
+    "reference_commit": "f0547d7"
+  },
+  "lanes": {
+    "cms_editor_donor": {
+      "decision": "keep_and_adapt",
+      "files": [
+        "app/studio/page.tsx",
+        "app/globals.css"
+      ],
+      "notes": "Preserve interaction/layout source verbatim. Replace simulated persistence/publication during implementation."
+    },
+    "chatgpt_identity_reference": {
+      "decision": "keep_and_package",
+      "files": [
+        "app/chatgpt-auth.ts"
+      ],
+      "notes": "Reference for optional OpenAI/ChatGPT identity provider/hosted adapter. Do not make CMS depend on transport headers."
+    },
+    "theme_layout_donor": {
+      "decision": "keep_and_normalize_later",
+      "files": [
+        "app/page.tsx",
+        "app/components/Storefront.tsx",
+        "app/storefront-data.ts",
+        "app/storefront.css",
+        "app/layout.tsx",
+        "app/shop/page.tsx",
+        "app/collections/[slug]/page.tsx",
+        "app/product/[slug]/page.tsx",
+        "app/journal/page.tsx",
+        "app/journal/[slug]/page.tsx",
+        "app/story/page.tsx",
+        "public/favicon.svg"
+      ],
+      "notes": "Candidate input for theme-inneranimals-site. Preserve routes/components/data/styles before normalizing into sections/blocks."
+    },
+    "content_plan_reference": {
+      "decision": "keep_as_provenance",
+      "files": [
+        "plans/INNERANIMALS-CONTENT-001.md"
+      ],
+      "notes": "Implementation intent and historical content plan; not reusable runtime authority."
+    },
+    "runtime_reference": {
+      "decision": "reference_only",
+      "files": [
+        ".openai/hosting.json",
+        "package.json",
+        "vite.config.ts",
+        "next.config.ts",
+        "worker/index.ts",
+        "worker/vpc.ts",
+        "wrangler.production.toml",
+        "docs/workers-vpc.md",
+        "drizzle.config.ts",
+        "db/index.ts",
+        "db/schema.ts",
+        "README.md"
+      ],
+      "notes": "Useful provenance/runtime context. Never auto-adopt deployment bindings or commands."
+    }
+  },
+  "exclude_patterns": [
+    ".git/**",
+    "node_modules/**",
+    "dist/**",
+    ".next/**",
+    ".wrangler/**",
+    ".vinext/**",
+    "*.log",
+    ".DS_Store"
+  ],
+  "junk_or_review_signals": [
+    "localStorage",
+    "setTimeout",
+    "2 others editing",
+    "Connected",
+    "uploaded",
+    "publishing",
+    "fake",
+    "demo",
+    "mock",
+    "wrangler deploy",
+    "deploy:prod"
+  ],
+  "target_suggestions": {
+    "cms": "apps/client-cms-editor or future packages/agentsam-cms family",
+    "theme": "packages/theme-inneranimals-site",
+    "theme_gallery": "apps/theme-gallery-preview/themes/inneranimals-site",
+    "identity": "packages/identity/src/providers/openai",
+    "sdk_staging": "apps/_incoming/studio-cms-editor-harvest"
+  }
+}