@plainconceptsplatform/agent-harness 3.8.3 → 3.9.0-alpha.1

package/cli/presets/models.json

@@ -1,68 +1,68 @@
-{
-  "costTiers": [
-    { "max": 1, "label": "[$]" },
-    { "max": 10, "label": "[$$]" },
-    { "label": "[$$$]" }
-  ],
-  "providers": [
-    { "value": "opencode", "name": "OpenCode Zen" },
-    { "value": "opencode-go", "name": "OpenCode Go" },
-    { "value": "github-copilot", "name": "GitHub Copilot" },
-    { "value": "anthropic", "name": "Anthropic" },
-    { "value": "google",   "name": "Google" },
-    { "value": "openai",   "name": "OpenAI" },
-    { "value": "deepseek", "name": "DeepSeek" },
-    { "value": "",         "name": "Other (show all)" }
-  ],
-  "roles": {
-    "plan": {
-      "prompt": "Plan model:",
-      "info": [
-        "PLAN: main session: reads issues, writes proposals, coordinates the agent team.",
-        "Needs to be strong. A weak model here will silently skip steps and break the workflow."
-      ],
-      "suggestions": {
-        "opencode":        "opencode/claude-sonnet-4",
-        "opencode-go":     null,
-        "github-copilot":  "github-copilot/claude-sonnet-4.5",
-        "anthropic":       "anthropic/claude-sonnet-4-5",
-        "google":          "google/gemini-2.5-pro",
-        "openai":          "openai/o3",
-        "deepseek":        null
-      }
-    },
-    "build": {
-      "prompt": "Build model:",
-      "info": [
-        "BUILD: engineers: implements code, runs tests, commits.",
-        "Code quality matters here. DeepSeek V4 is outstanding value. Claude Sonnet is the gold standard."
-      ],
-      "suggestions": {
-        "opencode":        "opencode/deepseek-v4-flash",
-        "opencode-go":     "opencode-go/deepseek-v4-pro",
-        "github-copilot":  "github-copilot/claude-sonnet-4.5",
-        "anthropic":       "anthropic/claude-sonnet-4-5",
-        "google":          "google/gemini-2.5-flash",
-        "openai":          "openai/gpt-4.1",
-        "deepseek":        "deepseek/deepseek-v4-pro"
-      },
-      "agents": ["fullstack-engineer"]
-    },
-    "fast": {
-      "prompt": "Fast model:",
-      "info": [
-        "FAST: light commands: /pc-pullrequest, /pc-explore, /pc-archive, status checks.",
-        "No heavy reasoning needed. Cheap and fast is the right call here."
-      ],
-      "suggestions": {
-        "opencode":        "opencode/glm-4.7",
-        "opencode-go":     "opencode-go/qwen3.6-plus",
-        "github-copilot":  "github-copilot/gpt-5.4-nano",
-        "anthropic":       "anthropic/claude-haiku-4-5",
-        "google":          "google/gemini-2.0-flash",
-        "openai":          "openai/gpt-4o-mini",
-        "deepseek":        null
-      }
-    }
-  }
-}
+{
+  "costTiers": [
+    { "max": 1, "label": "[$]" },
+    { "max": 10, "label": "[$$]" },
+    { "label": "[$$$]" }
+  ],
+  "providers": [
+    { "value": "opencode", "name": "OpenCode Zen" },
+    { "value": "opencode-go", "name": "OpenCode Go" },
+    { "value": "github-copilot", "name": "GitHub Copilot" },
+    { "value": "anthropic", "name": "Anthropic" },
+    { "value": "google",   "name": "Google" },
+    { "value": "openai",   "name": "OpenAI" },
+    { "value": "deepseek", "name": "DeepSeek" },
+    { "value": "",         "name": "Other (show all)" }
+  ],
+  "roles": {
+    "plan": {
+      "prompt": "Plan model:",
+      "info": [
+        "PLAN: main session: reads issues, writes proposals, coordinates the agent team.",
+        "Needs to be strong. A weak model here will silently skip steps and break the workflow."
+      ],
+      "suggestions": {
+        "opencode":        "opencode/claude-sonnet-4",
+        "opencode-go":     null,
+        "github-copilot":  "github-copilot/claude-sonnet-4.5",
+        "anthropic":       "anthropic/claude-sonnet-4-5",
+        "google":          "google/gemini-2.5-pro",
+        "openai":          "openai/o3",
+        "deepseek":        null
+      }
+    },
+    "build": {
+      "prompt": "Build model:",
+      "info": [
+        "BUILD: engineers: implements code, runs tests, commits.",
+        "Code quality matters here. DeepSeek V4 is outstanding value. Claude Sonnet is the gold standard."
+      ],
+      "suggestions": {
+        "opencode":        "opencode/deepseek-v4-flash",
+        "opencode-go":     "opencode-go/deepseek-v4-pro",
+        "github-copilot":  "github-copilot/claude-sonnet-4.5",
+        "anthropic":       "anthropic/claude-sonnet-4-5",
+        "google":          "google/gemini-2.5-flash",
+        "openai":          "openai/gpt-4.1",
+        "deepseek":        "deepseek/deepseek-v4-pro"
+      },
+      "agents": ["fullstack-engineer"]
+    },
+    "fast": {
+      "prompt": "Fast model:",
+      "info": [
+        "FAST: light commands: /pc-pullrequest, /pc-explore, /pc-archive, status checks.",
+        "No heavy reasoning needed. Cheap and fast is the right call here."
+      ],
+      "suggestions": {
+        "opencode":        "opencode/glm-4.7",
+        "opencode-go":     "opencode-go/qwen3.6-plus",
+        "github-copilot":  "github-copilot/gpt-5.4-nano",
+        "anthropic":       "anthropic/claude-haiku-4-5",
+        "google":          "google/gemini-2.0-flash",
+        "openai":          "openai/gpt-4o-mini",
+        "deepseek":        null
+      }
+    }
+  }
+}

