atris 3.30.0 → 3.30.2

package/lib/task-db.js

@@ -501,7 +501,12 @@ function doneTask(db, { id, status, actor, allowReview = false, action, proof }
   return { updated: false };
 }
 
-function readyTask(db, { id, actor, proof, lesson, nextTask }) {
+function cleanLandingText(value) {
+  const text = String(value || '').replace(/\s+/g, ' ').trim();
+  return text || null;
+}
+
+function readyTask(db, { id, actor, proof, lesson, nextTask, landing = {}, resultTrace }) {
   if (!id) throw new Error('id required');
   const text = String(proof || '').trim();
   if (!text) throw new Error('proof required');
@@ -520,6 +525,11 @@ function readyTask(db, { id, actor, proof, lesson, nextTask }) {
   metadata.latest_agent_proof = text;
   metadata.latest_agent_lesson = String(lesson || '').trim() || null;
   metadata.latest_agent_next_task = String(nextTask || '').trim() || null;
+  const landingInput = landing && typeof landing === 'object' ? landing : {};
+  for (const key of ['happened', 'checked', 'tested', 'decision']) {
+    const cleaned = cleanLandingText(landingInput[key]);
+    if (cleaned) metadata[`landing_${key}`] = cleaned;
+  }
   if (reviewPassCount >= AGENT_CERTIFICATION_REVIEW_PASSES) {
     metadata.agent_certified = true;
     metadata.agent_certified_at = new Date(now).toISOString();
@@ -537,20 +547,31 @@ function readyTask(db, { id, actor, proof, lesson, nextTask }) {
   `).run(now, JSON.stringify(metadata), id));
   if (result.changes !== 1) return { ready: false, reason: 'not_open_claimed_or_review' };
   const updated = getTask(db, id);
+  const payload = {
+    proof: text,
+    lesson: metadata.latest_agent_lesson,
+    next_task: metadata.latest_agent_next_task,
+    approval_status: 'pending',
+    review_pass_count: reviewPassCount,
+    agent_certified: metadata.agent_certified === true,
+    agent_certification_policy: metadata.agent_certification_policy || null,
+  };
+  if (resultTrace && typeof resultTrace === 'object') {
+    payload.result_trace = resultTrace;
+    payload.result_packet = `TASK_RESULT_TRACE ${JSON.stringify(resultTrace)}`;
+  }
+  payload.landing = {
+    happened: metadata.landing_happened || null,
+    checked: metadata.landing_checked || null,
+    tested: metadata.landing_tested || null,
+    decision: metadata.landing_decision || null,
+  };
   const event = appendTaskEvent(db, {
     taskId: id,
     workspaceRoot: updated.workspace_root,
     actor: actor || null,
     eventType: 'proof_ready',
-    payload: {
-      proof: text,
-      lesson: metadata.latest_agent_lesson,
-      next_task: metadata.latest_agent_next_task,
-      approval_status: 'pending',
-      review_pass_count: reviewPassCount,
-      agent_certified: metadata.agent_certified === true,
-      agent_certification_policy: metadata.agent_certification_policy || null,
-    },
+    payload,
   });
   return { ready: true, event, row: updated };
 }
@@ -609,7 +630,9 @@ function reviseTask(db, { id, actor, note }) {
       revision_count: revisionCount,
     },
   });
-  return { revised: true, event, row: updated };
+  const episode = taskEpisodeFromRevision(updated, event, event.payload);
+  appendTaskEpisode(updated.workspace_root, episode);
+  return { revised: true, event, row: updated, episode };
 }
 
 function cleanStageText(value) {
@@ -770,6 +793,9 @@ function stagePacketFromPayload(payload) {
   if (data.proof_needed) lines.push(`proof_needed: ${data.proof_needed}`);
   if (data.first_move) lines.push(`first_move: ${data.first_move}`);
   if (data.next_button) lines.push(`next_button: ${data.next_button}`);
+  if (data.plan_trace && typeof data.plan_trace === 'object') {
+    lines.push(`TASK_PLAN_TRACE ${JSON.stringify(data.plan_trace)}`);
+  }
   return lines.filter(Boolean).join('\n');
 }
 
@@ -797,6 +823,7 @@ function stageTask(db, {
   firstMove,
   nextButton,
   confidence,
+  planTrace,
 }) {
   if (!id) throw new Error('id required');
   const targetStage = cleanStageText(stage).toLowerCase();
@@ -1015,6 +1042,7 @@ function stageTask(db, {
     first_move: cleanStageText(firstMove) || null,
     next_button: metadata.next_button || null,
     confidence: Number.isFinite(confidenceValue) ? metadata.stage_confidence : null,
+    plan_trace: targetStage === 'plan' && planTrace && typeof planTrace === 'object' ? planTrace : null,
   };
   payload.stage_packet = stagePacketFromPayload(payload);
   const updated = getTask(db, id);
@@ -1283,12 +1311,44 @@ function reviewOutcomeLabel(reward) {
   return 'revised';
 }
 
+function reviewLandingSignal(metadata) {
+  const landing = {
+    happened: compactEpisodeText(metadata.landing_happened, 220),
+    checked: compactEpisodeText(metadata.landing_checked, 220),
+    tested: compactEpisodeText(metadata.landing_tested, 260),
+    decision: compactEpisodeText(metadata.landing_decision, 220),
+  };
+  const present = Object.entries(landing)
+    .filter(([, value]) => Boolean(value))
+    .map(([key]) => key);
+  const missing = Object.keys(landing).filter(key => !landing[key]);
+  return {
+    landing: present.length ? landing : null,
+    quality: {
+      present,
+      missing,
+      completeness: present.length / Object.keys(landing).length,
+      has_decision: Boolean(landing.decision),
+    },
+  };
+}
+
+function humanFeedbackFromMetadata(metadata, label, payload = {}) {
+  return {
+    approval_status: metadata.approval_status || (label === 'accepted' ? 'accepted' : label),
+    human_revision_count: Number(metadata.human_revision_count || 0),
+    human_revision_note: metadata.human_revision_note || payload.note || null,
+  };
+}
+
 function taskEpisodeFromReview(row, event, payload) {
   const metadata = row.metadata || {};
   const rewardValue = Number(payload.reward);
   const hasProof = Boolean(String(payload.proof || '').trim());
   const label = reviewOutcomeLabel(payload.reward);
   const doneForXp = row.status === 'done';
+  const landingSignal = reviewLandingSignal(metadata);
+  const humanFeedback = humanFeedbackFromMetadata(metadata, label, payload);
   return {
     schema: 'atris.task_episode.v1',
     episode_id: event.event_id,
@@ -1315,6 +1375,9 @@ function taskEpisodeFromReview(row, event, payload) {
     proof: payload.proof,
     next_task_suggestion: payload.next_task,
     goal: goalSignalFromTaskMetadata(metadata),
+    review_landing: landingSignal.landing,
+    landing_quality: landingSignal.quality,
+    human_feedback: humanFeedback,
     career_xp: {
       eligible: payload.career_xp_eligible === true && label === 'accepted' && hasProof && doneForXp,
       source: 'task_review',
@@ -1328,6 +1391,60 @@ function taskEpisodeFromReview(row, event, payload) {
       has_proof: hasProof,
       has_lesson: Boolean(String(payload.lesson || '').trim()),
       has_next_task: Boolean(String(payload.next_task || '').trim()),
+      landing_completeness: landingSignal.quality.completeness,
+      approval_status: humanFeedback.approval_status,
+    },
+  };
+}
+
+function taskEpisodeFromRevision(row, event, payload) {
+  const metadata = row.metadata || {};
+  const landingSignal = reviewLandingSignal(metadata);
+  const humanFeedback = humanFeedbackFromMetadata(metadata, 'revise', payload);
+  return {
+    schema: 'atris.task_episode.v1',
+    episode_id: event.event_id,
+    task_id: row.id,
+    workspace_root: row.workspace_root,
+    created_at: new Date(event.created_at).toISOString(),
+    state: {
+      title: row.title,
+      status: row.status,
+      tag: row.tag,
+      claimed_by: row.claimed_by,
+      metadata,
+    },
+    action: {
+      event_type: 'revision_requested',
+      actor: event.actor || null,
+      version: event.version,
+    },
+    reward: {
+      value: 0,
+      source: 'task_revision',
+    },
+    lesson: '',
+    proof: null,
+    next_task_suggestion: null,
+    goal: goalSignalFromTaskMetadata(metadata),
+    review_landing: landingSignal.landing,
+    landing_quality: landingSignal.quality,
+    human_feedback: humanFeedback,
+    career_xp: {
+      eligible: false,
+      source: 'task_revision',
+      reward: 0,
+      proof_required: true,
+    },
+    rl: {
+      label: 'rework_requested',
+      source: 'task_revision',
+      reward: 0,
+      has_proof: false,
+      has_lesson: false,
+      has_next_task: false,
+      landing_completeness: landingSignal.quality.completeness,
+      approval_status: humanFeedback.approval_status,
     },
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "3.30.0",
+  "version": "3.30.2",
   "main": "bin/atris.js",
   "bin": {
     "atris": "bin/atris.js",
@@ -11,6 +11,7 @@
     "bin/",
     "cli/*.py",
     "commands/",
+    "decks/",
     "utils/",
     "lib/",
     "templates/",

package/templates/business-starter/team/START_HERE.md

@@ -4,14 +4,15 @@ Use this when a collaborator opens the shared business workspace for the first t
 
 ## Default Path
 
-1. Run `atris business start` from the workspace root.
-2. Run `atris radar` to see agents, tasks, missions, XP, team lanes, and proof state.
-3. Claim the seeded first task with `atris task next`.
-4. Wake `operator` with `atris member activate operator`.
-5. Resume an active mission, or start the first bounded loop if none exists.
-6. Execute the loop with `atris do`.
-7. Use `ops`, `research`, or `comms` only when the next loop needs that lens.
-8. Ask `validator` to check proof before reward, launch, external send, or spend.
+1. Run `atris sync --dry-run` if this workspace has cloud IDs.
+2. Run `atris business start` from the workspace root.
+3. Run `atris radar` to see agents, tasks, missions, XP, team lanes, and proof state.
+4. Claim the seeded first task with `atris task next`.
+5. Wake `operator` with `atris member activate operator`.
+6. Resume an active mission, or start the first bounded loop if none exists.
+7. Execute the loop with `atris do`.
+8. Use `ops`, `research`, or `comms` only when the next loop needs that lens.
+9. Ask `validator` to check proof before reward, launch, external send, or spend.
 
 ## Mission Loop
 
@@ -40,6 +41,9 @@ Record the first real run with:
 ```bash
 atris business record atris/reports/<recap>.md --outcome mixed --metric "operator speed"
 atris business share --write
+atris sync
 ```
 
+Use `atris sync --watch` while actively collaborating in a cloud-backed workspace.
+
 No XP or external action until a human approves the proof.

package/utils/auth.js

@@ -46,6 +46,10 @@ function promptUser(question) {
       let data = '';
       process.stdin.setEncoding('utf8');
       process.stdin.on('data', chunk => data += chunk);
+      process.stdin.on('error', () => {
+        inputLines = [];
+        resolve('');
+      });
       process.stdin.on('end', () => {
         inputLines = data.trim().split('\n');
         process.stdout.write(question);

package/utils/config.js

@@ -77,6 +77,10 @@ function loadLogSyncState() {
  */
 function saveLogSyncState(state) {
   const statePath = getLogSyncStatePath();
+  const targetDir = path.dirname(statePath);
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
   fs.writeFileSync(statePath, JSON.stringify(state, null, 2));
 }