@linimin/pi-letscook 0.1.67 → 0.1.68

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.68
+
+### Changed
+
+- simplified `/cook` startup sourcing so workflow proposals now come only from same-entry primary-agent startup-plan synthesis
+- stopped `/cook` from directly adopting old preview capsules or falling back to transcript-derived startup proposals
+- kept preview capsules advisory-only for humans while active-workflow replacement and next-round startup now depend on same-entry primary-agent synthesis from current task context
+
 ## 0.1.67
 
 ### Changed

package/README.md

@@ -57,11 +57,11 @@ Then run `/reload` in Pi.
 - a mission, scope, acceptance, and verification intent concrete enough for `completion-regrounder` to derive truthful slices after startup
 - README/CHANGELOG updates still count as concrete repo changes
 - assistant-produced summaries and plan/spec/design-doc/proposal-only artifacts still do not count unless the primary-agent startup-plan step turns them into concrete startup intake for `/cook`
-- `/cook` first prefers a fresh explicit `cook_handoff` preview when one already exists, but otherwise calls the primary-agent startup-plan synthesis step in the same `/cook` entry
+- `/cook` always runs a same-entry primary-agent startup-plan synthesis step from the current task context instead of directly adopting an old preview or transcript-derived proposal
 
 If the startup-plan step still cannot prepare a concrete startup plan, `/cook` fails closed, leaves canonical `.agent/**` state unchanged, and tells you to refine the mission, scope, acceptance, or verification intent in the main chat before rerunning `/cook`.
 
-If a fresh explicit preview exists but is still workflow-worthy rather than concrete enough to seed workflow planning, `/cook` also fails closed instead of silently treating that capsule as canonical workflow state.
+If the same-entry synthesized startup plan is still too vague or planning-only to seed workflow planning, `/cook` also fails closed instead of silently treating that output as canonical workflow state.
 
 If you pass inline arguments to `/cook`, it also fails closed and tells you to move that intent into the main chat before rerunning bare `/cook`.
 
@@ -71,15 +71,15 @@ Only explicit `/cook` enters workflow mode. Ordinary prompts stay in the main ch
 
 Ordinary chat can still directly implement repo changes. `/cook` is for the cases where you want workflow control rather than just implementation help, and the primary agent should prepare the startup plan before workflow begins.
 
-When you explicitly run `/cook`, it first checks for a fresh explicit primary-agent startup-plan preview. If one is missing, it calls a same-entry primary-agent startup-plan synthesis step from the current task context, then asks you to **Start** or **Cancel** before rewriting canonical workflow state.
+When you explicitly run `/cook`, it always calls a same-entry primary-agent startup-plan synthesis step from the current task context, then asks you to **Start** or **Cancel** before rewriting canonical workflow state.
 
-Explicit `/cook` capsules are still valid startup intake, but they are no longer the only path because `/cook` can synthesize the primary-agent startup plan in the same entry when needed.
+Optional preview capsules in ordinary chat are advisory only. `/cook` does not directly consume them as approval-ready workflow state; it synthesizes a fresh startup plan in the `/cook` entry.
 
 Important behavior:
 - `/cook` is an optional workflow boundary and manual entry point
-- startup and next-round entry stay confirm-first, using explicit primary-agent startup-plan data when present and otherwise running the primary-agent startup-plan synthesis step in the same `/cook` entry
+- startup and next-round entry stay confirm-first, always using same-entry primary-agent startup-plan synthesis from the current task context
 - after **Start**, `/cook` records the approved startup plan under `.agent/startup-plan.json` / `.agent/startup-plan.md`, then `completion-regrounder` derives canonical slices from repo truth
-- active workflows resume from canonical `.agent/**` state unless a concrete replacement startup plan is available or synthesized in the same `/cook` entry
+- active workflows resume from canonical `.agent/**` state unless same-entry primary-agent startup-plan synthesis produces a concrete replacement mission
 - explicit slash commands other than `/cook` continue normally in the main chat
 - ordinary main-chat discussion may clarify, propose, or directly implement repo changes without entering workflow mode
 
@@ -95,13 +95,13 @@ I want to add login redirect handling and tests.
 
 ## What happens when you run `/cook`
 
