opencastle 0.24.1 → 0.26.0

package/src/cli/bootstrap.ts

@@ -0,0 +1,472 @@
+import { readFile, writeFile, unlink, readdir } from 'node:fs/promises'
+import { join } from 'node:path'
+import { existsSync } from 'node:fs'
+import type { RepoInfo, StackConfig } from './types.js'
+
+export interface BootstrapResult {
+  populated: string[]
+  removed: string[]
+  renamed: string[]
+}
+
+// ── Internal types ─────────────────────────────────────────────
+
+interface PackageJson {
+  name?: string
+  description?: string
+  scripts?: Record<string, string>
+}
+
+interface WorkspacePkg {
+  path: string
+  name: string
+  description?: string
+}
+
+// ── Utilities ──────────────────────────────────────────────────
+
+async function tryReadJson<T>(p: string): Promise<T | null> {
+  try {
+    return JSON.parse(await readFile(p, 'utf8')) as T
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Replace the first empty table row within a named markdown section.
+ * Scopes the search from `sectionMarker` to the next `## ` heading.
+ */
+function fillTableSection(
+  content: string,
+  sectionMarker: string,
+  emptyRow: string,
+  rows: string[],
+): string {
+  if (rows.length === 0) return content
+  const sIdx = content.indexOf(sectionMarker)
+  if (sIdx === -1) return content
+  const nextSectionIdx = content.indexOf('\n## ', sIdx + sectionMarker.length)
+  const end = nextSectionIdx === -1 ? content.length : nextSectionIdx
+  const slice = content.slice(sIdx, end)
+  const needle = '\n' + emptyRow
+  const needleIdx = slice.indexOf(needle)
+  if (needleIdx === -1) return content
+  const abs = sIdx + needleIdx + 1 // position of first char of emptyRow (skip \n)
+  return content.slice(0, abs) + rows.join('\n') + content.slice(abs + emptyRow.length)
+}
+
+function replaceMarker(content: string, marker: string, replacement: string): string {
+  if (!content.includes(marker)) return content
+  return content.replace(marker, replacement)
+}
+
+function filterConfigFiles(configFiles: string[] | undefined, patterns: string[]): string[] {
+  if (!configFiles?.length) return []
+  return configFiles.filter(f => patterns.some(p => f === p || f.endsWith('/' + p) || f.includes(p)))
+}
+
+// ── Workspace scanning ─────────────────────────────────────────
+
+async function scanWorkspace(projectRoot: string): Promise<WorkspacePkg[]> {
+  const packages: WorkspacePkg[] = []
+  for (const dir of ['apps', 'packages', 'libs']) {
+    const dirPath = join(projectRoot, dir)
+    if (!existsSync(dirPath)) continue
+    let entries: Array<{ name: string; isDirectory(): boolean }> = []
+    try {
+      entries = await readdir(dirPath, { withFileTypes: true })
+    } catch {
+      continue
+    }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue
+      const pkg = await tryReadJson<PackageJson>(join(dirPath, e.name, 'package.json'))
+      packages.push({
+        path: `${dir}/${e.name}`,
+        name: pkg?.name ?? `${dir}/${e.name}`,
+        description: pkg?.description,
+      })
+    }
+  }
+  return packages
+}
+
+// ── Builders ───────────────────────────────────────────────────
+
+function buildStackRows(info: RepoInfo): string[] {
+  const rows: string[] = []
+  const addList = (layer: string, values: string[] | undefined) => {
+    if (!values?.length) return
+    for (const v of values) rows.push(`| ${layer} | ${v} | <!-- TODO: verify --> | |`)
+  }
+  if (info.language) rows.push(`| Language | ${info.language} | | |`)
+  if (info.packageManager) rows.push(`| Package Manager | ${info.packageManager} | | |`)
+  addList('Framework', info.frameworks)
+  addList('Database', info.databases)
+  addList('CMS', info.cms)
+  addList('Deployment', info.deployment)
+  addList('Testing', info.testing)
+  addList('CI/CD', info.cicd)
+  addList('Styling', info.styling)
+  addList('Auth', info.auth)
+  return rows
+}
+
+function buildKeyCommandsBlock(pm: string, scripts: Record<string, string>): string {
+  const commands = (['dev', 'build', 'test', 'lint', 'start'] as const)
+    .filter(k => scripts[k])
+    .map(k => `${pm} run ${k}`)
+  if (commands.length === 0) return ''
+  return `**Package manager:** \`${pm}\`\n\n\`\`\`bash\n${commands.join('\n')}\n\`\`\``
+}
+
+// ── Populators ─────────────────────────────────────────────────
+
+async function populateProjectInstructions(
+  opencastleDir: string,
+  projectRoot: string,
+  info: RepoInfo,
+  pkg: PackageJson,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'project.instructions.md')
+  if (!existsSync(filePath)) return
+  let content = await readFile(filePath, 'utf8')
+  const orig = content
+
+  // Overview: project name + description
+  if (pkg.name || pkg.description) {
+    const parts: string[] = []
+    if (pkg.name) parts.push(`**Project:** ${pkg.name}`)
+    if (pkg.description) parts.push(`**Description:** ${pkg.description}`)
+    content = replaceMarker(
+      content,
+      '<!-- Project name, description, and current status -->',
+      parts.join('\n\n'),
+    )
+  }
+
+  // Tech stack table
+  content = fillTableSection(content, '## Tech Stack', '| | | | |', buildStackRows(info))
+
+  // Key commands
+  if (pkg.scripts) {
+    const pm = info.packageManager ?? 'npm'
+    const cmdBlock = buildKeyCommandsBlock(pm, pkg.scripts)
+    if (cmdBlock) {
+      content = replaceMarker(
+        content,
+        '<!-- Package manager and common development commands -->',
+        '<!-- Package manager and common development commands -->\n\n' + cmdBlock,
+      )
+    }
+  }
+
+  // Monorepo workspace packages
+  if (info.monorepo) {
+    const workspaces = await scanWorkspace(projectRoot)
+    if (workspaces.length > 0) {
+      const pkgRows = workspaces.map(w => {
+        const cell =
+          w.name !== w.path ? `\`${w.path}\` (\`${w.name}\`)` : `\`${w.path}\``
+        return `| ${cell} | ${w.description ?? '<!-- TODO: verify -->'} |`
+      })
+      content = fillTableSection(content, '## Project Structure', '| | |', pkgRows)
+    }
+  }
+
+  if (content !== orig) {
+    await writeFile(filePath, content, 'utf8')
+    result.populated.push('project.instructions.md')
+  }
+}
+
+async function populateTestingConfig(
+  opencastleDir: string,
+  info: RepoInfo,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'stack', 'testing-config.md')
+  if (!existsSync(filePath)) return
+
+  if (!info.testing?.length) {
+    await unlink(filePath)
+    result.removed.push('stack/testing-config.md')
+    return
+  }
+
+  let content = await readFile(filePath, 'utf8')
+  const orig = content
+
+  const introLine = 'Project-specific testing details referenced by the `browser-testing` skill.'
+  if (content.includes(introLine)) {
+    const cfg = filterConfigFiles(info.configFiles, [
+      'vitest.config.ts',
+      'vitest.config.js',
+      'jest.config.ts',
+      'jest.config.js',
+      'playwright.config.ts',
+      'playwright.config.js',
+    ])
+    let addition = `\n\n**Test frameworks:** ${info.testing.join(', ')}`
+    if (cfg.length > 0) {
+      addition += `\n\n**Config files:** ${cfg.map(f => `\`${f}\``).join(', ')}`
+    }
+    content = content.replace(introLine, introLine + addition)
+  }
+
+  if (content !== orig) {
+    await writeFile(filePath, content, 'utf8')
+    result.populated.push('stack/testing-config.md')
+  }
+}
+
+async function populateDeploymentConfig(
+  opencastleDir: string,
+  info: RepoInfo,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'stack', 'deployment-config.md')
+  if (!existsSync(filePath)) return
+
+  if (!info.deployment?.length) {
+    await unlink(filePath)
+    result.removed.push('stack/deployment-config.md')
+    return
+  }
+
+  let content = await readFile(filePath, 'utf8')
+  const orig = content
+
+  const archMarker =
+    '<!-- Describe the deployment platform, CI/CD pipeline, and trigger mechanism. -->'
+  if (content.includes(archMarker)) {
+    const cfg = filterConfigFiles(info.configFiles, [
+      'vercel.json',
+      'netlify.toml',
+      'Dockerfile',
+      'docker-compose.yml',
+      'docker-compose.yaml',
+      'fly.toml',
+      'render.yaml',
+    ])
+    let addition = `**Platform:** ${info.deployment.join(', ')}`
+    if (cfg.length > 0) {
+      addition += `\n\n**Config files:** ${cfg.map(f => `\`${f}\``).join(', ')}`
+    }
+    content = content.replace(archMarker, addition + '\n\n' + archMarker)
+  }
+
+  if (content !== orig) {
+    await writeFile(filePath, content, 'utf8')
+    result.populated.push('stack/deployment-config.md')
+  }
+}
+
+async function handleDatabaseConfig(
+  opencastleDir: string,
+  info: RepoInfo,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'stack', 'database-config.md')
+  if (!existsSync(filePath)) return
+
+  if (!info.databases?.length) {
+    await unlink(filePath)
+    result.removed.push('stack/database-config.md')
+    return
+  }
+
+  let content = await readFile(filePath, 'utf8')
+  const provider = info.databases[0]
+
+  const integrationMarker =
+    '<!-- Auth library path, migration directory, session pattern, role system overview. -->'
+  if (content.includes(integrationMarker)) {
+    const cfg = filterConfigFiles(info.configFiles, [
+      'supabase/config.toml',
+      'prisma/schema.prisma',
+      'drizzle.config.ts',
+      'drizzle.config.js',
+    ])
+    let addition = `**Provider:** ${provider}`
+    if (cfg.length > 0) {
+      addition += `\n\n**Config files:** ${cfg.map(f => `\`${f}\``).join(', ')}`
+    }
+    addition += '\n\n<!-- TODO: verify -->'
+    content = content.replace(integrationMarker, addition + '\n\n' + integrationMarker)
+  }
+
+  if (info.databases.length === 1) {
+    const newName = `${provider}-config.md`
+    const newPath = join(opencastleDir, 'stack', newName)
+    await writeFile(newPath, content, 'utf8')
+    await unlink(filePath)
+    result.renamed.push(`stack/database-config.md \u2192 stack/${newName}`)
+  } else {
+    await writeFile(filePath, content, 'utf8')
+    result.populated.push('stack/database-config.md')
+  }
+}
+
+async function handleCmsConfig(
+  opencastleDir: string,
+  info: RepoInfo,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'stack', 'cms-config.md')
+  if (!existsSync(filePath)) return
+
+  if (!info.cms?.length) {
+    await unlink(filePath)
+    result.removed.push('stack/cms-config.md')
+    return
+  }
+
+  let content = await readFile(filePath, 'utf8')
+  const provider = info.cms[0]
+
+  const configMarker = '<!-- CMS project IDs, dataset, API version, studio location, etc. -->'
+  if (content.includes(configMarker)) {
+    const cfg = filterConfigFiles(info.configFiles, [
+      'sanity.config.ts',
+      'sanity.config.js',
+      '.contentful.json',
+      'payload.config.ts',
+    ])
+    let addition = `**Provider:** ${provider}`
+    if (cfg.length > 0) {
+      addition += `\n\n**Config files:** ${cfg.map(f => `\`${f}\``).join(', ')}`
+    }
+    addition += '\n\n<!-- TODO: verify -->'
+    content = content.replace(configMarker, addition + '\n\n' + configMarker)
+  }
+
+  if (info.cms.length === 1) {
+    const newName = `${provider}-config.md`
+    const newPath = join(opencastleDir, 'stack', newName)
+    await writeFile(newPath, content, 'utf8')
+    await unlink(filePath)
+    result.renamed.push(`stack/cms-config.md \u2192 stack/${newName}`)
+  } else {
+    await writeFile(filePath, content, 'utf8')
+    result.populated.push('stack/cms-config.md')
+  }
+}
+
+async function removeNotificationsIfUnused(
+  opencastleDir: string,
+  info: RepoInfo,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'stack', 'notifications-config.md')
+  if (!existsSync(filePath) || info.notifications?.length) return
+  await unlink(filePath)
+  result.removed.push('stack/notifications-config.md')
+}
+
+async function handleApiConfig(
+  opencastleDir: string,
+  info: RepoInfo,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'stack', 'api-config.md')
+  if (!existsSync(filePath)) return
+
+  if (!info.frameworks?.length) {
+    await unlink(filePath)
+    result.removed.push('stack/api-config.md')
+    return
+  }
+
+  let content = await readFile(filePath, 'utf8')
+  const orig = content
+
+  const initMarker =
+    '<!-- Populated by `opencastle init` based on detected API routes and Server Actions. -->'
+  if (content.includes(initMarker)) {
+    const frameworkList = info.frameworks.join(', ')
+    content = content.replace(
+      initMarker,
+      `<!-- Populated by \`opencastle init\`. Framework: ${frameworkList} -->`,
+    )
+  }
+
+  if (content !== orig) {
+    await writeFile(filePath, content, 'utf8')
+    result.populated.push('stack/api-config.md')
+  }
+}
+
+async function removeDataPipelineConfig(
+  opencastleDir: string,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'stack', 'data-pipeline-config.md')
+  if (!existsSync(filePath)) return
+  await unlink(filePath)
+  result.removed.push('stack/data-pipeline-config.md')
+}
+
+const TRACKER_TOOLS = new Set<string>(['linear', 'jira'])
+
+async function handleTrackerConfig(
+  opencastleDir: string,
+  info: RepoInfo,
+  stack: StackConfig,
+  result: BootstrapResult,
+): Promise<void> {
+  const filePath = join(opencastleDir, 'project', 'tracker-config.md')
+  if (!existsSync(filePath)) return
+
+  const tracker =
+    stack.teamTools.find(t => TRACKER_TOOLS.has(t)) ??
+    info.pm?.find(p => TRACKER_TOOLS.has(p))
+
+  if (!tracker) {
+    await unlink(filePath)
+    result.removed.push('project/tracker-config.md')
+    return
+  }
+
+  let content = await readFile(filePath, 'utf8')
+  const displayName = tracker.charAt(0).toUpperCase() + tracker.slice(1)
+
+  content = content.replace('# Task Tracker Configuration', `# ${displayName} Configuration`)
+
+  const renameComment =
+    '<!-- Populated by `opencastle init`.\n     Rename this file to match your tracker: linear-config.md, jira-config.md, etc. -->'
+  content = content.replace(renameComment + '\n', '')
+
+  const newName = `${tracker}-config.md`
+  const newPath = join(opencastleDir, 'project', newName)
+  await writeFile(newPath, content, 'utf8')
+  await unlink(filePath)
+  result.renamed.push(`project/tracker-config.md \u2192 project/${newName}`)
+}
+
+// ── Main export ────────────────────────────────────────────────
+
+export async function bootstrapCustomizations(
+  projectRoot: string,
+  repoInfo: RepoInfo,
+  stack: StackConfig,
+): Promise<BootstrapResult> {
+  const opencastleDir = join(projectRoot, '.opencastle')
+  const result: BootstrapResult = { populated: [], removed: [], renamed: [] }
+
+  const pkg = (await tryReadJson<PackageJson>(join(projectRoot, 'package.json'))) ?? {}
+
+  await populateProjectInstructions(opencastleDir, projectRoot, repoInfo, pkg, result)
+  await populateTestingConfig(opencastleDir, repoInfo, result)
+  await populateDeploymentConfig(opencastleDir, repoInfo, result)
+  await handleDatabaseConfig(opencastleDir, repoInfo, result)
+  await handleCmsConfig(opencastleDir, repoInfo, result)
+  await removeNotificationsIfUnused(opencastleDir, repoInfo, result)
+  await handleApiConfig(opencastleDir, repoInfo, result)
+  await removeDataPipelineConfig(opencastleDir, result)
+  await handleTrackerConfig(opencastleDir, repoInfo, stack, result)
+
+  return result
+}

