pumuki-ast-hooks 6.1.3 → 6.1.6

package/README.md

@@ -21,6 +21,14 @@ npm run install-hooks
 npx ast-hooks
 ```
 
+Default installation mode is `npm-runtime`.
+
+To opt into an embedded runtime copy (`vendored` mode):
+
+```bash
+HOOK_INSTALL_MODE=vendored npm run install-hooks
+```
+
 ---
 
 ## Operational visuals (examples)
@@ -53,14 +61,7 @@ Documentation:
 
 - `docs/USAGE.md` (Interactive Menu, non‑interactive `AUDIT_OPTION`, and typical flows)
 - `CHANGELOG.md` (Release notes and changes)
-- Keychain/Security casts are exempted from `ios.types.forbidden_type_cast` to avoid false positives in secure storage implementations.
-
-Release 6.0.6:
-- Keychain/Security casts are exempted from `ios.types.forbidden_type_cast` to avoid false positives in secure storage implementations.
-- Staging-only detection now ignores deleted files when building the file list.
-
-Release 6.0.7:
-- God Class detection (backend): baseline-first by default; optional hard cap via env; detector always runs (with or without baseline).
+- `docs/RELEASE_NOTES.md` (Historical release notes)
 
 ---
 

package/bin/__tests__/uninstall.spec.js

@@ -0,0 +1,50 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+function makeTempProject() {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), 'pumuki-uninstall-'));
+    fs.writeFileSync(path.join(root, 'package.json'), JSON.stringify({ name: 'tmp', version: '0.0.0' }));
+    fs.mkdirSync(path.join(root, '.ast-intelligence'), { recursive: true });
+    fs.writeFileSync(path.join(root, '.AI_EVIDENCE.json'), JSON.stringify({ ok: true }));
+    fs.writeFileSync(path.join(root, '.evidence-guard.pid'), '99999');
+    fs.writeFileSync(path.join(root, '.evidence-guard.log'), 'log');
+
+    const gitHooksDir = path.join(root, '.git', 'hooks');
+    fs.mkdirSync(gitHooksDir, { recursive: true });
+    fs.writeFileSync(path.join(gitHooksDir, 'pre-commit'), 'node_modules/pumuki-ast-hooks/scripts/hooks-system/infrastructure/shell/gitflow/gitflow-enforcer.sh');
+    fs.writeFileSync(path.join(gitHooksDir, 'pre-push'), 'node_modules/pumuki-ast-hooks/scripts/hooks-system/infrastructure/shell/gitflow/gitflow-enforcer.sh');
+
+    return root;
+}
+
+describe('ast-uninstall', () => {
+    it('should default to dry-run (no deletions)', () => {
+        const projectRoot = makeTempProject();
+        const { planUninstall, applyUninstall } = require('../uninstall');
+
+        const plan = planUninstall({ projectRoot });
+        expect(Array.isArray(plan.paths)).toBe(true);
+        expect(plan.paths.length).toBeGreaterThan(0);
+
+        const result = applyUninstall({ projectRoot, apply: false, yes: true });
+        expect(result.applied).toBe(false);
+        expect(fs.existsSync(path.join(projectRoot, '.ast-intelligence'))).toBe(true);
+    });
+
+    it('should delete pumuki artifacts when apply=true', () => {
+        const projectRoot = makeTempProject();
+        const { applyUninstall } = require('../uninstall');
+
+        const result = applyUninstall({ projectRoot, apply: true, yes: true });
+        expect(result.applied).toBe(true);
+
+        expect(fs.existsSync(path.join(projectRoot, '.ast-intelligence'))).toBe(false);
+        expect(fs.existsSync(path.join(projectRoot, '.AI_EVIDENCE.json'))).toBe(false);
+        expect(fs.existsSync(path.join(projectRoot, '.evidence-guard.pid'))).toBe(false);
+        expect(fs.existsSync(path.join(projectRoot, '.evidence-guard.log'))).toBe(false);
+
+        expect(fs.existsSync(path.join(projectRoot, '.git', 'hooks', 'pre-commit'))).toBe(false);
+        expect(fs.existsSync(path.join(projectRoot, '.git', 'hooks', 'pre-push'))).toBe(false);
+    });
+});

package/bin/uninstall.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+function findProjectRoot(startDir) {
+    let current = startDir;
+    while (current !== '/') {
+        if (fs.existsSync(path.join(current, 'package.json'))) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    return startDir;
+}
+
+function isPumukiHookContent(content) {
+    if (!content) return false;
+    const text = String(content);
+    return text.includes('pumuki-ast-hooks') ||
+        text.includes('AST Intelligence') ||
+        text.includes('gitflow-enforcer.sh') ||
+        text.includes('Hook-System Git Flow Enforcer');
+}
+
+function safeReadFile(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf8');
+    } catch {
+        return null;
+    }
+}
+
+function shouldRemoveGitHook(hookPath) {
+    if (!fs.existsSync(hookPath)) return false;
+    const content = safeReadFile(hookPath);
+    return isPumukiHookContent(content);
+}
+
+function buildUninstallPlan(projectRoot) {
+    const paths = [];
+
+    const artifactPaths = [
+        '.ast-intelligence',
+        '.AI_EVIDENCE.json',
+        '.evidence-guard.pid',
+        '.evidence-guard.log',
+        '.audit_tmp',
+        '.audit-reports'
+    ];
+
+    for (const rel of artifactPaths) {
+        const p = path.join(projectRoot, rel);
+        if (fs.existsSync(p)) {
+            paths.push(p);
+        }
+    }
+
+    const gitHooksDir = path.join(projectRoot, '.git', 'hooks');
+    const preCommit = path.join(gitHooksDir, 'pre-commit');
+    const prePush = path.join(gitHooksDir, 'pre-push');
+
+    if (shouldRemoveGitHook(preCommit)) {
+        paths.push(preCommit);
+    }
+    if (shouldRemoveGitHook(prePush)) {
+        paths.push(prePush);
+    }
+
+    const vendoredRoot = path.join(projectRoot, 'scripts', 'hooks-system');
+    if (fs.existsSync(vendoredRoot)) {
+        paths.push(vendoredRoot);
+    }
+
+    const cursorDir = path.join(projectRoot, '.cursor');
+    const windsurfDir = path.join(projectRoot, '.windsurf');
+    const vscodeDir = path.join(projectRoot, '.vscode');
+
+    const cursorMcp = path.join(cursorDir, 'mcp.json');
+    const windsurfMcp = path.join(windsurfDir, 'mcp.json');
+
+    if (fs.existsSync(cursorMcp) || fs.existsSync(windsurfMcp)) {
+        if (fs.existsSync(cursorDir)) paths.push(cursorDir);
+        if (fs.existsSync(windsurfDir)) paths.push(windsurfDir);
+    }
+
+    if (fs.existsSync(vscodeDir)) {
+        paths.push(vscodeDir);
+    }
+
+    const unique = Array.from(new Set(paths));
+    return {
+        projectRoot,
+        paths: unique.sort()
+    };
+}
+
+function removePath(targetPath) {
+    if (!fs.existsSync(targetPath)) return;
+    const stat = fs.lstatSync(targetPath);
+    if (stat.isDirectory()) {
+        fs.rmSync(targetPath, { recursive: true, force: true });
+        return;
+    }
+    fs.rmSync(targetPath, { force: true });
+}
+
+function stopEvidenceGuard(projectRoot) {
+    const pidPath = path.join(projectRoot, '.evidence-guard.pid');
+    if (!fs.existsSync(pidPath)) return;
+
+    const raw = safeReadFile(pidPath);
+    const pid = raw ? parseInt(raw.trim(), 10) : NaN;
+    if (Number.isNaN(pid)) return;
+
+    try {
+        process.kill(pid, 0);
+    } catch {
+        return;
+    }
+
+    try {
+        process.kill(pid, 'SIGTERM');
+    } catch {
+        return;
+    }
+}
+
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    return {
+        apply: args.includes('--apply'),
+        dryRun: args.includes('--dry-run') || !args.includes('--apply'),
+        yes: args.includes('--yes'),
+        help: args.includes('--help') || args.includes('-h'),
+        projectRootArg: (() => {
+            const p = args.find(a => a.startsWith('--project-root='));
+            if (!p) return null;
+            return p.split('=').slice(1).join('=');
+        })()
+    };
+}
+
+function printUsage() {
+    process.stdout.write(`\nUsage:\n  npx ast-uninstall [--dry-run] [--apply] [--yes] [--project-root=/path]\n\nDefaults:\n  --dry-run is default (no changes)\n\nExamples:\n  npx ast-uninstall\n  npx ast-uninstall --apply\n  npx ast-uninstall --apply --yes\n  npx ast-uninstall --project-root=/path/to/repo\n\n`);
+}
+
+function planUninstall({ projectRoot }) {
+    return buildUninstallPlan(projectRoot);
+}
+
+function applyUninstall({ projectRoot, apply, yes }) {
+    const plan = buildUninstallPlan(projectRoot);
+
+    if (!apply) {
+        return { applied: false, plan };
+    }
+
+    if (!yes && process.stdout.isTTY) {
+        process.stdout.write('This will delete files from your repository. Re-run with --yes to confirm.\n');
+        return { applied: false, plan, needsConfirmation: true };
+    }
+
+    stopEvidenceGuard(projectRoot);
+
+    for (const p of plan.paths) {
+        removePath(p);
+    }
+
+    return { applied: true, plan };
+}
+
+function main() {
+    const options = parseArgs(process.argv);
+
+    if (options.help) {
+        printUsage();
+        process.exit(0);
+    }
+
+    const cwd = process.cwd();
+    const rootFromCwd = findProjectRoot(cwd);
+    const projectRoot = options.projectRootArg ? path.resolve(options.projectRootArg) : rootFromCwd;
+
+    const plan = buildUninstallPlan(projectRoot);
+
+    if (options.dryRun) {
+        process.stdout.write(`Project root: ${projectRoot}\n`);
+        process.stdout.write('Planned removals:\n');
+        for (const p of plan.paths) {
+            process.stdout.write(`- ${p}\n`);
+        }
+        process.exit(0);
+    }
+
+    const result = applyUninstall({ projectRoot, apply: true, yes: options.yes });
+
+    if (result.needsConfirmation) {
+        process.exit(2);
+    }
+
+    process.stdout.write('Uninstall completed.\n');
+    process.exit(0);
+}
+
+if (require.main === module) {
+    main();
+}
+
+module.exports = { planUninstall, applyUninstall, findProjectRoot };

package/docs/INSTALLATION.md

@@ -91,6 +91,8 @@ npm install --save-dev pumuki-ast-hooks
 npm run install-hooks
 ```
 