-`/cook` first checks for a fresh explicit primary-agent startup-plan preview. New-workflow entry and done-workflow next-round entry use that plan when it already exists; otherwise `/cook` calls a same-entry primary-agent startup-plan synthesis step, then immediately continues to Start / Cancel if the generated plan is concrete enough. After **Start**, the approved startup plan is written into `.agent/startup-plan.json` / `.agent/startup-plan.md`, and `completion-regrounder` uses it to derive canonical slices from current repo truth. Active workflows still resume canonical state by default unless a concrete replacement startup plan is available or synthesized in the same `/cook` entry. None of this prevents ordinary-chat implementation when you choose not to enter workflow mode.
+`/cook` always runs a same-entry primary-agent startup-plan synthesis step from the current task context. If that synthesized plan is concrete enough, `/cook` continues to Start / Cancel confirmation. After **Start**, the approved startup plan is written into `.agent/startup-plan.json` / `.agent/startup-plan.md`, and `completion-regrounder` uses it to derive canonical slices from current repo truth. Active workflows still resume canonical state by default unless same-entry synthesis produces a concrete replacement mission. None of this prevents ordinary-chat implementation when you choose not to enter workflow mode.
 
 | Repo state | What you'll see |
 |---|---|
-| No workflow yet | `/cook` consumes a fresh explicit primary-agent startup-plan preview when one already exists, or synthesizes one from the primary-agent view in the same entry, then asks you to choose **Start** or **Cancel**. After **Start**, the approved startup plan is persisted under `.agent/` and `completion-regrounder` derives canonical slices. Stale, planning-only, or non-startable startup plans still fail closed. |
-| Active workflow exists | Usually a resume of the current workflow from canonical `.agent/**` state. If a concrete replacement startup plan exists already or is synthesized in the same `/cook` entry and points to a different mission, `/cook` shows a chooser first and only rewrites canonical state after you confirm the replacement. Ambiguous or missing replacement startup plans stay conservative. |
-| Previous workflow is `done` | `/cook` can start the next implementation round from a fresh explicit primary-agent startup plan or from the same-entry primary-agent startup-plan synthesis step behind **Start** or **Cancel**. Weak or planning-only next-round startup plans still fail closed. |
+| No workflow yet | `/cook` synthesizes a primary-agent startup plan in the same entry, then asks you to choose **Start** or **Cancel**. After **Start**, the approved startup plan is persisted under `.agent/` and `completion-regrounder` derives canonical slices. Weak, planning-only, or non-startable synthesized plans still fail closed. |
+| Active workflow exists | Usually a resume of the current workflow from canonical `.agent/**` state. If same-entry primary-agent startup-plan synthesis produces a concrete replacement mission, `/cook` shows a chooser first and only rewrites canonical state after you confirm the replacement. Ambiguous, missing, or non-startable synthesized replacement plans stay conservative. |
+| Previous workflow is `done` | `/cook` can start the next implementation round from a same-entry primary-agent startup-plan synthesis step behind **Start** or **Cancel**. Weak or planning-only synthesized next-round startup plans still fail closed. |
 
 ## Confirmation and fail-closed behavior
 
@@ -117,7 +117,7 @@ When you accept startup or refocus, `/cook` persists the chosen workflow state i
 
 The confirmed startup plan is preserved under `.agent/startup-plan.json` / `.agent/startup-plan.md` and summarized in `state.json` as advisory intake for later re-grounding. It does not replace `.agent/plan.json` or `.agent/active-slice.json`, which remain under regrounder authority.
 
-The pre-`/cook` preview capsule itself is not canonical workflow state. It is only startup intake for `/cook`.
+The pre-`/cook` preview capsule itself is not canonical workflow state. It is only an advisory preview for the human; `/cook` still synthesizes a fresh startup plan in the entry where workflow actually begins.
 
 ## Observability
 

package/extensions/completion/driver.ts

