create-pmos 0.154.0 → 0.156.0

package/README.md

@@ -20,6 +20,22 @@ You never need to write code. You need the courage to say what you want, and the
 
 ## Getting started (5 minutes)
 
+**New computer, nothing installed?** Paste one line. It installs what is missing (Node.js, git, Claude Code), makes a `PMOS` folder in your home folder, adds the kit and opens the PMOS app. No Homebrew, no WSL, and no admin password on Windows. Run it again at any time: it skips what is already there.
+
+Mac (Terminal):
+
+```bash
+curl -fsSL https://unpkg.com/create-pmos/install.sh | bash
+```
+
+Windows (PowerShell):
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "iex ((New-Object Net.WebClient).DownloadString('https://unpkg.com/create-pmos/install.ps1'))"
+```
+
+The Mac line also works on Linux. On a Mac without git, Apple's Command Line Tools window opens once: click Install. The first agent session in the app asks you to sign in to Claude.
+
 **Have an existing project?**
 
 ```bash
@@ -98,7 +114,8 @@ Some machines lock down npm's global folder. If the activation prints a warning
 
 ### What to expect
 
-- **Requirements:** Node 18+. macOS, Linux, and Windows. Activation (`create-pmos workspace`) builds `node-pty` once with a C toolchain — most dev machines already have one; `pmos doctor` names the exact fix if not.
+- **Requirements:** Node 18+. macOS, Windows 10 (1809) or later, and Linux; Windows runs natively, with no WSL. On macOS and Windows `node-pty` ships prebuilt; on Linux, activation builds it once with a C toolchain. `pmos doctor` names the exact fix when something is missing. Setup CI runs the one-line setup on clean macOS, Windows and Linux runners.
+- **Not on Windows yet:** `pmos launcher on` (start at login), and meeting-notes transcription (its engine is Apple Silicon only).
 - **It's local and private.** The server binds `127.0.0.1` and is never exposed to the network. Your agent CLI (Claude Code, Codex, a plain shell) runs **untouched** — its own login, slash commands, and keybindings all work; the workspace is the terminal, not a wrapper.
 - **The gates are the same gates.** `approve` / `return` / `accept` in the GUI write the exact file-mode records (`state/acceptances.jsonl`) this kit already uses — only ever on your click. Nothing is recorded automatically.
 - **Works with or without the kit.** Best in a repo you've run `create-pmos` in (it reads and writes `pmos/state/`), but it opens any repo — a plain project just records into the server's own state.

package/bin/cockpit-install.js

