swipium 1.0.0

package/dist/appMap/codeIndex.js

@@ -0,0 +1,73 @@
+// Lightweight text/symbol index over source files (SWIPIUM-REQ-01 "All frameworks: build a
+// lightweight text/symbol index over source files for feature queries"). Dependency-free: it
+// extracts exported/declared symbol names + a small token bag per file so qa_app_map_query can
+// rank source candidates without re-reading the tree. Persisted under .swipium/app-map.index/.
+import { basename } from 'node:path';
+import { rel, readTextSafe } from './fsWalk.js';
+const SYMBOL_RES = [
+    /export\s+(?:default\s+)?(?:async\s+)?function\s+([A-Za-z0-9_]+)/g,
+    /export\s+(?:const|let|var)\s+([A-Za-z0-9_]+)/g,
+    /export\s+(?:default\s+)?class\s+([A-Za-z0-9_]+)/g,
+    /(?:^|\n)\s*(?:public\s+|final\s+|open\s+|abstract\s+)*(?:class|interface|object)\s+([A-Za-z0-9_]+)/g,
+    /struct\s+([A-Za-z0-9_]+)\s*:/g,
+    /(?:^|\n)\s*class\s+([A-Za-z0-9_]+)\s+extends\s+/g, // dart widgets
+];
+function extractSymbols(text) {
+    const out = new Set();
+    for (const re of SYMBOL_RES) {
+        re.lastIndex = 0;
+        let m;
+        while ((m = re.exec(text)))
+            if (m[1])
+                out.add(m[1]);
+    }
+    return [...out].slice(0, 60);
+}
+function tokenize(text) {
+    const counts = new Map();
+    for (const m of text.matchAll(/[A-Za-z][A-Za-z0-9]{2,}/g)) {
+        // split camelCase into sub-words so "WeatherAnalysisScreen" matches "weather"/"analysis"
+        const word = m[0];
+        const parts = word.replace(/([a-z0-9])([A-Z])/g, '$1 $2').toLowerCase().split(/\s+/);
+        for (const p of parts)
+            if (p.length >= 3)
+                counts.set(p, (counts.get(p) ?? 0) + 1);
+    }
+    return [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 40).map(([t]) => t);
+}
+const STOP = new Set(['const', 'export', 'import', 'function', 'return', 'class', 'this', 'from', 'react', 'native', 'string', 'number', 'void', 'null', 'undefined', 'true', 'false', 'async', 'await']);
+/** Build a code index from collected source files. Skips tests/specs and oversized files. */
+export function buildCodeIndex(root, files, generatedAt) {
+    const out = [];
+    for (const f of files) {
+        const relPath = rel(root, f);
+        if (/\.(test|spec|stories)\./.test(basename(f)))
+            continue;
+        const text = readTextSafe(f);
+        if (!text || text.length > 400_000)
+            continue;
+        const symbols = extractSymbols(text);
+        const tokens = tokenize(text).filter((t) => !STOP.has(t));
+        if (!symbols.length && !tokens.length)
+            continue;
+        out.push({ file: relPath, symbols, tokens });
+        if (out.length >= 2000)
+            break;
+    }
+    return { schemaVersion: 1, generatedAt, files: out };
+}
+/** Score a file against query terms (symbol hits weigh more than token hits). */
+export function scoreFile(entry, terms) {
+    let score = 0;
+    const symLower = entry.symbols.map((s) => s.toLowerCase());
+    for (const t of terms) {
+        if (symLower.some((s) => s.includes(t)))
+            score += 3;
+        if (entry.tokens.includes(t))
+            score += 1;
+        if (entry.file.toLowerCase().includes(t))
+            score += 2;
+    }
+    return score;
+}
+//# sourceMappingURL=codeIndex.js.map

package/dist/appMap/codeIndex.js.map

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

package/dist/appMap/featureModel.js

