@plainconceptsplatform/agent-harness 2.3.0 → 2.4.0

package/{src → cli}/steps/copy/commands.js

@@ -1,95 +1,95 @@
-import fse from 'fs-extra'
-import path from 'path'
-import { fileURLToPath } from 'url'
-import { success } from '../../utils/exec.js'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-
-const _archive = {
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/az.md'), 'utf-8'),
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gh.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gl.md'), 'utf-8'),
-  none: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/none.md'), 'utf-8'),
-}
-
-const _ship = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/az.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gl.md'), 'utf-8'),
-}
-
-const _review = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/az.md'), 'utf-8'),
-  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gl.md'), 'utf-8'),
-}
-
-const _backlog = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/az.md'), 'utf-8'),
-  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/jira.md'), 'utf-8'),
-}
-
-// Evidence comments target the backlog platform (where the issue/work-item lives).
-const _evidence = {
-  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/gh.md'), 'utf-8'),
-  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/az.md'), 'utf-8'),
-  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/jira.md'), 'utf-8'),
-}
-
-// relativePath is POSIX-style relative to the project root; commands live in
-// .opencode/commands/, skill-backed procedures (plan-archive, ops-ship) in
-// .agents/skills/<name>/SKILL.md.
-function patchFile(relativePath, startMarker, endMarker, content, platform, cwd = process.cwd()) {
-  const targetPath = path.join(cwd, ...relativePath.split('/'))
-  if (!fse.pathExistsSync(targetPath)) return
-
-  let fileContent = fse.readFileSync(targetPath, 'utf-8')
-  if (!fileContent.includes(startMarker) || !fileContent.includes(endMarker)) return
-
-  const pattern = new RegExp(`${startMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${endMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`)
-  // Replacer function, not a replacement string: the injected fragments contain
-  // shell quoting like $'...' and a string replacement expands $' as "everything
-  // after the match", silently truncating the command. That is how the ops-ship
-  // screenshot comment lost its entire --body argument.
-  fileContent = fileContent.replace(pattern, () => `${startMarker}\n${content.trim()}\n${endMarker}`)
-  fse.writeFileSync(targetPath, `${fileContent.replace(/\s*$/, '')}\n`, 'utf-8')
-  success(`${relativePath} content injected for platform: ${platform}`)
-}
-
-export async function patchArchiveCommand(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? platform.backlogPlatform ?? 'github') : platform
-  const replacement = _archive[repoPlatform]
-  if (!replacement) return
-  patchFile('.agents/skills/pc-plan-archive/SKILL.md', '<!-- PC-PLATFORM-ARCHIVE-START -->', '<!-- PC-PLATFORM-ARCHIVE-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsShip(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
-  const replacement = _ship[repoPlatform]
-  if (!replacement) return
-  patchFile('.agents/skills/pc-ops-ship/SKILL.md', '<!-- PC-PLATFORM-SHIP-START -->', '<!-- PC-PLATFORM-SHIP-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsReview(platform, cwd = process.cwd()) {
-  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
-  const replacement = _review[repoPlatform]
-  if (!replacement) return
-  patchFile('.opencode/commands/ops-review.md', '<!-- PC-PLATFORM-REVIEW-START -->', '<!-- PC-PLATFORM-REVIEW-END -->', replacement, repoPlatform, cwd)
-}
-
-export async function patchOpsBacklog(platform, cwd = process.cwd()) {
-  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
-  const replacement = _backlog[backlogPlatform]
-  if (!replacement) return
-  patchFile('.opencode/commands/ops-backlog.md', '<!-- PC-PLATFORM-BACKLOG-START -->', '<!-- PC-PLATFORM-BACKLOG-END -->', replacement, backlogPlatform, cwd)
-}
-
-export async function patchOpsEvidence(platform, cwd = process.cwd()) {
-  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
-  const replacement = _evidence[backlogPlatform]
-  // browser/none have no CLI to post with: leave the markers empty (the skill skips commenting).
-  if (!replacement) return
-  patchFile('.agents/skills/pc-ops-evidence/SKILL.md', '<!-- PC-PLATFORM-EVIDENCE-START -->', '<!-- PC-PLATFORM-EVIDENCE-END -->', replacement, backlogPlatform, cwd)
-}
-
+import fse from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { success } from '../../utils/exec.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+const _archive = {
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/az.md'), 'utf-8'),
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gh.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/gl.md'), 'utf-8'),
+  none: await fse.readFile(path.resolve(__dirname, '../../fragments/archive/none.md'), 'utf-8'),
+}
+
+const _ship = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/az.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-ship/gl.md'), 'utf-8'),
+}
+
+const _review = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/az.md'), 'utf-8'),
+  gitlab: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-review/gl.md'), 'utf-8'),
+}
+
+const _backlog = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/az.md'), 'utf-8'),
+  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-backlog/jira.md'), 'utf-8'),
+}
+
+// Evidence comments target the backlog platform (where the issue/work-item lives).
+const _evidence = {
+  github: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/gh.md'), 'utf-8'),
+  azure: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/az.md'), 'utf-8'),
+  jira: await fse.readFile(path.resolve(__dirname, '../../fragments/ops-evidence/jira.md'), 'utf-8'),
+}
+
+// relativePath is POSIX-style relative to the project root; commands live in
+// .opencode/commands/, skill-backed procedures (plan-archive, ops-ship) in
+// .agents/skills/<name>/SKILL.md.
+function patchFile(relativePath, startMarker, endMarker, content, platform, cwd = process.cwd()) {
+  const targetPath = path.join(cwd, ...relativePath.split('/'))
+  if (!fse.pathExistsSync(targetPath)) return
+
+  let fileContent = fse.readFileSync(targetPath, 'utf-8')
+  if (!fileContent.includes(startMarker) || !fileContent.includes(endMarker)) return
+
+  const pattern = new RegExp(`${startMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${endMarker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`)
+  // Replacer function, not a replacement string: the injected fragments contain
+  // shell quoting like $'...' and a string replacement expands $' as "everything
+  // after the match", silently truncating the command. That is how the ops-ship
+  // screenshot comment lost its entire --body argument.
+  fileContent = fileContent.replace(pattern, () => `${startMarker}\n${content.trim()}\n${endMarker}`)
+  fse.writeFileSync(targetPath, `${fileContent.replace(/\s*$/, '')}\n`, 'utf-8')
+  success(`${relativePath} content injected for platform: ${platform}`)
+}
+
+export async function patchArchiveCommand(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? platform.backlogPlatform ?? 'github') : platform
+  const replacement = _archive[repoPlatform]
+  if (!replacement) return
+  patchFile('.agents/skills/pc-plan-archive/SKILL.md', '<!-- PC-PLATFORM-ARCHIVE-START -->', '<!-- PC-PLATFORM-ARCHIVE-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsShip(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
+  const replacement = _ship[repoPlatform]
+  if (!replacement) return
+  patchFile('.agents/skills/pc-ops-ship/SKILL.md', '<!-- PC-PLATFORM-SHIP-START -->', '<!-- PC-PLATFORM-SHIP-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsReview(platform, cwd = process.cwd()) {
+  const repoPlatform = typeof platform === 'object' ? (platform.repoPlatform ?? 'github') : platform
+  const replacement = _review[repoPlatform]
+  if (!replacement) return
+  patchFile('.opencode/commands/ops-review.md', '<!-- PC-PLATFORM-REVIEW-START -->', '<!-- PC-PLATFORM-REVIEW-END -->', replacement, repoPlatform, cwd)
+}
+
+export async function patchOpsBacklog(platform, cwd = process.cwd()) {
+  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
+  const replacement = _backlog[backlogPlatform]
+  if (!replacement) return
+  patchFile('.opencode/commands/ops-backlog.md', '<!-- PC-PLATFORM-BACKLOG-START -->', '<!-- PC-PLATFORM-BACKLOG-END -->', replacement, backlogPlatform, cwd)
+}
+
+export async function patchOpsEvidence(platform, cwd = process.cwd()) {
+  const backlogPlatform = typeof platform === 'object' ? (platform.backlogPlatform ?? 'github') : platform
+  const replacement = _evidence[backlogPlatform]
+  // browser/none have no CLI to post with: leave the markers empty (the skill skips commenting).
+  if (!replacement) return
+  patchFile('.agents/skills/pc-ops-evidence/SKILL.md', '<!-- PC-PLATFORM-EVIDENCE-START -->', '<!-- PC-PLATFORM-EVIDENCE-END -->', replacement, backlogPlatform, cwd)
+}
+

package/{src → cli}/steps/copy/fullstack-engineer.js

@@ -1,88 +1,89 @@
-import fse from 'fs-extra'
-import path from 'path'
-import { success } from '../../utils/exec.js'
-import { agentColor } from '../../utils/agent-color.js'
-
-const FULLSTACK_FILE = 'fullstack-engineer.md'
-const FULLSTACK_DESCRIPTION = 'Default engineer that accumulates skills from all created persona engineers. Use as fallback when no specialist matches: but prefer spawning a specific engineer for deterministic results.'
-const FULLSTACK_IDENTITY = 'You are the default engineer, and your body is what the build and plan agents run. You are more complete but less accurate than specialized engineers, so prefer spawning a specialist when one matches the task domain.'
-
-// The reminder plugin owns ability bootstrap. Remove the old prompt-level
-// directive when regenerating so it cannot duplicate the plugin reminder.
-function stripStartupDirective(text) {
-  if (!text) return text
-  return text
-    .split(/\r?\n\r?\n+/)
-    .filter(paragraph => !paragraph.trim().startsWith('**Startup'))
-    .join('\n\n')
-    .trim()
-}
-
-export async function removeLegacyStartupDirectives({ cwd = process.cwd() } = {}) {
-  const agentsDir = path.join(cwd, '.opencode', 'agents')
-  if (!await fse.pathExists(agentsDir)) return 0
-
-  let updated = 0
-  for (const fileName of await fse.readdir(agentsDir)) {
-    if (!fileName.endsWith('.md')) continue
-    const filePath = path.join(agentsDir, fileName)
-    const content = await fse.readFile(filePath, 'utf-8')
-    const cleaned = stripStartupDirective(content)
-    if (cleaned === content.trim()) continue
-    await fse.writeFile(filePath, `${cleaned}\n`, 'utf-8')
-    updated++
-  }
-  return updated
-}
-
-export async function generateFullstackEngineer({ cwd = process.cwd(), updateMode = false } = {}) {
-  const agentsDir = path.join(cwd, '.opencode', 'agents')
-  await fse.ensureDir(agentsDir)
-  const filePath = path.join(agentsDir, FULLSTACK_FILE)
-
-  if (updateMode && await fse.pathExists(filePath)) {
-    return { generated: false, preserved: true }
-  }
-
-  let existingAbilities = null
-  let existingIdentity = null
-  if (await fse.pathExists(filePath)) {
-    const content = await fse.readFile(filePath, 'utf-8')
-    const abilitiesMatch = content.match(/## Abilities\n([\s\S]*?)$/)
-    if (abilitiesMatch) existingAbilities = abilitiesMatch[1].trim()
-    const identityMatch = content.match(/^---\n[\s\S]*?\n---\n\n(.*?)(?:\n\n## Abilities)/s)
-    if (identityMatch) existingIdentity = stripStartupDirective(identityMatch[1])
-  }
-
-  const frontmatter = [
-    '---',
-    `description: ${FULLSTACK_DESCRIPTION}`,
-    // subagent, not primary: build.md and plan.md are the primaries, and
-    // pc-subagent-tiers generates both from this file on every startup.
-    'mode: subagent',
-    // warning is reserved for plan, so fullstack takes its name-derived hex
-    // like every other subagent.
-    `color: ${agentColor('fullstack-engineer')}`,
-    'permission:',
-    '  edit: allow',
-    '  bash: allow',
-    '  read: allow',
-    '  glob: allow',
-    '  grep: allow',
-    '  question: allow',
-    '  todowrite: allow',
-    '---',
-  ]
-
-  const identity = existingIdentity ?? FULLSTACK_IDENTITY
-
-  const abilities = existingAbilities ?? [
-    '- Guardrails: @pc-guardrails-generic, @pc-guardrails-project',
-  ].join('\n')
-
-  const content = `${frontmatter.join('\n')}\n\n${identity}\n\n## Abilities\n${abilities}\n`
-
-  await fse.writeFile(filePath, content, 'utf-8')
-  success(`Generated ${FULLSTACK_FILE}`)
-  return { generated: true }
-}
+import fse from 'fs-extra'
+import path from 'path'
+import { success } from '../../utils/exec.js'
+import { agentColor, yamlColor } from '../../utils/agent-color.js'
+
+const FULLSTACK_FILE = 'fullstack-engineer.md'
+const FULLSTACK_DESCRIPTION = 'Default engineer that accumulates skills from all created persona engineers. Use as fallback when no specialist matches: but prefer spawning a specific engineer for deterministic results.'
+const FULLSTACK_IDENTITY = 'You are the default engineer, and your body is what the build and plan agents run. You are more complete but less accurate than specialized engineers, so prefer spawning a specialist when one matches the task domain.'
+
+// The reminder plugin owns ability bootstrap. Remove the old prompt-level
+// directive when regenerating so it cannot duplicate the plugin reminder.
+function stripStartupDirective(text) {
+  if (!text) return text
+  return text
+    .split(/\r?\n\r?\n+/)
+    .filter(paragraph => !paragraph.trim().startsWith('**Startup'))
+    .join('\n\n')
+    .trim()
+}
+
+export async function removeLegacyStartupDirectives({ cwd = process.cwd() } = {}) {
+  const agentsDir = path.join(cwd, '.opencode', 'agents')
+  if (!await fse.pathExists(agentsDir)) return 0
+
+  let updated = 0
+  for (const fileName of await fse.readdir(agentsDir)) {
+    if (!fileName.endsWith('.md')) continue
+    const filePath = path.join(agentsDir, fileName)
+    const content = await fse.readFile(filePath, 'utf-8')
+    const cleaned = stripStartupDirective(content)
+    if (cleaned === content.trim()) continue
+    await fse.writeFile(filePath, `${cleaned}\n`, 'utf-8')
+    updated++
+  }
+  return updated
+}
+
+export async function generateFullstackEngineer({ cwd = process.cwd(), updateMode = false } = {}) {
+  const agentsDir = path.join(cwd, '.opencode', 'agents')
+  await fse.ensureDir(agentsDir)
+  const filePath = path.join(agentsDir, FULLSTACK_FILE)
+
+  if (updateMode && await fse.pathExists(filePath)) {
+    return { generated: false, preserved: true }
+  }
+
+  let existingAbilities = null
+  let existingIdentity = null
+  if (await fse.pathExists(filePath)) {
+    const content = await fse.readFile(filePath, 'utf-8')
+    const abilitiesMatch = content.match(/## Abilities\n([\s\S]*?)$/)
+    if (abilitiesMatch) existingAbilities = abilitiesMatch[1].trim()
+    const identityMatch = content.match(/^---\n[\s\S]*?\n---\n\n(.*?)(?:\n\n## Abilities)/s)
+    if (identityMatch) existingIdentity = stripStartupDirective(identityMatch[1])
+  }
+
+  const frontmatter = [
+    '---',
+    `description: ${FULLSTACK_DESCRIPTION}`,
+    // subagent, not primary: build.md and plan.md are the primaries, and
+    // pc-subagent-tiers generates both from this file on every startup.
+    'mode: subagent',
+    // warning is reserved for plan, so fullstack takes its name-derived hex
+    // like every other subagent.
+    // Quoted: a bare #hex is a YAML comment, which opencode rejects.
+    `color: ${yamlColor(agentColor('fullstack-engineer'))}`,
+    'permission:',
+    '  edit: allow',
+    '  bash: allow',
+    '  read: allow',
+    '  glob: allow',
+    '  grep: allow',
+    '  question: allow',
+    '  todowrite: allow',
+    '---',
+  ]
+
+  const identity = existingIdentity ?? FULLSTACK_IDENTITY
+
+  const abilities = existingAbilities ?? [
+    '- Guardrails: @pc-guardrails-generic, @pc-guardrails-project',
+  ].join('\n')
+
+  const content = `${frontmatter.join('\n')}\n\n${identity}\n\n## Abilities\n${abilities}\n`
+
+  await fse.writeFile(filePath, content, 'utf-8')
+  success(`Generated ${FULLSTACK_FILE}`)
+  return { generated: true }
+}

package/{src → cli}/steps/copy/index.js

@@ -11,7 +11,7 @@ import { generateFullstackEngineer, removeLegacyStartupDirectives } from "./full
 import { patchOpencodeJson, patchOpencodePackage } from "./opencode-json.js"
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const CONTENT_DIR = path.resolve(__dirname, "../../content")
+const CONTENT_DIR = path.resolve(__dirname, "../../../harness")
 
 export async function copyContentStep(platform, ctx = {}) {
   header("Step 5, Copying agent-harness files")