projscan 4.4.0 → 4.6.0

package/dist/core/releaseTrainFallbacks.js

@@ -0,0 +1,318 @@
+export function fallbackTrackForLine(line) {
+    if (line.startsWith('3.0')) {
+        return {
+            line,
+            theme: 'Graph Operations Readiness',
+            outcome: 'Agents can trust graph-backed review, impact, dataflow, and release gates during everyday repo work.',
+            includedInPlan: true,
+            scope: [
+                'graph corpus release gate',
+                'dataflow precision hardening',
+                'ownership-aware impact',
+            ],
+            successCriteria: [
+                'release readiness runs the graph corpus baseline gate',
+                'custom dataflow rules stay visible when users configure them',
+                'impact boundary summaries identify likely owners when metadata exists',
+            ],
+        };
+    }
+    if (line.startsWith('3.1')) {
+        return {
+            line,
+            theme: 'Graph Intelligence Expansion',
+            outcome: 'Agents get narrower package-scoped evidence and richer framework-aware dataflow before editing high-risk paths.',
+            includedInPlan: true,
+            scope: [
+                'package-scoped review evidence',
+                'framework route dataflow precision',
+                'deeper ownership and package boundary metadata',
+            ],
+            successCriteria: [
+                'review package filters apply to taint, dataflow, graph evidence, and verdicts',
+                'route and request-handler dataflow avoids generated-code noise',
+                'impact reports keep ownership context without expanding the stable schema',
+            ],
+        };
+    }
+    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 action queue that combines health, preflight, hotspots, and coordination evidence.',
+            includedInPlan: true,
+            scope: ['bug-hunt action queue', 'verification matrix', 'broad test-suite reliability pass'],
+            successCriteria: [
+                'bug-hunt output names the first prioritized action 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'],
+    };
+}
+export function fallbackTasksForTrack(track) {
+    if (track.line.startsWith('3.0')) {
+        return [
+            {
+                id: 'rt-3-0-graph-readiness',
+                priority: 'p0',
+                title: 'Harden graph operations readiness',
+                why: 'Agents trust projscan when graph/dataflow signals are gated, precise, and routed to the right owners.',
+                track: track.line,
+                files: ['scripts/release-check.mjs', 'src/core/dataflowFilters.ts', 'src/core/impact.ts'],
+                verification: {
+                    commands: [
+                        'npm run release:check',
+                        'npm run check:graph-corpus',
+                        'projscan impact --symbol foo --cross-repo --format json',
+                    ],
+                    expected: 'Release readiness includes graph corpus checks, custom dataflow rules remain visible, and impact reports ownership boundaries.',
+                },
+            },
+        ];
+    }
+    if (track.line.startsWith('3.1')) {
+        return [
+            {
+                id: 'rt-3-1-graph-expansion',
+                priority: 'p1',
+                title: 'Expand graph intelligence precision',
+                why: 'The next product step should make high-risk review evidence narrower and framework-aware without forcing agents to inspect full graphs.',
+                track: track.line,
+                files: ['src/core/review.ts', 'src/core/dataflow.ts', 'src/core/impact.ts'],
+                verification: {
+                    commands: [
+                        'projscan review --base main --head HEAD --format json',
+                        'projscan dataflow --format json',
+                    ],
+                    expected: 'Review and dataflow evidence are scoped to the relevant package, route, and ownership boundaries.',
+                },
+            },
+        ];
+    }
+    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 action 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 slug(value) {
+    return (value
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase() || 'line');
+}
+//# sourceMappingURL=releaseTrainFallbacks.js.map

package/dist/core/releaseTrainFallbacks.js.map

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

package/dist/core/reportScope.d.ts

@@ -0,0 +1,24 @@
+import type { AnalysisReport, Issue } from '../types.js';
+import type { ReportPolicyPreset } from '../types/config.js';
+export interface ReportControlOptions {
+    scopes?: string[];
+    redactPaths?: boolean;
+}
+export interface ReportControlsMetadata {
+    active: true;
+    scopeCount: number;
+    redactPaths: boolean;
+    pathLabelFormat?: 'redacted-path-N';
+}
+interface ResolveReportControlsInput {
+    reportPolicies?: Record<string, ReportPolicyPreset>;
+    reportPolicy?: unknown;
+    reportScope?: unknown;
+    redactPaths?: unknown;
+}
+export declare function parseReportScopes(input: unknown): string[];
+export declare function resolveReportControls(input: ResolveReportControlsInput): ReportControlOptions;
+export declare function applyReportControlsToIssues(issues: Issue[], options?: ReportControlOptions): Issue[];
+export declare function reportControlsMetadata(options?: ReportControlOptions): ReportControlsMetadata | undefined;
+export declare function applyReportControlsToAnalysis(report: AnalysisReport, options?: ReportControlOptions): AnalysisReport;
+export {};

package/dist/core/reportScope.js

@@ -0,0 +1,234 @@
+export function parseReportScopes(input) {
+    if (typeof input !== 'string')
+        return [];
+    return input
+        .split(',')
+        .map(normalizeReportPath)
+        .filter((scope) => Boolean(scope));
+}
+export function resolveReportControls(input) {
+    let controls = {};
+    if (typeof input.reportPolicy === 'string') {
+        const policyName = input.reportPolicy.trim();
+        if (!policyName) {
+            throw new Error('Missing report policy name. Pass --report-policy <name> with a configured preset.');
+        }
+        const policy = input.reportPolicies?.[policyName];
+        if (!policy) {
+            throw new Error(`Unknown report policy "${policyName}". Define reportPolicies.${policyName} in .projscanrc.json or remove --report-policy.`);
+        }
+        controls = {
+            scopes: normalizeScopes(policy.reportScope),
+            redactPaths: policy.redactPaths === true,
+        };
+    }
+    const directScopes = parseReportScopes(input.reportScope);
+    if (directScopes.length > 0)
+        controls.scopes = directScopes;
+    if (input.redactPaths === true)
+        controls.redactPaths = true;
+    return controls;
+}
+export function applyReportControlsToIssues(issues, options = {}) {
+    return applyReportControlsToIssuesWithRedactor(issues, normalizeScopes(options.scopes), options.redactPaths ? createPathRedactor() : null);
+}
+export function reportControlsMetadata(options = {}) {
+    const scopes = normalizeScopes(options.scopes);
+    const redactPaths = options.redactPaths === true;
+    if (scopes.length === 0 && !redactPaths)
+        return undefined;
+    return {
+        active: true,
+        scopeCount: scopes.length,
+        redactPaths,
+        ...(redactPaths ? { pathLabelFormat: 'redacted-path-N' } : {}),
+    };
+}
+export function applyReportControlsToAnalysis(report, options = {}) {
+    const scopes = normalizeScopes(options.scopes);
+    const redactor = options.redactPaths ? createPathRedactor() : null;
+    const files = filterFilesByScope(report.scan.files, scopes).map((file) => redactFileEntry(file, redactor));
+    const issues = applyReportControlsToIssuesWithRedactor(report.issues, scopes, redactor);
+    const dependencies = applyReportControlsToDependencies(report.dependencies, scopes, redactor);
+    const redactedRoot = redactor ? '<redacted-root>' : report.rootPath;
+    return {
+        ...report,
+        rootPath: redactedRoot,
+        scan: {
+            ...report.scan,
+            rootPath: redactedRoot,
+            totalFiles: files.length,
+            totalDirectories: countDirectories(files),
+            files,
+            directoryTree: scopes.length > 0 || redactor
+                ? buildDirectoryTree(redactor ? '<redacted-root>' : report.scan.directoryTree.name, files)
+                : report.scan.directoryTree,
+        },
+        dependencies,
+        issues,
+    };
+}
+function applyReportControlsToDependencies(dependencies, scopes, redactor) {
+    if (!dependencies?.byWorkspace)
+        return dependencies;
+    return {
+        ...dependencies,
+        byWorkspace: dependencies.byWorkspace
+            .filter((workspace) => dependencyWorkspaceInScope(workspace.relativePath, scopes))
+            .map((workspace) => ({
+            ...workspace,
+            relativePath: redactor && workspace.relativePath ? redactor(workspace.relativePath) : workspace.relativePath,
+        })),
+    };
+}
+function dependencyWorkspaceInScope(relativePath, scopes) {
+    if (scopes.length === 0)
+        return true;
+    return isInScope(relativePath, scopes);
+}
+function applyReportControlsToIssuesWithRedactor(issues, scopes, redactor) {
+    const out = [];
+    for (const issue of issues) {
+        const scopedLocations = filterLocationsByScope(issue.locations, scopes);
+        if (scopes.length > 0 && scopedLocations.length === 0)
+            continue;
+        out.push(redactIssue(issue, scopedLocations, redactor));
+    }
+    return out;
+}
+function normalizeScopes(scopes) {
+    return [...new Set((scopes ?? []).map(normalizeReportPath).filter(Boolean))];
+}
+function normalizeReportPath(value) {
+    let normalized = value.trim().replace(/\\/g, '/');
+    normalized = normalized.replace(/\/+/g, '/');
+    normalized = normalized.replace(/^\.\//, '');
+    normalized = normalized.replace(/\/$/, '');
+    if (!normalized || normalized === '.')
+        return null;
+    return normalized;
+}
+function isInScope(filePath, scopes) {
+    if (scopes.length === 0)
+        return true;
+    const normalized = normalizeReportPath(filePath);
+    if (!normalized)
+        return false;
+    return scopes.some((scope) => normalized === scope || normalized.startsWith(`${scope}/`));
+}
+function filterLocationsByScope(locations, scopes) {
+    if (!locations || locations.length === 0)
+        return [];
+    return locations.filter((loc) => loc.file && isInScope(loc.file, scopes));
+}
+function filterFilesByScope(files, scopes) {
+    if (scopes.length === 0)
+        return [...files];
+    return files.filter((file) => isInScope(file.relativePath, scopes));
+}
+function createPathRedactor() {
+    const seen = new Map();
+    return (filePath) => {
+        const normalized = normalizeReportPath(filePath) ?? filePath;
+        const existing = seen.get(normalized);
+        if (existing)
+            return existing;
+        const next = `redacted-path-${seen.size + 1}`;
+        seen.set(normalized, next);
+        return next;
+    };
+}
+function redactLocations(locations, redactor) {
+    if (!redactor)
+        return locations.map((loc) => ({ ...loc }));
+    return locations.map((loc) => ({ ...loc, file: redactor(loc.file) }));
+}
+function redactIssue(issue, scopedLocations, redactor) {
+    const redactedLocations = redactLocations(scopedLocations, redactor);
+    const redactedIssue = {
+        ...issue,
+        ...(scopedLocations.length > 0 || issue.locations ? { locations: redactedLocations } : {}),
+    };
+    if (!redactor)
+        return redactedIssue;
+    const textLocations = issue.locations ?? scopedLocations;
+    const replacements = textLocations
+        .filter((loc) => loc.file)
+        .map((loc) => [loc.file, redactor(loc.file)]);
+    redactedIssue.title = redactText(redactedIssue.title, replacements, redactor);
+    redactedIssue.description = redactText(redactedIssue.description, replacements, redactor);
+    if (redactedIssue.suggestedAction) {
+        redactedIssue.suggestedAction = {
+            ...redactedIssue.suggestedAction,
+            summary: redactText(redactedIssue.suggestedAction.summary, replacements, redactor),
+        };
+    }
+    return redactedIssue;
+}
+function redactText(text, replacements, redactor) {
+    let out = text;
+    const ordered = [...replacements].sort((a, b) => b[0].length - a[0].length);
+    for (const [filePath, label] of ordered) {
+        out = out.replace(pathReferenceRegExp(filePath), label);
+    }
+    if (redactor)
+        out = redactUnmappedPathTokens(out, redactor);
+    return out;
+}
+const TEXT_PATH_TOKEN_PATTERN = /(?:[A-Za-z]:[\\/]|\/|\.{1,2}[\\/])?(?:[A-Za-z0-9._@-]+[\\/])+[A-Za-z0-9._@-]+\.(?:ts|tsx|js|jsx|mjs|cjs|mts|cts|py|go|java|rb|rs|php|cs|json|ya?ml|toml|md)(?=$|[\s'"()[\]{}<>.,;:!?#])/gi;
+function redactUnmappedPathTokens(text, redactor) {
+    return text.replace(TEXT_PATH_TOKEN_PATTERN, (match, ...args) => {
+        const offset = args[args.length - 2];
+        if (isHttpUrlPathToken(text, offset))
+            return match;
+        return redactor(match);
+    });
+}
+function isHttpUrlPathToken(text, offset) {
+    const tokenStart = previousTokenStart(text, offset);
+    const prefix = text.slice(tokenStart, Math.min(text.length, offset + 2)).toLowerCase();
+    return prefix.startsWith('http://') || prefix.startsWith('https://');
+}
+function previousTokenStart(text, offset) {
+    let index = offset;
+    while (index > 0 && !isPathTokenBoundary(text[index - 1]))
+        index -= 1;
+    return index;
+}
+function isPathTokenBoundary(char) {
+    return char === undefined || /[\s'"()[\]{}<>]/.test(char);
+}
+function pathReferenceRegExp(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    const pathPattern = normalized.split('/').map(escapeRegExp).join(String.raw `[\\/]`);
+    const tokenEnd = String.raw `(?=$|[\s'"()[\]{}<>.,;:!?#])`;
+    return new RegExp(String.raw `(?:\S+[\\/])*` + pathPattern + tokenEnd, 'g');
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function redactFileEntry(file, redactor) {
+    if (!redactor)
+        return { ...file };
+    const relativePath = redactor(file.relativePath);
+    return {
+        ...file,
+        relativePath,
+        absolutePath: relativePath,
+        directory: '.',
+    };
+}
+function countDirectories(files) {
+    const dirs = new Set(files.map((file) => file.directory || '.'));
+    return dirs.size;
+}
+function buildDirectoryTree(name, files) {
+    return {
+        name,
+        path: '.',
+        fileCount: files.length,
+        totalFileCount: files.length,
+        children: [],
+    };
+}
+//# sourceMappingURL=reportScope.js.map

package/dist/core/reportScope.js.map

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

package/dist/core/review.d.ts

@@ -1,4 +1,5 @@
-import type { ReviewReport, ReviewTier } from '../types/review.js';
+import type { ReviewReport } from '../types/review.js';
+export { selectReviewTier, shapeReviewForTier } from './reviewTier.js';
 export interface ReviewOptions {
     /** Base ref. Default: origin/main → main → origin/master → master → HEAD~1. */
     base?: string;
@@ -29,27 +30,3 @@ export interface ReviewOptions {
  *   ok     - otherwise
  */
 export declare function computeReview(rootPath: string, options?: ReviewOptions): Promise<ReviewReport>;
-/**
- * 1.5+ — pick a review tier based on the caller's token budget.
- *
- *   <3000  → 'verdict-only'  (verdict + summary + totals)
- *   <7000  → 'summary'       (verdict + summary + top files / top cycles / etc.)
- *   else   → 'full'          (everything)
- *
- * `0`, `undefined`, and any non-positive value all mean "no budget given"
- * — the caller wants the full report. The tier names are stable (clients
- * can read them off the response and key behavior off them).
- */
-export declare function selectReviewTier(maxCostTokens: number | undefined): ReviewTier;
-/**
- * Reshape a full ReviewReport for the chosen tier. The caller passes a
- * fully-populated report from `computeReview`; we return a plain object
- * sized for the tier. Returning `Record<string, unknown>` (rather than
- * narrowing the ReviewReport type) keeps the type contract simple for
- * the dispatcher and avoids an over-engineered union.
- *
- * `unavailable` reports (no diff, missing base, etc.) pass through as-is
- * — there's nothing to shape; the verdict + reason already convey
- * everything the agent needs.
- */
-export declare function shapeReviewForTier(report: ReviewReport, tier: ReviewTier): Record<string, unknown>;