specweave 0.16.7 → 0.16.11

package/dist/src/utils/execFileNoThrow.js

@@ -0,0 +1,137 @@
+import { execFile, execFileSync } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+/**
+ * Safely execute a command without throwing errors
+ *
+ * This utility uses child_process.execFile instead of exec/execSync:
+ * - ✅ Prevents command injection vulnerabilities (no shell interpolation)
+ * - ✅ Cross-platform compatible (Windows, Mac, Linux)
+ * - ✅ Proper error handling (returns result instead of throwing)
+ * - ✅ Structured output (stdout, stderr, exitCode)
+ *
+ * @param command - Command to execute (must be in PATH or absolute path)
+ * @param args - Array of arguments (safely escaped automatically)
+ * @param options - Additional execution options
+ * @returns Promise resolving to execution result
+ *
+ * @example
+ * ```typescript
+ * // ✅ Safe: Arguments automatically escaped
+ * const result = await execFileNoThrow('git', ['add', userProvidedFilename]);
+ * if (result.success) {
+ *   console.log('Git add succeeded:', result.stdout);
+ * } else {
+ *   console.error('Git add failed:', result.stderr);
+ * }
+ *
+ * // ✅ Check if command exists
+ * const which = process.platform === 'win32' ? 'where' : 'which';
+ * const checkResult = await execFileNoThrow(which, ['claude']);
+ * if (checkResult.success) {
+ *   console.log('Claude CLI found at:', checkResult.stdout.trim());
+ * }
+ * ```
+ */
+export async function execFileNoThrow(command, args = [], options = {}) {
+    try {
+        // CRITICAL: On Windows, shell is needed for .cmd/.bat files
+        // Without shell, execFileAsync can't find 'claude.cmd' even if it's in PATH
+        const needsShell = process.platform === 'win32' && options.shell !== false;
+        const { stdout, stderr } = await execFileAsync(command, args, {
+            ...options,
+            encoding: 'utf-8',
+            windowsHide: true, // Don't show console window on Windows
+            shell: needsShell,
+        });
+        return {
+            stdout: stdout || '',
+            stderr: stderr || '',
+            exitCode: 0,
+            success: true,
+        };
+    }
+    catch (error) {
+        const execError = error;
+        return {
+            stdout: execError.stdout || '',
+            stderr: execError.stderr || '',
+            exitCode: typeof execError.code === 'number' ? execError.code : 1,
+            success: false,
+            error: execError,
+        };
+    }
+}
+/**
+ * Synchronous version of execFileNoThrow
+ *
+ * Use sparingly - prefer async version when possible.
+ * Useful for initialization code that needs to be synchronous.
+ *
+ * @example
+ * ```typescript
+ * const result = execFileNoThrowSync('claude', ['--version']);
+ * if (result.success) {
+ *   console.log('Claude version:', result.stdout.trim());
+ * }
+ * ```
+ */
+export function execFileNoThrowSync(command, args = [], options = {}) {
+    try {
+        // CRITICAL: On Windows, shell is needed for .cmd/.bat files
+        // Without shell, execFileSync can't find 'claude.cmd' even if it's in PATH
+        const needsShell = process.platform === 'win32' && options.shell !== false;
+        const stdout = execFileSync(command, args, {
+            ...options,
+            encoding: 'utf-8',
+            windowsHide: true,
+            shell: needsShell,
+        });
+        return {
+            stdout: stdout || '',
+            stderr: '',
+            exitCode: 0,
+            success: true,
+        };
+    }
+    catch (error) {
+        return {
+            stdout: error.stdout || '',
+            stderr: error.stderr || '',
+            exitCode: typeof error.status === 'number' ? error.status : 1,
+            success: false,
+            error: error,
+        };
+    }
+}
+/**
+ * Check if a command is available in PATH
+ *
+ * Cross-platform helper that uses 'which' (Unix) or 'where' (Windows)
+ *
+ * @param command - Command name to check (e.g., 'claude', 'git', 'node')
+ * @returns Promise resolving to true if command exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isCommandAvailable('claude')) {
+ *   console.log('Claude CLI is installed');
+ * } else {
+ *   console.log('Claude CLI not found - install from https://claude.com/code');
+ * }
+ * ```
+ */
+export async function isCommandAvailable(command) {
+    const whichCommand = process.platform === 'win32' ? 'where' : 'which';
+    const result = await execFileNoThrow(whichCommand, [command]);
+    return result.success;
+}
+/**
+ * Synchronous version of isCommandAvailable
+ */
+export function isCommandAvailableSync(command) {
+    const whichCommand = process.platform === 'win32' ? 'where' : 'which';
+    const result = execFileNoThrowSync(whichCommand, [command]);
+    return result.success;
+}
+//# sourceMappingURL=execFileNoThrow.js.map

package/dist/src/utils/execFileNoThrow.js.map

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

package/dist/src/utils/external-resource-validator.d.ts

