@plainconceptsplatform/agent-harness 2.0.0 → 2.1.0

package/src/content/.opencode/commands/ops-ship.md

@@ -1,9 +1,9 @@
----
-description: Create a pull request for the current feature branch with screenshots if UI changed.
----
-
-Load the `pc-ops-ship` skill and execute it.
-
-Input:
-
-$ARGUMENTS
+---
+description: Create a pull request for the current feature branch with screenshots if UI changed.
+---
+
+Load the `pc-ops-ship` skill and execute it.
+
+Input:
+
+$ARGUMENTS

package/src/content/.opencode/commands/plan-apply.md

@@ -1,9 +1,9 @@
----
-description: Implement tasks from a plan: works with OpenSpec proposals and in-conversation plans.
----
-
-Load the `pc-plan-apply` skill and execute it in **interactive mode** with `start_from: branch` (the full protocol, including branch creation).
-
-Input:
-
-$ARGUMENTS
+---
+description: Implement tasks from a plan: works with OpenSpec proposals and in-conversation plans.
+---
+
+Load the `pc-plan-apply` skill and execute it in **interactive mode** with `start_from: branch` (the full protocol, including branch creation).
+
+Input:
+
+$ARGUMENTS

package/src/content/.opencode/commands/plan-archive.md

@@ -1,5 +1,5 @@
----
-description: Archive the oldest merged unarchived OpenSpec change and update documentation.
----
-
-Load the `pc-plan-archive` skill and execute it in **interactive mode**. No input required.
+---
+description: Archive the oldest merged unarchived OpenSpec change and update documentation.
+---
+
+Load the `pc-plan-archive` skill and execute it in **interactive mode**. No input required.

package/src/content/.opencode/commands/plan-explore.md

@@ -1,9 +1,9 @@
----
-description: Think through an idea, investigate a problem, or clarify requirements before creating a change.
----
-
-Load the `pc-plan-explore` skill and execute it in **interactive mode**.
-
-Input:
-
-$ARGUMENTS
+---
+description: Think through an idea, investigate a problem, or clarify requirements before creating a change.
+---
+
+Load the `pc-plan-explore` skill and execute it in **interactive mode**.
+
+Input:
+
+$ARGUMENTS

package/src/content/.opencode/commands/plan-goal.md

@@ -1,5 +1,5 @@
----
-description: Autonomous pipeline: explore, propose, apply, archive, then merge/PR/push. For loop-engineering.
----
-
-Load the `pc-plan-goal` skill and follow every step defined in it.
+---
+description: Autonomous pipeline: explore, propose, apply, archive, then merge/PR/push. For loop-engineering.
+---
+
+Load the `pc-plan-goal` skill and follow every step defined in it.

package/src/content/.opencode/commands/plan-propose.md

@@ -1,9 +1,9 @@
----
-description: Parse a work item or idea and propose a change plan with enriched task assignments.
----
-
-Load the `pc-plan-propose` skill and execute it in **interactive mode**.
-
-Input:
-
-$ARGUMENTS
+---
+description: Parse a work item or idea and propose a change plan with enriched task assignments.
+---
+
+Load the `pc-plan-propose` skill and execute it in **interactive mode**.
+
+Input:
+
+$ARGUMENTS

package/src/content/.opencode/commands/plan-quick.md

@@ -1,5 +1,5 @@
----
-description: Quick plan: analyze the codebase and create a task checklist using the Todo pane. No files, no OpenSpec.
----
-
-Load the `pc-plan-quick` skill and follow every step defined in it.
+---
+description: Quick plan: analyze the codebase and create a task checklist using the Todo pane. No files, no OpenSpec.
+---
+
+Load the `pc-plan-quick` skill and follow every step defined in it.

package/src/content/.opencode/commands/plan-story.md

