@tyroneross/navgator 0.2.2 → 0.9.0

package/dist/types.d.ts

@@ -2,10 +2,11 @@
  * NavGator Type Definitions
  * Architecture connection tracking for Claude Code
  */
+import type { ExternalEnrichment } from './enrich/external-enrichment.types.js';
 /**
  * Types of architecture components that NavGator tracks
  */
-export type ComponentType = 'npm' | 'pip' | 'spm' | 'cargo' | 'go' | 'gem' | 'composer' | 'framework' | 'database' | 'queue' | 'infra' | 'service' | 'llm' | 'api-endpoint' | 'db-table' | 'prompt' | 'worker' | 'component' | 'other';
+export type ComponentType = 'npm' | 'pip' | 'spm' | 'cargo' | 'go' | 'gem' | 'composer' | 'framework' | 'database' | 'queue' | 'infra' | 'service' | 'llm' | 'config' | 'cron' | 'api-endpoint' | 'db-table' | 'prompt' | 'worker' | 'component' | 'xcode-target' | 'other';
 /**
  * Architecture layer classification
  */
@@ -28,6 +29,12 @@ export interface ConnectionRef {
  */
 export interface ArchitectureComponent {
     component_id: string;
+    /**
+     * Stable, deterministic identifier derived from type + canonical name.
+     * Format: STABLE_<type>_<slug>. Same component across scans → same stable_id.
+     * Used as the cross-scan join key for PageRank persistence, git diffs, timeline tracking.
+     */
+    stable_id?: string;
     name: string;
     version?: string;
     type: ComponentType;
@@ -49,6 +56,8 @@ export interface ArchitectureComponent {
     documentation_url?: string;
     repository_url?: string;
     metadata?: Record<string, unknown>;
+    runtime?: RuntimeIdentity;
+    external?: ExternalEnrichment;
     timestamp: number;
     last_updated: number;
 }
@@ -72,10 +81,35 @@ export interface Vulnerability {
     fixed_in?: string;
     url?: string;
 }
+/**
+ * Runtime identity annotation for architecture components.
+ * Maps code-level components to their runtime services/resources.
+ * Extracted from code and config — never from live service polling.
+ */
+export interface RuntimeIdentity {
+    /** Service/resource name as known at runtime (e.g., "email-queue", "worker") */
+    service_name?: string;
+    /** Deployment platform (vercel, railway, heroku, docker, local) */
+    platform?: string;
+    /** Parsed connection info (no secrets — just host, port, db name, protocol) */
+    endpoint?: {
+        protocol?: string;
+        host?: string;
+        port?: number;
+        database?: string;
+        path?: string;
+    };
+    /** Env var that provides the connection (e.g., "DATABASE_URL", "REDIS_URL") */
+    connection_env_var?: string;
+    /** Runtime resource type */
+    resource_type?: 'database' | 'cache' | 'queue' | 'api' | 'worker' | 'cron' | 'storage';
+    /** Provider/engine (postgres, mysql, redis, bullmq, openai, etc.) */
+    engine?: string;
+}
 /**
  * Types of connections between components
  */
-export type ConnectionType = 'api-calls-db' | 'frontend-calls-api' | 'queue-triggers' | 'service-call' | 'imports' | 'deploys-to' | 'prompt-location' | 'prompt-usage' | 'uses-package' | 'observes' | 'conforms-to' | 'notifies' | 'stores' | 'navigates-to' | 'requires-entitlement' | 'target-contains' | 'generates' | 'other';
+export type ConnectionType = 'api-calls-db' | 'frontend-calls-api' | 'queue-triggers' | 'service-call' | 'imports' | 'deploys-to' | 'env-dependency' | 'schema-relation' | 'cron-triggers' | 'queue-produces' | 'queue-consumes' | 'prompt-location' | 'prompt-usage' | 'uses-package' | 'observes' | 'conforms-to' | 'notifies' | 'stores' | 'navigates-to' | 'presents' | 'requires-entitlement' | 'target-contains' | 'build-phase-includes' | 'generates' | 'field-reference' | 'runtime-binding' | 'queue-uses-cache' | 'other';
 /**
  * Code location reference
  */
@@ -108,6 +142,10 @@ export interface ArchitectureConnection {
         line_end?: number;
         code_snippet?: string;
     };
+    semantic?: {
+        classification: 'production' | 'admin' | 'analytics' | 'test' | 'dev-only' | 'migration' | 'unknown';
+        confidence: number;
+    };
     description?: string;
     detected_from: string;
     confidence: number;
@@ -166,10 +204,39 @@ export interface ProjectMetadata {
         type: string;
         files: string[];
     }[];
+    xcodeProject?: {
+        path: string;
+        targets: {
+            name: string;
+            type: string;
+            bundleId?: string;
+        }[];
+    };
 }
+/**
+ * Scan mode types (Run 1 — D2). 'auto' is the default decision, resolved
+ * by selectScanMode to one of full/incremental/noop. 'incremental→full'
+ * is the runtime label for an incremental scan that promoted to full
+ * after an integrity-check failure.
+ */
+export type ScanType = 'full' | 'incremental' | 'incremental→full' | 'noop';
 export interface ArchitectureIndex {
+    schema_version?: string;
     version: string;
     last_scan: number;
+    /**
+     * Run 1 — D2: timestamp of the most recent FULL scan (or
+     * 'incremental→full' promote). Used by selectScanMode to enforce the
+     * staleness trigger (force full after 7 days). Optional for backward
+     * compat; selectScanMode treats `undefined` as "never had a full scan".
+     */
+    last_full_scan?: number;
+    /**
+     * Run 1 — D2: count of incremental scans since the most recent full
+     * scan. selectScanMode forces a full scan once this exceeds the cap
+     * (currently 20). Reset to 0 on every full or 'incremental→full' scan.
+     */
+    incrementals_since_full?: number;
     project_path: string;
     project?: ProjectMetadata;
     components: {
@@ -191,11 +258,77 @@ export interface ArchitectureIndex {
         outdated_count: number;
         vulnerable_count: number;
     };
+    /**
+     * Run 2 — D5: per-stratum EWMA state for defect-rate drift detection.
+     * Updated after each scan that runs an audit. Optional for backward compat.
+     * If any stratum's EWMA breaches its control limits, the next scan
+     * auto-promotes to mode='full' + audit-plan='Cochran' for tighter inspection.
+     */
+    ewma?: Record<string, EwmaStateSnapshot>;
+    /**
+     * Run 2 — D4: rolling count of audits that have run on this index. Used
+     * to switch from AQL → SPRT once history ≥ 3.
+     */
+    audit_history_count?: number;
+    /**
+     * Run 2: when the previous run's audit detected an EWMA breach, this is
+     * set so the NEXT scan can read it and auto-promote.
+     */
+    pending_drift_breach?: boolean;
+}
+/**
+ * Run 2 — snapshot of EWMA state persisted on the index. Mirrors `EwmaState`
+ * from `src/audit/spc.ts`; duplicated here so types.ts has zero runtime imports
+ * from the audit module.
+ */
+export interface EwmaStateSnapshot {
+    lambda: number;
+    L: number;
+    mean: number;
+    variance: number;
+    n: number;
+    points: number[];
+    breach_pending?: boolean;
+}
+/**
+ * Run 2 — D2 defect taxonomy.
+ */
+export type AuditDefectClass = 'HALLUCINATED_COMPONENT' | 'HALLUCINATED_EDGE' | 'WRONG_ENDPOINT' | 'STALE_REFERENCE' | 'DEDUP_COLLISION' | 'MISSED_EDGE';
+export interface AuditSampleEvidence {
+    id: string;
+    ok: boolean;
+    reason?: string;
+}
+/**
+ * Run 2 — D4: audit report attached to a TimelineEntry.
+ */
+export interface AuditReport {
+    plan: 'AQL' | 'SPRT' | 'Cochran';
+    n: number;
+    c: number;
+    sampled: number;
+    defects: number;
+    defect_rate: number;
+    by_class: Partial<Record<AuditDefectClass, {
+        sampled: number;
+        defects: number;
+    }>>;
+    by_stratum: Record<string, {
+        sampled: number;
+        defects: number;
+        defect_rate: number;
+    }>;
+    llm_skipped?: boolean;
+    verdict: 'accept' | 'reject' | 'continue';
+    drift_breach?: boolean;
+    timestamp: number;
+    defect_evidence?: AuditSampleEvidence[];
 }
 /**
  * Full connection graph (for visualization/analysis)
  */
 export interface ConnectionGraph {
+    schema_version?: string;
     nodes: GraphNode[];
     edges: GraphEdge[];
     metadata: {
@@ -206,6 +339,7 @@ export interface ConnectionGraph {
 }
 export interface GraphNode {
     id: string;
+    stable_id?: string;
     name: string;
     type: ComponentType;
     layer: ArchitectureLayer;
@@ -242,11 +376,18 @@ export interface DetectionPattern {
     connection_type: ConnectionType;
     extract_target: (match: RegExpMatchArray) => string | null;
 }
+export interface GitInfo {
+    branch: string;
+    commit: string;
+    commitFull?: string;
+}
+export type ImpactSeverity = 'critical' | 'high' | 'medium' | 'low';
 /**
  * Impact analysis result
  */
 export interface ImpactAnalysis {
     component: ArchitectureComponent;
+    severity: ImpactSeverity;
     affected: AffectedComponent[];
     total_files_affected: number;
     summary: string;
@@ -272,12 +413,42 @@ export interface NavGatorConfig {
     scanDepth: 'shallow' | 'deep';
     defaultConfidenceThreshold: number;
     maxResultsPerQuery: number;
+    sandbox?: boolean;
+    /**
+     * When true, scan writes one JSON file per component and per connection
+     * under `<storage>/components/` and `<storage>/connections/`. Default is
+     * `false` — the consolidated `graph.json`, `index.json`, `connections.jsonl`,
+     * and `reverse-deps.json` files are the source of truth and the per-entity
+     * files duplicate ~70MB of data on large projects (R6 fix).
+     *
+     * Override via env: `NAVGATOR_PER_ENTITY_FILES=true` or CLI:
+     * `navgator scan --per-entity-files`.
+     *
+     * When `false` (default), the scanner also performs an idempotent migration
+     * that deletes the contents of `components/` and `connections/` on each
+     * scan. It NEVER deletes the consolidated files.
+     */
+    perEntityFiles?: boolean;
 }
 /**
  * Generate a component ID
  * Format: COMP_type_name_random
  */
 export declare function generateComponentId(type: ComponentType, name: string): string;
+/**
+ * Generate a stable, deterministic component identifier.
+ * Format: STABLE_<type>_<slug>
+ *
+ * Same (type, name) → same stable_id across scans. This is the cross-scan
+ * join key — distinct from `component_id` which carries a random suffix
+ * for legacy backward compatibility.
+ *
+ * NOTE: collisions on (type, name) are intentional — they represent the
+ * same logical component re-detected. Callers needing path-uniqueness
+ * (e.g., two `prompt`-type components in different files) should pass a
+ * canonical_path as the second argument when available.
+ */
+export declare function generateStableId(type: ComponentType, name: string, canonicalPath?: string): string;
 /**
  * Generate a connection ID
  * Format: CONN_type_random
@@ -317,4 +488,153 @@ export declare function toCompactComponent(c: ArchitectureComponent): CompactCom
  * Convert connection to compact form
  */
 export declare function toCompactConnection(c: ArchitectureConnection): CompactConnection;
+export interface SnapshotComponent {
+    component_id: string;
+    name: string;
+    type: ComponentType;
+    version?: string;
+    status: ComponentStatus;
+    layer: ArchitectureLayer;
+    critical: boolean;
+}
+export interface SnapshotConnection {
+    connection_id: string;
+    from: string;
+    to: string;
+    type: ConnectionType;
+    from_name: string;
+    to_name: string;
+    file?: string;
+}
+export interface Snapshot {
+    snapshot_id: string;
+    snapshot_version: '2.0';
+    timestamp: number;
+    reason?: string;
+    git?: GitInfo;
+    components: SnapshotComponent[];
+    connections: SnapshotConnection[];
+    stats: {
+        total_components: number;
+        total_connections: number;
+    };
+}
+export type DiffSignificance = 'major' | 'minor' | 'patch';
+export type DiffTrigger = 'layer-change' | 'high-churn' | 'new-layer' | 'new-package' | 'connection-change' | 'version-bump' | 'metadata-only';
+export interface ComponentChange {
+    name: string;
+    type: ComponentType;
+    layer: ArchitectureLayer;
+    version?: string;
+}
+export interface ComponentModification {
+    name: string;
+    type: ComponentType;
+    changes: string[];
+}
+export interface ConnectionChange {
+    from_name: string;
+    to_name: string;
+    type: ConnectionType;
+    file?: string;
+}
+export interface DiffResult {
+    components: {
+        added: ComponentChange[];
+        removed: ComponentChange[];
+        modified: ComponentModification[];
+    };
+    connections: {
+        added: ConnectionChange[];
+        removed: ConnectionChange[];
+    };
+    stats: {
+        total_changes: number;
+        components_before: number;
+        components_after: number;
+        connections_before: number;
+        connections_after: number;
+    };
+}
+export interface TimelineEntry {
+    id: string;
+    timestamp: number;
+    significance: DiffSignificance;
+    triggers: DiffTrigger[];
+    diff: DiffResult;
+    snapshot_id?: string;
+    git?: GitInfo;
+    /**
+     * Run 1 — D2: which scan mode produced this entry. 'incremental→full'
+     * is the special promote case (Run 1.6 #3 / Run 1.7 — Problem A).
+     * Optional for backward compat with timeline entries written before
+     * mode tracking shipped.
+     */
+    scan_type?: ScanType;
+    /**
+     * Run 1.6 — item #3: number of source files actually walked by the
+     * scanners. For 'incremental' this is the walk-set size (changed +
+     * reverse-deps). For 'full' (or recursive-re-entry promote per Run 1.7
+     * Problem A) this is the full source-file count. Lets agents detect
+     * a silent integrity-promote vs a true full scan by comparing
+     * scan_type and files_scanned.
+     */
+    files_scanned?: number;
+    /**
+     * Run 2 — D4: audit report from this scan's self-measurement pass.
+     * Absent when `--no-audit` was used or audit was internally skipped
+     * (e.g., empty population). Audit failures NEVER cause the scan itself
+     * to fail; only EWMA drift triggers the next scan to auto-promote.
+     */
+    audit?: AuditReport;
+}
+export interface Timeline {
+    version: '1.0';
+    project_path: string;
+    entries: TimelineEntry[];
+}
+/**
+ * Stable envelope format for machine consumers (Codex, agents, CI)
+ */
+export interface AgentEnvelope<T> {
+    schema_version: string;
+    command: string;
+    timestamp: number;
+    data: T;
+}
+/**
+ * Executive summary for agent orientation
+ */
+export interface ExecutiveSummary {
+    project_path: string;
+    timestamp: number;
+    git?: GitInfo;
+    risks: SummaryRisk[];
+    blockers: SummaryBlocker[];
+    next_actions: SummaryAction[];
+    stats: {
+        total_components: number;
+        total_connections: number;
+        outdated_count: number;
+        vulnerable_count: number;
+    };
+    components: CompactComponent[];
+    connections: CompactConnection[];
+}
+export interface SummaryRisk {
+    type: string;
+    severity: ImpactSeverity;
+    component?: string;
+    message: string;
+}
+export interface SummaryBlocker {
+    type: string;
+    component?: string;
+    message: string;
+}
+export interface SummaryAction {
+    action: string;
+    reason: string;
+    command?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -14,6 +14,59 @@ export function generateComponentId(type, name) {
     const random = Math.random().toString(36).slice(2, 6);
     return `COMP_${type}_${sanitizedName}_${random}`;
 }
+/**
+ * Slugify a name for use in a stable_id.
+ * Lowercase; keep [a-z0-9._-]; collapse runs of other chars to '-'; trim '-'.
+ * Length-cap at 64 chars to keep filenames sane.
+ */
+function slugifyForStableId(name) {
+    const raw = (name ?? '').toString();
+    const MAX = 48;
+    const filtered = raw
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    // Hash-suffix triggers — narrow to cases where input identity could
+    // genuinely be lost. Routine punctuation folding (spaces, slashes, @scopes)
+    // does NOT trigger; that would make most names noisy.
+    const hasNonAscii = /[^\u0000-\u007f]/.test(raw);
+    const wasEmpty = filtered === '';
+    const trimmed = filtered.slice(0, MAX);
+    const wasTruncated = filtered.length > MAX;
+    if (!hasNonAscii && !wasEmpty && !wasTruncated) {
+        return trimmed;
+    }
+    // FNV-1a 32-bit over original raw bytes — deterministic, dependency-free.
+    // Disambiguates non-ASCII names, empty inputs, and >48-char names that
+    // would otherwise collide after slugification (Codex audit fix).
+    let h = 0x811c9dc5;
+    for (let i = 0; i < raw.length; i++) {
+        h = (h ^ raw.charCodeAt(i)) >>> 0;
+        h = Math.imul(h, 0x01000193) >>> 0;
+    }
+    const suffix = h.toString(36).padStart(7, '0').slice(0, 7);
+    const base = trimmed || 'h';
+    return `${base}-${suffix}`;
+}
+/**
+ * Generate a stable, deterministic component identifier.
+ * Format: STABLE_<type>_<slug>
+ *
+ * Same (type, name) → same stable_id across scans. This is the cross-scan
+ * join key — distinct from `component_id` which carries a random suffix
+ * for legacy backward compatibility.
+ *
+ * NOTE: collisions on (type, name) are intentional — they represent the
+ * same logical component re-detected. Callers needing path-uniqueness
+ * (e.g., two `prompt`-type components in different files) should pass a
+ * canonical_path as the second argument when available.
+ */
+export function generateStableId(type, name, canonicalPath) {
+    const slug = canonicalPath
+        ? `${slugifyForStableId(canonicalPath)}__${slugifyForStableId(name)}`
+        : slugifyForStableId(name);
+    return `STABLE_${type}_${slug}`;
+}
 /**
  * Generate a connection ID
  * Format: CONN_type_random

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqZH,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAmB,EAAE,IAAY;IACnE,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,QAAQ,IAAI,IAAI,aAAa,IAAI,MAAM,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAoB;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,QAAQ,IAAI,IAAI,MAAM,EAAE,CAAC;AAClC,CAAC;AAkCD;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,CAAwB;IACzD,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,YAAY;QAClB,CAAC,EAAE,CAAC,CAAC,IAAI;QACT,CAAC,EAAE,CAAC,CAAC,IAAI;QACT,CAAC,EAAE,CAAC,CAAC,OAAO;QACZ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;QACf,CAAC,EAAE,CAAC,CAAC,MAAM;QACX,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM;QAC3B,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM;KACzB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAyB;IAC3D,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,aAAa;QACnB,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY;QACtB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,YAAY;QACpB,EAAE,EAAE,CAAC,CAAC,eAAe;QACrB,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI;QAC3B,GAAG,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM;QAC5B,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,WAAW;QAChC,IAAI,EAAE,CAAC,CAAC,cAAc,CAAC,UAAU;KAClC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/hooks/hooks.json

@@ -1,57 +1,3 @@
 {
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Check if NavGator architecture data exists and is fresh:\n1. Look for .claude/architecture/index.json\n2. If missing: 'This project hasn't been scanned. Run `/gator:scan` to map the architecture.'\n3. If >24h old: 'Architecture data is stale. Consider running `/gator:scan` to refresh.'\n4. If fresh: Note the component and connection counts for context.\n\nWhen architecture data exists, you should consult it BEFORE making changes to:\n- Database schemas or queries\n- API endpoints\n- External service integrations (Stripe, OpenAI, etc.)\n- Queue workers or job handlers\n- Shared utilities used across the codebase"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Before modifying this file, check if it involves architecture-critical code:\n\n1. **Database/ORM files** (prisma, drizzle, sequelize, models/): Run `/gator:impact <table-name>` to see affected APIs\n2. **API routes** (api/, routes/, controllers/): Run `/gator:connections <endpoint>` to see frontend callers\n3. **External services** (stripe, openai, twilio, sendgrid): Run `/gator:impact <service>` to see all usage locations\n4. **Queue/worker files** (workers/, jobs/, queues/): Check what triggers these and what they affect\n5. **Shared utilities** (lib/, utils/, helpers/): These often have wide impact\n\nIf the file matches any of these patterns and NavGator data exists, briefly note what else might need updating."
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Check if this command affects architecture:\n\n1. **Package install/remove** (npm install, yarn add, pip install, cargo add, go get):\n   → Run `/gator:scan --quick` to update package tracking\n\n2. **Database migrations** (prisma migrate, drizzle push, alembic, knex migrate):\n   → Run `/gator:scan` to update schema connections\n\n3. **New service setup** (stripe, supabase, firebase init):\n   → Run `/gator:scan` to detect new service connections\n\nIf the command matches, remind about updating architecture data."
-          }
-        ]
-      },
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "If you just modified an architecture-critical file (API route, database model, service integration, queue handler), note that the architecture connections may have changed. After completing the current task, consider running `/gator:scan` to update the connection map."
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "prompt",
-            "prompt": "Before finishing, if you made significant architectural changes during this session (new APIs, database changes, service integrations, refactored connections), remind the user: 'You may want to run `/gator:scan` to update the architecture map with these changes.'"
-          }
-        ]
-      }
-    ]
-  }
+  "hooks": {}
 }

package/hooks/mark-dirty.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Non-blocking PostToolUse hook: record the edited file in NavGator's dirty
+# ledger and kick a detached background drain. Returns immediately -- it never
+# delays the edit. Coalescing + the single-writer lock live in the drainer.
+set -euo pipefail
+
+# Claude Code passes tool input as JSON on stdin; extract the file path.
+INPUT="$(cat 2>/dev/null || true)"
+FILE="$(printf '%s' "$INPUT" | sed -n 's/.*"file_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)"
+
+# Only act inside a project that has a NavGator graph.
+if [ -z "$FILE" ] || [ ! -d ".navgator" ]; then
+  exit 0
+fi
+
+# `mark-dirty --drain` appends to the ledger and self-spawns a detached drain.
+if command -v navgator >/dev/null 2>&1; then
+  navgator mark-dirty "$FILE" --drain >/dev/null 2>&1 || true
+fi
+exit 0

package/hooks/post-bash-suggest.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# PostToolUse (Bash) — suggest a scan only after dep/migration/Xcode commands.
+# Silent otherwise.
+set -u
+
+project="${CLAUDE_PROJECT_DIR:-$PWD}"
+[ -f "$project/.navgator/architecture/index.json" ] || exit 0
+
+cmd=$(python3 -c '
+import sys, json
+try:
+  print(json.loads(sys.stdin.read()).get("tool_input", {}).get("command", ""))
+except Exception:
+  pass
+' 2>/dev/null)
+
+[ -z "$cmd" ] && exit 0
+
+case "$cmd" in
+  *"npm install"*|*"npm i "*|*"npm uninstall"*|*"npm remove"*|\
+  *"yarn add"*|*"yarn remove"*|*"pnpm add"*|*"pnpm remove"*|\
+  *"pip install"*|*"pip uninstall"*|*"uv add"*|*"uv remove"*|*"uv pip install"*|\
+  *"cargo add"*|*"cargo remove"*|*"go get"*|*"go mod tidy"*|\
+  *"prisma migrate"*|*"drizzle-kit push"*|*"drizzle push"*|*"alembic upgrade"*|*"alembic downgrade"*|\
+  *"swift package update"*|*"swift package resolve"*|*"pod install"*|*"pod update"*|*"xcodebuild"*)
+    echo "Dependency/migration/build change detected — consider running the navgator \`scan\` MCP tool to refresh architecture tracking."
+    ;;
+  *) exit 0 ;;
+esac
+exit 0