@plainconceptsplatform/agent-harness 2.3.0 → 2.4.0

package/{src → cli}/steps/optimization/simple-english.js

@@ -1,17 +1,17 @@
-import { addSkillToLock } from './skills-lock.js'
-import { header, success, info } from '../../utils/exec.js'
-
-const SKILL_ENTRY = {
-  source: 'AminBlg/SimpleEnglish',
-  sourceType: 'github',
-  skillPath: 'skills/simple-english/SKILL.md',
-}
-
-export async function installSimpleEnglish(options = {}) {
-  if (!options.skipHeader) header('Installing Simple English')
-
-  info('Adding Simple English to skills-lock.json for batch install')
-  await addSkillToLock('simple-english', SKILL_ENTRY)
-  success('Simple English queued for installation')
-  return { optedIn: true, installed: true }
-}
+import { addSkillToLock } from './skills-lock.js'
+import { header, success, info } from '../../utils/exec.js'
+
+const SKILL_ENTRY = {
+  source: 'AminBlg/SimpleEnglish',
+  sourceType: 'github',
+  skillPath: 'skills/simple-english/SKILL.md',
+}
+
+export async function installSimpleEnglish(options = {}) {
+  if (!options.skipHeader) header('Installing Simple English')
+
+  info('Adding Simple English to skills-lock.json for batch install')
+  await addSkillToLock('simple-english', SKILL_ENTRY)
+  success('Simple English queued for installation')
+  return { optedIn: true, installed: true }
+}

package/{src → cli}/steps/optimization/skills-lock.js

@@ -1,30 +1,30 @@
-import fse from 'fs-extra'
-import path from 'path'
-import { info, warn } from '../../utils/exec.js'
-
-export async function addSkillToLock(skillName, entry) {
-  if (!entry) {
-    warn(`No entry provided for skills-lock.json: ${skillName}`)
-    return false
-  }
-
-  const destLock = path.join(process.cwd(), 'skills-lock.json')
-
-  let lock = { version: 1, skills: {} }
-  if (await fse.pathExists(destLock)) {
-    try {
-      lock = await fse.readJson(destLock)
-      if (!lock.skills) lock.skills = {}
-    } catch {
-      warn('Could not parse existing skills-lock.json, creating fresh')
-    }
-  }
-
-  if (!lock.skills[skillName]) {
-    lock.skills[skillName] = entry
-    await fse.writeJson(destLock, lock, { spaces: 2 })
-    info(`Added ${skillName} to skills-lock.json`)
-  }
-
-  return true
-}
+import fse from 'fs-extra'
+import path from 'path'
+import { info, warn } from '../../utils/exec.js'
+
+export async function addSkillToLock(skillName, entry) {
+  if (!entry) {
+    warn(`No entry provided for skills-lock.json: ${skillName}`)
+    return false
+  }
+
+  const destLock = path.join(process.cwd(), 'skills-lock.json')
+
+  let lock = { version: 1, skills: {} }
+  if (await fse.pathExists(destLock)) {
+    try {
+      lock = await fse.readJson(destLock)
+      if (!lock.skills) lock.skills = {}
+    } catch {
+      warn('Could not parse existing skills-lock.json, creating fresh')
+    }
+  }
+
+  if (!lock.skills[skillName]) {
+    lock.skills[skillName] = entry
+    await fse.writeJson(destLock, lock, { spaces: 2 })
+    info(`Added ${skillName} to skills-lock.json`)
+  }
+
+  return true
+}

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

