atris 3.45.1 → 3.46.0

package/commands/mission.js

@@ -98,6 +98,7 @@ const GOAL_LOOP_STATUSES = new Set(['planning', 'running', 'ready']);
 const STATUS_ALIASES = new Set(['active']);
 const CODEX_NATIVE_GOAL_SLOT_STATUSES = new Set(['active', 'paused', 'usage_limited']);
 const CODEX_NATIVE_GOAL_REPLACE_STATUSES = new Set(['active', 'paused', 'usage_limited']);
+const CODEX_NATIVE_GOAL_CLOSED_STATUSES = new Set(['complete', 'completed', 'achieved']);
 const DEFAULT_LONG_RUN_VERIFIER = 'git diff --check';
 const SLEEP_LENGTH_BUDGET_SECONDS = 3600;
 const HUMAN_BLOCKING_PAUSE_REASONS = new Set(['auth-required', 'model-unavailable', 'rate-limit-exceeded-wall']);
@@ -6552,9 +6553,14 @@ function normalizeCodexNativeGoalStatus(value) {
   if (compact === 'usagelimited') return 'usage_limited';
   if (compact === 'active') return 'active';
   if (compact === 'paused') return 'paused';
+  if (CODEX_NATIVE_GOAL_CLOSED_STATUSES.has(compact)) return 'complete';
   return raw.toLowerCase();
 }
 
