@inerrata-corporation/errata 2.0.0-alpha.0 → 2.0.0-dev.21

package/README.txt

@@ -1,56 +1,56 @@
-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.ps1
-
-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.
-
-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.
-
-macOS / Linux:
-
-    errata.mjs carries a `#!/usr/bin/env node` shebang. Put the dist/ folder
-    somewhere stable, then symlink the bundle onto your PATH:
-
-        chmod +x errata.mjs
-        ln -s "$PWD/errata.mjs" ~/.local/bin/errata
-
-    The resources/wasm/ folder must stay next to errata.mjs.
-
-Use:
-
-    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)
-
-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
-neither the session transcript nor the MessageDisplay hook, so inline tags
-written mid-turn are lost on every capture channel. errata's agent instruction
-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.
-
-Uninstall (Windows):
-
-    .\uninstall.ps1
+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.ps1
+
+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.
+
+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.
+
+macOS / Linux:
+
+    errata.mjs carries a `#!/usr/bin/env node` shebang. Put the dist/ folder
+    somewhere stable, then symlink the bundle onto your PATH:
+
+        chmod +x errata.mjs
+        ln -s "$PWD/errata.mjs" ~/.local/bin/errata
+
+    The resources/wasm/ folder must stay next to errata.mjs.
+
+Use:
+
+    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)
+
+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
+neither the session transcript nor the MessageDisplay hook, so inline tags
+written mid-turn are lost on every capture channel. errata's agent instruction
+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.
+
+Uninstall (Windows):
+
+    .\uninstall.ps1

package/errata.mjs

