pumuki-ast-hooks 6.1.6 → 6.1.8

package/README.md

@@ -16,9 +16,10 @@ Portable, project‑agnostic, multi‑platform enterprise framework to govern AI
 ## Quick Start (30–60s)
 
 ```bash
+git init
 npm install --save-dev pumuki-ast-hooks
-npm run install-hooks
-npx ast-hooks
+npx ast-install
+npx ast-hooks audit
 ```
 
 Default installation mode is `npm-runtime`.
@@ -26,7 +27,7 @@ Default installation mode is `npm-runtime`.
 To opt into an embedded runtime copy (`vendored` mode):
 
 ```bash
-HOOK_INSTALL_MODE=vendored npm run install-hooks
+HOOK_INSTALL_MODE=vendored npx ast-install
 ```
 
 ---

package/docs/INSTALLATION.md

@@ -84,11 +84,11 @@ The installer will detect if Git is missing and show a clear warning:
 ### Option 1: Local Installation (Recommended)
 
 ```bash
-# Install as development dependency
+# Install as dev dependency
 npm install --save-dev pumuki-ast-hooks
 
 # Configure hooks
-npm run install-hooks
+npx ast-install
 ```
 
 By default, the installer uses npm-runtime mode (no embedded copy of `scripts/hooks-system` into your project). To use the vendored mode (embedded runtime), run the installer with `HOOK_INSTALL_MODE=vendored`.

package/docs/USAGE.md

@@ -17,8 +17,9 @@
 ### Step 1: Install
 
 ```bash
+git init
 npm install --save-dev pumuki-ast-hooks
-npm run install-hooks
+npx ast-install
 ```
 
 ### Step 2: Make a commit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "6.1.6",