package/src/cli/detect.ts

@@ -1,7 +1,28 @@
 import { resolve } from 'node:path';
 import { readFile, readdir, access } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
-import type { RepoInfo, StackConfig } from './types.js';
+import type { IdeChoice, RepoInfo, StackConfig } from './types.js';
+
+// ── IDE detection ───────────────────────────────────────────────
+
+/**
+ * Detect which IDE the CLI is running from, based on environment variables.
+ * Returns the IdeChoice value or undefined if unknown.
+ */
+export function detectCurrentIde(): IdeChoice | undefined {
+  const env = process.env;
+
+  // Cursor sets its own TERM_PROGRAM or CURSOR-specific env vars
+  if (env.CURSOR_TRACE_DIR || env.CURSOR_CHANNEL) return 'cursor';
+
+  // VS Code sets TERM_PROGRAM=vscode in its integrated terminal
+  if (env.TERM_PROGRAM === 'vscode') return 'vscode';
+
+  // Claude Code — check for CLAUDE_* env vars set by the CLI
+  if (env.CLAUDE_CODE === '1' || env.CLAUDE_PROJECT_ROOT) return 'claude-code';
+
+  return undefined;
+}
 
 // ── Detection rules ───────────────────────────────────────────
 

package/src/cli/init.ts

@@ -7,15 +7,11 @@ import { removeDirIfExists, copyDir, getOrchestratorRoot } from './copy.js'
 import { updateGitignore } from './gitignore.js'
 import { getRequiredMcpEnvVars, getCustomizationsTransform } from './stack-config.js'
 import { TECH_PLUGINS, TEAM_PLUGINS } from '../orchestrator/plugins/index.js'
