@inerrata-corporation/errata 2.0.0-dev.54 → 2.0.0-dev.56

package/README.txt

@@ -2,36 +2,38 @@ errata - local-first observation engine for coding agents
 
 Requires Node.js 22 or newer on PATH (https://nodejs.org).
 
-Install (Windows, no admin rights required):
+INSTALL
 
-    .\install.ps1
+    npm i -g @inerrata-corporation/errata
 
-This copies errata.mjs + the tree-sitter runtime to %LOCALAPPDATA%\errata
-and adds that directory to your user PATH. A small errata.cmd shim runs the
-bundle under your system Node.
+That's the whole install: npm drops the bundle + tree-sitter runtime and puts
+the `errata` command on your PATH. Works on Windows, macOS, and Linux. (Alpha
+dogfooders track the dev channel: `npm i -g @inerrata-corporation/errata@dev`.)
 
-It also registers a Scheduled Task (\errata\ai.errata.daemon) that auto-starts
-the daemon (`errata dash`) at every logon, launched hidden via a small .vbs so
-no console window flashes. uninstall.ps1 removes it. Note: this runs the
-installed copy under %LOCALAPPDATA%\errata - re-run install.ps1 after rebuilding
-to keep the autostarted daemon current.
+Windows autostart (optional): run install.ps1 (shipped alongside this file) to
+register a hidden logon Scheduled Task that keeps `errata dash` running across
+reboots. It installs via the SAME `npm i -g` and points the task at the
+npm-managed bundle, so a later `errata update` is picked up automatically -
+install and update never diverge. uninstall.ps1 removes the task + the install.
 
-macOS / Linux:
+USE
 
-    errata.mjs carries a `#!/usr/bin/env node` shebang. Put the dist/ folder
-    somewhere stable, then symlink the bundle onto your PATH:
+    cd /path/to/your/project
+    errata init         # auto-detects the profile + installs harness hooks
+    errata start        # observe this repo   (or 'errata dash' to watch all projects)
+    errata status       # verify the whole chain (daemon, cloud, consent, version)
 
-        chmod +x errata.mjs
-        ln -s "$PWD/errata.mjs" ~/.local/bin/errata
+Dashboard: http://127.0.0.1:7891
 
-    The resources/wasm/ folder must stay next to errata.mjs.
+UPDATE
 
-Use:
+    errata update                    # pull the newest build on your channel (npm i -g)
+    errata update --channel latest   # switch channels; the choice is persisted
+    errata update --check            # just report whether you're behind
 
-    cd C:\path\to\your\project
-    errata init         # auto-detects profile + installs harness hooks
-    errata start        # observe this repo
-    errata status       # verify the whole chain (daemon, cloud, consent)
+CLOUD (optional - errata works fully local without it)
+
+    errata login        # browser OAuth (loopback); '--device' for the code flow
 
 Model caveat (Claude Code + Claude Fable 5): the harness treats Fable 5's
 mid-turn assistant text (written between tool calls) as ephemeral - it reaches
@@ -41,16 +43,10 @@ tells the agent to restate mid-turn tags in its final message (which always
 survives), so expect reduced mid-turn capture on Fable sessions; Opus/Sonnet
 sessions are fully captured. (Verified with a 3-model matrix, 2026-07-02.)
 
-Open the dashboard: http://127.0.0.1:7891
-
-Point at a cloud (defaults to the public instance):
-
-    errata init --cloud https://your-instance --token <api-key>
-    errata login        # or browser device-code flow
-
-Per-workspace state lives at .errata/ inside each project root and is
-preserved on uninstall - delete manually if you want it gone.
+Per-workspace state lives at .errata/ inside each project root and is preserved
+on uninstall - delete manually if you want it gone.
 
-Uninstall (Windows):
+UNINSTALL
 
-    .\uninstall.ps1
+    .\uninstall.ps1                                   # Windows (removes the autostart task too)
+    npm uninstall -g @inerrata-corporation/errata     # any platform

package/errata.mjs

@@ -20896,6 +20896,8 @@ var init_client = __esm({
       refreshSkewSec;
       fetchFn;
       timeoutMs;
+      daemonVersion;
+      daemonChannel;
       constructor(opts) {
         this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
         if (opts.apiKey !== void 0) this.apiKey = opts.apiKey;
@@ -20907,6 +20909,8 @@ var init_client = __esm({
         this.refreshSkewSec = opts.refreshSkewSec ?? 60;
         this.fetchFn = opts.fetchFn ?? fetch;
         this.timeoutMs = opts.timeoutMs ?? 15e3;
+        this.daemonVersion = opts.daemonVersion;
+        this.daemonChannel = opts.daemonChannel;
       }
       /**
        * The bearer token to send: a fresh OAuth access token (refreshing it first if
@@ -21204,6 +21208,8 @@ var init_client = __esm({
       async getSkills(context = "daemon skill sync", seed) {
         const qs = new URLSearchParams({ context });
         if (seed && seed.length > 0) qs.set("seed", seed.join(","));
+        if (this.daemonVersion) qs.set("daemonVersion", this.daemonVersion);
+        if (this.daemonChannel) qs.set("daemonChannel", this.daemonChannel);
         return this.json("GET", `/v2/skills?${qs.toString()}`);
       }
       /** CL-induce: request a skill for a locally-detected community's cloud-
@@ -21751,6 +21757,7 @@ function oauthClientId() {
 function authedCloudClient(cfg, opts = {}) {
   const baseUrl = normalizeCloudUrl(cfg.cloudUrl);
   const fetchFn = guardCloudFetch(baseUrl, opts.fetchFn ?? fetch);
+  const versionOpts = opts.daemonVersion ? { daemonVersion: opts.daemonVersion, daemonChannel: cfg.updateChannel } : {};
   if (cfg.accessToken) {
     const tokenEndpoint = cfg.tokenEndpoint;
     return new CloudClient({
@@ -21758,6 +21765,7 @@ function authedCloudClient(cfg, opts = {}) {
       accessToken: cfg.accessToken,
       ...cfg.refreshToken ? { refreshToken: cfg.refreshToken } : {},
       fetchFn,
+      ...versionOpts,
       ...opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {},
       ...tokenEndpoint && cfg.refreshToken ? {
         refreshFn: (rt) => refreshAccessToken(opts.fetchFn ?? fetch, tokenEndpoint, {
@@ -21778,6 +21786,7 @@ function authedCloudClient(cfg, opts = {}) {
     baseUrl,
     ...cfg.apiKey ? { apiKey: cfg.apiKey } : {},
     fetchFn,
+    ...versionOpts,
     ...opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}
   });
 }
@@ -42355,10 +42364,11 @@ function readSkillManifest(manifestPath) {
 }
 async function syncSkills(paths, client, seed) {
   const res = await client.getSkills(void 0, seed);
+  const staleDaemon = res.staleDaemon && res.latestDaemonVersion ? { latest: res.latestDaemonVersion } : void 0;
   mkdirSync5(paths.skillsDir, { recursive: true });
   if (res.skills.length === 0) {
     const existing = readdirSync6(paths.skillsDir).filter((f) => f.endsWith(".md"));
-    if (existing.length > 0) return { written: 0, pruned: 0 };
+    if (existing.length > 0) return { written: 0, pruned: 0, ...staleDaemon ? { staleDaemon } : {} };
   }
   const rows = [];
   const keep = /* @__PURE__ */ new Set();
@@ -42390,7 +42400,7 @@ async function syncSkills(paths, client, seed) {
     JSON.stringify({ generatedAt: Date.now(), skills: rows }, null, 2),
     "utf8"
   );
-  return { written: rows.length, pruned };
+  return { written: rows.length, pruned, ...staleDaemon ? { staleDaemon } : {} };
 }
 
 // src/working-file-state.ts
@@ -42810,7 +42820,7 @@ function startLoopLagMonitor(thresholdMs = 1e3) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.0-dev.54" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.0-dev.56" : "2.0.0-alpha.0";
 var IGNORED_PATH = /[\\/](?:\.git|node_modules|\.errata|\.claude|\.codex|\.cursor|\.turbo|\.next|dist|coverage|test-results|playwright-report|__pycache__)(?:[\\/]|$)/;
 var IGNORED_NOISE = /castalia\.db|eventlog\.sqlite|turn-cursors/;
 var GIT_OP_MUTE_MS = 4e3;
@@ -44991,7 +45001,7 @@ async function startMultiDaemon(opts = {}) {
     initialCfg.tokenEndpoint = null;
     initialCfg.oauthClientId = null;
   }
-  const cloud = authedCloudClient(initialCfg, { timeoutMs: CLOUD_TIMEOUT_MS });
+  const cloud = authedCloudClient(initialCfg, { timeoutMs: CLOUD_TIMEOUT_MS, daemonVersion: DAEMON_VERSION });
   const cloudNow = () => {
     const c = loadConfig();
     const baseUrl2 = normalizeCloudUrl(opts.cloudUrl ?? c.cloudUrl);
@@ -45003,7 +45013,7 @@ async function startMultiDaemon(opts = {}) {
       current.tokenEndpoint = null;
       current.oauthClientId = null;
     }
-    return authedCloudClient(current, { timeoutMs: CLOUD_TIMEOUT_MS });
+    return authedCloudClient(current, { timeoutMs: CLOUD_TIMEOUT_MS, daemonVersion: DAEMON_VERSION });
   };
   const sharedDbPath = sharedStorePath();
   ensureParent(sharedDbPath);
@@ -45022,6 +45032,7 @@ async function startMultiDaemon(opts = {}) {
       for (const r of records) r.engine.markContextDirty();
     }
   }) : null;
+  let serverPending = null;
   const boundaryListeners = [];
   let boundaryFlushing = false;
   const fireBoundary = () => {
@@ -45040,7 +45051,7 @@ async function startMultiDaemon(opts = {}) {
       apiKey: opts.apiKey,
       reviewUrl: () => `${baseUrl}/ws/${id}/review`,
       sharedStore,
-      pendingUpdate: () => updatePoller?.current() ?? null,
+      pendingUpdate: () => serverPending ?? updatePoller?.current() ?? null,
       ...opts.skipWatchers ? { skipWatchers: true } : {}
     });
     const webApp = buildWebUi({
@@ -45615,10 +45626,17 @@ async function startMultiDaemon(opts = {}) {
     async syncSkillsAll() {
       let written = 0;
       let pruned2 = 0;
+      let stale;
       for (const r of records) {
         const s = await r.engine.fetchSkills();
         written += s.written;
         pruned2 += s.pruned;
+        if (s.staleDaemon) stale = s.staleDaemon;
+      }
+      const next = stale ? { current: DAEMON_VERSION, latest: stale.latest, channel: loadConfig().updateChannel } : null;
+      if ((next?.latest ?? null) !== (serverPending?.latest ?? null)) {
+        serverPending = next;
+        for (const rec of records) rec.engine.markContextDirty();
       }
       return { written, pruned: pruned2 };
     },
@@ -46014,6 +46032,9 @@ var cmd = argv[0] ?? "help";
 var rest = argv.slice(1);
 var NIGHTLY_INTERVAL_MS = 10 * 6e4;
 async function main() {
+  if (cmd !== "help" && cmd !== "--help" && cmd !== "-h" && (rest.includes("--help") || rest.includes("-h"))) {
+    return printHelp();
+  }
   switch (cmd) {
     case "init":
       return cmdInit();

package/install.ps1

@@ -1,15 +1,22 @@
-# errata Windows installer / patcher (Node-bundle distribution).
-# Idempotent: re-running upgrades an existing install in place.
+# errata Windows installer + logon autostart (no admin rights required).
 #
-# Unlike the old SEA build (a 90 MB self-contained errata.exe), this ships the
-# CLI as a single bundled errata.mjs run under the system Node — so Node 22+ must
-# be on PATH. Everything else (tree-sitter WASM) rides along under resources/.
+# The ONE install path is `npm i -g @inerrata-corporation/errata` - the SAME
+# mechanism `errata update` uses, so an update actually takes effect. (The old
+# installer copied a bundle to %LOCALAPPDATA%\errata while `errata update`
+# installed into npm's global prefix - two diverging locations, so the autostart
+# task kept relaunching the STALE copy and updates silently never landed. This
+# unifies them: install + update share one npm-managed location.)
+#
+# Requires Node 22+ on PATH (npm ships with it).
+#
+# Usage:  .\install.ps1                # dev channel (the alpha default)
+#         .\install.ps1 -Channel latest
+
+param([ValidateSet('dev', 'latest')][string]$Channel = 'dev')
 
 $ErrorActionPreference = "Stop"
-$ScriptRoot = $PSScriptRoot
-if (-not $ScriptRoot) { $ScriptRoot = Split-Path -Parent $MyInvocation.MyCommand.Path }
 
-# errata runs on the system Node — fail loudly if it's missing rather than after install.
+# errata runs on the system Node - fail loudly if it's missing rather than after install.
 $node = Get-Command node -ErrorAction SilentlyContinue
 if (-not $node) {
     Write-Host "[X] Node.js not found on PATH. Install Node 22+ from https://nodejs.org and re-run."
@@ -21,41 +28,55 @@ if ([int]$nodeMajor -lt 22) {
     exit 1
 }
 
-$Target = Join-Path $env:LOCALAPPDATA "errata"
-$IsPatch = Test-Path (Join-Path $Target "errata.mjs")
-
-if ($IsPatch) {
-    Write-Host "patching existing errata install at $Target"
-} else {
-    Write-Host "installing errata to $Target  (Node $nodeMajor)"
+$Pkg = "@inerrata-corporation/errata"
+Write-Host "installing $Pkg@$Channel via npm  (Node $nodeMajor)..."
+& npm install -g "$Pkg@$Channel"
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "[X] npm install failed (exit $LASTEXITCODE). Is npm on PATH?"
+    exit 1
 }
 
-if (-not (Test-Path $Target)) {
-    New-Item -ItemType Directory -Path $Target | Out-Null
+# Migrate off the OLD %LOCALAPPDATA%\errata bundle install if present: delete its
+# copied bundle and drop it from PATH, so the npm-generated `errata` shim (which
+# `errata update` keeps current) is the one that wins instead of a stale shadow.
+$LegacyDir = Join-Path $env:LOCALAPPDATA "errata"
+$LegacyMjs = Join-Path $LegacyDir "errata.mjs"
+if (Test-Path $LegacyMjs) {
+    Write-Host "migrating off the legacy %LOCALAPPDATA%\errata bundle install..."
+    foreach ($f in @("errata.mjs", "errata.cmd", "pass-worker.mjs", "consolidate-worker.mjs", "resources")) {
+        $p = Join-Path $LegacyDir $f
+        if (Test-Path $p) { Remove-Item -Path $p -Recurse -Force -ErrorAction SilentlyContinue }
+    }
+    $UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
+    if ($UserPath -and ($UserPath.Split(";") -contains $LegacyDir)) {
+        $NewPath = (($UserPath.Split(";") | Where-Object { $_ -ne $LegacyDir }) -join ";").Trim(";")
+        [Environment]::SetEnvironmentVariable("Path", $NewPath, "User")
+        Write-Host "removed the stale $LegacyDir entry from user PATH"
+    }
 }
-Copy-Item -Path (Join-Path $ScriptRoot "errata.mjs") -Destination $Target -Force
-Copy-Item -Path (Join-Path $ScriptRoot "errata.cmd") -Destination $Target -Force
-$ResSrc = Join-Path $ScriptRoot "resources"
-$ResDst = Join-Path $Target "resources"
-if (Test-Path $ResDst) { Remove-Item $ResDst -Recurse -Force }
-Copy-Item -Path $ResSrc -Destination $Target -Recurse -Force
 
-$UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
-$PathParts = if ($UserPath) { $UserPath.Split(";") } else { @() }
-if ($PathParts -notcontains $Target) {
-    $NewPath = if ($UserPath) { "$UserPath;$Target" } else { $Target }
-    [Environment]::SetEnvironmentVariable("Path", $NewPath, "User")
-    Write-Host "added $Target to user PATH"
-    Write-Host "  (open a new terminal for PATH changes to take effect)"
-} else {
-    Write-Host "PATH already contains $Target"
+# Resolve the npm-installed bundle so autostart points at the SAME file `errata
+# update` (npm i -g) replaces IN PLACE - this is what makes an update take effect.
+$globalRoot = (& npm root -g).Trim()
+$Mjs = Join-Path (Join-Path (Join-Path $globalRoot "@inerrata-corporation") "errata") "errata.mjs"
+if (-not (Test-Path $Mjs)) {
+    Write-Host "[X] installed, but could not locate the bundle at $Mjs - autostart not registered."
+    Write-Host "    You can still run 'errata dash' manually."
+    exit 1
 }
 
+# Persist the update channel so `errata update` tracks the one you installed.
+# (No-op display-wise; the config default is already 'dev', so this only matters
+# when you install -Channel latest.)
+try { & node "$Mjs" update --channel $Channel --check | Out-Null } catch { }
+
 # Auto-start the daemon at logon via a Scheduled Task. We launch through a hidden
-# .vbs shim because node.exe is a console app — running it from the task directly
+# .vbs shim because node.exe is a console app - running it from the task directly
 # flashes a window every logon; WScript's Run(..., 0, False) starts it windowless.
 # Task name/path mirror uninstall.ps1 (\errata\ai.errata.daemon) so the two stay
-# symmetric. Best-effort: a failure here must not fail the install.
+# symmetric. The launcher points at the npm bundle above, so a later `errata
+# update` is picked up on next logon with no re-install. Best-effort.
+if (-not (Test-Path $LegacyDir)) { New-Item -ItemType Directory -Path $LegacyDir | Out-Null }
 $VbsTemplate = @'
 ' errata daemon autostart launcher (written by install.ps1) - runs `errata dash` fully hidden.
 Set sh = CreateObject("WScript.Shell")
@@ -63,8 +84,8 @@ sh.CurrentDirectory = "__CWD__"
 sh.Run """__NODE__"" ""__MJS__"" dash", 0, False
 '@
 try {
-    $Launcher = Join-Path $Target "errata-autostart.vbs"
-    $Vbs = $VbsTemplate.Replace("__CWD__", $env:USERPROFILE).Replace("__NODE__", $node.Source).Replace("__MJS__", (Join-Path $Target "errata.mjs"))
+    $Launcher = Join-Path $LegacyDir "errata-autostart.vbs"
+    $Vbs = $VbsTemplate.Replace("__CWD__", $env:USERPROFILE).Replace("__NODE__", $node.Source).Replace("__MJS__", $Mjs)
     Set-Content -Path $Launcher -Value $Vbs -Encoding ASCII
 
     $action    = New-ScheduledTaskAction -Execute "wscript.exe" -Argument ('"{0}"' -f $Launcher)
@@ -72,19 +93,19 @@ try {
     $settings  = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable -ExecutionTimeLimit (New-TimeSpan -Seconds 0) -RestartCount 3 -RestartInterval (New-TimeSpan -Minutes 1)
     $principal = New-ScheduledTaskPrincipal -UserId $env:USERNAME -LogonType Interactive -RunLevel Limited
     Register-ScheduledTask -TaskName "ai.errata.daemon" -TaskPath "\errata\" -Action $action -Trigger $trigger -Settings $settings -Principal $principal -Description "Auto-start the errata dash daemon at logon." -Force | Out-Null
-    Write-Host "registered autostart task \errata\ai.errata.daemon (starts at logon)"
+    Write-Host "registered autostart task \errata\ai.errata.daemon (starts at logon, runs the npm-installed bundle)"
 } catch {
     Write-Host "[!] could not register autostart task: $($_.Exception.Message)"
     Write-Host "    (install still succeeded - start the daemon manually with 'errata dash')"
 }
 
 Write-Host ""
-if ($IsPatch) { Write-Host "[OK] errata patched." } else { Write-Host "[OK] errata installed." }
+Write-Host "[OK] errata installed (channel: $Channel)."
 Write-Host ""
 Write-Host "Next steps:"
-Write-Host "  1. Open a new terminal so PATH refreshes."
+Write-Host "  1. Open a new terminal so PATH refreshes (npm's global bin holds the 'errata' command)."
 Write-Host "  2. cd into the workspace you want to observe."
 Write-Host "  3. errata init"
 Write-Host "  4. errata start   (or 'errata dash' to watch all projects)"
 Write-Host ""
-Write-Host "The daemon will also auto-start at every logon from now on."
+Write-Host "Update anytime with:  errata update   (autostart picks it up on next logon)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inerrata-corporation/errata",
-  "version": "2.0.0-dev.54",
+  "version": "2.0.0-dev.56",
   "description": "errata - local-first observation engine for AI coding agents",
   "type": "module",
   "bin": {

package/uninstall.ps1

@@ -1,29 +1,35 @@
 # errata uninstaller.
 $ErrorActionPreference = "Stop"
-$Target = Join-Path $env:LOCALAPPDATA "errata"
-
-if (-not (Test-Path $Target)) {
-    Write-Host "errata is not installed at $Target."
-    exit 0
-}
 
-Write-Host "removing $Target"
-Remove-Item -Path $Target -Recurse -Force
-
-$UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
-if ($UserPath) {
-    $PathParts = $UserPath.Split(";") | Where-Object { $_ -ne $Target }
-    $NewPath = ($PathParts -join ";").Trim(";")
-    [Environment]::SetEnvironmentVariable("Path", $NewPath, "User")
-    Write-Host "removed $Target from user PATH"
+# Remove the npm-global install (the binary + bundle + npm's PATH shim).
+$node = Get-Command node -ErrorAction SilentlyContinue
+if ($node) {
+    Write-Host "removing @inerrata-corporation/errata (npm global)..."
+    & npm uninstall -g "@inerrata-corporation/errata" 2>$null | Out-Null
 }
 
+# Remove the logon autostart task.
 $Existing = Get-ScheduledTask -TaskName "ai.errata.daemon" -TaskPath "\errata\" -ErrorAction SilentlyContinue
 if ($Existing) {
     Unregister-ScheduledTask -TaskName "ai.errata.daemon" -TaskPath "\errata\" -Confirm:$false
     Write-Host "removed scheduled task errata\ai.errata.daemon"
 }
 
+# Remove %LOCALAPPDATA%\errata - the autostart launcher lives here, and (for
+# machines upgraded from the pre-npm installer) so did the legacy bundle. Also
+# drop the legacy dir from user PATH if a pre-npm install left it there.
+$Target = Join-Path $env:LOCALAPPDATA "errata"
+if (Test-Path $Target) {
+    Remove-Item -Path $Target -Recurse -Force
+    Write-Host "removed $Target"
+}
+$UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
+if ($UserPath -and ($UserPath.Split(";") -contains $Target)) {
+    $NewPath = (($UserPath.Split(";") | Where-Object { $_ -ne $Target }) -join ";").Trim(";")
+    [Environment]::SetEnvironmentVariable("Path", $NewPath, "User")
+    Write-Host "removed the legacy $Target entry from user PATH"
+}
+
 Write-Host ""
 Write-Host "[OK] errata uninstalled."
 Write-Host "Per-workspace .errata/ folders are left in place - delete them manually if desired."