Merge dev into main (marketing site updates)

Author: markmhendrickson

docs/releases/in_progress/v0.4.1/github_release_preview.md

@@ -7,11 +7,13 @@ npm install -g neotoma@0.4.1
 | | |
 |:--|:--|
 | **npm** | https://www.npmjs.com/package/neotoma/v/0.4.1 |
-| **Compare** | `v0.4.0` → `v0.4.1-provisional` — [view diff](https://github.com/markmhendrickson/neotoma/compare/v0.4.0...e91cacd0) |
+| **Compare** | `v0.4.0` → `v0.4.1` — [view diff](https://github.com/markmhendrickson/neotoma/compare/v0.4.0...v0.4.1) |
 
-**Draft scope note:** This release note draft is pinned to the committed range **`v0.4.0..e91cacd0`**. Newer unstaged local edits were intentionally excluded from the `v0.4.1` candidate.
+**Shipped scope:** Git tag **`v0.4.1`** is at **`8081ee5`** (`Release v0.4.1: incremental deploy (marketing site)`). Narrative and `release-notes:render --tag v0.4.1` use range **`v0.4.0..v0.4.1`**.
 
-Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery path for local installs, improves MCP/CLI contract parity around entity counts, and continues the evaluation-first site refresh with clearer product positioning, install guidance, and homepage demos.
+**Post-tag `dev` (not in the `v0.4.1` tag):** `5258b9f3` — `fix(site): keep record-types headline tail on one line`. Ship as **`v0.4.2`** (or cherry-pick) if that fix should ride with npm/GitHub users on the same semver.
+
+Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery path for local installs, improves MCP/CLI contract parity around entity counts, ships FU-301 marketing-site refresh with incremental Pages deploy, syncs foundation commands into Claude Code skills, adds the `writ` submodule for WRIT benchmarking, and continues the evaluation-first site refresh with clearer product positioning, install guidance, and homepage demos.
 
 ## What changed for npm package users
 
@@ -45,13 +47,16 @@ Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery
 
 ## Docs site & CI / tooling
 
+- **FU-301:** Marketing site refresh, SEO, and v0.4.1 prep docs; **incremental GitHub Pages deploy** for the marketing site (`Release v0.4.1: incremental deploy`).
 - Refreshed public positioning, ICP, and release-targeting material across `docs/foundation/`, `docs/icp/`, and homepage design guidance.
 - Expanded the `evaluate_positioning` skill and related reference material so release prep, positioning review, and site iteration share the same framework.
 - Kept site coverage current with Playwright updates for hash navigation and other homepage regressions, plus ongoing route/SEO/localization maintenance in the frontend site layer.
 
 ## Internal changes
 
 - Renamed the canonical release command to `/release` while keeping `/create_release` as a legacy alias, and updated synced command/rule/skill copies accordingly.
+- Emit foundation commands as **Claude Code skills** (`.claude/skills/<name>/SKILL.md`), with Cursor skill sync when not sourced from foundation.
+- Added **`writ` submodule** (WRIT write-integrity benchmark).
 - Synced generated Cursor/Claude instruction surfaces with the updated release workflow, positioning material, and rule set.
 - Added the focused test-only transport behavior in `src/cli/index.ts` to remove flaky per-command local transport startup during CLI test runs.
 
@@ -65,16 +70,23 @@ Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery
 
 - The committed `v0.4.1` candidate passed the full pre-commit gate used during release prep: `tsc --noEmit`, `eslint src --ext .ts`, `npm run lint:site-copy`, `npm test`, `npm run test:e2e`, `npm run validate:coverage`, `npm run check:pw-coverage`, and `npm run validate:doc-deps`.
 - Release prep also included focused reruns of the previously failing CLI correction test and the homepage hash-update Playwright test after the fixes landed.
-- Before publishing the actual GitHub Release, re-render notes after the final `v0.4.1` tag exists so the compare link and commit list reflect the exact tagged commit.
+- The `v0.4.1` tag exists on `8081ee5`; re-run `npm run -s release-notes:render -- --tag v0.4.1` after any tag movement before publishing or editing the GitHub Release.
 
 ## Breaking changes
 
 - None called out for `0.4.1`.
 
 ---
 
-## Commits (`v0.4.0` → `v0.4.1-provisional`)
+## Commits (`v0.4.0` → `v0.4.1`)
 
+- `80203f2` Release v0.4.1: incremental deploy (marketing site)
+- `5a95524` Merge dev into main for release v0.4.1 (marketing site)
+- `9c62ea4` FU-301: Marketing site refresh, SEO, and v0.4.1 prep docs
+- `56d4b50` chore: add writ submodule (WRIT write-integrity benchmark)
+- `2665395` fix(claude): emit skills as .claude/skills/<name>/SKILL.md
+- `5e816a2` Sync .cursor/skills into Claude skills when not in foundation
+- `8034a9b` Emit all foundation commands as Claude Code skills
 - `e91cacd` chore(release): prepare main-repo v0.4.1 candidate
 - `e3b99e5` Dev: CLI/API contracts, site UI, docs, cursor rules, inspector submodule
 - `0da9e28` docs(icp): refresh primary ICP, dev release targeting, general release criteria; anonymize evaluator PII in public docs; add private field_evidence submodule ref
@@ -273,4 +285,5 @@ Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery
 - `79285c8` WIP: CSV uploader with normalization and LLM transforms
 - `dc11c6d` Initial commit: MCP server for extensible record storage with semantic search, ChatGPT Actions, and Supabase backend
 
-**Full compare:** [`v0.4.0...v0.4.1-provisional`](https://github.com/markmhendrickson/neotoma/compare/v0.4.0...e91cacd0)
+**Full compare:** [`v0.4.0...v0.4.1`](https://github.com/markmhendrickson/neotoma/compare/v0.4.0...v0.4.1)
+

docs/releases/in_progress/v0.4.1/github_release_supplement.md

@@ -1,6 +1,8 @@
-**Draft scope note:** This release note draft is pinned to the committed range **`v0.4.0..e91cacd0`**. Newer unstaged local edits were intentionally excluded from the `v0.4.1` candidate.
+**Shipped scope:** Git tag **`v0.4.1`** is at **`8081ee5`** (`Release v0.4.1: incremental deploy (marketing site)`). Narrative and `release-notes:render --tag v0.4.1` use range **`v0.4.0..v0.4.1`**.
 
-Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery path for local installs, improves MCP/CLI contract parity around entity counts, and continues the evaluation-first site refresh with clearer product positioning, install guidance, and homepage demos.
+**Post-tag `dev` (not in the `v0.4.1` tag):** `5258b9f3` — `fix(site): keep record-types headline tail on one line`. Ship as **`v0.4.2`** (or cherry-pick) if that fix should ride with npm/GitHub users on the same semver.
+
+Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery path for local installs, improves MCP/CLI contract parity around entity counts, ships FU-301 marketing-site refresh with incremental Pages deploy, syncs foundation commands into Claude Code skills, adds the `writ` submodule for WRIT benchmarking, and continues the evaluation-first site refresh with clearer product positioning, install guidance, and homepage demos.
 
 ## What changed for npm package users
 
@@ -34,13 +36,16 @@ Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery
 
 ## Docs site & CI / tooling
 
+- **FU-301:** Marketing site refresh, SEO, and v0.4.1 prep docs; **incremental GitHub Pages deploy** for the marketing site (`Release v0.4.1: incremental deploy`).
 - Refreshed public positioning, ICP, and release-targeting material across `docs/foundation/`, `docs/icp/`, and homepage design guidance.
 - Expanded the `evaluate_positioning` skill and related reference material so release prep, positioning review, and site iteration share the same framework.
 - Kept site coverage current with Playwright updates for hash navigation and other homepage regressions, plus ongoing route/SEO/localization maintenance in the frontend site layer.
 
 ## Internal changes
 
 - Renamed the canonical release command to `/release` while keeping `/create_release` as a legacy alias, and updated synced command/rule/skill copies accordingly.
+- Emit foundation commands as **Claude Code skills** (`.claude/skills/<name>/SKILL.md`), with Cursor skill sync when not sourced from foundation.
+- Added **`writ` submodule** (WRIT write-integrity benchmark).
 - Synced generated Cursor/Claude instruction surfaces with the updated release workflow, positioning material, and rule set.
 - Added the focused test-only transport behavior in `src/cli/index.ts` to remove flaky per-command local transport startup during CLI test runs.
 
@@ -54,7 +59,7 @@ Neotoma `0.4.1` tightens the release-prep workflow, adds a safer SQLite recovery
 
 - The committed `v0.4.1` candidate passed the full pre-commit gate used during release prep: `tsc --noEmit`, `eslint src --ext .ts`, `npm run lint:site-copy`, `npm test`, `npm run test:e2e`, `npm run validate:coverage`, `npm run check:pw-coverage`, and `npm run validate:doc-deps`.
 - Release prep also included focused reruns of the previously failing CLI correction test and the homepage hash-update Playwright test after the fixes landed.
-- Before publishing the actual GitHub Release, re-render notes after the final `v0.4.1` tag exists so the compare link and commit list reflect the exact tagged commit.
+- The `v0.4.1` tag exists on `8081ee5`; re-run `npm run -s release-notes:render -- --tag v0.4.1` after any tag movement before publishing or editing the GitHub Release.
 
 ## Breaking changes
 

frontend/src/components/SiteHeaderNav.tsx

@@ -87,6 +87,8 @@ import {
   useSiteAppNavBarVisibleSetter,
   useSiteHomeEvaluateScrollBannerVisible,
 } from "@/context/SiteAppNavContext";
+import { HOME_DEMO_INSTALL_CTA_CLASS } from "@/components/code_block_copy_button_classes";
+import { cn } from "@/lib/utils";
 
 const sidebarNavItemClass =
   "!bg-transparent text-sidebar-foreground hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus:bg-sidebar-accent focus:text-sidebar-accent-foreground data-[state=open]:bg-sidebar-accent data-[state=open]:text-sidebar-accent-foreground";
@@ -704,7 +706,10 @@ export function SiteHeaderNav(props: SiteHeaderNavProps) {
         </Link>
         <Link
           to={localizePath("/install", locale)}
-          className="rounded-md px-1.5 py-1.5 text-[13px] text-sidebar-foreground no-underline hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"
+          className={cn(
+            HOME_DEMO_INSTALL_CTA_CLASS,
+            "px-2 py-1 text-[13px] focus-visible:ring-offset-sidebar",
+          )}
           onClick={() => sendCtaClick("header_install")}
         >
           {dict.install}
@@ -735,7 +740,10 @@ export function SiteHeaderNav(props: SiteHeaderNavProps) {
             <NavigationMenuLink asChild>
               <Link
                 to={localizePath("/install", locale)}
-                className={`${navigationMenuTriggerStyle()} ${sidebarNavItemClass}`}
+                className={cn(
+                  HOME_DEMO_INSTALL_CTA_CLASS,
+                  "px-2.5 py-1 text-sm focus-visible:ring-offset-sidebar",
+                )}
                 onClick={() => sendCtaClick("header_install")}
               >
                 {dict.install}
@@ -901,7 +909,10 @@ export function SiteHeaderNav(props: SiteHeaderNavProps) {
                   </Link>
                   <Link
                     to={localizePath("/install", locale)}
-                    className="rounded-md px-3 py-2 text-[14px] text-sidebar-foreground no-underline hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"
+                    className={cn(
+                      HOME_DEMO_INSTALL_CTA_CLASS,
+                      "w-full justify-center px-3 py-2 text-[14px] focus-visible:ring-offset-sidebar",
+                    )}
                     onClick={() => {
                       sendCtaClick("header_install");
                       setMobileMenuOpen(false);

frontend/src/components/SitePage.tsx

@@ -58,6 +58,7 @@ import founderPhoto from "@/assets/images/people/mark_hendrickson.jpg";
 
 import { useLocale } from "@/i18n/LocaleContext";
 import { localizePath } from "@/i18n/routing";
+import { cn } from "@/lib/utils";
 import { useSiteHomeEvaluateScrollBannerVisibleSetter } from "@/context/SiteAppNavContext";
 import { sendCtaClick } from "@/utils/analytics";
 interface SitePageProps {
@@ -1467,11 +1468,11 @@ export function SitePage({ staticMode = false }: SitePageProps) {
                           {pack.homeHero.curiosityGap}
                         </p>
 
-                        <p className="text-[15px] md:text-[17px] leading-7 text-foreground/80 max-w-xl mx-auto lg:mx-0">
+                        <p className="mb-4 text-[15px] md:text-[17px] leading-7 text-foreground/80 max-w-xl mx-auto lg:mx-0">
                           {pack.homeHero.subcopy}
                         </p>
 
-                        <div className="flex flex-col sm:flex-row sm:flex-wrap justify-center gap-3 pt-1 lg:justify-start">
+                        <div className="mt-10 flex flex-col sm:flex-row sm:flex-wrap justify-center gap-3 lg:justify-start">
                           <a
                             href="/evaluate"
                             className={`${HOME_EVALUATE_CTA_CLASS} w-full sm:w-auto`}
@@ -2003,7 +2004,11 @@ export function SitePage({ staticMode = false }: SitePageProps) {
                   </a>
                   <Link
                     to={localizePath("/meet", locale)}
-                    className={`${HOME_SCROLL_BANNER_SPLIT_CELL_CLASS} ${HOME_SCROLL_BANNER_SECONDARY_CELL_CLASS}`}
+                    className={cn(
+                      HOME_SCROLL_BANNER_SPLIT_CELL_CLASS,
+                      HOME_SCROLL_BANNER_SECONDARY_CELL_CLASS,
+                      "hidden md:flex",
+                    )}
                     onClick={() => sendCtaClick("meet_with_creator_banner")}
                   >
                     <CalendarClock className="h-4 w-4 shrink-0" aria-hidden />

package.json

@@ -92,7 +92,7 @@
     "cli": "node dist/cli/index.js",
     "cli:dev": "tsx src/cli/index.ts",
     "setup:cli": "npm run build:server && npm link && node -e \"const cp=require('child_process'); const fs=require('fs'); const p=cp.execSync('npm config get prefix',{encoding:'utf8'}).trim(); const bin=p+'/bin'; const neotomaPath=bin+'/neotoma'; const exists=fs.existsSync(neotomaPath); console.log(''); console.log('Step 1: Run this in your terminal (or add to ~/.zshrc):'); console.log('  export PATH=\\\"' + bin + ':\\$PATH\\\"'); console.log(''); console.log('Step 2: Then run: neotoma'); if(exists) { console.log(''); console.log('(Verified: neotoma is linked at ' + neotomaPath + ')'); }\"",
-    "prepare": "husky",
+    "prepare": "husky || node -e \"process.exit(0)\"",
     "setup:cursor": "bash scripts/setup_cursor_from_foundation.sh",
     "setup:claude": "bash scripts/setup_claude_instructions.sh",
     "sync:mcp": "node scripts/sync_mcp_configs.js",