package/cli/presets/optimization.json

@@ -1,32 +1,32 @@
-{
-  "message": "Enable tools:",
-  "info": "Choose which optimization tools to enable (recommended: all).",
-  "timeoutMs": 30000,
-  "choices": [
-    {
-      "name": "RTK check (recommended)",
-      "value": "rtk",
-      "checked": true
-    },
-    {
-      "name": "Simple English concise mode (recommended)",
-      "value": "simpleEnglish",
-      "checked": true
-    },
-    {
-      "name": "codegraph semantic index (recommended)",
-      "value": "codegraph",
-      "checked": true
-    },
-    {
-      "name": "agentmemory local memory server",
-      "value": "memory",
-      "checked": true
-    },
-    {
-      "name": "humanizer skill (removes AI writing patterns)",
-      "value": "humanizer",
-      "checked": true
-    }
-  ]
-}
+{
+  "message": "Enable tools:",
+  "info": "Choose which optimization tools to enable (recommended: all).",
+  "timeoutMs": 30000,
+  "choices": [
+    {
+      "name": "RTK check (recommended)",
+      "value": "rtk",
+      "checked": true
+    },
+    {
+      "name": "Simple English concise mode (recommended)",
+      "value": "simpleEnglish",
+      "checked": true
+    },
+    {
+      "name": "codegraph semantic index (recommended)",
+      "value": "codegraph",
+      "checked": true
+    },
+    {
+      "name": "agentmemory local memory server",
+      "value": "memory",
+      "checked": true
+    },
+    {
+      "name": "humanizer skill (removes AI writing patterns)",
+      "value": "humanizer",
+      "checked": true
+    }
+  ]
+}

package/cli/presets/platforms.json

