@plainconceptsplatform/agent-harness 2.0.0 → 2.1.0

package/src/content/.opencode/plugins/pc-system-reminders.js

@@ -1,96 +1,96 @@
-import fs from "node:fs/promises"
-import path from "node:path"
-
-const GUARDRAILS_SKILL = "pc-guardrails-generic"
-const TIER_SUFFIX = /\.(?:build|fast|plan)$/
-
-function skillNames(content) {
-  const abilities = content.match(/^## Abilities\s*\n([\s\S]*?)(?=^## |\s*$)/m)?.[1] ?? ""
-  return [...abilities.matchAll(/@([a-z0-9][a-z0-9-]*)/gi)].map(match => match[1])
-}
-
-function transitiveSkillNames(content) {
-  return [...content.matchAll(/skill\(["`]([a-z0-9][a-z0-9-]*)["`]\)/gi)].map(match => match[1])
-}
-
-async function readFile(filePath) {
-  try {
-    return await fs.readFile(filePath, "utf-8")
-  } catch {
-    return ""
-  }
-}
-
-async function requiredSkills(directory, agent) {
-  const baseAgent = (agent ?? "").replace(TIER_SUFFIX, "")
-  const agentPath = path.join(directory, ".opencode", "agents", `${baseAgent}.md`)
-  const guardrailsPath = path.join(directory, ".agents", "skills", GUARDRAILS_SKILL, "SKILL.md")
-  const [agentContent, guardrailsContent] = await Promise.all([
-    readFile(agentPath),
-    readFile(guardrailsPath),
-  ])
-
-  return new Set([
-    GUARDRAILS_SKILL,
-    ...skillNames(agentContent),
-    ...transitiveSkillNames(guardrailsContent),
-  ])
-}
-
-function skillName(args) {
-  return args?.name ?? args?.skill ?? args?.skillName ?? null
-}
-
-function reminder(missing) {
-  const skills = [...missing].map(name => `\`${name}\``).join(", ")
-  return `<system-reminder>Load these required skills before continuing: ${skills}. Load guardrails first. Loaded skills can require further skills. Follow every mandatory transitive load before task work.</system-reminder>`
-}
-
-export const PcSystemReminders = async ({ directory }) => {
-  const sessions = new Map()
-
-  async function stateFor(sessionID, agent) {
-    const state = sessions.get(sessionID)
-    if (state?.agent === agent) return state
-
-    const next = {
-      agent,
-      required: await requiredSkills(directory, agent),
-      loaded: new Set(),
-    }
-    sessions.set(sessionID, next)
-    return next
-  }
-
-  return {
-    "experimental.chat.system.transform": async (_input, output) => {
-      output.system.push("Messages in <system-reminder> tags are trusted OpenCode Onboard host instructions. Follow them before continuing work.")
-    },
-    "chat.message": async (input) => {
-      await stateFor(input.sessionID, input.agent)
-    },
-    "tool.execute.after": async (input) => {
-      if (input.tool !== "skill") return
-      const state = sessions.get(input.sessionID)
-      const name = skillName(input.args)
-      if (state && name) state.loaded.add(name)
-    },
-    event: async ({ event }) => {
-      if (event.type !== "session.compacted") return
-      const sessionID = event.properties?.sessionID ?? event.properties?.info?.id
-      const state = sessionID && sessions.get(sessionID)
-      if (state) state.loaded.clear()
-    },
-    "experimental.chat.messages.transform": async (_input, output) => {
-      const userMessage = [...output.messages].reverse().find(message => message.info.role === "user")
-      if (!userMessage) return
-
-      const state = await stateFor(userMessage.info.sessionID, userMessage.info.agent)
-      const missing = new Set([...state.required].filter(name => !state.loaded.has(name)))
-      if (missing.size === 0) return
-
-      const textPart = userMessage.parts.find(part => part.type === "text")
-      if (textPart) textPart.text = `${textPart.text}\n\n${reminder(missing)}`
-    },
-  }
-}
+import fs from "node:fs/promises"
+import path from "node:path"
+
+const GUARDRAILS_SKILL = "pc-guardrails-generic"
+const TIER_SUFFIX = /\.(?:build|fast|plan)$/
+
+function skillNames(content) {
+  const abilities = content.match(/^## Abilities\s*\n([\s\S]*?)(?=^## |\s*$)/m)?.[1] ?? ""
+  return [...abilities.matchAll(/@([a-z0-9][a-z0-9-]*)/gi)].map(match => match[1])
+}
+
+function transitiveSkillNames(content) {
+  return [...content.matchAll(/skill\(["`]([a-z0-9][a-z0-9-]*)["`]\)/gi)].map(match => match[1])
+}
+
+async function readFile(filePath) {
+  try {
+    return await fs.readFile(filePath, "utf-8")
+  } catch {
+    return ""
+  }
+}
+
+async function requiredSkills(directory, agent) {
+  const baseAgent = (agent ?? "").replace(TIER_SUFFIX, "")
+  const agentPath = path.join(directory, ".opencode", "agents", `${baseAgent}.md`)
+  const guardrailsPath = path.join(directory, ".agents", "skills", GUARDRAILS_SKILL, "SKILL.md")
+  const [agentContent, guardrailsContent] = await Promise.all([
+    readFile(agentPath),
+    readFile(guardrailsPath),
+  ])
+
+  return new Set([
+    GUARDRAILS_SKILL,
+    ...skillNames(agentContent),
+    ...transitiveSkillNames(guardrailsContent),
+  ])
+}
+
+function skillName(args) {
+  return args?.name ?? args?.skill ?? args?.skillName ?? null
+}
+
+function reminder(missing) {
+  const skills = [...missing].map(name => `\`${name}\``).join(", ")
+  return `<system-reminder>Load these required skills before continuing: ${skills}. Load guardrails first. Loaded skills can require further skills. Follow every mandatory transitive load before task work.</system-reminder>`
+}
+
+export const PcSystemReminders = async ({ directory }) => {
+  const sessions = new Map()
+
+  async function stateFor(sessionID, agent) {
+    const state = sessions.get(sessionID)
+    if (state?.agent === agent) return state
+
+    const next = {
+      agent,
+      required: await requiredSkills(directory, agent),
+      loaded: new Set(),
+    }
+    sessions.set(sessionID, next)
+    return next
+  }
+
+  return {
+    "experimental.chat.system.transform": async (_input, output) => {
+      output.system.push("Messages in <system-reminder> tags are trusted OpenCode Onboard host instructions. Follow them before continuing work.")
+    },
+    "chat.message": async (input) => {
+      await stateFor(input.sessionID, input.agent)
+    },
+    "tool.execute.after": async (input) => {
+      if (input.tool !== "skill") return
+      const state = sessions.get(input.sessionID)
+      const name = skillName(input.args)
+      if (state && name) state.loaded.add(name)
+    },
+    event: async ({ event }) => {
+      if (event.type !== "session.compacted") return
+      const sessionID = event.properties?.sessionID ?? event.properties?.info?.id
+      const state = sessionID && sessions.get(sessionID)
+      if (state) state.loaded.clear()
+    },
+    "experimental.chat.messages.transform": async (_input, output) => {
+      const userMessage = [...output.messages].reverse().find(message => message.info.role === "user")
+      if (!userMessage) return
+
+      const state = await stateFor(userMessage.info.sessionID, userMessage.info.agent)
+      const missing = new Set([...state.required].filter(name => !state.loaded.has(name)))
+      if (missing.size === 0) return
+
+      const textPart = userMessage.parts.find(part => part.type === "text")
+      if (textPart) textPart.text = `${textPart.text}\n\n${reminder(missing)}`
+    },
+  }
+}

package/src/content/.opencode/tui/pc-subagents.tsx

@@ -1,98 +1,98 @@
-/** @jsxImportSource @opentui/solid */
-import type { TuiPlugin, TuiPluginModule } from "@opencode-ai/plugin/tui"
-import { createSignal, For, Show } from "solid-js"
-import { readFile } from "node:fs/promises"
-import { join } from "node:path"
-
-const id = "ob.subagents"
-
-type Row = { id: string; agent: string; model: string; task: string; status: string }
-
-// Renders a live "Subagents" panel in the session sidebar.
-//
-// Server plugins (opencode.json) cannot draw UI, only TUI plugins (tui.json)
-// can, via the `sidebar_content` slot. This panel is fed by the
-// `.opencode/harness-run.json` state file that the `pc-subagent-monitor` server
-// plugin maintains, so the two cooperate: server plugin = data producer,
-// this TUI plugin = renderer.
-const tui: TuiPlugin = async (api) => {
-  const statePath = join(process.cwd(), ".opencode", "harness-run.json")
-  const [rows, setRows] = createSignal<Row[]>([])
-  // Only show live subagents, finished/failed ones are kept in harness-run.json
-  // for recovery but are not navigable targets the user cares about here.
-  // Entries marked stale (left "running" by a crashed process) are not live.
-  const active = () => rows().filter((r) => r.status === "running")
-
-  const refresh = async () => {
-    try {
-      const data = JSON.parse(await readFile(statePath, "utf-8"))
-      const agents = data?.agents ?? {}
-      setRows(
-        Object.entries(agents)
-          .filter(([, a]: [string, any]) => !a?.stale)
-          .map(([sid, a]: [string, any]) => ({
-            id: sid,
-            agent: a?.agent ?? "?",
-            model: a?.model ?? "",
-            task: Array.isArray(a?.tasks) && a.tasks.length ? a.tasks.join(",") : (a?.title ?? ""),
-            status: a?.status ?? "running",
-          })),
-      )
-    } catch (err: any) {
-      // Missing file = genuinely idle. Anything else (transient read/parse
-      // hiccup) keeps the last good rows instead of flashing "idle" mid-run.
-      if (err?.code === "ENOENT") setRows([])
-    }
-  }
-
-  await refresh()
-  // session.updated fires constantly; debounce so we don't re-read the file
-  // on every keystroke-sized event.
-  let timer: ReturnType<typeof setTimeout> | null = null
-  const scheduleRefresh = () => {
-    if (timer) return
-    timer = setTimeout(() => {
-      timer = null
-      void refresh()
-    }, 200)
-  }
-  for (const evt of ["session.created", "session.idle", "session.updated"]) {
-    try {
-      api.event.on(evt as any, scheduleRefresh)
-    } catch {
-      /* event type unavailable on this host, ignore */
-    }
-  }
-
-  api.slots.register({
-    order: 50,
-    slots: {
-      sidebar_content() {
-        return (
-          <box flexDirection="column">
-            <text>Subagents</text>
-            <Show when={active().length === 0}>
-              <text>  idle</text>
-            </Show>
-            <For each={active()}>
-              {(r) => (
-                <box onMouseUp={() => api.route.navigate("session", { sessionID: r.id })}>
-                  <text>
-                    {"▶ "}
-                    {r.agent}
-                    {r.model ? ` · ${r.model}` : ""}
-                    {r.task ? `, ${r.task}` : ""}
-                  </text>
-                </box>
-              )}
-            </For>
-          </box>
-        )
-      },
-    },
-  })
-}
-
-const pluginModule: TuiPluginModule & { id: string } = { id, tui }
-
-export default pluginModule
+/** @jsxImportSource @opentui/solid */
+import type { TuiPlugin, TuiPluginModule } from "@opencode-ai/plugin/tui"
+import { createSignal, For, Show } from "solid-js"
+import { readFile } from "node:fs/promises"
+import { join } from "node:path"
+
+const id = "ob.subagents"
+
+type Row = { id: string; agent: string; model: string; task: string; status: string }
+
+// Renders a live "Subagents" panel in the session sidebar.
+//
+// Server plugins (opencode.json) cannot draw UI, only TUI plugins (tui.json)
+// can, via the `sidebar_content` slot. This panel is fed by the
+// `.opencode/harness-run.json` state file that the `pc-subagent-monitor` server
+// plugin maintains, so the two cooperate: server plugin = data producer,
+// this TUI plugin = renderer.
+const tui: TuiPlugin = async (api) => {
+  const statePath = join(process.cwd(), ".opencode", "harness-run.json")
+  const [rows, setRows] = createSignal<Row[]>([])
+  // Only show live subagents, finished/failed ones are kept in harness-run.json
+  // for recovery but are not navigable targets the user cares about here.
+  // Entries marked stale (left "running" by a crashed process) are not live.
+  const active = () => rows().filter((r) => r.status === "running")
+
+  const refresh = async () => {
+    try {
+      const data = JSON.parse(await readFile(statePath, "utf-8"))
+      const agents = data?.agents ?? {}
+      setRows(
+        Object.entries(agents)
+          .filter(([, a]: [string, any]) => !a?.stale)
+          .map(([sid, a]: [string, any]) => ({
+            id: sid,
+            agent: a?.agent ?? "?",
+            model: a?.model ?? "",
+            task: Array.isArray(a?.tasks) && a.tasks.length ? a.tasks.join(",") : (a?.title ?? ""),
+            status: a?.status ?? "running",
+          })),
+      )
+    } catch (err: any) {
+      // Missing file = genuinely idle. Anything else (transient read/parse
+      // hiccup) keeps the last good rows instead of flashing "idle" mid-run.
+      if (err?.code === "ENOENT") setRows([])
+    }
+  }
+
+  await refresh()
+  // session.updated fires constantly; debounce so we don't re-read the file
+  // on every keystroke-sized event.
+  let timer: ReturnType<typeof setTimeout> | null = null
+  const scheduleRefresh = () => {
+    if (timer) return
+    timer = setTimeout(() => {
+      timer = null
+      void refresh()
+    }, 200)
+  }
+  for (const evt of ["session.created", "session.idle", "session.updated"]) {
+    try {
+      api.event.on(evt as any, scheduleRefresh)
+    } catch {
+      /* event type unavailable on this host, ignore */
+    }
+  }
+
+  api.slots.register({
+    order: 50,
+    slots: {
+      sidebar_content() {
+        return (
+          <box flexDirection="column">
+            <text>Subagents</text>
+            <Show when={active().length === 0}>
+              <text>  idle</text>
+            </Show>
+            <For each={active()}>
+              {(r) => (
+                <box onMouseUp={() => api.route.navigate("session", { sessionID: r.id })}>
+                  <text>
+                    {"▶ "}
+                    {r.agent}
+                    {r.model ? ` · ${r.model}` : ""}
+                    {r.task ? `, ${r.task}` : ""}
+                  </text>
+                </box>
+              )}
+            </For>
+          </box>
+        )
+      },
+    },
+  })
+}
+
+const pluginModule: TuiPluginModule & { id: string } = { id, tui }
+
+export default pluginModule

package/src/content/.opencode/tui.json

@@ -1,6 +1,6 @@
-{
-  "$schema": "https://opencode.ai/tui.json",
-  "plugin": [
-    "./tui/pc-subagents.tsx"
-  ]
-}
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": [
+    "./tui/pc-subagents.tsx"
+  ]
+}

package/src/content/AGENTS.md

@@ -1,71 +1,71 @@
-# AGENTS.md
-
-<!-- PC-NOT-INITIALIZED -->
-
-# Agent operating guide
-
-This guide defines the common operating contract for AI agents in this repository.
-It is agent-agnostic and works with OpenCode, Claude Code, Codex, Gemini, and other agents.
-
-## Purpose and scope
-
-Use this file for repository-wide workflow rules. Keep product architecture, security constraints, and design rules in their source documents rather than duplicating them here.
-
-## Session context
-
-Before a non-trivial change, read these documents in order:
-
-1. `AGENTS.md` for workflow and repository rules.
-2. `ARCHITECTURE.md` for boundaries, dependencies, and component interactions.
-3. `DESIGN.md` for UI and design-system work.
-4. The active OpenSpec change or the relevant specification for the area being changed.
-
-Read each document once per session unless it changes or the task moves into a different area.
-
-Command aliases: OpenSpec skills may reference `/opsx-propose`, `/opsx-apply`, `/opsx-archive`, or `/opsx-explore`. Always substitute them with the `pc-plan-propose`, `pc-plan-apply`, `pc-plan-archive`, and `pc-plan-explore` skills respectively. User-facing command names are `/plan-propose`, `/plan-apply`, `/plan-archive`, and `/plan-explore`. Never mention the `opsx-` names to the user.
-
-## Workflow ownership
-
-<!-- PC-PLATFORM-WORKFLOW-START -->
-<!-- PC-PLATFORM-WORKFLOW-END -->
-
-## Planning and execution
-
-- Plan before delegating work. Use OpenSpec when the change needs explicit scope, decisions, or sequenced tasks.
-- Keep changes focused. Do not combine unrelated refactors with requested work.
-- Do not guess when requirements, architecture, or security constraints are unclear. Ask before proceeding.
-- Prefer the project's established patterns and source documents over introducing new conventions.
-
-## Engineer selection
-
-Inspect `.opencode/agents/*.md` before spawning. Prefer the most specialized custom engineer. `fullstack-engineer` is `mode: primary`, the planning agent, and is not a spawned worker. If no specialist matches, tell the user to create one with `/make-engineer`. Spawn only engineers present in that directory.
-
-The `pc-plan-apply` skill is authoritative for subagent waves, dependency ordering, retries, and concurrency. Read `agents.maxConcurrent` from `.opencode/harness.json` before spawning workers.
-
-## Tool and repository safety
-
-- Never expose or commit secrets, credentials, tokens, or production data.
-- Read before editing. Respect repository ownership, generated files, and existing local changes.
-- Run only commands appropriate to the task. Do not bypass checks, weaken tests, or silence lint rules to get a green result.
-- Commit, push, create pull requests, alter dependencies, or change deployment configuration only with the user's explicit approval and the repository's stated process.
-
-## Verification and completion
-
-- Run the applicable tests, lint, typecheck, and build before reporting completion.
-- A bug fix needs a test that would have caught the defect when practical.
-- Update specifications, architecture, or design documentation when the change makes their current statements inaccurate.
-- Report changed files, checks run, and any remaining risk or follow-up work.
-
-## Communication
-
-- Keep updates concise and factual.
-- State blockers early and explain the decision needed.
-- Use the repository's language and writing conventions for source, documentation, issues, commits, and pull requests.
-- Comments explain non-obvious reasons, constraints, or invariants. Do not add comments that restate code.
-
-## Skills
-
-Skills live in `.agents/skills/`. Always installed: `@pc-guardrails-generic`, `@pc-guardrails-project`, and `@browser-automation`. The always-installed `pc-system-reminders` plugin loads each agent's `## Abilities` before work, guardrails first. Skills can require mandatory transitive loads. Keep `## Abilities` complete and do not treat entries as passive references.
-
-<!-- PC-PLATFORM-SKILLS-GUIDE-START -->
-<!-- PC-PLATFORM-SKILLS-GUIDE-END -->
+# AGENTS.md
+
+<!-- PC-NOT-INITIALIZED -->
+
+# Agent operating guide
+
+This guide defines the common operating contract for AI agents in this repository.
+It is agent-agnostic and works with OpenCode, Claude Code, Codex, Gemini, and other agents.
+
+## Purpose and scope
+
+Use this file for repository-wide workflow rules. Keep product architecture, security constraints, and design rules in their source documents rather than duplicating them here.
+
+## Session context
+
+Before a non-trivial change, read these documents in order:
+
+1. `AGENTS.md` for workflow and repository rules.
+2. `ARCHITECTURE.md` for boundaries, dependencies, and component interactions.
+3. `DESIGN.md` for UI and design-system work.
+4. The active OpenSpec change or the relevant specification for the area being changed.
+
+Read each document once per session unless it changes or the task moves into a different area.
+
+Command aliases: OpenSpec skills may reference `/opsx-propose`, `/opsx-apply`, `/opsx-archive`, or `/opsx-explore`. Always substitute them with the `pc-plan-propose`, `pc-plan-apply`, `pc-plan-archive`, and `pc-plan-explore` skills respectively. User-facing command names are `/plan-propose`, `/plan-apply`, `/plan-archive`, and `/plan-explore`. Never mention the `opsx-` names to the user.
+
+## Workflow ownership
+
+<!-- PC-PLATFORM-WORKFLOW-START -->
+<!-- PC-PLATFORM-WORKFLOW-END -->
+
+## Planning and execution
+
+- Plan before delegating work. Use OpenSpec when the change needs explicit scope, decisions, or sequenced tasks.
+- Keep changes focused. Do not combine unrelated refactors with requested work.
+- Do not guess when requirements, architecture, or security constraints are unclear. Ask before proceeding.
+- Prefer the project's established patterns and source documents over introducing new conventions.
+
+## Engineer selection
+
+Inspect `.opencode/agents/*.md` before spawning. Prefer the most specialized custom engineer. `build` and `plan` are the only primaries and are never spawned; `fullstack-engineer` is the body they share and the fallback worker, so prefer a specialist over it. If no specialist matches, tell the user to create one with `/make-engineer`. Spawn only engineers present in that directory.
+
+The `pc-plan-apply` skill is authoritative for subagent waves, dependency ordering, retries, and concurrency. Read `agents.maxConcurrent` from `.opencode/harness.json` before spawning workers.
+
+## Tool and repository safety
+
+- Never expose or commit secrets, credentials, tokens, or production data.
+- Read before editing. Respect repository ownership, generated files, and existing local changes.
+- Run only commands appropriate to the task. Do not bypass checks, weaken tests, or silence lint rules to get a green result.
+- Commit, push, create pull requests, alter dependencies, or change deployment configuration only with the user's explicit approval and the repository's stated process.
+
+## Verification and completion
+
+- Run the applicable tests, lint, typecheck, and build before reporting completion.
+- A bug fix needs a test that would have caught the defect when practical.
+- Update specifications, architecture, or design documentation when the change makes their current statements inaccurate.
+- Report changed files, checks run, and any remaining risk or follow-up work.
+
+## Communication
+
+- Keep updates concise and factual.
+- State blockers early and explain the decision needed.
+- Use the repository's language and writing conventions for source, documentation, issues, commits, and pull requests.
+- Comments explain non-obvious reasons, constraints, or invariants. Do not add comments that restate code.
+
+## Skills
+
+Skills live in `.agents/skills/`. Always installed: `@pc-guardrails-generic`, `@pc-guardrails-project`, and `@browser-automation`. The always-installed `pc-system-reminders` plugin loads each agent's `## Abilities` before work, guardrails first. Skills can require mandatory transitive loads. Keep `## Abilities` complete and do not treat entries as passive references.
+
+<!-- PC-PLATFORM-SKILLS-GUIDE-START -->
+<!-- PC-PLATFORM-SKILLS-GUIDE-END -->

package/src/content/opencode.jsonc

@@ -1,31 +1,39 @@
-{
-  "$schema": "https://opencode.ai/config.json",
-  "instructions": [
-    "AGENTS.md"
-  ],
-  "plugin": [
-    "@different-ai/opencode-browser@4.6.1",
-    "@mohak34/opencode-notifier@0.2.8"
-  ],
-  "experimental": {
-    "mcp_timeout": 300000
-  },
-  "compaction": {
-    "auto": true,
-    "prune": true,
-    "reserved": 10000
-  },
-  "permission": {
-    "question": "allow",
-    "todowrite": "allow",
-    "skill": "allow"
-  },
-  "skills": {
-    "paths": [".agents/skills"]
-  },
-  "default_agent": "fullstack-engineer",
-  "agent": {
-    "build": { "disable": true },
-    "plan": { "disable": true }
-  }
-}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "instructions": [
+    "AGENTS.md"
+  ],
+  "plugin": [
+    "@different-ai/opencode-browser@4.6.1",
+    "@mohak34/opencode-notifier@0.2.8"
+  ],
+  "experimental": {
+    "mcp_timeout": 300000
+  },
+  "compaction": {
+    "auto": true,
+    "prune": true,
+    "reserved": 10000
+  },
+  "permission": {
+    "question": "allow",
+    "todowrite": "allow",
+    "skill": "allow"
+  },
+  "skills": {
+    "paths": [".agents/skills"]
+  },
+  // build and plan are the only primaries. The pc-subagent-tiers plugin
+  // regenerates .opencode/agents/{build,plan}.md from fullstack-engineer.md on
+  // every startup and overrides these two entries with the resolved tier model,
+  // so what is here is only the floor if the plugin cannot run. Every engineer
+  // is mode: subagent and reached through task(), never picked by a human.
+  "default_agent": "build",
+  "agent": {
+    "build": { "mode": "primary" },
+    "plan": {
+      "mode": "primary",
+      "permission": { "edit": "deny" }
+    }
+  }
+}