@linimin/pi-letscook 0.1.68 → 0.1.69

package/extensions/completion/state-store.ts

@@ -3,7 +3,6 @@ import { spawnSync } from "node:child_process";
 import { promises as fsp } from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-import { buildApprovedStartupPlanMarkdown } from "./prompt-surfaces";
 import type { CompletionStateSnapshot, JsonRecord } from "./types";
 
 const PROTOCOL_ID = "completion";
@@ -46,10 +45,9 @@ export function resolveFiles(root: string) {
 		statePath: path.join(agentDir, "state.json"),
 		planPath: path.join(agentDir, "plan.json"),
 		activePath: path.join(agentDir, "active-slice.json"),
-		startupPlanPath: path.join(agentDir, "startup-plan.json"),
-		startupPlanMarkdownPath: path.join(agentDir, "startup-plan.md"),
 		sliceHistoryPath: path.join(agentDir, "slice-history.jsonl"),
 		stopHistoryPath: path.join(agentDir, "stop-check-history.jsonl"),
+		startupBriefPath: path.join(agentDir, "startup-brief.json"),
 		verificationEvidencePath: path.join(agentDir, "verification-evidence.json"),
 		compactionMarkerPath: path.join(tmpDir, "post-compaction-recovery.json"),
 	};
@@ -144,7 +142,7 @@ export async function loadCompletionSnapshot(startCwd: string): Promise<Completi
 	const state = await readJson(files.statePath);
 	const plan = await readJson(files.planPath);
 	const active = await readJson(files.activePath);
-	const startupPlan = await readJson(files.startupPlanPath);
+	const startupBrief = await readJson(files.startupBriefPath);
 	const verificationEvidence = await readJson(files.verificationEvidencePath);
 	return {
 		files,
@@ -152,7 +150,7 @@ export async function loadCompletionSnapshot(startCwd: string): Promise<Completi
 		state,
 		plan,
 		active,
-		startupPlan,
+		startupBrief,
 		verificationEvidence,
 		activeSlice: findActiveSlice(plan, active),
 	};
@@ -233,15 +231,25 @@ export function buildProfileRecord(args: {
 	};
 }
 
