@plainconceptsplatform/agent-harness 2.3.0 → 2.4.1

package/{src/content → harness}/ARCHITECTURE.md

@@ -1,16 +1,16 @@
-> NOT GENERATED YET
->
-> This file has not been populated yet. It is intentionally empty.
->
-> **If this is a greenfield project** (no codebase exists yet): skip this for now.
-> Come back and run `/make-architecture` once you have meaningful code, structure, or infrastructure in place.
->
-> **If this is a brownfield project** (existing codebase): run this command now to generate the architecture documentation:
->
-> ```
-> /make-architecture
-> ```
->
-> This command analyzes your folder structure, config files, routes, data models, integrations, and build setup,
-> then writes a complete ARCHITECTURE.md covering components, data flow, tech stack, deployment, and more.
-> It is safe to rerun any time the architecture changes significantly.
+> NOT GENERATED YET
+>
+> This file has not been populated yet. It is intentionally empty.
+>
+> **If this is a greenfield project** (no codebase exists yet): skip this for now.
+> Come back and run `/make-architecture` once you have meaningful code, structure, or infrastructure in place.
+>
+> **If this is a brownfield project** (existing codebase): run this command now to generate the architecture documentation:
+>
+> ```
+> /make-architecture
+> ```
+>
+> This command analyzes your folder structure, config files, routes, data models, integrations, and build setup,
+> then writes a complete ARCHITECTURE.md covering components, data flow, tech stack, deployment, and more.
+> It is safe to rerun any time the architecture changes significantly.

package/{src/content → harness}/DESIGN.md

@@ -1,16 +1,16 @@
-> NOT GENERATED YET
->
-> This file has not been populated yet. It is intentionally empty.
->
-> **If this is a greenfield project** (no UI exists yet): skip this for now.
-> Come back and run `/make-design` once you have a design system, UI components, or styles in place.
->
-> **If this is a brownfield project** (existing UI/styles): run this command now to generate the design documentation:
->
-> ```
-> /make-design
-> ```
->
-> This command analyzes your CSS, Tailwind config, component files, and design tokens,
-> then writes a complete DESIGN.md with structured YAML tokens and written design intent.
-> It is safe to rerun any time your design system changes.
+> NOT GENERATED YET
+>
+> This file has not been populated yet. It is intentionally empty.
+>
+> **If this is a greenfield project** (no UI exists yet): skip this for now.
+> Come back and run `/make-design` once you have a design system, UI components, or styles in place.
+>
+> **If this is a brownfield project** (existing UI/styles): run this command now to generate the design documentation:
+>
+> ```
+> /make-design
+> ```
+>
+> This command analyzes your CSS, Tailwind config, component files, and design tokens,
+> then writes a complete DESIGN.md with structured YAML tokens and written design intent.
+> It is safe to rerun any time your design system changes.

package/{src/content → harness}/opencode.jsonc

@@ -1,41 +1,47 @@
-{
-  "$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, and plan is the default: a session
-  // starts read-only and you switch to build once you know what to change.
-  // 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": "plan",
-  "agent": {
-    "build": { "mode": "primary" },
-    "plan": {
-      "mode": "primary",
-      "permission": { "edit": "deny" }
-    }
-  }
-}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "instructions": [
+    "AGENTS.md"
+  ],
+  "plugin": [
+    "@mohak34/opencode-notifier@0.2.8"
+  ],
+  "mcp": {
+    "agent-browser": {
+      "type": "local",
+      "command": ["agent-browser", "mcp", "--tools", "core"],
+      "enabled": true
+    }
+  },
+  "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, and plan is the default: a session
+  // starts read-only and you switch to build once you know what to change.
+  // 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": "plan",
+  "agent": {
+    "build": { "mode": "primary" },
+    "plan": {
+      "mode": "primary",
+      "permission": { "edit": "deny" }
+    }
+  }
+}

package/{src/content → harness}/openspec/config.yaml

@@ -1,20 +1,20 @@
-schema: spec-driven
-
-# Project context (optional)
-# This is shown to AI when creating artifacts.
-# Add your tech stack, conventions, style guides, domain knowledge, etc.
-# Example:
-#   context: |
-#     Tech stack: TypeScript, React, Node.js
-#     We use conventional commits
-#     Domain: e-commerce platform
-
-# Per-artifact rules (optional)
-# Add custom rules for specific artifacts.
-# Example:
-#   rules:
-#     proposal:
-#       - Keep proposals under 500 words
-#       - Always include a "Non-goals" section
-#     tasks:
-#       - Break tasks into chunks of max 2 hours
+schema: spec-driven
+
+# Project context (optional)
+# This is shown to AI when creating artifacts.
+# Add your tech stack, conventions, style guides, domain knowledge, etc.
+# Example:
+#   context: |
+#     Tech stack: TypeScript, React, Node.js
+#     We use conventional commits
+#     Domain: e-commerce platform
+
+# Per-artifact rules (optional)
+# Add custom rules for specific artifacts.
+# Example:
+#   rules:
+#     proposal:
+#       - Keep proposals under 500 words
+#       - Always include a "Non-goals" section
+#     tasks:
+#       - Break tasks into chunks of max 2 hours