-import { detectRepoInfo, mergeStackIntoRepoInfo, formatRepoInfo, buildDetectedToolsSet } from './detect.js'
+import { detectRepoInfo, mergeStackIntoRepoInfo, formatRepoInfo, buildDetectedToolsSet, detectCurrentIde } from './detect.js'
 import { IDE_ADAPTERS } from './adapters/index.js'
 import { IDE_LABELS } from './types.js'
 import type { CliContext, IdeChoice, TechTool, TeamTool, StackConfig } from './types.js'
-
-/** OSC 8 terminal hyperlink — clickable in VS Code integrated terminal and modern terminals */
-function termLink(text: string, url: string): string {
-  return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`
-}
+import { bootstrapCustomizations } from './bootstrap.js'
 
 export default async function init({ pkgRoot, args }: CliContext): Promise<void> {
   const projectRoot = process.cwd()
@@ -57,26 +53,31 @@ export default async function init({ pkgRoot, args }: CliContext): Promise<void>
 
   // ── IDE (single select) ────────────────────────────────────────
   console.log(`  ${c.bold('── IDEs ──────────────────────────────────────')}`)
+  const detectedIde = detectCurrentIde()
   const selectedIde = await select('Which IDE do you use?', [
     {
       label: 'VS Code',
       hint: 'GitHub Copilot agents, instructions, skills',
       value: 'vscode',
+      ...(detectedIde === 'vscode' && { selected: true }),
     },
     {
       label: 'Cursor',
       hint: '.cursorrules & .cursor/rules/*.mdc',
       value: 'cursor',
+      ...(detectedIde === 'cursor' && { selected: true }),
     },
     {
       label: 'Claude Code',
       hint: 'CLAUDE.md & .claude/ commands, skills',
       value: 'claude-code',
+      ...(detectedIde === 'claude-code' && { selected: true }),
     },
     {
       label: 'OpenCode',
       hint: 'AGENTS.md & opencode.json',
       value: 'opencode',
+      ...(detectedIde === 'opencode' && { selected: true }),
     },
   ])
   const ides = [selectedIde]
@@ -227,6 +228,22 @@ export default async function init({ pkgRoot, args }: CliContext): Promise<void>
     totalSkipped += sub.skipped.length
   }
 
+  // ── Project scan ────────────────────────────────────────────────
+  console.log(`\n  ${c.dim('Configuring project...')}`)
+  const bootstrapResult = await bootstrapCustomizations(projectRoot, combinedRepoInfo, stack)
+
+  if (bootstrapResult.populated.length > 0) {
+    console.log(`  ${c.green('✓')} Populated ${c.bold(String(bootstrapResult.populated.length))} config files`)
+  }
+  if (bootstrapResult.renamed.length > 0) {
+    for (const r of bootstrapResult.renamed) {
+      console.log(`  ${c.dim('→')} Renamed ${r}`)
+    }
+  }
+  if (bootstrapResult.removed.length > 0) {
+    console.log(`  ${c.dim('→')} Removed ${bootstrapResult.removed.length} unused template(s)`)
+  }
+
   // ── Write manifest ──────────────────────────────────────────────
   const manifest = createManifest(pkg.version, ides[0], ides)
   manifest.managedPaths = allManagedPaths
@@ -317,13 +334,6 @@ export default async function init({ pkgRoot, args }: CliContext): Promise<void>
     )
   }
   step++
-  const bootstrapLabel = ides.includes('vscode')
-    ? termLink(c.cyan('"Bootstrap Customizations"'), 'vscode://GitHub.Copilot-Chat/chat?mode=Team%20Lead%20(OpenCastle)&prompt=%2Fbootstrap-customizations')
-    : c.cyan('"Bootstrap Customizations"')
-  console.log(
-    `  ${step}. Run the ${bootstrapLabel} prompt to configure for your project`
-  )
-  step++
   console.log(`  ${step}. Commit the .opencastle/ folder to your repository`)
   console.log()
 

package/src/cli/prompt.ts

@@ -188,7 +188,7 @@ function selectInteractive(
   options: SelectOption[]
 ): Promise<string> {
   return new Promise<string>((resolve) => {
-    let cursor = 0;
+    let cursor = Math.max(0, options.findIndex((o) => o.selected));
     const maxVisible = Math.max(3, Math.min(options.length, (process.stdout.rows || 24) - 4));
     let lastRenderedLines = 0;
 

package/src/dashboard/node_modules/.vite/deps/_metadata.json

@@ -1,25 +1,25 @@
 {
-  "hash": "444a3464",
+  "hash": "939c6a62",
   "configHash": "30f8ea04",
-  "lockfileHash": "b44c3569",
-  "browserHash": "30897244",
+  "lockfileHash": "2a42269f",
+  "browserHash": "10c140c1",
   "optimized": {
     "astro > cssesc": {
       "src": "../../../../../node_modules/cssesc/cssesc.js",
       "file": "astro___cssesc.js",
-      "fileHash": "cee74f3e",
+      "fileHash": "9fc34a31",
       "needsInterop": true
     },
     "astro > aria-query": {
       "src": "../../../../../node_modules/aria-query/lib/index.js",
       "file": "astro___aria-query.js",
-      "fileHash": "9af6f54a",
+      "fileHash": "e0152e5e",
       "needsInterop": true
     },
     "astro > axobject-query": {
       "src": "../../../../../node_modules/axobject-query/lib/index.js",
       "file": "astro___axobject-query.js",
-      "fileHash": "5fe9f18b",
+      "fileHash": "c3b40a68",
       "needsInterop": true
     }
   },

package/src/orchestrator/agents/team-lead.agent.md

@@ -152,7 +152,7 @@ The convoy engine is the **mandatory** execution mechanism for all project-relat
 | Work type | Approach |
 |-----------|----------|
 | Features, bug fixes, refactors (any subtask count) | **Convoy execution** — always generate a `.convoy.yml` spec, even for 1-task fixes |
-| Utility prompts (`bootstrap-customizations`, `create-skill`, `generate-convoy`, `brainstorm`, `quick-refinement`) | **Direct** — these are meta/tooling operations, not project code changes |
+| Utility prompts (`create-skill`, `generate-convoy`, `brainstorm`, `quick-refinement`) | **Direct** — these are meta/tooling operations, not project code changes |
 
 ### How to generate a convoy spec
 
@@ -247,8 +247,10 @@ For each task:
      - High-stakes: panel review (load panel-majority-vote skill)
      - Discovered issues tracked (not silently ignored)
      - Lessons captured (if agent retried anything)
+     - Agent expertise updated (AGENT-EXPERTISE.md)
+     - Knowledge graph appended (KNOWLEDGE-GRAPH.md)
   6. PASS → log review (⛔ hard gate — do NOT proceed until logged), move issue → Done
-     FAIL → re-delegate with failure details (max 3 attempts)
+     FAIL → re-delegate with failure details (max 3 attempts → log DLQ in AGENT-FAILURES.md)
 ```
 
 Fast review auto-PASS: research-only tasks, docs-only, or ≤10 lines across ≤2 files with all deterministic gates passing.

package/src/orchestrator/customizations/README.md

@@ -32,7 +32,7 @@ Skills reference these files with relative links like `../../.opencastle/stack/a
 
 | File | Purpose |
 |------|---------|
-| _(created by `bootstrap-customizations` prompt based on detected technologies)_ | |
+| _(created by `opencastle init` based on detected technologies)_ | |
 
 ### `project/` — Project management config
 
@@ -41,7 +41,7 @@ Skills reference these files with relative links like `../../.opencastle/stack/a
 | `docs-structure.md` | Project documentation directory tree and practices |
 | `roadmap.md` | Project roadmap with planned features and their status |
 | `decisions.md` | Architecture Decision Records (ADRs) for the project |
-| _(task tracker config created by `bootstrap-customizations` prompt)_ | |
+| _(task tracker config created by `opencastle init`)_ | |
 
 ### `logs/` — Append-only NDJSON session logs
 
@@ -58,4 +58,4 @@ Update these files when the project changes — new tables, new API routes, new
 
 ## Bootstrap
 
-Run the `bootstrap-customizations` prompt to auto-discover the project's structure and populate these files. It will scan for frameworks, databases, CMS, deployment config, and task tracking, then generate the appropriate `stack/` and `project/` files.
+Run `npx opencastle init` to auto-discover the project's structure and populate these files. It scans for frameworks, databases, CMS, deployment config, and task tracking, then generates the appropriate `stack/` and `project/` files.

package/src/orchestrator/customizations/agents/agent-registry.md

@@ -3,7 +3,7 @@
 
 Project-specific agent-to-model assignments and scope examples referenced by the `team-lead-reference` skill.
 
-<!-- Populated by the `bootstrap-customizations` prompt based on project structure. -->
+<!-- Populated by `opencastle init` based on project structure. -->
 
 ## Specialist Agent Registry