@@ -0,0 +1,194 @@
+/**
+ * External Resource Validator
+ *
+ * Validates and creates external resources (Jira projects, boards, etc.)
+ * Smart enough to:
+ * - Check if resources exist
+ * - Prompt user to select existing or create new
+ * - Create missing resources automatically
+ * - Update .env with actual IDs after creation
+ *
+ * @module utils/external-resource-validator
+ * @since 0.9.5
+ */
+export interface JiraProject {
+    id: string;
+    key: string;
+    name: string;
+}
+export interface JiraBoard {
+    id: number;
+    name: string;
+    type: string;
+}
+export interface JiraValidationResult {
+    valid: boolean;
+    project: {
+        exists: boolean;
+        key?: string;
+        id?: string;
+        name?: string;
+    };
+    boards: {
+        valid: boolean;
+        existing: number[];
+        missing: string[];
+        created: Array<{
+            name: string;
+            id: number;
+        }>;
+    };
+    envUpdated: boolean;
+}
+export declare class JiraResourceValidator {
+    private apiToken;
+    private email;
+    private domain;
+    private envPath;
+    constructor(envPath?: string);
+    /**
+     * Load .env file
+     */
+    private loadEnv;
+    /**
+     * Update .env file with new values
+     */
+    private updateEnv;
+    /**
+     * Call Jira API
+     */
+    private callJiraApi;
+    /**
+     * Fetch all Jira projects
+     */
+    fetchProjects(): Promise<JiraProject[]>;
+    /**
+     * Check if project exists
+     */
+    checkProject(projectKey: string): Promise<JiraProject | null>;
+    /**
+     * Create new Jira project
+     */
+    createProject(projectKey: string, projectName: string): Promise<JiraProject>;
+    /**
+     * Get current user ID (for project lead)
+     */
+    private getCurrentUserId;
+    /**
+     * Fetch all boards for a project
+     */
+    fetchBoards(projectKey: string): Promise<JiraBoard[]>;
+    /**
+     * Check if board exists by ID
+     */
+    checkBoard(boardId: number): Promise<JiraBoard | null>;
+    /**
+     * Create new Jira board
+     */
+    createBoard(boardName: string, projectKey: string): Promise<JiraBoard>;
+    /**
+     * Get or create filter for board
+     */
+    private getOrCreateFilter;
+    /**
+     * Validate and fix Jira configuration
+     */
+    validate(): Promise<JiraValidationResult>;
+}
+export interface AzureDevOpsProject {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface AzureDevOpsTeam {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface AzureDevOpsAreaPath {
+    id: number;
+    name: string;
+    path: string;
+}
+export interface AzureDevOpsValidationResult {
+    valid: boolean;
+    strategy: 'project-per-team' | 'area-path-based' | 'team-based';
+    projects: Array<{
+        name: string;
+        id?: string;
+        exists: boolean;
+        created: boolean;
+    }>;
+    areaPaths?: Array<{
+        name: string;
+        id?: number;
+        exists: boolean;
+        created: boolean;
+    }>;
+    teams?: Array<{
+        name: string;
+        id?: string;
+        exists: boolean;
+        created: boolean;
+    }>;
+    envUpdated: boolean;
+}
+export declare class AzureDevOpsResourceValidator {
+    private pat;
+    private organization;
+    private envPath;
+    constructor(envPath?: string);
+    /**
+     * Load .env file
+     */
+    private loadEnv;
+    /**
+     * Update .env file with new values
+     */
+    private updateEnv;
+    /**
+     * Call Azure DevOps API
+     */
+    private callAzureDevOpsApi;
+    /**
+     * Fetch all Azure DevOps projects
+     */
+    fetchProjects(): Promise<AzureDevOpsProject[]>;
+    /**
+     * Check if project exists
+     */
+    checkProject(projectName: string): Promise<AzureDevOpsProject | null>;
+    /**
+     * Create new Azure DevOps project
+     */
+    createProject(projectName: string, description?: string): Promise<AzureDevOpsProject>;
+    /**
+     * Wait for project creation to complete
+     */
+    private waitForProjectCreation;
+    /**
+     * Create area path in project
+     */
+    createAreaPath(projectName: string, areaName: string): Promise<AzureDevOpsAreaPath>;
+    /**
+     * Fetch teams in project
+     */
+    fetchTeams(projectName: string): Promise<AzureDevOpsTeam[]>;
+    /**
+     * Create team in project
+     */
+    createTeam(projectName: string, teamName: string): Promise<AzureDevOpsTeam>;
+    /**
+     * Validate and fix Azure DevOps configuration
+     */
+    validate(): Promise<AzureDevOpsValidationResult>;
+}
+/**
+ * Validate Jira resources
+ */
+export declare function validateJiraResources(envPath?: string): Promise<JiraValidationResult>;
+/**
+ * Validate Azure DevOps resources
+ */
+export declare function validateAzureDevOpsResources(envPath?: string): Promise<AzureDevOpsValidationResult>;
+//# sourceMappingURL=external-resource-validator.d.ts.map

package/dist/src/utils/external-resource-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-resource-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/external-resource-validator.ts"],"names":[],"mappings":"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"}