projscan 4.3.1 → 4.5.0

package/dist/core/startReviewGate.js

@@ -0,0 +1,200 @@
+export const READY_PROOF_SUMMARY = 'Ready-to-run proof commands; placeholder follow-ups are excluded until Needs Input is resolved.';
+export function buildMissionReviewGate(input) {
+    const autonomousContinuation = input.autonomousContinuation === true;
+    const checklist = [
+        'Complete this task card and remaining proof.',
+        'Capture `git status --short`.',
+        'Capture `git diff --stat`.',
+        autonomousContinuation
+            ? 'Continue only with another bounded implementation slice after proof; stop before release, publish, deploy, push, merge, or version bump.'
+            : 'Stop and ask for approval before starting another slice, release, publish, or deploy.',
+    ];
+    const commands = ['git status --short', 'git diff --stat'];
+    const doneWhen = input.doneWhen.slice();
+    const policy = buildMissionReviewPolicy(autonomousContinuation);
+    const decisions = buildMissionReviewDecisions(autonomousContinuation);
+    const worktree = buildMissionReviewWorktree(input.currentWorktree);
+    const stopCondition = autonomousContinuation
+        ? 'Continue with bounded implementation slices after the current Mission Control checklist and proof; stop for approval before release, publish, deploy, push, merge, or version bump.'
+        : 'Stop after the current Mission Control checklist and proof are complete.';
+    const reviewPrompt = autonomousContinuation
+        ? `Review the completed mission, proof output, and working-tree summary before any release, publish, deploy, push, merge, or version bump. ${input.proof.summary}`
+        : `Review the completed mission, proof output, and working-tree summary before approving another slice, release, publish, or deploy. ${input.proof.summary}`;
+    return {
+        title: 'Mission Review Gate',
+        required: true,
+        status: input.status,
+        stopCondition,
+        reviewPrompt,
+        checklist,
+        doneWhen,
+        policy,
+        decisions,
+        commands,
+        worktree,
+        proof: input.proof,
+        markdown: renderMissionReviewGateMarkdown({
+            status: input.status,
+            stopCondition,
+            reviewPrompt,
+            checklist,
+            doneWhen,
+            policy,
+            decisions,
+            commands,
+            worktree,
+            proof: input.proof,
+        }),
+    };
+}
+export function buildMissionReviewProof(resume, proofCommands) {
+    const commands = resume.remainingProofCommands ?? proofCommands;
+    const toolCalls = resume.remainingProofToolCalls ?? [];
+    const items = resume.remainingProofItems ?? [];
+    return {
+        summary: READY_PROOF_SUMMARY,
+        commands,
+        ...(toolCalls.length > 0 ? { toolCalls } : {}),
+        ...(items.length > 0 ? { items } : {}),
+    };
+}
+export function formatMissionReviewDecision(decision) {
+    return `- [ ] ${decision.label}: ${decision.description} Consequence: ${decision.consequence} Reply: "${decision.reply}"`;
+}
+function buildMissionReviewPolicy(autonomousContinuation = false) {
+    return {
+        approvalRequired: true,
+        blockedActions: autonomousContinuation
+            ? ['release', 'publish', 'deploy', 'push', 'merge', 'version_bump']
+            : ['next_slice', 'release', 'publish', 'deploy', 'push', 'merge', 'version_bump'],
+        summary: autonomousContinuation
+            ? 'Autonomous bounded implementation slices may continue after proof; explicit reviewer approval is still required before release, publish, deploy, push, merge, or version bump.'
+            : 'Explicit reviewer approval is required before another slice, release, publish, deploy, push, merge, or version bump.',
+    };
+}
+function buildMissionReviewDecisions(autonomousContinuation = false) {
+    return [
+        {
+            id: 'approve_next_slice',
+            label: autonomousContinuation ? 'Continue next slice' : 'Approve next slice',
+            description: autonomousContinuation
+                ? 'The agent may continue with another bounded implementation slice after proof.'
+                : 'The agent may start another bounded implementation slice.',
+            consequence: 'No release, publish, deploy, or version bump is allowed unless the reviewer asks for it.',
+            reply: autonomousContinuation
+                ? 'Continue: start one more bounded implementation slice. Do not release, publish, deploy, push, merge, or bump the version.'
+                : 'Approved: start one more bounded implementation slice. Do not release, publish, deploy, push, merge, or bump the version.',
+        },
+        {
+            id: 'request_changes',
+            label: 'Request changes',
+            description: 'The agent must address review feedback before starting more scope.',
+            consequence: 'The current mission stays open until feedback and proof are updated.',
+            reply: 'Changes requested: address the review feedback first, update proof, then stop for another review.',
+        },
+        {
+            id: 'review_version_candidate',
+            label: 'Review version candidate',
+            description: 'The agent may prepare release notes, version rationale, and remaining gates for review.',
+            consequence: 'Publishing still requires a separate explicit approval.',
+            reply: 'Prepare a version-candidate review only. Do not publish, deploy, push, merge, or bump the version.',
+        },
+    ];
+}
+function buildMissionReviewWorktree(currentWorktree) {
+    if (!currentWorktree.available) {
+        const reason = currentWorktree.reason ?? 'unknown';
+        return {
+            available: false,
+            clean: false,
+            changedFileCount: 0,
+            files: [],
+            baseRef: currentWorktree.baseRef,
+            summary: `Current worktree evidence is unavailable: ${reason}.`,
+            reason,
+        };
+    }
+    const changedFileCount = currentWorktree.count;
+    const baseRef = currentWorktree.baseRef;
+    return {
+        available: true,
+        clean: changedFileCount === 0,
+        changedFileCount,
+        files: currentWorktree.files,
+        baseRef,
+        summary: changedFileCount === 0
+            ? 'Current worktree evidence sees no changed files.'
+            : `Current worktree evidence sees ${changedFileCount} changed file(s)${baseRef ? ` against ${baseRef}` : ''}.`,
+    };
+}
+function renderMissionReviewGateMarkdown(input) {
+    const lines = [
+        '# Mission Review Gate',
+        '',
+        `Status: ${input.status}`,
+        `Stop condition: ${input.stopCondition}`,
+        '',
+        '## Checklist',
+        ...input.checklist.map((item) => `- [ ] ${item}`),
+        '',
+        '## Review Policy',
+        `Approval required: ${input.policy.approvalRequired ? 'yes' : 'no'}`,
+        input.policy.summary,
+        'Blocked until approval:',
+        ...input.policy.blockedActions.map(formatMissionReviewBlockedAction),
+        '',
+        '## Done When',
+        ...(input.doneWhen.length > 0
+            ? input.doneWhen.map((criterion) => `- [ ] ${criterion}`)
+            : ['- [ ] The current mission is complete and verified.']),
+        '',
+        '## Reviewer Decision',
+        ...input.decisions.map(formatMissionReviewDecision),
+        '',
+        ...renderMissionReviewProofLines(input.proof),
+        '## Evidence Commands',
+        ...input.commands.map((command) => `- \`${command}\``),
+        '',
+        '## Worktree Evidence',
+        input.worktree.summary,
+        ...input.worktree.files.slice(0, 8).map((file) => `- \`${file}\``),
+        '',
+        '## Review Prompt',
+        input.reviewPrompt,
+    ];
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+function formatMissionReviewBlockedAction(action) {
+    const labels = {
+        next_slice: 'Start another implementation slice',
+        release: 'Release',
+        publish: 'Publish',
+        deploy: 'Deploy',
+        push: 'Push',
+        merge: 'Merge',
+        version_bump: 'Version bump',
+    };
+    return `- ${labels[action]} (\`${action}\`)`;
+}
+function renderMissionReviewProofLines(proof) {
+    const lines = ['## Proof Queue', proof.summary];
+    if (proof.items && proof.items.length > 0) {
+        return [...lines, ...proof.items.map(formatMissionReviewProofItem), ''];
+    }
+    if (proof.commands.length > 0) {
+        return [...lines, ...proof.commands.map((command) => `- \`${command}\``), ''];
+    }
+    return [...lines, 'No proof commands are ready yet.', ''];
+}
+function formatMissionReviewProofItem(item) {
+    const annotation = item.toolCall
+        ? ` (MCP: ${formatMissionReviewToolCall(item.toolCall)})`
+        : ' (CLI only)';
+    return `- \`${item.command}\`${annotation}`;
+}
+function formatMissionReviewToolCall(toolCall) {
+    return typeof toolCall.args !== 'undefined'
+        ? `${toolCall.tool} ${JSON.stringify(toolCall.args)}`
+        : toolCall.tool;
+}
+//# sourceMappingURL=startReviewGate.js.map

package/dist/core/startReviewGate.js.map

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

package/dist/core/startRouteActions.d.ts

@@ -0,0 +1,7 @@
+import type { PreflightSuggestedAction } from '../types/preflight.js';
+import type { StartRoutedIntent } from '../types/start.js';
+import type { WorkplanMode } from '../types/workplan.js';
+export declare function actionFromRoute(mode: WorkplanMode, intent: string, route: StartRoutedIntent): PreflightSuggestedAction;
+export declare function actionPlanFromRoute(mode: WorkplanMode, intent: string, route: StartRoutedIntent): PreflightSuggestedAction[];
+export declare function argsFromRouteIntent(mode: WorkplanMode, intent: string, route: StartRoutedIntent): Record<string, unknown>;
+export declare function commandFromRouteIntent(_intent: string, route: StartRoutedIntent, args: Record<string, unknown>): string;