@liangjie559567/ultrapower 5.0.4

package/dist/hooks/plugin-patterns/index.js

@@ -0,0 +1,314 @@
+/**
+ * Popular Plugin Patterns
+ *
+ * Common hook patterns from the Claude Code community:
+ * - Auto-format on file save
+ * - Lint validation before commit
+ * - Commit message validation
+ * - Test runner before commit
+ * - Type checking enforcement
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join, extname, normalize, isAbsolute } from 'path';
+import { execSync } from 'child_process';
+// =============================================================================
+// SECURITY UTILITIES
+// =============================================================================
+/**
+ * Validate file path for security
+ * Blocks shell metacharacters and path traversal attempts
+ */
+export function isValidFilePath(filePath) {
+    // Block shell metacharacters (sync with DANGEROUS_SHELL_CHARS but add \t)
+    if (/[;&|`$()<>{}[\]*?~!#\n\r\t\0\\]/.test(filePath))
+        return false;
+    // Block path traversal
+    const normalized = normalize(filePath);
+    if (normalized.includes('..') || isAbsolute(normalized))
+        return false;
+    return true;
+}
+const DEFAULT_FORMATTERS = {
+    '.ts': 'prettier --write',
+    '.tsx': 'prettier --write',
+    '.js': 'prettier --write',
+    '.jsx': 'prettier --write',
+    '.json': 'prettier --write',
+    '.css': 'prettier --write',
+    '.scss': 'prettier --write',
+    '.md': 'prettier --write',
+    '.py': 'black',
+    '.go': 'gofmt -w',
+    '.rs': 'rustfmt'
+};
+/**
+ * Get formatter command for a file extension
+ */
+export function getFormatter(ext) {
+    return DEFAULT_FORMATTERS[ext] || null;
+}
+/**
+ * Check if a formatter is available
+ */
+export function isFormatterAvailable(command) {
+    try {
+        const binary = command.split(' ')[0];
+        const checkCommand = process.platform === 'win32' ? 'where' : 'which';
+        execSync(`${checkCommand} ${binary}`, { encoding: 'utf-8', stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Format a file using the appropriate formatter
+ */
+export function formatFile(filePath) {
+    // Validate file path for security
+    if (!isValidFilePath(filePath)) {
+        return { success: false, message: 'Invalid file path: contains unsafe characters or path traversal' };
+    }
+    const ext = extname(filePath);
+    const formatter = getFormatter(ext);
+    if (!formatter) {
+        return { success: true, message: `No formatter configured for ${ext}` };
+    }
+    if (!isFormatterAvailable(formatter)) {
+        return { success: true, message: `Formatter ${formatter} not available` };
+    }
+    try {
+        execSync(`${formatter} "${filePath}"`, { encoding: 'utf-8', stdio: 'pipe' });
+        return { success: true, message: `Formatted ${filePath}` };
+    }
+    catch (_error) {
+        return { success: false, message: `Format failed: ${_error}` };
+    }
+}
+const DEFAULT_LINTERS = {
+    '.ts': 'eslint --fix',
+    '.tsx': 'eslint --fix',
+    '.js': 'eslint --fix',
+    '.jsx': 'eslint --fix',
+    '.py': 'ruff check --fix',
+    '.go': 'golangci-lint run',
+    '.rs': 'cargo clippy'
+};
+/**
+ * Get linter command for a file extension
+ */
+export function getLinter(ext) {
+    return DEFAULT_LINTERS[ext] || null;
+}
+/**
+ * Run linter on a file
+ */
+export function lintFile(filePath) {
+    // Validate file path for security
+    if (!isValidFilePath(filePath)) {
+        return { success: false, message: 'Invalid file path: contains unsafe characters or path traversal' };
+    }
+    const ext = extname(filePath);
+    const linter = getLinter(ext);
+    if (!linter) {
+        return { success: true, message: `No linter configured for ${ext}` };
+    }
+    try {
+        const binary = linter.split(' ')[0];
+        const checkCommand = process.platform === 'win32' ? 'where' : 'which';
+        execSync(`${checkCommand} ${binary}`, { encoding: 'utf-8', stdio: 'pipe' });
+    }
+    catch {
+        return { success: true, message: `Linter ${linter} not available` };
+    }
+    try {
+        execSync(`${linter} "${filePath}"`, { encoding: 'utf-8', stdio: 'pipe' });
+        return { success: true, message: `Lint passed for ${filePath}` };
+    }
+    catch (_error) {
+        return { success: false, message: `Lint errors in ${filePath}` };
+    }
+}
+const DEFAULT_COMMIT_TYPES = [
+    'feat', // New feature
+    'fix', // Bug fix
+    'docs', // Documentation
+    'style', // Formatting, no code change
+    'refactor', // Refactoring
+    'perf', // Performance improvement
+    'test', // Adding tests
+    'build', // Build system changes
+    'ci', // CI configuration
+    'chore', // Maintenance
+    'revert' // Revert previous commit
+];
+const CONVENTIONAL_COMMIT_REGEX = /^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([a-z0-9-]+\))?(!)?:\s.+$/;
+/**
+ * Validate a commit message against conventional commit format
+ */
+export function validateCommitMessage(message, config) {
+    const errors = [];
+    const lines = message.trim().split('\n');
+    const subject = lines[0];
+    // Check subject line
+    if (!subject) {
+        errors.push('Commit message cannot be empty');
+        return { valid: false, errors };
+    }
+    // Check conventional commit format
+    if (!CONVENTIONAL_COMMIT_REGEX.test(subject)) {
+        errors.push('Subject must follow conventional commit format: type(scope?): description');
+        errors.push(`Allowed types: ${DEFAULT_COMMIT_TYPES.join(', ')}`);
+    }
+    // Check subject length
+    const maxLength = config?.maxSubjectLength || 72;
+    if (subject.length > maxLength) {
+        errors.push(`Subject line exceeds ${maxLength} characters`);
+    }
+    // Check for scope if required
+    if (config?.requireScope) {
+        const hasScope = /\([a-z0-9-]+\)/.test(subject);
+        if (!hasScope) {
+            errors.push('Scope is required in commit message');
+        }
+    }
+    // Check for body if required
+    if (config?.requireBody) {
+        if (lines.length < 3 || !lines[2]) {
+            errors.push('Commit body is required');
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+// =============================================================================
+// TYPE CHECKING PATTERN
+// =============================================================================
+/**
+ * Run TypeScript type checking
+ */
+export function runTypeCheck(directory) {
+    const tsconfigPath = join(directory, 'tsconfig.json');
+    if (!existsSync(tsconfigPath)) {
+        return { success: true, message: 'No tsconfig.json found' };
+    }
+    try {
+        const checkCommand = process.platform === 'win32' ? 'where' : 'which';
+        execSync(`${checkCommand} tsc`, { encoding: 'utf-8', stdio: 'pipe' });
+    }
+    catch {
+        return { success: true, message: 'TypeScript not installed' };
+    }
+    try {
+        execSync('tsc --noEmit', { cwd: directory, encoding: 'utf-8', stdio: 'pipe' });
+        return { success: true, message: 'Type check passed' };
+    }
+    catch (_error) {
+        return { success: false, message: 'Type errors found' };
+    }
+}
+// =============================================================================
+// TEST RUNNER PATTERN
+// =============================================================================
+/**
+ * Detect and run tests for a project
+ */
+export function runTests(directory) {
+    const packageJsonPath = join(directory, 'package.json');
+    if (existsSync(packageJsonPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            if (pkg.scripts?.test) {
+                execSync('npm test', { cwd: directory, encoding: 'utf-8', stdio: 'pipe' });
+                return { success: true, message: 'Tests passed' };
+            }
+        }
+        catch (_error) {
+            return { success: false, message: 'Tests failed' };
+        }
+    }
+    // Check for pytest
+    if (existsSync(join(directory, 'pytest.ini')) || existsSync(join(directory, 'pyproject.toml'))) {
+        try {
+            execSync('pytest', { cwd: directory, encoding: 'utf-8', stdio: 'pipe' });
+            return { success: true, message: 'Tests passed' };
+        }
+        catch (_error) {
+            return { success: false, message: 'Tests failed' };
+        }
+    }
+    return { success: true, message: 'No test runner found' };
+}
+/**
+ * Run all pre-commit checks
+ */
+export function runPreCommitChecks(directory, commitMessage) {
+    const checks = [];
+    // Type checking
+    const typeCheck = runTypeCheck(directory);
+    checks.push({
+        name: 'Type Check',
+        passed: typeCheck.success,
+        message: typeCheck.message
+    });
+    // Commit message validation
+    if (commitMessage) {
+        const commitCheck = validateCommitMessage(commitMessage);
+        checks.push({
+            name: 'Commit Message',
+            passed: commitCheck.valid,
+            message: commitCheck.valid ? 'Valid format' : commitCheck.errors.join('; ')
+        });
+    }
+    // All checks must pass
+    const canCommit = checks.every(c => c.passed);
+    return { canCommit, checks };
+}
+// =============================================================================
+// HOOK MESSAGE GENERATORS
+// =============================================================================
+/**
+ * Generate pre-commit check reminder message
+ */
+export function getPreCommitReminderMessage(result) {
+    if (result.canCommit) {
+        return '';
+    }
+    const failedChecks = result.checks.filter(c => !c.passed);
+    return `<pre-commit-validation>
+
+[PRE-COMMIT CHECKS FAILED]
+
+The following checks did not pass:
+${failedChecks.map(c => `- ${c.name}: ${c.message}`).join('\n')}
+
+Please fix these issues before committing.
+
+</pre-commit-validation>
+
+---
+
+`;
+}
+/**
+ * Generate auto-format reminder message
+ */
+export function getAutoFormatMessage(filePath, result) {
+    if (result.success) {
+        return '';
+    }
+    return `<auto-format>
+
+[FORMAT WARNING]
+
+File ${filePath} could not be auto-formatted:
+${result.message}
+
+Please check the file manually.
+
+</auto-format>
+
+---
+
+`;
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/plugin-patterns/index.js.map

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

package/dist/hooks/pre-compact/index.d.ts

@@ -0,0 +1,129 @@
+/**
+ * PreCompact Hook - State Preservation Before Context Compaction
+ *
+ * Creates checkpoints before compaction to preserve critical state including:
+ * - Active mode states (autopilot, ralph, ultrawork, swarm)
+ * - TODO summary
+ * - Wisdom from notepads
+ *
+ * This ensures no critical information is lost during context window compaction.
+ */
+export interface PreCompactInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode: string;
+    hook_event_name: "PreCompact";
+    trigger: "manual" | "auto";
+    custom_instructions?: string;
+}
+export interface CompactCheckpoint {
+    created_at: string;
+    trigger: "manual" | "auto";
+    active_modes: {
+        autopilot?: {
+            phase: string;
+            originalIdea: string;
+        };
+        ralph?: {
+            iteration: number;
+            prompt: string;
+        };
+        ultrawork?: {
+            original_prompt: string;
+        };
+        swarm?: {
+            session_id: string;
+            task_count: number;
+        };
+        ultrapilot?: {
+            session_id: string;
+            worker_count: number;
+        };
+        pipeline?: {
+            preset: string;
+            current_stage: number;
+        };
+        ultraqa?: {
+            cycle: number;
+            prompt: string;
+        };
+    };
+    todo_summary: {
+        pending: number;
+        in_progress: number;
+        completed: number;
+    };
+    wisdom_exported: boolean;
+    background_jobs?: {
+        active: Array<{
+            jobId: string;
+            provider: string;
+            model: string;
+            agentRole: string;
+            spawnedAt: string;
+        }>;
+        recent: Array<{
+            jobId: string;
+            provider: string;
+            status: string;
+            agentRole: string;
+            completedAt?: string;
+        }>;
+        stats: {
+            total: number;
+            active: number;
+            completed: number;
+            failed: number;
+        } | null;
+    };
+}
+export interface HookOutput {
+    continue: boolean;
+    /** System message for context injection (Claude Code compatible) */
+    systemMessage?: string;
+}
+/**
+ * Get the checkpoint directory path
+ */
+export declare function getCheckpointPath(directory: string): string;
+/**
+ * Export wisdom from notepads to checkpoint
+ */
+export declare function exportWisdomToNotepad(directory: string): Promise<{
+    wisdom: string;
+    exported: boolean;
+}>;
+/**
+ * Save summary of active modes
+ */
+export declare function saveModeSummary(directory: string): Promise<Record<string, unknown>>;
+/**
+ * Create a compact checkpoint
+ */
+export declare function createCompactCheckpoint(directory: string, trigger: "manual" | "auto"): Promise<CompactCheckpoint>;
+/**
+ * Format checkpoint summary for context injection
+ */
+export declare function formatCompactSummary(checkpoint: CompactCheckpoint): string;
+/**
+ * Main handler for PreCompact hook.
+ *
+ * Uses a per-directory mutex to prevent concurrent compaction.
+ * When multiple subagent results arrive simultaneously (swarm/ultrawork),
+ * only the first call runs the compaction; subsequent calls await
+ * the in-flight result. This fixes issue #453.
+ */
+export declare function processPreCompact(input: PreCompactInput): Promise<HookOutput>;
+/**
+ * Check if compaction is currently in progress for a directory.
+ * Useful for diagnostics and testing.
+ */
+export declare function isCompactionInProgress(directory: string): boolean;
+/**
+ * Get the number of callers queued behind an in-flight compaction.
+ * Returns 0 if no compaction is in progress.
+ */
+export declare function getCompactionQueueDepth(directory: string): number;
+export default processPreCompact;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/pre-compact/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/pre-compact/index.ts"],"names":[],"mappings":"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"}