pumuki 6.3.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 @Pumiki Team - AST Intelligence Project
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,370 @@
+# Pumuki AST Intelligence Framework
+
+[![Version](https://img.shields.io/badge/version-6.3.7-1d4ed8)](package.json)
+[![License](https://img.shields.io/badge/license-MIT-16a34a)](LICENSE)
+[![Build](https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/actions/workflows/ci.yml/badge.svg)](https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/actions/workflows/ci.yml)
+[![Node](https://img.shields.io/badge/node-%3E%3D18-0ea5e9)](package.json)
+[![Evidence](https://img.shields.io/badge/evidence-v2.1-7c3aed)](docs/evidence-v2.1.md)
+
+<img src="assets/logo.png" alt="Pumuki" width="100%" />
+
+Enterprise governance for AI-assisted code delivery.
+
+Pumuki turns code changes into traceable and reproducible decisions:
+
+`Facts -> Rules -> Gate -> ai_evidence v2.1`
+
+This gives enterprise teams one deterministic source of truth to decide what is blocked, what is warned, and why, both locally and in CI.
+
+## Table of contents
+
+- [Why Pumuki](#why-pumuki)
+- [Quick Start](#quick-start)
+- [Automated vs Manual Operations](#automated-vs-manual-operations)
+- [Software Lifecycle](#software-lifecycle)
+- [Command Reference](#command-reference)
+- [MCP: JSON Installation and Configuration](#mcp-json-installation-and-configuration)
+- [Architecture and Design Philosophy](#architecture-and-design-philosophy)
+- [Contributing and Support](#contributing-and-support)
+- [References](#references)
+
+## Why Pumuki
+
+### Real problem in large teams
+
+- Inconsistent quality checks between local and CI.
+- Hard-to-audit technical decisions.
+- Configuration drift across platforms.
+- Operational incidents without reproducible evidence.
+
+### What Pumuki solves
+
+- Stage-aware gate policies (`PRE_COMMIT`, `PRE_PUSH`, `CI`).
+- Versioned and locked rule bundles (`skills.lock.json`).
+- Deterministic evidence contract (`.ai_evidence.json`).
+- Operational runbooks for triage, closure, and handoff.
+
+### Where it fits best
+
+- Multi-platform repositories (`ios`, `backend`, `frontend`, `android`).
+- Teams with compliance/audit requirements.
+- High-change environments with AI-assisted development.
+
+## Quick Start
+
+### Prerequisites
+
+- `Node.js >= 18.0.0`
+- `npm >= 9.0.0`
+- `git`
+
+### Installation
+
+```bash
+git clone https://github.com/SwiftEnProfundidad/ast-intelligence-hooks.git
+cd ast-intelligence-hooks
+npm ci
+```
+
+### Minimal verification
+
+```bash
+npm run typecheck
+npm run test:deterministic
+npm run validation:package-manifest
+```
+
+### First run
+
+```bash
+npm run framework:menu
+```
+
+## Automated vs Manual Operations
+
+### Automated path (default)
+
+The core lifecycle is automated:
+
+- facts extraction,
+- rules evaluation,
+- stage-aware gate decision,
+- `ai_evidence v2.1` generation,
+- CI workflow execution.
+
+### Manual path (intentional)
+
+`validation:*` commands are operational controls for:
+
+- triage,
+- closure,
+- handoff,
+- adapter diagnostics,
+- rollout guardrails.
+
+Examples:
+
+- `validation:consumer-startup-triage`
+- `validation:phase5-execution-closure`
+- `validation:phase8:*`
+- `validation:adapter-*`
+
+Practical rule:
+
+- normal development: automated pipeline + tests,
+- incident/rollout handling: manual runbook commands.
+
+## Software Lifecycle
+
+### Consumer package install (enterprise UX)
+
+```bash
+npm install --save-exact pumuki
+npm update pumuki
+npm uninstall pumuki
+```
+
+`npm upgrade pumuki` is also supported as an alias to update in npm environments where `upgrade` is mapped.
+
+### Installation (fresh setup)
+
+```bash
+npm ci
+npm run typecheck
+npm run test:deterministic
+npm run skills:lock:check
+```
+
+### Upgrade
+
+```bash
+git pull
+npm ci
+npm run skills:lock:check
+npm run validation:docs-hygiene
+npm run test:deterministic
+```
+
+### Uninstall (local cleanup)
+
+```bash
+rm -rf node_modules
+rm -rf .audit-reports
+```
+
+If legacy guards are active:
+
+```bash
+npm run ast:guard:stop
+```
+
+For consumer repositories using the package:
+
+```bash
+npx --yes pumuki remove
+```
+
+This command also prunes orphan `node_modules/.package-lock.json` residue when no installed modules remain.
+
+### Dependency conflict troubleshooting
+
+| Symptom | Typical root cause | Recommended action |
+| --- | --- | --- |
+| local differs from CI | skills lock drift | `npm run skills:lock:check` |
+| `tsx` fails to start | incompatible Node runtime | upgrade to `Node >= 18` |
+| upgrade regressions | inconsistent lockfile/modules | `rm -rf node_modules package-lock.json && npm install` |
+| noisy docs/artifacts | stale `.audit-reports` outputs | `npm run validation:clean-artifacts -- --dry-run` |
+
+## Command Reference
+
+Flag forwarding pattern:
+
+```bash
+npm run <script> -- <flags>
+```
+
+### Core, CLI, and framework
+
+| Command | Description | Example |
+| --- | --- | --- |
+| `npm run install-hooks` | Install managed Pumuki hooks (`pre-commit`, `pre-push`) | `npm run install-hooks` |
+| `npm run check-version` | Print lifecycle/runtime status | `npm run check-version` |
+| `npm run pumuki:install` | Install managed hooks in current Git repo | `npm run pumuki:install` |
+| `npm run pumuki:uninstall` | Uninstall managed hooks and purge untracked Pumuki artifacts | `npm run pumuki:uninstall` |
+| `npm run pumuki:remove` | One-command cleanup + package removal from consumer repo | `npm run pumuki:remove` |
+| `npm run pumuki:update` | Update Pumuki dependency to latest and re-apply hooks | `npm run pumuki:update` |
+| `npm run pumuki:doctor` | Enterprise baseline safety checks (tracked `node_modules`, hook/state drift) | `npm run pumuki:doctor` |
+| `npm run pumuki:status` | Lifecycle status snapshot | `npm run pumuki:status` |
+| `npm run audit` | Run AST CLI | `npm run audit -- --help` |
+| `npm run ast` | AST CLI alias | `npm run ast -- --help` |
+| `npm run framework:menu` | Launch interactive operations menu | `npm run framework:menu` |
+| `npm run mcp:evidence` | Start read-only MCP evidence server | `npm run mcp:evidence` |
+| `npm run violations` | Violations CLI | `npm run violations -- --help` |
+| `npm run violations:list` | List violations | `npm run violations:list` |
+| `npm run violations:show` | Show one violation | `npm run violations:show -- <id>` |
+| `npm run violations:summary` | Aggregated violations summary | `npm run violations:summary` |
+| `npm run violations:top` | Top violations view | `npm run violations:top` |
+
+### Quality and testing
+
+| Command | Description | Example |
+| --- | --- | --- |
+| `npm run typecheck` | TypeScript check without emit | `npm run typecheck` |
+| `npm run test` | Main Jest test suite | `npm run test` |
+| `npm run test:evidence` | Evidence-specific tests | `npm run test:evidence` |
+| `npm run test:mcp` | MCP tests | `npm run test:mcp` |
+| `npm run test:heuristics` | AST heuristics tests | `npm run test:heuristics` |
+| `npm run test:stage-gates` | Stage policy/gate tests | `npm run test:stage-gates` |
+| `npm run test:deterministic` | Recommended deterministic baseline | `npm run test:deterministic` |
+| `npm run validation:package-manifest` | Validate package manifest contract | `npm run validation:package-manifest` |
+| `npm run validation:package-smoke` | Blocking package smoke test | `npm run validation:package-smoke` |
+| `npm run validation:package-smoke:minimal` | Minimal package smoke test | `npm run validation:package-smoke:minimal` |
+| `npm run validation:lifecycle-smoke` | Lifecycle smoke check (`install -> run -> uninstall` clean round-trip) | `npm run validation:lifecycle-smoke` |
+| `npm run validation:docs-hygiene` | Documentation guardrail checks | `npm run validation:docs-hygiene` |
+| `npm run validation:clean-artifacts -- --dry-run` | Simulated artifact cleanup | `npm run validation:clean-artifacts -- --dry-run` |
+| `npm run skills:compile` | Compile skills lock | `npm run skills:compile` |
+| `npm run skills:lock:check` | Verify skills lock freshness | `npm run skills:lock:check` |
+
+### Consumer diagnostics and support
+
+| Command | Main flags | Example |
+| --- | --- | --- |
+| `validation:consumer-ci-artifacts` | `--repo --limit --out` | `npm run validation:consumer-ci-artifacts -- --repo <owner>/<repo> --limit 20 --out .audit-reports/consumer-triage/consumer-ci-artifacts-report.md` |
+| `validation:consumer-ci-auth-check` | `--repo --out` | `npm run validation:consumer-ci-auth-check -- --repo <owner>/<repo> --out .audit-reports/consumer-triage/consumer-ci-auth-check.md` |
+| `validation:consumer-workflow-lint` | `--repo-path --actionlint-bin --out` | `npm run validation:consumer-workflow-lint -- --repo-path /path/repo --actionlint-bin /tmp/actionlint --out .audit-reports/consumer-triage/consumer-workflow-lint-report.md` |
+| `validation:consumer-support-bundle` | `--repo --limit --out` | `npm run validation:consumer-support-bundle -- --repo <owner>/<repo> --limit 20 --out .audit-reports/consumer-triage/consumer-startup-failure-support-bundle.md` |
+| `validation:consumer-support-ticket-draft` | `--repo --support-bundle --auth-report --out` | `npm run validation:consumer-support-ticket-draft -- --repo <owner>/<repo> --support-bundle .audit-reports/consumer-triage/consumer-startup-failure-support-bundle.md --auth-report .audit-reports/consumer-triage/consumer-ci-auth-check.md --out .audit-reports/consumer-triage/consumer-support-ticket-draft.md` |
+| `validation:consumer-startup-unblock-status` | `--repo --support-bundle --auth-report --workflow-lint-report --out` | `npm run validation:consumer-startup-unblock-status -- --repo <owner>/<repo> --support-bundle .audit-reports/consumer-triage/consumer-startup-failure-support-bundle.md --auth-report .audit-reports/consumer-triage/consumer-ci-auth-check.md --workflow-lint-report .audit-reports/consumer-triage/consumer-workflow-lint-report.md --out .audit-reports/consumer-triage/consumer-startup-unblock-status.md` |
+| `validation:consumer-startup-triage` | `--repo --out-dir [--skip-workflow-lint]` | `npm run validation:consumer-startup-triage -- --repo SwiftEnProfundidad/pumuki-actions-healthcheck-temp --out-dir .audit-reports/consumer-triage-temp --skip-workflow-lint` |
+
+### Phase 5 (closure and handoff)
+
+| Command | Main flags | Example |
+| --- | --- | --- |
+| `validation:phase5-blockers-readiness` | `--consumer-triage-report --out [--require-adapter-report --adapter-report]` | `npm run validation:phase5-blockers-readiness -- --consumer-triage-report .audit-reports/consumer-triage/consumer-startup-triage-report.md --out .audit-reports/phase5/phase5-blockers-readiness.md` |
+| `validation:phase5-execution-closure-status` | `--phase5-blockers-report --consumer-unblock-report --out` | `npm run validation:phase5-execution-closure-status -- --phase5-blockers-report .audit-reports/phase5/phase5-blockers-readiness.md --consumer-unblock-report .audit-reports/consumer-triage/consumer-startup-unblock-status.md --out .audit-reports/phase5/phase5-execution-closure-status.md` |
+| `validation:phase5-execution-closure` | `--repo --out-dir [--mock-consumer] [--skip-workflow-lint] [--skip-auth-preflight]` | `npm run validation:phase5-execution-closure -- --repo SwiftEnProfundidad/pumuki-actions-healthcheck-temp --out-dir .audit-reports/phase5 --mock-consumer` |
+| `validation:phase5-external-handoff` | `--repo [--require-mock-ab-report] [--require-artifact-urls] [--artifact-url] [--out]` | `npm run validation:phase5-external-handoff -- --repo SwiftEnProfundidad/pumuki-actions-healthcheck-temp --require-mock-ab-report` |
+| `validation:phase5-latest:refresh` | shell script | `npm run validation:phase5-latest:refresh` |
+| `validation:phase5-latest:sync-docs` | shell script | `npm run validation:phase5-latest:sync-docs` |
+| `validation:phase5-latest:ready-check` | shell script | `npm run validation:phase5-latest:ready-check` |
+| `validation:phase5-post-support:refresh` | shell script | `npm run validation:phase5-post-support:refresh` |
+
+### Phase 8 (operations, anti-loop, status)
+
+| Command | Main flags | Example |
+| --- | --- | --- |
+| `validation:phase8:resume-after-billing` | shell script | `npm run validation:phase8:resume-after-billing` |
+| `validation:phase8:next-step` | shell script | `npm run validation:phase8:next-step` |
+| `validation:phase8:doctor` | shell script | `npm run validation:phase8:doctor` |
+| `validation:phase8:autopilot` | shell script | `npm run validation:phase8:autopilot` |
+| `validation:phase8:status-pack` | shell script | `npm run validation:phase8:status-pack` |
+| `validation:phase8:tick` | shell script | `npm run validation:phase8:tick` |
+| `validation:phase8:loop-guard` | shell script | `npm run validation:phase8:loop-guard` |
+| `validation:phase8:loop-guard-coverage` | shell script | `npm run validation:phase8:loop-guard-coverage` |
+| `validation:phase8:mark-followup-state` | `<ticket_id> <posted_by> <POSTED_WAITING_REPLY|SUPPORT_REPLIED> [posted_at] [reply_at] [summary]` | `npm run validation:phase8:mark-followup-state -- 4077449 juancarlosmerlosalbarracin POSTED_WAITING_REPLY` |
+| `validation:phase8:mark-followup-posted-now` | `<posted_by> [ticket_id] [posted_at]` | `npm run validation:phase8:mark-followup-posted-now -- juancarlosmerlosalbarracin 4077449` |
+| `validation:phase8:mark-followup-replied-now` | `<posted_by> <summary> [ticket_id] [posted_at] [reply_at]` | `npm run validation:phase8:mark-followup-replied-now -- juancarlosmerlosalbarracin "support replied" 4077449` |
+| `validation:phase8:ready-handoff` | shell script | `npm run validation:phase8:ready-handoff` |
+| `validation:phase8:close-ready` | shell script | `npm run validation:phase8:close-ready` |
+
+### Adapter readiness and legacy compatibility
+
+| Command | Description |
+| --- | --- |
+| `validation:adapter-session-status` | Build adapter session status report |
+| `validation:adapter-real-session-report` | Build adapter real-session report |
+| `validation:adapter-readiness` | Build final adapter readiness report |
+| `validate:adapter-hooks-local` | Validate legacy local adapter runtime |
+| `print:adapter-hooks-config` | Print legacy adapter hook config |
+| `install:adapter-hooks-config` | Install legacy adapter hook config |
+| `verify:adapter-hooks-runtime` | Verify legacy adapter runtime |
+| `assess:adapter-hooks-session` | Assess legacy adapter session |
+| `assess:adapter-hooks-session:any` | Assess legacy adapter session including simulated events |
+
+## MCP: JSON Installation and Configuration
+
+### Is MCP mandatory to use Pumuki?
+
+No.
+
+- Pumuki core does not require MCP JSON registration.
+- MCP is optional and only needed for external MCP/agent clients.
+
+### MCP JSON example
+
+```json
+{
+  "mcpServers": {
+    "pumuki-evidence": {
+      "command": "npm",
+      "args": ["run", "mcp:evidence"],
+      "cwd": "/absolute/path/to/ast-intelligence-hooks"
+    }
+  }
+}
+```
+
+Start locally:
+
+```bash
+npm run mcp:evidence
+```
+
+## Architecture and Design Philosophy
+
+### Deterministic architecture
+
+`Facts -> Rules -> Gate -> ai_evidence v2.1`
+
+This deterministic flow is the backbone of reproducibility and governance.
+
+### Stage-aware policy model
+
+Each stage has an explicit tolerance profile:
+
+- `PRE_COMMIT`: immediate developer feedback,
+- `PRE_PUSH`: stronger repository-level protection,
+- `CI`: strict release-grade enforcement.
+
+### Platform-aware by default
+
+Pumuki detects platform scope and applies relevant packs:
+
+- iOS,
+- Backend,
+- Frontend,
+- Android.
+
+### Rule-pack governance
+
+- Rule packs are versioned.
+- Skills bundles are locked.
+- Drift detection is first-class.
+
+### Evidence-first operations
+
+Operational decisions are backed by deterministic artifacts, not tribal memory.
+
+## Contributing and Support
+
+### Contributing
+
+1. Branch from `develop`.
+2. Keep changes scoped and deterministic.
+3. Update docs/runbooks when behavior changes.
+4. Open a PR with clear context and impact.
+
+### Issues and support
+
+- Bug reports: open a GitHub issue with reproducible context.
+- Operational incidents: use `docs/validation/*` runbooks and artifacts.
+- Architecture questions: start from `docs/ARCHITECTURE.md` and `docs/evidence-v2.1.md`.
+
+## References
+
+- `PUMUKI.md`
+- `docs/ARCHITECTURE.md`
+- `docs/evidence-v2.1.md`
+- `docs/MCP_EVIDENCE_CONTEXT_SERVER.md`
+- `docs/validation/README.md`

package/VERSION

@@ -0,0 +1 @@
+v6.3.3

package/assets/ast_intelligence_01.svg

@@ -0,0 +1,40 @@
+
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="900" viewBox="0 0 1600 900" role="img" aria-label="AST Intelligence System Overview">
+  <defs>
+    <style>
+      .bg { fill: #0b0f14; }
+      .panel { fill: #0f1620; stroke: #1f2a37; stroke-width: 2; }
+      .title { fill: #7dd3fc; font: 700 40px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .sub { fill: #a7f3d0; font: 600 22px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .txt { fill: #e5e7eb; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .muted { fill: #9ca3af; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .accent { fill: #fbbf24; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .ok { fill: #34d399; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .warn { fill: #f59e0b; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+    </style>
+  </defs>
+
+  <rect class="bg" x="0" y="0" width="1600" height="900" />
+  <rect class="panel" x="40" y="40" width="1520" height="820" rx="18" />
+
+  <text class="title" x="80" y="115">PUMUKI — Hook-System (run: npx ast-hooks)</text>
+  <text class="sub" x="80" y="160">AST Intelligence System Overview</text>
+
+  <text class="txt" x="80" y="230">1) Pattern checks</text>
+  <text class="txt" x="80" y="265">2) ESLint audits</text>
+  <text class="txt" x="80" y="300">3) AST Intelligence analysis</text>
+  <text class="txt" x="80" y="335">4) Intelligent Audit Gate (block/allow)</text>
+  <text class="txt" x="80" y="370">5) Evidence update (.AI_EVIDENCE.json)</text>
+
+  <text class="muted" x="80" y="435">Pipeline</text>
+  <text class="accent" x="80" y="470">Source files → AST analyzers → violations → severity evaluation → AI Gate verdict</text>
+
+  <text class="muted" x="80" y="535">Outputs</text>
+  <text class="txt" x="80" y="570">• .audit_tmp/ast-summary.json</text>
+  <text class="txt" x="80" y="605">• .audit_tmp/ast-summary-enhanced.json</text>
+  <text class="txt" x="80" y="640">• reports/ (json + text)</text>
+  <text class="txt" x="80" y="675">• .AI_EVIDENCE.json (ai_gate + metrics)</text>
+
+  <text class="warn" x="80" y="750">Rule: Fail fast, block early</text>
+  <text class="ok" x="80" y="785">Goal: deterministic governance across iOS / Android / Backend / Frontend</text>
+</svg>

package/assets/ast_intelligence_02.svg

@@ -0,0 +1,39 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="900" viewBox="0 0 1600 900" role="img" aria-label="AST Intelligence Workflow">
+  <defs>
+    <style>
+      .bg { fill: #0b0f14; }
+      .panel { fill: #0f1620; stroke: #1f2a37; stroke-width: 2; }
+      .h { fill: #a7f3d0; font: 700 26px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .t { fill: #e5e7eb; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .m { fill: #9ca3af; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .accent { fill: #fbbf24; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .warn { fill: #f59e0b; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+    </style>
+  </defs>
+
+  <rect class="bg" x="0" y="0" width="1600" height="900" />
+  <rect class="panel" x="40" y="40" width="1520" height="820" rx="18" />
+
+  <text class="h" x="80" y="120">QUICK SUMMARY</text>
+
+  <text class="t" x="80" y="190">Files scanned:          269</text>
+  <text class="t" x="80" y="220">Total violations:       69</text>
+  <text class="t" x="80" y="250">ESLint errors:          0</text>
+  <text class="t" x="80" y="280">Critical issues:        3</text>
+  <text class="t" x="80" y="310">High priority:          38</text>
+
+  <text class="warn" x="80" y="365">⚠ STATUS: ACTION REQUIRED</text>
+  <text class="accent" x="80" y="395">Critical or high-severity issues detected</text>
+
+  <text class="h" x="80" y="465">1) PATTERN CHECKS</text>
+  <text class="t" x="110" y="510">• TODO / FIXME: 4</text>
+  <text class="t" x="110" y="540">• CONSOLE_LOG: 205</text>
+  <text class="t" x="110" y="570">• ANY TYPE: 8</text>
+  <text class="t" x="110" y="600">• SQL_RAW: 3</text>
+
+  <text class="h" x="80" y="670">2) ESLINT AUDIT RESULTS</text>
+  <text class="t" x="110" y="715">ESLint: errors=0  warnings=0</text>
+
+  <text class="h" x="80" y="785">3) AST INTELLIGENCE — SEVERITY BREAKDOWN</text>
+  <text class="m" x="110" y="830">Staging Area: no staged files to analyze</text>
+</svg>

package/assets/ast_intelligence_03.svg

@@ -0,0 +1,55 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="900" viewBox="0 0 1600 900" role="img" aria-label="AST Intelligence Audit - Part 1">
+  <defs>
+    <style>
+      .bg { fill: #0b0f14; }
+      .panel { fill: #0f1620; stroke: #1f2a37; stroke-width: 2; }
+      .h { fill: #a7f3d0; font: 700 24px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .t { fill: #e5e7eb; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .muted { fill: #9ca3af; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .sevC { fill: #fb7185; }
+      .sevH { fill: #f59e0b; }
+      .sevM { fill: #fbbf24; }
+      .sevL { fill: #60a5fa; }
+      .dot { stroke: #1f2a37; stroke-width: 2; }
+    </style>
+  </defs>
+
+  <rect class="bg" x="0" y="0" width="1600" height="900" />
+  <rect class="panel" x="40" y="40" width="1520" height="820" rx="18" />
+
+  <text class="h" x="80" y="120">Platform: iOS</text>
+  <circle class="sevC dot" cx="95" cy="160" r="10" /><text class="t" x="120" y="166">CRITICAL: 2</text>
+  <circle class="sevH dot" cx="260" cy="160" r="10" /><text class="t" x="285" y="166">HIGH: 15</text>
+  <circle class="sevM dot" cx="395" cy="160" r="10" /><text class="t" x="420" y="166">MEDIUM: 6</text>
+  <circle class="sevL dot" cx="555" cy="160" r="10" /><text class="t" x="580" y="166">LOW: 13</text>
+
+  <text class="muted" x="80" y="210">Files affected: 1</text>
+  <text class="t" x="80" y="250">Top violations:</text>
+  <text class="t" x="110" y="285">ios.quality.long_function: 3</text>
+  <text class="t" x="110" y="315">ios.solid.isp.unused_dependency: 2</text>
+  <text class="t" x="110" y="345">ios.concurrency.missing_actor: 2</text>
+  <text class="t" x="110" y="375">ios.force_unwrapping: 2</text>
+  <text class="t" x="110" y="405">ios.uikit.viewmodel_delegation: 1</text>
+
+  <text class="h" x="80" y="500">Platform: Android</text>
+  <circle class="sevC dot" cx="95" cy="540" r="10" /><text class="t" x="120" y="546">CRITICAL: 0</text>
+  <circle class="sevH dot" cx="260" cy="540" r="10" /><text class="t" x="285" y="546">HIGH: 8</text>
+  <circle class="sevM dot" cx="395" cy="540" r="10" /><text class="t" x="420" y="546">MEDIUM: 8</text>
+  <circle class="sevL dot" cx="555" cy="540" r="10" /><text class="t" x="580" y="546">LOW: 1</text>
+
+  <text class="t" x="80" y="610">Top violations:</text>
+  <text class="t" x="110" y="645">android.asynctask: 2</text>
+  <text class="t" x="110" y="675">android.di.missing_android_entry_point: 1</text>
+  <text class="t" x="110" y="705">android.networking.missing_error_handling: 1</text>
+  <text class="t" x="110" y="735">android.coroutines.missing_lifecycle_scope: 1</text>
+
+  <text class="h" x="920" y="500">Platform: Other</text>
+  <circle class="sevC dot" cx="935" cy="540" r="10" /><text class="t" x="960" y="546">CRITICAL: 0</text>
+  <circle class="sevH dot" cx="1100" cy="540" r="10" /><text class="t" x="1125" y="546">HIGH: 2</text>
+  <circle class="sevM dot" cx="1235" cy="540" r="10" /><text class="t" x="1260" y="546">MEDIUM: 0</text>
+  <circle class="sevL dot" cx="1395" cy="540" r="10" /><text class="t" x="1420" y="546">LOW: 0</text>
+
+  <text class="t" x="920" y="610">Top violations:</text>
+  <text class="t" x="950" y="645">workflow.tdd.low_test_coverage: 1</text>
+  <text class="t" x="950" y="675">workflow.sequence.tests_lagging: 1</text>
+</svg>

package/assets/ast_intelligence_04.svg

@@ -0,0 +1,39 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="900" viewBox="0 0 1600 900" role="img" aria-label="AST Intelligence Audit - Part 2">
+  <defs>
+    <style>
+      .bg { fill: #0b0f14; }
+      .panel { fill: #0f1620; stroke: #1f2a37; stroke-width: 2; }
+      .h { fill: #a7f3d0; font: 700 24px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .t { fill: #e5e7eb; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .muted { fill: #9ca3af; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+    </style>
+  </defs>
+
+  <rect class="bg" x="0" y="0" width="1600" height="900" />
+  <rect class="panel" x="40" y="40" width="1520" height="820" rx="18" />
+
+  <text class="h" x="80" y="120">5) TOP VIOLATIONS &amp; REMEDIATION</text>
+
+  <text class="t" x="80" y="200">• common.types.any (8 violations)</text>
+  <text class="muted" x="110" y="235">→ Review and fix violations.</text>
+
+  <text class="t" x="80" y="285">• ios.quality.long_function (3 violations)</text>
+  <text class="muted" x="110" y="320">→ Review and fix violations.</text>
+
+  <text class="t" x="80" y="370">• android.asynctask (2 violations)</text>
+  <text class="muted" x="110" y="405">→ Review and fix violations.</text>
+
+  <text class="t" x="80" y="455">• common.network.missing_timeout (2 violations)</text>
+  <text class="muted" x="110" y="490">→ Review and fix violations.</text>
+
+  <text class="t" x="80" y="540">• common.network.missing_error_handling (2 violations)</text>
+  <text class="muted" x="110" y="575">→ Review and fix violations.</text>
+
+  <text class="t" x="80" y="625">• ios.solid.isp.unused_dependency (2 violations)</text>
+  <text class="muted" x="110" y="660">→ Review and fix violations.</text>
+
+  <text class="t" x="80" y="710">• ios.concurrency.missing_actor (2 violations)</text>
+  <text class="muted" x="110" y="745">→ Review and fix violations.</text>
+
+  <text class="h" x="80" y="830">6) EXECUTIVE SUMMARY</text>
+</svg>

package/assets/ast_intelligence_05.svg

@@ -0,0 +1,45 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="900" viewBox="0 0 1600 900" role="img" aria-label="AST Intelligence Audit - Part 3">
+  <defs>
+    <style>
+      .bg { fill: #0b0f14; }
+      .panel { fill: #0f1620; stroke: #1f2a37; stroke-width: 2; }
+      .h { fill: #a7f3d0; font: 700 24px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .t { fill: #e5e7eb; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .muted { fill: #9ca3af; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .errBox { fill: none; stroke: #fb7185; stroke-width: 3; }
+      .err { fill: #fb7185; font: 18px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; }
+      .sevC { fill: #fb7185; }
+      .sevH { fill: #f59e0b; }
+      .sevM { fill: #fbbf24; }
+      .sevL { fill: #60a5fa; }
+      .dot { stroke: #1f2a37; stroke-width: 2; }
+    </style>
+  </defs>
+
+  <rect class="bg" x="0" y="0" width="1600" height="900" />
+  <rect class="panel" x="40" y="40" width="1520" height="820" rx="18" />
+
+  <text class="h" x="80" y="120">METRICS</text>
+  <text class="t" x="80" y="170">Total violations detected: 69</text>
+  <text class="t" x="80" y="200">ESLint errors: 0</text>
+  <text class="t" x="80" y="230">Critical issues: 3</text>
+  <text class="t" x="80" y="260">High priority issues: 38</text>
+  <text class="t" x="80" y="290">Files scanned: 269</text>
+
+  <text class="muted" x="80" y="335">Code Health Score: 65% (Good)</text>
+
+  <rect class="errBox" x="80" y="370" width="1440" height="90" rx="10" />
+  <text class="err" x="110" y="425">ACTION REQUIRED: Critical or high-severity issues detected. Please review and fix before proceeding.</text>
+
+  <text class="h" x="80" y="520">FINAL SUMMARY — VIOLATIONS BY SEVERITY</text>
+
+  <circle class="sevC dot" cx="95" cy="565" r="10" /><text class="t" x="120" y="571">CRITICAL: 3</text>
+  <circle class="sevH dot" cx="95" cy="605" r="10" /><text class="t" x="120" y="611">HIGH: 38</text>
+  <circle class="sevM dot" cx="95" cy="645" r="10" /><text class="t" x="120" y="651">MEDIUM: 14</text>
+  <circle class="sevL dot" cx="95" cy="685" r="10" /><text class="t" x="120" y="691">LOW: 14</text>
+
+  <text class="muted" x="80" y="760">COMMIT BLOCKED — STRICT REPO+STAGING</text>
+  <text class="muted" x="80" y="795">Action: clean entire repository before committing.</text>
+
+  <text class="t" x="80" y="845">Generated by Pumuki — Hook-System</text>
+</svg>