@plainconceptsplatform/agent-harness 3.3.1 → 3.4.1

package/cli/index.js

@@ -1,116 +1,116 @@
-#!/usr/bin/env node
-import chalk from 'chalk'
-import { createRequire } from 'node:module'
-import { runJoin } from './commands/join.js'
-import { runUpdate } from './commands/update.js'
-import { runSingleCommand } from './commands/single.js'
-import { runWizard } from './commands/wizard.js'
-import { exit } from './utils/process.js'
-import { runMigrateCommand } from './commands/migrate.js'
-import { findLegacyInstall } from './utils/legacy-check.js'
-
-function printHelp(version) {
-  console.log(`agent-harness v${version}`)
-  console.log()
-  console.log('Usage:')
-  console.log('  npx @plainconceptsplatform/agent-harness             Install the harness (full wizard)')
-  console.log('  npx @plainconceptsplatform/agent-harness <command>   Run a single step command')
-  console.log()
-  console.log('Commands:')
-  console.log('  update          Bring the harness up to date from saved config (no prompts)')
-  console.log('  migrate         Move a v1 (opencode-onboard) project to v2, keeping your content')
-  console.log('  join            Set up a teammate\'s machine (checks & local installs only)')
-  console.log('  clean           Run AI files cleanup step')
-  console.log('  platform        Run platform selection step')
-  console.log('  copy            Run content copy step')
-  console.log('  openspec        Run OpenSpec initialization step')
-  console.log('  models          Run models selection step')
-  console.log('  optimization    Run token optimization tools step')
-  console.log('  browser         Run agent-browser installer step')
-  console.log('  metadata        Write onboarding metadata step')
-  console.log()
-  console.log('Options:')
-  console.log('  -h, --help      Show this help message')
-}
-
-if (process.stdout.isTTY) console.clear()
-console.log()
-const require = createRequire(import.meta.url)
-const { version } = require('../package.json')
-const args = process.argv.slice(2)
-
-if (args.includes('-h') || args.includes('--help')) {
-  printHelp(version)
-  exit()
-}
-
-async function refuseLegacyInstall() {
-  const legacy = await findLegacyInstall()
-  if (!legacy) return false
-
-  console.log(chalk.red('This project was set up by opencode-onboard v1.'))
-  console.log()
-  if (legacy.files.length > 0) console.log(chalk.dim(`  config:  ${legacy.files.join(', ')}`))
-  if (legacy.skills.length > 0) {
-    const shown = legacy.skills.slice(0, 3).join(', ')
-    const rest = legacy.skills.length > 3 ? `, +${legacy.skills.length - 3} more` : ''
-    console.log(chalk.dim(`  skills:  ${shown}${rest}`))
-  }
-  console.log()
-  console.log('agent-harness v2 renamed both the config files and the skill prefix,')
-  console.log('and it does not migrate v1 projects. Continuing would leave the harness')
-  console.log('half-patched without reporting an error.')
-  console.log()
-  console.log('Migrate it, keeping your generated skills and custom engineers:')
-  console.log(chalk.dim('  npx @plainconceptsplatform/agent-harness migrate'))
-  console.log(chalk.dim('  npx @plainconceptsplatform/agent-harness update'))
-  console.log()
-  console.log(chalk.dim('Add --dry-run to see what migrate would change first.'))
-  return true
-}
-
-// Ctrl-C out of an @inquirer prompt throws ExitPromptError; that is a normal
-// cancellation, not a crash, so it must not exit non-zero.
-async function main() {
-  // migrate is the way out of a v1 project, so it must run before the guard
-  // that refuses v1 projects.
-  if (args[0] === 'migrate') {
-    await runMigrateCommand(args.slice(1))
-    return
-  }
-  if (await refuseLegacyInstall()) {
-    exit(1)
-    return
-  }
-  if (args.length === 0) {
-    await runWizard(version)
-    return
-  }
-  if (args[0] === 'join') {
-    await runJoin()
-    return
-  }
-  if (args[0] === 'update') {
-    await runUpdate()
-    return
-  }
-  if (!await runSingleCommand(args[0])) {
-    console.log(chalk.red(`Unknown command: ${args[0]}`))
-    console.log()
-    printHelp(version)
-    exit(1)
-  }
-}
-
-try {
-  await main()
-} catch (err) {
-  if (err.name === 'ExitPromptError') {
-    console.log()
-    console.log(chalk.yellow('Cancelled.'))
-  } else {
-    console.error(chalk.red('\nUnexpected error:'), err.message)
-    exit(1)
-  }
-}
-exit()
+#!/usr/bin/env node
+import chalk from 'chalk'
+import { createRequire } from 'node:module'
+import { runJoin } from './commands/join.js'
+import { runUpdate } from './commands/update.js'
+import { runSingleCommand } from './commands/single.js'
+import { runWizard } from './commands/wizard.js'
+import { exit } from './utils/process.js'
+import { runMigrateCommand } from './commands/migrate.js'
+import { findLegacyInstall } from './utils/legacy-check.js'
+
+function printHelp(version) {
+  console.log(`agent-harness v${version}`)
+  console.log()
+  console.log('Usage:')
+  console.log('  npx @plainconceptsplatform/agent-harness             Install the harness (full wizard)')
+  console.log('  npx @plainconceptsplatform/agent-harness <command>   Run a single step command')
+  console.log()
+  console.log('Commands:')
+  console.log('  update          Bring the harness up to date from saved config (no prompts)')
+  console.log('  migrate         Move a v1 (opencode-onboard) project to v2, keeping your content')
+  console.log('  join            Set up a teammate\'s machine (checks & local installs only)')
+  console.log('  clean           Run AI files cleanup step')
+  console.log('  platform        Run platform selection step')
+  console.log('  copy            Run content copy step')
+  console.log('  openspec        Run OpenSpec initialization step')
+  console.log('  models          Run models selection step')
+  console.log('  optimization    Run token optimization tools step')
+  console.log('  browser         Run agent-browser installer step')
+  console.log('  metadata        Write onboarding metadata step')
+  console.log()
+  console.log('Options:')
+  console.log('  -h, --help      Show this help message')
+}
+
+if (process.stdout.isTTY) console.clear()
+console.log()
+const require = createRequire(import.meta.url)
+const { version } = require('../package.json')
+const args = process.argv.slice(2)
+
+if (args.includes('-h') || args.includes('--help')) {
+  printHelp(version)
+  exit()
+}
+
+async function refuseLegacyInstall() {
+  const legacy = await findLegacyInstall()
+  if (!legacy) return false
+
+  console.log(chalk.red('This project was set up by opencode-onboard v1.'))
+  console.log()
+  if (legacy.files.length > 0) console.log(chalk.dim(`  config:  ${legacy.files.join(', ')}`))
+  if (legacy.skills.length > 0) {
+    const shown = legacy.skills.slice(0, 3).join(', ')
+    const rest = legacy.skills.length > 3 ? `, +${legacy.skills.length - 3} more` : ''
+    console.log(chalk.dim(`  skills:  ${shown}${rest}`))
+  }
+  console.log()
+  console.log('agent-harness v2 renamed both the config files and the skill prefix,')
+  console.log('and it does not migrate v1 projects. Continuing would leave the harness')
+  console.log('half-patched without reporting an error.')
+  console.log()
+  console.log('Migrate it, keeping your generated skills and custom engineers:')
+  console.log(chalk.dim('  npx @plainconceptsplatform/agent-harness migrate'))
+  console.log(chalk.dim('  npx @plainconceptsplatform/agent-harness update'))
+  console.log()
+  console.log(chalk.dim('Add --dry-run to see what migrate would change first.'))
+  return true
+}
+
+// Ctrl-C out of an @inquirer prompt throws ExitPromptError; that is a normal
+// cancellation, not a crash, so it must not exit non-zero.
+async function main() {
+  // migrate is the way out of a v1 project, so it must run before the guard
+  // that refuses v1 projects.
+  if (args[0] === 'migrate') {
+    await runMigrateCommand(args.slice(1))
+    return
+  }
+  if (await refuseLegacyInstall()) {
+    exit(1)
+    return
+  }
+  if (args.length === 0) {
+    await runWizard(version)
+    return
+  }
+  if (args[0] === 'join') {
+    await runJoin()
+    return
+  }
+  if (args[0] === 'update') {
+    await runUpdate()
+    return
+  }
+  if (!await runSingleCommand(args[0])) {
+    console.log(chalk.red(`Unknown command: ${args[0]}`))
+    console.log()
+    printHelp(version)
+    exit(1)
+  }
+}
+
+try {
+  await main()
+} catch (err) {
+  if (err.name === 'ExitPromptError') {
+    console.log()
+    console.log(chalk.yellow('Cancelled.'))
+  } else {
+    console.error(chalk.red('\nUnexpected error:'), err.message)
+    exit(1)
+  }
+}
+exit()

