prjct-cli 0.10.12 → 0.10.13

package/core/agentic/command-executor.js

@@ -15,6 +15,9 @@
  * Source: Claude Code, Devin, Augment Code patterns
  */
 
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
 const templateLoader = require('./template-loader')
 const contextBuilder = require('./context-builder')
 const promptBuilder = require('./prompt-builder')
@@ -32,6 +35,9 @@ const groundTruth = require('./ground-truth')
 const thinkBlocks = require('./think-blocks')
 const parallelTools = require('./parallel-tools')
 const planMode = require('./plan-mode')
+
+// Running file for status line integration
+const RUNNING_FILE = path.join(os.homedir(), '.prjct-cli', '.running')
 // P3.5, P3.6, P3.7: DELEGATED TO CLAUDE CODE
 // - semantic-search → Claude Code has Grep/Glob with semantic understanding
 // - code-intelligence → Claude Code has native LSP integration
@@ -44,16 +50,48 @@ class CommandExecutor {
     this.contextEstimator = null
   }
 
+  /**
+   * Signal that a command is running (for status line)
+   */
+  signalStart(commandName) {
+    try {
+      const dir = path.dirname(RUNNING_FILE)
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true })
+      }
+      fs.writeFileSync(RUNNING_FILE, `/p:${commandName}`)
+    } catch {
+      // Silently ignore - status line is optional
+    }
+  }
+
+  /**
+   * Signal that command has finished (for status line)
+   */
+  signalEnd() {
+    try {
+      if (fs.existsSync(RUNNING_FILE)) {
+        fs.unlinkSync(RUNNING_FILE)
+      }
+    } catch {
+      // Silently ignore - status line is optional
+    }
+  }
+
   /**
    * Execute command with MANDATORY agent assignment
    */
   async execute(commandName, params, projectPath) {
+    // Signal start for status line
+    this.signalStart(commandName)
+
     // Context for loop detection
     const loopContext = params.task || params.description || ''
 
     // Check if we're in a loop BEFORE attempting
     if (loopDetector.shouldEscalate(commandName, loopContext)) {
       const escalation = loopDetector.getEscalationInfo(commandName, loopContext)
+      this.signalEnd()
       return {
         success: false,
         error: escalation.message,
@@ -73,6 +111,7 @@ class CommandExecutor {
       // 2.5. VALIDATE: Pre-flight checks with specific errors
       const validation = await validate(commandName, metadataContext)
       if (!validation.valid) {
+        this.signalEnd()
         return {
           success: false,
           error: formatError(validation),
@@ -267,6 +306,9 @@ class CommandExecutor {
       // Record successful attempt
       loopDetector.recordSuccess(commandName, loopContext)
 
+      // Signal end for status line
+      this.signalEnd()
+
       return {
         success: true,
         template,
@@ -334,6 +376,9 @@ class CommandExecutor {
         // - Native LSP for code intelligence
       }
     } catch (error) {
+      // Signal end for status line
+      this.signalEnd()
+
       // Record failed attempt for loop detection
       const attemptInfo = loopDetector.recordAttempt(commandName, loopContext, {
         success: false,

package/core/commands.js

@@ -1925,6 +1925,15 @@ Agent: ${agent} (${Math.round(confidence * 100)}% confidence)
       console.log(`⚠️  ${configResult.error}`)
     }
 
+    // Install status line for Claude Code
+    console.log('\n⚡ Installing status line...')
+    const statusLineResult = await this.installStatusLine()
+    if (statusLineResult.success) {
+      console.log('✅ Status line configured')
+    } else {
+      console.log(`⚠️  ${statusLineResult.error}`)
+    }
+
     console.log('\n🎉 Setup complete!\n')
 
     // Show beautiful ASCII art
@@ -1936,6 +1945,69 @@ Agent: ${agent} (${Math.round(confidence * 100)}% confidence)
     }
   }
 
+  /**
+   * Install status line script and configure settings.json
+   */
+  async installStatusLine() {
+    const fs = require('fs')
+    const path = require('path')
+    const os = require('os')
+
+    try {
+      const claudeDir = path.join(os.homedir(), '.claude')
+      const settingsPath = path.join(claudeDir, 'settings.json')
+      const statusLinePath = path.join(claudeDir, 'prjct-statusline.sh')
+
+      // Copy status line script
+      const scriptContent = `#!/bin/bash
+# prjct Status Line for Claude Code
+# Shows ⚡ prjct with animated spinner when command is running
+
+# Read JSON context from stdin (provided by Claude Code)
+read -r json
+
+# Spinner frames
+frames=('⠋' '⠙' '⠹' '⠸' '⠼' '⠴' '⠦' '⠧' '⠇' '⠏')
+
+# Calculate frame based on time (changes every 80ms)
+frame=$(($(date +%s%N 2>/dev/null || echo 0) / 80000000 % 10))
+
+# Check if prjct command is running
+running_file="$HOME/.prjct-cli/.running"
+
+if [ -f "$running_file" ]; then
+  task=$(cat "$running_file" 2>/dev/null || echo "working")
+  echo "⚡ prjct \${frames[$frame]} $task"
+else
+  echo "⚡ prjct"
+fi
+`
+      fs.writeFileSync(statusLinePath, scriptContent, { mode: 0o755 })
+
+      // Update settings.json
+      let settings = {}
+      if (fs.existsSync(settingsPath)) {
+        try {
+          settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'))
+        } catch {
+          // Invalid JSON, start fresh
+        }
+      }
+
+      // Set status line configuration
+      settings.statusLine = {
+        type: 'command',
+        command: statusLinePath
+      }
+
+      fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2))
+
+      return { success: true }
+    } catch (error) {
+      return { success: false, error: error.message }
+    }
+  }
+
   /**
    * Show beautiful ASCII art with quick start
    */

package/core/index.js

@@ -6,6 +6,7 @@
 
 const { PrjctCommands } = require('./commands')
 const registry = require('./command-registry')
+const out = require('./utils/output')
 
 async function main() {
   const [commandName, ...rawArgs] = process.argv.slice(2)
@@ -25,6 +26,9 @@ async function main() {
 
   // === DYNAMIC COMMAND EXECUTION ===
 
+  // Show branding header
+  out.start()
+
   try {
     // 1. Find command in registry
     const cmd = registry.getByName(commandName)
@@ -32,6 +36,7 @@ async function main() {
     if (!cmd) {
       console.error(`Unknown command: ${commandName}`)
       console.error(`\nUse 'prjct --help' to see available commands.`)
+      out.end()
       process.exit(1)
     }
 
@@ -41,6 +46,7 @@ async function main() {
       if (cmd.replacedBy) {
         console.error(`Use 'prjct ${cmd.replacedBy}' instead.`)
       }
+      out.end()
       process.exit(1)
     }
 
@@ -49,6 +55,7 @@ async function main() {
       console.error(`Command '${commandName}' exists but is not yet implemented.`)
       console.error(`Check the roadmap or contribute: https://github.com/jlopezlira/prjct-cli`)
       console.error(`\nUse 'prjct --help' to see available commands.`)
+      out.end()
       process.exit(1)
     }
 
@@ -90,12 +97,16 @@ async function main() {
       console.log(result.message)
     }
 
+    // Show branding footer
+    out.end()
     process.exit(result && result.success ? 0 : 1)
   } catch (error) {
     console.error('Error:', error.message)
     if (process.env.DEBUG) {
       console.error(error.stack)
     }
+    // Show branding footer even on error
+    out.end()
     process.exit(1)
   }
 }

package/core/utils/branding.js

@@ -0,0 +1,47 @@
+/**
+ * Branding Configuration for prjct-cli
+ * Single source of truth for all branding across CLI and Claude Code
+ */
+
+const chalk = require('chalk')
+
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+const SPINNER_SPEED = 80
+
+const branding = {
+  // Core identity
+  name: 'prjct',
+  icon: '⚡',
+  signature: '⚡ prjct',
+
+  // Spinner config
+  spinner: {
+    frames: SPINNER_FRAMES,
+    speed: SPINNER_SPEED
+  },
+
+  // CLI output (with chalk colors)
+  cli: {
+    header: () => chalk.cyan.bold('⚡') + ' ' + chalk.cyan('prjct'),
+    footer: () => chalk.dim('⚡ prjct'),
+    spin: (frame, msg) => chalk.cyan('⚡') + ' ' + chalk.cyan('prjct') + ' ' + chalk.cyan(SPINNER_FRAMES[frame % 10]) + ' ' + chalk.dim(msg || '')
+  },
+
+  // Template/Claude (plain text)
+  template: {
+    header: '⚡ prjct',
+    footer: '⚡ prjct'
+  },
+
+  // Git commit footer
+  commitFooter: `🤖 Generated with [p/](https://www.prjct.app/)
+Designed for [Claude](https://www.anthropic.com/claude)`,
+
+  // URLs
+  urls: {
+    website: 'https://prjct.app',
+    docs: 'https://prjct.app/docs'
+  }
+}
+
+module.exports = branding

package/core/utils/output.js

@@ -1,24 +1,39 @@
 /**
  * Minimal Output System for prjct-cli
  * Spinner while working → Single line result
+ * With ⚡ prjct branding
  */
 
 const chalk = require('chalk')
+const branding = require('./branding')
 
-const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
-const SPEED = 80
+const FRAMES = branding.spinner.frames
+const SPEED = branding.spinner.speed
 
 let interval = null
 let frame = 0
 
 const truncate = (s, max = 50) => (s && s.length > max ? s.slice(0, max - 1) + '…' : s || '')
-const clear = () => process.stdout.write('\r' + ' '.repeat(70) + '\r')
+const clear = () => process.stdout.write('\r' + ' '.repeat(80) + '\r')
 
 const out = {
+  // Branding: Show header at start
+  start() {
+    console.log(branding.cli.header())
+    return this
+  },
+
+  // Branding: Show footer at end
+  end() {
+    console.log(branding.cli.footer())
+    return this
+  },
+
+  // Branded spinner: ⚡ prjct ⠋ message...
   spin(msg) {
     this.stop()
     interval = setInterval(() => {
-      process.stdout.write(`\r${chalk.cyan(FRAMES[frame++ % 10])} ${truncate(msg, 55)}`)
+      process.stdout.write(`\r${branding.cli.spin(frame++, truncate(msg, 45))}`)
     }, SPEED)
     return this
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.10.12",
+  "version": "0.10.13",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {