swipium 1.4.0 → 2.0.0

package/dist/tools/issues.js

@@ -1,20 +1,23 @@
-// SWIPIUM Issue Log MCP tools (SWIPIUM-REQ-07). Expose the durable project issue ledger:
-//   qa_issue_log         — list current issues + counts + recurrence candidates
-//   qa_issue_history     — the append-only event trail for one issue
-//   qa_issue_mark_fixed  — record a fix (date, commit, version, how-fixed) for regression detection
-//   qa_issue_triage      — change category / severity / owner / note
-//   qa_issue_suppress    — suppress known noise (stays visible under known-noise, never hidden)
+// SWIPIUM Issue Log MCP tools. qa_issue_log is still the only exposed issue
+// tool, but it now carries the full ledger lifecycle via `mode`:
+//   history (default): list current issues + counts + recurrence candidates (original behavior)
+//   log:               record a new observation (re-observing a fixed fingerprint reopens it)
+//   mark_fixed:        transition an issue to fixed (commit/version/how-fixed provenance)
+//   verify_fixed:      confirm a fixed issue held, with current-run evidence
+//   suppress:          hide expected noise from default history (stays under known-noise);
+//                       `suppressedUntil` expires it automatically, `unsuppress:true` lifts it early
+//   metrics:           opened/fixed/reopened/verified counts + trends from the event log
 //
 // Thin wrappers over src/issues/*; heavy logic lives there. Large lists are returned inline but
 // compact (issue ids + summaries), with a resource URI for the full index.
 import { z } from 'zod';
-import { qaOk, qaError } from '../lib/result.js';
-import { resolveProjectRoot } from '../context/projectRoot.js';
-import { markFixed, queryIssues, suppressIssue, triageIssue, verifyFixed, } from '../issues/index.js';
+import { qaOk, qaError, unknownSessionError } from '../lib/result.js';
+import { resolveProjectRoot, unresolvedProjectRootError } from '../context/projectRoot.js';
+import { makeRedactor } from '../lib/redact.js';
+import { markFixed, markSuppressed, markUnsuppressed, queryIssues, recordObservation, verifyFixed, } from '../issues/index.js';
+import { fingerprintTokens, hasIdentitySignal } from '../issues/fingerprint.js';
 import { computeIssueMetrics } from '../issues/metrics.js';