@@ -1,109 +1,109 @@
-import { select } from '@inquirer/prompts'
-import { execa } from 'execa'
-import fse from 'fs-extra'
-import path from 'path'
-import { fileURLToPath } from 'url'
-import { code, commandExists, header, info, success, warn } from '../../utils/exec.js'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const PLATFORMS_PRESET_PATH = path.resolve(__dirname, '../../presets/platforms.json')
-const platformsPreset = await fse.readJson(PLATFORMS_PRESET_PATH)
-
-
-export async function checkPlatform(platform) {
-  const preset = platformsPreset.find(p => p.value === platform) || platformsPreset[0]
-  if (!preset.cli) {
-    header(`Step 4, Checking ${preset.name} CLI`)
-    info('No platform integration selected, skipping CLI checks.')
-    success(`Platform: ${preset.name}`)
-    return
-  }
-  await checkPlatformCli(preset)
-}
-
-export async function choosePlatform() {
-  header('Step 3, Version control platform')
-
-  const backlogChoices = platformsPreset.filter(p => !p.repoOnly)
-  const backlogPlatform = await select({
-    message: 'Where is your backlog (work items / issues)?',
-    choices: backlogChoices.map(p => ({ name: p.name, value: p.value })),
-  })
-
-  const backlogPreset = platformsPreset.find(p => p.value === backlogPlatform)
-  success(`Backlog platform: ${backlogPreset?.name || backlogPlatform}`)
-
-  let repoPlatform = backlogPlatform
-  if (backlogPlatform !== 'none') {
-    // Exclude backlog-only platforms (e.g. Jira) from repo choices
-    const repoChoices = platformsPreset.filter(p => !p.backlogOnly)
-    repoPlatform = await select({
-      message: 'Where is your code repository (PRs / code reviews)?',
-      choices: repoChoices.map(p => ({ name: p.name, value: p.value })),
-      default: backlogPreset.backlogOnly ? 'github' : backlogPlatform,
-    })
-    const repoPreset = platformsPreset.find(p => p.value === repoPlatform)
-    success(`Repo platform: ${repoPreset?.name || repoPlatform}`)
-  }
-
-  // Check CLIs for both platforms (deduped)
-  const platformsToCheck = [...new Set([backlogPlatform, repoPlatform])].filter(p => p !== 'none')
-  for (const p of platformsToCheck) {
-    const preset = platformsPreset.find(x => x.value === p)
-    if (preset?.cli) await checkPlatformCli(preset)
-  }
-
-  return { backlogPlatform, repoPlatform }
-}
-
-async function checkPlatformCli(platformPreset) {
-  const { cli } = platformPreset
-  header(`Step 4, Checking ${platformPreset.name} CLI`)
-
-  const hasCli = await commandExists(cli.command)
-  if (!hasCli) {
-    warn(`${cli.displayName} not found.`)
-    info(`Install from: ${cli.installUrl}`)
-    if (cli.authCheck?.commands?.length) {
-      console.log()
-      info('After installing, authenticate with:')
-      code(cli.authCheck.commands)
-    }
-    return
-  }
-  success(`${cli.displayName} available`)
-
-  if (cli.authCheck) await runAuthCheck(cli)
-  if (cli.extensionCheck) await runExtensionCheck(cli)
-}
-
-async function runAuthCheck(cli) {
-  try {
-    const result = await execa(cli.command, cli.authCheck.args, { reject: false })
-    if (result.exitCode === 0) {
-      success(`${cli.displayName} authenticated`)
-    } else {
-      warn(cli.authCheck.notAuthenticatedMessage)
-      code(cli.authCheck.commands)
-    }
-  } catch {
-    warn(`Could not check ${cli.command} auth status.`)
-  }
-}
-
-async function runExtensionCheck(cli) {
-  try {
-    const result = await execa(cli.command, cli.extensionCheck.args, { reject: false })
-    const hasExtension = result.stdout && result.stdout.includes(cli.extensionCheck.expectedOutput)
-
-    if (hasExtension) {
-      success(`${cli.extensionCheck.expectedOutput} extension installed`)
-    } else {
-      warn(cli.extensionCheck.missingMessage)
-      code(cli.extensionCheck.commands)
-    }
-  } catch {
-    warn(cli.extensionCheck.errorMessage)
-    code(cli.extensionCheck.commands)
-  }
-}
+import { select } from '@inquirer/prompts'
+import { execa } from 'execa'
+import fse from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { code, commandExists, header, info, success, warn } from '../../utils/exec.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const PLATFORMS_PRESET_PATH = path.resolve(__dirname, '../../presets/platforms.json')
+const platformsPreset = await fse.readJson(PLATFORMS_PRESET_PATH)
+
+
+export async function checkPlatform(platform) {
+  const preset = platformsPreset.find(p => p.value === platform) || platformsPreset[0]
+  if (!preset.cli) {
+    header(`Step 4, Checking ${preset.name} CLI`)
+    info('No platform integration selected, skipping CLI checks.')
+    success(`Platform: ${preset.name}`)
+    return
+  }
+  await checkPlatformCli(preset)
+}
+
+export async function choosePlatform() {
+  header('Step 3, Version control platform')
+
+  const backlogChoices = platformsPreset.filter(p => !p.repoOnly)
+  const backlogPlatform = await select({
+    message: 'Where is your backlog (work items / issues)?',
+    choices: backlogChoices.map(p => ({ name: p.name, value: p.value })),
+  })
+
+  const backlogPreset = platformsPreset.find(p => p.value === backlogPlatform)
+  success(`Backlog platform: ${backlogPreset?.name || backlogPlatform}`)
+
+  let repoPlatform = backlogPlatform
+  if (backlogPlatform !== 'none') {
+    // Exclude backlog-only platforms (e.g. Jira) from repo choices
+    const repoChoices = platformsPreset.filter(p => !p.backlogOnly)
+    repoPlatform = await select({
+      message: 'Where is your code repository (PRs / code reviews)?',
+      choices: repoChoices.map(p => ({ name: p.name, value: p.value })),
+      default: backlogPreset.backlogOnly ? 'github' : backlogPlatform,
+    })
+    const repoPreset = platformsPreset.find(p => p.value === repoPlatform)
+    success(`Repo platform: ${repoPreset?.name || repoPlatform}`)
+  }
+
+  // Check CLIs for both platforms (deduped)
+  const platformsToCheck = [...new Set([backlogPlatform, repoPlatform])].filter(p => p !== 'none')
+  for (const p of platformsToCheck) {
+    const preset = platformsPreset.find(x => x.value === p)
+    if (preset?.cli) await checkPlatformCli(preset)
+  }
+
+  return { backlogPlatform, repoPlatform }
+}
+
+async function checkPlatformCli(platformPreset) {
+  const { cli } = platformPreset
+  header(`Step 4, Checking ${platformPreset.name} CLI`)
+
+  const hasCli = await commandExists(cli.command)
+  if (!hasCli) {
+    warn(`${cli.displayName} not found.`)
+    info(`Install from: ${cli.installUrl}`)
+    if (cli.authCheck?.commands?.length) {
+      console.log()
+      info('After installing, authenticate with:')
+      code(cli.authCheck.commands)
+    }
+    return
+  }
+  success(`${cli.displayName} available`)
+
+  if (cli.authCheck) await runAuthCheck(cli)
+  if (cli.extensionCheck) await runExtensionCheck(cli)
+}
+
+async function runAuthCheck(cli) {
+  try {
+    const result = await execa(cli.command, cli.authCheck.args, { reject: false })
+    if (result.exitCode === 0) {
+      success(`${cli.displayName} authenticated`)
+    } else {
+      warn(cli.authCheck.notAuthenticatedMessage)
+      code(cli.authCheck.commands)
+    }
+  } catch {
+    warn(`Could not check ${cli.command} auth status.`)
+  }
+}
+
+async function runExtensionCheck(cli) {
+  try {
+    const result = await execa(cli.command, cli.extensionCheck.args, { reject: false })
+    const hasExtension = result.stdout && result.stdout.includes(cli.extensionCheck.expectedOutput)
+
+    if (hasExtension) {
+      success(`${cli.extensionCheck.expectedOutput} extension installed`)
+    } else {
+      warn(cli.extensionCheck.missingMessage)
+      code(cli.extensionCheck.commands)
+    }
+  } catch {
+    warn(cli.extensionCheck.errorMessage)
+    code(cli.extensionCheck.commands)
+  }
+}

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

