create-pmos 0.229.0 → 0.230.0

package/install.ps1

@@ -6,8 +6,9 @@
 #   1. Node.js   latest LTS from nodejs.org, into %LOCALAPPDATA%\PMOS\node
 #   2. git       the official Portable Git, into %LOCALAPPDATA%\PMOS\git (Claude Code needs its bash)
 #   3. Claude Code   its own installer, claude.ai/install.ps1
-#   4. the PMOS kit in %USERPROFILE%\PMOS   (npx create-pmos)
-#   5. the PMOS app   (npx create-pmos workspace), which opens in the browser
+#   4. the newest PMOS release that npm can download (a release a few minutes old may not download yet)
+#   5. the PMOS kit in %USERPROFILE%\PMOS   (npx create-pmos)
+#   6. the PMOS app   (npx create-pmos workspace), which opens in the browser
 # Every step checks first and skips what is already there, so running the line again is safe.
 #
 # Settings (environment variables):
@@ -23,6 +24,7 @@ $ProgressPreference = 'SilentlyContinue'   # Invoke-WebRequest is many times slo
 $PmosHome = Join-Path $env:LOCALAPPDATA 'PMOS'
 $PmosDir = if ($env:PMOS_DIR) { $env:PMOS_DIR } else { Join-Path $env:USERPROFILE 'PMOS' }
 $PmosPkg = if ($env:PMOS_PKG) { $env:PMOS_PKG } else { 'create-pmos@latest' }
+$PmosPkgGiven = [bool]$env:PMOS_PKG
 $NodeMin = 18
 
 function Say($m) { Write-Host "==> $m" -ForegroundColor Cyan }
@@ -147,7 +149,42 @@ if ($env:PMOS_SKIP_CLAUDE -eq '1') {
   else { Fail 'Claude Code did not install.' 'run: irm https://claude.ai/install.ps1 | iex   then paste the line again' }
 }
 
