projscan 2.2.0 → 2.9.0

package/dist/core/regressionPlan.js

@@ -0,0 +1,226 @@
+import { computeBugHunt } from './bugHunt.js';
+import { computePreflight } from './preflight.js';
+import { computeReleaseTrain } from './releaseTrain.js';
+const DEFAULT_MAX_TARGETS = 8;
+export async function computeRegressionPlan(rootPath, options = {}) {
+    const level = normalizeLevel(options.level);
+    const maxTargets = normalizeMaxTargets(options.maxTargets);
+    const [bugHunt, train, preflight] = await Promise.all([
+        computeBugHunt(rootPath, { maxFindings: maxTargets }),
+        computeReleaseTrain(rootPath, { lines: options.lines }),
+        computePreflight(rootPath, { mode: 'before_commit' }),
+    ]);
+    const allTargets = rankTargets([
+        ...baselineTargets(level),
+        ...bugHuntTargets(bugHunt),
+        ...preflightTargets(preflight),
+        ...releaseLineTargets(train),
+    ]);
+    const targets = allTargets.slice(0, maxTargets);
+    const verdict = regressionVerdict(preflight, bugHunt, targets);
+    const commands = commandsForLevel(level, targets);
+    return {
+        schemaVersion: 1,
+        level,
+        verdict,
+        summary: summarize(verdict, level, targets.length),
+        releaseLines: train.plan.lines,
+        evidence: {
+            healthScore: bugHunt.health.score,
+            bugHuntVerdict: bugHunt.verdict,
+            preflightVerdict: preflight.verdict,
+            changedFiles: preflight.evidence.changedFiles?.count ?? 0,
+            touchedFiles: preflight.evidence.session?.totalTouchedFiles ?? preflight.evidence.session?.touchedFiles.length ?? 0,
+        },
+        targets,
+        commands,
+        suggestedNextActions: suggestedActions(targets),
+        ...(allTargets.length > targets.length ? { truncated: true } : {}),
+    };
+}
+function baselineTargets(level) {
+    return [
+        {
+            id: 'rp-baseline-health',
+            priority: 'p0',
+            source: 'baseline',
+            title: 'Verify the health and safety baseline',
+            why: 'Every product line needs a repeatable health gate before deeper regression work starts.',
+            files: [],
+            verification: {
+                commands: ['projscan doctor --format json', 'projscan preflight --mode before_commit --format json'],
+                expected: 'Doctor has no unresolved error-level issues and preflight does not block the handoff.',
+            },
+        },
+        ...(level === 'full'
+            ? [{
+                    id: 'rp-baseline-release',
+                    priority: 'p1',
+                    source: 'baseline',
+                    title: 'Run full package and stability gates',
+                    why: 'The larger product update should prove build output, stable public surfaces, and readiness checks in one pass.',
+                    files: ['package.json', 'docs/STABILITY.md', 'scripts/check-stability.mjs'],
+                    verification: {
+                        commands: ['npm run build', 'npm run lint', 'npm run check:stability', 'npm run release:check'],
+                        expected: 'Build, lint, stability guard, and release check all pass from the committed tree.',
+                    },
+                }]
+            : []),
+    ];
+}
+function bugHuntTargets(bugHunt) {
+    const first = bugHunt.fixQueue.find((finding) => finding.id !== 'bh-verify-clean');
+    if (!first)
+        return [];
+    return [
+        {
+            id: 'rp-bug-hunt-top',
+            priority: first.priority,
+            source: 'bug-hunt',
+            title: `Regression-cover bug-hunt target: ${first.title}`,
+            why: first.why,
+            files: first.files,
+            verification: {
+                commands: ['projscan bug-hunt --format json', ...first.verification.commands],
+                expected: first.verification.expected,
+            },
+        },
+    ];
+}
+function preflightTargets(preflight) {
+    return preflight.reasons.slice(0, 3).map((reason, index) => ({
+        id: `rp-preflight-${index + 1}`,
+        priority: severityPriority(reason.severity),
+        source: 'preflight',
+        title: `Exercise preflight signal: ${reason.source}`,
+        why: reason.message,
+        files: reason.file ? [reason.file] : [],
+        verification: {
+            commands: ['projscan preflight --mode before_commit --format json', commandForTool(reason.tool)],
+            expected: 'The preflight signal is either gone or documented as accepted risk.',
+        },
+    }));
+}
+function releaseLineTargets(train) {
+    return train.tasks
+        .filter((task) => task.track !== 'plan')
+        .slice(0, 4)
+        .map((task) => ({
+        id: `rp-${task.id}`,
+        priority: task.priority,
+        source: 'product-line',
+        title: `Verify ${task.track}: ${task.title}`,
+        why: task.why,
+        files: task.files,
+        verification: task.verification,
+    }));
+}
+function commandsForLevel(level, targets) {
+    const smoke = ['projscan doctor --format json', 'projscan preflight --mode before_commit --format json'];
+    if (level === 'smoke')
+        return dedupeStrings(smoke);
+    const focused = [
+        ...smoke,
+        'projscan bug-hunt --format json',
+        ...targets.flatMap((target) => target.verification.commands),
+        'npm test',
+    ];
+    if (level === 'focused')
+        return dedupeStrings(focused);
+    return dedupeStrings([
+        ...focused,
+        'npm run build',
+        'npm run lint',
+        'npm run check:stability',
+        'npm run release:check',
+    ]);
+}
+function regressionVerdict(preflight, bugHunt, targets) {
+    if (preflight.verdict === 'block' || bugHunt.verdict === 'block')
+        return 'blocked';
+    if (preflight.verdict === 'caution' || bugHunt.verdict === 'fix' || targets.length > 1)
+        return 'needs_tests';
+    return 'ready';
+}
+function suggestedActions(targets) {
+    return targets.slice(0, 8).map((target) => ({
+        label: target.title,
+        command: target.verification.commands[0],
+    }));
+}
+function rankTargets(targets) {
+    const seen = new Set();
+    return targets
+        .filter((target) => {
+        if (seen.has(target.id))
+            return false;
+        seen.add(target.id);
+        return true;
+    })
+        .sort((a, b) => {
+        const source = sourceRank(a.source) - sourceRank(b.source);
+        if (source !== 0)
+            return source;
+        const priority = priorityRank(a.priority) - priorityRank(b.priority);
+        if (priority !== 0)
+            return priority;
+        return a.id.localeCompare(b.id);
+    });
+}
+function summarize(verdict, level, targetCount) {
+    if (verdict === 'blocked')
+        return `blocked: ${level} regression plan has ${targetCount} target(s) and p0 evidence`;
+    if (verdict === 'needs_tests')
+        return `needs_tests: run ${level} regression plan across ${targetCount} target(s)`;
+    return `ready: ${level} regression baseline has no immediate extra targets`;
+}
+function severityPriority(severity) {
+    if (severity === 'error')
+        return 'p0';
+    if (severity === 'warning')
+        return 'p1';
+    return 'p2';
+}
+function priorityRank(priority) {
+    if (priority === 'p0')
+        return 0;
+    if (priority === 'p1')
+        return 1;
+    return 2;
+}
+function sourceRank(source) {
+    if (source === 'baseline')
+        return 0;
+    if (source === 'bug-hunt')
+        return 1;
+    if (source === 'preflight')
+        return 2;
+    return 3;
+}
+function commandForTool(tool) {
+    if (tool === 'projscan_review')
+        return 'projscan review --format json';
+    if (tool === 'projscan_taint')
+        return 'projscan taint --format json';
+    if (tool === 'projscan_hotspots')
+        return 'projscan hotspots --format json';
+    if (tool === 'projscan_plugin')
+        return 'projscan plugin list --format json';
+    if (tool === 'projscan_preflight')
+        return 'projscan preflight --mode before_commit --format json';
+    return 'projscan doctor --format json';
+}
+function normalizeLevel(value) {
+    if (value === 'smoke' || value === 'focused' || value === 'full')
+        return value;
+    return 'focused';
+}
+function normalizeMaxTargets(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return DEFAULT_MAX_TARGETS;
+    return Math.max(1, Math.min(25, Math.floor(value)));
+}
+function dedupeStrings(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+//# sourceMappingURL=regressionPlan.js.map

package/dist/core/regressionPlan.js.map

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

package/dist/core/releaseEvidence.d.ts

@@ -0,0 +1,7 @@
+import type { EvidencePackReport } from '../types.js';
+export interface ComputeEvidencePackOptions {
+    lines?: string[];
+    includeWebsitePrompt?: boolean;
+    maxFindings?: number;
+}
+export declare function computeEvidencePack(rootPath: string, options?: ComputeEvidencePackOptions): Promise<EvidencePackReport>;

package/dist/core/releaseEvidence.js

@@ -0,0 +1,174 @@
+import { computeBugHunt } from './bugHunt.js';
+import { computePreflight } from './preflight.js';
+import { computeReleaseTrain } from './releaseTrain.js';
+import { computeWorkplan } from './workplan.js';
+export async function computeEvidencePack(rootPath, options = {}) {
+    const [train, bugHunt, workplan, preflight] = await Promise.all([
+        computeReleaseTrain(rootPath, { lines: options.lines }),
+        computeBugHunt(rootPath, { maxFindings: options.maxFindings }),
+        computeWorkplan(rootPath, { mode: 'release', maxTasks: 6 }),
+        computePreflight(rootPath, { mode: 'before_merge' }),
+    ]);
+    const artifacts = buildArtifacts(train, bugHunt, workplan, preflight);
+    const verdict = packVerdict(artifacts);
+    const blockingReasons = blockingEvidence(preflight, bugHunt, workplan);
+    const changelogEntries = buildChangelogEntries();
+    const suggestedNextActions = dedupeActions([
+        ...train.suggestedNextActions,
+        ...workplan.suggestedNextActions,
+        ...preflight.suggestedNextActions,
+        ...bugHunt.fixQueue.slice(0, 4).map((finding) => ({
+            label: finding.title,
+            command: finding.verification.commands[0],
+        })),
+    ]);
+    return {
+        schemaVersion: 1,
+        currentVersion: train.currentVersion,
+        readOnly: true,
+        verdict,
+        summary: summarize(verdict, train, blockingReasons),
+        train: {
+            lines: train.plan.lines,
+            readiness: train.readiness,
+        },
+        approval: {
+            required: true,
+            recommendation: approvalRecommendation(verdict),
+            blockingReasons,
+        },
+        artifacts,
+        changelogEntries,
+        ...(options.includeWebsitePrompt ? { websitePrompt: buildWebsitePrompt(train, changelogEntries) } : {}),
+        suggestedNextActions,
+    };
+}
+function buildArtifacts(train, bugHunt, workplan, preflight) {
+    return [
+        {
+            id: 'ep-release-train',
+            title: 'Product plan readiness',
+            status: statusFromPreflight(train.readiness.verdict),
+            summary: train.readiness.summary,
+            evidence: [
+                `${train.plan.lines.length} product line(s): ${train.plan.lines.join(', ')}`,
+                `${train.readiness.blockers} blocker(s), ${train.readiness.cautions} caution(s)`,
+                'read-only evidence: yes',
+            ],
+            commands: ['projscan release-train --format json'],
+        },
+        {
+            id: 'ep-bug-hunt',
+            title: 'Bug-hunt queue',
+            status: bugHunt.verdict === 'block' ? 'blocked' : bugHunt.verdict === 'fix' ? 'caution' : 'ready',
+            summary: bugHunt.summary,
+            evidence: [
+                `health score ${bugHunt.health.score}`,
+                `${bugHunt.fixQueue.length} fix target(s) in queue`,
+                `preflight evidence during bug hunt: ${bugHunt.evidence.preflightVerdict}`,
+            ],
+            commands: ['projscan bug-hunt --format json'],
+        },
+        {
+            id: 'ep-workplan',
+            title: 'Agent workplan',
+            status: statusFromPreflight(workplan.verdict),
+            summary: workplan.summary,
+            evidence: [
+                `${workplan.tasks.length} task(s)`,
+                `${workplan.topRisks.length} top risk(s)`,
+                workplan.coordination.recommendedNextAgent,
+            ],
+            commands: ['projscan workplan --mode release --format json', 'projscan handoff --mode release'],
+        },
+        {
+            id: 'ep-preflight',
+            title: 'Preflight gate',
+            status: statusFromPreflight(preflight.verdict),
+            summary: preflight.summary,
+            evidence: preflight.requiredChecks.map((check) => `${check.name}: ${check.status}`),
+            commands: ['projscan preflight --mode before_merge --format json'],
+        },
+    ];
+}
+function blockingEvidence(preflight, bugHunt, workplan) {
+    return dedupeStrings([
+        ...preflight.reasons
+            .filter((reason) => reason.severity === 'error')
+            .map((reason) => reason.message),
+        ...(bugHunt.verdict === 'block'
+            ? bugHunt.fixQueue
+                .filter((finding) => finding.priority === 'p0')
+                .map((finding) => finding.title)
+            : []),
+        ...(workplan.verdict === 'block'
+            ? workplan.topRisks
+                .filter((risk) => risk.priority === 'p0')
+                .map((risk) => risk.message)
+            : []),
+    ]).slice(0, 10);
+}
+function buildChangelogEntries() {
+    return [
+        '`projscan_evidence_pack` / `projscan evidence-pack` produce one approval-ready packet with planning, preflight, workplan, bug-hunt, changelog, and website-update evidence.',
+        '`projscan_regression_plan` / `projscan regression-plan` build a smoke/focused/full verification matrix from bug-hunt, preflight, and product risk.',
+        '`projscan_agent_brief` / `projscan agent-brief` create compact next-agent context packets with focus items, guardrails, and repo context.',
+        '`projscan_quality_scorecard` / `projscan quality-scorecard` summarize health, security, tests, maintainability, and coordination with top risks and commands.',
+    ];
+}
+function buildWebsitePrompt(train, changelogEntries) {
+    return [
+        'Update the projscan website for the next release using the current repository evidence.',
+        `Product lines covered: ${train.plan.lines.join(', ')}.`,
+        'Highlight the new agent-facing surfaces: projscan_workplan, projscan_bug_hunt, projscan_release_train, projscan_evidence_pack, projscan_regression_plan, projscan_agent_brief, and projscan_quality_scorecard.',
+        'Use these product bullets:',
+        ...changelogEntries.map((entry) => `- ${entry}`),
+        'Keep claims grounded in the completed product evidence.',
+    ].join('\n');
+}
+function packVerdict(artifacts) {
+    if (artifacts.some((artifact) => artifact.status === 'blocked'))
+        return 'blocked';
+    if (artifacts.some((artifact) => artifact.status === 'caution'))
+        return 'caution';
+    return 'ready';
+}
+function summarize(verdict, train, blockingReasons) {
+    if (verdict === 'blocked') {
+        return `blocked: ${blockingReasons[0] ?? 'product evidence still contains blocking signals'}`;
+    }
+    if (verdict === 'caution') {
+        return `caution: ${train.plan.lines.join(', ')} evidence is assembled but still needs explicit review`;
+    }
+    return `ready: ${train.plan.lines.join(', ')} evidence is assembled for approval`;
+}
+function approvalRecommendation(verdict) {
+    if (verdict === 'blocked')
+        return 'Do not approve launch until p0 evidence is cleared or accepted.';
+    if (verdict === 'caution')
+        return 'Review cautions, then approve only after the regression plan passes.';
+    return 'Approval can proceed after the recorded regression commands pass.';
+}
+function statusFromPreflight(verdict) {
+    if (verdict === 'block')
+        return 'blocked';
+    if (verdict === 'caution')
+        return 'caution';
+    return 'ready';
+}
+function dedupeActions(actions) {
+    const seen = new Set();
+    const result = [];
+    for (const action of actions) {
+        const key = `${action.label}:${action.command ?? ''}:${action.tool ?? ''}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(action);
+    }
+    return result.slice(0, 12);
+}
+function dedupeStrings(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+//# sourceMappingURL=releaseEvidence.js.map

package/dist/core/releaseEvidence.js.map

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

package/dist/core/releaseTrain.d.ts

@@ -0,0 +1,5 @@
+import type { ReleaseTrainReport } from '../types.js';
+export interface ComputeReleaseTrainOptions {
+    lines?: string[];
+}
+export declare function computeReleaseTrain(rootPath: string, options?: ComputeReleaseTrainOptions): Promise<ReleaseTrainReport>;