@@ -0,0 +1,83 @@
+// Feature-NODE inference (SWIPIUM-REQ-01 FeatureNode). Complements featureIndex.ts (the lightweight
+// code symbol/route index): this maps the static topology + library signals into candidate
+// FeatureNodes for the AppKnowledgeMap. Inference is conservative — a feature backed by a single
+// weak signal is a HYPOTHESIS, not a fact (Non-Goals § "Do not treat low-confidence feature
+// inference as fact"). Runtime merge later enriches testCoverage + runtimeScreens; tickets scope.
+import { combineConfidence } from './provenance.js';
+// Ordered, lightweight semantic patterns matched against screen names/routes + source files.
+const PATTERNS = [
+    { id: 'feature:auth', title: 'Authentication', objective: 'Sign in / sign up / sign out', re: /login|signin|sign-in|signup|sign-up|register|auth|password|forgot/i, risk: 'high' },
+    { id: 'feature:onboarding', title: 'Onboarding', objective: 'First-run welcome / tutorial', re: /onboard|welcome|intro|get-?started|walkthrough|tutorial/i, risk: 'low' },
+    { id: 'feature:paywall', title: 'Paywall / Subscription', objective: 'Purchase or subscribe', re: /paywall|subscribe|subscription|premium|upgrade|pricing|plans?|purchase|checkout|billing/i, risk: 'high' },
+    { id: 'feature:search', title: 'Search', objective: 'Search / discover content', re: /search|explore|discover|browse/i, risk: 'low' },
+    { id: 'feature:profile', title: 'Profile', objective: 'View / edit the user profile', re: /profile|account|\bme\b/i, risk: 'medium' },
+    { id: 'feature:settings', title: 'Settings', objective: 'Adjust app settings', re: /settings|preferences|config/i, risk: 'medium' },
+    { id: 'feature:notifications', title: 'Notifications', objective: 'View / manage notifications', re: /notification|alerts?|inbox/i, risk: 'low' },
+    { id: 'feature:create', title: 'Create / Add', objective: 'Create or add an item', re: /create|new|add|compose|post|upload/i, risk: 'medium' },
+    { id: 'feature:detail', title: 'Detail / View', objective: 'View an item detail', re: /detail|view|show|info/i, risk: 'low' },
+    { id: 'feature:checkout', title: 'Cart / Checkout', objective: 'Cart and checkout', re: /cart|checkout|order|payment|\bpay\b/i, risk: 'high' },
+    { id: 'feature:map', title: 'Map / Location', objective: 'Map or location features', re: /\bmap\b|location|nearby|geo/i, risk: 'low' },
+    { id: 'feature:media', title: 'Media', objective: 'Photos / video / camera', re: /camera|photo|video|gallery|media/i, risk: 'low' },
+];
+export function inferFeatures(input) {
+    const { topo } = input;
+    const features = [];
+    for (const pat of PATTERNS) {
+        const screens = topo.screens.filter((s) => pat.re.test(s.name) || pat.re.test(s.route ?? '') || s.sourceFiles.some((f) => pat.re.test(f)));
+        if (!screens.length)
+            continue;
+        const sourceFiles = [...new Set(screens.flatMap((s) => s.sourceFiles))];
+        // signals: screen-name match + library corroboration for auth/paywall raise confidence to "fact".
+        const signals = [Math.min(0.85, 0.4 + 0.12 * screens.length)];
+        const reasons = [`matched ${screens.length} screen(s)`];
+        if (pat.id === 'feature:auth' && input.auth.libraries.length) {
+            signals.push(0.7);
+            reasons.push(`auth library: ${input.auth.libraries.join(', ')}`);
+        }
+        if (pat.id === 'feature:paywall' && input.paywalls.some((p) => p.libraries.length)) {
+            signals.push(0.7);
+            reasons.push('purchase/subscription library present');
+        }
+        if ((pat.id === 'feature:auth' || pat.id === 'feature:create' || pat.id === 'feature:search') && input.hasForms) {
+            signals.push(0.3);
+            reasons.push('form library present');
+        }
+        const confidence = combineConfidence(signals);
+        const corroborated = signals.length >= 2 || confidence >= 0.8;
+        features.push({
+            id: pat.id,
+            title: pat.title,
+            objective: pat.objective,
+            sourceFiles,
+            staticScreens: screens.map((s) => s.id),
+            runtimeScreens: [],
+            actions: [],
+            riskLevel: pat.risk,
+            testCoverage: 'none',
+            blockers: pat.id === 'feature:auth' ? ['Requires test credentials (fixture)'] : [],
+            status: corroborated ? 'fact' : 'hypothesis',
+            confidence,
+            reasons,
+        });
+    }
+    // Navigation is always a feature when there is more than one screen.
+    if (topo.screens.length > 1) {
+        features.push({
+            id: 'feature:navigation',
+            title: 'Navigation',
+            objective: "Move between the app's primary screens",
+            sourceFiles: [],
+            staticScreens: topo.screens.slice(0, 12).map((s) => s.id),
+            runtimeScreens: [],
+            actions: [],
+            riskLevel: 'low',
+            testCoverage: 'none',
+            blockers: [],
+            status: 'fact',
+            confidence: 0.9,
+            reasons: [`${topo.screens.length} screens, ${topo.edges.length} navigation edges`],
+        });
+    }
+    return features;
+}
+//# sourceMappingURL=featureModel.js.map

