@invisibleloop/pulse 0.2.8 → 0.2.10

package/CLAUDE.md

@@ -454,3 +454,5 @@ First-visit JS = runtime chunk (~3.8 kB) + per-page boot file (~0.4–0.9 kB). O
 Lighthouse: 100/100/100 (Accessibility / Best Practices / SEO) on both pages.
 
 LCP is fast by design (streaming SSR sends HTML before data resolves) but actual millisecond values depend on machine speed, browser, network conditions, and server location — do not quote specific numbers.
+
+**Caveat — third-party ads:** Pages that load ad network scripts will not achieve 100 across all categories. Ad scripts introduce render-blocking JS, third-party cookies (Best Practices), and late-loading content that causes CLS. Reserving fixed space for ad slots reduces CLS but cannot fully compensate for what ad networks inject at runtime. Treat 100/100/100 as the baseline for ad-free pages only.

package/docs/src/pages/performance.js

@@ -34,6 +34,7 @@ export default {
         ]
       )}
       ${callout('note', 'Run <code>mcp__chrome-devtools__lighthouse_audit</code> after every new page to verify all four scores are 100. Fix any failures before considering the task done.')}
+      ${callout('warning', '<strong>Third-party ads caveat:</strong> Pages that load ad network scripts will not achieve 100 across all categories. Ad scripts introduce render-blocking JS, third-party cookies (Best Practices), and late-loading content that causes CLS. Reserving fixed space for ad slots reduces CLS but cannot fully compensate for what ad networks inject at runtime. Treat 100/100/100 as the baseline for ad-free pages only.')}
 
       ${section('streaming-ssr', 'Streaming SSR')}
       <p>Pulse uses Node.js streams for SSR. The server sends the <code>&lt;head&gt;</code> and page shell immediately, before any async data resolves. Browsers start downloading CSS and fonts while the server fetches data — so the user sees a styled shell within milliseconds.</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invisibleloop/pulse",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "type": "module",
   "description": "AI-first frontend framework. The spec is the source of truth.",
   "license": "MIT",

package/public/.pulse-ui-version

@@ -1 +1 @@
-0.2.8
+0.2.10

package/src/agent/commands/pulse-build.md

@@ -0,0 +1,7 @@
+Build this Pulse project for production.
+
+```bash
+pulse build
+```
+
+This bundles all pages into `public/dist/`. When complete, confirm the build succeeded and list the generated files.

package/src/agent/commands/pulse-dev.md

@@ -0,0 +1,7 @@
+Start (or restart) the Pulse dev server for this project.
+
+```bash
+pulse stop; pulse dev
+```
+
+The server port is read from `pulse.config.js` (defaults to 3000).

package/src/agent/commands/pulse-start.md

@@ -0,0 +1,9 @@
+Start the Pulse production server for this project.
+
+First ensure a build exists (`public/dist/`). Then run:
+
+```bash
+pulse start
+```
+
+The production server uses the port from `pulse.config.js` (defaults to 3000).

package/src/agent/commands/pulse-stop.md

@@ -0,0 +1,5 @@
+Stop the Pulse dev server for this project.
+
+```bash
+pulse stop
+```

package/src/cli/dev.js

@@ -71,6 +71,16 @@ const PUBLIC_DIR     = path.join(ROOT, 'public')
     fs.copyFileSync(checklistSrc, checklistDst)
   }
 
+  // Sync slash commands into .claude/commands/ so /pulse-dev etc. always exist
+  const commandsSrc = new URL('../agent/commands', import.meta.url).pathname
+  const commandsDst = path.join(ROOT, '.claude', 'commands')
+  if (fs.existsSync(commandsSrc)) {
+    fs.mkdirSync(commandsDst, { recursive: true })
+    for (const file of fs.readdirSync(commandsSrc).filter(f => f.endsWith('.md'))) {
+      fs.copyFileSync(path.join(commandsSrc, file), path.join(commandsDst, file))
+    }
+  }
+
   console.log(`  ✓ pulse-ui assets synced (v${pkgVersion})\n`)
 })()
 

package/src/cli/index.js

@@ -289,7 +289,7 @@ async function runUpdate(root) {
     const dst = path.join(publicDir, asset)
     if (!fs.existsSync(src)) { missing.push(asset); continue }
     fs.copyFileSync(src, dst)
-    updated.push(asset)
+    updated.push(`public/${asset}`)
   }
 
   // Sync agent checklist into .claude/
@@ -301,12 +301,23 @@ async function runUpdate(root) {
     updated.push('.claude/pulse-checklist.md')
   }
 
+  // Sync slash commands into .claude/commands/
+  const commandsSrc = new URL('../agent/commands', import.meta.url).pathname
+  const commandsDst = path.join(root, '.claude', 'commands')
+  if (fs.existsSync(commandsSrc)) {
+    fs.mkdirSync(commandsDst, { recursive: true })
+    for (const file of fs.readdirSync(commandsSrc).filter(f => f.endsWith('.md'))) {
+      fs.copyFileSync(path.join(commandsSrc, file), path.join(commandsDst, file))
+      updated.push(`.claude/commands/${file}`)
+    }
+  }
+
   // Read the new version for the success message
   const versionFile = path.join(publicDir, '.pulse-ui-version')
   const version     = fs.existsSync(versionFile) ? fs.readFileSync(versionFile, 'utf8').trim() : '?'
 
-  console.log(`\n⚡ Pulse UI updated to ${version}\n`)
-  for (const f of updated) console.log(`  ✓ public/${f}`)
+  console.log(`\n⚡ Pulse updated to ${version}\n`)
+  for (const f of updated) console.log(`  ✓ ${f}`)
   for (const f of missing) console.log(`  ✗ ${f} not found in package`)
   console.log()
 }

package/src/cli/scaffold.js

@@ -85,6 +85,14 @@ ${port !== 3000 ? `  port: ${port},\n` : ''}}
   // CLAUDE.md — in .claude/ so it's alongside Claude Code's own config, not cluttering the project root
   write(targetDir, '.claude/CLAUDE.md', claudeMd(name))
 
+  // Slash commands — copied from src/agent/commands/ so scaffold and dev sync stay in lock-step
+  const commandsSrc = new URL('../agent/commands', import.meta.url).pathname
+  if (fs.existsSync(commandsSrc)) {
+    for (const file of fs.readdirSync(commandsSrc).filter(f => f.endsWith('.md'))) {
+      write(targetDir, `.claude/commands/${file}`, fs.readFileSync(path.join(commandsSrc, file), 'utf8'))
+    }
+  }
+
   // settings.json — hooks that enforce correct agent behaviour
   write(targetDir, '.claude/settings.json', JSON.stringify({
     hooks: {
@@ -408,3 +416,4 @@ function write(dir, relPath, content) {
   fs.mkdirSync(path.dirname(filePath), { recursive: true })
   fs.writeFileSync(filePath, content, 'utf8')
 }
+