devflow-kit 0.4.0 → 0.6.0

package/dist/commands/uninstall.js.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/cli/commands/uninstall.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/cli/commands/uninstall.ts"],"names":[],"mappings":"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"}

package/dist/utils/git.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Get git repository root directory (async, non-blocking)
+ * Returns null if not in a git repository
+ *
+ * Security: Validates output to prevent command injection
+ * - Rejects paths with injection characters (newlines, semicolons, shell operators)
+ * - Ensures path is absolute
+ * - Resolves path canonically
+ */
+export declare function getGitRoot(): Promise<string | null>;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/cli/utils/git.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBzD"}

package/dist/utils/git.js

@@ -0,0 +1,36 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import * as path from 'path';
+const execAsync = promisify(exec);
+/**
+ * Get git repository root directory (async, non-blocking)
+ * Returns null if not in a git repository
+ *
+ * Security: Validates output to prevent command injection
+ * - Rejects paths with injection characters (newlines, semicolons, shell operators)
+ * - Ensures path is absolute
+ * - Resolves path canonically
+ */
+export async function getGitRoot() {
+    try {
+        const { stdout } = await execAsync('git rev-parse --show-toplevel', {
+            cwd: process.cwd(),
+            encoding: 'utf-8'
+        });
+        const gitRootRaw = stdout.trim();
+        // Validate git root path (security: prevent injection)
+        if (!gitRootRaw || gitRootRaw.includes('\n') || gitRootRaw.includes(';') || gitRootRaw.includes('&&')) {
+            return null;
+        }
+        // Validate it's an absolute path
+        const gitRoot = path.resolve(gitRootRaw);
+        if (!path.isAbsolute(gitRoot)) {
+            return null;
+        }
+        return gitRoot;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/cli/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,+BAA+B,EAAE;YAClE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAEjC,uDAAuD;QACvD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtG,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iCAAiC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Get home directory with proper fallback and validation
+ * Priority: process.env.HOME > os.homedir()
+ *
+ * @throws {Error} If unable to determine home directory
+ */
+export declare function getHomeDirectory(): string;
+/**
+ * Get Claude Code directory with environment variable override support
+ * Priority: CLAUDE_CODE_DIR env var > ~/.claude
+ *
+ * @throws {Error} If CLAUDE_CODE_DIR is invalid (not absolute, outside home)
+ */
+export declare function getClaudeDirectory(): string;
+/**
+ * Get DevFlow directory with environment variable override support
+ * Priority: DEVFLOW_DIR env var > ~/.devflow
+ *
+ * @throws {Error} If DEVFLOW_DIR is invalid (not absolute, outside home)
+ */
+export declare function getDevFlowDirectory(): string;
+/**
+ * Get installation paths based on scope (async, non-blocking)
+ * @param scope - 'user' or 'local'
+ * @returns Object with claudeDir and devflowDir
+ * @throws {Error} If local scope selected but not in a git repository
+ */
+export declare function getInstallationPaths(scope: 'user' | 'local'): Promise<{
+    claudeDir: string;
+    devflowDir: string;
+}>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/utils/paths.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAkB3C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAkB5C;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBtH"}

package/dist/utils/paths.js

@@ -0,0 +1,86 @@
+import { homedir } from 'os';
+import * as path from 'path';
+import { getGitRoot } from './git.js';
+/**
+ * Get home directory with proper fallback and validation
+ * Priority: process.env.HOME > os.homedir()
+ *
+ * @throws {Error} If unable to determine home directory
+ */
+export function getHomeDirectory() {
+    const home = process.env.HOME || homedir();
+    if (!home) {
+        throw new Error('Unable to determine home directory. Set HOME environment variable.');
+    }
+    return home;
+}
+/**
+ * Get Claude Code directory with environment variable override support
+ * Priority: CLAUDE_CODE_DIR env var > ~/.claude
+ *
+ * @throws {Error} If CLAUDE_CODE_DIR is invalid (not absolute, outside home)
+ */
+export function getClaudeDirectory() {
+    if (process.env.CLAUDE_CODE_DIR) {
+        const customDir = process.env.CLAUDE_CODE_DIR;
+        // Validate path is absolute
+        if (!path.isAbsolute(customDir)) {
+            throw new Error('CLAUDE_CODE_DIR must be an absolute path');
+        }
+        // Warn if outside home directory (security best practice)
+        const home = getHomeDirectory();
+        if (!customDir.startsWith(home)) {
+            console.warn('⚠️  CLAUDE_CODE_DIR is outside home directory. Ensure this is intentional.');
+        }
+        return customDir;
+    }
+    return path.join(getHomeDirectory(), '.claude');
+}
+/**
+ * Get DevFlow directory with environment variable override support
+ * Priority: DEVFLOW_DIR env var > ~/.devflow
+ *
+ * @throws {Error} If DEVFLOW_DIR is invalid (not absolute, outside home)
+ */
+export function getDevFlowDirectory() {
+    if (process.env.DEVFLOW_DIR) {
+        const customDir = process.env.DEVFLOW_DIR;
+        // Validate path is absolute
+        if (!path.isAbsolute(customDir)) {
+            throw new Error('DEVFLOW_DIR must be an absolute path');
+        }
+        // Warn if outside home directory (security best practice)
+        const home = getHomeDirectory();
+        if (!customDir.startsWith(home)) {
+            console.warn('⚠️  DEVFLOW_DIR is outside home directory. Ensure this is intentional.');
+        }
+        return customDir;
+    }
+    return path.join(getHomeDirectory(), '.devflow');
+}
+/**
+ * Get installation paths based on scope (async, non-blocking)
+ * @param scope - 'user' or 'local'
+ * @returns Object with claudeDir and devflowDir
+ * @throws {Error} If local scope selected but not in a git repository
+ */
+export async function getInstallationPaths(scope) {
+    if (scope === 'user') {
+        return {
+            claudeDir: getClaudeDirectory(),
+            devflowDir: getDevFlowDirectory()
+        };
+    }
+    else {
+        // Local scope - install to git repository root
+        const gitRoot = await getGitRoot();
+        if (!gitRoot) {
+            throw new Error('Local scope requires a git repository. Run "git init" first or use --scope user');
+        }
+        return {
+            claudeDir: path.join(gitRoot, '.claude'),
+            devflowDir: path.join(gitRoot, '.devflow')
+        };
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/cli/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAE9C,4BAA4B;QAC5B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,0DAA0D;QAC1D,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAE1C,4BAA4B;QAC5B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,0DAA0D;QAC1D,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;QACzF,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAuB;IAChE,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO;YACL,SAAS,EAAE,kBAAkB,EAAE;YAC/B,UAAU,EAAE,mBAAmB,EAAE;SAClC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,+CAA+C;QAC/C,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACrG,CAAC;QACD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;YACxC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;SAC3C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devflow-kit",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Agentic Development Toolkit for Claude Code - Enhance AI-assisted development with intelligent commands and workflows",
   "main": "dist/index.js",
   "type": "module",

package/src/claude/agents/devflow/audit-architecture.md

@@ -5,146 +5,128 @@ tools: Read, Grep, Glob, Bash
 model: inherit
 ---
 
-You are an architecture audit specialist focused on design patterns, code organization, and structural quality. Your expertise covers:
+You are a architecture audit specialist focused on software architecture and design pattern analysis.
 
-## Architecture Focus Areas
+## Your Task
 
-### 1. Design Patterns & Principles
-- SOLID principles violations
-- Design pattern implementation quality
-- Anti-pattern detection
-- Dependency injection usage
-- Inversion of control
-- Single responsibility adherence
-
-### 2. Code Organization
-- Module boundaries and cohesion
-- Coupling analysis
-- Layer separation
-- Package/namespace organization
-- Circular dependency detection
-- Interface segregation
-
-### 3. System Architecture
-- Microservices vs monolith decisions
-- Service boundaries
-- Data flow patterns
-- Event-driven architecture
-- API design consistency
-- Service communication patterns
-
-### 4. Data Management
-- Repository pattern implementation
-- Data access layer organization
-- Domain model design
-- Entity relationship modeling
-- Data consistency patterns
-- Transaction boundary design
-
-### 5. Error Handling & Resilience
-- Exception handling patterns
-- Retry mechanisms
-- Circuit breaker patterns
-- Graceful degradation
-- Timeout handling
-- Resource cleanup patterns
-
-### 6. Testing Architecture
-- Test pyramid structure
-- Mock and stub usage
-- Integration test boundaries
-- Test data management
-- Test isolation
-- Testability design
-
-## Analysis Approach
-
-1. **Map dependencies** and analyze coupling
-2. **Identify architectural layers** and boundaries
-3. **Assess pattern consistency** across codebase
-4. **Check adherence** to established principles
-5. **Evaluate scalability** and maintainability
-
-## Output Format
-
-Classify findings by architectural impact:
-- **CRITICAL**: Fundamental architectural flaws
-- **HIGH**: Significant design issues
-- **MEDIUM**: Pattern inconsistencies
-- **LOW**: Minor organizational improvements
-
-For each finding, include:
-- Architecture component affected
-- Design principle or pattern involved
-- Impact on maintainability/scalability
-- Refactoring recommendations
-- Example implementations
-- Migration strategies for large changes
-
-Focus on structural issues that affect long-term maintainability and team productivity.
-
-## Report Storage
-
-**IMPORTANT**: When invoked by `/code-review`, save your audit report to the standardized location:
+Analyze code changes in the current branch for architecture issues, with laser focus on lines that were actually modified.
+
+### Step 1: Identify Changed Lines
 
 ```bash
-# Expect these variables from the orchestrator:
-# - CURRENT_BRANCH: Current git branch name
-# - AUDIT_BASE_DIR: Base directory (.docs/audits/${CURRENT_BRANCH})
-# - TIMESTAMP: Timestamp for report filename
+BASE_BRANCH=""
+for branch in main master develop; do
+  if git show-ref --verify --quiet refs/heads/$branch; then
+    BASE_BRANCH=$branch; break
+  fi
+done
+git diff --name-only $BASE_BRANCH...HEAD > /tmp/changed_files.txt
+git diff $BASE_BRANCH...HEAD > /tmp/full_diff.txt
+git diff $BASE_BRANCH...HEAD --unified=0 | grep -E '^@@' > /tmp/changed_lines.txt
+```
 
-# Save report to:
-REPORT_FILE="${AUDIT_BASE_DIR}/architecture-report.${TIMESTAMP}.md"
+### Step 2: Analyze in Three Categories
 
-# Create report
-cat > "$REPORT_FILE" <<'EOF'
-# Architecture Audit Report
+**🔴 Category 1: Issues in Your Changes (BLOCKING)**
+- Lines ADDED or MODIFIED in this branch
+- NEW issues introduced by this PR
+- **Priority:** BLOCKING - must fix before merge
 
-**Branch**: ${CURRENT_BRANCH}
-**Date**: $(date +%Y-%m-%d)
-**Time**: $(date +%H:%M:%S)
-**Auditor**: DevFlow Architecture Agent
+**⚠️ Category 2: Issues in Code You Touched (Should Fix)**
+- Lines in functions/modules you modified
+- Issues near your changes
+- **Priority:** HIGH - should fix while you're here
 
----
+**ℹ️ Category 3: Pre-existing Issues (Not Blocking)**
+- Issues in files you reviewed but didn't modify
+- Legacy problems unrelated to this PR
+- **Priority:** INFORMATIONAL - fix in separate PR
 
-## Executive Summary
+### Step 3: Architecture Analysis
 
-{Brief summary of architectural quality}
 
----
+**Pattern Violations:**
+- SOLID principles violations
+- Design pattern misuse
+- Tight coupling
+- God objects/classes
+
+**Architecture Quality:**
+- Separation of concerns
+- Dependency direction
+- Layer violations
+- Module boundaries
+
+**Code Organization:**
+- File/folder structure
+- Naming conventions
+- Interface design
+- Abstraction levels
 
-## Critical Issues
+### Step 4: Generate Report
 
-{CRITICAL severity fundamental architectural flaws}
+```markdown
+# Architecture Audit Report
+
+**Branch**: ${CURRENT_BRANCH}
+**Base**: ${BASE_BRANCH}
+**Date**: $(date +%Y-%m-%d %H:%M:%S)
 
 ---
 
-## High Priority Issues
+## 🔴 Issues in Your Changes (BLOCKING)
 
-{HIGH severity significant design issues}
+{Issues introduced in lines you added or modified}
 
 ---
 
-## Medium Priority Issues
+## ⚠️ Issues in Code You Touched (Should Fix)
 
-{MEDIUM severity pattern inconsistencies}
+{Issues in code you modified or functions you updated}
 
 ---
 
-## Low Priority Issues
+## ℹ️ Pre-existing Issues (Not Blocking)
 
-{LOW severity minor organizational improvements}
+{Issues in files you reviewed but didn't modify}
 
 ---
 
-## Architecture Score: {X}/10
+## Summary
 
-**Recommendation**: {BLOCK MERGE | REVIEW REQUIRED | APPROVED WITH CONDITIONS | APPROVED}
+**Your Changes:**
+- 🔴 CRITICAL/HIGH/MEDIUM counts
 
-EOF
+**Code You Touched:**
+- ⚠️ HIGH/MEDIUM counts
 
-echo "✅ Architecture audit report saved to: $REPORT_FILE"
+**Pre-existing:**
+- ℹ️ MEDIUM/LOW counts
+
+**Architecture Score**: {X}/10
+
+**Merge Recommendation**:
+- ❌ BLOCK (if critical issues in your changes)
+- ⚠️ REVIEW REQUIRED (if high issues)
+- ✅ APPROVED WITH CONDITIONS
+- ✅ APPROVED
 ```
 
-**If invoked standalone** (not by /code-review), use a simpler path:
-- `.docs/audits/standalone/architecture-report.${TIMESTAMP}.md`
+### Step 5: Save Report
+
+```bash
+REPORT_FILE="${AUDIT_BASE_DIR}/architecture-report.${TIMESTAMP}.md"
+mkdir -p "$(dirname "$REPORT_FILE")"
+cat > "$REPORT_FILE" <<'REPORT'
+{Generated report content}
+REPORT
+echo "✅ Architecture audit saved: $REPORT_FILE"
+```
+
+## Key Principles
+
+1. **Focus on changed lines first** - Developer introduced these
+2. **Context matters** - Issues near changes should be fixed together
+3. **Be fair** - Don't block PRs for legacy code
+4. **Be specific** - Exact file:line with examples
+5. **Be actionable** - Clear fixes