@inerrata-corporation/errata 2.0.19 → 2.0.20-dev.3682

package/resources/context-plugin/launch.mjs

@@ -0,0 +1,63 @@
+import { spawn } from 'node:child_process'
+import { openSync, closeSync } from 'node:fs'
+import { mkdir, readFile } from 'node:fs/promises'
+import { join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { parseArgs } from 'node:util'
+import { setTimeout } from 'node:timers/promises'
+
+const { values } = parseArgs({ options: { root: { type: 'string' }, session: { type: 'string' } } })
+const root = resolve(values.root ?? process.cwd())
+const session = values.session ?? process.env.CODEX_THREAD_ID
+if (session && !/^[\w-]{1,100}$/.test(session)) throw new Error('Invalid task id')
+const output = join(root, '.errata', 'context-preview')
+const metadata = join(output, (session ?? 'workspace') + '.json')
+async function running() {
+  try {
+    const info = JSON.parse(await readFile(metadata, 'utf8'))
+    const url = new URL(info.url)
+    if (
+      url.protocol !== 'http:' ||
+      url.hostname !== '127.0.0.1' ||
+      info.root !== root ||
+      info.sessionId !== (session ?? null)
+    )
+      return null
+    const response = await fetch(new URL('health', url), { signal: AbortSignal.timeout(700) })
+    const health = await response.json()
+    return health.ok &&
+      health.root === root &&
+      health.sessionId === (session ?? null) &&
+      health.pid === info.pid
+      ? info
+      : null
+  } catch {
+    return null
+  }
+}
+let info = await running()
+if (!info) {
+  await mkdir(output, { recursive: true })
+  const log = openSync(join(output, (session ?? 'workspace') + '.log'), 'a')
+  const args = [fileURLToPath(new URL('dist/server.mjs', import.meta.url)), '--root', root]
+  if (session) args.push('--session', session)
+  let error
+  const child = spawn(process.execPath, args, {
+    detached: true,
+    windowsHide: true,
+    stdio: ['ignore', log, log],
+    cwd: root,
+  })
+  child.on('error', (e) => {
+    error = e
+  })
+  child.unref()
+  closeSync(log)
+  for (let i = 0; i < 50 && !info; i++) {
+    if (error) throw error
+    await setTimeout(200)
+    info = await running()
+  }
+}
+if (!info) throw new Error('Preview did not start. See the task log in ' + output)
+console.log(JSON.stringify(info))

package/resources/context-plugin/skills/context-graph/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: context-graph
+description: Open a minimal live 3D graph of the Errata priors loaded into the current Codex task and its recent bursts. Use when the user asks to see context, priors, or graph activity in a side panel.
+---
+
+# Errata context graph
+
+Use the plugin's `open_context_graph` MCP tool. Supply the absolute current
+workspace as `workspace` and the current `CODEX_THREAD_ID` as `sessionId`.
+Read that environment variable through the shell if it is not already available.
+Do not guess the task id or select whichever transcript was modified most recently.
+
+Once the user has a context panel open for this task, keep that panel as the
+visual surface. Do not call `open_context_graph` again for normal refreshes or
+post additional graph cards or screenshots into chat. Reopen only when the user
+asks or the current panel cannot recover. The panel follows updates itself.
+
+This tool declares the native conversation-panel entrypoint. The UI reads its own
+updates through `read_context_graph`; no automation, repeated model calls, or
+additional graph bursts are needed to keep it live. Do not print the entire graph
+payload into the conversation. Do not add a dashboard, header, counts, or node list.
+
+The graph follows the latest task-specific Errata injection and uses the workspace
+snapshot only while task context is unavailable. It turns toward real successful
+burst results. New bursts animate a seed pulse, recorded traversal hops, and a
+settle on the results. This replays recorded paths after completion; do not
+describe it as every internal search step. Dragging pauses camera following;
+double-click, Home, or Escape resumes. Hover or select a node for its label.
+Click a burst in the tiny log to replay it. Reduced motion shows results directly.
+
+If the host cannot render MCP Apps, use the bundled fallback only as needed:
+run `node <plugin-root>/launch.mjs --root <workspace> --session <task-id>` and open
+the returned local URL in the right-hand browser panel. Explain that it is a browser
+fallback. Do not claim the native panel was opened unless the host actually renders it.
+
+All graph and transcript reads are local and read-only. Only rendered prior lines
+and completed burst results are sent to the panel, never the full conversation.