+function buildWorkflowSessionId(): string {
+	return `wf-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+
 export function defaultState(
 	missionAnchor: string,
 	routing?: { taskType?: string; evaluationProfile?: string; continuationReason?: string },
 	advisoryStartupBrief?: JsonRecord,
 ): JsonRecord {
+	const confirmedAt = asString(advisoryStartupBrief?.captured_at) ?? new Date().toISOString();
 	return {
 		schema_version: 1,
 		mission_anchor: missionAnchor,
 		advisory_startup_brief: advisoryStartupBrief ?? null,
+		workflow_entry_status: "active",
+		workflow_entry_source: "/cook",
+		workflow_entry_confirmed_at: confirmedAt,
+		workflow_session_id: buildWorkflowSessionId(),
+		startup_brief_path: ".agent/startup-brief.json",
 		current_phase: "reground",
 		continuation_policy: "continue",
 		continuation_reason: routing?.continuationReason ?? "Fresh completion bootstrap requires canonical re-ground",
@@ -280,32 +288,6 @@ export function defaultPlan(
 	};
 }
 
-export function defaultStartupPlan(
-	missionAnchor: string,
-	routing?: { taskType?: string; evaluationProfile?: string },
-	approvedStartupPlan?: JsonRecord,
-): JsonRecord {
-	return approvedStartupPlan ?? {
-		schema_version: 1,
-		artifact_type: "completion-startup-plan",
-		status: "approved",
-		source: "recent_discussion",
-		captured_at: null,
-		mission_anchor: missionAnchor,
-		goal_text: `Mission: ${missionAnchor}`,
-		task_type: routing?.taskType ?? DEFAULT_TASK_TYPE,
-		evaluation_profile: routing?.evaluationProfile ?? DEFAULT_EVALUATION_PROFILE,
-		scope: [],
-		constraints: [],
-		acceptance: [],
-		risks: [],
-		notes: ["No approved startup plan has been recorded yet."],
-		planned_surfaces: [],
-		verification_intent: [],
-		sequencing_hints: [],
-	};
-}
-
 export function defaultActiveSlice(
 	missionAnchor: string,
 	routing?: { taskType?: string; evaluationProfile?: string },
@@ -334,6 +316,32 @@ export function defaultActiveSlice(
 	};
 }
 
+export function defaultStartupBrief(
+	missionAnchor: string,
+	routing?: { taskType?: string; evaluationProfile?: string },
+	advisoryStartupBrief?: JsonRecord,
+): JsonRecord {
+	return {
+		schema_version: 1,
+		artifact_type: "completion-startup-brief",
+		source: asString(advisoryStartupBrief?.source) ?? "primary_agent",
+		confirmed: true,
+		confirmed_at: asString(advisoryStartupBrief?.captured_at) ?? new Date().toISOString(),
+		mission: asString(advisoryStartupBrief?.mission) ?? missionAnchor,
+		goal_text: asString(advisoryStartupBrief?.goal_text) ?? `Mission: ${missionAnchor}`,
+		scope: asStringArray(advisoryStartupBrief?.scope),
+		constraints: asStringArray(advisoryStartupBrief?.constraints),
+		acceptance: asStringArray(advisoryStartupBrief?.acceptance),
+		risks: asStringArray(advisoryStartupBrief?.risks),
+		notes:
+			asStringArray(advisoryStartupBrief?.notes).length > 0
+				? asStringArray(advisoryStartupBrief?.notes)
+				: ["No additional startup notes were preserved for this workflow entry."],
+		task_type: asString(advisoryStartupBrief?.task_type) ?? routing?.taskType ?? DEFAULT_TASK_TYPE,
+		evaluation_profile: asString(advisoryStartupBrief?.evaluation_profile) ?? routing?.evaluationProfile ?? DEFAULT_EVALUATION_PROFILE,
+	};
+}
+
 export function defaultVerificationEvidence(): JsonRecord {
 	return {
 		schema_version: 1,
@@ -352,7 +360,7 @@ export function defaultVerificationEvidence(): JsonRecord {
 }
 
 export function buildAgentReadme(projectName: string): string {
-	return `# Completion Control Plane\n\nThis repository uses the \`completion\` workflow for long-running coding tasks.\n\n## Canonical tracked contract files\n\n- \`.agent/README.md\`\n- \`.agent/mission.md\`\n- \`.agent/profile.json\`\n- \`.agent/verify_completion_stop.sh\`\n- \`.agent/verify_completion_control_plane.sh\`\n\n## Ignored canonical execution state\n\n- \`.agent/state.json\`\n- \`.agent/startup-plan.json\`\n- \`.agent/startup-plan.md\`\n- \`.agent/plan.json\`\n- \`.agent/active-slice.json\`\n- \`.agent/slice-history.jsonl\`\n- \`.agent/stop-check-history.jsonl\`\n- \`.agent/verification-evidence.json\`\n- \`.agent/*.log\`\n- \`.agent/tmp/\`\n\n\`.agent/startup-plan.json\` plus \`.agent/startup-plan.md\` preserve the approved workflow startup plan captured at \`/cook\`. \`completion-regrounder\` consumes that plan as planning input, then derives canonical slices in \`.agent/plan.json\` from current repo truth.\n\n\`.agent/verification-evidence.json\` is the durable canonical record of deterministic verification for the selected slice or current HEAD. Recovery, review, audit, and stop-check reminder surfaces consume it instead of temp-only artifacts or conversational summaries when it is populated.\n\nThe source of truth for long-running completion work is canonical \`.agent/**\` state plus current repo truth.\n\nProject: ${projectName}\n`;
+	return `# Completion Control Plane\n\nThis repository uses the \`completion\` workflow for long-running coding tasks.\n\n## Canonical tracked contract files\n\n- \`.agent/README.md\`\n- \`.agent/mission.md\`\n- \`.agent/profile.json\`\n- \`.agent/verify_completion_stop.sh\`\n- \`.agent/verify_completion_control_plane.sh\`\n\n## Ignored canonical execution state\n\n- \`.agent/state.json\`\n- \`.agent/startup-brief.json\`\n- \`.agent/plan.json\`\n- \`.agent/active-slice.json\`\n- \`.agent/slice-history.jsonl\`\n- \`.agent/stop-check-history.jsonl\`\n- \`.agent/verification-evidence.json\`\n- \`.agent/*.log\`\n- \`.agent/tmp/\`\n\n\`.agent/startup-brief.json\` preserves the confirmed \`/cook\` startup intent as canonical intake for re-grounding. It does not replace \`.agent/plan.json\` or \`.agent/active-slice.json\`, which remain under regrounder authority.\n\n\`.agent/verification-evidence.json\` is the durable canonical record of deterministic verification for the selected slice or current HEAD. Recovery, review, audit, and stop-check reminder surfaces consume it instead of temp-only artifacts or conversational summaries when it is populated.\n\nThe source of truth for long-running completion work is canonical \`.agent/**\` state plus current repo truth.\n\nProject: ${projectName}\n`;
 }
 
 export function buildMission(projectName: string, missionAnchor: string): string {
@@ -455,23 +463,15 @@ function trackedDiffFiles(fromCommit, toCommit) {
 
 const profile = readJson('.agent/profile.json');
 const state = readJson('.agent/state.json');
-const startupPlan = readJson('.agent/startup-plan.json');
 const plan = readJson('.agent/plan.json');
 const active = readJson('.agent/active-slice.json');
 const evidence = readJson('.agent/verification-evidence.json');
-let startupPlanMarkdown = '';
-try {
-  startupPlanMarkdown = fs.readFileSync('.agent/startup-plan.md', 'utf8');
-} catch (error) {
-  fail('.agent/startup-plan.md must be present and readable: ' + error.message);
-}
 
 ensureTrackedContractFiles();
 
 for (const [file, record] of [
   ['.agent/profile.json', profile],
   ['.agent/state.json', state],
-  ['.agent/startup-plan.json', startupPlan],
   ['.agent/plan.json', plan],
   ['.agent/active-slice.json', active],
 ]) {
@@ -482,38 +482,12 @@ for (const [file, record] of [
 const taskType = asString(profile.task_type);
 const evaluationProfile = asString(profile.evaluation_profile);
 if (asString(state.task_type) !== taskType) fail('.agent/state.json task_type must match .agent/profile.json task_type');
-if (asString(startupPlan.task_type) !== taskType) fail('.agent/startup-plan.json task_type must match .agent/profile.json task_type');
 if (asString(plan.task_type) !== taskType) fail('.agent/plan.json task_type must match .agent/profile.json task_type');
 if (asString(active.task_type) !== taskType) fail('.agent/active-slice.json task_type must match .agent/profile.json task_type');
 if (asString(state.evaluation_profile) !== evaluationProfile) fail('.agent/state.json evaluation_profile must match .agent/profile.json evaluation_profile');
-if (asString(startupPlan.evaluation_profile) !== evaluationProfile) fail('.agent/startup-plan.json evaluation_profile must match .agent/profile.json evaluation_profile');
 if (asString(plan.evaluation_profile) !== evaluationProfile) fail('.agent/plan.json evaluation_profile must match .agent/profile.json evaluation_profile');
 if (asString(active.evaluation_profile) !== evaluationProfile) fail('.agent/active-slice.json evaluation_profile must match .agent/profile.json evaluation_profile');
 
-if (asString(startupPlan.artifact_type) !== 'completion-startup-plan') {
-  fail('.agent/startup-plan.json artifact_type must be completion-startup-plan');
-}
-if (asString(startupPlan.status) !== 'approved') {
-  fail('.agent/startup-plan.json status must be approved');
-}
-const startupPlanMissionAnchor = asString(startupPlan.mission_anchor);
-if (!startupPlanMissionAnchor) fail('.agent/startup-plan.json mission_anchor must be present');
-if (startupPlanMissionAnchor !== asString(state.mission_anchor)) fail('.agent/startup-plan.json mission_anchor must match .agent/state.json mission_anchor');
-if (startupPlanMissionAnchor !== asString(plan.mission_anchor)) fail('.agent/startup-plan.json mission_anchor must match .agent/plan.json mission_anchor');
-if (startupPlanMissionAnchor !== asString(active.mission_anchor)) fail('.agent/startup-plan.json mission_anchor must match .agent/active-slice.json mission_anchor');
-if (!asString(startupPlan.goal_text)) fail('.agent/startup-plan.json goal_text must be present');
-for (const field of ['scope', 'constraints', 'acceptance', 'risks', 'notes', 'planned_surfaces', 'verification_intent', 'sequencing_hints']) {
-  if (!Array.isArray(startupPlan[field])) fail('.agent/startup-plan.json is missing ' + field);
-}
-if (startupPlanMarkdown.trim().length === 0) fail('.agent/startup-plan.md must not be empty');
-if (startupPlanMissionAnchor && !startupPlanMarkdown.includes(startupPlanMissionAnchor)) {
-  fail('.agent/startup-plan.md must mention the startup-plan mission_anchor');
-}
-const startupPlanGoalText = asString(startupPlan.goal_text);
-if (startupPlanGoalText && !startupPlanMarkdown.includes(startupPlanGoalText)) {
-  fail('.agent/startup-plan.md must render the startup-plan goal_text');
-}
-
 if (asString(evidence.artifact_type) !== 'completion-verification-evidence') {
   fail('.agent/verification-evidence.json artifact_type must be completion-verification-evidence');
 }
@@ -660,12 +634,7 @@ export type ScaffoldResult = {
 export async function scaffoldCompletionFiles(
 	root: string,
 	missionAnchor: string,
-	options?: {
-		analysis?: { taskType?: string; evaluationProfile?: string };
-		continuationReason?: string;
-		advisoryStartupBrief?: JsonRecord;
-		approvedStartupPlan?: JsonRecord;
-	},
+	options?: { analysis?: { taskType?: string; evaluationProfile?: string }; continuationReason?: string; advisoryStartupBrief?: JsonRecord },
 ): Promise<ScaffoldResult> {
 	const files = resolveFiles(root);
 	const created: string[] = [];
@@ -675,10 +644,6 @@ export async function scaffoldCompletionFiles(
 	const projectName = path.basename(root);
 	const docsSurfaces = await detectDocsSurfaces(root);
 	const verifierCommand = await detectVerifierCommand(root);
-	const startupPlanRecord =
-		options?.approvedStartupPlan ??
-		(await readJson(files.startupPlanPath)) ??
-		defaultStartupPlan(missionAnchor, { taskType: options?.analysis?.taskType, evaluationProfile: options?.analysis?.evaluationProfile });
 	const trackedFiles: Array<{ path: string; content: string; executable?: boolean }> = [
 		{ path: path.join(files.agentDir, "README.md"), content: buildAgentReadme(projectName) },
 		{ path: path.join(files.agentDir, "mission.md"), content: buildMission(projectName, missionAnchor) },
@@ -693,12 +658,8 @@ export async function scaffoldCompletionFiles(
 			content: `${JSON.stringify(defaultState(missionAnchor, { taskType: options?.analysis?.taskType, evaluationProfile: options?.analysis?.evaluationProfile, continuationReason: options?.continuationReason }, options?.advisoryStartupBrief), null, 2)}\n`,
 		},
 		{
-			path: files.startupPlanPath,
-			content: `${JSON.stringify(startupPlanRecord, null, 2)}\n`,
-		},
-		{
-			path: files.startupPlanMarkdownPath,
-			content: buildApprovedStartupPlanMarkdown(startupPlanRecord as any),
+			path: files.startupBriefPath,
+			content: `${JSON.stringify(defaultStartupBrief(missionAnchor, { taskType: options?.analysis?.taskType, evaluationProfile: options?.analysis?.evaluationProfile }, options?.advisoryStartupBrief), null, 2)}\n`,
 		},
 		{ path: files.planPath, content: `${JSON.stringify(defaultPlan(missionAnchor, { taskType: options?.analysis?.taskType, evaluationProfile: options?.analysis?.evaluationProfile }), null, 2)}\n` },
 		{ path: files.activePath, content: `${JSON.stringify(defaultActiveSlice(missionAnchor, { taskType: options?.analysis?.taskType, evaluationProfile: options?.analysis?.evaluationProfile }), null, 2)}\n` },
@@ -721,7 +682,6 @@ export function currentTaskType(snapshot: CompletionStateSnapshot): string | und
 	return (
 		asString(snapshot.active?.task_type) ??
 		asString(snapshot.state?.task_type) ??
-		asString(snapshot.startupPlan?.task_type) ??
 		asString(snapshot.plan?.task_type) ??
 		asString(snapshot.profile?.task_type)
 	);
@@ -731,7 +691,6 @@ export function currentEvaluationProfile(snapshot: CompletionStateSnapshot): str
 	return (
 		asString(snapshot.active?.evaluation_profile) ??
 		asString(snapshot.state?.evaluation_profile) ??
-		asString(snapshot.startupPlan?.evaluation_profile) ??
 		asString(snapshot.plan?.evaluation_profile) ??
 		asString(snapshot.profile?.evaluation_profile)
 	);
@@ -740,7 +699,6 @@ export function currentEvaluationProfile(snapshot: CompletionStateSnapshot): str
 export function currentMissionAnchor(snapshot: CompletionStateSnapshot): string {
 	return (
 		asString(snapshot.state?.mission_anchor) ??
-		asString(snapshot.startupPlan?.mission_anchor) ??
 		asString(snapshot.plan?.mission_anchor) ??
 		asString(snapshot.active?.mission_anchor) ??
 		path.basename(snapshot.files.root)

package/extensions/completion/types.ts

@@ -18,10 +18,9 @@ export type CompletionFiles = {
 	statePath: string;
 	planPath: string;
 	activePath: string;
-	startupPlanPath: string;
-	startupPlanMarkdownPath: string;
 	sliceHistoryPath: string;
 	stopHistoryPath: string;
+	startupBriefPath: string;
 	verificationEvidencePath: string;
 	compactionMarkerPath: string;
 };
@@ -32,7 +31,7 @@ export type CompletionStateSnapshot = {
 	state?: JsonRecord;
 	plan?: JsonRecord;
 	active?: JsonRecord;
-	startupPlan?: JsonRecord;
+	startupBrief?: JsonRecord;
 	verificationEvidence?: JsonRecord;
 	activeSlice?: JsonRecord;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linimin/pi-letscook",
-  "version": "0.1.68",
+  "version": "0.1.69",
   "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

@@ -242,6 +242,11 @@ acceptance = [
 state = {
     'schema_version': 1,
     'mission_anchor': mission,
+    'workflow_entry_status': 'active',
+    'workflow_entry_source': '/cook',
+    'workflow_entry_confirmed_at': '2026-05-03T00:00:00Z',
+    'workflow_session_id': 'active-slice-fixture-session',
+    'startup_brief_path': '.agent/startup-brief.json',
     'current_phase': 'implement',
     'continuation_policy': 'continue',
     'continuation_reason': 'Fixture for active-slice contract regression coverage.',
@@ -316,6 +321,22 @@ active = {
 }
 
 Path('.agent/state.json').write_text(json.dumps(state, indent=2) + '\n')
+Path('.agent/startup-brief.json').write_text(json.dumps({
+    'schema_version': 1,
+    'artifact_type': 'completion-startup-brief',
+    'source': 'primary_agent',
+    'confirmed': True,
+    'confirmed_at': '2026-05-03T00:00:00Z',
+    'mission': mission,
+    'goal_text': f'Mission: {mission}',
+    'scope': ['Exercise active-slice contract parity.'],
+    'constraints': ['Keep the fixture scoped to active-slice contract coverage.'],
+    'acceptance': acceptance,
+    'risks': ['Fixture drift can hide active-slice contract regressions.'],
+    'notes': ['Fixture startup brief for active-slice contract regression coverage.'],
+    'task_type': task_type,
+    'evaluation_profile': evaluation_profile,
+}, indent=2) + '\n')
 Path('.agent/plan.json').write_text(json.dumps(plan, indent=2) + '\n')
 Path('.agent/active-slice.json').write_text(json.dumps(active, indent=2) + '\n')
 Path('.agent/verification-evidence.json').write_text(json.dumps({

package/scripts/canonical-evidence-artifact-test.sh

@@ -134,11 +134,11 @@ assertIncludes('.agent/README.md', 'durable canonical record of deterministic ve
 assertSectionIncludes('skills/completion-protocol/SKILL.md', '## Canonical Files', '- `.agent/verification-evidence.json`');
 assertSectionIncludes('skills/completion-protocol/SKILL.md', '## Canonical Inputs', '- `.agent/verification-evidence.json`');
 assertSectionIncludes('skills/completion-protocol/SKILL.md', '## Compaction And Recovery', '- `.agent/verification-evidence.json`');
-assertSectionIncludes('skills/completion-protocol/SKILL.md', '## Compaction And Recovery', '`completion-implementer` must also re-read canonical `.agent/state.json`, `.agent/startup-plan.json`, `.agent/plan.json`, `.agent/active-slice.json`, and `.agent/verification-evidence.json` before resuming work.');
+assertSectionIncludes('skills/completion-protocol/SKILL.md', '## Compaction And Recovery', '`completion-implementer` must also re-read canonical `.agent/state.json`, `.agent/plan.json`, `.agent/active-slice.json`, and `.agent/verification-evidence.json` before resuming work.');
 assertSectionIncludes('skills/completion-protocol/references/completion.md', '## Ignored Canonical Execution State', '- `.agent/verification-evidence.json`');
 assertSectionIncludes('skills/completion-protocol/references/completion.md', '## Canonical Inputs', '- `.agent/verification-evidence.json`');
 assertSectionIncludes('skills/completion-protocol/references/completion.md', '## Compaction And Recovery', '- `.agent/verification-evidence.json`');
-assertSectionIncludes('skills/completion-protocol/references/completion.md', '## Compaction And Recovery', '`completion-implementer` must also re-read canonical `.agent/state.json`, `.agent/startup-plan.json`, `.agent/plan.json`, `.agent/active-slice.json`, and `.agent/verification-evidence.json` before resuming work.');
+assertSectionIncludes('skills/completion-protocol/references/completion.md', '## Compaction And Recovery', '`completion-implementer` must also re-read canonical `.agent/state.json`, `.agent/plan.json`, `.agent/active-slice.json`, and `.agent/verification-evidence.json` before resuming work.');
 assertIncludes('extensions/completion/prompt-surfaces.ts', 'Verification evidence artifact: ${args.evidence.path} (${args.evidence.status})');
 assertIncludes('extensions/completion/prompt-surfaces.ts', 'Verification evidence summary: ${args.evidence.summary}');
 assertIncludes('extensions/completion/index.ts', 'Canonical verification evidence artifact is currently: ${evidence.path} (${evidence.status})');
@@ -157,6 +157,13 @@ bash .agent/verify_completion_control_plane.sh >/dev/null
 CURRENT_EVIDENCE_BACKUP="$TMPDIR/current-verification-evidence.json"
 cp .agent/verification-evidence.json "$CURRENT_EVIDENCE_BACKUP"
 
+CURRENT_EVIDENCE_SUBJECT_TYPE="$(python3 - <<'PY'
+import json
+from pathlib import Path
+print(json.loads(Path('.agent/verification-evidence.json').read_text()).get('subject_type', ''))
+PY
+)"
+
 python3 - <<'PY'
 import json
 from pathlib import Path
@@ -166,14 +173,16 @@ evidence['head_sha'] = 'stale-head'
 path.write_text(json.dumps(evidence, indent=2) + '\n')
 PY
 
-if bash ./scripts/release-check.sh >/dev/null 2>&1; then
-  echo "expected release-check to fail when current repo verification-evidence.json is stale" >&2
-  exit 1
-fi
+if [[ "$CURRENT_EVIDENCE_SUBJECT_TYPE" == "selected_slice" ]]; then
+  if bash ./scripts/release-check.sh >/dev/null 2>&1; then
+    echo "expected release-check to fail when current repo verification-evidence.json is stale" >&2
+    exit 1
+  fi
 
-if bash .agent/verify_completion_stop.sh >/dev/null 2>&1; then
-  echo "expected verify_completion_stop.sh to fail when current repo verification-evidence.json is stale" >&2
-  exit 1
+  if bash .agent/verify_completion_stop.sh >/dev/null 2>&1; then
+    echo "expected verify_completion_stop.sh to fail when current repo verification-evidence.json is stale" >&2
+    exit 1
+  fi
 fi
 
 cp "$CURRENT_EVIDENCE_BACKUP" .agent/verification-evidence.json
@@ -182,26 +191,27 @@ bash .agent/verify_completion_control_plane.sh >/dev/null
 ROOT="$TMPDIR/repo"
 SYSTEM_REMINDER="$TMPDIR/system-reminder.txt"
 BOOTSTRAP_SESSION="$TMPDIR/session-canonical-evidence-bootstrap.jsonl"
-BOOTSTRAP_DISCUSSION=$'Prepare the canonical evidence bootstrap fixture and tell me when it is ready for /cook.'
-GENERATED_HANDOFF="$(python3 - <<'PY'
+BOOTSTRAP_MESSAGES="$(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 canonical evidence fixture bootstrap.",
     "scope": [
         "Materialize canonical completion files for the evidence artifact fixture.",
-        "Keep the verification-evidence bootstrap on the supported same-entry synthesis startup path."
+        "Keep the verification-evidence bootstrap on the supported explicit-handoff startup path."
     ],
     "constraints": [
         "Use supported bare /cook startup only."
     ],
     "acceptance": [
-        "Scaffold .agent/profile.json, .agent/state.json, .agent/plan.json, .agent/active-slice.json, and .agent/verification-evidence.json before the fixture rewrites them.",
+        "Write the workflow control-plane files under .agent, including profile.json, state.json, active-slice.json, verification-evidence.json, and the slice backlog file, before the fixture rewrites them.",
         "Keep scripts/canonical-evidence-artifact-test.sh aligned with packaged bootstrap behavior."
     ],
     "risks": [
-        "Evidence-artifact bootstrap must stay anchored to same-entry primary-agent startup-plan synthesis."
+        "Evidence-artifact bootstrap must stay anchored to the fresh explicit handoff."
     ],
     "notes": [
         "This fixture exists only to scaffold canonical files before rewriting them for evidence parity coverage."
@@ -223,26 +233,30 @@ capsule = {
     "evaluation_profile": "completion-rubric-v1",
     "why_cook_now": "The fixture bootstrap is concrete enough to create canonical control-plane files."
 }
-print("```cook_handoff\n" + json.dumps(capsule, ensure_ascii=False, indent=2) + "\n```")
+messages = [
+    {"role": "user", "content": "Prepare the canonical evidence bootstrap fixture and tell me when it is ready for /cook."},
+    {"role": "assistant", "content": "The canonical evidence 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))
 PY
 )"
 mkdir -p "$ROOT"
 cd "$ROOT"
 git init -q
-write_session "$BOOTSTRAP_SESSION" "$ROOT" "$BOOTSTRAP_DISCUSSION"
+write_session_messages "$BOOTSTRAP_SESSION" "$ROOT" "$BOOTSTRAP_MESSAGES"
 
 PI_COMPLETION_CONTEXT_PROPOSAL_ACTION=accept \
-PI_COMPLETION_PRIMARY_HANDOFF_OUTPUT="$GENERATED_HANDOFF" \
+PI_COMPLETION_DISABLE_CONTEXT_PROPOSAL_ANALYST=1 \
 PI_COMPLETION_SKIP_DRIVER_KICKOFF=1 \
 pi --session "$BOOTSTRAP_SESSION" -e "$PKG_ROOT" -p "/cook" \
   >"$TMPDIR/pi-canonical-evidence-bootstrap.out" 2>"$TMPDIR/pi-canonical-evidence-bootstrap.err"
 
-for file in .agent/profile.json .agent/state.json .agent/startup-plan.json .agent/startup-plan.md .agent/plan.json .agent/active-slice.json .agent/verification-evidence.json; do
+for file in .agent/profile.json .agent/state.json .agent/plan.json .agent/active-slice.json .agent/verification-evidence.json; do
   [[ -f "$file" ]] || { echo "missing canonical bootstrap file: $file" >&2; exit 1; }
 done
 
 bash .agent/verify_completion_control_plane.sh >/dev/null
-bash .agent/verify_completion_stop.sh >/dev/null
+PI_COMPLETION_RUNNING_RELEASE_CHECK=1 bash .agent/verify_completion_stop.sh >/dev/null
 
 python3 - <<'PY'
 import json
@@ -283,39 +297,14 @@ acceptance = [
     'Canonical verification evidence is recorded for the selected slice.',
     'Fail-closed verification rejects missing or stale evidence.',
 ]
-startup_plan = {
-    'schema_version': 1,
-    'artifact_type': 'completion-startup-plan',
-    'status': 'approved',
-    'source': 'deferred_primary_agent_handoff',
-    'captured_at': '2026-05-03T00:00:00Z',
-    'mission_anchor': mission,
-    'goal_text': 'Mission: Exercise canonical verification evidence parity.\n\nScope:\n- Persist canonical verification evidence for the selected slice.\n- Keep the verifier fail-closed on stale or missing evidence.\n\nAcceptance:\n- Canonical verification evidence is recorded for the selected slice.\n- Fail-closed verification rejects missing or stale evidence.',
-    'task_type': task_type,
-    'evaluation_profile': evaluation_profile,
-    'scope': [
-        'Persist canonical verification evidence for the selected slice.',
-        'Keep the verifier fail-closed on stale or missing evidence.',
-    ],
-    'constraints': [
-        'Keep the fixture scoped to canonical verification evidence parity.',
-    ],
-    'acceptance': acceptance,
-    'risks': [
-        'Stale startup-plan parity could mask canonical evidence regressions.',
-    ],
-    'notes': [
-        'Use startup-plan parity to prove the verifier reads the approved startup plan alongside other canonical state.',
-    ],
-    'planned_surfaces': implementation_surfaces,
-    'verification_intent': verification_commands,
-    'sequencing_hints': [
-        'First slice goal: Persist canonical verification evidence for the selected slice.',
-    ],
-}
 state = {
     'schema_version': 1,
     'mission_anchor': mission,
+    'workflow_entry_status': 'active',
+    'workflow_entry_source': '/cook',
+    'workflow_entry_confirmed_at': '2026-05-03T00:00:00Z',
+    'workflow_session_id': 'evidence-fixture-session',
+    'startup_brief_path': '.agent/startup-brief.json',
     'current_phase': 'implement',
     'continuation_policy': 'continue',
     'continuation_reason': 'Fixture for canonical evidence artifact regression coverage.',
@@ -389,22 +378,25 @@ active = {
     'why_now': 'Exercise fail-closed evidence parity.',
 }
 
+startup_brief = {
+    'schema_version': 1,
+    'artifact_type': 'completion-startup-brief',
+    'source': 'primary_agent',
+    'confirmed': True,
+    'confirmed_at': '2026-05-03T00:00:00Z',
+    'mission': mission,
+    'goal_text': f'Mission: {mission}',
+    'scope': ['Exercise canonical verification evidence artifact parity.'],
+    'constraints': ['Keep the fixture scoped to verification evidence coverage.'],
+    'acceptance': acceptance,
+    'risks': ['Fixture drift can hide evidence-parity regressions.'],
+    'notes': ['Fixture startup brief for canonical evidence artifact regression coverage.'],
+    'task_type': task_type,
+    'evaluation_profile': evaluation_profile,
+}
+
 Path('.agent/state.json').write_text(json.dumps(state, indent=2) + '\n')
-Path('.agent/startup-plan.json').write_text(json.dumps(startup_plan, indent=2) + '\n')
-Path('.agent/startup-plan.md').write_text(
-    '# Approved Startup Plan\n\n'
-    f'Mission anchor: {mission}\n'
-    'Source: deferred_primary_agent_handoff\n'
-    'Captured at: 2026-05-03T00:00:00Z\n'
-    f'Task type: {task_type}\n'
-    f'Evaluation profile: {evaluation_profile}\n\n'
-    '## Goal\n\n'
-    f"{startup_plan['goal_text']}\n\n"
-    '## Planned surfaces\n\n'
-    + ''.join(f'- {item}\n' for item in startup_plan['planned_surfaces'])
-    + '\n## Verification intent\n\n'
-    + ''.join(f'- {item}\n' for item in startup_plan['verification_intent'])
-)
+Path('.agent/startup-brief.json').write_text(json.dumps(startup_brief, indent=2) + '\n')
 Path('.agent/plan.json').write_text(json.dumps(plan, indent=2) + '\n')
 Path('.agent/active-slice.json').write_text(json.dumps(active, indent=2) + '\n')
 PY
@@ -506,7 +498,7 @@ Path('.agent/verification-evidence.json').write_text(json.dumps(valid, indent=2)
 PY
 
 bash .agent/verify_completion_control_plane.sh >/dev/null
-bash .agent/verify_completion_stop.sh >/dev/null
+PI_COMPLETION_RUNNING_RELEASE_CHECK=1 bash .agent/verify_completion_stop.sh >/dev/null
 
 rm -f "$SYSTEM_REMINDER"
 PI_COMPLETION_TEST_SYSTEM_REMINDER_PATH="$SYSTEM_REMINDER" \