@@ -38,7 +38,7 @@ type ContextProposalAlternate = {
 	analysis: ContextProposalAnalysis;
 	goalText: string;
 	basisPreview: string;
-	source: "session" | "analyst" | "handoff_capsule";
+	source: "session" | "analyst" | "handoff_capsule" | "deferred_primary_agent_handoff";
 };
 
 type ContextProposal = ContextProposalAlternate & {
@@ -71,10 +71,10 @@ type ActiveWorkflowProposalAssessment = {
 	proposal?: ContextProposal;
 	blockedFailureMessage?: string;
 	reason:
-		| "matching_mission"
-		| "missing_explicit_handoff"
-		| "fresh_explicit_handoff"
-		| "fresh_explicit_handoff_not_startable";
+		| "matching_generated_startup_plan"
+		| "no_generated_startup_plan"
+		| "generated_replacement_startup_plan"
+		| "generated_startup_plan_not_startable";
 };
 
 type ExistingWorkflowChooserOptions = {
@@ -126,7 +126,6 @@ export type CompletionDriverDeps = {
 	) => string;
 	completionResumePrompt: (taskType: string, evaluationProfile: string) => string;
 	deriveCookContextProposal: (ctx: DriverContext, projectName: string) => Promise<CookContextProposalResult>;
-	deriveCookStartupProposal: (ctx: DriverContext, projectName: string) => Promise<CookContextProposalResult>;
 	confirmContextProposal: (
 		ctx: { hasUI: boolean; ui: any },
 		proposal: ContextProposal,
@@ -332,7 +331,7 @@ async function assessActiveWorkflowProposalRouting(
 			action: "blocked",
 			currentMissionAnchor: currentMission,
 			blockedFailureMessage: proposalResult.blockedFailureMessage,
-			reason: "fresh_explicit_handoff_not_startable",
+			reason: "generated_startup_plan_not_startable",
 		};
 		deps.maybeWriteActiveWorkflowRoutingSnapshot(assessment);
 		return assessment;
@@ -342,7 +341,7 @@ async function assessActiveWorkflowProposalRouting(
 		const assessment: ActiveWorkflowProposalAssessment = {
 			action: "continue",
 			currentMissionAnchor: currentMission,
-			reason: "missing_explicit_handoff",
+			reason: "no_generated_startup_plan",
 		};
 		deps.maybeWriteActiveWorkflowRoutingSnapshot(assessment);
 		return assessment;
@@ -352,7 +351,7 @@ async function assessActiveWorkflowProposalRouting(
 			action: "continue",
 			currentMissionAnchor: currentMission,
 			proposal,
-			reason: "matching_mission",
+			reason: "matching_generated_startup_plan",
 		};
 		deps.maybeWriteActiveWorkflowRoutingSnapshot(assessment);
 		return assessment;
@@ -361,7 +360,7 @@ async function assessActiveWorkflowProposalRouting(
 		action: "refocus",
 		currentMissionAnchor: currentMission,
 		proposal,
-		reason: "fresh_explicit_handoff",
+		reason: "generated_replacement_startup_plan",
 	};
 	deps.maybeWriteActiveWorkflowRoutingSnapshot(assessment);
 	return assessment;
@@ -424,8 +423,8 @@ async function confirmExistingWorkflowProposal(
 	const continueChoice = "Continue current workflow\n\nKeep the current mission and treat the new goal as extra direction only.";
 	const buildRefocusChoice = (candidate: ContextProposalAlternate, variant: "primary" | "alternate") =>
 		variant === "primary"
-			? `${options.refocusChoiceLabel ?? "Start new workflow from recent discussion\n\nReview the proposed replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state."}\n\n${summarizeProposalForChoice(candidate)}`
-			: `${options.alternateChoiceLabel ?? "Start alternate workflow from recent discussion\n\nReview this alternate replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state."}\n\n${summarizeProposalForChoice(candidate)}`;
+			? `${options.refocusChoiceLabel ?? "Start new workflow from synthesized startup plan\n\nReview the proposed replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state."}\n\n${summarizeProposalForChoice(candidate)}`
+			: `${options.alternateChoiceLabel ?? "Start alternate workflow from synthesized startup plan\n\nReview this alternate replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state."}\n\n${summarizeProposalForChoice(candidate)}`;
 	const refocusChoices = candidateProposals.map((candidate, index) => buildRefocusChoice(candidate, index === 0 ? "primary" : "alternate"));
 	const cancelChoice = `Cancel\n\nKeep the current workflow unchanged. ${deps.mainChatRerunGuidance}`;
 	deps.maybeWriteTestSnapshot(
@@ -578,7 +577,7 @@ export async function runCookEntry(
 			title: "Start a completion workflow from this startup plan?",
 		});
 		if (!decision) {
-			deps.emitCommandText(ctx, buildCookCancellationMessage("Cancelled recent-discussion workflow proposal", deps), "info");
+			deps.emitCommandText(ctx, buildCookCancellationMessage("Cancelled synthesized startup plan", deps), "info");
 			return;
 		}
 		goal = decision.goalText;
@@ -663,19 +662,19 @@ export async function runCookEntry(
 				await resumeActiveWorkflowFromCanonicalState(pi, ctx, snapshot, deps);
 				return;
 			}
-			const explicitReplacement = assessment.reason === "fresh_explicit_handoff";
+			const generatedReplacement = assessment.reason === "generated_replacement_startup_plan";
 			const decision = await confirmExistingWorkflowProposal(ctx, snapshot, assessment.proposal, deps, {
-				intro: explicitReplacement
-					? "A fresh explicit primary-agent startup plan proposes replacing the current workflow. Choose how /cook should proceed:"
+				intro: generatedReplacement
+					? "A same-entry primary-agent startup plan proposes replacing the current workflow. Choose how /cook should proceed:"
 					: "A replacement workflow is ready. Choose how /cook should proceed:",
-				proposedMissionLabel: explicitReplacement
-					? "Proposed mission from explicit primary-agent startup plan"
+				proposedMissionLabel: generatedReplacement
+					? "Proposed mission from same-entry primary-agent startup plan"
 					: "Proposed mission",
-				refocusChoiceLabel: explicitReplacement
-					? "Start new workflow from explicit primary-agent startup plan\n\nReview the proposed replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state."
+				refocusChoiceLabel: generatedReplacement
+					? "Start new workflow from same-entry primary-agent startup plan\n\nReview the proposed replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state."
 					: "Start new workflow\n\nReview the proposed replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state.",
-				alternateChoiceLabel: explicitReplacement
-					? "Start alternate workflow from explicit primary-agent startup plan\n\nReview this alternate replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state."
+				alternateChoiceLabel: generatedReplacement
+					? "Start alternate workflow from same-entry primary-agent startup plan\n\nReview this alternate replacement in a final Start/Cancel confirmation before /cook rewrites canonical workflow state."
 					: undefined,
 				comparison: "strict",
 			});
@@ -689,8 +688,8 @@ export async function runCookEntry(
 			}
 			const selectedProposal = decision.proposal;
 			const proposalDecision = await deps.confirmContextProposal(ctx, selectedProposal, {
-				title: assessment.reason === "fresh_explicit_handoff"
-					? "Start the replacement workflow from this explicit startup plan?"
+				title: assessment.reason === "generated_replacement_startup_plan"
+					? "Start the replacement workflow from this synthesized startup plan?"
 					: "Start the replacement workflow from this startup plan?",
 			});
 			if (!proposalDecision) {
@@ -718,8 +717,8 @@ export async function runCookEntry(
 			snapshot = (await loadCompletionSnapshot(snapshot.files.root)) ?? snapshot;
 			deps.emitCommandText(
 				ctx,
-				assessment.reason === "fresh_explicit_handoff"
-					? `Refocused completion mission from explicit primary-agent startup plan and rewrote the approved startup plan to: ${proposalDecision.missionAnchor}`
+				assessment.reason === "generated_replacement_startup_plan"
+					? `Refocused completion mission from same-entry primary-agent startup plan and rewrote the approved startup plan to: ${proposalDecision.missionAnchor}`
 					: `Refocused completion mission and rewrote the approved startup plan to: ${proposalDecision.missionAnchor}`,
 				"info",
 			);

package/extensions/completion/index.ts

@@ -14,18 +14,17 @@ import {
 	registerCookCommand,
 } from "./driver";
 import {
+	assessCookHandoffText,
 	assessMissionAnchor,
 	collectRecentDiscussionEntries,
 	collectRecentSessionMessages,
-	assessLatestCookHandoffProposal,
-	deriveCookContextProposalFromRecentDiscussion,
 	finalizeContextProposalAnalysis,
-	hasStructuredContextProposalSignal,
 	isWeakMissionAnchor,
 	missionAnchorsLikelyEquivalent,
 	missionAnchorsStrictlyEquivalent,
 	normalizeMissionAnchorText,
 	resolveContextProposalConfirmationAction,
+	retagContextProposalSource,
 	stripCodeBlocks,
 } from "./proposal";
 import type {
@@ -49,7 +48,7 @@ import {
 	maybeWriteContextProposalSnapshot,
 } from "./prompt-surfaces";
 import { toolCallBlockReason } from "./policy-guards";
-import { analyzeContextProposalWithAgent, runCompletionRole } from "./role-runner";
+import { runCompletionRole } from "./role-runner";
 import { generateCookHandoffWithAgent } from "./role-runner";
 import {
 	applyLiveRoleEvent,
@@ -135,10 +134,10 @@ type ActiveWorkflowProposalAssessment = {
 	proposal?: ContextProposal;
 	blockedFailureMessage?: string;
 	reason:
-		| "matching_mission"
-		| "missing_explicit_handoff"
-		| "fresh_explicit_handoff"
-		| "fresh_explicit_handoff_not_startable";
+		| "matching_generated_startup_plan"
+		| "no_generated_startup_plan"
+		| "generated_replacement_startup_plan"
+		| "generated_startup_plan_not_startable";
 };
 
 function completionTestWorkflowActionOverride(): "continue" | "refocus" | "cancel" | undefined {
@@ -379,36 +378,13 @@ function stripCookHandoffBlocks(text: string): string {
 	return text.replace(COOK_HANDOFF_BLOCK_REGEX, " ").replace(/\s+/g, " ").trim();
 }
 
-async function deriveCookStartupProposal(
-	ctx: { cwd: string; hasUI: boolean; ui: any; sessionManager: any; model?: any; modelRegistry?: any },
-	projectName: string,
-): Promise<CookContextProposalResult> {
-	const recentMessages = collectRecentSessionMessages(ctx, { isRecord, asString, asNumber, isStaleContextError });
-	const explicitHandoff = assessLatestCookHandoffProposal(recentMessages, projectName, {
-		asString,
-		asStringArray,
-		assessMissionAnchor,
-		normalizeMissionAnchorText,
-		isWeakMissionAnchor,
-		missionAnchorsStrictlyEquivalent,
-		stripCodeBlocks,
-	});
-	if (explicitHandoff.status === "startable") return { proposal: explicitHandoff.proposal };
-	if (explicitHandoff.status === "fresh_but_not_startable") {
-		return { blockedFailureMessage: explicitHandoff.message };
-	}
-	return {};
-}
-
 async function deriveCookContextProposal(
 	ctx: { cwd: string; hasUI: boolean; ui: any; sessionManager: any; model?: any; modelRegistry?: any },
 	projectName: string,
 ): Promise<CookContextProposalResult> {
-	const explicit = await deriveCookStartupProposal(ctx, projectName);
-	if (explicit.proposal || explicit.blockedFailureMessage) return explicit;
 	const recentMessages = collectRecentSessionMessages(ctx, { isRecord, asString, asNumber, isStaleContextError });
 	const recentEntries = recentMessages
-		.filter((entry) => !entry.isCommand && (entry.role === "user" || entry.role === "assistant" || entry.role === "custom" || entry.role === "summary"))
+		.filter((entry) => !entry.isCommand && (entry.role === "user" || entry.role === "custom" || entry.role === "summary"))
 		.slice(0, 12)
 		.map((entry) => ({ role: entry.role, text: stripCookHandoffBlocks(entry.text) }))
 		.filter((entry) => entry.text.length > 0);
@@ -426,18 +402,6 @@ async function deriveCookContextProposal(
 			`verification summary: ${asString(snapshot.verificationEvidence?.summary) ?? "(none)"}`,
 		]
 		: [];
-	const workflowContext = snapshot
-		? {
-			currentMissionAnchor: asString(snapshot.state?.mission_anchor) ?? asString(snapshot.plan?.mission_anchor) ?? asString(snapshot.active?.mission_anchor),
-			latestCompletedSlice: asString(snapshot.state?.latest_completed_slice),
-			latestVerifiedSlice: asString(snapshot.state?.latest_verified_slice),
-			activeSliceGoal: asString(snapshot.active?.goal),
-			activeSliceWhyNow: asString(snapshot.active?.why_now),
-			verificationGoal: asString(snapshot.verificationEvidence?.goal),
-			verificationSummary: asString(snapshot.verificationEvidence?.summary),
-			continuationPolicy: asString(snapshot.state?.continuation_policy),
-		}
-		: undefined;
 	const raw = await generateCookHandoffWithAgent({
 		ctx,
 		projectName,
@@ -450,49 +414,24 @@ async function deriveCookContextProposal(
 		getCtxHasUI,
 		getCtxUi,
 	});
-	if (raw) {
-		const generated = assessLatestCookHandoffProposal([
-			{ role: "assistant", text: raw, messageId: "generated-primary-agent-handoff", timestampMs: Date.now(), isCommand: false },
-		], projectName, {
-			asString,
-			asStringArray,
-			assessMissionAnchor,
-			normalizeMissionAnchorText,
-			isWeakMissionAnchor,
-			missionAnchorsStrictlyEquivalent,
-			stripCodeBlocks,
-		});
-		if (generated.status === "startable") return { proposal: generated.proposal };
-		if (generated.status === "fresh_but_not_startable") return { blockedFailureMessage: generated.message };
-	}
-	const canFallbackToDiscussionProposal =
-		recentEntries.length >= 2 || recentEntries.some((entry) => hasStructuredContextProposalSignal(entry.text, stripCodeBlocks));
-	if (canFallbackToDiscussionProposal) {
-		const fromDiscussion = await deriveCookContextProposalFromRecentDiscussion(projectName, recentEntries, {
-			asString,
-			asStringArray,
-			assessMissionAnchor,
-			normalizeMissionAnchorText,
-			isWeakMissionAnchor,
-			missionAnchorsStrictlyEquivalent,
-			stripCodeBlocks,
-			analyzeContextProposal: async (candidateEntries) =>
-				await analyzeContextProposalWithAgent({
-					ctx,
-					projectName,
-					recentEntries: candidateEntries,
-					workflowContextLines,
-					liveRoleActivityByRoot,
-					completionStatusKey: COMPLETION_STATUS_KEY,
-					safeUiCall,
-					getCtxCwd,
-					getCtxHasUI,
-					getCtxUi,
-				}),
-			workflowContext,
-		});
-		if (fromDiscussion) return { proposal: fromDiscussion };
+	if (!raw) return {};
+	const generated = assessCookHandoffText(raw, projectName, {
+		asString,
+		asStringArray,
+		assessMissionAnchor,
+		normalizeMissionAnchorText,
+		isWeakMissionAnchor,
+		missionAnchorsStrictlyEquivalent,
+		stripCodeBlocks,
+	}, {
+		messageId: "generated-primary-agent-handoff",
+		timestampMs: Date.now(),
+		context: "same_entry_synthesis",
+	});
+	if (generated.status === "startable") {
+		return { proposal: retagContextProposalSource(generated.proposal, "deferred_primary_agent_handoff") };
 	}
+	if (generated.status === "fresh_but_not_startable") return { blockedFailureMessage: generated.message };
 	return {};
 }
 
@@ -1012,7 +951,6 @@ export default function completionExtension(pi: ExtensionAPI) {
 		completionTestWorkflowMissionOverride,
 		confirmContextProposal,
 		deriveCookContextProposal,
-		deriveCookStartupProposal,
 		emitCommandText,
 		finalizeContextProposalAnalysis,
 		getCtxCwd,

package/extensions/completion/prompt-surfaces.ts

@@ -54,9 +54,9 @@ export function buildCookHandoffBoundaryReminder(): string {
 		"If the user wants direct implementation now, stay in ordinary chat and help directly instead of blocking on /cook.",
 		"If the user asks follow-up questions or wants to keep refining scope, continue helping naturally in ordinary chat.",
 		"If the user explicitly runs /cook, the extension should call a primary-agent startup-plan synthesis step from the current task context, show Start/Cancel confirmation in the same /cook entry, and only write the approved plan into .agent after Start.",
-		"Do not expect /cook to infer or guess startup intent from recent discussion alone; /cook should use primary-agent-authored startup-plan data, whether it already exists as preview intake or is synthesized in the same /cook entry.",
+		"Do not expect /cook to infer or guess startup intent from recent discussion alone, and do not expect /cook to directly reuse an old preview capsule; /cook should always synthesize the startup plan fresh in the same entry from current task context.",
 		"Only provide a preview startup plan or ```cook_handoff``` capsule in ordinary chat when the user explicitly asks for that preview behavior.",
-		"Any preview capsule is startup intake for /cook only: do not present it as canonical .agent state, an active slice, or a persistent repo contract.",
+		"Any preview capsule is advisory only until /cook reruns same-entry primary-agent startup-plan synthesis: do not present it as canonical .agent state, an active slice, or a persistent repo contract.",
 		"When /cook starts, the approved startup plan should be written into .agent and then handed to completion-regrounder so canonical slices can be derived from repo truth.",
 		"When you continue in ordinary chat, do not pretend /cook already started and do not silently rewrite discussion into canonical workflow state.",
 	].join(" ");
@@ -106,7 +106,7 @@ function buildAdvisoryStartupBriefNotes(analysis: ContextProposalAnalysis): stri
 		...analysis.critique,
 		...analysis.possibleNoise.map((item) => `Possible noise: ${item}`),
 	];
-	return notes.length > 0 ? notes : ["No additional operator notes were derived from recent discussion."];
+	return notes.length > 0 ? notes : ["No additional operator notes were captured for the approved startup plan."];
 }
 
 function startupPlanSourceForProposal(source: ContextProposal["source"]): AdvisoryStartupBrief["source"] {

package/extensions/completion/proposal.ts

@@ -1374,12 +1374,21 @@ function cookHandoffStartabilityFailures(
 	return failures;
 }
 
-function buildNonStartableCookHandoffMessage(failures: string[]): string {
-	return [
-		"/cook failed closed because a fresh explicit primary-agent startup plan exists, but it is not concrete enough to seed workflow planning yet.",
-		"Tighten the startup plan in the main chat so it captures a concrete mission, repo-change-oriented acceptance, and truthful verification intent, then rerun /cook.",
-		`Blocking details: ${failures.join("; ")}.`,
-	].join(" ");
+function buildNonStartableCookHandoffMessage(
+	failures: string[],
+	context: "explicit_preview" | "same_entry_synthesis" = "explicit_preview",
+): string {
+	return context === "same_entry_synthesis"
+		? [
+			"/cook failed closed because the same-entry primary-agent startup-plan synthesis step returned a startup plan that is still not concrete enough to seed workflow planning yet.",
+			"Clarify the mission, scope, acceptance, or verification intent in the main chat, then rerun /cook so the primary agent can synthesize a tighter startup plan.",
+			`Blocking details: ${failures.join("; ")}.`,
+		].join(" ")
+		: [
+			"/cook failed closed because a fresh explicit primary-agent startup plan exists, but it is not concrete enough to seed workflow planning yet.",
+			"Tighten the startup plan in the main chat so it captures a concrete mission, repo-change-oriented acceptance, and truthful verification intent, then rerun /cook.",
+			`Blocking details: ${failures.join("; ")}.`,
+		].join(" ");
 }
 
 function isStartableCookHandoffCapsule(
@@ -1470,6 +1479,32 @@ function buildContextProposalFromCookHandoffCapsule(
 	return finalizeContextProposal(proposal, projectName, deps);
 }
 
+export function assessCookHandoffText(
+	text: string,
+	projectName: string,
+	deps: ProposalParseDeps,
+	options?: {
+		messageId?: string;
+		timestampMs?: number;
+		context?: "explicit_preview" | "same_entry_synthesis";
+	},
+): CookHandoffProposalAssessment {
+	const capsules = parseCookHandoffCapsulesFromText(text, options?.messageId, options?.timestampMs, deps);
+	for (let capsuleIndex = capsules.length - 1; capsuleIndex >= 0; capsuleIndex -= 1) {
+		const capsule = capsules[capsuleIndex];
+		const failures = cookHandoffStartabilityFailures(capsule, deps);
+		if (failures.length > 0) {
+			return {
+				status: "fresh_but_not_startable",
+				message: buildNonStartableCookHandoffMessage(failures, options?.context ?? "explicit_preview"),
+			};
+		}
+		const proposal = buildContextProposalFromCookHandoffCapsule(capsule, projectName, deps);
+		if (proposal) return { status: "startable", proposal };
+	}
+	return { status: "none" };
+}
+
 export function assessLatestCookHandoffProposal(
 	recentMessages: RecentSessionMessage[],
 	projectName: string,
@@ -1489,7 +1524,7 @@ export function assessLatestCookHandoffProposal(
 			if (failures.length > 0) {
 				return {
 					status: "fresh_but_not_startable",
-					message: buildNonStartableCookHandoffMessage(failures),
+					message: buildNonStartableCookHandoffMessage(failures, "explicit_preview"),
 				};
 			}
 			const proposal = buildContextProposalFromCookHandoffCapsule(capsule, projectName, deps);

package/extensions/completion/role-runner.ts

@@ -103,7 +103,10 @@ const PRIMARY_AGENT_HANDOFF_SYSTEM_PROMPT = [
 	"Author the approved workflow startup plan now from the primary-agent view of the task so /cook can persist it under .agent before completion-regrounder derives canonical slices.",
 	"Capture the agreed mission, scope, constraints or non_goals, acceptance, risks, notes, and any concrete planning hints that will help completion-regrounder split slices later.",
 	"If a bounded first slice, likely implementation surfaces, or likely verification commands are already obvious, include first_slice_goal, first_slice_non_goals, implementation_surfaces, verification_commands, and why_this_slice_first as optional hints only. They are not required when the overall startup plan is already concrete enough to begin workflow planning.",
-	"Do not make /cook infer or rediscover the mission from recent discussion later; author the startup plan now from the primary-agent view of the task.",
+	"Prefer the latest user-authored task context plus canonical workflow context over older assistant-authored previews or stale planning text.",
+	"Do not directly reuse an old preview capsule as-is; either synthesize a fresh startup plan from the current task context or return a brief plain sentence saying no concrete startup plan should replace canonical state yet.",
+	"If canonical workflow context already exists and the latest discussion does not clearly ask to replace the mission or start the next round, return a brief plain sentence instead of inventing a replacement startup plan.",
+	"Do not make /cook infer or rediscover the mission later; author the startup plan now from the primary-agent view of the task.",
 	"Do not emit markdown commentary before or after the capsule.",
 	"If the task is not concrete enough for workflow startup, do not invent missing detail.",
 ].join(" ");
@@ -343,7 +346,8 @@ function buildPrimaryAgentHandoffPrompt(projectName: string, recentEntries: Rece
 	lines.push(
 		"",
 		"Task:",
-		"The user explicitly invoked /cook. Prepare the primary-agent startup plan that /cook should consume immediately for Start/Cancel confirmation, persistence under .agent, and later slice derivation by completion-regrounder.",
+		"The user explicitly invoked /cook. Prepare the primary-agent startup plan that /cook should synthesize immediately for Start/Cancel confirmation, persistence under .agent, and later slice derivation by completion-regrounder.",
+		"If the latest discussion does not justify a concrete new startup plan, return a brief plain sentence instead of speculative JSON.",
 	);
 	return lines.join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linimin/pi-letscook",
-  "version": "0.1.67",
+  "version": "0.1.68",
   "description": "Pi package for long-running completion workflows with canonical .agent state, role-based subagents, continuity, and verification helpers.",
   "license": "MIT",
   "private": false,

package/scripts/active-slice-contract-test.sh

@@ -137,17 +137,16 @@ NODE
 ROOT="$TMPDIR/repo"
 PROMPT="$TMPDIR/resume-prompt.txt"
 BOOTSTRAP_SESSION="$TMPDIR/session-active-slice-bootstrap.jsonl"
-BOOTSTRAP_MESSAGES="$(python3 - <<'PY'
+BOOTSTRAP_DISCUSSION=$'Prepare the active-slice contract bootstrap fixture and tell me when it is ready for /cook.'
+GENERATED_HANDOFF="$(python3 - <<'PY'
 import json
 capsule = {
     "kind": "cook_handoff",
     "source": "primary_agent",
-    "captured_at": "2026-01-01T00:00:02.000Z",
-    "source_turn_id": "m0002",
     "mission": "Exercise active-slice contract parity.",
     "scope": [
         "Bootstrap canonical completion files for the active-slice contract fixture.",
-        "Keep the fixture on the shipped explicit-handoff startup path."
+        "Keep the fixture on the shipped same-entry synthesis startup path."
     ],
     "constraints": [
         "Use supported bare /cook startup only."
@@ -157,7 +156,7 @@ capsule = {
         "Keep scripts/active-slice-contract-test.sh aligned with the packaged startup contract."
     ],
     "risks": [
-        "Active-slice fixture bootstrap must stay anchored to the fresh explicit startup-plan preview."
+        "Active-slice fixture bootstrap must stay anchored to same-entry primary-agent startup-plan synthesis."
     ],
     "notes": [
         "This handoff exists only to scaffold canonical files before the fixture rewrites them for contract parity coverage."
@@ -179,20 +178,16 @@ capsule = {
     "evaluation_profile": "completion-rubric-v1",
     "why_cook_now": "The fixture bootstrap is concrete enough to scaffold canonical control-plane files."
 }
-messages = [
-    {"role": "user", "content": "Prepare the active-slice contract bootstrap fixture and tell me when it is ready for /cook."},
-    {"role": "assistant", "content": "The active-slice contract bootstrap fixture is ready for /cook. Run /cook to confirm it.\n\n```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```"},
-]
-print(json.dumps(messages, ensure_ascii=False))
+print("```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```")
 PY
 )"
 mkdir -p "$ROOT"
 cd "$ROOT"
 git init -q
-write_session_messages "$BOOTSTRAP_SESSION" "$ROOT" "$BOOTSTRAP_MESSAGES"
+write_session "$BOOTSTRAP_SESSION" "$ROOT" "$BOOTSTRAP_DISCUSSION"
 
 PI_COMPLETION_CONTEXT_PROPOSAL_ACTION=accept \
-PI_COMPLETION_DISABLE_CONTEXT_PROPOSAL_ANALYST=1 \
+PI_COMPLETION_PRIMARY_HANDOFF_OUTPUT="$GENERATED_HANDOFF" \
 PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
 pi --session "$BOOTSTRAP_SESSION" -e "$PKG_ROOT" -p "/cook" \
   >"$TMPDIR/pi-active-slice-bootstrap.out" 2>"$TMPDIR/pi-active-slice-bootstrap.err"