+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`.
+
 ### Option 2: Global Installation
 
 ```bash
@@ -231,7 +233,7 @@ cat > .cursor/mcp.json << 'EOF'
     "ai-evidence-watcher": {
       "command": "node",
       "args": [
-        "${workspaceFolder}/node_modules/pumuki-ast-hooks/infrastructure/mcp/evidence-watcher.js"
+        "${workspaceFolder}/node_modules/pumuki-ast-hooks/scripts/hooks-system/infrastructure/mcp/evidence-watcher.js"
       ],
       "env": {
         "REPO_ROOT": "${workspaceFolder}"
@@ -240,7 +242,7 @@ cat > .cursor/mcp.json << 'EOF'
     "ast-intelligence-automation": {
       "command": "node",
       "args": [
-        "${workspaceFolder}/scripts/hooks-system/infrastructure/mcp/ast-intelligence-automation.js"
+        "${workspaceFolder}/node_modules/pumuki-ast-hooks/scripts/hooks-system/infrastructure/mcp/ast-intelligence-automation.js"
       ],
       "env": {
         "REPO_ROOT": "${workspaceFolder}",
@@ -358,6 +360,8 @@ cp node_modules/pumuki-ast-hooks/templates/config/rules.json.template \
 # Then customize as needed
 ```
 
+If you are using npm-runtime mode (default), use `HOOK_INSTALL_MODE=vendored` before re-running the installer to ensure `scripts/hooks-system/config/` exists in your project.
+
 **Note:** Templates are optional. The library works without them using default configurations. Only copy and customize if you need project-specific overrides.
 
 ### 7. Configure Exclusions
@@ -653,7 +657,7 @@ npm run install-hooks
 This ensures:
 - ✅ Latest Git hooks are installed (with new features)
 - ✅ Latest MCP server configurations are updated
-- ✅ Latest system files are copied to `scripts/hooks-system/`
+- ✅ Latest system files are copied to `scripts/hooks-system/` when using vendored mode
 - ✅ Any new configuration options are applied
 
 **What gets updated:**

package/docs/USAGE.md

@@ -12,13 +12,6 @@
 
 ---
 
-## Recent Changes (v6.0.6)
-
-- Keychain/Security casts are exempted from `ios.types.forbidden_type_cast` to avoid false positives.
-- Staging gate evaluation ignores deleted files when assembling the staged file list.
-
----
-
 ## Minimal Example (5 minutes)
 
 ### Step 1: Install
@@ -88,10 +81,15 @@ npm run ast:guard:logs
 Gate scope:
 ```bash
 # Default is staging (only staged files)
-AI_GATE_SCOPE=staging bash ./scripts/hooks-system/bin/update-evidence.sh --auto
+AI_GATE_SCOPE=staging bash ./node_modules/pumuki-ast-hooks/scripts/hooks-system/bin/update-evidence.sh --auto
 
 # Repository-wide gate evaluation
-AI_GATE_SCOPE=repo bash ./scripts/hooks-system/bin/update-evidence.sh --auto
+AI_GATE_SCOPE=repo bash ./node_modules/pumuki-ast-hooks/scripts/hooks-system/bin/update-evidence.sh --auto
+```
+
+If you are using vendored mode, you can use:
+```bash
+AI_GATE_SCOPE=staging bash ./scripts/hooks-system/bin/update-evidence.sh --auto
 ```
 
 ### Interactive Menu (Recommended)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki-ast-hooks",
-  "version": "6.1.3",
+  "version": "6.1.6",
   "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": {
@@ -8,6 +8,7 @@
     "audit": "./bin/audit",
     "ast-hooks": "./bin/cli.js",
     "ast-install": "./bin/install.js",
+    "ast-uninstall": "./bin/uninstall.js",
     "ast-violations": "./bin/violations-api.js",
     "ast-check-version": "./bin/check-version.js",
     "ast-gitflow": "./scripts/hooks-system/bin/gitflow-cycle.js",

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

@@ -35,3 +35,7 @@
 {"timestamp":"2026-01-14T10:52:05.241Z","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-14T10:53:08.625Z","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-14T10:53:45.774Z","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-14T19:41:34.447Z","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-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":{}}

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

@@ -150,3 +150,19 @@
 {"timestamp":"2026-01-14T10:53:45.937Z","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-14T10:53:45.939Z","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-14T10:53:45.939Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-14T19:41:34.372Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-14T19:41:34.380Z","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-14T19:41:34.380Z","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-14T19:41:34.380Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-14T22:23:58.044Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-14T22:23:58.052Z","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-14T22:23:58.052Z","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-14T22:23:58.053Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-15T07:43:05.408Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"timestamp":"2026-01-15T07:43:05.416Z","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:43:05.417Z","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:43:05.417Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_COMPLETED","data":{},"context":{}}
+{"timestamp":"2026-01-15T07:49:00.924Z","level":"info","component":"InstallWizard","event":"INSTALL_WIZARD_START","data":{"repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"},"context":{}}
+{"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":{}}

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

@@ -1154,3 +1154,99 @@
 {"timestamp":1768388025774,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
 {"timestamp":1768388025774,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
 {"timestamp":1768388025774,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694445,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694446,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768419694446,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768419694446,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694446,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694446,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768419694446,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768419694446,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694446,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768419694447,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438128,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768429438129,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768429438130,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985307,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985308,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768462985308,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768462985308,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985308,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768462985309,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340775,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"ensure_dir","status":"started"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"ensure_dir","status":"success"}
+{"timestamp":1768463340776,"hook":"audit_logger","operation":"constructor","status":"success","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"timestamp":1768463340777,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"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":1768463340777,"hook":"audit_logger","operation":"constructor","status":"started","repoRoot":"/Users/juancarlosmerlosalbarracin/Developer/Projects/ast-intelligence-hooks/scripts/hooks-system"}
+{"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"}

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

@@ -68,8 +68,12 @@ class ConfigurationGeneratorService {
             }
         });
 
-        const configPath = path.join(this.targetRoot, 'scripts/hooks-system/config/project.config.json');
-        // Ensure dir exists just in case
+        const installMode = String(env.get('HOOK_INSTALL_MODE', 'npm')).trim().toLowerCase();
+        const useVendored = installMode === 'vendored' || installMode === 'embedded';
+        const configPath = useVendored
+            ? path.join(this.targetRoot, 'scripts/hooks-system/config/project.config.json')
+            : path.join(this.targetRoot, '.ast-intelligence/project.config.json');
+
         const configDir = path.dirname(configPath);
         if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true });
 
@@ -107,16 +111,22 @@ class ConfigurationGeneratorService {
                 packageJson.scripts = {};
             }
 
-            // Add helper scripts
-            packageJson.scripts['ast:refresh'] = 'node scripts/hooks-system/bin/update-evidence.sh';
-            packageJson.scripts['ast:audit'] = 'node scripts/hooks-system/infrastructure/ast/ast-intelligence.js';
-            packageJson.scripts['ast:guard:start'] = 'bash scripts/hooks-system/bin/evidence-guard start';
-            packageJson.scripts['ast:guard:stop'] = 'bash scripts/hooks-system/bin/evidence-guard stop';
-            packageJson.scripts['ast:guard:restart'] = 'bash scripts/hooks-system/bin/evidence-guard restart';
-            packageJson.scripts['ast:guard:status'] = 'bash scripts/hooks-system/bin/evidence-guard status';
-            packageJson.scripts['ast:guard:logs'] = 'bash scripts/hooks-system/bin/evidence-guard logs';
-            packageJson.scripts['ast:check-version'] = 'node scripts/hooks-system/bin/check-version.js';
-            packageJson.scripts['ast:gitflow'] = 'node scripts/hooks-system/bin/gitflow-cycle.js';
+            const installMode = String(env.get('HOOK_INSTALL_MODE', 'npm')).trim().toLowerCase();
+            const useVendored = installMode === 'vendored' || installMode === 'embedded';
+
+            const base = useVendored
+                ? '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`;
 
             fs.writeFileSync(projectPackageJsonPath, JSON.stringify(packageJson, null, 2));
             this.logSuccess('npm scripts added');

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

@@ -130,6 +130,10 @@ fi
 
 # Enforce Git Flow checks (strict) before allowing commit
 ENFORCER_SCRIPT="scripts/hooks-system/infrastructure/shell/gitflow/gitflow-enforcer.sh"
+if [[ ! -f "$ENFORCER_SCRIPT" ]]; then
+  ENFORCER_SCRIPT="node_modules/pumuki-ast-hooks/scripts/hooks-system/infrastructure/shell/gitflow/gitflow-enforcer.sh"
+fi
+
 if [[ -f "$ENFORCER_SCRIPT" ]]; then
   echo ""
   echo "🔍 Running Git Flow checks (strict)..."
@@ -276,6 +280,10 @@ fi
 
 # Run gitflow-enforcer if available (optional validation)
 ENFORCER_SCRIPT="scripts/hooks-system/infrastructure/shell/gitflow/gitflow-enforcer.sh"
+if [[ ! -f "$ENFORCER_SCRIPT" ]]; then
+  ENFORCER_SCRIPT="node_modules/pumuki-ast-hooks/scripts/hooks-system/infrastructure/shell/gitflow/gitflow-enforcer.sh"
+fi
+
 if [[ -f "$ENFORCER_SCRIPT" ]]; then
   echo ""
   echo "🔍 Running Git Flow checks (strict)..."

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

@@ -77,6 +77,14 @@ class InstallService {
         this.ideIntegration = new IdeIntegrationService(this.targetRoot, this.hookSystemRoot, this.logger);
     }
 
+    getInstallMode() {
+        const mode = String(env.get('HOOK_INSTALL_MODE', 'npm')).trim().toLowerCase();
+        if (mode === 'vendored' || mode === 'embedded') {
+            return 'vendored';
+        }
+        return 'npm';
+    }
+
     checkCriticalDependencies() {
         CriticalDependenciesService.check({
             targetRoot: this.targetRoot,
@@ -113,12 +121,18 @@ class InstallService {
         this.logStep('2/8', 'Installing ESLint configurations...');
         this.configGenerator.installESLintConfigs();
 
-        this.logStep('3/8', 'Creating hooks-system directory structure...');
-        this.fsInstaller.createDirectoryStructure();
+        const installMode = this.getInstallMode();
+        if (installMode === 'vendored') {
+            this.logStep('3/8', 'Creating hooks-system directory structure...');
+            this.fsInstaller.createDirectoryStructure();
 
-        this.logStep('4/8', 'Copying AST Intelligence system files...');
-        this.fsInstaller.copySystemFiles();
-        this.fsInstaller.copyManageLibraryScript();
+            this.logStep('4/8', 'Copying AST Intelligence system files...');
+            this.fsInstaller.copySystemFiles();
+            this.fsInstaller.copyManageLibraryScript();
+        } else {
+            this.logStep('3/8', 'Skipping embedded runtime copy (npm-runtime mode)...');
+            this.logStep('4/8', 'Skipping embedded system files (npm-runtime mode)...');
+        }
 
         this.logStep('5/8', 'Creating project configuration...');
         this.configGenerator.createProjectConfig(platforms);
@@ -148,9 +162,14 @@ class InstallService {
 
     startEvidenceGuard() {
         const { spawn } = require('child_process');
-        const guardScript = path.join(this.targetRoot, 'scripts/hooks-system/bin/evidence-guard');
+        const candidates = [
+            path.join(this.targetRoot, 'scripts/hooks-system/bin/evidence-guard'),
+            path.join(this.targetRoot, 'node_modules/pumuki-ast-hooks/scripts/hooks-system/bin/evidence-guard')
+        ];
+
+        const guardScript = candidates.find(p => fs.existsSync(p)) || null;
 
-        if (!fs.existsSync(guardScript)) {
+        if (!guardScript) {
             this.logWarning('Evidence guard script not found, skipping daemon start');
             return;
         }
@@ -241,6 +260,11 @@ ${COLORS.reset}\n`);
     }
 
     printFooter() {
+        const installMode = this.getInstallMode();
+        const configHint = installMode === 'vendored'
+            ? 'scripts/hooks-system/config/project.config.json'
+            : '.ast-intelligence/project.config.json';
+
         process.stdout.write(`
 ${COLORS.green}✨ Installation Complete! ✨${COLORS.reset}
 
@@ -249,13 +273,8 @@ ${COLORS.cyan}Evidence Guard Daemon:${COLORS.reset}
 - Manage with: ${COLORS.yellow}npm run ast:guard:{start|stop|status|logs}${COLORS.reset}
 
 ${COLORS.cyan}Next Steps:${COLORS.reset}
-1. Review generated configuration in ${COLORS.yellow}scripts/hooks-system/config/project.config.json${COLORS.reset}
-2. Run ${COLORS.yellow}./manage-library.sh verify${COLORS.reset} to check installation
-3. Commit the changes: ${COLORS.yellow}git add . && git commit -m "chore: install ast-intelligence-hooks"${COLORS.reset}
-
-${COLORS.blue}Documentation:${COLORS.reset}
-- scripts/hooks-system/docs/guides/getting-started.md
-- scripts/hooks-system/docs/architecture.md
+1. Review generated configuration in ${COLORS.yellow}${configHint}${COLORS.reset}
+2. Commit the changes: ${COLORS.yellow}git add . && git commit -m "chore: install ast-intelligence-hooks"${COLORS.reset}
 `);
     }
 

package/scripts/hooks-system/bin/__tests__/install-mode.spec.js

@@ -0,0 +1,98 @@
+describe('Installation mode (npm-runtime vs vendored)', () => {
+    const fs = require('fs');
+    const os = require('os');
+    const path = require('path');
+
+    const ConfigurationGeneratorService = require('../../application/services/installation/ConfigurationGeneratorService');
+    const InstallService = require('../../application/services/installation/InstallService');
+
+    const originalEnv = { ...process.env };
+
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+
+    it('ConfigurationGeneratorService.addNpmScripts writes node_modules scripts by default', () => {
+        const testRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'ast-hooks-install-mode-'));
+        const pkgPath = path.join(testRoot, 'package.json');
+        fs.writeFileSync(pkgPath, JSON.stringify({ name: 'test', version: '1.0.0', scripts: {} }, null, 2));
+
+        const service = new ConfigurationGeneratorService(testRoot, __dirname);
+        delete process.env.HOOK_INSTALL_MODE;
+
+        service.addNpmScripts();
+
+        const written = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        expect(written.scripts['ast:audit']).toContain('node_modules/pumuki-ast-hooks');
+        expect(written.scripts['ast:guard:start']).toContain('node_modules/pumuki-ast-hooks');
+
+        fs.rmSync(testRoot, { recursive: true, force: true });
+    });
+
+    it('ConfigurationGeneratorService.addNpmScripts writes vendored scripts when HOOK_INSTALL_MODE=vendored', () => {
+        const testRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'ast-hooks-install-mode-'));
+        const pkgPath = path.join(testRoot, 'package.json');
+        fs.writeFileSync(pkgPath, JSON.stringify({ name: 'test', version: '1.0.0', scripts: {} }, null, 2));
+
+        const service = new ConfigurationGeneratorService(testRoot, __dirname);
+        process.env.HOOK_INSTALL_MODE = 'vendored';
+
+        service.addNpmScripts();
+
+        const written = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        expect(written.scripts['ast:audit']).toContain('scripts/hooks-system');
+        expect(written.scripts['ast:guard:start']).toContain('scripts/hooks-system');
+
+        fs.rmSync(testRoot, { recursive: true, force: true });
+    });
+
+    it('InstallService does not copy system files in npm runtime mode by default', async () => {
+        const service = new InstallService();
+
+        service.gitService = { checkGitRepository: () => true, ensureGitInfoExclude: () => { }, installGitHooks: () => { } };
+        service.platformService = { detect: () => ['backend'] };
+
+        const fsInstaller = {
+            createDirectoryStructure: jest.fn(),
+            copySystemFiles: jest.fn(),
+            copyManageLibraryScript: jest.fn()
+        };
+
+        service.fsInstaller = fsInstaller;
+        service.configGenerator = { installESLintConfigs: () => { }, createProjectConfig: () => { }, addNpmScripts: () => { } };
+        service.ideIntegration = { installCursorHooks: () => { }, configureVSCodeTasks: () => { } };
+        service.checkCriticalDependencies = () => { };
+        service.startEvidenceGuard = () => { };
+
+        delete process.env.HOOK_INSTALL_MODE;
+
+        await service.run();
+
+        expect(fsInstaller.copySystemFiles).not.toHaveBeenCalled();
+    });
+
+    it('InstallService copies system files when HOOK_INSTALL_MODE=vendored', async () => {
+        const service = new InstallService();
+
+        service.gitService = { checkGitRepository: () => true, ensureGitInfoExclude: () => { }, installGitHooks: () => { } };
+        service.platformService = { detect: () => ['backend'] };
+
+        const fsInstaller = {
+            createDirectoryStructure: jest.fn(),
+            copySystemFiles: jest.fn(),
+            copyManageLibraryScript: jest.fn()
+        };
+
+        service.fsInstaller = fsInstaller;
+        service.configGenerator = { installESLintConfigs: () => { }, createProjectConfig: () => { }, addNpmScripts: () => { } };
+        service.ideIntegration = { installCursorHooks: () => { }, configureVSCodeTasks: () => { } };
+        service.checkCriticalDependencies = () => { };
+        service.startEvidenceGuard = () => { };
+
+        process.env.HOOK_INSTALL_MODE = 'vendored';
+
+        await service.run();
+
+        expect(fsInstaller.copySystemFiles).toHaveBeenCalled();
+    });
+});

package/scripts/hooks-system/bin/cli.js

@@ -432,7 +432,11 @@ const commands = {
 
   'gitflow': () => {
     const subcommand = args[0] || 'check';
-    execFileSync('bash', [path.join(HOOKS_ROOT, 'infrastructure/shell/gitflow-enforcer.sh'), subcommand], { stdio: 'inherit' });
+    let enforcerPath = path.join(HOOKS_ROOT, 'infrastructure/shell/gitflow/gitflow-enforcer.sh');
+    if (!fs.existsSync(enforcerPath)) {
+      enforcerPath = path.join(HOOKS_ROOT, 'infrastructure/shell/gitflow-enforcer.sh');
+    }
+    execFileSync('bash', [enforcerPath, subcommand], { stdio: 'inherit' });
   },
 
   'intent': () => {

package/scripts/hooks-system/bin/gitflow

@@ -6,7 +6,11 @@
 # =============================================================================
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ENFORCER="${SCRIPT_DIR}/../infrastructure/shell/gitflow-enforcer.sh"
+ENFORCER="${SCRIPT_DIR}/../infrastructure/shell/gitflow/gitflow-enforcer.sh"
+
+if [[ ! -f "$ENFORCER" ]]; then
+  ENFORCER="${SCRIPT_DIR}/../infrastructure/shell/gitflow-enforcer.sh"
+fi
 
 if [[ ! -f "$ENFORCER" ]]; then
   echo "❌ Error: gitflow-enforcer.sh not found"
@@ -14,4 +18,17 @@ if [[ ! -f "$ENFORCER" ]]; then
   exit 1
 fi
 
-bash "$ENFORCER" "${1:-check}"
+SUBCOMMAND="${1:-check}"
+case "$SUBCOMMAND" in
+  status)
+    SUBCOMMAND="check"
+    ;;
+  workflow)
+    SUBCOMMAND="cycle"
+    ;;
+  reset)
+    SUBCOMMAND="cleanup"
+    ;;
+esac
+
+bash "$ENFORCER" "$SUBCOMMAND"

package/scripts/hooks-system/bin/install.js

@@ -1,8 +1,15 @@
 #!/usr/bin/env node
 
-const env = require('../config/env');
 const InstallService = require('../application/services/installation/InstallService');
 
+const args = process.argv.slice(2);
+if (args.includes('--vendored') || args.includes('--embedded')) {
+  process.env.HOOK_INSTALL_MODE = 'vendored';
+}
+if (args.includes('--npm-runtime') || args.includes('--npm')) {
+  process.env.HOOK_INSTALL_MODE = 'npm';
+}
+
 // Run installation
 const installer = new InstallService();
 installer.run().catch(error => {

package/scripts/hooks-system/infrastructure/ast/ios/detectors/__tests__/ios-encapsulation-public-mutable.spec.js

@@ -12,6 +12,22 @@ describe('ios.encapsulation.public_mutable', () => {
         };
     }
 
+    it('does not flag public private(set) stored property', () => {
+        const analyzer = makeAnalyzer();
+        const node = {
+            'key.name': 'state',
+            'key.line': 10,
+            'key.kind': 'source.lang.swift.decl.var.instance',
+            'key.accessibility': 'source.lang.swift.accessibility.public'
+        };
+
+        analyzer.getAttributes = () => ['setter_access.private'];
+
+        analyzePropertyAST(analyzer, node, '/tmp/Foo.swift');
+
+        expect(analyzer.findings.find(f => f.ruleId === 'ios.encapsulation.public_mutable')).toBeUndefined();
+    });
+
     it('does not flag public computed get-only property', () => {
         const analyzer = makeAnalyzer();
         const node = {

package/scripts/hooks-system/infrastructure/ast/ios/detectors/ios-ast-intelligent-strategies.js

@@ -457,7 +457,8 @@ function analyzePropertyAST(analyzer, node, filePath) {
     const isComputed = hasAccessorGet || hasAccessorSet;
     const isMutable = isComputed ? hasAccessorSet : true;
 
-    if (isPublic && isInstance && isMutable && !attributes.includes('setter_access')) {
+    const hasSetterAccessRestriction = attributes.some(a => String(a).startsWith('setter_access'));
+    if (isPublic && isInstance && isMutable && !hasSetterAccessRestriction) {
         analyzer.pushFinding('ios.encapsulation.public_mutable', 'medium', filePath, line, `Public mutable property '${name}' - consider private(set)`);
     }
 }

package/scripts/hooks-system/infrastructure/git-hooks/pre-push

@@ -19,7 +19,12 @@ echo ""
 echo "🔍 Validating Git Flow compliance before push..."
 echo ""
 
-if ! bash "${HOOKS_SYSTEM_ROOT}/infrastructure/shell/gitflow-enforcer.sh" check; then
+ENFORCER_SCRIPT="${HOOKS_SYSTEM_ROOT}/infrastructure/shell/gitflow/gitflow-enforcer.sh"
+if [[ ! -f "$ENFORCER_SCRIPT" ]]; then
+  ENFORCER_SCRIPT="${HOOKS_SYSTEM_ROOT}/infrastructure/shell/gitflow-enforcer.sh"
+fi
+
+if ! bash "$ENFORCER_SCRIPT" check; then
   echo ""
   echo "🚨 PUSH BLOCKED: Complete Git Flow cycle first"
   echo ""

package/scripts/hooks-system/infrastructure/mcp/ast-intelligence-automation.js

@@ -2432,7 +2432,7 @@ async function handleMcpMessage(message) {
                     result = suggestHumanIntent();
                     break;
                 case 'pre_flight_check':
-                    result = preFlightCheck(toolParams);
+                    result = await preFlightCheck(toolParams);
                     break;
                 case 'record_test_created':
                     result = recordTestCreated(toolParams);

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

@@ -109,3 +109,15 @@
 {"timestamp":"2026-01-14T10:53:47.998Z","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-14T10:53:47.999Z","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-14T10:53:47.999Z","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-14T19:41:36.274Z","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-14T19:41:36.275Z","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-14T19:41:36.275Z","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-14T22:24:01.361Z","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-14T22:24:01.362Z","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-14T22:24:01.362Z","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-15T07:43:06.798Z","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:43:06.800Z","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:43:06.800Z","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-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)"}}