+  "version": "6.1.8",
   "description": "Enterprise-grade AST Intelligence System with multi-platform support (iOS, Android, Backend, Frontend) and Feature-First + DDD + Clean Architecture enforcement. Includes dynamic violations API for intelligent querying.",
   "main": "index.js",
   "bin": {

package/scripts/hooks-system/.audit-reports/auto-recovery.log

@@ -39,3 +39,4 @@
 {"timestamp":"2026-01-14T22:23:58.130Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
 {"timestamp":"2026-01-15T07:43:05.309Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
 {"timestamp":"2026-01-15T07:49:00.777Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}
+{"timestamp":"2026-01-15T09:57:40.478Z","level":"info","component":"AutoRecovery","event":"NotificationCenterService shutdown","data":{"totalEnqueued":0,"totalSent":0,"totalDeduplicated":0,"totalCooldownSkipped":0,"totalFailed":0,"totalRetries":0,"queueSize":0,"deduplication":{"size":0},"cooldowns":{"activeCooldowns":0}},"context":{}}

package/scripts/hooks-system/.audit-reports/install-wizard.log

@@ -166,3 +166,7 @@
 {"timestamp":"2026-01-15T07:49:00.931Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_CONFIG_EXISTS","data":{"configPath":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.hook-system/config.json"},"context":{}}
 {"timestamp":"2026-01-15T07:49:00.931Z","level":"error","component":"InstallWizard","event":"INSTALL_WIZARD_SYMLINK_FAILED","data":{"error":"EEXIST: file already exists, symlink '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/scripts/hooks-system/bin/guard-supervisor.js' -> '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.git/hooks/guard-supervisor'"},"context":{}}
 {"timestamp":"2026-01-15T07:49:00.931Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-15T09:57:40.584Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-15T09:57:40.597Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_CONFIG_EXISTS","data":{"configPath":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.hook-system/config.json"},"context":{}}
+{"timestamp":"2026-01-15T09:57:40.598Z","level":"error","component":"InstallWizard","event":"INSTALL_WIZARD_SYMLINK_FAILED","data":{"error":"EEXIST: file already exists, symlink '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/scripts/hooks-system/bin/guard-supervisor.js' -> '/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system/.git/hooks/guard-supervisor'"},"context":{}}
+{"timestamp":"2026-01-15T09:57:40.598Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}

package/scripts/hooks-system/.audit_tmp/hook-metrics.jsonl

@@ -1250,3 +1250,27 @@
 {"timestamp":1768463340777,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
 {"timestamp":1768463340777,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
 {"timestamp":1768463340777,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060475,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060475,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768471060475,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768471060475,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060476,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768471060477,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768471060477,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060477,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768471060477,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768471060477,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768471060477,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}

package/scripts/hooks-system/application/services/installation/ConfigurationGeneratorService.js

@@ -118,15 +118,15 @@ class ConfigurationGeneratorService {
                 ? 'scripts/hooks-system'
                 : 'node_modules/pumuki-ast-hooks/scripts/hooks-system';
 
-            packageJson.scripts['ast:refresh'] = `node ${base}/bin/update-evidence.sh`;
-            packageJson.scripts['ast:audit'] = `node ${base}/infrastructure/ast/ast-intelligence.js`;
-            packageJson.scripts['ast:guard:start'] = `bash ${base}/bin/evidence-guard start`;
-            packageJson.scripts['ast:guard:stop'] = `bash ${base}/bin/evidence-guard stop`;
-            packageJson.scripts['ast:guard:restart'] = `bash ${base}/bin/evidence-guard restart`;
-            packageJson.scripts['ast:guard:status'] = `bash ${base}/bin/evidence-guard status`;
-            packageJson.scripts['ast:guard:logs'] = `bash ${base}/bin/evidence-guard logs`;
-            packageJson.scripts['ast:check-version'] = `node ${base}/bin/check-version.js`;
-            packageJson.scripts['ast:gitflow'] = `node ${base}/bin/gitflow-cycle.js`;
+            packageJson.scripts['ast:refresh'] = `node "${base}/bin/update-evidence.sh"`;
+            packageJson.scripts['ast:audit'] = `node "${base}/infrastructure/ast/ast-intelligence.js"`;
+            packageJson.scripts['ast:guard:start'] = `bash "${base}/bin/evidence-guard" start`;
+            packageJson.scripts['ast:guard:stop'] = `bash "${base}/bin/evidence-guard" stop`;
+            packageJson.scripts['ast:guard:restart'] = `bash "${base}/bin/evidence-guard" restart`;
+            packageJson.scripts['ast:guard:status'] = `bash "${base}/bin/evidence-guard" status`;
+            packageJson.scripts['ast:guard:logs'] = `bash "${base}/bin/evidence-guard" logs`;
+            packageJson.scripts['ast:check-version'] = `node "${base}/bin/check-version.js"`;
+            packageJson.scripts['ast:gitflow'] = `node "${base}/bin/gitflow-cycle.js"`;
 
             fs.writeFileSync(projectPackageJsonPath, JSON.stringify(packageJson, null, 2));
             this.logSuccess('npm scripts added');

package/scripts/hooks-system/bin/__tests__/evidence-guard-wrapper.spec.js

@@ -0,0 +1,43 @@
+const { execFileSync } = require('child_process');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+function makeSUT() {
+    const workspaceRoot = path.resolve(__dirname, '../../../..');
+    const guardScriptPath = path.join(workspaceRoot, 'scripts', 'hooks-system', 'bin', 'evidence-guard');
+
+    const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'pumuki evidence guard project '));
+    fs.writeFileSync(path.join(projectRoot, 'package.json'), JSON.stringify({ name: 'tmp', version: '0.0.0' }));
+
+    const pidFilePath = path.join(projectRoot, '.evidence-guard.pid');
+    fs.writeFileSync(pidFilePath, String(process.pid));
+
+    return { guardScriptPath, projectRoot, pidFilePath };
+}
+
+describe('evidence-guard wrapper', () => {
+    it('should resolve project root from cwd (supports paths with spaces)', () => {
+        const { guardScriptPath, projectRoot } = makeSUT();
+
+        const output = execFileSync('bash', [guardScriptPath, 'status'], {
+            cwd: projectRoot,
+            encoding: 'utf8'
+        });
+
+        expect(output).toContain('Evidence guard is running');
+    });
+
+    it('should find PID file in project root with spaces in path', () => {
+        const { guardScriptPath, projectRoot, pidFilePath } = makeSUT();
+
+        expect(fs.existsSync(pidFilePath)).toBe(true);
+
+        const output = execFileSync('bash', [guardScriptPath, 'status'], {
+            cwd: projectRoot,
+            encoding: 'utf8'
+        });
+
+        expect(output).toContain(`PID: ${process.pid}`);
+    });
+});

package/scripts/hooks-system/bin/evidence-guard

@@ -1,7 +1,15 @@
 #!/bin/bash
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+PROJECT_ROOT="$(pwd)"
+while [ "$PROJECT_ROOT" != "/" ] && [ ! -f "$PROJECT_ROOT/package.json" ]; do
+  PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+if [ ! -f "$PROJECT_ROOT/package.json" ]; then
+  PROJECT_ROOT="$(pwd)"
+fi
+
 GUARD_SCRIPT="$SCRIPT_DIR/../infrastructure/daemons/evidence-guard.js"
 PID_FILE="$PROJECT_ROOT/.evidence-guard.pid"
 LOG_FILE="$PROJECT_ROOT/.evidence-guard.log"

package/scripts/hooks-system/infrastructure/watchdog/__tests__/.audit-reports/token-monitor.log

@@ -121,3 +121,6 @@
 {"timestamp":"2026-01-15T07:49:02.751Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":10,"tokensUsed":100000,"maxTokens":1000000,"source":"realtime","stale":false},"context":{"message":"Result level=ok percent=10% used=100000/1000000 source=realtime"}}
 {"timestamp":"2026-01-15T07:49:02.752Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"warning","percentUsed":91,"tokensUsed":910000,"maxTokens":1000000,"source":"fallback","stale":false},"context":{"message":"Result level=warning percent=91% used=910000/1000000 source=fallback"}}
 {"timestamp":"2026-01-15T07:49:02.753Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"critical","percentUsed":98,"tokensUsed":980000,"maxTokens":1000000,"source":"realtime","stale":true},"context":{"message":"Result level=critical percent=98% used=980000/1000000 source=realtime (stale)"}}
+{"timestamp":"2026-01-15T09:57:43.821Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"ok","percentUsed":10,"tokensUsed":100000,"maxTokens":1000000,"source":"realtime","stale":false},"context":{"message":"Result level=ok percent=10% used=100000/1000000 source=realtime"}}
+{"timestamp":"2026-01-15T09:57:43.823Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"warning","percentUsed":91,"tokensUsed":910000,"maxTokens":1000000,"source":"fallback","stale":false},"context":{"message":"Result level=warning percent=91% used=910000/1000000 source=fallback"}}
+{"timestamp":"2026-01-15T09:57:43.823Z","level":"info","component":"TokenMonitor","event":"TOKEN_MONITOR_RESULT","data":{"level":"critical","percentUsed":98,"tokensUsed":980000,"maxTokens":1000000,"source":"realtime","stale":true},"context":{"message":"Result level=critical percent=98% used=980000/1000000 source=realtime (stale)"}}