pumuki-ast-hooks 5.3.1

package/bin/audit-library.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/audit-library.js');

package/bin/auto-fix-violations.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const implPath = path.join(__dirname, '..', 'scripts', 'hooks-system', 'bin', 'auto-fix-violations.js');
+
+if (require.main === module) {
+    const res = spawnSync(process.execPath, [implPath, ...process.argv.slice(2)], {
+        stdio: 'inherit',
+        env: process.env
+    });
+    process.exit(res.status ?? 1);
+}
+
+module.exports = require(implPath);

package/bin/auto-restart-guards.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/auto-restart-guards.js');

package/bin/check-doc-drift.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/check-doc-drift.js');

package/bin/check-version.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const implPath = path.join(__dirname, '..', 'scripts', 'hooks-system', 'bin', 'check-version.js');
+
+if (require.main === module) {
+    const res = spawnSync(process.execPath, [implPath], {
+        stdio: 'inherit',
+        env: process.env
+    });
+    process.exit(res.status ?? 1);
+}
+
+module.exports = require(implPath);

package/bin/cleanup-branches.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/cleanup-branches.sh" "$@"

package/bin/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/cli.js');

package/bin/demo-recording.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/demo-recording.sh" "$@"

package/bin/demo-violations

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/demo-violations" "$@"

package/bin/fix-enforcer

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/fix-enforcer" "$@"

package/bin/fix-gitflow-enforcement.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/fix-gitflow-enforcement.sh" "$@"

package/bin/generate-progress-report.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/generate-progress-report.sh" "$@"

package/bin/git-analyze-pairs.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/git-analyze-pairs.sh" "$@"

package/bin/git-leave-branch-check.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/git-leave-branch-check.sh" "$@"

package/bin/gitflow

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/gitflow" "$@"

package/bin/gitflow-shell-integration.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/gitflow-shell-integration.sh" "$@"

package/bin/guard-auto-manager.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/guard-auto-manager.js');

package/bin/guard-autostart.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/guard-autostart.sh" "$@"

package/bin/guard-env.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/guard-env.sh" "$@"

package/bin/guard-supervisor.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/guard-supervisor.js');

package/bin/hook-status.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/hook-status.js');

package/bin/install-git-wrapper.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/install-git-wrapper.sh" "$@"

package/bin/install.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/install.js');

package/bin/kill-mcp-zombies.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/kill-mcp-zombies.sh" "$@"

package/bin/nightly-metrics-report.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+const impl = require('../scripts/hooks-system/bin/nightly-metrics-report.js');
+
+if (require.main === module) {
+    impl.run();
+}
+
+module.exports = impl;

package/bin/plan-review.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/plan-review.js');

package/bin/predictive-hooks.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/predictive-hooks.js');

package/bin/pumuki-audit.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/pumuki-audit.js');

package/bin/pumuki-init.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const implPath = path.join(__dirname, '..', 'scripts', 'hooks-system', 'bin', 'pumuki-init.js');
+
+if (require.main === module) {
+    const res = spawnSync(process.execPath, [implPath], {
+        stdio: 'inherit',
+        env: process.env
+    });
+    process.exit(res.status ?? 1);
+}
+
+module.exports = require(implPath);

package/bin/pumuki-mcp-server.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+if (!process.env.REPO_ROOT) {
+    process.env.REPO_ROOT = process.cwd();
+}
+
+if (!process.env.MCP_SERVER_NAME) {
+    const path = require('path');
+    const folderName = path.basename(process.env.REPO_ROOT).toLowerCase();
+    process.env.MCP_SERVER_NAME = `ast-intelligence-automation-${folderName}`;
+}
+
+require('../scripts/hooks-system/infrastructure/mcp/ast-intelligence-automation.js');

package/bin/pumuki-mcp.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/pumuki-mcp.js');

package/bin/pumuki-rules.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/pumuki-rules.js');

package/bin/request-no-verify-approval.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/request-no-verify-approval.sh" "$@"

package/bin/run-ast-adapter.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/run-ast-adapter.js');

package/bin/run-intelligent-audit.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/run-intelligent-audit.sh" "$@"

package/bin/run-orchestrator.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/run-orchestrator.js');

package/bin/run-playbook.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/run-playbook.js');

package/bin/session-loader.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/session-loader.sh" "$@"

package/bin/setup-eslint.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/setup-eslint.js');

package/bin/start-guards.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/start-guards.sh" "$@"

package/bin/sync-autonomous-orchestrator.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/sync-autonomous-orchestrator.sh" "$@"

package/bin/sync-to-library.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/sync-to-library.sh" "$@"

package/bin/update-evidence.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/update-evidence.sh" "$@"

package/bin/update-session-context.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/update-session-context.sh" "$@"

package/bin/verify-no-verify.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/verify-no-verify.sh" "$@"

package/bin/violations

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Script Wrapper
+# Redirects to the centralized implementation in scripts/hooks-system
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+bash "$REPO_ROOT/scripts/hooks-system/bin/violations" "$@"

package/bin/violations-api.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/violations-api.js');

