@pjmendonca/devflow 1.10.1 → 1.10.2

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.10.2] - 2025-12-24
+
+### Fixed
+- **npx Command** - Fixed "could not determine executable to run" error when running `npx @pjmendonca/devflow`
+  - Added main `devflow` bin entry to package.json
+  - Created bin/devflow.js as smart entry point with context detection
+  - Outside Devflow project: automatically scaffolds new project
+  - Inside Devflow project: shows help and dispatches to commands
+  - Simplified workflow: single command for both setup and usage
+
 ## [1.10.1] - 2025-12-24
 
 ### Fixed

package/README.md

@@ -532,7 +532,7 @@ Free to use in commercial and personal projects.
 
 
 <!-- VERSION_START - Auto-updated by update_version.py -->
-**Version**: 1.10.1
+**Version**: 1.10.2
 **Status**: Production Ready
 **Last Updated**: 2025-12-24
 <!-- VERSION_END -->

package/bin/devflow.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const commands = {
+  'init': 'Initialize Devflow in your project',
+  'story': 'Run full story pipeline (context + dev + review)',
+  'collab': 'Run collaborative story with mode selection',
+  'checkpoint': 'Create or restore context checkpoints',
+  'memory': 'View or query shared agent memory',
+  'cost': 'View cost dashboard and spending analytics',
+  'validate': 'Validate project configuration',
+  'create-persona': 'Create a new agent persona',
+  'personalize': 'Personalize agent behavior with guided wizard',
+  'validate-overrides': 'Validate override configurations',
+  'new-doc': 'Create new documentation',
+  'tech-debt': 'Analyze and track technical debt',
+  'setup-checkpoint': 'Setup checkpoint system',
+  'version': 'Show version information'
+};
+
+/**
+ * Check if we're in a Devflow project
+ */
+function isInDevflowProject() {
+  const indicators = [
+    'tooling/.automation',
+    'tooling/scripts',
+    '.claude'
+  ];
+
+  return indicators.some(indicator => fs.existsSync(path.join(process.cwd(), indicator)));
+}
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  console.log('Devflow - Development workflow automation with Claude Code\n');
+  console.log('Usage: devflow <command> [options]\n');
+  console.log('Available commands:\n');
+
+  Object.entries(commands).forEach(([cmd, desc]) => {
+    console.log(`  ${cmd.padEnd(20)} ${desc}`);
+  });
+
+  console.log('\nRun "devflow <command> --help" for more information on a command.');
+  console.log('\nGet started: devflow init');
+}
+
+const args = process.argv.slice(2);
+
+// If no arguments or --help, check if we're in a project
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+  if (!isInDevflowProject()) {
+    // Not in a project - run scaffolder
+    console.log('No Devflow project detected. Running project scaffolder...\n');
+    const createScript = require.resolve('./create-devflow.js');
+    const child = spawn('node', [createScript], { stdio: 'inherit' });
+    child.on('exit', (code) => process.exit(code || 0));
+  } else {
+    // In a project - show help
+    showHelp();
+    process.exit(0);
+  }
+} else {
+  // Command provided
+  const command = args[0];
+
+  if (commands[command]) {
+    const binPath = require.resolve(`./devflow-${command}.js`);
+    const child = spawn('node', [binPath, ...args.slice(1)], { stdio: 'inherit' });
+    child.on('exit', (code) => process.exit(code || 0));
+  } else {
+    console.error(`Unknown command: ${command}`);
+    console.error('Run "devflow --help" to see available commands.');
+    process.exit(1);
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pjmendonca/devflow",
-  "version": "1.10.1",
+  "version": "1.10.2",
   "description": "Development workflow automation with Claude Code - agent-based development system with cost tracking",
   "keywords": [
     "devflow",
@@ -24,6 +24,7 @@
     "name": "Pedro Jose da Rocha Mendonca"
   },
   "bin": {
+    "devflow": "bin/devflow.js",
     "create-devflow": "bin/create-devflow.js",
     "devflow-cost": "bin/devflow-cost.js",
     "devflow-validate": "bin/devflow-validate.js",

package/tooling/scripts/lib/__init__.py

@@ -18,7 +18,7 @@ Usage:
     from lib.agent_router import AgentRouter
 """
 
-__version__ = "1.10.1"
+__version__ = "1.10.2"
 
 # Lazy imports to avoid circular dependencies
 __all__ = [