Add FORMA static storefront, Shopify theme & Ruby adapter, integration hooks, docs and CI checks

[feispla]

Motivation

• Provide a deployable static FORMA storefront with local demo catalog and clear runtime integration hooks for Shopify, Supabase and Chatbase.
• Add a minimal Shopify Liquid theme scaffold and a small Ruby adapter to support server-side Admin/storefront workflows and future upstream contributions.
• Improve developer experience with verification/smoke scripts, Turborepo wiring and a GitHub PR/issue checklist for AI-assisted agents.
• Ensure CI runs a preflight npm run check on PRs and important branches to prevent missing assets or accidental secrets.

Description

• Added a full static storefront: index.html, assets/store.js, assets/store.css, assets/integrations.js and assets/config.js (demo values only) to drive client-side catalog, cart, wishlist and integrations.
• Added integration and ops scaffolding: shopify-ruby/ adapter, shopify-theme/ Liquid scaffold, Supabase migration supabase/migrations/202605130001_storefront_core.sql, vercel.json, and docs under docs/ for go-live, integrations and Turborepo.
• Added developer tooling and verification scripts: scripts/verify-files.js, scripts/smoke-static.js, scripts/github-plain-diff.js, scripts/prepare-shopify-upstream.sh, scripts/turbo-doctor.js, plus package.json, package-lock.json, turbo.json and a CLAUDE.md guideline for GitHub agents.
• Repository hygiene and CI: new .github templates (ISSUE_TEMPLATE/ai-agent-task.md, pull_request_template.md) and a workflow .github/workflows/check.yml that checks out, installs Node and runs npm ci then npm run check on PR and push events.

Testing

• No automated tests were executed as part of this rollout; the change adds CI that will run npm run check on pull requests and pushes.
• The created npm scripts wire verify:files and smoke:static so running npm run check locally will execute node scripts/verify-files.js and node scripts/smoke-static.js (and other configured checks).
• The workflow .github/workflows/check.yml is configured to run npm ci and npm run check on pull_request and on pushes to main, master and work branches.
• Smoke and verification scripts will fail fast and exit non-zero when required assets or files are missing, as implemented in scripts/smoke-static.js and scripts/verify-files.js.

---

Codex Task