package/bin/watch-hooks.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Script Wrapper
+ * Redirects to the centralized implementation in scripts/hooks-system
+ */
+require('../scripts/hooks-system/bin/watch-hooks.js');

package/docs/API_REFERENCE.md

@@ -0,0 +1,161 @@
+# Hook System API Documentation
+
+## Overview
+
+The Hook System provides automated quality gates and intelligent AST analysis for multi-platform projects. It ensures code quality, security, and architectural compliance through pre-commit hooks and CI/CD integration.
+
+## Core Services
+
+### GitOperations
+
+Centralized Git operations for the hook system.
+
+#### Methods
+
+- `getStagedFiles()`: Returns array of staged file paths
+- `getWorkingDirectoryFiles()`: Returns array of modified files in working directory
+- `getAllChangedFiles()`: Returns all changed files (staged + working directory)
+- `isInGitRepository()`: Boolean check for Git repository
+- `getRepositoryRoot()`: Returns absolute path to repository root
+
+**Location**: `infrastructure/core/GitOperations.js`
+
+### SeverityConfig
+
+Centralized severity mapping and utilities.
+
+#### Constants
+
+- `SEVERITY_LEVELS`: Numeric severity rankings (CRITICAL: 4, HIGH: 3, etc.)
+- `SEVERITY_MAP`: String mappings for different severity formats
+- `SEVERITY_ICONS`: Emoji icons for each severity level
+- `SEVERITY_LABELS`: Human-readable labels
+
+#### Methods
+
+- `getSeverityValue(severity)`: Normalizes severity string
+- `getSeverityIcon(severity)`: Returns emoji icon
+- `getSeverityLabel(severity)`: Returns human-readable label
+- `isBlocking(severity)`: Checks if severity blocks commits
+- `filterBySeverity(violations, severity)`: Filters violations by severity
+- `sortBySeverity(violations)`: Sorts violations by severity (highest first)
+
+**Location**: `domain/entities/SeverityConfig.js`
+
+## Entry Points
+
+### Command Line Scripts
+
+Located in `bin/` directory:
+
+- `run-ast-adapter.js`: AST analysis adapter for pre-commit hooks
+- `violations-api.js`: Query interface for violations data
+- `update-evidence.sh`: Updates .AI_EVIDENCE.json with metrics
+- `ai-commit.sh`: Intelligent commit wrapper
+- `pumuki-audit.js`: Global audit runner
+
+### Orchestrators
+
+Located in `infrastructure/shell/orchestrators/`:
+
+- `audit-orchestrator.sh`: Main audit menu and pre-commit integration
+- `intelligent-audit.js`: Severity intelligence evaluator
+
+### Guards
+
+Located in `infrastructure/guards/`:
+
+- `master-validator.sh`: Primary pre-commit validation gate
+
+## Configuration
+
+### Files
+
+- `config/detect-secrets-baseline.json`: Secret detection baseline
+- `config/rules.json`: AST rule definitions
+- `config/paths.conf`: Path configurations
+
+### Environment Variables
+
+- `ENABLE_INTELLIGENT_SEVERITY`: Enable/disable intelligent severity evaluation
+- `PRE_COMMIT`: Set to 'true' during pre-commit hooks
+
+## Architecture
+
+```
+node_modules/@pumuki/ast-intelligence-hooks/
+├── application/          # Business logic (Use Cases, Services)
+├── domain/               # Core entities (SeverityConfig, etc.)
+├── infrastructure/       # Technical implementations
+│   ├── ast/              # AST analysis engines
+│   ├── core/             # Core utilities (GitOperations)
+│   ├── guards/           # Validation gates
+│   ├── reporting/        # Report generation
+│   └── shell/            # Shell scripts
+├── bin/                  # CLI entry points
+├── config/               # Configuration files
+├── hooks/                # Git hook templates
+└── presentation/         # CLI interface
+```
+
+## Usage Examples
+
+### Basic AST Analysis
+
+```bash
+# Run AST analysis on staged files
+npm run audit
+
+# Or using CLI directly
+npx ast-hooks analyze
+
+# Query violations by severity
+npm run violations:list
+
+# Or using CLI
+npx ast-violations list
+```
+
+### Pre-commit Integration
+
+The system automatically runs during `git commit` via pre-commit hooks installed with `npm run install-hooks`.
+
+### Manual Audit
+
+```bash
+# Run full audit
+npm run audit
+
+# With intelligent severity
+ENABLE_INTELLIGENT_SEVERITY=true npm run audit
+
+# Using CLI
+npx ast-hooks analyze
+```
+
+## Testing
+
+Run integration tests:
+
+```bash
+npm test -- scripts/hooks-system/__tests__/integration.test.js
+```
+
+## Development
+
+### Adding New Rules
+
+1. Add rule definition to `config/rules.json`
+2. Implement rule logic in appropriate AST analyzer
+3. Update SeverityConfig if new severity levels needed
+4. Add tests in `__tests__/` directory
+
+### Extending Git Operations
+
+1. Add new methods to `GitOperations` class
+2. Update integration tests
+3. Document in this API reference
+
+---
+
+## 🐈💚 Pumuki Team® - Hook System API Reference