@invisibleloop/pulse 0.2.9 → 0.2.11

package/docs/src/pages/getting-started.js

@@ -78,7 +78,12 @@ Validate the email format before submitting."`, 'bash'))}
 ├── .claude/
 │   ├── CLAUDE.md            ← session instructions Claude reads on startup
 │   ├── settings.json        ← hooks: syntax checks, colour guards, package blocklist
-│   └── pulse-checklist.md   ← spec review checklist, kept in sync by Pulse
+│   ├── pulse-checklist.md   ← spec review checklist, kept in sync by Pulse
+│   └── commands/            ← slash commands available inside Claude
+│       ├── pulse-dev.md
+│       ├── pulse-stop.md
+│       ├── pulse-build.md
+│       └── pulse-start.md
 ├── package.json
 └── pulse.config.js          ← port and project settings`, 'bash'))}
       <p><code>src/pages/home.js</code> is a complete working spec — a counter with increment and decrement buttons. Open <a href="http://localhost:3000">localhost:3000</a> after running <code>/pulse-dev</code> to see it. Every new page you create goes into <code>src/pages/</code> and is discovered automatically.</p>
@@ -93,6 +98,18 @@ Validate the email format before submitting."`, 'bash'))}
 /pulse-report  # Lighthouse audit + performance report`, 'bash'))}
       <p>You can also skip the commands entirely — just describe what you want and the agent handles the rest, including starting the dev server when needed.</p>
 
+      ${section('update', 'Keeping up to date')}
+      <p>When a new version of Pulse is released, update the package and then run <code>pulse update</code> from your project root:</p>
+      ${codeBlock(highlight(`npm update @invisibleloop/pulse
+pulse update`, 'bash'))}
+      <p><code>pulse update</code> copies the latest UI assets and agent files into your project:</p>
+      <ul>
+        <li><code>public/pulse-ui.css</code> and <code>public/pulse-ui.js</code> — component library styles and behaviour</li>
+        <li><code>.claude/pulse-checklist.md</code> — spec review checklist</li>
+        <li><code>.claude/commands/</code> — slash commands</li>
+      </ul>
+      <p>Your own source files, <code>CLAUDE.md</code>, and <code>pulse.config.js</code> are never touched.</p>
+
       ${section('next-steps', 'Next steps')}
       <ul>
         <li><a href="/how-it-works">How It Works</a> — the MCP server, what the agent knows, and the full build cycle</li>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invisibleloop/pulse",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "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.9
+0.2.11

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')
 }
+