-# --- 4. The PMOS folder and kit ---
+# --- 4. The PMOS release ---
+# For a few minutes after a release, npm can name it as the newest while its download servers do not
+# have it yet ("No matching version found"). Ask for the newest release first and step back to the ones
+# before it until one downloads, then use that same release for the kit and for the app.
+function Get-PmosRelease($spec) {
+  # npm writes its warnings to stderr; with 'Stop', Windows PowerShell would turn them into a thrown error.
+  $old = $ErrorActionPreference; $ErrorActionPreference = 'Continue'
+  try { $out = (& npx.cmd -y -p $spec create-pmos --version 2>$null) -join "`n"; $code = $LASTEXITCODE }
+  catch { $out = ''; $code = 1 }
+  finally { $ErrorActionPreference = $old }
+  if ($code -eq 0 -and $out -match '(?m)^create-pmos (\d+\.\d+\.\d+)') { return $Matches[1] }
+  return $null
+}
+if (-not $PmosPkgGiven) {
+  Say 'Finding the newest PMOS release'
+  # The three newest published releases, newest first (node reads npm's JSON; it is installed by now).
+  $older = ''
+  $old = $ErrorActionPreference; $ErrorActionPreference = 'Continue'
+  try {
+    $json = (& npm.cmd view create-pmos versions --json 2>$null) -join "`n"
+    $older = ($json | & node -e "let s='';process.stdin.on('data',(d)=>{s+=d}).on('end',()=>{try{console.log([].concat(JSON.parse(s.replace(/^\uFEFF/,''))).slice(-3).reverse().join(' '))}catch{}})") -join ' '
+  } catch { $older = '' }
+  finally { $ErrorActionPreference = $old }
+  $tries = @('latest') + @($older -split ' ' | Where-Object { $_ })
+  $picked = $null
+  foreach ($v in $tries) {
+    $picked = Get-PmosRelease "create-pmos@$v"
+    if ($picked) { break }
+    Write-Host "    create-pmos@$v does not download yet; trying the release before it"
+  }
+  if (-not $picked) { Fail 'Could not download PMOS from npm.' 'check the internet connection, then paste the line again' }
+  $PmosPkg = "create-pmos@$picked"
+  Ok "PMOS $picked"
+}
+
+# --- 5. The PMOS folder and kit ---
 Say "Setting up the PMOS folder: $PmosDir"
 New-Item -ItemType Directory -Force -Path $PmosDir | Out-Null
 if (-not (Test-Path (Join-Path $PmosDir '.git'))) {
@@ -162,7 +199,7 @@ if (Test-Path (Join-Path $PmosDir 'pmos\AGENTS.md')) {
   Ok 'PMOS kit added'
 }
 
-# --- 5. The PMOS app ---
+# --- 6. The PMOS app ---
 Say 'Starting the PMOS app'
 & npx.cmd -y -p $PmosPkg create-pmos workspace $PmosDir
 if ($LASTEXITCODE -ne 0) { Fail 'The PMOS app did not start.' 'run: pmos doctor   and send what it prints to your PMOS contact' }

package/install.sh

@@ -7,8 +7,9 @@
 #   1. Node.js (latest LTS from nodejs.org, into ~/.pmos/node; no Homebrew, no admin)
 #   2. git (macOS: Apple's Command Line Tools, one system dialog; Linux: the package manager)
 #   3. Claude Code (its own installer, claude.ai/install.sh)
-#   4. the PMOS kit in ~/PMOS (npx create-pmos)
-#   5. the PMOS app (npx create-pmos workspace), which opens in the browser
+#   4. the newest PMOS release that npm can download (a release a few minutes old may not download yet)
+#   5. the PMOS kit in ~/PMOS (npx create-pmos)
+#   6. the PMOS app (npx create-pmos workspace), which opens in the browser
 # Every step checks first and skips what is already there, so running the line again is safe.
 #
 # Settings (environment variables):
@@ -20,6 +21,7 @@ set -euo pipefail
 
 PMOS_HOME="${PMOS_HOME:-$HOME/.pmos}"
 PMOS_DIR="${PMOS_DIR:-$HOME/PMOS}"
+PMOS_PKG_GIVEN="${PMOS_PKG:-}"
 PMOS_PKG="${PMOS_PKG:-create-pmos@latest}"
 NODE_MIN=18
 MARK="# added by PMOS setup"
@@ -161,7 +163,27 @@ else
   have claude && ok "Claude Code installed" || fail "Claude Code installed, but the claude command is not found." "open a new Terminal window and paste the line again"
 fi
 
-# ── 4. The PMOS folder and kit ──────────────────────────────────────────────────────────────
+# ── 4. The PMOS release ─────────────────────────────────────────────────────────────────────
+# For a few minutes after a release, npm can name it as the newest while its download servers do not
+# have it yet ("No matching version found"). Ask for the newest release first and step back to the ones
+# before it until one downloads, then use that same release for the kit and for the app.
+if [ -z "$PMOS_PKG_GIVEN" ]; then
+  say "Finding the newest PMOS release"
+  older="$(npm view create-pmos versions --json 2>/dev/null \
+    | node -e 'let s="";process.stdin.on("data",(d)=>{s+=d}).on("end",()=>{try{console.log([].concat(JSON.parse(s)).slice(-3).reverse().join(" "))}catch{}})' || true)"
+  picked=""
+  for v in latest $older; do
+    out="$(npx -y -p "create-pmos@$v" create-pmos --version 2>/dev/null || true)"
+    rel="$(printf '%s\n' "$out" | sed -n '/^create-pmos [0-9]/{s/^create-pmos //p;q;}')"
+    if [ -n "$rel" ]; then picked="$rel"; break; fi
+    echo "    create-pmos@$v does not download yet; trying the release before it"
+  done
+  [ -n "$picked" ] || fail "Could not download PMOS from npm." "check the internet connection, then paste the line again"
+  PMOS_PKG="create-pmos@$picked"
+  ok "PMOS $picked"
+fi
+
+# ── 5. The PMOS folder and kit ──────────────────────────────────────────────────────────────
 say "Setting up the PMOS folder: $PMOS_DIR"
 mkdir -p "$PMOS_DIR"
 if [ ! -d "$PMOS_DIR/.git" ] && ! git -C "$PMOS_DIR" rev-parse --git-dir >/dev/null 2>&1; then
@@ -175,7 +197,7 @@ else
   ok "PMOS kit added"
 fi
 
-# ── 5. The PMOS app ─────────────────────────────────────────────────────────────────────────
+# ── 6. The PMOS app ─────────────────────────────────────────────────────────────────────────
 say "Starting the PMOS app"
 npx -y -p "$PMOS_PKG" create-pmos workspace "$PMOS_DIR" || fail "The PMOS app did not start." "run: pmos doctor, and send what it prints to your PMOS contact"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.229.0",
+  "version": "0.230.0",
   "description": "Scaffold the PMOS portable kit — run the PMOS product-management workflow (initiative → lane-fit spec → contract → build → three gates, with work-type lanes for features, research, maintenance, incidents, and content) entirely inside your own repo, with all state as git-versioned files. Includes `workflow-sweep`, which audits the state every board derives from and separates real defects from work you simply have not done. `create-pmos workspace` also installs + launches the local Terminal Workspace GUI. No database, no network, no telemetry.",
   "license": "MIT",
   "bin": {

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@de0d7bf
+kernel-source: pmos@19db06e
 assembled: 2026-10-14
 mode: vendor

package/payload/planning/evals/eval-calibration.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-14T07:38:04Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T07:57:03Z"}
 status: stable
 ---
 

package/payload/planning/okrs/health-budgets.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Health budgets"
 description: "Closed registry of health-budget anchors (D59), edited only by the PM."
-generated: {by: process:create-pmos, at: "2026-10-14T07:38:04Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T07:57:03Z"}
 status: stable
 ---
 

package/payload/state/discoveries.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Discoveries and friction log"
 description: "Append-only record of what runs discovered and where the process rubbed."
-generated: {by: process:create-pmos, at: "2026-10-14T07:38:04Z"}
+generated: {by: process:create-pmos, at: "2026-10-14T07:57:03Z"}
 status: stable
 ---
 

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.229.0",
+  "version": "0.230.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.229.0",
+      "version": "0.230.0",
       "license": "MIT",
       "dependencies": {
         "@xterm/addon-fit": "^0.11.0",

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.229.0",
+  "version": "0.230.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",