@@ -1,76 +1,76 @@
-[
-  {
-    "value": "github",
-    "name": "GitHub",
-    "cli": {
-      "command": "gh",
-      "displayName": "GitHub CLI (gh)",
-      "installUrl": "https://cli.github.com",
-      "authCheck": {
-        "args": ["auth", "status"],
-        "notAuthenticatedMessage": "GitHub CLI not authenticated. Run:",
-        "commands": ["gh auth login"]
-      }
-    }
-  },
-  {
-    "value": "azure",
-    "name": "Azure DevOps",
-    "cli": {
-      "command": "az",
-      "displayName": "Azure CLI (az)",
-      "installUrl": "https://learn.microsoft.com/en-us/cli/azure/install-azure-cli",
-      "extensionCheck": {
-        "args": ["extension", "list", "--query", "[?name=='azure-devops']", "-o", "tsv"],
-        "expectedOutput": "azure-devops",
-        "missingMessage": "azure-devops extension not found. Run:",
-        "errorMessage": "Could not check azure-devops extension. Run:",
-        "commands": [
-          "az extension add --name azure-devops",
-          "az config set extension.dynamic_install_allow_preview=true",
-          "az login",
-          "az devops login --organization https://dev.azure.com/<your-org>"
-        ]
-      }
-    }
-  },
-  {
-    "value": "jira",
-    "name": "Jira (Atlassian)",
-    "backlogOnly": true,
-    "cli": {
-      "command": "acli",
-      "displayName": "Atlassian CLI (acli)",
-      "installUrl": "https://developer.atlassian.com/cloud/acli/guides/install-acli/",
-      "authCheck": {
-        "args": ["jira", "auth", "status"],
-        "notAuthenticatedMessage": "Atlassian CLI not authenticated. Run:",
-        "commands": ["acli jira auth login --site <yoursite>.atlassian.net --email <email> --token"]
-      }
-    }
-  },
-  {
-    "value": "gitlab",
-    "name": "GitLab",
-    "repoOnly": true,
-    "cli": {
-      "command": "glab",
-      "displayName": "GitLab CLI (glab)",
-      "installUrl": "https://gitlab.com/gitlab-org/cli/#installation",
-      "authCheck": {
-        "args": ["auth", "status"],
-        "notAuthenticatedMessage": "GitLab CLI not authenticated. Run:",
-        "commands": ["glab auth login"]
-      }
-    }
-  },
-  {
-    "value": "browser",
-    "name": "Others (Browser)",
-    "backlogOnly": true
-  },
-  {
-    "value": "none",
-    "name": "None"
-  }
-]
+[
+  {
+    "value": "github",
+    "name": "GitHub",
+    "cli": {
+      "command": "gh",
+      "displayName": "GitHub CLI (gh)",
+      "installUrl": "https://cli.github.com",
+      "authCheck": {
+        "args": ["auth", "status"],
+        "notAuthenticatedMessage": "GitHub CLI not authenticated. Run:",
+        "commands": ["gh auth login"]
+      }
+    }
+  },
+  {
+    "value": "azure",
+    "name": "Azure DevOps",
+    "cli": {
+      "command": "az",
+      "displayName": "Azure CLI (az)",
+      "installUrl": "https://learn.microsoft.com/en-us/cli/azure/install-azure-cli",
+      "extensionCheck": {
+        "args": ["extension", "list", "--query", "[?name=='azure-devops']", "-o", "tsv"],
+        "expectedOutput": "azure-devops",
+        "missingMessage": "azure-devops extension not found. Run:",
+        "errorMessage": "Could not check azure-devops extension. Run:",
+        "commands": [
+          "az extension add --name azure-devops",
+          "az config set extension.dynamic_install_allow_preview=true",
+          "az login",
+          "az devops login --organization https://dev.azure.com/<your-org>"
+        ]
+      }
+    }
+  },
+  {
+    "value": "jira",
+    "name": "Jira (Atlassian)",
+    "backlogOnly": true,
+    "cli": {
+      "command": "acli",
+      "displayName": "Atlassian CLI (acli)",
+      "installUrl": "https://developer.atlassian.com/cloud/acli/guides/install-acli/",
+      "authCheck": {
+        "args": ["jira", "auth", "status"],
+        "notAuthenticatedMessage": "Atlassian CLI not authenticated. Run:",
+        "commands": ["acli jira auth login --site <yoursite>.atlassian.net --email <email> --token"]
+      }
+    }
+  },
+  {
+    "value": "gitlab",
+    "name": "GitLab",
+    "repoOnly": true,
+    "cli": {
+      "command": "glab",
+      "displayName": "GitLab CLI (glab)",
+      "installUrl": "https://gitlab.com/gitlab-org/cli/#installation",
+      "authCheck": {
+        "args": ["auth", "status"],
+        "notAuthenticatedMessage": "GitLab CLI not authenticated. Run:",
+        "commands": ["glab auth login"]
+      }
+    }
+  },
+  {
+    "value": "browser",
+    "name": "Others (Browser)",
+    "backlogOnly": true
+  },
+  {
+    "value": "none",
+    "name": "None"
+  }
+]

