warp-os 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -6,6 +6,27 @@ Format: [Semantic Versioning](https://semver.org/). Sections: Added, Changed, Re
 
 ---
 
+## [1.1.2] - 2026-04-05
+
+Session migration for existing users.
+
+### Added
+- **Session migration.** `bin/migrate-sessions.js` imports old `.warp/sessions/*.md` files into claude-mem. Runs automatically during install/upgrade when old session files are detected. Originals archived to `.warp/sessions/migrated-to-claude-mem/`.
+
+---
+
+## [1.1.1] - 2026-04-05
+
+npm installer and upgrade improvements.
+
+### Changed
+- **npm-based install.** `npx warp-os install` replaces symlink-based install.sh. Zero symlinks, works on Windows without Developer Mode.
+- **Upgrade rewrite.** `/warp-upgrade` now runs `npx warp-os@latest install`, patches per-project hooks, checks for stale artifacts from previous versions.
+- **Release skill.** `/warp-release-update` detects package.json/pyproject.toml/Cargo.toml and offers to publish to npm/PyPI/crates.io during deploy phase.
+- **Bootstrap scripts.** get-warp.sh and get-warp.ps1 simplified to check Node.js and run `npx warp-os install`.
+
+---
+
 ## [1.1.0] - 2026-04-05
 
 Persistent cross-session memory via [claude-mem](https://github.com/thedotmack/claude-mem). Automatic observation capture replaces manual session handoffs.

package/VERSION

@@ -1 +1 @@
-1.1.0
+1.1.2

package/agents/warp-release-update.md

@@ -690,7 +690,38 @@ PRE-DEPLOY:
   ☐ Rollback plan documented (see deploy strategy above)
 ```
 
-### 6C. Deploy Execution
+### 6C. Package Registry Publish
+
+Detect if this project publishes to a package registry:
+
+```bash
+# npm / Node.js
+[ -f "package.json" ] && grep -q '"name"' package.json && echo "npm: $(node -e "console.log(require('./package.json').name)")" || true
+# PyPI / Python
+[ -f "pyproject.toml" ] && grep -q 'name' pyproject.toml && echo "pypi: detected" || true
+# Cargo / Rust
+[ -f "Cargo.toml" ] && grep -q 'name' Cargo.toml && echo "crates.io: detected" || true
+```
+
+If a publishable package is detected:
+1. Verify the version in the package file matches the version being released
+2. Confirm with the user: "Publish [name]@[version] to [registry]? [Y/n]"
+3. Publish:
+
+```bash
+# npm
+npm publish --access public
+
+# PyPI
+python -m build && twine upload dist/*
+
+# Cargo
+cargo publish
+```
+
+If publish fails with auth error, guide the user through login/token setup for that registry.
+
+### 6D. Deploy Execution
 
 ```bash
 # Merge the PR (adapt to project workflow)
@@ -712,7 +743,7 @@ DEPLOY STATUS:
   Environment: [staging | production]
 ```
 
-### 6D. Canary Check
+### 6E. Canary Check
 
 Immediately after deploy, verify the deployment is healthy:
 

package/agents/warp-upgrade.md

@@ -1,7 +1,7 @@
 ---
 name: warp-upgrade
 description: >-
-  One-command Warp upgrade from inside Claude Code. Pulls latest, rebuilds, reinstalls, shows changelog, detects migration requirements, and offers to re-run /warp-setup on the current project. No terminal switching needed.
+  One-command Warp upgrade from inside Claude Code. Fetches latest from npm, reinstalls, patches project hooks, shows changelog. No terminal switching needed.
 ---
 
 <!-- ═══════════════════════════════════════════════════════════ -->
@@ -188,112 +188,113 @@ Status values: **DONE**, **DONE_WITH_CONCERNS** (list concerns), **BLOCKED** (st
 
 # Upgrade
 
-Meta skill. Upgrades WarpOS from inside Claude Code — no terminal switching.
-
-**The upgrade is ONE COMMAND.** Do not decompose into manual steps. The upgrade
-script handles pull, build, install, auto-patch, changelog, and migration detection.
+Meta skill. Upgrades Warp from inside Claude Code — no terminal switching.
 
 ---
 
-## STEP 1: Locate the WarpOS Repo
+## STEP 1: Run the Upgrade
+
+**One command. Do not decompose into manual steps.**
 
 ```bash
-WARP_REPO=""
-for candidate in \
-  "$(cat "$HOME/.warp/repo-path" 2>/dev/null)" \
-  "$(readlink -f ~/.claude/skills/warp-setup 2>/dev/null)/../../../.." \
-  "$(dirname "$(readlink -f ~/.warp/hooks/identity-briefing.sh 2>/dev/null)")/../.." \
-  "$HOME/Projects/warp" \
-  "$HOME/warp" \
-; do
-  [ -z "$candidate" ] && continue
-  if [ -d "$candidate/.git" ] && [ -f "$candidate/VERSION" ] && [ -f "$candidate/build.sh" ]; then
-    WARP_REPO="$(cd "$candidate" && pwd)"
-    break
-  fi
-done
-echo "Warp repo: ${WARP_REPO:-NOT FOUND}"
+npx warp-os@latest install
 ```
 
-If not found, ask the user for the path.
+**Timeout:** On Windows, npm fetch + install can take 2-4 minutes. Use a Bash timeout of at least 300000ms (5 minutes).
+
+**If it succeeds:** Read the output, note the version, proceed to Step 2.
+
+**If it fails:**
+- Network error → "Check your connection and try again"
+- Permission error → "Try running from a regular terminal: npx warp-os@latest install"
+- Node.js missing → "Install Node.js 18+ from https://nodejs.org/"
 
 ---
 
-## STEP 2: Run the Upgrade Script
+## STEP 2: Patch Project Hooks
 
-**Run `bin/warp-upgrade.sh` as a single command. Do NOT decompose into manual steps.**
+The npm installer updates global files (~/.claude/skills/, ~/.claude/agents/, ~/.warp/hooks/). But per-project config needs patching too.
 
-The script handles everything: fetch, version check, pull, build, install, auto-patch
-project hooks, changelog display, migration detection, and restart recommendation.
+Check if the current project's hook config is current:
 
 ```bash
-cd "$WARP_REPO" && bash bin/warp-upgrade.sh
+# Check for stale hooks (old hook names that no longer exist)
+grep -c 'lifecycle-session-start\|warp-save\|session-end' .claude/settings.local.json 2>/dev/null && echo "STALE — needs patching" || echo "OK"
 ```
 
-**IMPORTANT — Timeout:** On Windows (Git Bash), build + install can take 2-4 minutes.
-Use a Bash timeout of at least 300000ms (5 minutes). If the default timeout is shorter,
-set it explicitly. A timed-out upgrade leaves a half-installed state.
+If stale, patch it using the canonical template:
 
-**If the script succeeds:** Read its output, summarize what changed, and remind the user
-to restart Claude Code.
+```bash
+node -e "
+  const fs = require('fs');
+  const home = require('os').homedir();
+  const settings = JSON.parse(fs.readFileSync('.claude/settings.local.json', 'utf8'));
+  const template = JSON.parse(fs.readFileSync(home + '/.warp/project-hooks.json', 'utf8'));
+  settings.agent = template.agent;
+  settings.hooks = template.hooks;
+  fs.writeFileSync('.claude/settings.local.json', JSON.stringify(settings, null, 2) + '\n');
+  console.log('Patched.');
+"
+```
 
-**If the script fails:** Read the error output. Common failures:
-- Network error on git pull → "Check your connection and try again"
-- Build error → "build.sh failed — check the error above"
-- Install error (Windows file locks) → "Close other Claude Code instances and retry"
-- Git conflicts → "Your local Warp repo has changes. Run `git stash` first."
+This preserves the project's `permissions` and `enabledMcpjsonServers` while updating `agent` and `hooks` from the template.
 
-Only if the script itself is missing or broken should you fall back to manual steps.
+If `.claude/settings.local.json` doesn't exist → tell user to run `/warp-setup`.
 
 ---
 
-## STEP 3: Verify Auto-Patch (if script completed)
-
-The upgrade script auto-patches `.claude/settings.local.json` in the current project
-directory with the latest hook config from `~/.warp/project-hooks.json`.
+## STEP 3: Verify claude-mem
 
-Verify the patch applied:
+Check if claude-mem is installed (required since v1.1.0):
 
 ```bash
-# Check that settings.local.json references new hook names
-grep -c 'identity-foundation\|identity-briefing\|consistency-check' .claude/settings.local.json 2>/dev/null && echo "hooks patched" || echo "hooks NOT patched"
+npx claude-mem --version 2>/dev/null && echo "claude-mem OK" || echo "claude-mem MISSING"
 ```
 
-If NOT patched (script ran from a different directory, or no settings.local.json):
-- If `settings.local.json` exists but has old hook names → patch it manually using
-  `~/.warp/project-hooks.json` as the source. Preserve `permissions` and `enabledMcpjsonServers`.
-- If no `settings.local.json` → tell user to run `/warp-setup` (first-time setup, not upgrade).
+If missing, install it:
+```bash
+npx claude-mem install
+```
 
 ---
 
-## FALLBACK: Manual Steps (only if warp-upgrade.sh is missing/broken)
+## STEP 4: Show Changelog
 
-If `bin/warp-upgrade.sh` does not exist or crashes on invocation, fall back to manual:
+```bash
+# Show what changed in the new version
+cat CHANGELOG.md 2>/dev/null | head -40 || echo "(CHANGELOG not found locally)"
+```
 
+If CHANGELOG is not in the current directory, check the npm package:
 ```bash
-cd "$WARP_REPO"
-git fetch origin --quiet
-git pull --rebase origin master
-bash build.sh
-bash install.sh
-cat CHANGELOG.md | head -60
+cat "$(npm root -g)/warp-os/CHANGELOG.md" 2>/dev/null | head -40 || echo "(not found)"
 ```
 
-Then manually patch project hooks:
+---
+
+## STEP 5: Migration Checks
+
+After upgrading, check for stale artifacts from previous versions:
+
 ```bash
-# Read template and patch settings.local.json
-python3 -c "
-import json
-t = json.load(open('$HOME/.warp/project-hooks.json'))
-s = json.load(open('.claude/settings.local.json'))
-s['agent'] = t['agent']
-s['hooks'] = t['hooks']
-json.dump(s, open('.claude/settings.local.json','w'), indent=2)
-print('Patched.')
-"
+# Stale session directories (replaced by claude-mem in v1.1.0)
+[ -d ".warp/sessions" ] && echo "STALE: .warp/sessions/ exists (claude-mem handles sessions now)" || echo "OK"
+
+# Stale hook scripts in ~/.warp/hooks/
+for old in lifecycle-session-start.sh lifecycle-session-end.sh lifecycle-pre-compact.sh; do
+  [ -f "$HOME/.warp/hooks/$old" ] && echo "STALE: ~/.warp/hooks/$old"
+done
+
+# Stale skill symlinks (replaced by file copies in v1.1.0)
+for skill in ~/.claude/skills/warp-*/; do
+  [ -L "$skill" ] && echo "STALE SYMLINK: $skill (should be a directory, not a symlink)"
+done
 ```
 
-**This fallback exists for emergencies only.** The script is the primary path.
+If stale items found, offer to clean them:
+- Stale .warp/sessions/ → "These are old session handoffs. claude-mem now handles session memory. Safe to delete? [Y/n]"
+- Stale hook scripts → delete automatically (installer should have cleaned these)
+- Stale symlinks → re-run `npx warp-os install` to replace with file copies
 
 ---
 
@@ -303,13 +304,14 @@ print('Patched.')
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 WARP │ UPGRADE
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  Repo:      {path}
-  Upgrade:   v{old} → v{new}
+  Upgraded: v{old} → v{new}
 
-  {changelog excerpt — Added/Changed/Removed}
+  {changelog excerpt}
 
-  Hooks:     auto-patched ✓
-  Restart:   required (new hooks + skills)
+  Hooks:     patched ✓
+  claude-mem: installed ✓
+  Stale:     {N items cleaned / none}
+  Restart:   required
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -320,15 +322,15 @@ WARP │ UPGRADE
 ## MUST / MUST NOT
 
 **MUST:**
-- Run `bin/warp-upgrade.sh` as a single command (not decomposed steps)
-- Use a 5-minute timeout for the upgrade script on Windows
-- Verify hooks auto-patched after script completes
+- Run `npx warp-os@latest install` as the primary upgrade command
+- Patch per-project settings.local.json with latest hooks
+- Check for and offer to clean stale artifacts
+- Verify claude-mem is installed
 - Show changelog summary
 - Remind user to restart Claude Code
 
 **MUST NOT:**
-- Decompose the upgrade into individual git/build/install commands when the script works
-- Use default Bash timeout (2 minutes is too short on Windows)
-- Proceed to install if build fails
-- Require the user to re-run `/warp-setup` after a normal upgrade
-- Force-push, reset, or destructively modify the Warp repo without consent
+- Use git clone/pull to upgrade (npm handles distribution now)
+- Skip the per-project hook patch
+- Delete .warp/sessions/ without asking (user may want the archives)
+- Require the user to re-run `/warp-setup` after a normal upgrade (hook patching should suffice)

package/bin/install.js

@@ -280,7 +280,35 @@ try {
   info('Install manually: npx claude-mem install');
 }
 
-// ── Step 6: Version Tracking ─────────────────────────────────────────────────
+// ── Step 6: Migrate old session files to claude-mem ──────────────────────────
+
+// Check if this is running inside a project with old .warp/sessions/ files
+const projectSessionsDir = path.join(process.cwd(), '.warp', 'sessions');
+if (fs.existsSync(projectSessionsDir)) {
+  const sessionFiles = fs.readdirSync(projectSessionsDir)
+    .filter(f => f.endsWith('.md') && f.startsWith('SESSION_'));
+
+  if (sessionFiles.length > 0) {
+    console.log('');
+    console.log(`Migrating ${sessionFiles.length} session file(s) to claude-mem...`);
+    const migrationScript = path.join(REPO_ROOT, 'bin', 'migrate-sessions.js');
+    if (fs.existsSync(migrationScript)) {
+      try {
+        execSync(`node "${migrationScript}" "${process.cwd()}"`, {
+          stdio: 'inherit',
+          timeout: 60000
+        });
+      } catch {
+        warn('Session migration failed — files left in place. Run manually: node bin/migrate-sessions.js');
+      }
+    } else {
+      info(`Found ${sessionFiles.length} old session files in .warp/sessions/`);
+      info('claude-mem will capture new sessions automatically. Old files preserved.');
+    }
+  }
+}
+
+// ── Step 7: Version Tracking ────────────────────────────────────────────────
 
 console.log('');
 console.log('Writing version...');

package/bin/migrate-sessions.js

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+// migrate-sessions.js — Import old .warp/sessions/*.md into claude-mem
+// Run once during upgrade. Reads markdown session handoffs, posts them
+// to claude-mem's worker API as observations, then archives originals.
+
+const fs = require('fs');
+const path = require('path');
+const http = require('http');
+
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const CYAN = '\x1b[36m';
+const NC = '\x1b[0m';
+
+function ok(msg) { console.log(`  ${GREEN}OK${NC}    ${msg}`); }
+function warn(msg) { console.log(`  ${YELLOW}WARN${NC}  ${msg}`); }
+function info(msg) { console.log(`  ${CYAN}INFO${NC}  ${msg}`); }
+
+// ── Find session files ───────────────────────────────────────────────────────
+
+const cwd = process.argv[2] || process.cwd();
+const sessionsDir = path.join(cwd, '.warp', 'sessions');
+const archiveDir = path.join(sessionsDir, 'archive');
+
+if (!fs.existsSync(sessionsDir)) {
+  console.log('No .warp/sessions/ directory found. Nothing to migrate.');
+  process.exit(0);
+}
+
+// Gather all session files (active + archived)
+const sessionFiles = [];
+
+for (const file of fs.readdirSync(sessionsDir)) {
+  if (file.endsWith('.md') && file.startsWith('SESSION_')) {
+    sessionFiles.push(path.join(sessionsDir, file));
+  }
+}
+
+if (fs.existsSync(archiveDir)) {
+  for (const file of fs.readdirSync(archiveDir)) {
+    if (file.endsWith('.md') && file.startsWith('SESSION_')) {
+      sessionFiles.push(path.join(archiveDir, file));
+    }
+  }
+}
+
+if (sessionFiles.length === 0) {
+  console.log('No session files found to migrate.');
+  process.exit(0);
+}
+
+console.log(`Found ${sessionFiles.length} session file(s) to migrate.`);
+
+// ── Check if claude-mem worker is running ────────────────────────────────────
+
+function httpPost(urlPath, data) {
+  return new Promise((resolve, reject) => {
+    const body = JSON.stringify(data);
+    const req = http.request({
+      hostname: '127.0.0.1',
+      port: 37777,
+      path: urlPath,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body)
+      },
+      timeout: 10000
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => resolve({ status: res.statusCode, body: data }));
+    });
+    req.on('error', reject);
+    req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+    req.write(body);
+    req.end();
+  });
+}
+
+function httpGet(urlPath) {
+  return new Promise((resolve, reject) => {
+    const req = http.request({
+      hostname: '127.0.0.1',
+      port: 37777,
+      path: urlPath,
+      method: 'GET',
+      timeout: 5000
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => resolve({ status: res.statusCode, body: data }));
+    });
+    req.on('error', reject);
+    req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+    req.end();
+  });
+}
+
+// ── Parse session file ───────────────────────────────────────────────────────
+
+function parseSessionFile(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const filename = path.basename(filePath, '.md');
+
+  // Extract session metadata from filename: SESSION_CC7_20260404
+  const match = filename.match(/SESSION_CC(\d+)_(\d{8})/);
+  const sessionNum = match ? `CC${match[1]}` : filename;
+  const dateStr = match ? `${match[2].slice(0,4)}-${match[2].slice(4,6)}-${match[2].slice(6,8)}` : 'unknown';
+
+  // Extract sections
+  const sections = {};
+  let currentSection = 'header';
+  sections[currentSection] = [];
+
+  for (const line of content.split('\n')) {
+    if (line.startsWith('## ')) {
+      currentSection = line.replace('## ', '').trim();
+      sections[currentSection] = [];
+    } else {
+      if (!sections[currentSection]) sections[currentSection] = [];
+      sections[currentSection].push(line);
+    }
+  }
+
+  // Extract goal from header
+  const goalLine = content.match(/Goal:\s+(.+)/);
+  const goal = goalLine ? goalLine[1].trim() : `Session ${sessionNum}`;
+
+  return {
+    filename,
+    sessionNum,
+    dateStr,
+    goal,
+    content,
+    sections,
+    keyDecisions: (sections['Key Decisions'] || []).filter(l => l.trim().startsWith('-')).map(l => l.trim().replace(/^- /, '')),
+    itemsAchieved: (sections['Items Achieved'] || []).filter(l => l.trim().startsWith('-')).map(l => l.trim().replace(/^- /, '')),
+    itemsNotDone: (sections['Items Not Done'] || []).filter(l => l.trim().startsWith('-')).map(l => l.trim().replace(/^- /, '')),
+    nextPickup: (sections['Next Pickup Point'] || []).join('\n').trim(),
+    filesProduced: (sections['Files Produced'] || []).filter(l => l.trim().startsWith('-')).map(l => l.trim().replace(/^- /, '')),
+    filesAmended: (sections['Files Amended'] || []).filter(l => l.trim().startsWith('-')).map(l => l.trim().replace(/^- /, '')),
+  };
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  // Check worker health
+  try {
+    const health = await httpGet('/health');
+    if (health.status !== 200) {
+      warn('claude-mem worker not healthy. Start it with: npx claude-mem start');
+      process.exit(1);
+    }
+  } catch {
+    warn('claude-mem worker not running. Start it with: npx claude-mem start');
+    info('Migration will run on next upgrade after worker is available.');
+    process.exit(0);
+  }
+
+  const projectName = path.basename(cwd);
+  let migrated = 0;
+  let failed = 0;
+
+  for (const file of sessionFiles) {
+    const session = parseSessionFile(file);
+
+    // Build a narrative for claude-mem from the session handoff
+    const narrative = [
+      `Session ${session.sessionNum} (${session.dateStr}): ${session.goal}`,
+      '',
+      session.keyDecisions.length > 0 ? `Key Decisions:\n${session.keyDecisions.map(d => `  - ${d}`).join('\n')}` : '',
+      session.itemsAchieved.length > 0 ? `Completed:\n${session.itemsAchieved.map(d => `  - ${d}`).join('\n')}` : '',
+      session.itemsNotDone.length > 0 ? `Not Done:\n${session.itemsNotDone.map(d => `  - ${d}`).join('\n')}` : '',
+      session.nextPickup ? `Next Pickup: ${session.nextPickup}` : '',
+      session.filesProduced.length > 0 ? `Files Produced:\n${session.filesProduced.map(d => `  - ${d}`).join('\n')}` : '',
+      session.filesAmended.length > 0 ? `Files Amended:\n${session.filesAmended.map(d => `  - ${d}`).join('\n')}` : '',
+    ].filter(Boolean).join('\n\n');
+
+    try {
+      // Post as an observation to claude-mem
+      const result = await httpPost('/api/sessions/observations', {
+        contentSessionId: `warp-migration-${session.sessionNum}`,
+        project: projectName,
+        tool_name: 'warp-session-migration',
+        tool_input: {
+          session: session.sessionNum,
+          date: session.dateStr,
+          goal: session.goal
+        },
+        tool_output: {
+          narrative: narrative,
+          keyDecisions: session.keyDecisions,
+          itemsAchieved: session.itemsAchieved,
+          filesAmended: session.filesAmended,
+          nextPickup: session.nextPickup
+        }
+      });
+
+      if (result.status >= 200 && result.status < 300) {
+        ok(`${session.filename} → claude-mem (${session.keyDecisions.length} decisions, ${session.itemsAchieved.length} items)`);
+        migrated++;
+      } else {
+        // If the observation API doesn't accept this format, try the raw session init
+        const initResult = await httpPost('/api/sessions/init', {
+          contentSessionId: `warp-migration-${session.sessionNum}`,
+          project: projectName,
+          userPrompt: `[Migrated from ${session.filename}] ${session.goal}\n\n${narrative}`
+        });
+
+        if (initResult.status >= 200 && initResult.status < 300) {
+          ok(`${session.filename} → claude-mem (via session init)`);
+          migrated++;
+        } else {
+          warn(`${session.filename} — API returned ${result.status}`);
+          failed++;
+        }
+      }
+    } catch (err) {
+      warn(`${session.filename} — ${err.message}`);
+      failed++;
+    }
+  }
+
+  // Archive migrated files
+  if (migrated > 0) {
+    const migratedDir = path.join(sessionsDir, 'migrated-to-claude-mem');
+    fs.mkdirSync(migratedDir, { recursive: true });
+
+    for (const file of sessionFiles) {
+      const basename = path.basename(file);
+      const dest = path.join(migratedDir, basename);
+      try {
+        fs.copyFileSync(file, dest);
+        fs.unlinkSync(file);
+      } catch {
+        // File might already be in archive subdir, just leave it
+      }
+    }
+    ok(`Archived ${migrated} session file(s) → .warp/sessions/migrated-to-claude-mem/`);
+  }
+
+  console.log('');
+  console.log(`Migration: ${GREEN}${migrated}${NC} imported, ${YELLOW}${failed}${NC} failed`);
+  if (failed > 0) {
+    info('Failed files left in place. Re-run migration after fixing claude-mem worker.');
+  }
+}
+
+main().catch(err => {
+  warn(`Migration error: ${err.message}`);
+  process.exit(1);
+});

package/dist/warp-release-update/SKILL.md

@@ -712,7 +712,38 @@ PRE-DEPLOY:
   ☐ Rollback plan documented (see deploy strategy above)
 ```
 
-### 6C. Deploy Execution
+### 6C. Package Registry Publish
+
+Detect if this project publishes to a package registry:
+
+```bash
+# npm / Node.js
+[ -f "package.json" ] && grep -q '"name"' package.json && echo "npm: $(node -e "console.log(require('./package.json').name)")" || true
+# PyPI / Python
+[ -f "pyproject.toml" ] && grep -q 'name' pyproject.toml && echo "pypi: detected" || true
+# Cargo / Rust
+[ -f "Cargo.toml" ] && grep -q 'name' Cargo.toml && echo "crates.io: detected" || true
+```
+
+If a publishable package is detected:
+1. Verify the version in the package file matches the version being released
+2. Confirm with the user: "Publish [name]@[version] to [registry]? [Y/n]"
+3. Publish:
+
+```bash
+# npm
+npm publish --access public
+
+# PyPI
+python -m build && twine upload dist/*
+
+# Cargo
+cargo publish
+```
+
+If publish fails with auth error, guide the user through login/token setup for that registry.
+
+### 6D. Deploy Execution
 
 ```bash
 # Merge the PR (adapt to project workflow)
@@ -734,7 +765,7 @@ DEPLOY STATUS:
   Environment: [staging | production]
 ```
 
-### 6D. Canary Check
+### 6E. Canary Check
 
 Immediately after deploy, verify the deployment is healthy:
 

package/dist/warp-upgrade/SKILL.md

@@ -1,10 +1,8 @@
 ---
 name: warp-upgrade
 description: >
-  One-command Warp upgrade from inside Claude Code. Pulls latest,
-  rebuilds, reinstalls, shows changelog, detects migration requirements,
-  and offers to re-run /warp-setup on the current project. No terminal
-  switching needed.
+  One-command Warp upgrade from inside Claude Code. Fetches latest from npm,
+  reinstalls, patches project hooks, shows changelog. No terminal switching needed.
 triggers:
   - /warp-upgrade
   - /upgrade
@@ -199,112 +197,113 @@ Status values: **DONE**, **DONE_WITH_CONCERNS** (list concerns), **BLOCKED** (st
 
 # Upgrade
 
-Meta skill. Upgrades WarpOS from inside Claude Code — no terminal switching.
-
-**The upgrade is ONE COMMAND.** Do not decompose into manual steps. The upgrade
-script handles pull, build, install, auto-patch, changelog, and migration detection.
+Meta skill. Upgrades Warp from inside Claude Code — no terminal switching.
 
 ---
 
-## STEP 1: Locate the WarpOS Repo
+## STEP 1: Run the Upgrade
+
+**One command. Do not decompose into manual steps.**
 
 ```bash
-WARP_REPO=""
-for candidate in \
-  "$(cat "$HOME/.warp/repo-path" 2>/dev/null)" \
-  "$(readlink -f ~/.claude/skills/warp-setup 2>/dev/null)/../../../.." \
-  "$(dirname "$(readlink -f ~/.warp/hooks/identity-briefing.sh 2>/dev/null)")/../.." \
-  "$HOME/Projects/warp" \
-  "$HOME/warp" \
-; do
-  [ -z "$candidate" ] && continue
-  if [ -d "$candidate/.git" ] && [ -f "$candidate/VERSION" ] && [ -f "$candidate/build.sh" ]; then
-    WARP_REPO="$(cd "$candidate" && pwd)"
-    break
-  fi
-done
-echo "Warp repo: ${WARP_REPO:-NOT FOUND}"
+npx warp-os@latest install
 ```
 
-If not found, ask the user for the path.
+**Timeout:** On Windows, npm fetch + install can take 2-4 minutes. Use a Bash timeout of at least 300000ms (5 minutes).
+
+**If it succeeds:** Read the output, note the version, proceed to Step 2.
+
+**If it fails:**
+- Network error → "Check your connection and try again"
+- Permission error → "Try running from a regular terminal: npx warp-os@latest install"
+- Node.js missing → "Install Node.js 18+ from https://nodejs.org/"
 
 ---
 
-## STEP 2: Run the Upgrade Script
+## STEP 2: Patch Project Hooks
 
-**Run `bin/warp-upgrade.sh` as a single command. Do NOT decompose into manual steps.**
+The npm installer updates global files (~/.claude/skills/, ~/.claude/agents/, ~/.warp/hooks/). But per-project config needs patching too.
 
-The script handles everything: fetch, version check, pull, build, install, auto-patch
-project hooks, changelog display, migration detection, and restart recommendation.
+Check if the current project's hook config is current:
 
 ```bash
-cd "$WARP_REPO" && bash bin/warp-upgrade.sh
+# Check for stale hooks (old hook names that no longer exist)
+grep -c 'lifecycle-session-start\|warp-save\|session-end' .claude/settings.local.json 2>/dev/null && echo "STALE — needs patching" || echo "OK"
 ```
 
-**IMPORTANT — Timeout:** On Windows (Git Bash), build + install can take 2-4 minutes.
-Use a Bash timeout of at least 300000ms (5 minutes). If the default timeout is shorter,
-set it explicitly. A timed-out upgrade leaves a half-installed state.
+If stale, patch it using the canonical template:
 
-**If the script succeeds:** Read its output, summarize what changed, and remind the user
-to restart Claude Code.
+```bash
+node -e "
+  const fs = require('fs');
+  const home = require('os').homedir();
+  const settings = JSON.parse(fs.readFileSync('.claude/settings.local.json', 'utf8'));
+  const template = JSON.parse(fs.readFileSync(home + '/.warp/project-hooks.json', 'utf8'));
+  settings.agent = template.agent;
+  settings.hooks = template.hooks;
+  fs.writeFileSync('.claude/settings.local.json', JSON.stringify(settings, null, 2) + '\n');
+  console.log('Patched.');
+"
+```
 
-**If the script fails:** Read the error output. Common failures:
-- Network error on git pull → "Check your connection and try again"
-- Build error → "build.sh failed — check the error above"
-- Install error (Windows file locks) → "Close other Claude Code instances and retry"
-- Git conflicts → "Your local Warp repo has changes. Run `git stash` first."
+This preserves the project's `permissions` and `enabledMcpjsonServers` while updating `agent` and `hooks` from the template.
 
-Only if the script itself is missing or broken should you fall back to manual steps.
+If `.claude/settings.local.json` doesn't exist → tell user to run `/warp-setup`.
 
 ---
 
-## STEP 3: Verify Auto-Patch (if script completed)
-
-The upgrade script auto-patches `.claude/settings.local.json` in the current project
-directory with the latest hook config from `~/.warp/project-hooks.json`.
+## STEP 3: Verify claude-mem
 
-Verify the patch applied:
+Check if claude-mem is installed (required since v1.1.0):
 
 ```bash
-# Check that settings.local.json references new hook names
-grep -c 'identity-foundation\|identity-briefing\|consistency-check' .claude/settings.local.json 2>/dev/null && echo "hooks patched" || echo "hooks NOT patched"
+npx claude-mem --version 2>/dev/null && echo "claude-mem OK" || echo "claude-mem MISSING"
 ```
 
-If NOT patched (script ran from a different directory, or no settings.local.json):
-- If `settings.local.json` exists but has old hook names → patch it manually using
-  `~/.warp/project-hooks.json` as the source. Preserve `permissions` and `enabledMcpjsonServers`.
-- If no `settings.local.json` → tell user to run `/warp-setup` (first-time setup, not upgrade).
+If missing, install it:
+```bash
+npx claude-mem install
+```
 
 ---
 
-## FALLBACK: Manual Steps (only if warp-upgrade.sh is missing/broken)
+## STEP 4: Show Changelog
 
-If `bin/warp-upgrade.sh` does not exist or crashes on invocation, fall back to manual:
+```bash
+# Show what changed in the new version
+cat CHANGELOG.md 2>/dev/null | head -40 || echo "(CHANGELOG not found locally)"
+```
 
+If CHANGELOG is not in the current directory, check the npm package:
 ```bash
-cd "$WARP_REPO"
-git fetch origin --quiet
-git pull --rebase origin master
-bash build.sh
-bash install.sh
-cat CHANGELOG.md | head -60
+cat "$(npm root -g)/warp-os/CHANGELOG.md" 2>/dev/null | head -40 || echo "(not found)"
 ```
 
-Then manually patch project hooks:
+---
+
+## STEP 5: Migration Checks
+
+After upgrading, check for stale artifacts from previous versions:
+
 ```bash
-# Read template and patch settings.local.json
-python3 -c "
-import json
-t = json.load(open('$HOME/.warp/project-hooks.json'))
-s = json.load(open('.claude/settings.local.json'))
-s['agent'] = t['agent']
-s['hooks'] = t['hooks']
-json.dump(s, open('.claude/settings.local.json','w'), indent=2)
-print('Patched.')
-"
+# Stale session directories (replaced by claude-mem in v1.1.0)
+[ -d ".warp/sessions" ] && echo "STALE: .warp/sessions/ exists (claude-mem handles sessions now)" || echo "OK"
+
+# Stale hook scripts in ~/.warp/hooks/
+for old in lifecycle-session-start.sh lifecycle-session-end.sh lifecycle-pre-compact.sh; do
+  [ -f "$HOME/.warp/hooks/$old" ] && echo "STALE: ~/.warp/hooks/$old"
+done
+
+# Stale skill symlinks (replaced by file copies in v1.1.0)
+for skill in ~/.claude/skills/warp-*/; do
+  [ -L "$skill" ] && echo "STALE SYMLINK: $skill (should be a directory, not a symlink)"
+done
 ```
 
-**This fallback exists for emergencies only.** The script is the primary path.
+If stale items found, offer to clean them:
+- Stale .warp/sessions/ → "These are old session handoffs. claude-mem now handles session memory. Safe to delete? [Y/n]"
+- Stale hook scripts → delete automatically (installer should have cleaned these)
+- Stale symlinks → re-run `npx warp-os install` to replace with file copies
 
 ---
 
@@ -314,13 +313,14 @@ print('Patched.')
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 WARP │ UPGRADE
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  Repo:      {path}
-  Upgrade:   v{old} → v{new}
+  Upgraded: v{old} → v{new}
 
-  {changelog excerpt — Added/Changed/Removed}
+  {changelog excerpt}
 
-  Hooks:     auto-patched ✓
-  Restart:   required (new hooks + skills)
+  Hooks:     patched ✓
+  claude-mem: installed ✓
+  Stale:     {N items cleaned / none}
+  Restart:   required
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -331,15 +331,15 @@ WARP │ UPGRADE
 ## MUST / MUST NOT
 
 **MUST:**
-- Run `bin/warp-upgrade.sh` as a single command (not decomposed steps)
-- Use a 5-minute timeout for the upgrade script on Windows
-- Verify hooks auto-patched after script completes
+- Run `npx warp-os@latest install` as the primary upgrade command
+- Patch per-project settings.local.json with latest hooks
+- Check for and offer to clean stale artifacts
+- Verify claude-mem is installed
 - Show changelog summary
 - Remind user to restart Claude Code
 
 **MUST NOT:**
-- Decompose the upgrade into individual git/build/install commands when the script works
-- Use default Bash timeout (2 minutes is too short on Windows)
-- Proceed to install if build fails
-- Require the user to re-run `/warp-setup` after a normal upgrade
-- Force-push, reset, or destructively modify the Warp repo without consent
+- Use git clone/pull to upgrade (npm handles distribution now)
+- Skip the per-project hook patch
+- Delete .warp/sessions/ without asking (user may want the archives)
+- Require the user to re-run `/warp-setup` after a normal upgrade (hook patching should suffice)

package/package.json

@@ -1,21 +1,22 @@
 {
   "name": "warp-os",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "A development operating system for Claude Code. 16 skills compiled into a pipeline that thinks through every step of building a product.",
   "author": "WolfOnWings",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/WolfOnWings/warp"
+    "url": "git+https://github.com/WolfOnWings/warp.git"
   },
   "bin": {
-    "warp-os": "./bin/cli.js"
+    "warp-os": "bin/cli.js"
   },
   "files": [
     "dist/",
     "agents/",
     "bin/cli.js",
     "bin/install.js",
+    "bin/migrate-sessions.js",
     "bin/hooks/",
     "shared/tier1-engineering-constitution.md",
     "shared/project-hooks.json",