buildflow-dev 1.0.3 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buildflow-dev",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Adaptive AI-powered development orchestration. Works with Claude Code, Gemini CLI, Codex CLI, Cursor, and more.",
   "keywords": [
     "ai",

package/src/commands/install.js

@@ -59,20 +59,29 @@ const TOOLS = {
     docsUrl: 'https://github.com/google-gemini/gemini-cli',
 
     detect() {
-      try { which.sync('gemini'); return true } catch { return false }
+      const hasCli = (() => { try { which.sync('gemini'); return true } catch { return false } })()
+      // Also check config dir — binary may not be on PATH in all shells
+      const hasGeminiDir = existsSync(join(homedir(), '.gemini'))
+      return hasCli || hasGeminiDir
     },
 
-    isInstalledLocal()  { return existsSync(join(process.cwd(), '.gemini', 'commands', 'start.md')) },
-    isInstalledGlobal() { return existsSync(join(homedir(), '.gemini', 'commands', 'start.md')) },
+    isInstalledLocal() {
+      const cmdFile = existsSync(join(process.cwd(), '.gemini', 'commands', 'start.md'))
+      const ctxFile = existsSync(join(process.cwd(), 'GEMINI.md')) &&
+        readFileSafe(join(process.cwd(), 'GEMINI.md')).includes('BuildFlow')
+      return cmdFile || ctxFile
+    },
+    isInstalledGlobal() {
+      const cmdFile = existsSync(join(homedir(), '.gemini', 'commands', 'start.md'))
+      const ctxFile = existsSync(join(homedir(), '.gemini', 'GEMINI.md')) &&
+        readFileSafe(join(homedir(), '.gemini', 'GEMINI.md')).includes('BuildFlow')
+      return cmdFile || ctxFile
+    },
 
     installGlobal(commandFiles) {
       const dir = join(homedir(), '.gemini', 'commands')
       mkdirSync(dir, { recursive: true })
-      const contextPath = join(homedir(), '.gemini', 'GEMINI.md')
-      const existingContent = existsSync(contextPath) ? readFileSync(contextPath, 'utf8') : ''
-      if (!existingContent.includes('## BuildFlow Commands')) {
-        writeFileSync(contextPath, existingContent + '\n\n' + geminiContextBlock(commandFiles))
-      }
+      patchGeminiContext(join(homedir(), '.gemini', 'GEMINI.md'), commandFiles)
       for (const [name, content] of Object.entries(commandFiles)) {
         writeFileSync(join(dir, `${name}.md`), content)
       }
@@ -82,18 +91,14 @@ const TOOLS = {
     installLocal(commandFiles) {
       const dir = join(process.cwd(), '.gemini', 'commands')
       mkdirSync(dir, { recursive: true })
-      const contextPath = join(process.cwd(), 'GEMINI.md')
-      const existingContent = existsSync(contextPath) ? readFileSync(contextPath, 'utf8') : ''
-      if (!existingContent.includes('## BuildFlow Commands')) {
-        writeFileSync(contextPath, existingContent + '\n\n' + geminiContextBlock(commandFiles))
-      }
+      patchGeminiContext(join(process.cwd(), 'GEMINI.md'), commandFiles)
       for (const [name, content] of Object.entries(commandFiles)) {
         writeFileSync(join(dir, `${name}.md`), content)
       }
       return dir
     },
 
-    triggerNote: 'In Gemini CLI, type "/" or @buildflow to use commands',
+    triggerNote: 'In Gemini CLI, type "/buildflow-start" or ask Gemini to run a buildflow command',
   },
 
   codex: {
@@ -104,7 +109,9 @@ const TOOLS = {
     docsUrl: 'https://github.com/openai/codex',
 
     detect() {
-      try { which.sync('codex'); return true } catch { return false }
+      const hasCli = (() => { try { which.sync('codex'); return true } catch { return false } })()
+      const hasCodexDir = existsSync(join(homedir(), '.codex'))
+      return hasCli || hasCodexDir
     },
 
     isInstalledLocal()  { return existsSync(join(process.cwd(), '.codex', 'instructions', 'buildflow-start.md')) },
@@ -188,8 +195,7 @@ const TOOLS = {
     },
 
     isInstalledLocal() {
-      const p = join(process.cwd(), '.clinerules')
-      return existsSync(p) && readFileSync(p, 'utf8').includes('BuildFlow')
+      return readFileSafe(join(process.cwd(), '.clinerules')).includes('BuildFlow')
     },
     isInstalledGlobal() { return this.isInstalledLocal() },
 
@@ -267,11 +273,18 @@ ${UPDATE_CHECK_INSTRUCTION}`
 }
 
 function patchAgentsMd(filePath, scope) {
-  const existing = existsSync(filePath) ? readFileSync(filePath, 'utf8') : ''
-  if (existing.includes('BuildFlow')) return
+  const existing = readFileSafe(filePath)
   const dir = scope === 'global' ? '~/.codex/instructions/' : '.codex/instructions/'
-  const block = `\n\n## BuildFlow Instructions\n\nWhen the user types $buildflow-<command> or /buildflow-<command>, load the matching file from ${dir} and follow those instructions.\n\nAvailable commands: start, think, plan, build, check, ship, onboard, modify, refactor, audit, status, explain, back, help\n${UPDATE_CHECK_INSTRUCTION}`
-  writeFileSync(filePath, existing + block)
+  const block = `## BuildFlow Instructions\n\nWhen the user types $buildflow-<command> or /buildflow-<command>, load the matching file from ${dir} and follow those instructions.\n\nAvailable commands: start, think, plan, build, check, ship, onboard, modify, refactor, audit, status, explain, back, help\n${UPDATE_CHECK_INSTRUCTION}`
+  if (existing.includes('## BuildFlow Instructions')) {
+    const updated = existing.replace(
+      /## BuildFlow Instructions[\s\S]*?(?=\n## |\n# |$)/,
+      block
+    )
+    writeFileSync(filePath, updated)
+  } else {
+    writeFileSync(filePath, existing + (existing ? '\n\n' : '') + block)
+  }
 }
 
 function writeCodexSkill(skillsDir, name, commandContent) {
@@ -408,6 +421,27 @@ function readdirSafe(dir) {
   }
 }
 
+function readFileSafe(filePath) {
+  try { return readFileSync(filePath, 'utf8') } catch { return '' }
+}
+
+// Writes or replaces the BuildFlow block in a GEMINI.md context file.
+// Always overwrites the block so updates pick up new commands.
+function patchGeminiContext(contextPath, commandFiles) {
+  const existing = readFileSafe(contextPath)
+  const block = geminiContextBlock(commandFiles)
+  if (existing.includes('## BuildFlow Commands')) {
+    // Replace old block — from the marker to the next top-level ## or end of file
+    const updated = existing.replace(
+      /## BuildFlow Commands[\s\S]*?(?=\n## |\n# |$)/,
+      block.trimStart()
+    )
+    writeFileSync(contextPath, updated)
+  } else {
+    writeFileSync(contextPath, existing + (existing ? '\n\n' : '') + block)
+  }
+}
+
 function detectAppName() {
   const pkgPath = join(process.cwd(), 'package.json')
   if (existsSync(pkgPath)) {
@@ -421,6 +455,44 @@ function detectAppName() {
   return process.cwd().split(/[/\\]/).pop() || 'my-project'
 }
 
+export async function refreshInstalledTools(opts = {}) {
+  const commandFiles = loadCommandTemplates()
+  const commandCount = Object.keys(commandFiles).length
+  const results = []
+
+  for (const tool of Object.values(TOOLS)) {
+    const local  = tool.isInstalledLocal()
+    const global = tool.isInstalledGlobal()
+    if (!local && !global) continue
+
+    const sp = ora(`  ${tool.icon}  Refreshing ${tool.name}...`).start()
+    try {
+      if (local)  tool.installLocal(commandFiles)
+      if (global && !local) tool.installGlobal(commandFiles)
+      sp.succeed(chalk.green(`  ${tool.icon}  ${tool.name}`) + chalk.dim(` — ${commandCount} commands refreshed`))
+      results.push({ tool, success: true })
+    } catch (err) {
+      sp.fail(chalk.red(`  ${tool.icon}  ${tool.name} — ${err.message}`))
+      results.push({ tool, success: false, error: err })
+    }
+  }
+
+  if (results.length === 0) {
+    console.log(chalk.yellow('  No previously installed tools found.'))
+    console.log(chalk.dim('  Run: buildflow install\n'))
+  } else {
+    const failed = results.filter(r => !r.success)
+    if (failed.length > 0) {
+      console.log(chalk.red('\n  Some tools failed to update:'))
+      for (const { tool, error } of failed) {
+        console.log(chalk.red(`  ✗ ${tool.name}: ${error.message}`))
+      }
+    }
+  }
+
+  return results
+}
+
 export function getToolStatus() {
   return Object.values(TOOLS).map(tool => ({
     id:              tool.id,

package/src/commands/update.js

@@ -1,21 +1,14 @@
 import chalk from 'chalk'
 import ora from 'ora'
-import { existsSync, readFileSync } from 'fs'
+import { readFileSync } from 'fs'
 import { join, dirname } from 'path'
 import { fileURLToPath } from 'url'
-import { run as runInstall } from './install.js'
+import { refreshInstalledTools } from './install.js'
 import { checkVersion, clearUpdateNotice } from '../utils/checkVersion.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 
 export async function run(opts = {}) {
-  const base = join(process.cwd(), '.buildflow')
-
-  if (!existsSync(base)) {
-    console.log(chalk.yellow('\n  BuildFlow not initialized. Run: npx buildflow-dev init\n'))
-    return
-  }
-
   const pkg = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf8'))
 
   if (opts.check) {
@@ -26,7 +19,7 @@ export async function run(opts = {}) {
 
     if (update) {
       console.log(chalk.yellow(`  Update available: ${update.current} → ${update.latest}`))
-      console.log(chalk.white('  Run: npx buildflow-dev update\n'))
+      console.log(chalk.white('  Run: npx buildflow-dev@latest update\n'))
     } else {
       console.log(chalk.green(`  ✓ Up to date (v${pkg.version})\n`))
     }
@@ -35,13 +28,11 @@ export async function run(opts = {}) {
 
   console.log('\n' + chalk.bold.white('  Updating BuildFlow...\n'))
 
-  const sp = ora('Updating command files...').start()
-  await new Promise(r => setTimeout(r, 400))
-  sp.succeed(chalk.green('  ✓ Command files updated'))
+  // Re-push latest command templates to all previously installed tools
+  await refreshInstalledTools()
 
   // Clear the update notice now that we've updated
   clearUpdateNotice()
 
-  console.log('')
-  await runInstall({ yes: opts.yes })
+  console.log(chalk.green(`\n  ✓ BuildFlow updated to v${pkg.version}\n`))
 }

package/src/utils/welcome.js

@@ -13,7 +13,7 @@ export async function showWelcome() {
   checkVersion(pkg.version).then(update => {
     if (update) {
       console.log(chalk.yellow(`\n  Update available: ${update.current} → ${update.latest}`))
-      console.log(chalk.dim('  Run: npx buildflow-dev update\n'))
+      console.log(chalk.dim('  Run: npx buildflow-dev@latest update\n'))
     }
   }).catch(() => {})
   const isInitialized = existsSync(join(process.cwd(), '.buildflow'))
@@ -66,9 +66,9 @@ export async function showWelcome() {
     console.log(chalk.cyan('    /buildflow-status ') + chalk.dim('  Where am I?'))
     console.log('')
     console.log(chalk.dim('  CLI commands:'))
-    console.log(chalk.white('    buildflow status  ') + chalk.dim('  Show project status'))
-    console.log(chalk.white('    buildflow audit   ') + chalk.dim('  Run security audit from terminal'))
-    console.log(chalk.white('    buildflow update  ') + chalk.dim('  Update BuildFlow commands'))
+    console.log(chalk.white('    npx buildflow-dev status  ') + chalk.dim('  Show project status'))
+    console.log(chalk.white('    npx buildflow-dev audit   ') + chalk.dim('  Run security audit from terminal'))
+    console.log(chalk.white('    npx buildflow-dev update  ') + chalk.dim('  Refresh AI tool command files'))
 
     // Surface any newly installed AI tools that don't have BuildFlow yet
     const uninstalled = getToolStatus().filter(t => t.detected && !t.installedLocal && !t.installedGlobal)