package/cli/presets/clean.json

@@ -1,21 +1,21 @@
-{
-  "preserve": ["DESIGN.md", "ARCHITECTURE.md", "openspec"],
-  "detectFiles": [
-    "AGENTS.md",
-    "CLAUDE.md",
-    "ARCHITECTURE.md",
-    "DESIGN.md",
-    ".cursorrules",
-    ".clinerules",
-    ".windsurfrules",
-    ".github/copilot-instructions.md",
-    "copilot-instructions.md",
-    ".aider.conf.yml",
-    ".aider",
-    ".opencode",
-    ".agents"
-  ],
-  "directoryTargets": [".opencode", ".agents"],
-  "preserveSubfolders": ["skills"],
-  "selectionMessage": "Select AI config files to remove:"
-}
+{
+  "preserve": ["DESIGN.md", "ARCHITECTURE.md", "openspec"],
+  "detectFiles": [
+    "AGENTS.md",
+    "CLAUDE.md",
+    "ARCHITECTURE.md",
+    "DESIGN.md",
+    ".cursorrules",
+    ".clinerules",
+    ".windsurfrules",
+    ".github/copilot-instructions.md",
+    "copilot-instructions.md",
+    ".aider.conf.yml",
+    ".aider",
+    ".opencode",
+    ".agents"
+  ],
+  "directoryTargets": [".opencode", ".agents"],
+  "preserveSubfolders": ["skills"],
+  "selectionMessage": "Select AI config files to remove:"
+}

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"
+  }
+]