motif-design 0.2.0 → 0.2.2

package/bin/install.js

@@ -362,8 +362,9 @@ function writeManifest(mapping, copyResult, flags) {
 
   const cwd = process.cwd();
   const pkgDir = path.dirname(__dirname);
+  const pkgJson = JSON.parse(fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf8'));
   const manifest = {
-    version: '0.1.0',
+    version: pkgJson.version,
     runtime: 'claude-code',
     installedAt: new Date().toISOString(),
     files: {},
@@ -700,6 +701,10 @@ if (flags.uninstall) {
 const runtime = detectRuntime(flags);
 const mapping = resolveMapping(runtime);
 
+// Read current package version
+const pkgDir = path.dirname(__dirname);
+const currentVersion = JSON.parse(fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf8')).version;
+
 // Load existing manifest for upgrade tracking (re-install detection)
 const manifestPath = path.join(process.cwd(), '.motif-manifest.json');
 let existingManifest = null;
@@ -712,6 +717,22 @@ if (fs.existsSync(manifestPath)) {
   }
 }
 
+// Detect install type: fresh install vs upgrade vs re-install
+if (existingManifest) {
+  const prevVersion = existingManifest.version;
+  if (prevVersion !== currentVersion) {
+    console.log('');
+    console.log(styleText('cyan', `Upgrading Motif: ${prevVersion} → ${currentVersion}`));
+    console.log('Modified files will be backed up to .motif-backup/');
+  } else {
+    console.log('');
+    console.log(styleText('cyan', `Re-installing Motif v${currentVersion}`));
+  }
+} else {
+  console.log('');
+  console.log(styleText('cyan', `Installing Motif v${currentVersion}`));
+}
+
 const copyResult = copyFiles(mapping, existingManifest, flags);
 const injectResult = injectConfig(mapping, flags);
 injectHookSettings(mapping, flags);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "motif-design",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Domain-intelligent design system for AI coding assistants",
   "bin": {
     "motif": "bin/install.js"

package/runtimes/claude-code/commands/motif/help.md

@@ -17,8 +17,9 @@ description: Show all Motif commands
 | `/motif:evolve` | Update design system based on learnings |
 | `/motif:quick [desc]` | Ad-hoc task with design system consistency |
 
-## Navigation
-| `/motif:progress` | Current status + next steps |
+## Navigation & Maintenance
+| `/motif:progress` | Current status + next steps + version check |
+| `/motif:update` | Check for and apply Motif updates |
 | `/motif:help` | This reference |
 
 ## Typical flow

package/runtimes/claude-code/commands/motif/progress.md

@@ -1,6 +1,27 @@
 ---
 description: Show current Motif project status and next steps
+allowed-tools: Read, Bash(node:*)
 ---
+
+# /motif:progress — Project Status
+
+## Step 1: Version check
+
+Run:
+```bash
+node .claude/get-motif/scripts/check-version.js
+```
+
+Parse the JSON output. If `updateAvailable` is true, display at the top:
+
+```
+⬆ Motif update available: [installed] → [latest]. Run /motif:update to upgrade.
+```
+
+If the check fails or latest is unknown, just show the installed version silently.
+
+## Step 2: Project status
+
 Read `.planning/design/STATE.md` and display:
 1. Current phase
 2. Screen status table
@@ -9,3 +30,10 @@ Read `.planning/design/STATE.md` and display:
 5. Recommended next command
 
 If STATE.md doesn't exist: "No project initialized. Run /motif:init."
+
+## Step 3: Footer
+
+Always show at the bottom:
+```
+Motif v[installed] | /motif:help for commands
+```

package/runtimes/claude-code/commands/motif/update.md

@@ -0,0 +1,67 @@
+---
+description: Check for and apply Motif updates
+allowed-tools: Read, Bash(node:*), Bash(npx:*)
+---
+
+# /motif:update — Update Motif
+
+You are the Motif updater. Check for new versions and apply updates.
+
+## Step 1: Check current version
+
+Run:
+```bash
+node .claude/get-motif/scripts/check-version.js
+```
+
+Parse the JSON output.
+
+## Step 2: Report status
+
+**If `updateAvailable` is true:**
+
+Display:
+```
+Motif update available: [installed] → [latest]
+
+Updating now...
+```
+
+Then run:
+```bash
+npx motif-design@latest
+```
+
+After it completes, display:
+```
+Motif updated to [latest]. Your modified files were backed up to .motif-backup/.
+```
+
+**If `updateAvailable` is false and `latest` is not `"unknown"`:**
+
+Display:
+```
+Motif v[installed] is up to date.
+```
+
+**If `latest` is `"unknown"` (network error):**
+
+Display:
+```
+Motif v[installed] installed. Could not check for updates (offline or npm registry unavailable).
+
+To update manually: npx motif-design@latest
+```
+
+## Step 3: Show what changed (if updated)
+
+After a successful update, read the new `.motif-manifest.json` and compare with the previous version. Show:
+- New version number
+- Number of files updated
+- Reminder to review any files in `.motif-backup/` if the user had customizations
+
+## Rules
+
+1. **Never force-install.** Always run without `--force` so user modifications get backed up.
+2. **Be transparent.** Show what version is installed and what's available before acting.
+3. **Handle offline gracefully.** Users may not have network access.

package/scripts/check-version.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Checks if a newer version of motif-design is available on npm.
+ * Outputs JSON: { "installed": "0.2.0", "latest": "0.3.0", "updateAvailable": true }
+ * Exits 0 on success, 1 on error (prints error JSON).
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+const https = require('node:https');
+
+function getInstalledVersion() {
+  const manifestPath = path.join(process.cwd(), '.motif-manifest.json');
+  if (!fs.existsSync(manifestPath)) return null;
+
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    return manifest.version || null;
+  } catch {
+    return null;
+  }
+}
+
+function fetchLatestVersion() {
+  return new Promise((resolve, reject) => {
+    const req = https.get('https://registry.npmjs.org/motif-design/latest', {
+      headers: { 'Accept': 'application/json' },
+      timeout: 5000,
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => { data += chunk; });
+      res.on('end', () => {
+        try {
+          const pkg = JSON.parse(data);
+          resolve(pkg.version || null);
+        } catch {
+          reject(new Error('Failed to parse npm registry response'));
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new Error('npm registry request timed out'));
+    });
+  });
+}
+
+function compareVersions(a, b) {
+  const pa = a.split('.').map(Number);
+  const pb = b.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) < (pb[i] || 0)) return -1;
+    if ((pa[i] || 0) > (pb[i] || 0)) return 1;
+  }
+  return 0;
+}
+
+async function main() {
+  const installed = getInstalledVersion();
+
+  if (!installed) {
+    console.log(JSON.stringify({ error: 'No Motif installation found' }));
+    process.exit(1);
+  }
+
+  try {
+    const latest = await fetchLatestVersion();
+    const updateAvailable = latest ? compareVersions(installed, latest) < 0 : false;
+
+    console.log(JSON.stringify({
+      installed,
+      latest: latest || 'unknown',
+      updateAvailable,
+    }));
+  } catch (err) {
+    // Network failure is non-fatal — report installed version
+    console.log(JSON.stringify({
+      installed,
+      latest: 'unknown',
+      updateAvailable: false,
+      warning: err.message,
+    }));
+  }
+}
+
+main();