package/dist/appMap/featureModel.js.map

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

package/dist/appMap/firstRunApply.js

@@ -0,0 +1,131 @@
+// SWIPIUM-REQ-02 / REQ-01 Fix Group 5 — apply first-run classifications to the durable app map.
+// runFirstRun() emits AppMapPatch[] (per-screen purpose + auth/onboarding/paywall signals + observed
+// transitions). Historically these were written ONLY as a detached session artifact. This module
+// folds them into AppKnowledgeMap so a runtime login/onboarding/paywall screen durably updates the
+// map's runtime topology + auth/onboarding/paywall models + provenance. PURE (mutates the passed map).
+import { addProvenance, makeProvenance } from './provenance.js';
+import { computeUnvisitedStaticScreens } from './runtimeMerge.js';
+const AUTH_PURPOSES = new Set(['login', 'create_account', 'login_or_create_account', 'otp_or_email_verification']);
+function findScreenBySignature(map, sig) {
+    if (!sig)
+        return undefined;
+    return map.runtimeTopology.screens.find((s) => s.signature === sig || s.uiSignature === sig || s.visualSignature === sig);
+}
+function defaultPlatform(map) {
+    if (map.project.platforms.length === 1)
+        return map.project.platforms[0];
+    return map.runtimeTopology.screens[0]?.platform ?? 'android';
+}
+function upsertPaywall(map, screenId, confidence) {
+    let pw = map.paywalls.find((f) => f.kind === 'paywall');
+    if (!pw) {
+        pw = { id: 'paywall', kind: 'paywall', present: true, signals: [], libraries: [], screens: [], confidence: 0 };
+        map.paywalls.push(pw);
+    }
+    pw.present = true;
+    pw.signals = [...new Set([...pw.signals, 'runtime_first_run'])];
+    if (!pw.screens.includes(screenId))
+        pw.screens.push(screenId);
+    pw.confidence = Math.max(pw.confidence, confidence);
+}
+/** Fold first-run classifications into the map's runtime topology + auth/onboarding/paywall models. */
+export function applyFirstRunPatches(map, patches, at) {
+    const res = { updatedScreens: 0, newScreens: 0, authUpdated: false, onboardingUpdated: false, paywallUpdated: false };
+    const platform = defaultPlatform(map);
+    // Resolve the strongest static-screen link from a patch (Vision Gap Fix 2) against ids that actually
+    // exist in the static topology, so a runtime auth/onboarding screen durably links to its static id.
+    const staticIds = new Set(map.staticTopology.screens.map((s) => s.id));
+    const staticLinkOf = (p) => {
+        const links = (p.links ?? []).filter((l) => l.kind === 'staticScreen' && staticIds.has(l.id));
+        if (!links.length)
+            return undefined;
+        return links.reduce((best, l) => (l.confidence > best.confidence ? l : best), links[0]);
+    };
+    for (const p of patches) {
+        const staticLink = staticLinkOf(p);
+        let screen = findScreenBySignature(map, p.screenSignature);
+        if (screen) {
+            screen.purpose = p.purpose;
+            if (p.authState)
+                screen.authState = p.authState;
+            screen.lastSeen = at;
+            screen.lastArtifactUris = [...new Set([...(p.evidence ?? []), ...screen.lastArtifactUris])].slice(0, 10);
+            if (staticLink) {
+                screen.linkedStaticScreenId = staticLink.id;
+                screen.linkConfidence = Math.max(screen.linkConfidence ?? 0, staticLink.confidence);
+                screen.unmapped = false;
+            }
+            res.updatedScreens++;
+        }
+        else {
+            screen = {
+                id: `r${map.runtimeTopology.screens.length + 1}`,
+                signature: p.screenSignature,
+                platform,
+                purpose: p.purpose,
+                authState: p.authState,
+                lastArtifactUris: (p.evidence ?? []).slice(0, 10),
+                locatorReadiness: 'unknown',
+                firstSeen: at,
+                lastSeen: at,
+                visits: 1,
+                ...(staticLink ? { linkedStaticScreenId: staticLink.id, linkConfidence: staticLink.confidence, unmapped: false } : { unmapped: true }),
+            };
+            map.runtimeTopology.screens.push(screen);
+            res.newScreens++;
+        }
+        if (AUTH_PURPOSES.has(p.purpose)) {
+            map.auth.hasAuth = true;
+            map.auth.loginScreenSeen = true;
+            if (!map.auth.screens.includes(screen.id))
+                map.auth.screens.push(screen.id);
+            // Link the static screen too (Fix 2): the auth model lists both the runtime and static screen.
+            if (staticLink && !map.auth.screens.includes(staticLink.id))
+                map.auth.screens.push(staticLink.id);
+            map.auth.signals = [...new Set([...map.auth.signals, 'runtime_first_run'])];
+            map.auth.confidence = Math.max(map.auth.confidence, p.confidence);
+            res.authUpdated = true;
+        }
+        else if (p.purpose === 'onboarding') {
+            const ob = map.onboarding ?? { id: 'onboarding', kind: 'onboarding', present: false, signals: [], libraries: [], screens: [], confidence: 0 };
+            ob.present = true;
+            ob.signals = [...new Set([...ob.signals, 'runtime_first_run'])];
+            if (!ob.screens.includes(screen.id))
+                ob.screens.push(screen.id);
+            ob.confidence = Math.max(ob.confidence, p.confidence);
+            map.onboarding = ob;
+            res.onboardingUpdated = true;
+        }
+        else if (p.purpose === 'paywall') {
+            upsertPaywall(map, screen.id, p.confidence);
+            res.paywallUpdated = true;
+        }
+    }
+    // Observed transitions → runtime edges (best-effort; only when both endpoints resolve).
+    for (const p of patches) {
+        const fromSig = p.transition?.fromSignature;
+        if (!fromSig)
+            continue;
+        const from = findScreenBySignature(map, fromSig);
+        const to = findScreenBySignature(map, p.screenSignature);
+        if (!from || !to)
+            continue;
+        const exists = map.runtimeTopology.edges.find((e) => e.from === from.id && e.to === to.id && e.action.type === 'first_run_step');
+        if (!exists) {
+            map.runtimeTopology.edges.push({
+                from: from.id,
+                to: to.id,
+                action: { type: 'first_run_step', targetDescription: p.purpose },
+                outcome: p.transition?.outcome ?? 'changed_screen',
+                evidenceUris: (p.evidence ?? []).slice(0, 5),
+                observedCount: 1,
+            });
+        }
+    }
+    map.runtimeTopology.unvisitedStaticScreens = computeUnvisitedStaticScreens(map);
+    if (patches.length) {
+        addProvenance(map, makeProvenance('runtime', at, `First-run classifications: ${[...new Set(patches.map((p) => p.purpose))].slice(0, 6).join(', ')}`, { targetType: 'map' }));
+    }
+    return res;
+}
+//# sourceMappingURL=firstRunApply.js.map