@@ -1,9 +1,9 @@
----
-description: Write a detailed, repo-aware user story from a feature idea or need.
----
-
-Load the `pc-plan-story` skill and follow every step defined in it.
-
-Input:
-
-$ARGUMENTS
+---
+description: Write a detailed, repo-aware user story from a feature idea or need.
+---
+
+Load the `pc-plan-story` skill and follow every step defined in it.
+
+Input:
+
+$ARGUMENTS

package/src/content/.opencode/commands/repo-audit.md

@@ -1,5 +1,5 @@
----
-description: Audit every configured source root against the fullstack engineer's guardrails and abilities. Read-only.
----
-
-Load the `pc-repo-audit` skill and follow every step defined in it.
+---
+description: Audit every configured source root against the fullstack engineer's guardrails and abilities. Read-only.
+---
+
+Load the `pc-repo-audit` skill and follow every step defined in it.

package/src/content/.opencode/commands/repo-help.md

@@ -1,5 +1,5 @@
----
-description: Show all available commands and when to use each one.
----
-
-Load the `pc-repo-help` skill and display its reference to the user exactly as written. Do not summarize.
+---
+description: Show all available commands and when to use each one.
+---
+
+Load the `pc-repo-help` skill and display its reference to the user exactly as written. Do not summarize.

package/src/content/.opencode/commands/repo-initialize.md

@@ -1,5 +1,5 @@
----
-description: Initialize the project. Presents a single form with all setup questions, then executes selected steps.
----
-
-Load the `pc-repo-initialize` skill and follow every step defined in it.
+---
+description: Initialize the project. Presents a single form with all setup questions, then executes selected steps.
+---
+
+Load the `pc-repo-initialize` skill and follow every step defined in it.

package/src/content/.opencode/commands/repo-onboard.md

@@ -1,5 +1,5 @@
----
-description: Walk the user through the project and its agentic infrastructure. Explains what exists, how agents work, and how to use the system.
----
-
-Load the `pc-repo-onboard` skill and follow every step defined in it.
+---
+description: Walk the user through the project and its agentic infrastructure. Explains what exists, how agents work, and how to use the system.
+---
+
+Load the `pc-repo-onboard` skill and follow every step defined in it.

package/src/content/.opencode/commands/repo-verify.md

@@ -1,5 +1,5 @@
----
-description: Verify current-branch changes, plus immutable dependency installs, builds, and tests for every discovered project.
----
-
-Load the `pc-repo-verify` skill and follow every step defined in it.
+---
+description: Verify current-branch changes, plus immutable dependency installs, builds, and tests for every discovered project.
+---
+
+Load the `pc-repo-verify` skill and follow every step defined in it.

package/src/content/.opencode/plugins/pc-subagent-monitor.js