+function codexRuntimeTaskIsClosed(runtimeGoalState) {
+  return runtimeGoalState?.status === 'complete';
+}
+
 function codexRuntimeGoalStatusLabel(runtimeGoalState) {
   const status = runtimeGoalState?.status || '';
   if (status === 'usage_limited') return 'usageLimited';
@@ -6652,9 +6658,7 @@ function codexNativeGoalRuntimeReplaceAction(newMission, runtimeGoalState = null
   const toObjective = codexGoalObjective(newMission);
   const fromObjective = runtimeGoalState?.objective || null;
   const ackNewMission = commands.ack_new_mission || codexGoalAckCommand(newMission, toObjective);
-  const completeCurrentGoal = 'update_goal({ status: "complete" })';
-  const createNewGoal = `create_goal({ objective: ${JSON.stringify(toObjective)} })`;
-  const supersedeApproved = commands.allow_native_goal_supersede === true;
+  const newTaskInstruction = `Create a new Codex task for ${JSON.stringify(toObjective)}, then run ${ackNewMission}`;
   return {
     runtime: 'codex',
     tool: 'replace_goal',
@@ -6672,23 +6676,18 @@ function codexNativeGoalRuntimeReplaceAction(newMission, runtimeGoalState = null
       ack_new_mission: ackNewMission,
     },
     fallback: {
-      reason: 'This Codex runtime exposes get_goal/create_goal/update_goal but not replace_goal or resume_goal.',
-      automatic: supersedeApproved,
-      approved: supersedeApproved,
-      executable_now: supersedeApproved,
-      blocked_by: supersedeApproved ? null : 'native_goal_cancel_or_supersede_tool_missing',
-      safe_when: 'Use only when a mission handoff proves the paused goal is intentionally superseded; update_goal complete otherwise misrepresents abandoned work as finished.',
-      sequence_name: 'complete_paused_goal_then_create_new_goal',
-      sequence: [
-        completeCurrentGoal,
-        createNewGoal,
-        ackNewMission,
-      ],
+      reason: 'A different objective belongs in a new Codex task; this task keeps its current goal and history.',
+      automatic: false,
+      approved: false,
+      executable_now: false,
+      blocked_by: 'new_codex_task_required',
+      safe_when: 'Continue here only when the active objective still matches this task.',
+      sequence_name: 'new_codex_task_required',
+      sequence: [],
       commands: {
         ...commands,
-        complete_current_goal: completeCurrentGoal,
-        create_new_goal: createNewGoal,
-        ack_new_mission: ackNewMission,
+        create_new_task: newTaskInstruction,
+        ack_new_mission_after_task_create: ackNewMission,
       },
     },
   };
@@ -6887,14 +6886,28 @@ function codexNativeGoalReplaceInstruction(mission, runtimeGoalState = null, obj
     ? ` from paused objective ${JSON.stringify(runtimeGoalState.objective)}`
     : '';
   if (options.allowNativeGoalSupersede === true) {
-    return `Supersede approved: run update_goal({ status: "complete" }), then create_goal({ objective: ${JSON.stringify(objective)} }), then run ${codexGoalAckCommand(mission, objective)}. Atris records the old paused goal as superseded.`;
+    return `Same-task supersede refused${fromObjective}. Create a new Codex task for ${JSON.stringify(objective)}, then run ${codexGoalAckCommand(mission, objective)} there.`;
   }
-  return `Native Codex replace_goal is required${fromObjective} to ${JSON.stringify(objective)}, then run ${codexGoalAckCommand(mission, objective)}; this runtime currently lacks replace_goal. Fallback is update_goal({ status: "complete" }) -> create_goal({ objective: ${JSON.stringify(objective)} }) -> mission goal ack only after handoff proof says the paused goal is intentionally superseded.`;
+  return `This Codex task keeps${fromObjective || ' its current objective'}. Create a new dedicated Codex task for ${JSON.stringify(objective)}, then run ${codexGoalAckCommand(mission, objective)} there.`;
 }
 
 function codexNativeGoalBlockPayload(mission, options = {}) {
   const objective = codexGoalObjective(mission);
   const runtimeGoalState = codexRuntimeGoalStateFromOptions(options);
+  if (codexRuntimeTaskIsClosed(runtimeGoalState)) {
+    return {
+      ok: false,
+      code: 'completed_task_closed',
+      mission_id: mission.id,
+      objective,
+      runtime_goal_state: runtimeGoalState,
+      requires_native_goal_start: false,
+      requires_new_task: true,
+      native_goal_action: null,
+      native_goal_ack_command: null,
+      next_action: 'Create a new Codex task for this mission. This completed task must retain its final state.',
+    };
+  }
   const recovery = codexNativeGoalRecovery(mission, runtimeGoalState);
   if (recovery) {
     return {
@@ -6985,30 +6998,32 @@ function codexGoalReplaceAfterInstruction(mission) {
   if (missionBudgetContinuationText(mission)) {
     return 'After each proof, run atris mission goal --json again and keep the matching Codex /goal active until the full budget is used.';
   }
-  return 'After proof or verifier pass, run atris mission goal --json again and replace the Codex /goal with the returned objective.';
+  return 'After proof or verifier pass, complete this Codex task and stop. A different objective belongs in a new Codex task.';
 }
 
 function codexVisibleGoalBridge(mission, goalObjective, options = {}) {
   const ack = codexNativeGoalAck(mission, goalObjective);
   const recovery = options.nativeGoalRecovery || null;
+  const completedTaskClosed = options.completedTaskClosed === true;
   return {
     schema: 'atris.visible_chat_goal_bridge.v1',
     runtime: 'codex',
     source: 'atris_mission',
     mission_id: mission.id,
     desired_objective: goalObjective,
-    status: ack ? 'active' : (recovery ? 'needs_ack_recovery' : 'needs_runtime_write'),
+    status: completedTaskClosed ? 'completed_task_closed' : (ack ? 'active' : (recovery ? 'needs_ack_recovery' : 'needs_runtime_write')),
     acknowledged_at: ack?.acknowledged_at || null,
     state_file: '.atris/state/codex_goal.json',
     status_file: 'atris/status/codex-goal.md',
     operations: {
       read_current_goal: 'get_goal',
       keep_if_matching: 'if current goal objective equals goal.objective, continue the mission',
-      create_when_empty_or_completed: ack || recovery ? null : 'create_goal({ objective: goal.objective })',
+      create_when_no_goal: ack || recovery || completedTaskClosed ? null : 'create_goal({ objective: goal.objective })',
+      completed_task_action: completedTaskClosed ? 'stop this task and create a new dedicated Codex task for the next objective' : null,
       ack_existing_matching_goal: recovery?.commands?.ack_current_goal || null,
       handoff_when_usage_limited: recovery?.commands?.handoff_to_fresh_agent || null,
-      ack_after_create: codexGoalAckCommand(mission, goalObjective),
-      complete_after_proof: codexGoalCompletionInstruction(mission),
+      ack_after_create: completedTaskClosed ? null : codexGoalAckCommand(mission, goalObjective),
+      complete_after_proof: completedTaskClosed ? null : codexGoalCompletionInstruction(mission),
       refresh_on_phase_change: 'atris mission goal --json before continuing changed work',
       refresh_next_candidate: 'atris mission goal --json',
     },
@@ -7016,6 +7031,7 @@ function codexVisibleGoalBridge(mission, goalObjective, options = {}) {
       ...(missionBudgetContinuationText(mission)
         ? ['Keep the matching native goal active until the full budget is used, even when an intermediate verifier passes.']
         : []),
+      'A completed Codex task stays closed; never create another goal in that task.',
       'Do not complete a human-set active goal unless it matches this mission goal or the mission receipt proves handoff.',
       'If create_goal fails because another goal is active, keep this bridge waiting for the visible goal slot.',
       'Do not run mission work for runner=codex_goal until ack_after_create has been recorded.',
@@ -7024,7 +7040,23 @@ function codexVisibleGoalBridge(mission, goalObjective, options = {}) {
   };
 }
 
-function codexGoalToolContract(mission, nativeGoalRecovery = null) {
+function codexGoalToolContract(mission, nativeGoalRecovery = null, options = {}) {
+  if (options.completedTaskClosed === true) {
+    return {
+      current_policy: 'completed Codex tasks retain their final goal state',
+      read_current_goal: 'get_goal',
+      complete_current_goal: 'already complete; do not mutate this task',
+      select_next_goal: 'create a new Codex task for a different objective',
+      set_next_goal: 'do not call create_goal in this completed task',
+      visible_goal_bridge: 'goal.visible_goal',
+      platform_requirement: 'New work and recurring monitors need their own Codex task.',
+      phase_change_refresh: 'continue only while this task is active and the objective still matches',
+      runtime_tool_sequence: 'get_goal -> if complete, stop this task -> create a new Codex task for the next objective',
+      blocked_without_platform_goal_write: true,
+      requires_new_task: true,
+      mission_id: mission.id,
+    };
+  }
   if (nativeGoalRecovery) {
     return {
       current_policy: 'keep one visible Codex /goal active for the selected Atris mission',
@@ -7045,11 +7077,11 @@ function codexGoalToolContract(mission, nativeGoalRecovery = null) {
     read_current_goal: 'get_goal',
     complete_current_goal: codexGoalCompletionInstruction(mission),
     select_next_goal: 'atris mission goal --json',
-    set_next_goal: 'use goal.visible_goal: create_goal({ objective: goal.objective }) when no active goal blocks the slot',
+    set_next_goal: 'use goal.visible_goal only when get_goal reports no goal for this task',
     visible_goal_bridge: 'goal.visible_goal',
-    platform_requirement: 'Codex runtime must expose replace_goal/set_goal, or allow update_goal({ status: "complete" }) followed by create_goal({ objective }).',
-    phase_change_refresh: 'before changed follow-up work, run atris mission goal --json and mirror the returned visible goal',
-    runtime_tool_sequence: 'get_goal -> create_goal({ objective }) -> atris mission goal ack <mission-id> --runtime codex --status active --objective "<objective>" --json -> do work -> update_goal({ status: "complete" }) after proof or phase change -> atris mission goal --json',
+    platform_requirement: 'Codex runtime must create a new task when a completed task needs a different objective.',
+    phase_change_refresh: 'continue in this task only while its active objective still matches',
+    runtime_tool_sequence: 'get_goal -> if no goal, create_goal({ objective }) -> acknowledge -> do matching work -> update_goal({ status: "complete" }) after proof -> stop this task',
     blocked_without_platform_goal_write: true,
     mission_id: mission.id,
   };
@@ -7092,8 +7124,11 @@ function writeCodexGoalState(payload, root = process.cwd()) {
     if (state.goal.visible_goal) {
       lines.push(`- visible goal: ${state.goal.visible_goal.status}`);
       lines.push(`- visible goal desired: ${state.goal.visible_goal.desired_objective}`);
-      if (state.goal.visible_goal.operations.create_when_empty_or_completed) {
-        lines.push(`- visible goal create: ${state.goal.visible_goal.operations.create_when_empty_or_completed}`);
+      if (state.goal.visible_goal.operations.create_when_no_goal) {
+        lines.push(`- visible goal create: ${state.goal.visible_goal.operations.create_when_no_goal}`);
+      }
+      if (state.goal.visible_goal.operations.completed_task_action) {
+        lines.push(`- completed task: ${state.goal.visible_goal.operations.completed_task_action}`);
       }
       if (state.goal.visible_goal.operations.ack_existing_matching_goal) {
         lines.push(`- visible goal ack recovery: ${state.goal.visible_goal.operations.ack_existing_matching_goal}`);
@@ -7101,10 +7136,12 @@ function writeCodexGoalState(payload, root = process.cwd()) {
       if (state.goal.visible_goal.operations.handoff_when_usage_limited) {
         lines.push(`- usage-limited handoff: ${state.goal.visible_goal.operations.handoff_when_usage_limited}`);
       }
-      const completionLabel = missionBudgetContinuationText(state.mission)
-        ? 'visible goal hold'
-        : 'visible goal complete';
-      lines.push(`- ${completionLabel}: ${state.goal.visible_goal.operations.complete_after_proof}`);
+      if (state.goal.visible_goal.operations.complete_after_proof) {
+        const completionLabel = missionBudgetContinuationText(state.mission)
+          ? 'visible goal hold'
+          : 'visible goal complete';
+        lines.push(`- ${completionLabel}: ${state.goal.visible_goal.operations.complete_after_proof}`);
+      }
     }
     if (state.goal.native_goal_recovery) {
       lines.push(`- native goal recovery: ${state.goal.native_goal_recovery.next_command}`);
@@ -7174,15 +7211,18 @@ function buildCodexGoalPayload(root = process.cwd(), options = {}) {
 
   let { mission } = selected;
   const { reason, direct_goal_request: directGoalRequest, seeded_continuation_goal: seededContinuationGoal } = selected;
-  const autoNativeGoalAck = maybeAutoAckCodexNativeGoal(mission, root, options);
+  const completedTaskClosed = codexRuntimeTaskIsClosed(runtimeGoalState);
+  const autoNativeGoalAck = completedTaskClosed ? null : maybeAutoAckCodexNativeGoal(mission, root, options);
   if (autoNativeGoalAck) mission = autoNativeGoalAck.saved;
   const taskSpine = missionTaskSpine(mission);
   const missionView = missionStatusView(mission);
   const objective = codexGoalObjective(mission);
   const ack = codexNativeGoalAck(mission);
-  const nativeGoalRecovery = !ack ? codexNativeGoalRecovery(mission, runtimeGoalState, root) : null;
-  const runtimeNeedsReplace = !ack && !nativeGoalRecovery && codexRuntimeGoalNeedsReplace(runtimeGoalState, objective);
-  const nativeGoalAction = ack
+  const nativeGoalRecovery = !completedTaskClosed && !ack ? codexNativeGoalRecovery(mission, runtimeGoalState, root) : null;
+  const runtimeNeedsReplace = !completedTaskClosed && !ack && !nativeGoalRecovery && codexRuntimeGoalNeedsReplace(runtimeGoalState, objective);
+  const nativeGoalAction = completedTaskClosed
+    ? null
+    : ack
     ? null
     : nativeGoalRecovery
       ? null
@@ -7201,7 +7241,9 @@ function buildCodexGoalPayload(root = process.cwd(), options = {}) {
     executed_by: taskSpine?.executed_by || mission.executed_by || null,
     task_spine: taskSpine,
     reason,
-    next_command: nativeGoalRecovery
+    next_command: completedTaskClosed
+      ? 'Create a new Codex task for this mission. This completed task must retain its final state.'
+      : nativeGoalRecovery
       ? nativeGoalRecovery.next_command
       : runtimeNeedsReplace
       ? codexNativeGoalReplaceInstruction(mission, runtimeGoalState, objective, {
@@ -7209,11 +7251,12 @@ function buildCodexGoalPayload(root = process.cwd(), options = {}) {
       })
       : codexGoalNextCommand(mission),
     replace_after: codexGoalReplaceAfterInstruction(mission),
-    visible_goal: codexVisibleGoalBridge(mission, objective, { nativeGoalRecovery }),
-    codex_tool_contract: codexGoalToolContract(mission, nativeGoalRecovery),
-    requires_native_goal_start: !ack && !nativeGoalRecovery,
+    visible_goal: codexVisibleGoalBridge(mission, objective, { nativeGoalRecovery, completedTaskClosed }),
+    codex_tool_contract: codexGoalToolContract(mission, nativeGoalRecovery, { completedTaskClosed }),
+    requires_native_goal_start: !completedTaskClosed && !ack && !nativeGoalRecovery,
     requires_native_goal_recovery: Boolean(nativeGoalRecovery),
     requires_native_goal_replace: runtimeNeedsReplace,
+    requires_new_task: completedTaskClosed,
     native_goal_action: nativeGoalAction,
     native_goal_recovery: nativeGoalRecovery,
     native_goal_ack_command: codexGoalAckCommand(mission, objective),
@@ -7230,13 +7273,14 @@ function buildCodexGoalPayload(root = process.cwd(), options = {}) {
   const heartbeat = heartbeatMode ? codexGoalHeartbeat(goal, mission) : undefined;
   return {
     ok: true,
-    action: heartbeatMode ? 'codex_goal_heartbeat' : 'codex_goal_candidate',
+    action: completedTaskClosed ? 'completed_task_closed' : (heartbeatMode ? 'codex_goal_heartbeat' : 'codex_goal_candidate'),
     goal,
     mission: missionView,
     heartbeat,
     requires_native_goal_start: goal.requires_native_goal_start,
     requires_native_goal_recovery: goal.requires_native_goal_recovery,
     requires_native_goal_replace: goal.requires_native_goal_replace,
+    requires_new_task: goal.requires_new_task,
     native_goal_action: goal.native_goal_action,
     native_goal_recovery: goal.native_goal_recovery,
     auto_native_goal_ack: goal.auto_native_goal_ack,
@@ -7453,6 +7497,7 @@ function goalLoopNextCommandPlan(goal) {
 
 function shouldRunGoalLoopCommand(heartbeat, plan) {
   if (!heartbeat?.goal) return false;
+  if (heartbeat.action === 'completed_task_closed' || heartbeat.goal.requires_new_task === true) return false;
   if (heartbeat.goal.requires_native_goal_start === true) return false;
   if (plan && plan.run_when_due_only === false) return true;
   return heartbeat.heartbeat?.due === true;
@@ -10409,12 +10454,12 @@ function reapPausedMissions(root = process.cwd(), { hours = MISSION_PAUSED_REAP_
 }
 
 function missionGoalHelp() {
-  console.log('Usage: atris mission goal [--runtime codex|atris] [--heartbeat] [--native-goal-status active|paused|usageLimited] [--native-goal-objective "..."] [--manual-ack] [--allow-native-goal-supersede] [--json]');
+  console.log('Usage: atris mission goal [--runtime codex|atris] [--heartbeat] [--native-goal-status active|paused|usageLimited|complete] [--native-goal-objective "..."] [--manual-ack] [--allow-native-goal-supersede] [--json]');
   console.log('Refresh the visible native goal from active mission state. Help is read-only.');
 }
 
 function missionGoalLoopHelp() {
-  console.log('Usage: atris mission goal-loop [--max-wall 28800] [--max-iterations 32] [--no-claude] [--dry-run] [--once] [--json]');
+  console.log('Usage: atris mission goal-loop [--max-wall 28800] [--max-iterations 32] [--no-claude] [--native-goal-status active|paused|usageLimited|complete] [--native-goal-objective "..."] [--dry-run] [--once] [--json]');
   console.log('Run the bounded native-goal controller. Help is read-only and never starts due work.');
 }
 
@@ -10470,6 +10515,18 @@ function goalMission(args) {
     );
     return;
   }
+  if (payload.action === 'completed_task_closed') {
+    printJsonOrText(
+      payload,
+      [
+        'Completed Codex task stays closed.',
+        `Next: ${payload.goal.next_command}`,
+      ],
+      asJson,
+    );
+    process.exitCode = 2;
+    return;
+  }
 
   printJsonOrText(
     payload,
@@ -10566,12 +10623,13 @@ async function goalLoopMission(args) {
   const once = hasFlag(args, '--once');
   const maxIterations = once ? 1 : Math.max(1, Number(readFlag(args, '--max-iterations', '')) || 32);
   const maxWallSeconds = Math.max(1, Number(readFlag(args, '--max-wall', '')) || 8 * 60 * 60);
+  const nativeGoalOptions = codexNativeGoalOptionsFromArgs(args);
   const root = process.cwd();
   const startedAt = Date.now();
   const events = [];
 
   for (let index = 0; index < maxIterations; index += 1) {
-    const heartbeat = refreshCodexGoalController(root, { heartbeat: true });
+    const heartbeat = refreshCodexGoalController(root, { heartbeat: true, ...nativeGoalOptions });
     const event = {
       iteration: index + 1,
       heartbeat,
@@ -10597,11 +10655,12 @@ async function goalLoopMission(args) {
         event.run = runMissionGoalNextCommand(root, heartbeat, { noClaude });
         event.ran_heavy_work = event.run.ok === true && event.run.heavy_work === true;
         event.ran_setup_work = event.run.ok === true && event.run.setup_work === true;
-        event.after_run = refreshCodexGoalController(root, { heartbeat: true });
+        event.after_run = refreshCodexGoalController(root, { heartbeat: true, ...nativeGoalOptions });
       }
     }
     events.push(event);
 
+    if (heartbeat.action === 'completed_task_closed') break;
     if (index + 1 >= maxIterations) break;
     const elapsedSeconds = (Date.now() - startedAt) / 1000;
     const remainingSeconds = maxWallSeconds - elapsedSeconds;
@@ -10615,9 +10674,10 @@ async function goalLoopMission(args) {
     await sleep(sleepSeconds * 1000);
   }
 
-  const finalState = refreshCodexGoalController(root, { heartbeat: true });
+  const finalState = refreshCodexGoalController(root, { heartbeat: true, ...nativeGoalOptions });
+  const completedTaskClosed = finalState.action === 'completed_task_closed';
   const payload = {
-    ok: true,
+    ok: !completedTaskClosed,
     action: 'codex_goal_loop',
     iterations: events.length,
     max_iterations: maxIterations,
@@ -10626,6 +10686,8 @@ async function goalLoopMission(args) {
     setup_runs: events.filter((event) => event.ran_setup_work).length,
     events,
     final_state: finalState,
+    status: completedTaskClosed ? 'completed_task_closed' : 'running',
+    next_action: completedTaskClosed ? finalState.goal?.next_command || null : null,
   };
   printJsonOrText(
     payload,
@@ -10637,6 +10699,7 @@ async function goalLoopMission(args) {
     ],
     asJson,
   );
+  if (completedTaskClosed) process.exitCode = 2;
 }
 
 function help() {
@@ -10662,9 +10725,9 @@ atris mission - durable goal + loop + owner + proof state
                        (rolls up sibling git-worktree missions; --local scopes to this checkout)
   atris mission room "<messy input>" [--owner <member>] [--room-auto-run] [--json]   Create a Mission Room card and shareable receipt from messy intent
   atris mission prune-runs [--apply] [--days <n>] [--keep-newest <n>] [--json]   Compress old run receipts into a manifest and prune unreferenced clutter
-  atris mission goal [--runtime codex|atris] [--heartbeat] [--native-goal-status active|paused|usageLimited] [--native-goal-objective "..."] [--manual-ack] [--allow-native-goal-supersede] [--json]
+  atris mission goal [--runtime codex|atris] [--heartbeat] [--native-goal-status active|paused|usageLimited|complete] [--native-goal-objective "..."] [--manual-ack] [--allow-native-goal-supersede] [--json]
   atris mission goal ack <id> --runtime codex --status active --objective "<objective>" --json
-  atris mission goal-loop [--max-wall 28800] [--max-iterations 32] [--no-claude] [--json]
+  atris mission goal-loop [--max-wall 28800] [--max-iterations 32] [--no-claude] [--native-goal-status active|paused|usageLimited|complete] [--native-goal-objective "..."] [--dry-run] [--once] [--json]
   atris mission tick <id> [--verify ["cmd"]] [--complete-on-pass] [--self-drive] [--summary "..."]
                        [--native-goal-status active|paused|usageLimited] [--native-goal-objective "..."] [--json]
   atris mission set-runner <id> <runner|engine> [--model <id>] [--json]

package/commands/pack.js

@@ -6,6 +6,7 @@ const path = require('path');
 const { isUtf8 } = require('buffer');
 const { createHash } = require('crypto');
 const { spawnSync } = require('child_process');
+const { version: CLI_VERSION } = require('../package.json');
 const { apiRequestJson, getApiBaseUrl, getAppBaseUrl, httpRequest } = require('../utils/api');
 const { loadCredentials, performTokenRefresh } = require('../utils/auth');
 const { createZipBuffer, readZipBuffer, ZIP_LIMITS } = require('../lib/zip');
@@ -156,6 +157,7 @@ const ENV_ASSIGNMENT = /=(?!=*$)/;
 
 function showHelp() {
   console.log('usage: atris pack craft "<topic>" [--dir <target>] [--force]');
+  console.log('       atris pack seal <dir> [--type <t>] [--entrypoint <file>]');
   console.log('       atris pack publish [--dir atris] [--slug <slug>] [--author "<name>"] [--notes "..."] [--visibility public|unlisted|private] [--minor|--major] [--out <file.zip>] [--push] [--dry-run] [--allow-secrets]');
   console.log('       atris pack install <file.zip|url|slug> [--dir <target>] [--force]');
   console.log('       atris pack run <slug|dir> [--dir <target>] [--input <file>] [--cloud] [--force] [--trust] [--grant <capability>]');
@@ -1377,14 +1379,8 @@ async function showPackSales(rawArgs, cwd = process.cwd(), options = {}) {
 // ── pack purchases ──────────────────────────────────────────────────────────
 const PACK_PURCHASES_LOGIN_NUDGE = 'not logged in. run atris login first to view pack purchases.';
 
-function packPurchaseItems(payload) {
-  if (Array.isArray(payload)) return payload;
-  if (payload && Array.isArray(payload.purchases)) return payload.purchases;
-  if (payload && Array.isArray(payload.data)) return payload.data;
-  if (payload && payload.data && Array.isArray(payload.data.purchases)) {
-    return payload.data.purchases;
-  }
-  return null;
+function packPurchasesUrl(apiBaseUrl = getApiBaseUrl()) {
+  return `${String(apiBaseUrl || '').replace(/\/+$/, '')}/pack/purchases/mine`;
 }
 
 async function showPackPurchases(rawArgs, cwd = process.cwd(), options = {}) {
@@ -1393,28 +1389,32 @@ async function showPackPurchases(rawArgs, cwd = process.cwd(), options = {}) {
 
   const deps = options.deps || {};
   const print = options.print || console.log;
+  const request = deps.httpRequest || httpRequest;
+  const authHeaders = requiredAuthHeaders(deps, 'view pack purchases');
 
-  let payload;
+  let response;
   try {
-    payload = await requestRegistryJson(
-      '/api/pack/purchases',
-      {
-        authPurpose: 'view pack purchases',
-        unreachableMessage: 'could not load pack purchases. check your connection and try again.',
-        invalidMessage: 'pack purchases returned an invalid response.',
+    const apiBaseUrl = (deps.getApiBaseUrl || getApiBaseUrl)();
+    response = await request(packPurchasesUrl(apiBaseUrl), {
+      method: 'GET',
+      timeoutMs: REGISTRY_TIMEOUT_MS,
+      headers: {
+        Accept: 'application/json',
+        ...authHeaders,
       },
-      deps,
-    );
-  } catch (error) {
-    if (error && error.status === 401) throw new Error(PACK_PURCHASES_LOGIN_NUDGE);
-    if (error && Number.isFinite(error.status)) {
-      throw new Error(`could not load pack purchases (status ${error.status}).`);
-    }
-    throw error;
+    });
+  } catch {
+    throw new Error('could not load pack purchases. check your connection and try again.');
+  }
+
+  if (response.status === 401) throw new Error(PACK_PURCHASES_LOGIN_NUDGE);
+  if (response.status < 200 || response.status >= 300) {
+    throw new Error(`could not load pack purchases (status ${response.status}).`);
   }
 
-  const purchases = packPurchaseItems(payload);
-  if (!purchases) throw new Error('pack purchases returned an invalid response.');
+  const parsed = parseJsonBody(response.body);
+  if (!Array.isArray(parsed.data)) throw new Error('pack purchases returned an invalid response.');
+  const purchases = parsed.data;
   if (!purchases.length) {
     print('no purchased packs yet. browse with: atris pack browse');
     return 0;
@@ -3003,6 +3003,70 @@ function inspectInstalledContentHashes(packDir, manifest) {
   };
 }
 
+function sealPack(rawArgs, cwd = process.cwd()) {
+  const args = [...rawArgs];
+  const requestedType = takeValue(args, '--type');
+  const requestedEntrypoint = takeValue(args, '--entrypoint');
+  const source = args.shift();
+  if (!source) {
+    showHelp();
+    return 2;
+  }
+  if (args.length) throw new Error(`unknown pack seal argument: ${args.join(' ')}`);
+
+  const packDir = path.resolve(cwd, source);
+  const manifest = assertPacketDir(packDir, cwd);
+  const contentFiles = collectInstalledContentFiles(packDir);
+  const setFields = [];
+
+  if (!Object.prototype.hasOwnProperty.call(manifest, 'type')) {
+    manifest.type = requestedType !== null
+      ? requestedType
+      : (contentFiles.size === 1 && contentFiles.has('README.md') ? 'playbook' : 'context');
+    setFields.push(['type', manifest.type]);
+  }
+  if (!Object.prototype.hasOwnProperty.call(manifest, 'entrypoint')) {
+    const entrypoint = requestedEntrypoint !== null
+      ? requestedEntrypoint
+      : (contentFiles.has('README.md') ? 'README.md' : null);
+    if (entrypoint !== null) {
+      manifest.entrypoint = entrypoint;
+      setFields.push(['entrypoint', manifest.entrypoint]);
+    }
+  }
+  if (!Object.prototype.hasOwnProperty.call(manifest, 'permissions')) {
+    manifest.permissions = [];
+    setFields.push(['permissions', '[]']);
+  }
+  if (!Object.prototype.hasOwnProperty.call(manifest, 'created-in')) {
+    manifest['created-in'] = CLI_VERSION;
+    setFields.push(['created-in', manifest['created-in']]);
+  }
+
+  manifest['content-hashes'] = Object.fromEntries(
+    [...contentFiles.entries()]
+      .map(([relativePath, absolutePath]) => {
+        const contentPath = canonicalContentPath(relativePath);
+        if (contentPath !== relativePath) {
+          throw new Error(`pack content-hashes requires canonical file path: ${relativePath}`);
+        }
+        return [contentPath, sha256(fs.readFileSync(absolutePath))];
+      })
+      .sort(([left], [right]) => left.localeCompare(right)),
+  );
+  setFields.push([
+    'content-hashes',
+    `${contentFiles.size} file${contentFiles.size === 1 ? '' : 's'}`,
+  ]);
+
+  writeJson(path.join(packDir, 'pack.json'), manifest);
+  for (const [field, value] of setFields) console.log(`set ${field}: ${value}`);
+
+  const result = evaluatePackDoctor(packDir, cwd);
+  printPackDoctor(result);
+  return result.ok ? 0 : 1;
+}
+
 function printContentHashStatus(result) {
   if (result.status === 'absent') {
     console.log('  content hashes: absent (legacy pack, bytes unverified)');
@@ -3942,6 +4006,7 @@ async function run(argv = []) {
       }
       return result;
     }
+    if (subcommand === 'seal') return sealPack(args);
     if (subcommand === 'publish') return await publishPack(args);
     if (subcommand === 'install') return await installPack(args);
     if (subcommand === 'run') return await runPack(args);

package/commands/sync.js

@@ -3,6 +3,12 @@ const path = require('path');
 const os = require('os');
 const { ensureWikiScaffold } = require('../lib/wiki');
 const { upsertAtrisClaudeBootBlock } = require('../lib/claude-boot-block');
+const {
+  upsertAgentVoiceCard,
+  upsertClaudeVoiceHook,
+  upsertCursorVoiceCard,
+  voiceCardForRoot,
+} = require('../lib/voice-card');
 
 const TEMPLATE_ROOT_DIR = path.join(__dirname, '..', 'templates');
 const WORKSPACE_TEMPLATES = {
@@ -251,6 +257,8 @@ function renderBusinessAgentAdapter(bizMeta = {}, targetRoot = '.') {
     '',
     '- Check `atris/MAP.md` before broad code or file search.',
     '- Use `atris task` for ownership, notes, proof, and review state.',
+    '- Give every task a plain first layer: what changes, why it matters, and what done looks like. Keep all technical detail underneath unchanged.',
+    '- Use the existing Plan/Do and accept/revise gates for approve or change actions; never bypass proof.',
     '- Use `atris mission` when work should survive the current chat.',
     '- Put completed agent work in Review with `atris task ready <id> --proof "<receipt>" --result "<day-one PM sentence>".`',
     '- Do not run `atris task accept` or claim XP unless a human approved the proof.',
@@ -553,6 +561,21 @@ function syncAtris(options = {}) {
   // Sync all skills from package to user's project via shared helper.
   updated += syncPackageSkills(targetDir, { verbose: true, dryRun });
 
+  const voiceCard = voiceCardForRoot(process.cwd());
+  const cursorVoiceFile = path.join(process.cwd(), '.cursor', 'rules', 'atris-voice.mdc');
+  const cursorVoiceResult = upsertCursorVoiceCard(cursorVoiceFile, voiceCard, { dryRun });
+  if (cursorVoiceResult.action !== 'unchanged') {
+    console.log(`${dryRun ? 'Would update' : '✓ Updated'} .cursor/rules/atris-voice.mdc`);
+    updated++;
+  }
+
+  const agentsMdFile = path.join(process.cwd(), 'AGENTS.md');
+  const agentsVoiceResult = upsertAgentVoiceCard(agentsMdFile, voiceCard, { dryRun });
+  if (agentsVoiceResult.action !== 'unchanged') {
+    console.log(`${dryRun ? 'Would update' : '✓ Updated'} AGENTS.md voice card`);
+    updated++;
+  }
+
   // Update .claude/skills/atris/SKILL.md (legacy - now handled above, keeping for compatibility)
   const claudeSkillsDir = path.join(process.cwd(), '.claude', 'skills', 'atris');
   const claudeSkillFile = path.join(claudeSkillsDir, 'SKILL.md');
@@ -584,6 +607,9 @@ Key behaviors:
 - Read PERSONA.md (3-4 sentences, ASCII visuals)
 - Check MAP.md for file:line refs
 - Use \`atris task\` for claims, proof, ready, and accept
+- Give every task a plain first layer: what changes, why it matters, and what
+  done looks like. Keep exact technical detail underneath and use the existing
+  approve/change gates; never bypass proof.
 - Treat TODO.md as a rendered view; regenerate it instead of hand-editing tasks`;
 
   if (!dryRun && !fs.existsSync(claudeSkillsDir)) {
@@ -596,10 +622,11 @@ Key behaviors:
     updated++;
   }
 
-  // Update .claude/settings.json with SessionStart hook
+  // Update .claude/settings.json with startup and per-prompt hooks.
   const claudeSettingsFile = path.join(process.cwd(), '.claude', 'settings.json');
-  if (!fs.existsSync(claudeSettingsFile)) {
-    const claudeSettings = {
+  const claudeSettingsResult = upsertClaudeVoiceHook(claudeSettingsFile, {
+    dryRun,
+    initialSettings: {
       hooks: {
         SessionStart: [
           {
@@ -612,9 +639,10 @@ Key behaviors:
           }
         ]
       }
-    };
-    if (!dryRun) fs.writeFileSync(claudeSettingsFile, JSON.stringify(claudeSettings, null, 2));
-    console.log(`${dryRun ? 'Would create' : '✓ Created'} .claude/settings.json (SessionStart hook)`);
+    },
+  });
+  if (claudeSettingsResult.action !== 'unchanged' && claudeSettingsResult.action !== 'skipped') {
+    console.log(`${dryRun ? 'Would update' : '✓ Updated'} .claude/settings.json (voice hook)`);
     updated++;
   }