pumuki-ast-hooks 6.1.7 → 6.1.9

package/bin/uninstall.js

@@ -3,6 +3,8 @@
 const fs = require('fs');
 const path = require('path');
 
+const MANIFEST_RELATIVE_PATH = '.ast-intelligence/install-manifest.json';
+
 function findProjectRoot(startDir) {
     let current = startDir;
     while (current !== '/') {
@@ -14,6 +16,45 @@ function findProjectRoot(startDir) {
     return startDir;
 }
 
+function loadManifest(projectRoot) {
+    const manifestPath = path.join(projectRoot, MANIFEST_RELATIVE_PATH);
+    if (!fs.existsSync(manifestPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    } catch {
+        return null;
+    }
+}
+
+function buildUninstallPlanFromManifest(projectRoot, manifest) {
+    const paths = [];
+
+    for (const relPath of manifest.createdFiles || []) {
+        const fullPath = path.join(projectRoot, relPath);
+        if (fs.existsSync(fullPath)) {
+            paths.push(fullPath);
+        }
+    }
+
+    for (const relPath of manifest.createdDirs || []) {
+        const fullPath = path.join(projectRoot, relPath);
+        if (fs.existsSync(fullPath)) {
+            paths.push(fullPath);
+        }
+    }
+
+    paths.push(path.join(projectRoot, MANIFEST_RELATIVE_PATH));
+
+    const unique = Array.from(new Set(paths.filter(p => fs.existsSync(p))));
+    return {
+        projectRoot,
+        paths: unique.sort(),
+        fromManifest: true
+    };
+}
+
 function isPumukiHookContent(content) {
     if (!content) return false;
     const text = String(content);
@@ -146,11 +187,18 @@ function printUsage() {
 }
 
 function planUninstall({ projectRoot }) {
+    const manifest = loadManifest(projectRoot);
+    if (manifest) {
+        return buildUninstallPlanFromManifest(projectRoot, manifest);
+    }
     return buildUninstallPlan(projectRoot);
 }
 
 function applyUninstall({ projectRoot, apply, yes }) {
-    const plan = buildUninstallPlan(projectRoot);
+    const manifest = loadManifest(projectRoot);
+    const plan = manifest
+        ? buildUninstallPlanFromManifest(projectRoot, manifest)
+        : buildUninstallPlan(projectRoot);
 
     if (!apply) {
         return { applied: false, plan };
@@ -182,10 +230,18 @@ function main() {
     const rootFromCwd = findProjectRoot(cwd);
     const projectRoot = options.projectRootArg ? path.resolve(options.projectRootArg) : rootFromCwd;
 
-    const plan = buildUninstallPlan(projectRoot);
+    const manifest = loadManifest(projectRoot);
+    const plan = manifest
+        ? buildUninstallPlanFromManifest(projectRoot, manifest)
+        : buildUninstallPlan(projectRoot);
 
     if (options.dryRun) {
         process.stdout.write(`Project root: ${projectRoot}\n`);
+        if (plan.fromManifest) {
+            process.stdout.write('Using install manifest for precise cleanup.\n');
+        } else {
+            process.stdout.write('No manifest found, using heuristic detection.\n');
+        }
         process.stdout.write('Planned removals:\n');
         for (const p of plan.paths) {
             process.stdout.write(`- ${p}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "6.1.7",
+  "version": "6.1.9",
   "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,5 @@
 {"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":{}}
+{"timestamp":"2026-01-15T14:53:23.342Z","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,11 @@
 {"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":{}}
+{"timestamp":"2026-01-15T14:53:23.406Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-15T14:53:23.414Z","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-15T14:53:23.415Z","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-15T14:53:23.415Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}

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

@@ -1250,3 +1250,51 @@
 {"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"}
+{"timestamp":1768488803340,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803340,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768488803340,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768488803340,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803340,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803340,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768488803340,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768488803340,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803341,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803341,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768488803341,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768488803341,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803341,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803341,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768488803342,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768488803342,"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/application/services/installation/InstallManifestService.js

@@ -0,0 +1,76 @@
+const fs = require('fs');
+const path = require('path');
+
+const MANIFEST_RELATIVE_PATH = '.ast-intelligence/install-manifest.json';
+
+class InstallManifestService {
+    constructor(projectRoot, version = 'unknown') {
+        this.projectRoot = projectRoot;
+        this.version = version;
+        this.createdFiles = [];
+        this.modifiedFiles = [];
+        this.createdDirs = [];
+        this.installedAt = new Date().toISOString();
+    }
+
+    recordCreatedFile(relativePath) {
+        if (!this.createdFiles.includes(relativePath)) {
+            this.createdFiles.push(relativePath);
+        }
+    }
+
+    recordModifiedFile(relativePath, backupPath) {
+        const existing = this.modifiedFiles.find(m => m.path === relativePath);
+        if (!existing) {
+            this.modifiedFiles.push({ path: relativePath, backup: backupPath });
+        }
+    }
+
+    recordCreatedDir(relativePath) {
+        if (!this.createdDirs.includes(relativePath)) {
+            this.createdDirs.push(relativePath);
+        }
+    }
+
+    getManifest() {
+        return {
+            version: this.version,
+            installedAt: this.installedAt,
+            createdFiles: [...this.createdFiles],
+            modifiedFiles: [...this.modifiedFiles],
+            createdDirs: [...this.createdDirs]
+        };
+    }
+
+    save() {
+        const manifestPath = path.join(this.projectRoot, MANIFEST_RELATIVE_PATH);
+        const manifestDir = path.dirname(manifestPath);
+
+        if (!fs.existsSync(manifestDir)) {
+            fs.mkdirSync(manifestDir, { recursive: true });
+        }
+
+        fs.writeFileSync(manifestPath, JSON.stringify(this.getManifest(), null, 2));
+    }
+
+    static load(projectRoot) {
+        const manifestPath = path.join(projectRoot, MANIFEST_RELATIVE_PATH);
+
+        if (!fs.existsSync(manifestPath)) {
+            return null;
+        }
+
+        try {
+            const content = fs.readFileSync(manifestPath, 'utf8');
+            return JSON.parse(content);
+        } catch {
+            return null;
+        }
+    }
+
+    static getManifestPath(projectRoot) {
+        return path.join(projectRoot, MANIFEST_RELATIVE_PATH);
+    }
+}
+
+module.exports = InstallManifestService;

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

@@ -8,6 +8,7 @@ const FileSystemInstallerService = require('./FileSystemInstallerService');
 const ConfigurationGeneratorService = require('./ConfigurationGeneratorService');
 const IdeIntegrationService = require('./IdeIntegrationService');
 const CriticalDependenciesService = require('./CriticalDependenciesService');
+const InstallManifestService = require('./InstallManifestService');
 const UnifiedLogger = require('../logging/UnifiedLogger');
 
 const COLORS = {
@@ -75,6 +76,7 @@ class InstallService {
         this.fsInstaller = new FileSystemInstallerService(this.targetRoot, this.hookSystemRoot, this.logger);
         this.configGenerator = new ConfigurationGeneratorService(this.targetRoot, this.hookSystemRoot);
         this.ideIntegration = new IdeIntegrationService(this.targetRoot, this.hookSystemRoot, this.logger);
+        this.manifest = new InstallManifestService(this.targetRoot, this.version);
     }
 
     getInstallMode() {
@@ -156,10 +158,58 @@ class InstallService {
         this.logStep('8.5/8', 'Starting evidence guard daemon...');
         this.startEvidenceGuard();
 
+        this.logStep('8.75/8', 'Saving installation manifest...');
+        this.saveInstallManifest(installMode);
+
         this.logger.info('INSTALLATION_COMPLETED_SUCCESSFULLY');
         this.printFooter();
     }
 
+    saveInstallManifest(installMode) {
+        this.manifest.recordCreatedDir('.ast-intelligence');
+        this.manifest.recordCreatedFile('.AI_EVIDENCE.json');
+        this.manifest.recordCreatedFile('.evidence-guard.pid');
+        this.manifest.recordCreatedFile('.evidence-guard.log');
+
+        if (installMode === 'vendored') {
+            this.manifest.recordCreatedDir('scripts/hooks-system');
+        }
+
+        const cursorMcp = path.join(this.targetRoot, '.cursor', 'mcp.json');
+        const windsurfMcp = path.join(this.targetRoot, '.windsurf', 'mcp.json');
+        if (fs.existsSync(cursorMcp)) {
+            this.manifest.recordCreatedDir('.cursor');
+            this.manifest.recordModifiedFile('.cursor/mcp.json', null);
+        }
+        if (fs.existsSync(windsurfMcp)) {
+            this.manifest.recordCreatedDir('.windsurf');
+            this.manifest.recordModifiedFile('.windsurf/mcp.json', null);
+        }
+
+        const vscodeDir = path.join(this.targetRoot, '.vscode');
+        if (fs.existsSync(vscodeDir)) {
+            this.manifest.recordCreatedDir('.vscode');
+            this.manifest.recordModifiedFile('.vscode/tasks.json', null);
+        }
+
+        const gitHooksDir = path.join(this.targetRoot, '.git', 'hooks');
+        if (fs.existsSync(path.join(gitHooksDir, 'pre-commit'))) {
+            this.manifest.recordCreatedFile('.git/hooks/pre-commit');
+        }
+        if (fs.existsSync(path.join(gitHooksDir, 'pre-push'))) {
+            this.manifest.recordCreatedFile('.git/hooks/pre-push');
+        }
+
+        this.manifest.recordModifiedFile('package.json', null);
+
+        try {
+            this.manifest.save();
+            this.logSuccess('Installation manifest saved');
+        } catch (error) {
+            this.logWarning(`Failed to save manifest: ${error.message}`);
+        }
+    }
+
     startEvidenceGuard() {
         const { spawn } = require('child_process');
         const candidates = [

package/scripts/hooks-system/application/services/installation/__tests__/InstallManifestService.spec.js

@@ -0,0 +1,117 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const InstallManifestService = require('../InstallManifestService');
+
+function makeSUT() {
+    const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'pumuki-manifest-test-'));
+    const manifestPath = path.join(projectRoot, '.ast-intelligence', 'install-manifest.json');
+    const sut = new InstallManifestService(projectRoot);
+    return { sut, projectRoot, manifestPath };
+}
+
+function cleanupSUT({ projectRoot }) {
+    fs.rmSync(projectRoot, { recursive: true, force: true });
+}
+
+describe('InstallManifestService', () => {
+    describe('recordCreatedFile', () => {
+        it('should add file path to manifest', () => {
+            const { sut, projectRoot, manifestPath } = makeSUT();
+
+            sut.recordCreatedFile('.ast-intelligence/skills/SKILL.md');
+            sut.save();
+
+            expect(fs.existsSync(manifestPath)).toBe(true);
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+            expect(manifest.createdFiles).toContain('.ast-intelligence/skills/SKILL.md');
+
+            cleanupSUT({ projectRoot });
+        });
+    });
+
+    describe('recordModifiedFile', () => {
+        it('should add modified file with backup path to manifest', () => {
+            const { sut, projectRoot, manifestPath } = makeSUT();
+
+            sut.recordModifiedFile('package.json', '_package.json.bak');
+            sut.save();
+
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+            expect(manifest.modifiedFiles).toEqual(
+                expect.arrayContaining([
+                    expect.objectContaining({
+                        path: 'package.json',
+                        backup: '_package.json.bak'
+                    })
+                ])
+            );
+
+            cleanupSUT({ projectRoot });
+        });
+    });
+
+    describe('recordCreatedDir', () => {
+        it('should add directory path to manifest', () => {
+            const { sut, projectRoot, manifestPath } = makeSUT();
+
+            sut.recordCreatedDir('.ast-intelligence');
+            sut.save();
+
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+            expect(manifest.createdDirs).toContain('.ast-intelligence');
+
+            cleanupSUT({ projectRoot });
+        });
+    });
+
+    describe('getManifest', () => {
+        it('should return manifest structure with metadata', () => {
+            const { sut, projectRoot } = makeSUT();
+
+            sut.recordCreatedFile('.AI_EVIDENCE.json');
+            const manifest = sut.getManifest();
+
+            expect(manifest).toHaveProperty('version');
+            expect(manifest).toHaveProperty('installedAt');
+            expect(manifest).toHaveProperty('createdFiles');
+            expect(manifest).toHaveProperty('modifiedFiles');
+            expect(manifest).toHaveProperty('createdDirs');
+
+            cleanupSUT({ projectRoot });
+        });
+    });
+
+    describe('load', () => {
+        it('should load existing manifest from disk', () => {
+            const { sut, projectRoot, manifestPath } = makeSUT();
+
+            fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
+            fs.writeFileSync(manifestPath, JSON.stringify({
+                version: '6.1.8',
+                installedAt: '2026-01-15T00:00:00.000Z',
+                createdFiles: ['.AI_EVIDENCE.json'],
+                modifiedFiles: [],
+                createdDirs: ['.ast-intelligence']
+            }));
+
+            const loaded = InstallManifestService.load(projectRoot);
+
+            expect(loaded.createdFiles).toContain('.AI_EVIDENCE.json');
+            expect(loaded.createdDirs).toContain('.ast-intelligence');
+
+            cleanupSUT({ projectRoot });
+        });
+
+        it('should return null if manifest does not exist', () => {
+            const { sut, projectRoot } = makeSUT();
+
+            const loaded = InstallManifestService.load(projectRoot);
+
+            expect(loaded).toBeNull();
+
+            cleanupSUT({ projectRoot });
+        });
+    });
+});

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,9 @@
 {"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)"}}
+{"timestamp":"2026-01-15T14:53:25.770Z","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-15T14:53:25.772Z","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-15T14:53:25.772Z","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)"}}