@@ -84,7 +84,8 @@ const lstat = (p) => { try { return fs.lstatSync(p); } catch { return null; } };
 const real = (p) => { try { return fs.realpathSync(p); } catch { return null; } };
 
 /**
- * Link `.claude/skills/<name>` to `pmos/skills-native/<name>` for every kit skill that has none.
+ * Link `.claude/skills/<name>` to `pmos/skills-native/<name>` for every kit skill that has none
+ * (a relative symlink; a junction on Windows).
  * @returns {{ linked: string[], ok: string[], blocked: {name:string, reason:string}[], badDescription: string[], errors: string[] }}
  */
 function linkSkills(repoRoot) {
@@ -100,10 +101,14 @@ function linkSkills(repoRoot) {
     if (!descriptionHasText(text)) { out.badDescription.push(e.name); continue; }
 
     const link = path.join(dest, e.name);
-    const target = `../../pmos/skills-native/${e.name}`;
+    // Windows refuses a directory symlink unless Developer Mode is on or the shell is elevated. A
+    // junction needs neither; it takes an absolute target. Everywhere else the link stays relative,
+    // so the repository can move.
+    const target = process.platform === 'win32' ? path.join(native, e.name) : `../../pmos/skills-native/${e.name}`;
+    const type = process.platform === 'win32' ? 'junction' : 'dir';
     const st = lstat(link);
     if (st === null) {
-      try { fs.mkdirSync(dest, { recursive: true }); fs.symlinkSync(target, link, 'dir'); out.linked.push(e.name); }
+      try { fs.mkdirSync(dest, { recursive: true }); fs.symlinkSync(target, link, type); out.linked.push(e.name); }
       catch (err) { out.errors.push(`${e.name}: ${err.message}`); }
       continue;
     }
@@ -113,8 +118,8 @@ function linkSkills(repoRoot) {
       if (r === null) {
         let was = '';
         try { was = fs.readlinkSync(link); } catch { /* keep blocked */ }
-        if (/(^|\/)pmos\/skills-native\//.test(was)) {
-          try { fs.unlinkSync(link); fs.symlinkSync(target, link, 'dir'); out.linked.push(e.name); }
+        if (/(^|[\\/])pmos[\\/]skills-native[\\/]/.test(was)) {
+          try { fs.unlinkSync(link); fs.symlinkSync(target, link, type); out.linked.push(e.name); }
           catch (err) { out.errors.push(`${e.name}: ${err.message}`); }
           continue;
         }

package/install.ps1

@@ -0,0 +1,171 @@
+# PMOS one-line setup for Windows (initiative one-line-setup).
+#
+#   powershell -ExecutionPolicy Bypass -c "iex ((New-Object Net.WebClient).DownloadString('https://unpkg.com/create-pmos/install.ps1'))"
+#
+# Installs what is missing, makes a PMOS folder and opens the PMOS app. No admin rights, no WSL:
+#   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
+# Every step checks first and skips what is already there, so running the line again is safe.
+#
+# Settings (environment variables):
+#   PMOS_DIR=<folder>     the PMOS folder (default: %USERPROFILE%\PMOS)
+#   PMOS_NO_OPEN=1        do not open the browser at the end
+#   PMOS_SKIP_CLAUDE=1    do not install Claude Code
+#   PMOS_PKG=<spec>       the create-pmos package to run (default: create-pmos@latest)
+
+$ErrorActionPreference = 'Stop'
+$ProgressPreference = 'SilentlyContinue'   # Invoke-WebRequest is many times slower with the progress bar on
+[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
+
+$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' }
+$NodeMin = 18
+
+function Say($m) { Write-Host "==> $m" -ForegroundColor Cyan }
+function Ok($m) { Write-Host "    [ok] $m" -ForegroundColor Green }
+function Fail($m, $try) {
+  Write-Host ""
+  Write-Host "x $m" -ForegroundColor Red
+  if ($try) { Write-Host "  Try: $try" }
+  # A pasted line runs inside the user's own PowerShell window: throw instead of exit, so the window stays open.
+  throw "PMOS setup stopped: $m"
+}
+function Have($c) { [bool](Get-Command $c -ErrorAction SilentlyContinue) }
+
+# Put a folder on PATH now and for new windows (the user's own PATH; no admin needed).
+function Add-Path($dir) {
+  if (-not (($env:Path -split ';') -contains $dir)) { $env:Path = "$dir;$env:Path" }
+  $user = [Environment]::GetEnvironmentVariable('Path', 'User')
+  if (-not $user) { $user = '' }
+  if (-not (($user -split ';') -contains $dir)) {
+    [Environment]::SetEnvironmentVariable('Path', ($dir + ';' + $user).TrimEnd(';'), 'User')
+  }
+}
+function Get-File($url, $out) {
+  try { Invoke-WebRequest -Uri $url -OutFile $out -UseBasicParsing }
+  catch { Fail "Could not download $url" 'check the internet connection, then paste the line again' }
+}
+function Node-Major {
+  try { [int]((& node -p "process.versions.node.split('.')[0]") 2>$null) } catch { 0 }
+}
+
+$arch = if ($env:PROCESSOR_ARCHITECTURE -eq 'ARM64' -or $env:PROCESSOR_ARCHITEW6432 -eq 'ARM64') { 'arm64' } else { 'x64' }
+New-Item -ItemType Directory -Force -Path $PmosHome | Out-Null
+
+Write-Host ""
+Write-Host "PMOS setup - this installs what is missing and opens PMOS."
+Write-Host ""
+
+# --- 1. Node.js ---
+Say 'Checking Node.js'
+$nodeDir = Join-Path $PmosHome 'node'
+if (Test-Path (Join-Path $nodeDir 'node.exe')) { Add-Path $nodeDir }
+if ((Have node) -and ((Node-Major) -ge $NodeMin)) {
+  Ok "Node.js $(& node -v) is installed"
+} else {
+  Say "Installing Node.js (latest LTS) into $nodeDir"
+  try { $index = Invoke-RestMethod -Uri 'https://nodejs.org/dist/index.json' -UseBasicParsing }
+  catch { Fail 'Could not read the Node.js version list from nodejs.org.' 'check the internet connection, then paste the line again' }
+  $ver = ($index | Where-Object { $_.lts } | Select-Object -First 1).version
+  $zip = Join-Path $env:TEMP "node-$ver-win-$arch.zip"
+  Get-File "https://nodejs.org/dist/$ver/node-$ver-win-$arch.zip" $zip
+  $unz = Join-Path $env:TEMP "pmos-node-$ver"
+  if (Test-Path $unz) { Remove-Item -Recurse -Force $unz }
+  Expand-Archive -Path $zip -DestinationPath $unz -Force
+  if (Test-Path $nodeDir) { Remove-Item -Recurse -Force $nodeDir }
+  Move-Item -Path (Join-Path $unz "node-$ver-win-$arch") -Destination $nodeDir
+  Remove-Item -Force $zip; Remove-Item -Recurse -Force $unz -ErrorAction SilentlyContinue
+  Add-Path $nodeDir
+  Ok "Node.js $(& node -v) installed"
+}
+# Windows blocks PowerShell scripts by default, and npm's `pmos` and `npx` commands are partly scripts.
+# RemoteSigned for this user only (no admin) is the setting npm's own docs give.
+$policy = Get-ExecutionPolicy -Scope CurrentUser
+if ($policy -eq 'Undefined' -or $policy -eq 'Restricted') {
+  try { Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force; Ok 'PowerShell may now run the pmos command (RemoteSigned, this user only)' }
+  catch { Write-Host "    note: could not change the PowerShell script setting; type pmos.cmd instead of pmos" }
+}
+# npm's global folder is where `pmos` lands. It must exist and be on PATH. It is %APPDATA%\npm unless
+# npm is set up otherwise, so ask npm.
+New-Item -ItemType Directory -Force -Path (Join-Path $env:APPDATA 'npm') | Out-Null
+$npmGlobal = ((& npm.cmd prefix -g) | Select-Object -Last 1).Trim()
+if (-not $npmGlobal) { $npmGlobal = Join-Path $env:APPDATA 'npm' }
+New-Item -ItemType Directory -Force -Path $npmGlobal | Out-Null
+Add-Path $npmGlobal
+
+# --- 2. git ---
+Say 'Checking git'
+$gitDir = Join-Path $PmosHome 'git'
+if (Test-Path (Join-Path $gitDir 'cmd\git.exe')) { Add-Path (Join-Path $gitDir 'cmd') }
+if (Have git) {
+  Ok (& git --version)
+} else {
+  Say "Installing Portable Git into $gitDir"
+  try {
+    $h = @{ 'User-Agent' = 'pmos-setup' }
+    if ($env:GITHUB_TOKEN) { $h['Authorization'] = "Bearer $env:GITHUB_TOKEN" }   # CI only: the anonymous rate limit is shared per address
+    $rel = Invoke-RestMethod -Uri 'https://api.github.com/repos/git-for-windows/git/releases/latest' -UseBasicParsing -Headers $h
+  } catch { Fail 'Could not read the Git for Windows release list from GitHub.' 'check the internet connection, then paste the line again' }
+  $want = if ($arch -eq 'arm64') { 'PortableGit-*-arm64.7z.exe' } else { 'PortableGit-*-64-bit.7z.exe' }
+  $asset = $rel.assets | Where-Object { $_.name -like $want } | Select-Object -First 1
+  if (-not $asset) { Fail 'Could not find Portable Git for this computer.' 'install Git from https://git-scm.com/download/win, then paste the line again' }
+  $exe = Join-Path $env:TEMP $asset.name
+  Get-File $asset.browser_download_url $exe
+  if (Test-Path $gitDir) { Remove-Item -Recurse -Force $gitDir }
+  # A self-extracting 7-Zip archive: -o is the target folder, -y answers yes. No installer, no admin.
+  $p = Start-Process -FilePath $exe -ArgumentList "-o`"$gitDir`"", '-y' -Wait -PassThru -WindowStyle Hidden
+  Remove-Item -Force $exe -ErrorAction SilentlyContinue
+  if ($p.ExitCode -ne 0 -or -not (Test-Path (Join-Path $gitDir 'cmd\git.exe'))) { Fail 'Portable Git did not unpack.' 'paste the line again' }
+  Add-Path (Join-Path $gitDir 'cmd')
+  Ok (& git --version)
+}
+# Claude Code runs its commands in Git Bash. Tell it where bash is when git came from Portable Git.
+$bash = Join-Path $gitDir 'bin\bash.exe'
+if ((Test-Path $bash) -and -not $env:CLAUDE_CODE_GIT_BASH_PATH) {
+  [Environment]::SetEnvironmentVariable('CLAUDE_CODE_GIT_BASH_PATH', $bash, 'User')
+  $env:CLAUDE_CODE_GIT_BASH_PATH = $bash
+}
+
+# --- 3. Claude Code ---
+Say 'Checking Claude Code'
+$claudeBin = Join-Path $env:USERPROFILE '.local\bin'
+if (Test-Path (Join-Path $claudeBin 'claude.exe')) { Add-Path $claudeBin }
+if ($env:PMOS_SKIP_CLAUDE -eq '1') {
+  Ok 'skipped (PMOS_SKIP_CLAUDE=1)'
+} elseif (Have claude) {
+  Ok 'Claude Code is installed'
+} else {
+  Say 'Installing Claude Code'
+  # A child PowerShell: the Claude Code installer may end its own session, which must not end this one.
+  & powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://claude.ai/install.ps1 | iex"
+  if (Test-Path (Join-Path $claudeBin 'claude.exe')) { Add-Path $claudeBin }
+  if (Have claude) { Ok 'Claude Code installed' }
+  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 ---
+Say "Setting up the PMOS folder: $PmosDir"
+New-Item -ItemType Directory -Force -Path $PmosDir | Out-Null
+if (-not (Test-Path (Join-Path $PmosDir '.git'))) {
+  & git -C $PmosDir init -q
+  Ok 'git folder created'
+}
+if (Test-Path (Join-Path $PmosDir 'pmos\AGENTS.md')) {
+  Ok 'the PMOS kit is already in this folder'
+} else {
+  & npx.cmd -y -p $PmosPkg create-pmos $PmosDir
+  if ($LASTEXITCODE -ne 0) { Fail 'Could not add the PMOS kit.' 'paste the line again; if it fails again, send the text above to your PMOS contact' }
+  Ok 'PMOS kit added'
+}
+
+# --- 5. 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' }
+
+Write-Host ""
+Ok 'PMOS is ready. Next time, open PowerShell and type: pmos'

package/install.sh

@@ -0,0 +1,184 @@
+#!/usr/bin/env bash
+# PMOS one-line setup for macOS and Linux (initiative one-line-setup).
+#
+#   curl -fsSL https://unpkg.com/create-pmos/install.sh | bash
+#
+# Installs what is missing, makes a PMOS folder and opens the PMOS app:
+#   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
+# Every step checks first and skips what is already there, so running the line again is safe.
+#
+# Settings (environment variables):
+#   PMOS_DIR=<folder>      the PMOS folder (default: ~/PMOS)
+#   PMOS_NO_OPEN=1         do not open the browser at the end
+#   PMOS_SKIP_CLAUDE=1     do not install Claude Code
+#   PMOS_PKG=<spec>        the create-pmos package to run (default: create-pmos@latest)
+set -euo pipefail
+
+PMOS_HOME="${PMOS_HOME:-$HOME/.pmos}"
+PMOS_DIR="${PMOS_DIR:-$HOME/PMOS}"
+PMOS_PKG="${PMOS_PKG:-create-pmos@latest}"
+NODE_MIN=18
+MARK="# added by PMOS setup"
+
+say()  { printf '\033[1m==>\033[0m %s\n' "$*"; }
+ok()   { printf '    \033[32m✓\033[0m %s\n' "$*"; }
+fail() { printf '\n\033[31m✗ %s\033[0m\n' "$1" >&2; [ -n "${2:-}" ] && printf '  Try: %s\n' "$2" >&2; exit 1; }
+have() { command -v "$1" >/dev/null 2>&1; }
+
+OS="$(uname -s)"
+case "$OS" in
+  Darwin) PLAT=darwin ;;
+  Linux)  PLAT=linux ;;
+  *) fail "This setup is for macOS and Linux. On Windows, paste the PowerShell line instead." \
+          "powershell -ExecutionPolicy Bypass -c \"iex ((New-Object Net.WebClient).DownloadString('https://unpkg.com/create-pmos/install.ps1'))\"" ;;
+esac
+case "$(uname -m)" in
+  arm64|aarch64) ARCH=arm64 ;;
+  x86_64|amd64)  ARCH=x64 ;;
+  *) fail "This computer's processor ($(uname -m)) is not supported." ;;
+esac
+
+# The shell start-up files that new Terminal windows read, so PATH changes last. On Linux a new window
+# reads ~/.bashrc and a login reads ~/.bash_profile or ~/.profile, so both get the line.
+profile_files() {
+  case "${SHELL:-}" in
+    */zsh)  echo "$HOME/.zprofile" ;;
+    */bash) if [ "$PLAT" = darwin ]; then echo "$HOME/.bash_profile"
+            else
+              echo "$HOME/.bashrc"
+              # A login shell reads ~/.bash_profile instead of ~/.profile when it exists.
+              if [ -f "$HOME/.bash_profile" ]; then echo "$HOME/.bash_profile"; else echo "$HOME/.profile"; fi
+            fi ;;
+    *)      echo "$HOME/.profile" ;;
+  esac
+}
+# Put a folder on PATH now and in new Terminal windows. Adds the line once per file.
+add_path() {
+  local dir="$1" f
+  case ":$PATH:" in *":$dir:"*) ;; *) export PATH="$dir:$PATH" ;; esac
+  for f in $(profile_files); do
+    touch "$f"
+    grep -qsF "$dir" "$f" || printf '\nexport PATH="%s:$PATH" %s\n' "$dir" "$MARK" >> "$f"
+  done
+}
+
+node_major() { node -p 'process.versions.node.split(".")[0]' 2>/dev/null || echo 0; }
+
+echo
+echo "PMOS setup — this installs what is missing and opens PMOS."
+echo
+
+# ── 1. Node.js ────────────────────────────────────────────────────────────────────────────────
+say "Checking Node.js"
+[ -x "$PMOS_HOME/node/bin/node" ] && add_path "$PMOS_HOME/node/bin"
+if have node && [ "$(node_major)" -ge "$NODE_MIN" ]; then
+  ok "Node.js $(node -v) is installed"
+else
+  say "Installing Node.js (latest LTS) into $PMOS_HOME/node"
+  have curl || fail "curl is missing." "install curl, then paste the line again"
+  # The list is newest first; the first entry whose "lts" is not false is the latest LTS. awk reads to the end
+  # (no early exit), so nothing upstream is cut off mid-write under pipefail.
+  ver="$(curl -fsSL https://nodejs.org/dist/index.json | tr '{' '\n' \
+    | awk '!found && /"version":"v/ && !/"lts":false/ { sub(/.*"version":"/, ""); sub(/".*/, ""); print; found = 1 }')"
+  [ -n "$ver" ] || fail "Could not read the Node.js version list from nodejs.org." "check the internet connection, then paste the line again"
+  tmp="$(mktemp -d)"
+  curl -fsSL "https://nodejs.org/dist/$ver/node-$ver-$PLAT-$ARCH.tar.gz" -o "$tmp/node.tar.gz" \
+    || fail "Could not download Node.js $ver." "check the internet connection, then paste the line again"
+  rm -rf "$PMOS_HOME/node" && mkdir -p "$PMOS_HOME/node"
+  tar -xzf "$tmp/node.tar.gz" -C "$PMOS_HOME/node" --strip-components=1 --no-same-owner
+  rm -rf "$tmp"
+  add_path "$PMOS_HOME/node/bin"
+  hash -r
+  ok "Node.js $(node -v) installed"
+fi
+# A system Node whose global folder needs sudo: point npm's global folder at one the user owns.
+npm_prefix="$(npm prefix -g 2>/dev/null || true)"
+if [ -n "$npm_prefix" ] && [ ! -w "$npm_prefix/lib" ] && [ ! -w "$npm_prefix" ]; then
+  mkdir -p "$PMOS_HOME/npm-global"
+  npm config set prefix "$PMOS_HOME/npm-global"
+  add_path "$PMOS_HOME/npm-global/bin"
+  ok "npm global folder set to $PMOS_HOME/npm-global (no sudo needed)"
+fi
+# npm's global folder is where `pmos` lands: put its bin folder on PATH, wherever npm is set up to keep it.
+npm_prefix="$(npm prefix -g 2>/dev/null || true)"
+[ -n "$npm_prefix" ] && [ -d "$npm_prefix" ] && add_path "$npm_prefix/bin"
+
+# ── 2. git ────────────────────────────────────────────────────────────────────────────────────
+say "Checking git"
+if [ "$PLAT" = darwin ]; then
+  if xcode-select -p >/dev/null 2>&1 && git --version >/dev/null 2>&1; then
+    ok "$(git --version)"
+  else
+    say "Installing Apple's Command Line Tools (they include git)"
+    echo "    A window opens. Click Install and wait for it to finish. This step can take a few minutes."
+    xcode-select --install >/dev/null 2>&1 || true
+    waited=0
+    until xcode-select -p >/dev/null 2>&1; do
+      sleep 5; waited=$((waited + 5))
+      [ "$waited" -ge 3600 ] && fail "The Command Line Tools did not finish installing." "run: xcode-select --install, then paste the line again"
+    done
+    ok "$(git --version)"
+  fi
+else
+  if have git; then
+    ok "$(git --version)"
+  else
+    say "Installing git (your password may be asked)"
+    if have apt-get; then sudo apt-get update -qq && sudo apt-get install -y -qq git
+    elif have dnf; then sudo dnf install -y -q git
+    elif have pacman; then sudo pacman -S --noconfirm git
+    else fail "Could not install git automatically." "install git with your package manager, then paste the line again"; fi
+    ok "$(git --version)"
+  fi
+  # On Linux the terminal component (node-pty) is built from source: it needs a compiler and Python.
+  if ! have make || ! have g++ || ! have python3; then
+    say "Installing build tools for the PMOS app (your password may be asked)"
+    if have apt-get; then sudo apt-get install -y -qq build-essential python3
+    elif have dnf; then sudo dnf install -y -q gcc-c++ make python3
+    elif have pacman; then sudo pacman -S --noconfirm base-devel python
+    else fail "Could not install build tools automatically." "install a C++ compiler, make and python3, then paste the line again"; fi
+    ok "build tools installed"
+  fi
+fi
+
+# ── 3. Claude Code ───────────────────────────────────────────────────────────────────────────
+say "Checking Claude Code"
+[ -x "$HOME/.local/bin/claude" ] && add_path "$HOME/.local/bin"
+if [ "${PMOS_SKIP_CLAUDE:-}" = 1 ]; then
+  ok "skipped (PMOS_SKIP_CLAUDE=1)"
+elif have claude; then
+  ok "Claude Code is installed"
+else
+  say "Installing Claude Code"
+  curl -fsSL https://claude.ai/install.sh | bash \
+    || fail "Could not install Claude Code." "run: curl -fsSL https://claude.ai/install.sh | bash, then paste the line again"
+  add_path "$HOME/.local/bin"
+  hash -r
+  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 ──────────────────────────────────────────────────────────────
+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
+  git -C "$PMOS_DIR" init -q
+  ok "git folder created"
+fi
+if [ -f "$PMOS_DIR/pmos/AGENTS.md" ]; then
+  ok "the PMOS kit is already in this folder"
+else
+  npx -y -p "$PMOS_PKG" create-pmos "$PMOS_DIR" || fail "Could not add the PMOS kit." "paste the line again; if it fails again, send the text above to your PMOS contact"
+  ok "PMOS kit added"
+fi
+
+# ── 5. 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"
+
+echo
+ok "PMOS is ready. Next time, open Terminal and type: pmos"
+echo "    New Terminal windows find node, claude and pmos by themselves."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.154.0",
+  "version": "0.156.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": {
@@ -10,6 +10,8 @@
     "bin/",
     "payload/",
     "workspace/",
+    "install.sh",
+    "install.ps1",
     "README.md",
     "LICENSE"
   ],

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@c6cee1a
+kernel-source: pmos@04349e3
 assembled: 2026-10-12
 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-12T04:39:11Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T05:09:50Z"}
 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-12T04:39:11Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T05:09:50Z"}
 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-12T04:39:11Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T05:09:50Z"}
 status: stable
 ---
 

package/workspace/bin/pmos.js

@@ -329,6 +329,7 @@ async function up(dir, { remote = false, open = true } = {}) {
   };
   const child = spawn(process.execPath, [path.join(WS, 'server.js')], {
     cwd: WS, detached: true, stdio: ['ignore', log, log], env,
+    windowsHide: true,                                  // Windows: no console window for the background server
   });
   // A server that exits at once (a refused tailnet bind, a port lost to a race) ends the wait below early.
   let exited = false;

package/workspace/doctor.js

@@ -33,7 +33,9 @@ function binaryArch(file) {
   console.log(`pmos workspace doctor — node ${process.version} (${process.platform}/${process.arch})`);
   console.log(`  install dir: ${WSDIR}\n`);
 
-  const REINSTALL = `cd "${WSDIR}" && rm -rf node_modules && npm install   (reinstalls node-pty for this platform)`;
+  const REINSTALL = process.platform === 'win32'
+    ? 'npx create-pmos@latest workspace --reinstall   (reinstalls the app and node-pty for this computer)'
+    : `cd "${WSDIR}" && rm -rf node_modules && npm install   (reinstalls node-pty for this platform)`;
 
   // 1. Node version
   const major = Number(process.versions.node.split('.')[0]);
@@ -101,7 +103,7 @@ function binaryArch(file) {
       bad(`PTY spawn failed: ${e.message}`,
         /posix_spawnp/.test(e.message)
           ? `on macOS this is node-pty's spawn-helper lacking +x (check 3 restores it — re-run \`npm run doctor\`); otherwise a wrong-arch binary — ${REINSTALL}`
-          : process.platform === 'win32' ? 'native Windows needs WSL for a real PTY — run the workspace inside WSL'
+          : process.platform === 'win32' ? `Windows 10 version 1809 or later is needed for terminals (ConPTY); otherwise ${REINSTALL}`
           : 'check that /bin/sh exists and is executable');
     }
   }

package/workspace/guide/document-sheet.md

@@ -1,7 +1,7 @@
 ---
 type: Guide
 title: "The document sheet"
-description: "How to read a document as rich text, edit it, review the agent's proposals section by section, read the edit log, and clear a stale document."
+description: "How to read a document as rich text with its outline, edit it, review the agent's proposals section by section, read the edit log, keep its Confluence and Google Doc copies in step, see the documents around it, and clear a stale document."
 timestamp: 2026-10-12
 ---
 
@@ -16,7 +16,8 @@ Read shows the document as formatted text: headings, bold, links, tables, checkl
 - Each section shows who changed it last: a person, or the agent and the person who accepted it, with the revision and the day. Select the name to open that revision in the edit log.
 - **Show who wrote what** colours each section: blue for a person, purple for the agent.
 - **Markdown source** shows the file as text. **Copy the markdown** copies it.
-- **Contents** goes to a section.
+- The **outline** beside the text lists the headings, nested by level. The section you read is marked as you scroll. Select a heading to go to it, or the arrow beside a heading to fold the headings under it. A document with more than 12 headings has a **Find a heading** box. An orange dot marks a section that cites a source that changed. A purple dot marks a section that an open proposal changes.
+- **Hide the outline** hides it, and the sheet keeps that choice in this browser. On a narrow screen the outline is a button, **Outline**, that names the section you read and opens the list over the text.
 - When an open proposal changes a section, a note shows above that section. Select **Show change** to see the difference in place.
 
 ## Edit
@@ -53,6 +54,20 @@ A document is stale when a document that it links to changed after it. The sheet
 - Edit the sections, or ask the agent for an update.
 - If the document is still right, select **Mark as still current** and write why. The mark counts as a change, so the banner clears.
 
+## Copies in Confluence and Google Docs
+
+The header shows one chip for each copy of the document in Confluence or Google Docs, with its state: in step, behind (the copy has changes), PMOS ahead (PMOS has changes), both changed, or not checked. Select a chip to open **Copies in other tools**. Each copy shows its state, who changed it last and when, and when it was last checked.
+
+- **Check now** starts an agent session that reads the copies with your connectors. The states change when it finishes.
+- **Open in Confluence** or **Open in Google Doc** opens the copy.
+- When the copy is behind or both changed, **Bring their change in as a proposal** asks the agent to read the copy and draft its changes as a proposal. Review it in Proposals, section by section. PMOS keeps a fingerprint of the copy, not its text, so the proposal is where you see the difference.
+- When PMOS is ahead, **Update the Google Doc to this version** (or the Confluence page) starts an agent session that writes the copy. You have five seconds to select **Undo**.
+- **Link a copy** takes the address of a Confluence page or a Google Doc. The sheet finds the tool from the address.
+
+PMOS never overwrites the document from a copy.
+
 ## Health and Relations
 
-Health shows the checks of the document and how many pass. Relations shows the documents around this one.
+Health shows the checks of the document and how many pass.
+
+Relations shows a graph of the documents around this one: the documents it uses on the left, its initiative and goals on top, and the documents that use it and its copies on the right. A dashed orange line shows a document that is out of step. Select a document to open it. The lists under the graph name the same documents. From Initiatives › Documents, **Open the full graph in Docs** shows the whole graph.

package/workspace/guide/launcher.md

@@ -1,7 +1,7 @@
 ---
 type: Guide
 title: "Start the workspace without a terminal"
-timestamp: 2026-10-06
+timestamp: 2026-10-12
 ---
 
 # Start the workspace without a terminal
@@ -47,5 +47,5 @@ Type `pmos launcher off`. It removes the app and the login item. It removes only
 ## Limits
 
 - The login item never starts remote (tailnet) mode, and it writes no token. To open the workspace from your phone, start remote mode yourself as `workspace/REMOTE.md` tells you.
-- Native Windows is not supported. The workspace needs WSL on Windows. Type `pmos launcher on` inside WSL.
+- Windows has no launcher yet. The workspace itself runs on Windows with no WSL: open PowerShell and type `pmos`. If PMOS is not installed yet, the one-line setup in the create-pmos README installs it.
 - The login item runs once, at login. If the server stops, open the app to start it again.

package/workspace/lib/launcher-cli.js

@@ -16,7 +16,7 @@
  * A file started by the desktop has no shell profile, so the PATH of the terminal that ran `on` is written into the
  * script; that is how `claude`, `git` and `tmux` resolve. It never starts remote (tailnet) mode and writes no token.
  * `off` deletes a file only when it carries MARK, so a file of the same name that the PM wrote is left alone.
- * Native Windows is refused: the workspace needs WSL there for a real PTY (doctor.js says the same).
+ * Windows is refused: no Start-menu or login item is made there yet. Start the workspace with `pmos`.
  *
  * plan() is pure: every input is injected, so each platform's files are assertable from any machine.
  */
@@ -81,7 +81,7 @@ function desktop(entries) {
  * `login: false` leaves the login item out.
  */
 function plan({ platform, home, env = {}, node, bin, repo, login = true }) {
-  if (platform === 'win32') return { refused: 'native Windows needs WSL for a real PTY. Run `pmos launcher on` inside WSL.' };
+  if (platform === 'win32') return { refused: 'no launcher is made on Windows yet. Start the workspace with `pmos` in PowerShell.' };
   if (platform !== 'darwin' && platform !== 'linux') return { refused: `no launcher is made for ${platform}. Start the workspace with \`pmos\`.` };
   const log = path.join(stateRoot.defaultRoot({ env, platform, home }), 'launcher.log');
   const body = script({ node, bin, repo, pathEnv: env.PATH || '/usr/bin:/bin', log });

package/workspace/package-lock.json

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

package/workspace/package.json

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

package/workspace/public/pm/c3-demo-boards.js

@@ -584,14 +584,15 @@ function handleMore(S, method, path, p) {
     return okb({ board: { name: 'Demo board' }, releases: S.releases.filter((x) => x.board === p.board).map((x) => ({ id: x.id, name: x.name, type: 'both', initiative_ids: x.scope.slice(), deploy_at: x.date + 'T11:00:00', release_at: x.date + 'T12:00:00', accepted_at: x.status === 'Released' ? x.date + 'T12:30:00' : null, gapFlags: [], tags: { detected: [], reason: null }, summary: [], status: x.status, board: x.board })) });
   }
   if (path === '/api/docs/library') {
-    const files = [];
+    const files = []; const edges = [];   // the research informs the PRD; the rubric comes from the PRD (the document sheet's Relations graph)
     for (const r of feat(p.board)) {
-      const h = hash(r.id); const slug = r.id.toLowerCase();
+      const h = hash(r.id); const slug = r.id.toLowerCase(); const at0 = files.length;
       if (r.spec) files.push({ path: 'planning/ib/' + slug + '-prd.md', title: r.title + ' PRD', category: 'spec', date: D(-(h % 20) - 1), initiative: r.id });
       files.push({ path: 'planning/ib/' + slug + '-research.md', title: r.title + ' research', category: 'res', date: D(-(h % 50) - 5), initiative: r.id });
       if (catOfRow(S, r) === 'Do') files.push({ path: 'planning/ib/' + slug + '-rubric.md', title: r.title + ' rubric', category: 'eval', date: D(-(h % 9) - 1), initiative: r.id });
+      if (r.spec) { edges.push([at0 + 1, at0, 0]); if (files.length === at0 + 3) edges.push([at0, at0 + 2, 1]); }
     }
-    return okb({ key: 'demo', files, edges: [], kinds: [], categories: [{ key: 'spec', name: 'Specs' }, { key: 'eval', name: 'Evals' }, { key: 'res', name: 'Research & plans' }], initiatives: {} });
+    return okb({ key: 'demo', files, edges, kinds: ['informs', 'rubric from'], categories: [{ key: 'spec', name: 'Specs' }, { key: 'eval', name: 'Evals' }, { key: 'res', name: 'Research & plans' }], initiatives: {} });
   }
   return undefined;
 }