@plainconceptsplatform/agent-harness 2.0.0 → 2.0.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plainconceptsplatform/agent-harness",
-  "version": "2.0.0",
-  "description": "Installs and maintains an agent harness in any codebase. Wires OpenCode, OpenSpec, codegraph, and agentmemory into a multi-agent development workflow powered by native parallel subagents.",
+  "version": "2.0.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",
     "ai",
@@ -28,9 +28,9 @@
   },
   "files": [
     "src",
+    "src/content",
     "!src/**/*.test.js",
     "!src/**/__tests__",
-    "src/content",
     "!src/content/**/node_modules"
   ],
   "publishConfig": {

package/src/commands/join.js

@@ -1,244 +1,244 @@
-import chalk from 'chalk'
-import { execa } from 'execa'
-import fse from 'fs-extra'
-import path from 'node:path'
-import { parse as parseJsonc } from 'jsonc-parser'
-import { installBrowser } from '../steps/browser/index.js'
-import { checkRtk } from '../steps/optimization/index.js'
-import { checkPlatform } from '../steps/platform/index.js'
-import { commandExists, header, info, loading, success, warn } from '../utils/exec.js'
-import { IGNORED_ENTRIES, USER_CONFIG_FILE } from '../utils/paths.js'
-import { readHarnessConfig } from './shared.js'
-
-export async function runJoin() {
-  const logo = chalk.hex('#fe3d57')
-  console.log()
-  console.log(logo('  🤝 agent-harness join'))
-  console.log(chalk.dim('  New team member setup: checks & local installs only.'))
-  console.log(chalk.dim('  Does not modify committed project files.'))
-  console.log()
-
-  const saved = await readHarnessConfig()
-
-  if (!saved) {
-    warn('No .opencode/harness.json found.')
-    warn('This project may not have been onboarded yet. Run `npx @plainconceptsplatform/agent-harness` first.')
-    return
-  }
-
-  const backlogPlatform = saved?.platform?.backlog
-  const repoPlatform = saved?.platform?.repo
-  const installScope = 'local'
-  const teamModels = saved?.models ?? {}
-
-  const opencodeDir = path.join(process.cwd(), '.opencode')
-  const opencodeJsonPath = path.join(process.cwd(), 'opencode.jsonc')
-
-  // Step 1: Platform CLI check
-  header('Step 1, Platform CLI check')
-  const platformsToCheck = [...new Set([backlogPlatform, repoPlatform])].filter(p => p && p !== 'none')
-  if (platformsToCheck.length === 0) {
-    info('No platform integration selected, skipping CLI checks.')
-  } else {
-    for (const p of platformsToCheck) {
-      const display = p === 'github' ? 'GitHub' : p === 'azure' ? 'Azure DevOps' : p
-      info(`Checking platform: ${display}`)
-      await checkPlatform(p)
-    }
-  }
-
-  // Step 2: Install OpenCode plugins
-  header('Step 2, Installing OpenCode plugins')
-  const pkgPath = path.join(opencodeDir, 'package.json')
-  if (await fse.pathExists(pkgPath)) {
-    try {
-      await execa('npm', ['install'], { cwd: opencodeDir, reject: false, stdio: 'pipe' })
-      success('OpenCode plugins installed')
-    } catch {
-      warn('npm install failed in .opencode/: plugins may not load correctly')
-    }
-  } else {
-    warn('No .opencode/package.json found: skipping plugin install')
-  }
-
-  // Step 3: Install/update skills
-  header('Step 3, Installing skills')
-  try {
-    await execa('npx', ['skills'], { cwd: process.cwd(), reject: false, stdio: 'pipe' })
-    success('Skills installed/updated')
-  } catch {
-    warn('npx skills failed: skills may be missing')
-  }
-
-  // Step 4: OpenSpec CLI check
-  header('Step 4, Checking OpenSpec')
-  const openspecAvailable = await commandExists('openspec')
-  if (openspecAvailable) {
-    success('OpenSpec CLI is available')
-  } else {
-    info('OpenSpec not found on PATH: installing...')
-    try {
-      const result = await execa('npm', ['install', '@fission-ai/openspec', '--global'], {
-        cwd: process.cwd(),
-        reject: false,
-        stdio: 'pipe',
-      })
-      if (result.exitCode === 0) {
-        success('OpenSpec installed')
-      } else {
-        warn('OpenSpec install failed: run `npm install -g @fission-ai/openspec` manually')
-      }
-    } catch {
-      warn('OpenSpec install failed: run `npm install -g @fission-ai/openspec` manually')
-    }
-  }
-
-  // Step 5: agentmemory (if project uses it)
-  header('Step 5, Checking agentmemory')
-  let cfg = {}
-  if (await fse.pathExists(opencodeJsonPath)) {
-    try {
-      const errors = []
-      cfg = parseJsonc(await fse.readFile(opencodeJsonPath, 'utf-8'), errors)
-      if (errors.length > 0) cfg = {}
-    } catch {
-      // ignore config read errors
-    }
-  }
-
-  if (cfg?.mcp?.['agentmemory']) {
-    info('Project uses agentmemory MCP')
-    loading('checking agentmemory server...')
-
-    // Check if agentmemory is installed
-    const agentmemoryAvailable = await commandExists('agentmemory')
-    if (agentmemoryAvailable) {
-      success('agentmemory CLI is available')
-    } else {
-      info('agentmemory not found on PATH, installing...')
-      try {
-        const installResult = await execa('npm', ['install', '-g', '@agentmemory/agentmemory'], {
-          reject: false,
-          timeout: 300000,
-          stdio: 'pipe',
-        })
-        if (installResult.exitCode === 0) {
-          success('agentmemory installed')
-        } else {
-          warn('agentmemory install failed, run `npm install -g @agentmemory/agentmemory` manually')
-        }
-      } catch (err) {
-        warn(`agentmemory install failed: ${err.message}`)
-      }
-    }
-
-    // Health-check the server
-    try {
-      const healthResult = await execa('curl', ['-s', '-o', '/dev/null', '-w', '%{http_code}', 'http://localhost:3111/agentmemory/health'], {
-        reject: false,
-        timeout: 5000,
-      })
-      if (healthResult.stdout.trim() === '200') {
-        success('agentmemory server is running')
-      } else {
-        info('agentmemory server not running, start it with `agentmemory` in a separate terminal')
-      }
-    } catch {
-      info('agentmemory server not running, start it with `agentmemory` in a separate terminal')
-    }
-  } else {
-    info('agentmemory not configured for this project, skipping')
-  }
-
-  // Step 6: Codegraph (if project uses it)
-  header('Step 6, Checking codegraph')
-  if (cfg?.mcp?.['codegraph']) {
-    info('Project uses codegraph MCP: building index...')
-    try {
-      const result = await execa('npx', ['--yes', '@colbymchenry/codegraph', 'init', '-i'], {
-        cwd: process.cwd(),
-        reject: false,
-        stdio: 'pipe',
-        timeout: 120000,
-      })
-      if (result.exitCode === 0) {
-        success('codegraph index initialized')
-      } else {
-        warn('codegraph init failed: codegraph_search may be slow or unavailable')
-      }
-    } catch {
-      warn('codegraph init failed: codegraph_search may be slow or unavailable')
-    }
-  } else {
-    info('codegraph not configured for this project: skipping')
-  }
-
-  // Step 7: RTK check
-  header('Step 7, Checking rtk')
-  await checkRtk({ skipHeader: true, skipPrompt: true })
-
-  // Step 8: Browser extension
-  header('Step 8, Installing opencode-browser')
-  await installBrowser({ installScope })
-
-  // Step 9: Model tier guidance
-  header('Step 9, Model tiers')
-  const userConfigPath = path.join(opencodeDir, USER_CONFIG_FILE)
-  const hasUserOverride = await fse.pathExists(userConfigPath)
-
-  if (teamModels && Object.keys(teamModels).length > 0) {
-    info('Team model configuration:')
-    for (const [tier, model] of Object.entries(teamModels)) {
-      info(`  ${tier}: ${model}`)
-    }
-    console.log()
-
-    if (hasUserOverride) {
-      info('You have a local model override (harness.user.json).')
-      info('To change: /make-user-model user <tier> <model>')
-    } else {
-      info('No local override: using team defaults.')
-      info('To override a tier for your machine: /make-user-model user <tier> <model>')
-      info('  e.g. /make-user-model user build current')
-    }
-    console.log()
-    info('The pc-subagent-tiers plugin will generate *-engineer.<tier>.md variants')
-    info('on opencode startup from these model configs.')
-  } else {
-    warn('No model tiers configured in harness.json.')
-    warn('Run /make-user-model <tier> <model> for plan, build, and fast.')
-  }
-
-  // Step 10: Ensure .opencode/.gitignore exists
-  header('Step 10, Checking .opencode/.gitignore')
-  const gitignorePath = path.join(opencodeDir, '.gitignore')
-  const requiredEntries = IGNORED_ENTRIES
-
-  if (await fse.pathExists(gitignorePath)) {
-    const content = await fse.readFile(gitignorePath, 'utf-8')
-    const existing = content.split('\n').map(l => l.trim()).filter(Boolean)
-    const missing = requiredEntries.filter(e => !existing.includes(e))
-    if (missing.length > 0) {
-      const merged = `${[...existing, ...missing].join('\n')}\n`
-      await fse.writeFile(gitignorePath, merged, 'utf-8')
-      success(`Merged ${missing.length} missing .gitignore entries`)
-    } else {
-      success('.gitignore is up to date')
-    }
-  } else {
-    await fse.writeFile(gitignorePath, `${requiredEntries.join('\n')}\n`, 'utf-8')
-    success('Created .opencode/.gitignore')
-  }
-
-  console.log()
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log(chalk.bold.green('  Join setup complete!'))
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log()
-  console.log('  Your local environment is ready.')
-  if (teamModels && Object.keys(teamModels).length > 0 && !hasUserOverride) {
-    console.log(chalk.dim('  Tip: Run /make-user-model user <tier> current to override team models locally.'))
-  }
-  console.log(chalk.dim('  Restart opencode to pick up tier agent variants.'))
-  console.log()
-}
+import chalk from 'chalk'
+import { execa } from 'execa'
+import fse from 'fs-extra'
+import path from 'node:path'
+import { parse as parseJsonc } from 'jsonc-parser'
+import { installBrowser } from '../steps/browser/index.js'
+import { checkRtk } from '../steps/optimization/index.js'
+import { checkPlatform } from '../steps/platform/index.js'
+import { commandExists, header, info, loading, success, warn } from '../utils/exec.js'
+import { IGNORED_ENTRIES, USER_CONFIG_FILE } from '../utils/paths.js'
+import { readHarnessConfig } from './shared.js'
+
+export async function runJoin() {
+  const logo = chalk.hex('#fe3d57')
+  console.log()
+  console.log(logo('  🤝 agent-harness join'))
+  console.log(chalk.dim('  New team member setup: checks & local installs only.'))
+  console.log(chalk.dim('  Does not modify committed project files.'))
+  console.log()
+
+  const saved = await readHarnessConfig()
+
+  if (!saved) {
+    warn('No .opencode/harness.json found.')
+    warn('This project may not have been onboarded yet. Run `npx @plainconceptsplatform/agent-harness` first.')
+    return
+  }
+
+  const backlogPlatform = saved?.platform?.backlog
+  const repoPlatform = saved?.platform?.repo
+  const installScope = 'local'
+  const teamModels = saved?.models ?? {}
+
+  const opencodeDir = path.join(process.cwd(), '.opencode')
+  const opencodeJsonPath = path.join(process.cwd(), 'opencode.jsonc')
+
+  // Step 1: Platform CLI check
+  header('Step 1, Platform CLI check')
+  const platformsToCheck = [...new Set([backlogPlatform, repoPlatform])].filter(p => p && p !== 'none')
+  if (platformsToCheck.length === 0) {
+    info('No platform integration selected, skipping CLI checks.')
+  } else {
+    for (const p of platformsToCheck) {
+      const display = p === 'github' ? 'GitHub' : p === 'azure' ? 'Azure DevOps' : p
+      info(`Checking platform: ${display}`)
+      await checkPlatform(p)
+    }
+  }
+
+  // Step 2: Install OpenCode plugins
+  header('Step 2, Installing OpenCode plugins')
+  const pkgPath = path.join(opencodeDir, 'package.json')
+  if (await fse.pathExists(pkgPath)) {
+    try {
+      await execa('npm', ['install'], { cwd: opencodeDir, reject: false, stdio: 'pipe' })
+      success('OpenCode plugins installed')
+    } catch {
+      warn('npm install failed in .opencode/: plugins may not load correctly')
+    }
+  } else {
+    warn('No .opencode/package.json found: skipping plugin install')
+  }
+
+  // Step 3: Install/update skills
+  header('Step 3, Installing skills')
+  try {
+    await execa('npx', ['skills'], { cwd: process.cwd(), reject: false, stdio: 'pipe' })
+    success('Skills installed/updated')
+  } catch {
+    warn('npx skills failed: skills may be missing')
+  }
+
+  // Step 4: OpenSpec CLI check
+  header('Step 4, Checking OpenSpec')
+  const openspecAvailable = await commandExists('openspec')
+  if (openspecAvailable) {
+    success('OpenSpec CLI is available')
+  } else {
+    info('OpenSpec not found on PATH: installing...')
+    try {
+      const result = await execa('npm', ['install', '@fission-ai/openspec', '--global'], {
+        cwd: process.cwd(),
+        reject: false,
+        stdio: 'pipe',
+      })
+      if (result.exitCode === 0) {
+        success('OpenSpec installed')
+      } else {
+        warn('OpenSpec install failed: run `npm install -g @fission-ai/openspec` manually')
+      }
+    } catch {
+      warn('OpenSpec install failed: run `npm install -g @fission-ai/openspec` manually')
+    }
+  }
+
+  // Step 5: agentmemory (if project uses it)
+  header('Step 5, Checking agentmemory')
+  let cfg = {}
+  if (await fse.pathExists(opencodeJsonPath)) {
+    try {
+      const errors = []
+      cfg = parseJsonc(await fse.readFile(opencodeJsonPath, 'utf-8'), errors)
+      if (errors.length > 0) cfg = {}
+    } catch {
+      // ignore config read errors
+    }
+  }
+
+  if (cfg?.mcp?.['agentmemory']) {
+    info('Project uses agentmemory MCP')
+    loading('checking agentmemory server...')
+
+    // Check if agentmemory is installed
+    const agentmemoryAvailable = await commandExists('agentmemory')
+    if (agentmemoryAvailable) {
+      success('agentmemory CLI is available')
+    } else {
+      info('agentmemory not found on PATH, installing...')
+      try {
+        const installResult = await execa('npm', ['install', '-g', '@agentmemory/agentmemory'], {
+          reject: false,
+          timeout: 300000,
+          stdio: 'pipe',
+        })
+        if (installResult.exitCode === 0) {
+          success('agentmemory installed')
+        } else {
+          warn('agentmemory install failed, run `npm install -g @agentmemory/agentmemory` manually')
+        }
+      } catch (err) {
+        warn(`agentmemory install failed: ${err.message}`)
+      }
+    }
+
+    // Health-check the server
+    try {
+      const healthResult = await execa('curl', ['-s', '-o', '/dev/null', '-w', '%{http_code}', 'http://localhost:3111/agentmemory/health'], {
+        reject: false,
+        timeout: 5000,
+      })
+      if (healthResult.stdout.trim() === '200') {
+        success('agentmemory server is running')
+      } else {
+        info('agentmemory server not running, start it with `agentmemory` in a separate terminal')
+      }
+    } catch {
+      info('agentmemory server not running, start it with `agentmemory` in a separate terminal')
+    }
+  } else {
+    info('agentmemory not configured for this project, skipping')
+  }
+
+  // Step 6: Codegraph (if project uses it)
+  header('Step 6, Checking codegraph')
+  if (cfg?.mcp?.['codegraph']) {
+    info('Project uses codegraph MCP: building index...')
+    try {
+      const result = await execa('npx', ['--yes', '@colbymchenry/codegraph', 'init', '-i'], {
+        cwd: process.cwd(),
+        reject: false,
+        stdio: 'pipe',
+        timeout: 120000,
+      })
+      if (result.exitCode === 0) {
+        success('codegraph index initialized')
+      } else {
+        warn('codegraph init failed: codegraph_search may be slow or unavailable')
+      }
+    } catch {
+      warn('codegraph init failed: codegraph_search may be slow or unavailable')
+    }
+  } else {
+    info('codegraph not configured for this project: skipping')
+  }
+
+  // Step 7: RTK check
+  header('Step 7, Checking rtk')
+  await checkRtk({ skipHeader: true, skipPrompt: true })
+
+  // Step 8: Browser extension
+  header('Step 8, Installing opencode-browser')
+  await installBrowser({ installScope })
+
+  // Step 9: Model tier guidance
+  header('Step 9, Model tiers')
+  const userConfigPath = path.join(opencodeDir, USER_CONFIG_FILE)
+  const hasUserOverride = await fse.pathExists(userConfigPath)
+
+  if (teamModels && Object.keys(teamModels).length > 0) {
+    info('Team model configuration:')
+    for (const [tier, model] of Object.entries(teamModels)) {
+      info(`  ${tier}: ${model}`)
+    }
+    console.log()
+
+    if (hasUserOverride) {
+      info('You have a local model override (harness.user.json).')
+      info('To change: /make-user-model user <tier> <model>')
+    } else {
+      info('No local override: using team defaults.')
+      info('To override a tier for your machine: /make-user-model user <tier> <model>')
+      info('  e.g. /make-user-model user build current')
+    }
+    console.log()
+    info('The pc-subagent-tiers plugin will generate *-engineer.<tier>.md variants')
+    info('on opencode startup from these model configs.')
+  } else {
+    warn('No model tiers configured in harness.json.')
+    warn('Run /make-user-model <tier> <model> for plan, build, and fast.')
+  }
+
+  // Step 10: Ensure .opencode/.gitignore exists
+  header('Step 10, Checking .opencode/.gitignore')
+  const gitignorePath = path.join(opencodeDir, '.gitignore')
+  const requiredEntries = IGNORED_ENTRIES
+
+  if (await fse.pathExists(gitignorePath)) {
+    const content = await fse.readFile(gitignorePath, 'utf-8')
+    const existing = content.split('\n').map(l => l.trim()).filter(Boolean)
+    const missing = requiredEntries.filter(e => !existing.includes(e))
+    if (missing.length > 0) {
+      const merged = `${[...existing, ...missing].join('\n')}\n`
+      await fse.writeFile(gitignorePath, merged, 'utf-8')
+      success(`Merged ${missing.length} missing .gitignore entries`)
+    } else {
+      success('.gitignore is up to date')
+    }
+  } else {
+    await fse.writeFile(gitignorePath, `${requiredEntries.join('\n')}\n`, 'utf-8')
+    success('Created .opencode/.gitignore')
+  }
+
+  console.log()
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log(chalk.bold.green('  Join setup complete!'))
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log()
+  console.log('  Your local environment is ready.')
+  if (teamModels && Object.keys(teamModels).length > 0 && !hasUserOverride) {
+    console.log(chalk.dim('  Tip: Run /make-user-model user <tier> current to override team models locally.'))
+  }
+  console.log(chalk.dim('  Restart opencode to pick up tier agent variants.'))
+  console.log()
+}

package/src/commands/shared.js

@@ -1,27 +1,27 @@
-import { execa } from 'execa'
-import fse from 'fs-extra'
-import { configPath } from '../utils/paths.js'
-
-export async function readHarnessConfig() {
-  const cfgPath = configPath()
-  if (!await fse.pathExists(cfgPath)) return null
-  try {
-    return await fse.readJson(cfgPath)
-  } catch {
-    return null
-  }
-}
-
-export async function ensureGitLongpaths(cwd = process.cwd()) {
-  // core.longpaths only matters on Windows; don't touch repo config elsewhere.
-  if (process.platform !== 'win32') return false
-  try {
-    const repoCheck = await execa('git', ['rev-parse', '--is-inside-work-tree'], { cwd, reject: false })
-    if (repoCheck.exitCode !== 0 || repoCheck.stdout.trim() !== 'true') return false
-
-    const configResult = await execa('git', ['config', 'core.longpaths', 'true'], { cwd, reject: false })
-    return configResult.exitCode === 0
-  } catch {
-    return false
-  }
-}
+import { execa } from 'execa'
+import fse from 'fs-extra'
+import { configPath } from '../utils/paths.js'
+
+export async function readHarnessConfig() {
+  const cfgPath = configPath()
+  if (!await fse.pathExists(cfgPath)) return null
+  try {
+    return await fse.readJson(cfgPath)
+  } catch {
+    return null
+  }
+}
+
+export async function ensureGitLongpaths(cwd = process.cwd()) {
+  // core.longpaths only matters on Windows; don't touch repo config elsewhere.
+  if (process.platform !== 'win32') return false
+  try {
+    const repoCheck = await execa('git', ['rev-parse', '--is-inside-work-tree'], { cwd, reject: false })
+    if (repoCheck.exitCode !== 0 || repoCheck.stdout.trim() !== 'true') return false
+
+    const configResult = await execa('git', ['config', 'core.longpaths', 'true'], { cwd, reject: false })
+    return configResult.exitCode === 0
+  } catch {
+    return false
+  }
+}