projscan 2.1.0 → 2.8.0

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>;

package/dist/core/releaseTrain.js

@@ -0,0 +1,348 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { computePreflight } from './preflight.js';
+export async function computeReleaseTrain(rootPath, options = {}) {
+    const currentVersion = await readPackageVersion(rootPath);
+    const lines = normalizeLines(options.lines, currentVersion);
+    const preflight = await computePreflight(rootPath, { mode: 'before_merge' });
+    const blockers = preflight.reasons.filter((reason) => reason.severity === 'error').length;
+    const cautions = preflight.reasons.filter((reason) => reason.severity === 'warning').length;
+    const tracks = lines.map(trackForLine);
+    const tasks = rankTasks([
+        ...(blockers > 0
+            ? [{
+                    id: 'rt-blockers-first',
+                    priority: 'p0',
+                    title: 'Clear readiness blockers',
+                    why: 'Product planning should stay anchored to active safety and quality evidence.',
+                    track: 'plan',
+                    files: filesFromPreflight(preflight.reasons),
+                    verification: {
+                        commands: ['projscan preflight --mode before_merge --format json'],
+                        expected: 'Preflight no longer returns block.',
+                    },
+                }]
+            : []),
+        ...tracks.flatMap(tasksForTrack),
+        {
+            id: 'rt-plan-readiness',
+            priority: blockers > 0 ? 'p1' : 'p0',
+            title: 'Prove product readiness',
+            why: 'The product needs one final local gate across docs, tests, stability metadata, and package contents before handoff.',
+            track: 'plan',
+            files: ['CHANGELOG.md', 'README.md', 'docs/STABILITY.md', 'package.json'],
+            verification: {
+                commands: ['npm test', 'npm run build', 'npm run check:stability', 'npm run release:check'],
+                expected: 'All readiness checks pass before handoff.',
+            },
+        },
+    ]);
+    return {
+        schemaVersion: 1,
+        currentVersion,
+        plan: {
+            policy: 'product-readiness-plan',
+            lines,
+            readOnly: true,
+        },
+        readiness: {
+            verdict: preflight.verdict,
+            blockers,
+            cautions,
+            summary: preflight.summary,
+        },
+        tracks,
+        tasks,
+        suggestedNextActions: suggestedActions(tasks, preflight.suggestedNextActions),
+    };
+}
+function trackForLine(line) {
+    if (line.startsWith('2.3')) {
+        return {
+            line,
+            theme: 'Agent Mission Control',
+            outcome: 'Agents can decide what to do next, hand off safely, and prove readiness without rereading the whole repo.',
+            includedInPlan: true,
+            scope: [
+                'prioritized workplans',
+                'handoff-ready next actions',
+                'readiness planning',
+            ],
+            successCriteria: [
+                'MCP and CLI expose the same planning contracts',
+                'plans include evidence, priority, and verification commands',
+                'planning output stays read-only',
+            ],
+        };
+    }
+    if (line.startsWith('2.4')) {
+        return {
+            line,
+            theme: 'Autonomous Bug Hunt',
+            outcome: 'Agents get a ranked fix queue that combines health, preflight, hotspots, and coordination evidence.',
+            includedInPlan: true,
+            scope: [
+                'bug-hunt fix queue',
+                'verification matrix',
+                'broad test-suite reliability pass',
+            ],
+            successCriteria: [
+                'bug-hunt output names the first fix target and commands to prove it',
+                'clean repos still receive reproducible verification guidance',
+                'full project verification passes from the committed tree',
+            ],
+        };
+    }
+    if (line.startsWith('2.5')) {
+        return {
+            line,
+            theme: 'Release Evidence Pack',
+            outcome: 'Humans and agents get one approval packet that ties product scope, preflight evidence, bug-hunt status, workplan tasks, and website-update copy together.',
+            includedInPlan: true,
+            scope: [
+                'approval-ready evidence packet',
+                'product-facing changelog and website prompt',
+                'read-only evidence gathering',
+            ],
+            successCriteria: [
+                'evidence pack includes planning, bug hunt, workplan, and preflight artifacts',
+                'website update prompt is generated only as text evidence',
+                'evidence generation stays read-only',
+            ],
+        };
+    }
+    if (line.startsWith('2.6')) {
+        return {
+            line,
+            theme: 'Regression Planning',
+            outcome: 'Agents get a smoke, focused, or full regression matrix that turns product risk into concrete verification commands.',
+            includedInPlan: true,
+            scope: [
+                'risk-based regression targets',
+                'smoke/focused/full verification levels',
+                'deduplicated command matrix',
+            ],
+            successCriteria: [
+                'regression plan includes commands for the selected level',
+                'bug-hunt and preflight signals become explicit regression targets',
+                'full level covers tests, build, lint, stability, and package checks',
+            ],
+        };
+    }
+    if (line.startsWith('2.7')) {
+        return {
+            line,
+            theme: 'Agent Brief',
+            outcome: 'Agents get a compact context packet with focus items, repo context, guardrails, and suggested next actions.',
+            includedInPlan: true,
+            scope: [
+                'next-agent focus packet',
+                'guardrail commands',
+                'session and repo context summary',
+            ],
+            successCriteria: [
+                'brief includes health, context, focus, guardrails, and next actions',
+                'CLI and MCP expose the same schema',
+                'brief output stays compact enough for handoff',
+            ],
+        };
+    }
+    if (line.startsWith('2.8')) {
+        return {
+            line,
+            theme: 'Quality Scorecard',
+            outcome: 'Agents and reviewers get a dimensioned quality view with top risks and verification commands.',
+            includedInPlan: true,
+            scope: [
+                'quality dimensions',
+                'top-risk ranking',
+                'verification command set',
+            ],
+            successCriteria: [
+                'scorecard reports health, security, tests, maintainability, and coordination',
+                'top risks include concrete commands',
+                'CLI and MCP expose the same scorecard schema',
+            ],
+        };
+    }
+    return {
+        line,
+        theme: 'Quality Hardening',
+        outcome: 'The line gets explicit readiness checks.',
+        includedInPlan: true,
+        scope: ['quality fixes', 'documentation alignment', 'readiness checks'],
+        successCriteria: ['all checks pass', 'public surface is documented', 'planning output stays read-only'],
+    };
+}
+function tasksForTrack(track) {
+    if (track.line.startsWith('2.3')) {
+        return [
+            {
+                id: 'rt-2-3-agent-readiness',
+                priority: 'p0',
+                title: 'Finish agent mission-control readiness',
+                why: 'Planning tools only matter if they produce short, ordered, evidence-backed actions that another agent can execute.',
+                track: track.line,
+                files: ['src/core/workplan.ts', 'src/cli/commands/workplan.ts', 'src/mcp/tools/workplan.ts'],
+                verification: {
+                    commands: ['projscan workplan --mode release --format json', 'projscan handoff'],
+                    expected: 'Workplan and handoff both include prioritized tasks and verification commands.',
+                },
+            },
+        ];
+    }
+    if (track.line.startsWith('2.4')) {
+        return [
+            {
+                id: 'rt-2-4-bug-hunt-gate',
+                priority: 'p0',
+                title: 'Ship the autonomous bug-hunt gate',
+                why: 'Before a larger release, the product should tell agents where to polish first and how to prove each fix.',
+                track: track.line,
+                files: ['src/core/bugHunt.ts', 'src/cli/commands/bugHunt.ts', 'src/mcp/tools/bugHunt.ts'],
+                verification: {
+                    commands: ['projscan bug-hunt --format json', 'npm test'],
+                    expected: 'Bug hunt returns a prioritized fix queue and the test suite passes.',
+                },
+            },
+        ];
+    }
+    if (track.line.startsWith('2.5')) {
+        return [
+            {
+                id: 'rt-2-5-evidence-pack',
+                priority: 'p0',
+                title: 'Assemble the release evidence pack',
+                why: 'A larger product update needs one human-readable evidence packet instead of scattered command output.',
+                track: track.line,
+                files: ['src/core/releaseEvidence.ts', 'src/cli/commands/evidencePack.ts', 'src/mcp/tools/evidencePack.ts'],
+                verification: {
+                    commands: ['projscan evidence-pack --line 2.3.x --line 2.4.x --line 2.5.x --line 2.6.x --line 2.7.x --line 2.8.x --format json'],
+                    expected: 'Evidence pack returns all planned lines, approval evidence, and changelog entries.',
+                },
+            },
+        ];
+    }
+    if (track.line.startsWith('2.6')) {
+        return [
+            {
+                id: 'rt-2-6-regression-plan',
+                priority: 'p0',
+                title: 'Ship the regression planning matrix',
+                why: 'A bigger product update should tell agents exactly which smoke, focused, and full checks prove readiness.',
+                track: track.line,
+                files: ['src/core/regressionPlan.ts', 'src/cli/commands/regressionPlan.ts', 'src/mcp/tools/regressionPlan.ts'],
+                verification: {
+                    commands: ['projscan regression-plan --level full --format json', 'npm test'],
+                    expected: 'Regression plan returns a deduplicated command matrix and the project suite passes.',
+                },
+            },
+        ];
+    }
+    if (track.line.startsWith('2.7')) {
+        return [
+            {
+                id: 'rt-2-7-agent-brief',
+                priority: 'p0',
+                title: 'Ship the agent brief',
+                why: 'Agents need a compact context packet that can be read quickly before choosing the next action.',
+                track: track.line,
+                files: ['src/core/agentBrief.ts', 'src/cli/commands/agentBrief.ts', 'src/mcp/tools/agentBrief.ts'],
+                verification: {
+                    commands: ['projscan agent-brief --intent release --format json'],
+                    expected: 'Agent brief returns focus, context, guardrails, and suggested next actions.',
+                },
+            },
+        ];
+    }
+    if (track.line.startsWith('2.8')) {
+        return [
+            {
+                id: 'rt-2-8-quality-scorecard',
+                priority: 'p0',
+                title: 'Ship the quality scorecard',
+                why: 'Agents and reviewers need a dimensioned quality view before deciding what to polish next.',
+                track: track.line,
+                files: ['src/core/qualityScorecard.ts', 'src/cli/commands/qualityScorecard.ts', 'src/mcp/tools/qualityScorecard.ts'],
+                verification: {
+                    commands: ['projscan quality-scorecard --format json'],
+                    expected: 'Quality scorecard returns dimensions, top risks, and verification commands.',
+                },
+            },
+        ];
+    }
+    return [
+        {
+            id: `rt-${slug(track.line)}-quality`,
+            priority: 'p1',
+            title: `Plan ${track.line} quality work`,
+            why: 'Every product line needs an explicit verification task.',
+            track: track.line,
+            files: [],
+            verification: {
+                commands: ['npm test', 'npm run lint'],
+                expected: 'Quality checks pass for this product line.',
+            },
+        },
+    ];
+}
+function suggestedActions(tasks, preflightActions) {
+    return [
+        ...tasks.slice(0, 5).map((task) => ({
+            label: task.title,
+            command: task.verification.commands[0],
+        })),
+        ...preflightActions,
+    ].slice(0, 12);
+}
+async function readPackageVersion(rootPath) {
+    try {
+        const raw = await fs.readFile(path.join(rootPath, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        return typeof pkg.version === 'string' ? pkg.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeLines(lines, currentVersion) {
+    const cleaned = (lines ?? []).map((line) => line.trim()).filter(Boolean);
+    if (cleaned.length > 0)
+        return [...new Set(cleaned)];
+    const [major = 0, minor = 0] = (currentVersion ?? '2.2.0').split('.').map((part) => Number.parseInt(part, 10));
+    const safeMajor = Number.isFinite(major) ? major : 2;
+    const safeMinor = Number.isFinite(minor) ? minor : 2;
+    return [
+        `${safeMajor}.${safeMinor + 1}.x`,
+        `${safeMajor}.${safeMinor + 2}.x`,
+        `${safeMajor}.${safeMinor + 3}.x`,
+        `${safeMajor}.${safeMinor + 4}.x`,
+        `${safeMajor}.${safeMinor + 5}.x`,
+        `${safeMajor}.${safeMinor + 6}.x`,
+    ];
+}
+function rankTasks(tasks) {
+    return tasks.sort((a, b) => {
+        const blocker = blockerRank(a.id) - blockerRank(b.id);
+        if (blocker !== 0)
+            return blocker;
+        return priorityRank(a.priority) - priorityRank(b.priority) || a.id.localeCompare(b.id);
+    });
+}
+function filesFromPreflight(reasons) {
+    return [...new Set(reasons.map((reason) => reason.file).filter((file) => typeof file === 'string'))];
+}
+function priorityRank(priority) {
+    if (priority === 'p0')
+        return 0;
+    if (priority === 'p1')
+        return 1;
+    return 2;
+}
+function blockerRank(id) {
+    return id === 'rt-blockers-first' ? 0 : 1;
+}
+function slug(value) {
+    return value.replace(/[^a-zA-Z0-9]+/g, '-').replace(/^-+|-+$/g, '').toLowerCase() || 'line';
+}
+//# sourceMappingURL=releaseTrain.js.map

package/dist/core/releaseTrain.js.map

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

package/dist/core/review.js

@@ -40,6 +40,32 @@ export async function computeReview(rootPath, options = {}) {
     if (!baseSha) {
         return unavailable(`Could not resolve base ref "${baseRef}".`, options, baseRef, headRef, headSha);
     }
+    if (headSha && headSha === baseSha) {
+        const report = {
+            available: true,
+            base: { ref: baseRef, resolvedSha: baseSha },
+            head: { ref: headRef, resolvedSha: headSha },
+            prDiff: {
+                available: true,
+                base: { ref: baseRef, resolvedSha: baseSha },
+                head: { ref: headRef, resolvedSha: headSha },
+                filesAdded: [],
+                filesRemoved: [],
+                filesModified: [],
+                totalFilesChanged: 0,
+            },
+            changedFiles: [],
+            newCycles: [],
+            riskyFunctions: [],
+            dependencyChanges: [],
+            contractChanges: [],
+            newTaintFlows: [],
+            verdict: 'ok',
+            summary: ['No structural changes detected between base and head.'],
+        };
+        applyIntent(report, options.intent);
+        return report;
+    }
     // Head-side data: scan + graph + issues + hotspots.
     const headScan = await scanRepository(rootPath);
     const headGraph = await buildCodeGraph(rootPath, headScan.files);
@@ -159,7 +185,11 @@ export async function computeReview(rootPath, options = {}) {
     // annotate each finding with an alignment label, and append a
     // small intent summary to the verdict bullets. Does NOT change the
     // verdict — verdict stays structural.
-    const intent = parseIntent(options.intent);
+    applyIntent(report, options.intent);
+    return report;
+}
+function applyIntent(report, rawIntent) {
+    const intent = parseIntent(rawIntent);
     if (intent) {
         const analysis = annotateReviewWithIntent(report, intent);
         report.intent = {
@@ -173,7 +203,6 @@ export async function computeReview(rootPath, options = {}) {
         };
         appendIntentToSummary(report.summary, analysis);
     }
-    return report;
 }
 async function computeNewTaintFlows(rootPath, baseGraph, headGraph, touchedFiles) {
     const { config } = await loadConfig(rootPath);