package/cli/presets/source.json

@@ -1,23 +1,23 @@
-{
-  "message": "Source code location:",
-  "default": "current",
-  "choices": [
-    {
-      "name": "Current folder (default)",
-      "value": "current",
-      "description": "Use this repository only"
-    },
-    {
-      "name": "Select folders in parent (../)",
-      "value": "parent",
-      "description": "Use when this repo only contains agent config"
-    },
-    {
-      "name": "Select child folders (./*/)",
-      "value": "children",
-      "description": "Use when source code lives in subdirectories of this repo"
-    }
-  ],
-  "parentSelectionMessage": "Select source folders from parent directory:",
-  "childrenSelectionMessage": "Select child folders to include as source:"
-}
+{
+  "message": "Source code location:",
+  "default": "current",
+  "choices": [
+    {
+      "name": "Current folder (default)",
+      "value": "current",
+      "description": "Use this repository only"
+    },
+    {
+      "name": "Select folders in parent (../)",
+      "value": "parent",
+      "description": "Use when this repo only contains agent config"
+    },
+    {
+      "name": "Select child folders (./*/)",
+      "value": "children",
+      "description": "Use when source code lives in subdirectories of this repo"
+    }
+  ],
+  "parentSelectionMessage": "Select source folders from parent directory:",
+  "childrenSelectionMessage": "Select child folders to include as source:"
+}

package/cli/steps/browser/index.js

@@ -1,48 +1,52 @@
-import { execa } from 'execa'
-import fse from 'fs-extra'
-import { 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() {
-  header('Step 9, Installing agent-browser')
-
-  try {
-    const install = await execa(browserPreset.installer.command, browserPreset.installer.args, {
-      cwd: os.homedir(),
-      reject: false,
-    })
-
-    if (install.exitCode !== 0) {
-      warn('agent-browser npm install exited with non-zero code')
-      if (install.stderr) info(install.stderr)
-      return
-    }
-    success('agent-browser installed')
-  } catch (err) {
-    error(`Failed to install agent-browser: ${err.message}`)
-    return
-  }
-
-  try {
-    const chrome = await execa(browserPreset.chromeSetup.command, browserPreset.chromeSetup.args, {
-      cwd: os.homedir(),
-      reject: false,
-    })
-
-    if (chrome.exitCode === 0) {
-      success('agent-browser Chrome ready')
-      if (chrome.stdout) info(chrome.stdout.trim())
-    } else {
-      warn('agent-browser install (Chrome setup) exited with non-zero code')
-      if (chrome.stderr) info(chrome.stderr)
-    }
-  } catch (err) {
-    error(`Failed to set up Chrome for agent-browser: ${err.message}`)
-  }
-}
+import { execa } from 'execa'
+import fse from 'fs-extra'
+import { 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() {
+  header('Step 9, Installing browse')
+
+  try {
+    const install = await execa(browserPreset.installer.command, browserPreset.installer.args, {
+      cwd: os.homedir(),
+      reject: false,
+    })
+
+    if (install.exitCode !== 0) {
+      warn('browse npm install exited with non-zero code')
+      if (install.stderr) info(install.stderr)
+      return
+    }
+    success('browse installed')
+  } catch (err) {
+    error(`Failed to install browse: ${err.message}`)
+    return
+  }
+
+  try {
+    const setup = await execa(browserPreset.setup.command, browserPreset.setup.args, {
+      cwd: os.homedir(),
+      reject: false,
+      timeout: 180000,
+    })
+
+    if (setup.exitCode === 0) {
+      success('browse paired with your browser')
+      if (setup.stdout) info(setup.stdout.trim())
+    } else {
+      // browse install opens the Chrome Web Store and waits for the extension to connect.
+      // A non-zero exit often just means the user didn't finish pairing in time; browse is
+      // still installed and usable once they add the extension and run `browse pair`.
+      warn('browse setup did not complete — install the extension and run `browse pair`')
+      if (setup.stderr) info(setup.stderr)
+    }
+  } catch (err) {
+    error(`Failed to set up browse: ${err.message}`)
+  }
+}