-import { issuesResourceUri, readEvents } from '../issues/store.js';
-import { resolveSourceRevision } from '../issues/sourceRevision.js';
-import { loadPolicy } from '../issues/store.js';
+import { readEvents } from '../issues/store.js';
 import { ALL_ISSUE_CATEGORIES, ALL_ISSUE_SEVERITIES, ALL_ISSUE_STATES, } from '../issues/schema.js';
 function nowIso() {
     return new Date().toISOString();
@@ -23,46 +26,255 @@ async function rootFor(server, sessions, args) {
     if (args.sessionId) {
         const s = sessions.get(args.sessionId);
         if (!s)
-            return { hint: `Unknown sessionId ${args.sessionId}` };
-        return { root: s.root };
+            return { error: unknownSessionError(args.sessionId) };
+        return { root: s.root, appId: s.appId };
     }
     const resolved = await resolveProjectRoot(server, args.projectRoot);
     if (!resolved.root)
         return { hint: resolved.hint };
     return { root: resolved.root };
 }
-const KEY_SCHEMA = {
-    issueId: z.string().optional().describe('Issue id (iss_…). Provide this OR fingerprint.'),
-    fingerprint: z.string().optional().describe('Issue fingerprint (sha256:…). Provide this OR issueId.'),
-};
+/** Compact lifecycle view of one record for write-mode responses (undefined fields drop out). */
+function lifecycleRecord(r) {
+    return {
+        issueId: r.issueId,
+        fingerprint: r.fingerprint,
+        state: r.state,
+        category: r.category,
+        severity: r.severity,
+        summary: r.summary,
+        observationCount: r.observationCount,
+        lastSeenAt: r.lastSeenAt,
+        fixedAt: r.fixedAt,
+        fixedInCommit: r.fixedInCommit,
+        fixedInVersion: r.fixedInVersion,
+        howFixed: r.howFixed,
+        reopenedAt: r.reopenedAt,
+        recurrence: r.lastRecurrenceMessage,
+        suppressionReason: r.suppressionReason,
+        suppressedUntil: r.suppressedUntil,
+        stateBeforeSuppression: r.stateBeforeSuppression,
+        lastVerifiedFixedAt: r.lastVerifiedFixedAt,
+    };
+}
+/** Free-text qa_issue_log fields persisted to .swipium/issues-log.jsonl. */
+const FREE_TEXT_FIELDS = ['title', 'summary', 'howFixed', 'suppressionReason', 'fixedBy'];
+function sessionSecrets(sessions, sessionId) {
+    return (sessionId ? sessions.get(sessionId)?.secrets : undefined) ?? [];
+}
+/** Redact registered session secrets from the agent-supplied free-text fields (exported for tests). */
+export function redactIssueArgs(args, secrets) {
+    const redact = makeRedactor(secrets);
+    const out = { ...args };
+    for (const k of FREE_TEXT_FIELDS) {
+        const v = out[k];
+        if (typeof v === 'string')
+            out[k] = redact(v) ?? v;
+    }
+    return out;
+}
 export function registerIssues(server, sessions) {
     // --- qa_issue_log ------------------------------------------------------------------------
     server.registerTool('qa_issue_log', {
-        title: 'List project issues',
-        description: 'List the durable project issue ledger (`.swipium/issues-log.jsonl`). Returns current issue records, counts by state/category/severity, and recurrence candidates (previously-fixed issues seen again). Filter by state, category, severity, platform, or since (ISO date). Suppressed issues are hidden unless includeSuppressed=true (they stay visible under known-noise in reports either way).',
+        title: 'Project issue ledger (list + lifecycle)',
+        description: 'Durable project issue ledger (.swipium/issues-log.jsonl). mode: history (default; list + counts + recurrence, filterable), ' +
+            'log (record an observation; identity = normalized title + category + platform; re-observing a fixed issue reopens it), ' +
+            'mark_fixed (active issues only), verify_fixed (needs current-run evidence), suppress (suppressedUntil auto-expires; ' +
+            'unsuppress:true lifts it), metrics (trends from the event log). Transitions take issueId (or fingerprint).',
         inputSchema: {
             projectRoot: z.string().optional(),
             sessionId: z.string().optional(),
-            state: z.enum(ALL_ISSUE_STATES).optional(),
-            category: z.enum(ALL_ISSUE_CATEGORIES).optional(),
-            severity: z.enum(ALL_ISSUE_SEVERITIES).optional(),
-            platform: z.enum(['ios', 'android', 'web', 'unknown']).optional(),
-            since: z.string().optional().describe('ISO timestamp; only issues last seen on/after this.'),
-            includeSuppressed: z.boolean().optional(),
+            mode: z.enum(['history', 'log', 'mark_fixed', 'verify_fixed', 'suppress', 'metrics']).optional(),
+            state: z
+                .enum(ALL_ISSUE_STATES)
+                .optional()
+                .describe('history filter.'),
+            category: z
+                .enum(ALL_ISSUE_CATEGORIES)
+                .optional()
+                .describe('history filter; log: category hint.'),
+            severity: z
+                .enum(ALL_ISSUE_SEVERITIES)
+                .optional()
+                .describe('history filter; log: severity hint.'),
+            platform: z.enum(['ios', 'android', 'web', 'unknown']).optional().describe('history filter; log: platform observed on.'),
+            since: z.string().optional().describe('history/metrics: ISO start.'),
+            includeSuppressed: z.boolean().optional().describe('history/metrics: include suppressed issues.'),
+            issueId: z.string().optional().describe('Transition key (from history).'),
+            fingerprint: z.string().optional().describe('Alternative transition key.'),
+            title: z.string().optional().describe('log (required): what was observed, descriptive.'),
+            summary: z.string().optional().describe('log: one-line summary.'),
+            failureCode: z.string().optional().describe('log: typed code (e.g. REDBOX, ANR); sharpens the fingerprint.'),
+            evidenceUris: z.array(z.string()).optional().describe('log/verify_fixed: swipium:// evidence URIs.'),
+            fixedInCommit: z.string().optional().describe('mark_fixed'),
+            fixedInVersion: z.string().optional().describe('mark_fixed'),
+            howFixed: z.string().optional().describe('mark_fixed (quoted on recurrence)'),
+            fixedBy: z.string().optional().describe('mark_fixed'),
+            reportUri: z.string().optional().describe('verify_fixed evidence'),
+            testCaseId: z.string().optional().describe('verify_fixed evidence'),
+            auditCheckId: z.string().optional().describe('verify_fixed evidence'),
+            suppressionReason: z.string().optional().describe('suppress'),
+            suppressedUntil: z.string().optional().describe('suppress: ISO expiry (then the issue returns to its prior state).'),
+            unsuppress: z.boolean().optional().describe('suppress: lift an existing suppression now.'),
+            suppressionScope: z.enum(['fingerprint', 'platform', 'environment', 'appVersion']).optional().describe('suppress'),
+            until: z.string().optional().describe('metrics: ISO end; suppress: alias of suppressedUntil.'),
+            groupBy: z
+                .enum(['day', 'week', 'version', 'commit', 'category', 'owner', 'screen', 'feature'])
+                .optional()
+                .describe('metrics bucketing (default week).'),
         },
-    }, async ({ projectRoot, sessionId, state, category, severity, platform, since, includeSuppressed }) => {
-        const { root, hint } = await rootFor(server, sessions, { projectRoot, sessionId });
+    }, async (rawArgs) => {
+        // The ledger is a committed repo file: scrub every registered session secret (typed
+        // passwords, OTPs, secret flow variables) out of agent-supplied free text before it lands.
+        const args = redactIssueArgs(rawArgs, sessionSecrets(sessions, rawArgs.sessionId));
+        const { root, hint, appId, error } = await rootFor(server, sessions, { projectRoot: args.projectRoot, sessionId: args.sessionId });
         if (!root)
-            return qaError({ what: 'Could not resolve a project root', changedState: false, retrySafe: true, nextSteps: ['Pass projectRoot or sessionId.'], clientHint: hint });
+            return error ?? unresolvedProjectRootError({ source: 'none', hint });
+        const mode = args.mode ?? 'history';
+        const now = nowIso();
+        // --- log: record a new observation (may reopen a previously fixed issue) ---------------
+        if (mode === 'log') {
+            if (!args.title && !args.summary)
+                return qaError({
+                    what: 'mode "log" needs a title (and ideally a summary) describing what was observed',
+                    changedState: false,
+                    retrySafe: true,
+                    nextSteps: ['Pass title and summary; optionally category, severity, platform, failureCode, evidenceUris.'],
+                });
+            const title = (args.title ?? args.summary).trim();
+            // Identity: the normalized title rides the fingerprint's `text:` token (the same token the
+            // report bridge uses for visible text), plus category/platform/app scope, so two different
+            // defects logged on one platform are two issues, and re-logging the same title matches.
+            const observation = {
+                title,
+                summary: args.summary ?? title,
+                failureCode: args.failureCode,
+                visibleText: title.replace(/[\s.!?…:;,]+$/u, ''),
+            };
+            // The `app:` token is NEVER part of a manual entry's identity: the ledger is already
+            // project-scoped, and appId is only known when a sessionId was passed. Including it made
+            // the same title logged via sessionId vs via projectRoot two different issues. appId is
+            // still stored on the event as metadata. (Pre-1.6 manual issues keep their old
+            // platform-only fingerprint; they are never auto-merged; close them via mark_fixed/suppress.)
+            const meta = {
+                appId,
+                fingerprintWithoutAppId: true,
+                fingerprintCategory: args.category,
+                platform: args.platform,
+                links: args.evidenceUris?.length ? { evidenceRefs: args.evidenceUris.map((uri) => ({ kind: 'evidence', uri })) } : undefined,
+            };
+            if (!hasIdentitySignal(fingerprintTokens({
+                ...meta,
+                appId: undefined,
+                category: meta.fingerprintCategory,
+                failureCode: args.failureCode,
+                observation,
+            })))
+                return qaError({
+                    failureCode: 'ISSUE_LOG_TOO_VAGUE',
+                    what: `The title "${title}" has no identifying words once ids/numbers are scrubbed, so it would merge with unrelated issues`,
+                    changedState: false,
+                    retrySafe: true,
+                    nextSteps: ['Use a descriptive title (what broke, where), or pass failureCode.'],
+                });
+            const res = recordObservation(root, observation, now, { categoryHint: args.category, severityHint: args.severity }, meta);
+            return qaOk({
+                mode,
+                issue: lifecycleRecord(res.record),
+                issueId: res.issueId,
+                fingerprint: res.fingerprint,
+                isNew: res.isNew,
+                reopened: res.reopened,
+                recurrenceMessage: res.recurrenceMessage,
+            }, res.reopened
+                ? `Reopened ${res.issueId}: ${res.recurrenceMessage}`
+                : `${res.isNew ? 'Logged new' : 'Updated'} issue ${res.issueId} (${res.record.state}, ${res.record.category}/${res.record.severity})`);
+        }
+        // --- metrics: trends computed from the full event log -----------------------------------
+        if (mode === 'metrics') {
+            const m = computeIssueMetrics(readEvents(root), {
+                since: args.since,
+                until: args.until,
+                groupBy: args.groupBy,
+                includeSuppressed: args.includeSuppressed,
+            });
+            return qaOk({
+                mode,
+                metrics: {
+                    ...m,
+                    topRecurringIssues: m.topRecurringIssues.map(lifecycleRecord),
+                    topAgingIssues: m.topAgingIssues.map(lifecycleRecord),
+                },
+            }, `Issue metrics: opened=${m.opened} fixed=${m.fixed} reopened=${m.reopened} verifiedFixed=${m.verifiedFixed} suppressed=${m.suppressed} reopenRate=${m.reopenRatePct}% fixVerification=${m.fixVerificationRatePct}%`);
+        }
+        // --- mark_fixed / verify_fixed / suppress: lifecycle transitions on an existing issue ---
+        if (mode === 'mark_fixed' || mode === 'verify_fixed' || mode === 'suppress') {
+            const key = { issueId: args.issueId, fingerprint: args.fingerprint };
+            if (!key.issueId && !key.fingerprint)
+                return qaError({
+                    what: `mode "${mode}" needs the issue key`,
+                    changedState: false,
+                    retrySafe: true,
+                    nextSteps: ['Pass issueId (or fingerprint) from mode "history".'],
+                });
+            const suppressedUntil = args.suppressedUntil ?? args.until;
+            if (mode === 'suppress' && !args.unsuppress && suppressedUntil !== undefined && !Number.isFinite(Date.parse(suppressedUntil)))
+                return qaError({
+                    failureCode: 'INVALID_ARGUMENT',
+                    what: `suppressedUntil "${suppressedUntil}" is not an ISO timestamp`,
+                    changedState: false,
+                    retrySafe: true,
+                    nextSteps: ['Pass an ISO timestamp such as 2026-12-31T00:00:00Z, or omit it for an open-ended suppression.'],
+                });
+            const res = mode === 'suppress' && args.unsuppress
+                ? markUnsuppressed(root, key, now)
+                : mode === 'mark_fixed'
+                    ? markFixed(root, key, {
+                        fixedInCommit: args.fixedInCommit,
+                        fixedInVersion: args.fixedInVersion,
+                        howFixed: args.howFixed,
+                        fixedBy: args.fixedBy,
+                    }, now)
+                    : mode === 'verify_fixed'
+                        ? verifyFixed(root, key, {
+                            reportUri: args.reportUri,
+                            testCaseId: args.testCaseId,
+                            auditCheckId: args.auditCheckId,
+                            evidenceUris: args.evidenceUris,
+                        }, now)
+                        : markSuppressed(root, key, {
+                            suppressionReason: args.suppressionReason,
+                            suppressedUntil,
+                            suppressionScope: args.suppressionScope,
+                        }, now);
+            if (!res.ok || !res.record)
+                return qaError({
+                    failureCode: res.code,
+                    what: res.reason ?? `Could not apply ${mode}`,
+                    changedState: false,
+                    retrySafe: true,
+                    nextSteps: ['Check the issue key with mode "history" (includeSuppressed=true shows suppressed issues).'],
+                });
+            const r = res.record;
+            const summary = mode === 'mark_fixed'
+                ? `Marked ${r.issueId} fixed${r.fixedInCommit ? ` in ${r.fixedInCommit}` : ''}`
+                : mode === 'verify_fixed'
+                    ? `Verified fix for ${r.issueId} with current-run evidence`
+                    : args.unsuppress
+                        ? `Unsuppressed ${r.issueId} (now ${r.state})`
+                        : `Suppressed ${r.issueId}${r.suppressionReason ? ` (${r.suppressionReason})` : ''} (hidden from default history${r.suppressedUntil ? ` until ${r.suppressedUntil}` : ''}; still visible under known-noise)`;
+            return qaOk({ mode, issue: lifecycleRecord(r) }, summary);
+        }
+        // --- history (default): the original query/list behavior --------------------------------
         const query = {
-            state: state,
-            category: category,
-            severity: severity,
-            platform: platform,
-            since,
-            includeSuppressed,
+            state: args.state,
+            category: args.category,
+            severity: args.severity,
+            platform: args.platform,
+            since: args.since,
+            includeSuppressed: args.includeSuppressed,
         };
-        const res = queryIssues(root, nowIso(), query);
+        const res = queryIssues(root, now, query);
         const compact = res.records.map((r) => ({
             issueId: r.issueId,
             state: r.state,
@@ -72,147 +284,20 @@ export function registerIssues(server, sessions) {
             lastSeenAt: r.lastSeenAt,
             observationCount: r.observationCount,
             recurrence: r.lastRecurrenceMessage,
-            // REQ-08: linked app-map screens/features, test cases, and fix-verification status.
+            // Linked app-map screens/features, test cases, and fix-verification status.
             linkedScreens: r.appMapRefs?.map((a) => a.screenId).filter(Boolean) ?? [],
             linkedFeatures: r.appMapRefs?.map((a) => a.featureId).filter(Boolean) ?? [],
             linkedTestCases: r.testRefs?.map((t) => t.testCaseId) ?? [],
             verifiedFixedAt: r.lastVerifiedFixedAt,
             verificationStatus: r.state === 'fixed' ? (r.lastVerifiedFixedAt ? 'verified_this_history' : 'unverified') : undefined,
         }));
-        return qaOk({ issues: compact, counts: res.counts, recurrenceCandidates: res.recurrenceCandidates.map((r) => r.issueId), resourceUri: issuesResourceUri(root) }, `${res.counts.total} issue(s) — ${Object.entries(res.counts.byState).map(([k, v]) => `${k}=${v}`).join(' ')}${res.recurrenceCandidates.length ? ` | ${res.recurrenceCandidates.length} recurrence candidate(s)` : ''}`);
-    });
-    // --- qa_issue_history --------------------------------------------------------------------
-    server.registerTool('qa_issue_history', {
-        title: 'Issue event history',
-        description: 'Return the append-only event trail (observed / classified / triaged / fixed / reopened / suppressed) for one issue, so you can audit why it is currently open, fixed, reopened, or suppressed.',
-        inputSchema: { projectRoot: z.string().optional(), sessionId: z.string().optional(), ...KEY_SCHEMA },
-    }, async ({ projectRoot, sessionId, issueId, fingerprint }) => {
-        const { root, hint } = await rootFor(server, sessions, { projectRoot, sessionId });
-        if (!root)
-            return qaError({ what: 'Could not resolve a project root', changedState: false, retrySafe: true, nextSteps: ['Pass projectRoot or sessionId.'], clientHint: hint });
-        if (!issueId && !fingerprint)
-            return qaError({ what: 'Provide issueId or fingerprint', changedState: false, retrySafe: true, nextSteps: ['Re-call with issueId or fingerprint (from qa_issue_log).'] });
-        const events = readEvents(root).filter((e) => (issueId && e.issueId === issueId) || (fingerprint && e.fingerprint === fingerprint));
-        if (events.length === 0)
-            return qaError({ what: `No events for ${issueId ?? fingerprint}`, changedState: false, retrySafe: true, nextSteps: ['Check the id via qa_issue_log.'] });
-        return qaOk({ issueId: events[0].issueId, fingerprint: events[0].fingerprint, events }, `${events.length} event(s) for ${events[0].issueId}`);
-    });
-    // --- qa_issue_mark_fixed -----------------------------------------------------------------
-    server.registerTool('qa_issue_mark_fixed', {
-        title: 'Mark an issue fixed',
-        description: 'Record that a developer fixed an issue: appends a `fixed` event with date, commit, version, how-fixed note, and fixedBy, then updates the derived index to state=fixed. Previous observations are NEVER deleted. If the same fingerprint is observed again later, the issue is reopened with a recurrence message that cites this fix metadata.',
-        inputSchema: {
-            projectRoot: z.string().optional(),
-            sessionId: z.string().optional(),
-            ...KEY_SCHEMA,
-            fixedInCommit: z.string().optional().describe('Commit sha the fix landed in. Defaults from sourceRevision/CI env when omitted.'),
-            fixedInVersion: z.string().optional(),
-            howFixed: z.string().optional().describe('Plain-language note: what changed.'),
-            fixedBy: z.string().optional(),
-        },
-    }, async ({ projectRoot, sessionId, issueId, fingerprint, fixedInCommit, fixedInVersion, howFixed, fixedBy }) => {
-        const { root, hint } = await rootFor(server, sessions, { projectRoot, sessionId });
-        if (!root)
-            return qaError({ what: 'Could not resolve a project root', changedState: false, retrySafe: true, nextSteps: ['Pass projectRoot or sessionId.'], clientHint: hint });
-        if (!issueId && !fingerprint)
-            return qaError({ what: 'Provide issueId or fingerprint', changedState: false, retrySafe: true, nextSteps: ['Re-call with issueId or fingerprint.'] });
-        const policy = loadPolicy(root);
-        const sourceRevision = resolveSourceRevision({ env: process.env, allowGitMetadataRead: policy.allowGitMetadataRead, root, explicit: fixedInCommit ? { provider: 'explicit', commit: fixedInCommit } : undefined });
-        const res = markFixed(root, { issueId, fingerprint }, { fixedInCommit, fixedInVersion, howFixed, fixedBy, sourceRevision }, nowIso());
-        if (!res.ok)
-            return qaError({ what: res.reason ?? 'mark-fixed failed', changedState: false, retrySafe: true, nextSteps: ['Confirm the issueId/fingerprint via qa_issue_log.'] });
-        return qaOk({ record: res.record, resourceUri: issuesResourceUri(root) }, `marked ${res.record.issueId} fixed${res.record.fixedInCommit ? ` in ${res.record.fixedInCommit}` : ''}`);
-    });
-    // --- qa_issue_triage ---------------------------------------------------------------------
-    server.registerTool('qa_issue_triage', {
-        title: 'Triage an issue',
-        description: 'Change an issue\'s category, severity, owner, or add a note. Appends a `triaged` event (append-only audit trail).',
-        inputSchema: {
-            projectRoot: z.string().optional(),
-            sessionId: z.string().optional(),
-            ...KEY_SCHEMA,
-            category: z.enum(ALL_ISSUE_CATEGORIES).optional(),
-            severity: z.enum(ALL_ISSUE_SEVERITIES).optional(),
-            owner: z.enum(['app', 'backend', 'test_env', 'mcp', 'unknown']).optional(),
-            note: z.string().optional(),
-        },
-    }, async ({ projectRoot, sessionId, issueId, fingerprint, category, severity, owner, note }) => {
-        const { root, hint } = await rootFor(server, sessions, { projectRoot, sessionId });
-        if (!root)
-            return qaError({ what: 'Could not resolve a project root', changedState: false, retrySafe: true, nextSteps: ['Pass projectRoot or sessionId.'], clientHint: hint });
-        if (!issueId && !fingerprint)
-            return qaError({ what: 'Provide issueId or fingerprint', changedState: false, retrySafe: true, nextSteps: ['Re-call with issueId or fingerprint.'] });
-        const res = triageIssue(root, { issueId, fingerprint }, { category: category, severity: severity, owner: owner, note }, nowIso());
-        if (!res.ok)
-            return qaError({ what: res.reason ?? 'triage failed', changedState: false, retrySafe: true, nextSteps: ['Confirm the issueId/fingerprint via qa_issue_log.'] });
-        return qaOk({ record: res.record }, `triaged ${res.record.issueId} → ${res.record.category}/${res.record.severity}`);
-    });
-    // --- qa_issue_suppress -------------------------------------------------------------------
-    server.registerTool('qa_issue_suppress', {
-        title: 'Suppress known noise',
-        description: 'Suppress a known-noise issue with a reason and optional expiration. Suppressed issues are moved OUT of blockers but REMAIN VISIBLE in reports under known-noise — they are never silently hidden.',
-        inputSchema: {
-            projectRoot: z.string().optional(),
-            sessionId: z.string().optional(),
-            ...KEY_SCHEMA,
-            reason: z.string().describe('Why this is known noise.'),
-            until: z.string().optional().describe('ISO timestamp the suppression expires.'),
-            scope: z.enum(['fingerprint', 'platform', 'environment', 'appVersion']).optional(),
-        },
-    }, async ({ projectRoot, sessionId, issueId, fingerprint, reason, until, scope }) => {
-        const { root, hint } = await rootFor(server, sessions, { projectRoot, sessionId });
-        if (!root)
-            return qaError({ what: 'Could not resolve a project root', changedState: false, retrySafe: true, nextSteps: ['Pass projectRoot or sessionId.'], clientHint: hint });
-        if (!issueId && !fingerprint)
-            return qaError({ what: 'Provide issueId or fingerprint', changedState: false, retrySafe: true, nextSteps: ['Re-call with issueId or fingerprint.'] });
-        const res = suppressIssue(root, { issueId, fingerprint }, { reason, until, scope: scope }, nowIso());
-        if (!res.ok)
-            return qaError({ what: res.reason ?? 'suppress failed', changedState: false, retrySafe: true, nextSteps: ['Confirm the issueId/fingerprint via qa_issue_log.'] });
-        return qaOk({ record: res.record }, `suppressed ${res.record.issueId} (${reason}) — still visible under known-noise`);
-    });
-    // --- qa_issue_verify_fixed ---------------------------------------------------------------
-    server.registerTool('qa_issue_verify_fixed', {
-        title: 'Verify a fixed issue with evidence',
-        description: 'Link a passing test/audit result to a FIXED issue and record `verified_fixed` evidence. Requires the issue to be in state "fixed" AND current-run evidence (a reportUri, testCaseId, auditCheckId, or evidenceUris) — a fix cannot be claimed verified without proof. After this, reports may list the issue under "fixed issues verified this run". A reappearance still reopens it with recurrence text.',
-        inputSchema: {
-            projectRoot: z.string().optional(),
-            sessionId: z.string().optional(),
-            ...KEY_SCHEMA,
-            testCaseId: z.string().optional(),
-            auditCheckId: z.string().optional(),
-            reportUri: z.string().optional(),
-            evidenceUris: z.array(z.string()).optional(),
-            note: z.string().optional(),
-        },
-    }, async ({ projectRoot, sessionId, issueId, fingerprint, testCaseId, auditCheckId, reportUri, evidenceUris, note }) => {
-        const { root, hint } = await rootFor(server, sessions, { projectRoot, sessionId });
-        if (!root)
-            return qaError({ what: 'Could not resolve a project root', changedState: false, retrySafe: true, nextSteps: ['Pass projectRoot or sessionId.'], clientHint: hint });
-        if (!issueId && !fingerprint)
-            return qaError({ what: 'Provide issueId or fingerprint', changedState: false, retrySafe: true, nextSteps: ['Re-call with issueId or fingerprint.'] });
-        const res = verifyFixed(root, { issueId, fingerprint }, { testCaseId, auditCheckId, reportUri, evidenceUris, note }, nowIso());
-        if (!res.ok)
-            return qaError({ what: res.reason ?? 'verify-fixed failed', changedState: false, retrySafe: true, nextSteps: ['Mark the issue fixed first (qa_issue_mark_fixed), and provide current-run evidence.'] });
-        return qaOk({ record: res.record }, `verified ${res.record.issueId} fixed with current-run evidence`);
-    });
-    // --- qa_issue_metrics --------------------------------------------------------------------
-    server.registerTool('qa_issue_metrics', {
-        title: 'Issue quality metrics',
-        description: 'Project-level issue quality metrics derived from the append-only event log: opened/fixed/reopened/verified-fixed counts, issue aging (avg + p95), reopen rate (fixed issues that later reopened), fix-verification rate (fixed issues with verified_fixed evidence), open blocker/high counts, top recurring + aging issues, and a time/version/category series. Answers "is the product improving?".',
-        inputSchema: {
-            projectRoot: z.string().optional(),
-            sessionId: z.string().optional(),
-            since: z.string().optional().describe('ISO start of the window.'),
-            until: z.string().optional().describe('ISO end of the window (defaults to the latest event).'),
-            groupBy: z.enum(['day', 'week', 'version', 'commit', 'category', 'owner', 'screen', 'feature']).optional().describe('Series bucket (default week).'),
-            includeSuppressed: z.boolean().optional(),
-        },
-    }, async ({ projectRoot, sessionId, since, until, groupBy, includeSuppressed }) => {
-        const { root, hint } = await rootFor(server, sessions, { projectRoot, sessionId });
-        if (!root)
-            return qaError({ what: 'Could not resolve a project root', changedState: false, retrySafe: true, nextSteps: ['Pass projectRoot or sessionId.'], clientHint: hint });
-        const metrics = computeIssueMetrics(readEvents(root), { since, until, groupBy: groupBy, includeSuppressed });
-        return qaOk({ metrics, resourceUri: issuesResourceUri(root) }, `issue metrics: opened=${metrics.opened} fixed=${metrics.fixed} reopened=${metrics.reopened} verifiedFixed=${metrics.verifiedFixed} | reopenRate=${metrics.reopenRatePct}% fixVerify=${metrics.fixVerificationRatePct}% | openBlocker=${metrics.blockerOpenCount} openHigh=${metrics.highOpenCount}`);
+        return qaOk({
+            issues: compact,
+            counts: res.counts,
+            recurrenceCandidates: res.recurrenceCandidates.map((r) => r.issueId),
+        }, `${res.counts.total} issue(s): ${Object.entries(res.counts.byState)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(' ')}${res.recurrenceCandidates.length ? ` | ${res.recurrenceCandidates.length} recurrence candidate(s)` : ''}`);
     });
 }
 //# sourceMappingURL=issues.js.map

package/dist/tools/issues.js.map

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

package/dist/tools/jobs.js

@@ -1,29 +1,73 @@
-// qa_job_status / qa_job_cancel — poll or cancel a long-running job (boot/install).
+// qa_job_status / qa_job_cancel: poll (or long-poll with waitMs) or cancel a background job.
 // Lets a client reconnect after a tool-call timeout instead of restarting the work.
 import { z } from 'zod';
-import { qaOk, qaError } from '../lib/result.js';
+import { qaOk, qaError, unknownSessionError } from '../lib/result.js';
 import { progressLine } from '../session/progress.js';
+/** Upper bound for qa_job_status waitMs. Keeps one call well under typical client tool timeouts. */
+export const MAX_JOB_WAIT_MS = 120_000;
+const JOB_POLL_INTERVAL_MS = 500;
+const sleep = (ms) => new Promise((r) => setTimeout(r, Math.max(0, ms)));
 export function registerJobs(server, sessions) {
     server.registerTool('qa_job_status', {
-        title: 'Job status',
-        description: 'Status of a long-running job (e.g. from qa_prepare_target / qa_test_this execute): running/done/failed/cancelled, the structured progressDetail (phase/elapsed/statusText/nextExpected/logUri/userActionRequired), and the result/error when finished. For a qa_test_this execute job the result carries the terminal state (completed/blocked/unsafe), reportUri, suite, smoke, and health.',
-        inputSchema: { sessionId: z.string(), jobId: z.string() },
-    }, async ({ sessionId, jobId }) => {
-        const job = sessions.get(sessionId)?.jobs.get(jobId);
+        title: 'Job status (optionally wait)',
+        description: 'Status of a background job (qa_test_this, qa_prepare_target, qa_explore, qa_build run, …): status ' +
+            '(running/done/failed/cancelled), progressDetail, and result/error when finished (for qa_test_this: state completed/blocked/unsafe/needs_input, ' +
+            'reportUri, suite, smoke, health). waitMs long-polls: returns once the job leaves "running", or with ' +
+            'waited.timedOut:true.',
+        inputSchema: {
+            sessionId: z.string(),
+            jobId: z.string(),
+            waitMs: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe(`Block up to this many ms for the job to finish (capped at ${MAX_JOB_WAIT_MS}). Default 0 = return immediately.`),
+        },
+    }, async ({ sessionId, jobId, waitMs }, extra) => {
+        const session = sessions.get(sessionId);
+        let job = session?.jobs.get(jobId);
+        if (!session)
+            return unknownSessionError(sessionId);
         if (!job) {
-            return qaError({ what: `Unknown job ${jobId}`, changedState: false, retrySafe: true, nextSteps: ['Check the jobId returned by qa_prepare_target.'] });
+            return qaError({
+                what: `Unknown job ${jobId}`,
+                failureCode: 'INVALID_ARGUMENT',
+                changedState: false,
+                retrySafe: true,
+                nextSteps: ['Use the sessionId + jobId returned by the tool that started the job (qa_status lists the last job).'],
+            });
+        }
+        const budget = Math.min(Math.max(0, waitMs ?? 0), MAX_JOB_WAIT_MS);
+        const started = Date.now();
+        while (budget > 0 && job.status === 'running' && Date.now() - started < budget && !extra?.signal?.aborted) {
+            await sleep(Math.min(JOB_POLL_INTERVAL_MS, budget - (Date.now() - started)));
+            job = session.jobs.get(jobId) ?? job;
         }
+        const waited = budget > 0 ? { waitedMs: Date.now() - started, timedOut: job.status === 'running' } : undefined;
         const progLine = progressLine(job.progressDetail);
-        return qaOk({ jobId: job.jobId, kind: job.kind, status: job.status, progress: job.progress, progressDetail: job.progressDetail ?? null, error: job.error, result: job.result, artifactUris: job.artifactUris }, `job ${job.jobId} [${job.kind}] = ${job.status}${progLine ? `\n  ${progLine}` : job.progress ? ` (${job.progress})` : ''}${job.resultText ? `\n${job.resultText}` : ''}${job.error ? `\nerror: ${job.error}` : ''}`);
+        return qaOk({
+            jobId: job.jobId,
+            kind: job.kind,
+            status: job.status,
+            progress: job.progress,
+            progressDetail: job.progressDetail ?? null,
+            error: job.error,
+            result: job.result,
+            artifactUris: job.artifactUris,
+            ...(waited ? { waited } : {}),
+        }, `job ${job.jobId} [${job.kind}] = ${job.status}${progLine ? `\n  ${progLine}` : job.progress ? ` (${job.progress})` : ''}${job.resultText ? `\n${job.resultText}` : ''}${job.error ? `\nerror: ${job.error}` : ''}` +
+            (waited?.timedOut ? `\nstill running after ${waited.waitedMs}ms, call again (waitMs) or qa_job_cancel.` : ''));
     });
     server.registerTool('qa_job_cancel', {
         title: 'Cancel a job',
-        description: 'Cancel a running job; aborts its spawned child processes.',
+        description: 'Cancel a running background job and abort its child processes (build/boot/install/record). Returns {jobId, cancelled}; ' +
+            'cancelled:false means it already finished or is unknown. Side effects already applied are not rolled back.',
         inputSchema: { sessionId: z.string(), jobId: z.string() },
     }, async ({ sessionId, jobId }) => {
         const session = sessions.get(sessionId);
         if (!session)
-            return qaError({ what: `Unknown sessionId ${sessionId}`, changedState: false, retrySafe: true, nextSteps: ['Call qa_start_session first.'] });
+            return unknownSessionError(sessionId);
         const ok = sessions.cancelJob(session, jobId);
         return qaOk({ jobId, cancelled: ok }, ok ? `cancelled ${jobId}` : `job ${jobId} not running (already finished or unknown)`);
     });