package/{src/content → harness}/skills-lock.json

@@ -1,17 +1,17 @@
-{
-  "version": 1,
-  "skills": {
-    "find-skills": {
-      "source": "vercel-labs/skills",
-      "sourceType": "github",
-      "skillPath": "skills/find-skills/SKILL.md",
-      "computedHash": "781bd6d3f9b19f8c9af6b53d8d0e4876d0183841b565db34ca7092ffa412d111"
-    },
-    "user-story": {
-      "source": "deanpeters/product-manager-skills",
-      "sourceType": "github",
-      "skillPath": "skills/user-story/SKILL.md",
-      "computedHash": "user-story-placeholder"
-    }
-  }
-}
+{
+  "version": 1,
+  "skills": {
+    "find-skills": {
+      "source": "vercel-labs/skills",
+      "sourceType": "github",
+      "skillPath": "skills/find-skills/SKILL.md",
+      "computedHash": "781bd6d3f9b19f8c9af6b53d8d0e4876d0183841b565db34ca7092ffa412d111"
+    },
+    "user-story": {
+      "source": "deanpeters/product-manager-skills",
+      "sourceType": "github",
+      "skillPath": "skills/user-story/SKILL.md",
+      "computedHash": "user-story-placeholder"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plainconceptsplatform/agent-harness",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "Installs the Plain Concepts Platform Harness into any codebase, and keeps it up to date. Wires OpenCode, OpenSpec, codegraph, and agentmemory into a multi-agent workflow that runs on native parallel subagents.",
   "keywords": [
     "opencode",
@@ -24,14 +24,14 @@
   "author": "Plain Concepts",
   "type": "module",
   "bin": {
-    "agent-harness": "./src/index.js"
+    "agent-harness": "./cli/index.js"
   },
   "files": [
-    "src",
-    "src/content",
-    "!src/**/*.test.js",
-    "!src/**/__tests__",
-    "!src/content/**/node_modules"
+    "cli",
+    "harness",
+    "!cli/**/*.test.js",
+    "!harness/**/*.test.js",
+    "!harness/**/node_modules"
   ],
   "publishConfig": {
     "access": "public",

package/src/content/.agents/skills/browser-automation/SKILL.md

@@ -1,66 +0,0 @@
----
-name: browser-automation
-description: Reliable, composable browser automation using OpenCode Browser primitives. Use when capturing screenshots of a locally running app, clicking UI elements, reading page content, or automating browser interactions on localhost.
-license: MIT
-compatibility: Requires opencode-browser extension installed and running.
-metadata:
-  author: copilots
-  version: "1.0"
----
-
-This skill operates on `localhost` URLs only. Screenshots, clicks, typing, scrolling, and queries on locally running apps are in scope. External services (github.com, dev.azure.com, npmjs.com, etc.) are out of scope for browser tools.
-
-The only exception: when the user selects "Others (Browser)" as their backlog platform during onboarding, the `pc-userstory` skill may navigate to work item URLs the user explicitly provides. That is the sole case where external navigation is permitted, and only to URLs the user explicitly gives you.
-
-## Best-practice workflow
-
-1. Inspect tabs with `browser_get_tabs`
-2. Open new tabs with `browser_open_tab` when needed
-3. Navigate with `browser_navigate` if needed
-4. Wait for UI using `browser_query` with `timeoutMs`
-5. Discover candidates using `browser_query` with `mode=list`
-6. Click, type, or select using `index`
-7. Confirm using `browser_query` or `browser_snapshot`
-
-## CLI-first debugging
-
-- List all available tools: `npx @different-ai/opencode-browser@4.6.1 tools`
-- Run one tool directly: `npx @different-ai/opencode-browser@4.6.1 tool browser_status`
-- Pass JSON args: `npx @different-ai/opencode-browser@4.6.1 tool browser_query --args '{"mode":"page_text"}'`
-- Run smoke test: `npx @different-ai/opencode-browser@4.6.1 self-test`
-- After `update`, reload the unpacked extension in `chrome://extensions`
-
-## Selecting options
-
-- Use `browser_select` for native `<select>` elements
-- Prefer `value` or `label`; use `optionIndex` when needed
-- Example: `browser_select({ selector: "select", value: "plugin" })`
-
-## Query modes
-
-- `text`: read visible text from a matched element
-- `value`: read input values
-- `list`: list many matches with text/metadata
-- `exists`: check presence and count
-- `page_text`: extract visible page text
-
-## Opening tabs
-
-- Use `browser_open_tab` to create a new tab, optionally with `url` and `active`
-- Example: `browser_open_tab({ url: "https://example.com", active: false })`
-
-## Troubleshooting
-
-- If a selector fails, run `browser_query` with `mode=page_text` to confirm the content exists
-- Use `mode=list` on broad selectors (`button`, `a`, `*[role="button"]`, `*[role="listitem"]`) and choose by index
-- For inbox/chat panes, try text selectors first (`text:Subject line`) then verify selection with `browser_query`
-- For scrollable containers, pass both `selector` and `x`/`y` to `browser_scroll` and then verify `scrollTop`
-
-## Scope
-
-- Screenshots of locally running app on `localhost` URLs: in scope
-- Click, type, scroll, query on `localhost` pages: in scope
-- Navigate to work item URLs the user explicitly provides (when backlog platform is "Others (Browser)"): in scope
-- Navigate to external services for non-work-item purposes: out of scope
-- DevOps or GitHub CLI operations via browser tools: out of scope
-- Reading or modifying production systems via browser tools: out of scope

package/src/presets/browser.json

@@ -1,22 +0,0 @@
-{
-  "installer": {
-    "command": "npx",
-    "args": ["@different-ai/opencode-browser@4.6.1", "install"]
-  },
-  "output": {
-    "showAfter": "To load the extension",
-    "hideAfter": "Press Enter when"
-  },
-  "locationChoices": {
-    "local": "2",
-    "global": "1"
-  },
-  "autoAnswers": [
-    { "trigger": "Press Enter when", "response": "" },
-    { "trigger": "Choose config location", "response": "__LOCATION__" },
-    { "trigger": "Add plugin automatically?", "response": "y" },
-    { "trigger": "Create one?", "response": "y" },
-    { "trigger": "Add browser-automation skill", "response": "n" },
-    { "trigger": "Check broker", "response": "n" }
-  ]
-}

package/src/steps/browser/index.js

@@ -1,91 +0,0 @@
-import { execa } from 'execa'
-import fse from 'fs-extra'
-import { code, header, info, success, warn, error } from '../../utils/exec.js'
-import os from 'os'
-import path from 'path'
-import { fileURLToPath } from 'url'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const BROWSER_PRESET_PATH = path.resolve(__dirname, '../../presets/browser.json')
-const browserPreset = await fse.readJson(BROWSER_PRESET_PATH)
-
-export async function installBrowser(ctx = {}) {
-  header('Step 9, Installing opencode-browser')
-
-  const installScope = ctx.installScope || 'local'
-  const locationAnswer = browserPreset.locationChoices?.[installScope] ?? browserPreset.locationChoices?.local ?? '2'
-
-  const pendingTriggers = browserPreset.autoAnswers.map(a => ({
-    ...a,
-    response: a.response === '__LOCATION__' ? locationAnswer : a.response,
-  }))
-
-  let extensionPathShown = false
-
-  try {
-    const child = execa(browserPreset.installer.command, browserPreset.installer.args, {
-      cwd: os.homedir(),
-      stdio: ['pipe', 'pipe', 'pipe'],
-      reject: false,
-    })
-
-    let show = false
-    const triggers = [...pendingTriggers]
-
-    child.stdout.on('data', (chunk) => {
-      const text = chunk.toString()
-
-      if (text.includes(browserPreset.output.showAfter)) show = true
-      if (text.includes(browserPreset.output.hideAfter)) show = false
-
-      if (show) process.stdout.write(chunk)
-
-      // Detect the extension path from the installer output to show it clearly
-      if (!extensionPathShown) {
-        const pathMatch = text.match(/(C:\\[^\s]+(?:extension|opencode-browser[^\s]*))/i) ||
-                          text.match(/((?:\/|~)[^\s]*(?:extension|opencode-browser[^\s]*))/i)
-        if (pathMatch) {
-          extensionPathShown = true
-        }
-      }
-
-      for (let i = 0; i < triggers.length; i++) {
-        if (text.includes(triggers[i].trigger)) {
-          // When the installer asks to press Enter after loading the extension,
-          // show the manual steps clearly before auto-answering
-          if (triggers[i].trigger === browserPreset.output.hideAfter) {
-            info('')
-            warn('Manual step required: load the browser extension before pressing Enter')
-            code([
-              '1. Open chrome://extensions',
-              '2. Enable Developer mode (top-right toggle)',
-              '3. Click "Load unpacked"',
-              '4. Select the extension folder shown above',
-              '5. Pin the extension: open the Extensions menu (puzzle icon) and click the pin',
-            ])
-            info('Auto-confirming in 5 seconds...')
-          }
-
-          child.stdin.write(`${triggers[i].response}\n`)
-          triggers.splice(i, 1)
-          break
-        }
-      }
-    })
-
-    child.stderr.on('data', (chunk) => process.stderr.write(chunk))
-
-    const result = await child
-
-    if (result.exitCode === 0) {
-      success('opencode-browser installed')
-      if (extensionPathShown) {
-        info('If you skipped loading the extension, run: npx @different-ai/opencode-browser@4.6.1 install')
-      }
-    } else {
-      warn('opencode-browser install exited with non-zero code')
-    }
-  } catch (err) {
-    error(`Failed to install opencode-browser: ${err.message}`)
-  }
-}