package/dist/appMap/firstRunApply.js.map

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

package/dist/appMap/fsWalk.js

@@ -0,0 +1,75 @@
+// Bounded, dependency-free source-file walker shared by the static scanner and code index.
+// Never throws on an unreadable dir; caps total files so a huge monorepo can't blow up a scan.
+import { createHash } from 'node:crypto';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', '.swipium', 'build', 'dist', 'out', '.next', '.expo', 'Pods', 'DerivedData',
+    '.gradle', '.idea', 'vendor', 'coverage', '__pycache__', '.dart_tool', '.venv', 'venv', 'Carthage',
+]);
+export function readTextSafe(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Recursively collect file paths under `root`, honoring ignore dirs + caps. Best-effort. */
+export function walkFiles(root, opts = {}) {
+    const exts = opts.exts?.map((e) => e.toLowerCase());
+    const names = new Set(opts.alsoNames ?? []);
+    const maxFiles = opts.maxFiles ?? 4000;
+    const maxDepth = opts.maxDepth ?? 12;
+    const out = [];
+    const walk = (dir, depth) => {
+        if (out.length >= maxFiles || depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (out.length >= maxFiles)
+                return;
+            if (e.name.startsWith('.') && e.name !== '.well-known') {
+                // allow hidden files only if explicitly named
+                if (!names.has(e.name))
+                    continue;
+            }
+            const full = join(dir, e.name);
+            if (e.isDirectory()) {
+                if (IGNORE_DIRS.has(e.name))
+                    continue;
+                walk(full, depth + 1);
+            }
+            else if (e.isFile()) {
+                const lower = e.name.toLowerCase();
+                const extOk = !exts || exts.some((x) => lower.endsWith(x));
+                if (extOk || names.has(e.name))
+                    out.push(full);
+            }
+        }
+    };
+    walk(root, 0);
+    return out;
+}
+export function fileHash(path) {
+    try {
+        const st = statSync(path);
+        if (!st.isFile())
+            return null;
+        const h = createHash('sha256').update(readFileSync(path)).digest('hex');
+        return { hash: `sha256:${h}`, mtimeMs: Math.round(st.mtimeMs) };
+    }
+    catch {
+        return null;
+    }
+}
+export function rel(root, path) {
+    return relative(root, path).split('\\').join('/');
+}
+//# sourceMappingURL=fsWalk.js.map

package/dist/appMap/fsWalk.js.map

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

package/dist/appMap/issues.js

@@ -0,0 +1,227 @@
+// SWIPIUM-REQ-08 — derive compact app-map issue summaries from the durable issue ledger.
+//
+// The issue ledger (`.swipium/issues-log.jsonl`) stays the source of truth. This module reads the
+// issue index + events and attaches a small `AppMapIssueSummary` to the screens/features an issue is
+// confidently associated with — counts + pointers only, never full events. Rebuilt on every app-map
+// refresh, so deleting the issue index and rebuilding loses nothing once the map is refreshed.
+//
+// PURE w.r.t. the clock (now is injected). Reads the ledger via src/issues/store.
+import { combineReleaseImpact, defaultReleaseImpact } from '../issues/schema.js';
+import { getIndex, readEvents } from '../issues/store.js';
+import { loadSuite } from '../testSuite/store.js';
+/** Categorize a record into the summary buckets. A record can land in several derived buckets. */
+function isOpen(r) {
+    return (r.state === 'open' || r.state === 'observed_again' || r.state === 'needs_triage') && r.category !== 'environment_noise';
+}
+function isRecurring(r) {
+    return r.state === 'reopened' || Boolean(r.lastRecurrenceMessage);
+}
+function isKnownNoise(r) {
+    return r.state === 'expected_environment_noise' || r.state === 'suppressed' || r.category === 'environment_noise';
+}
+const SEVERITY_RANK = { blocker: 5, high: 4, medium: 3, low: 2, info: 1 };
+/** Build a compact issue summary from the subset of issue records mapped to a screen/feature. */
+export function buildAppMapIssueSummary(records, now) {
+    const open = records.filter(isOpen);
+    const recurring = records.filter(isRecurring);
+    const hardGate = records.filter((r) => r.category === 'hard_gate');
+    const storeCompliance = records.filter((r) => r.category === 'store_compliance' || r.category === 'security_privacy');
+    const knownNoise = records.filter(isKnownNoise);
+    const improvement = records.filter((r) => r.category === 'improvement' || r.category === 'accessibility_readiness');
+    const fixed = records.filter((r) => r.state === 'fixed');
+    // Release impact rolls up non-suppressed, non-fixed, real-defect/gate/compliance records.
+    const impacts = records
+        .filter((r) => r.state !== 'suppressed' && r.state !== 'expected_environment_noise' && r.state !== 'fixed' && r.category !== 'environment_noise')
+        .map((r) => defaultReleaseImpact(r.category, r.severity));
+    const ids = (rs) => rs.map((r) => r.issueId);
+    const lastIssueSeenAt = records.reduce((max, r) => (!max || r.lastSeenAt > max ? r.lastSeenAt : max), undefined);
+    const topIssueIds = records
+        .slice()
+        .sort((a, b) => (SEVERITY_RANK[b.severity] ?? 0) - (SEVERITY_RANK[a.severity] ?? 0) || (b.lastSeenAt > a.lastSeenAt ? 1 : -1))
+        .slice(0, 5)
+        .map((r) => r.issueId);
+    return {
+        openIssueIds: ids(open),
+        recurringIssueIds: ids(recurring),
+        hardGateIssueIds: ids(hardGate),
+        storeComplianceIssueIds: ids(storeCompliance),
+        knownNoiseIssueIds: ids(knownNoise),
+        improvementIssueIds: ids(improvement),
+        fixedIssueIds: ids(fixed),
+        counts: {
+            open: open.length,
+            recurring: recurring.length,
+            hardGate: hardGate.length,
+            storeCompliance: storeCompliance.length,
+            knownNoise: knownNoise.length,
+            improvement: improvement.length,
+            fixed: fixed.length,
+        },
+        releaseImpact: combineReleaseImpact(impacts),
+        lastIssueSeenAt,
+        topIssueIds,
+        updatedAt: now,
+    };
+}
+/**
+ * Build per-issue screen/feature associations from the event log (mapping rules in REQ-08 order):
+ *   1. explicit links.appMapRefs (screenId/featureId)
+ *   2. observation.screenId matching a runtime/static screen id
+ *   3. observation.screenPurpose matching a runtime screen purpose
+ * Issues with no confident mapping stay project-level only (never attached to a random screen).
+ */
+export function issueAssociations(root, map) {
+    const assoc = new Map();
+    const ensure = (id) => {
+        let a = assoc.get(id);
+        if (!a)
+            assoc.set(id, (a = { screenIds: new Set(), featureIds: new Set() }));
+        return a;
+    };
+    const runtimeIds = new Set(map.runtimeTopology.screens.map((s) => s.id));
+    const staticIds = new Set(map.staticTopology.screens.map((s) => s.id));
+    const purposeIndex = new Map(); // purpose(lower) → runtime screen ids
+    for (const s of map.runtimeTopology.screens) {
+        if (s.purpose) {
+            const key = s.purpose.toLowerCase();
+            purposeIndex.set(key, [...(purposeIndex.get(key) ?? []), s.id]);
+        }
+    }
+    for (const ev of readEvents(root)) {
+        const a = ensure(ev.issueId);
+        // 1. explicit app-map refs.
+        for (const ref of ev.links?.appMapRefs ?? []) {
+            if (ref.screenId)
+                a.screenIds.add(ref.screenId);
+            if (ref.featureId)
+                a.featureIds.add(ref.featureId);
+        }
+        const obs = ev.observation;
+        if (obs?.screenId) {
+            // 2. screen id that matches a known screen.
+            if (runtimeIds.has(obs.screenId) || staticIds.has(obs.screenId))
+                a.screenIds.add(obs.screenId);
+        }
+        // 3. screen purpose → runtime screens with that purpose.
+        if (obs?.screenPurpose) {
+            for (const sid of purposeIndex.get(obs.screenPurpose.toLowerCase()) ?? [])
+                a.screenIds.add(sid);
+        }
+    }
+    // Roll screen associations up to the features that contain those screens.
+    for (const f of map.features) {
+        const owned = new Set([...f.staticScreens, ...f.runtimeScreens]);
+        for (const [issueId, a] of assoc) {
+            if ([...a.screenIds].some((sid) => owned.has(sid)))
+                a.featureIds.add(f.id);
+            void issueId;
+        }
+    }
+    // 4. observation.workflow → test-suite case → feature. Read the persistent suite's COMPACT issue
+    // links (issue id + featureId only — never case history) so an issue attached only to a test case
+    // still shows up on the owning feature's summary (REQ-08 follow-up).
+    try {
+        const suite = loadSuite(root, map.appIdentity?.androidPackage ?? undefined);
+        for (const c of suite.cases) {
+            if (!c.featureId)
+                continue;
+            for (const ref of c.issueRefs ?? [])
+                ensure(ref.issueId).featureIds.add(c.featureId);
+            for (const run of c.history ?? [])
+                for (const link of run.issueLinks ?? [])
+                    ensure(link.issueId).featureIds.add(c.featureId);
+        }
+    }
+    catch {
+        /* best-effort — suite is optional */
+    }
+    return assoc;
+}
+/**
+ * Attach derived issue summaries to the map's screens + features from the issue ledger. Clears stale
+ * summaries when an issue no longer maps to a node. The map keeps only counts + ids.
+ */
+export function applyIssueSummariesToAppMap(map, root, now) {
+    const index = getIndex(root, now, map.appIdentity?.androidPackage ?? undefined);
+    const byId = new Map(index.records.map((r) => [r.issueId, r]));
+    if (index.records.length === 0) {
+        // No ledger yet — clear any stale summaries and return.
+        for (const s of map.runtimeTopology.screens)
+            delete s.issueSummary;
+        for (const s of map.staticTopology.screens)
+            delete s.issueSummary;
+        for (const f of map.features)
+            delete f.issueSummary;
+        return { screensWithIssues: 0, featuresWithIssues: 0 };
+    }
+    const assoc = issueAssociations(root, map);
+    const recordsForScreen = (screenId) => {
+        const out = [];
+        for (const [issueId, a] of assoc) {
+            if (a.screenIds.has(screenId)) {
+                const r = byId.get(issueId);
+                if (r)
+                    out.push(r);
+            }
+        }
+        return out;
+    };
+    const recordsForFeature = (featureId) => {
+        const out = [];
+        for (const [issueId, a] of assoc) {
+            if (a.featureIds.has(featureId)) {
+                const r = byId.get(issueId);
+                if (r)
+                    out.push(r);
+            }
+        }
+        return out;
+    };
+    let screensWithIssues = 0;
+    let featuresWithIssues = 0;
+    const applyTo = (node, recs) => {
+        if (recs.length === 0) {
+            delete node.issueSummary;
+            return false;
+        }
+        node.issueSummary = buildAppMapIssueSummary(recs, now);
+        return true;
+    };
+    for (const s of map.runtimeTopology.screens)
+        if (applyTo(s, recordsForScreen(s.id)))
+            screensWithIssues++;
+    for (const s of map.staticTopology.screens)
+        if (applyTo(s, recordsForScreen(s.id)))
+            screensWithIssues++;
+    for (const f of map.features) {
+        const recs = recordsForFeature(f.id);
+        if (recs.length === 0) {
+            delete f.issueSummary;
+            continue;
+        }
+        f.issueSummary = buildAppMapIssueSummary(recs, now);
+        featuresWithIssues++;
+    }
+    return { screensWithIssues, featuresWithIssues };
+}
+/** Structural validation for a persisted AppMapIssueSummary (best-effort; returns error strings). */
+export function validateIssueSummary(s, where) {
+    const errs = [];
+    if (s == null)
+        return errs;
+    if (typeof s !== 'object')
+        return [`${where}: issueSummary is not an object`];
+    const o = s;
+    const arrays = ['openIssueIds', 'recurringIssueIds', 'hardGateIssueIds', 'storeComplianceIssueIds', 'knownNoiseIssueIds', 'improvementIssueIds', 'fixedIssueIds', 'topIssueIds'];
+    for (const k of arrays)
+        if (o[k] != null && !Array.isArray(o[k]))
+            errs.push(`${where}.${k} must be an array`);
+    if (o.counts != null && typeof o.counts !== 'object')
+        errs.push(`${where}.counts must be an object`);
+    if (o.releaseImpact != null && !['block', 'warn', 'pass'].includes(o.releaseImpact))
+        errs.push(`${where}.releaseImpact invalid`);
+    if (o.updatedAt != null && typeof o.updatedAt !== 'string')
+        errs.push(`${where}.updatedAt must be a string`);
+    return errs;
+}
+//# sourceMappingURL=issues.js.map