@@ -1,139 +1,139 @@
-// pc-subagent-monitor: tracks spawned subagents in .opencode/harness-run.json for
-// live TUI display and crash recovery. Never throws: monitor failures must
-// not break a session.
-
-import fs from "node:fs/promises"
-import path from "node:path"
-
-export const PcSubagentMonitor = async ({ directory, client }) => {
-  const root = directory || process.cwd()
-  const statePath = path.join(root, ".opencode", "harness-run.json")
-  const state = { updatedAt: null, agents: {} }
-
-  try {
-    const prev = JSON.parse(await fs.readFile(statePath, "utf-8"))
-    if (prev?.agents && typeof prev.agents === "object") {
-      for (const [id, entry] of Object.entries(prev.agents)) {
-        if (entry?.status === "running") entry.stale = true
-        state.agents[id] = entry
-      }
-    }
-  } catch {
-    // fresh start
-  }
-
-  let _modelsCache = null
-  async function loadModels() {
-    if (_modelsCache) return _modelsCache
-    const result = { build: null, fast: null, plan: null }
-    for (const file of ["harness.user.json", "harness.json"]) {
-      try {
-        const raw = await fs.readFile(path.join(root, ".opencode", file), "utf-8")
-        const { models = {} } = JSON.parse(raw)
-        for (const tier of ["build", "fast", "plan"]) {
-          if (!result[tier] && models[tier]) result[tier] = models[tier]
-        }
-      } catch {
-        continue
-      }
-    }
-    _modelsCache = result
-    return result
-  }
-
-  async function modelForAgent(agent) {
-    if (!agent) return null
-    const dotIdx = agent.lastIndexOf(".")
-    const tier = dotIdx !== -1 ? agent.slice(dotIdx + 1) : null
-    if (tier && ["build", "fast", "plan"].includes(tier)) {
-      const models = await loadModels()
-      return models[tier] ?? null
-    }
-    return null
-  }
-
-  function parseTasks(title) {
-    if (!title) return []
-    const m = /^\s*([\d]+(?:\.[\d]+)*(?:\s*,\s*[\d]+(?:\.[\d]+)*)*)/.exec(title)
-    return m ? m[1].split(",").map(s => s.trim()) : []
-  }
-
-  // Debounced persist: coalesce rapid writes when multiple subagents spawn
-  // in the same microtask batch (e.g. a wave of 5 task() calls).
-  let _persistScheduled = false
-  async function persist() {
-    if (_persistScheduled) return
-    _persistScheduled = true
-    queueMicrotask(async () => {
-      _persistScheduled = false
-      state.updatedAt = new Date().toISOString()
-      try {
-        await fs.mkdir(path.dirname(statePath), { recursive: true })
-        const tmpPath = `${statePath}.tmp`
-        await fs.writeFile(tmpPath, JSON.stringify(state, null, 2), "utf-8")
-        await fs.rename(tmpPath, statePath)
-      } catch {
-        // best-effort
-      }
-    })
-  }
-
-  function sessionInfo(props) {
-    const info = props?.info ?? props ?? {}
-    return {
-      id: info.id ?? info.sessionID ?? props?.sessionID,
-      parentID: info.parentID ?? info.parentId,
-      agent: info.agent,
-      title: info.title,
-    }
-  }
-
-  function pruneStale() {
-    for (const [id, entry] of Object.entries(state.agents)) {
-      if (entry?.stale) delete state.agents[id]
-    }
-  }
-
-  return {
-    event: async ({ event }) => {
-      try {
-        if (!event?.type?.startsWith("session.")) return
-        const info = sessionInfo(event.properties)
-        if (!info.id) return
-
-        if (event.type === "session.created" && info.parentID) {
-          pruneStale()
-
-          state.agents[info.id] = {
-            agent: info.agent ?? null,
-            model: await modelForAgent(info.agent),
-            tasks: parseTasks(info.title),
-            title: info.title ?? null,
-            status: "running",
-            startedAt: new Date().toISOString(),
-            endedAt: null,
-          }
-          await persist()
-          return
-        }
-
-        const entry = state.agents[info.id]
-        if (!entry) return
-
-        if (event.type === "session.idle" && entry.status === "running") {
-          entry.status = "done"
-          entry.endedAt = new Date().toISOString()
-          await persist()
-          client?.tui?.showToast?.({
-            body: {
-              message: `subagent done: ${entry.title ?? info.id}`,
-              variant: "success",
-            },
-          })
-        }
-      } catch {
-        // monitoring must never disrupt the run
-      }
-    },
-  }
-}
+// pc-subagent-monitor: tracks spawned subagents in .opencode/harness-run.json for
+// live TUI display and crash recovery. Never throws: monitor failures must
+// not break a session.
+
+import fs from "node:fs/promises"
+import path from "node:path"
+
+export const PcSubagentMonitor = async ({ directory, client }) => {
+  const root = directory || process.cwd()
+  const statePath = path.join(root, ".opencode", "harness-run.json")
+  const state = { updatedAt: null, agents: {} }
+
+  try {
+    const prev = JSON.parse(await fs.readFile(statePath, "utf-8"))
+    if (prev?.agents && typeof prev.agents === "object") {
+      for (const [id, entry] of Object.entries(prev.agents)) {
+        if (entry?.status === "running") entry.stale = true
+        state.agents[id] = entry
+      }
+    }
+  } catch {
+    // fresh start
+  }
+
+  let _modelsCache = null
+  async function loadModels() {
+    if (_modelsCache) return _modelsCache
+    const result = { build: null, fast: null, plan: null }
+    for (const file of ["harness.user.json", "harness.json"]) {
+      try {
+        const raw = await fs.readFile(path.join(root, ".opencode", file), "utf-8")
+        const { models = {} } = JSON.parse(raw)
+        for (const tier of ["build", "fast", "plan"]) {
+          if (!result[tier] && models[tier]) result[tier] = models[tier]
+        }
+      } catch {
+        continue
+      }
+    }
+    _modelsCache = result
+    return result
+  }
+
+  async function modelForAgent(agent) {
+    if (!agent) return null
+    const dotIdx = agent.lastIndexOf(".")
+    const tier = dotIdx !== -1 ? agent.slice(dotIdx + 1) : null
+    if (tier && ["build", "fast", "plan"].includes(tier)) {
+      const models = await loadModels()
+      return models[tier] ?? null
+    }
+    return null
+  }
+
+  function parseTasks(title) {
+    if (!title) return []
+    const m = /^\s*([\d]+(?:\.[\d]+)*(?:\s*,\s*[\d]+(?:\.[\d]+)*)*)/.exec(title)
+    return m ? m[1].split(",").map(s => s.trim()) : []
+  }
+
+  // Debounced persist: coalesce rapid writes when multiple subagents spawn
+  // in the same microtask batch (e.g. a wave of 5 task() calls).
+  let _persistScheduled = false
+  async function persist() {
+    if (_persistScheduled) return
+    _persistScheduled = true
+    queueMicrotask(async () => {
+      _persistScheduled = false
+      state.updatedAt = new Date().toISOString()
+      try {
+        await fs.mkdir(path.dirname(statePath), { recursive: true })
+        const tmpPath = `${statePath}.tmp`
+        await fs.writeFile(tmpPath, JSON.stringify(state, null, 2), "utf-8")
+        await fs.rename(tmpPath, statePath)
+      } catch {
+        // best-effort
+      }
+    })
+  }
+
+  function sessionInfo(props) {
+    const info = props?.info ?? props ?? {}
+    return {
+      id: info.id ?? info.sessionID ?? props?.sessionID,
+      parentID: info.parentID ?? info.parentId,
+      agent: info.agent,
+      title: info.title,
+    }
+  }
+
+  function pruneStale() {
+    for (const [id, entry] of Object.entries(state.agents)) {
+      if (entry?.stale) delete state.agents[id]
+    }
+  }
+
+  return {
+    event: async ({ event }) => {
+      try {
+        if (!event?.type?.startsWith("session.")) return
+        const info = sessionInfo(event.properties)
+        if (!info.id) return
+
+        if (event.type === "session.created" && info.parentID) {
+          pruneStale()
+
+          state.agents[info.id] = {
+            agent: info.agent ?? null,
+            model: await modelForAgent(info.agent),
+            tasks: parseTasks(info.title),
+            title: info.title ?? null,
+            status: "running",
+            startedAt: new Date().toISOString(),
+            endedAt: null,
+          }
+          await persist()
+          return
+        }
+
+        const entry = state.agents[info.id]
+        if (!entry) return
+
+        if (event.type === "session.idle" && entry.status === "running") {
+          entry.status = "done"
+          entry.endedAt = new Date().toISOString()
+          await persist()
+          client?.tui?.showToast?.({
+            body: {
+              message: `subagent done: ${entry.title ?? info.id}`,
+              variant: "success",
+            },
+          })
+        }
+      } catch {
+        // monitoring must never disrupt the run
+      }
+    },
+  }
+}