@@ -1,123 +1,123 @@
-import { checkbox, select } from '@inquirer/prompts'
-import fse from 'fs-extra'
-import path from 'path'
-import { fileURLToPath } from 'url'
-import { header, info, success, warn } from '../../utils/exec.js'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const SOURCE_PRESET_PATH = path.resolve(__dirname, '../../presets/source.json')
-const sourcePreset = await fse.readJson(SOURCE_PRESET_PATH)
-
-async function listChildFolders(cwd) {
-  const entries = await fse.readdir(cwd)
-  const dirs = []
-
-  for (const name of entries) {
-    if (name.startsWith('.')) continue
-    const abs = path.join(cwd, name)
-    try {
-      const stat = await fse.stat(abs)
-      if (!stat.isDirectory()) continue
-      dirs.push({ name, abs })
-    } catch {
-      // ignore invalid entries
-    }
-  }
-
-  dirs.sort((a, b) => a.name.localeCompare(b.name))
-  return dirs
-}
-
-async function listParentFolders(cwd) {
-  const parent = path.resolve(cwd, '..')
-  const entries = await fse.readdir(parent)
-  const dirs = []
-
-  for (const name of entries) {
-    if (name.startsWith('.')) continue
-    const abs = path.join(parent, name)
-    try {
-      const stat = await fse.stat(abs)
-      if (!stat.isDirectory()) continue
-      if (path.resolve(abs) === path.resolve(cwd)) continue
-      dirs.push({ name, abs })
-    } catch {
-      // ignore invalid entries
-    }
-  }
-
-  dirs.sort((a, b) => a.name.localeCompare(b.name))
-  return dirs
-}
-
-export async function chooseSourceScope() {
-  header('Step 1, Source code scope')
-
-  const cwd = process.cwd()
-  info('Choose where agents should read source code from during init analysis.')
-
-  const mode = await select({
-    message: sourcePreset.message,
-    default: sourcePreset.default,
-    choices: sourcePreset.choices,
-  })
-
-  if (mode === 'current') {
-    success(`Source scope: ${cwd}`)
-    return { sourceMode: 'current', sourceRoots: [cwd] }
-  }
-
-  if (mode === 'children') {
-    const childFolders = await listChildFolders(cwd)
-    if (childFolders.length === 0) {
-      warn('No child folders found in current directory. Falling back to current folder.')
-      success(`Source scope: ${cwd}`)
-      return { sourceMode: 'current', sourceRoots: [cwd] }
-    }
-
-    const selected = await checkbox({
-      message: sourcePreset.childrenSelectionMessage,
-      choices: childFolders.map(d => ({
-        name: `./${d.name}`,
-        value: d.abs,
-        checked: true,
-      })),
-      required: true,
-    })
-
-    if (!selected || selected.length === 0) {
-      warn('No folders selected. Falling back to current folder.')
-      success(`Source scope: ${cwd}`)
-      return { sourceMode: 'current', sourceRoots: [cwd] }
-    }
-
-    success(`Source scope: ${selected.map(p => path.basename(p)).join(', ')}`)
-    return { sourceMode: 'children-selected', sourceRoots: selected }
-  }
-
-  const parentFolders = await listParentFolders(cwd)
-  if (parentFolders.length === 0) {
-    warn('No sibling folders found in parent directory. Falling back to current folder.')
-    success(`Source scope: ${cwd}`)
-    return { sourceMode: 'current', sourceRoots: [cwd] }
-  }
-
-  const selected = await checkbox({
-    message: sourcePreset.parentSelectionMessage,
-    choices: parentFolders.map(d => ({
-      name: `../${d.name}`,
-      value: d.abs,
-      checked: true,
-    })),
-    required: true,
-  })
-
-  if (!selected || selected.length === 0) {
-    warn('No folders selected. Falling back to current folder.')
-    success(`Source scope: ${cwd}`)
-    return { sourceMode: 'current', sourceRoots: [cwd] }
-  }
-
-  success(`Source scope: ${selected.map(p => path.basename(p)).join(', ')}`)
-  return { sourceMode: 'parent-selected', sourceRoots: selected }
-}
+import { checkbox, select } from '@inquirer/prompts'
+import fse from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { header, info, success, warn } from '../../utils/exec.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const SOURCE_PRESET_PATH = path.resolve(__dirname, '../../presets/source.json')
+const sourcePreset = await fse.readJson(SOURCE_PRESET_PATH)
+
+async function listChildFolders(cwd) {
+  const entries = await fse.readdir(cwd)
+  const dirs = []
+
+  for (const name of entries) {
+    if (name.startsWith('.')) continue
+    const abs = path.join(cwd, name)
+    try {
+      const stat = await fse.stat(abs)
+      if (!stat.isDirectory()) continue
+      dirs.push({ name, abs })
+    } catch {
+      // ignore invalid entries
+    }
+  }
+
+  dirs.sort((a, b) => a.name.localeCompare(b.name))
+  return dirs
+}
+
+async function listParentFolders(cwd) {
+  const parent = path.resolve(cwd, '..')
+  const entries = await fse.readdir(parent)
+  const dirs = []
+
+  for (const name of entries) {
+    if (name.startsWith('.')) continue
+    const abs = path.join(parent, name)
+    try {
+      const stat = await fse.stat(abs)
+      if (!stat.isDirectory()) continue
+      if (path.resolve(abs) === path.resolve(cwd)) continue
+      dirs.push({ name, abs })
+    } catch {
+      // ignore invalid entries
+    }
+  }
+
+  dirs.sort((a, b) => a.name.localeCompare(b.name))
+  return dirs
+}
+
+export async function chooseSourceScope() {
+  header('Step 1, Source code scope')
+
+  const cwd = process.cwd()
+  info('Choose where agents should read source code from during init analysis.')
+
+  const mode = await select({
+    message: sourcePreset.message,
+    default: sourcePreset.default,
+    choices: sourcePreset.choices,
+  })
+
+  if (mode === 'current') {
+    success(`Source scope: ${cwd}`)
+    return { sourceMode: 'current', sourceRoots: [cwd] }
+  }
+
+  if (mode === 'children') {
+    const childFolders = await listChildFolders(cwd)
+    if (childFolders.length === 0) {
+      warn('No child folders found in current directory. Falling back to current folder.')
+      success(`Source scope: ${cwd}`)
+      return { sourceMode: 'current', sourceRoots: [cwd] }
+    }
+
+    const selected = await checkbox({
+      message: sourcePreset.childrenSelectionMessage,
+      choices: childFolders.map(d => ({
+        name: `./${d.name}`,
+        value: d.abs,
+        checked: true,
+      })),
+      required: true,
+    })
+
+    if (!selected || selected.length === 0) {
+      warn('No folders selected. Falling back to current folder.')
+      success(`Source scope: ${cwd}`)
+      return { sourceMode: 'current', sourceRoots: [cwd] }
+    }
+
+    success(`Source scope: ${selected.map(p => path.basename(p)).join(', ')}`)
+    return { sourceMode: 'children-selected', sourceRoots: selected }
+  }
+
+  const parentFolders = await listParentFolders(cwd)
+  if (parentFolders.length === 0) {
+    warn('No sibling folders found in parent directory. Falling back to current folder.')
+    success(`Source scope: ${cwd}`)
+    return { sourceMode: 'current', sourceRoots: [cwd] }
+  }
+
+  const selected = await checkbox({
+    message: sourcePreset.parentSelectionMessage,
+    choices: parentFolders.map(d => ({
+      name: `../${d.name}`,
+      value: d.abs,
+      checked: true,
+    })),
+    required: true,
+  })
+
+  if (!selected || selected.length === 0) {
+    warn('No folders selected. Falling back to current folder.')
+    success(`Source scope: ${cwd}`)
+    return { sourceMode: 'current', sourceRoots: [cwd] }
+  }
+
+  success(`Source scope: ${selected.map(p => path.basename(p)).join(', ')}`)
+  return { sourceMode: 'parent-selected', sourceRoots: selected }
+}