@@ -39472,8 +39472,11 @@ function fixRationaleBefore(sentence, idx) {
 function parseInlineTags(text) {
   const out2 = [];
   const deFenced = text.replace(/```[\s\S]*?```/g, " ");
+  let seqNo = -1;
   for (const raw2 of deFenced.split(/(?<=[.!?])\s+|\n+/)) {
+    seqNo++;
     if (raw2.length > 600) continue;
+    const seqStart = out2.length;
     const sentence = raw2.replace(
       /`[^`]*`/g,
       (m) => /\[[!?]|\((?:fix|cause|constraint):|\(\[/.test(m) ? " " : m
@@ -39559,6 +39562,7 @@ function parseInlineTags(text) {
         out2.push({ kind: "constraint", statement, sentence: sfield });
       }
     }
+    for (let i2 = seqStart; i2 < out2.length; i2++) out2[i2].seq = seqNo;
   }
   return out2;
 }
@@ -39670,7 +39674,18 @@ function harvestInlineTags(store, text, opts) {
   const mintPriors = opts.mintPriors ?? true;
   const touched = opts.sessionTouchedIds ?? /* @__PURE__ */ new Set();
   const plan = { priorEdges: 0, problems: [], fixes: [], triages: [], unresolvedFixes: [] };
-  for (const tag of parseInlineTags(text)) {
+  const tags = parseInlineTags(text);
+  const symptomSeqs = tags.filter((t) => (t.kind === "problem" || t.kind === "todo" || t.kind === "constraint") && t.statement).map((t) => ({ seq: t.seq ?? -1, statement: t.statement })).sort((a, b) => a.seq - b.seq);
+  const nearestSymptom = (seq) => {
+    if (seq == null) return void 0;
+    let best;
+    for (const s of symptomSeqs) {
+      if (s.seq <= seq) best = s.statement;
+      else break;
+    }
+    return best;
+  };
+  for (const tag of tags) {
     if (tag.kind === "problem" || tag.kind === "todo") {
       plan.problems.push({
         statement: tag.statement,
@@ -39688,13 +39703,14 @@ function harvestInlineTags(store, text, opts) {
         plan.fixes.push({ inScope: true, fixNote: tag.fixRationale });
       }
     } else if (tag.kind === "triage") {
+      const symptomStatement = nearestSymptom(tag.seq);
       if (tag.handle) {
         const causeId = resolveHandle(store, tag.handle, opts.handleMap);
         const node2 = causeId ? store.getNode(causeId) : null;
-        if (node2) plan.triages.push({ causeId: node2.id, causeDescription: node2.description });
+        if (node2) plan.triages.push({ causeId: node2.id, causeDescription: node2.description, ...symptomStatement ? { symptomStatement } : {} });
       } else if (tag.causeText) {
         const causeId = `dcause_${digest({ statement: tag.causeText })}`.slice(0, 56);
-        plan.triages.push({ causeId, causeDescription: tag.causeText });
+        plan.triages.push({ causeId, causeDescription: tag.causeText, ...symptomStatement ? { symptomStatement } : {} });
       }
     } else if (mintPriors && source) {
       const targetId = resolveHandle(store, tag.handle, opts.handleMap);
@@ -40951,7 +40967,7 @@ function maybeFlushDigests() {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.0-alpha.0" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.0-dev.21" : "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;
@@ -41542,27 +41558,29 @@ function createWorkspaceEngine(opts) {
           }
         }
         if (opts.sharedStore && plan.triages.length > 0) {
-          const symptomId = sessionLastProblem.get(sessionId);
-          const symptom = symptomId ? store.getNode(symptomId) : void 0;
-          if (symptom) {
-            for (const tr of plan.triages) {
-              if (tr.causeId === symptomId) continue;
-              try {
-                recordTriageObservation(
-                  opts.sharedStore,
-                  {
-                    presentingStatement: symptom.description,
-                    causeId: tr.causeId,
-                    ...tr.causeDescription ? { causeDescription: tr.causeDescription } : {},
-                    context: { stack: profile.stack, domain: profile.domains[0] },
-                    contributor: sessionId
-                  },
-                  t
-                );
-                triaged++;
-              } catch (err2) {
-                console.warn("[errata] inline triage route failed:", err2);
-              }
+          const fallbackId = sessionLastProblem.get(sessionId);
+          const fallbackStatement = fallbackId ? store.getNode(fallbackId)?.description : void 0;
+          for (const tr of plan.triages) {
+            const presentingStatement = tr.symptomStatement ?? fallbackStatement;
+            if (!presentingStatement) continue;
+            const presentingId = designProblemId(presentingStatement);
+            if (tr.causeId === presentingId) continue;
+            try {
+              recordTriageObservation(
+                opts.sharedStore,
+                {
+                  presentingStatement,
+                  presentingId,
+                  causeId: tr.causeId,
+                  ...tr.causeDescription ? { causeDescription: tr.causeDescription } : {},
+                  context: { stack: profile.stack, domain: profile.domains[0] },
+                  contributor: sessionId
+                },
+                t
+              );
+              triaged++;
+            } catch (err2) {
+              console.warn("[errata] inline triage route failed:", err2);
             }
           }
         }

package/install.ps1

@@ -1,90 +1,90 @@
-# errata Windows installer / patcher (Node-bundle distribution).
-# Idempotent: re-running upgrades an existing install in place.
-#
-# 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/.
-
-$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.
-$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."
-    exit 1
-}
-$nodeMajor = (& node -e "process.stdout.write(String(process.versions.node.split('.')[0]))")
-if ([int]$nodeMajor -lt 22) {
-    Write-Host "[X] Node $nodeMajor found, but errata needs Node 22+. Upgrade and re-run."
-    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)"
-}
-
-if (-not (Test-Path $Target)) {
-    New-Item -ItemType Directory -Path $Target | Out-Null
-}
-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"
-}
-
-# 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
-# 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.
-$VbsTemplate = @'
-' errata daemon autostart launcher (written by install.ps1) - runs `errata dash` fully hidden.
-Set sh = CreateObject("WScript.Shell")
-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"))
-    Set-Content -Path $Launcher -Value $Vbs -Encoding ASCII
-
-    $action    = New-ScheduledTaskAction -Execute "wscript.exe" -Argument ('"{0}"' -f $Launcher)
-    $trigger   = New-ScheduledTaskTrigger -AtLogOn -User $env:USERNAME
-    $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)"
-} 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 ""
-Write-Host "Next steps:"
-Write-Host "  1. Open a new terminal so PATH refreshes."
-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."
+# errata Windows installer / patcher (Node-bundle distribution).
+# Idempotent: re-running upgrades an existing install in place.
+#
+# 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/.
+
+$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.
+$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."
+    exit 1
+}
+$nodeMajor = (& node -e "process.stdout.write(String(process.versions.node.split('.')[0]))")
+if ([int]$nodeMajor -lt 22) {
+    Write-Host "[X] Node $nodeMajor found, but errata needs Node 22+. Upgrade and re-run."
+    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)"
+}
+
+if (-not (Test-Path $Target)) {
+    New-Item -ItemType Directory -Path $Target | Out-Null
+}
+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"
+}
+
+# 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
+# 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.
+$VbsTemplate = @'
+' errata daemon autostart launcher (written by install.ps1) - runs `errata dash` fully hidden.
+Set sh = CreateObject("WScript.Shell")
+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"))
+    Set-Content -Path $Launcher -Value $Vbs -Encoding ASCII
+
+    $action    = New-ScheduledTaskAction -Execute "wscript.exe" -Argument ('"{0}"' -f $Launcher)
+    $trigger   = New-ScheduledTaskTrigger -AtLogOn -User $env:USERNAME
+    $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)"
+} 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 ""
+Write-Host "Next steps:"
+Write-Host "  1. Open a new terminal so PATH refreshes."
+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."

package/package.json

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

package/uninstall.ps1

@@ -1,29 +1,29 @@
-# 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"
-}
-
-$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"
-}
-
-Write-Host ""
-Write-Host "[OK] errata uninstalled."
-Write-Host "Per-workspace .errata/ folders are left in place - delete them manually if desired."
+# 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"
+}
+
+$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"
+}
+
+Write-Host ""
+Write-Host "[OK] errata uninstalled."
+Write-Host "Per-workspace .errata/ folders are left in place - delete them manually if desired."