atris 3.74.17 → 3.74.19

package/commands/autoland.js

@@ -4,6 +4,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const { spawnSync } = require('child_process');
+const { localDay } = require('../lib/local-day');
 
 const autoland = require('../lib/autoland');
 const { gateForHuman, plainLandingReason } = require('../lib/voice-gate');
@@ -1006,6 +1007,19 @@ function mergedCloseNote(receipt) {
     + (receipt.merged_close_error ? ', could not check which jobs already merged' : '');
 }
 
+// The digest goes out once per local day. A stamp written before the switch
+// to local days is the UTC day of a send at this same local hour, today or
+// yesterday. Across a clock change both can be the same UTC day; that stamp
+// cannot say which, so the digest goes out rather than go quiet.
+function digestSentToday(state, now = new Date()) {
+  if (!state || !state.last_digest_date) return false;
+  if (state.last_digest_local) return state.last_digest_date === localDay(now);
+  const utcDay = (d) => d.toISOString().slice(0, 10);
+  const yesterday = new Date(now);
+  yesterday.setDate(yesterday.getDate() - 1);
+  return state.last_digest_date === utcDay(now) && state.last_digest_date !== utcDay(yesterday);
+}
+
 async function runTickBody(root, { json, policy, receipt, engineValidationDeps = {} }) {
 
   try {
@@ -1298,9 +1312,9 @@ async function runTickBody(root, { json, policy, receipt, engineValidationDeps =
   }
 
   // 4. daily digest at the configured hour
-  const today = new Date().toISOString().slice(0, 10);
+  const today = localDay();
   const digestHour = Number(policy.digest_hour ?? autoland.DEFAULT_DIGEST_HOUR);
-  if (new Date().getHours() === digestHour && state.last_digest_date !== today) {
+  if (new Date().getHours() === digestHour && !digestSentToday(state)) {
     receipt.digest_due = true;
     let waitingWishes = [];
     try {
@@ -1326,6 +1340,7 @@ async function runTickBody(root, { json, policy, receipt, engineValidationDeps =
     }
     receipt.digest_text = text;
     state.last_digest_date = today;
+    state.last_digest_local = true;
     delete state.janitor;
 
     // 5. once a day, keep the receipt shelf lean: compress old run receipts
@@ -1472,6 +1487,7 @@ function autolandCommand(args = []) {
 
 module.exports = {
   autolandCommand,
+  digestSentToday,
   digestNextMoves,
   acceptSweepTimeoutMs,
   describeAcceptKillCause,

package/commands/fleet-report.js

@@ -17,6 +17,7 @@ const { loadCredentials } = require('../utils/auth');
 const { apiRequestJson } = require('../utils/api');
 const { looksLikeBusinessSlug, requireAccountBound, refuseAccountGlobal } = require('../lib/account-bound');
 const { argsWantHelp, wantsJson } = require('../lib/noninteractive');
+const { localDay } = require('../lib/local-day');
 
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
@@ -58,7 +59,7 @@ async function fetchDailyReport(token, businessId) {
 }
 
 async function writeReportToComputer(token, businessId, workspaceId, report) {
-  const date = report.date || new Date().toISOString().slice(0, 10);
+  const date = report.date || localDay();
   const remotePath = `/workspace/atris/reports/daily-${date}.md`;
   const b64 = Buffer.from(report.markdown || '', 'utf8').toString('base64');
   const command =
@@ -231,4 +232,4 @@ async function fleetReport() {
   process.exitCode = delivered > 0 || dryRun || results.every((r) => r.reason === 'asleep') ? 0 : 1;
 }
 
-module.exports = { fleetReport, formatScoreboardPnl };
+module.exports = { fleetReport, formatScoreboardPnl, writeReportToComputer };

package/commands/init.js

@@ -655,9 +655,7 @@ tools: []
 
 > Works with: Claude Code, Cursor, Codex, OpenClaw, Windsurf, and any AI coding agent.
 
-> New here? Read \`atris/FOR_AGENTS.md\` first.
 > If a repo you touch next has no \`atris/\` folder, run \`npx -y atris init\`.
-> Then read \`atris/atris.md\` and leave proof on disk.
 
 ## FIRST MESSAGE: Boot Sequence
 
@@ -675,20 +673,14 @@ ${agentsOpeningBlock}
 
 The person you work for does not know atris words and never has to learn them. Never tell them to run an atris command or learn a term.
 
-When their words match a move below, run it and report what happened in plain words.
-
-When unsure, run \`atris guide "<their words>"\` and follow its answer.
-
-After anything lands, offer one next move in plain words, never a command name.
+When their words ask for a move like "what should i do next", "keep going while i'm away", "remember this", or "our goal is x", run \`atris guide "<their words>"\`, then run the move it names and report what happened in plain words. When unsure, run \`atris guide "<their words>"\` and follow its answer. \`atris guide\` alone lists every move.
 
 Moves marked asks you first send messages, spend credits, or run for hours. Say in one sentence what would happen and wait for a yes before running them. Never add a skip flag like --yes on the person's behalf.
 
-Never end a reply with a command for the person to run. If a move needs a claim or an approval, do it for them and say what you did.
+Never end a reply with a command for the person to run. If a move needs a claim or an approval, do it for them and say what you did. After anything lands, offer one next move in plain words, never a command name.
 
 In a project with nothing on the list yet, speak first: three things you noticed about the codebase, one question, then start on the most useful one.
 
-${intentTable}
-
 ## The way of talking (every reply, no exceptions)
 
 Talk like a person. This governs every message you send the operator: boot, status, summaries, everything.
@@ -701,17 +693,42 @@ Talk like a person. This governs every message you send the operator: boot, stat
 - No em dashes anywhere; use a comma, colon, or period.
 - The test before sending: read it fried at 2am. If decoding takes work, rewrite it.
 
-copy these shapes:
+Canonical source: \`atris/atris.md\` \`## voice\`. This block is a copy for tools that only read \`AGENTS.md\`; if they differ, atris.md wins.
+
+## Read on demand
+
+Start on the job you were given. Open these only when the job needs them, not up front:
+
+| When | Read |
+|------|------|
+| You need to find where something lives | \`atris/MAP.md\` |
+| The work is bigger than a quick fix, or it involves tasks, missions, proof, or review | \`atris/atris.md\` (the protocol) |
+| You will create, claim, or hand off a task, report results, or run a mission | \`atris/AGENT_REFERENCE.md\` (task contract, reporting, missions, worktrees, rules) |
+| You are new to Atris | \`atris/FOR_AGENTS.md\` |
+| You are unsure how the person wants to be spoken to | \`atris/PERSONA.md\` |
+
+Do not write new operating doctrine here; add it to \`atris/atris.md\` and regenerate this adapter.`;
+
+  const agentReference = `# Agent reference
+
+The long form of \`AGENTS.md\`. Agents read this on demand, when the job involves tasks, reports, missions, or worktrees. The protocol itself is \`atris/atris.md\`.
+
+## Plain-English moves
+
+The same list \`atris guide\` prints. When the person's words match a move, run it and report what happened in plain words.
+
+${intentTable}
+
+## Reply shapes
+
 - **Status:** "The reply check is built. I am running the final checks now, so the result is not ready yet."
 - **Landing:** "Replies now get a plain-language check before they reach you. The checks passed, and the change is ready."
 - **Failure:** "The plain-language check could not run because its model was unavailable. Your reply still went through, so no work was blocked."
 
-Canonical source: \`atris/atris.md\` \`## voice\`. This block is a copy for tools that only read \`AGENTS.md\`; if they differ, atris.md wins.
-
 ## Core Files
 
-Atris is the source of truth. This file is only an adapter for tools that read
-\`AGENTS.md\`; do not turn it into a parallel brain. Durable policy, workflow,
+Atris is the source of truth. \`AGENTS.md\` and this file are only adapters for
+tools that read \`AGENTS.md\`; do not turn them into a parallel brain. Durable policy, workflow,
 task truth, proof, review, and backend/cloud sync all flow through Atris.
 
 | File | Purpose |
@@ -836,10 +853,7 @@ member -> mission start --verify -> status --status active -> one bounded step -
 - Don't leave stale tasks
 - Don't hand-edit TODO.md for active task ownership
 - Don't write verbose docs
-
----
-
-**Protocol:** See \`atris/atris.md\` for full spec.`;
+`;
 
   const voiceCard = voiceCardForRoot(process.cwd());
 
@@ -871,6 +885,12 @@ member -> mission start --verify -> status --status active -> one bounded step -
     fs.writeFileSync(agentsMdFile, agentInstructions);
     markReady('adapters', 'AGENTS.md', '✓ Created AGENTS.md (for Codex)');
   }
+  // The long form AGENTS.md points to; agents open it on demand.
+  const agentReferenceFile = path.join(targetDir, 'AGENT_REFERENCE.md');
+  if (!fs.existsSync(agentReferenceFile)) {
+    fs.writeFileSync(agentReferenceFile, agentReference);
+    markReady('workspace', 'AGENT_REFERENCE.md', '✓ Created AGENT_REFERENCE.md');
+  }
   const agentsVoiceResult = upsertAgentVoiceCard(agentsMdFile, voiceCard);
   if (agentsVoiceResult.action !== 'unchanged') {
     markReady('adapters', 'AGENTS.md voice card', '✓ Pinned the Atris voice card in AGENTS.md');

package/commands/lesson.js

@@ -8,6 +8,7 @@ const {
 } = require('./autopilot');
 const { detectLessonContradictions } = require('../lib/lesson-contradiction');
 const taskDb = require('../lib/task-db');
+const { localDay } = require('../lib/local-day');
 const { validateDetector, appendLedgerEntry, readLedger } = require('../lib/lesson-ledger');
 
 /**
@@ -57,7 +58,7 @@ function autoResolveLessons(cwd, options = {}) {
   const dryRun = !!options.dryRun;
   const lessons = parseLessons(cwd);
   const metadata = loadLessonMetadata(cwd);
-  const today = new Date().toISOString().slice(0, 10);
+  const today = localDay();
   const checked = [];
   const resolved = [];
 

package/lib/campaign-cadence.js

@@ -67,10 +67,11 @@ function roundSummary(before, after) {
   }
   const fresh = after.missions.filter((m) => !previous.get(m.id)?.has(m.status));
   const kept = fresh.filter((m) => m.status === 'ended' && m.outcome === 'kept').length;
-  const failed = fresh.filter((m) => m.status === 'ended' && m.outcome !== 'kept').length;
+  const held = fresh.filter((m) => m.status === 'ended' && m.outcome === 'held').length;
+  const failed = fresh.filter((m) => m.status === 'ended' && m.outcome !== 'kept' && m.outcome !== 'held').length;
   const vetoed = fresh.filter((m) => m.status === 'vetoed').length;
   const spent = Math.round((after.budget.spent - before.budget.spent) * 100) / 100;
-  return { kept, failed, vetoed, spent, fresh };
+  return { kept, failed, held, vetoed, spent, fresh };
 }
 
 // Nothing finished and the check reads the same: there is nothing to learn.
@@ -81,7 +82,7 @@ function quietRound(before, after, summary) {
 
 // On a subscription the round is told without dollars, since none were paid.
 function roundTally(view, summary) {
-  return `${summary.kept} kept, ${summary.failed} failed${paysDollars(view) ? `, $${summary.spent} spent` : ''}`;
+  return `${summary.kept} kept, ${summary.failed} failed${summary.held ? `, ${summary.held} waiting on you` : ''}${paysDollars(view) ? `, $${summary.spent} spent` : ''}`;
 }
 
 function reviewPrompt(view, summary, lessons) {
@@ -94,7 +95,7 @@ function reviewPrompt(view, summary, lessons) {
     `Campaign: ${view.title}`,
     `Judge: ${view.judge}`,
     `Judge now: ${view.last_judge ? `${view.last_judge.passed ? 'passed' : 'failed'}${view.last_judge.reading !== null ? ` (reading ${view.last_judge.reading})` : ''}: ${view.answer.text || ''}` : 'never run'}`,
-    `This round: ${summary.kept} kept, ${summary.failed} failed, ${summary.vetoed} could not start${paid ? `, $${summary.spent} spent` : ''}`,
+    `This round: ${summary.kept} kept, ${summary.failed} failed, ${summary.vetoed} could not start${summary.held ? `, ${summary.held} paused for a person's review` : ''}${paid ? `, $${summary.spent} spent` : ''}`,
     'Missions this round:',
     missions,
     '',
@@ -174,4 +175,4 @@ function makeCadence(root, loop, options = {}, deps = {}) {
   return { run, review };
 }
 
-module.exports = { lessonsPath, makeCadence, parseDuration, readLessons, reviewPrompt };
+module.exports = { lessonsPath, makeCadence, parseDuration, readLessons, reviewPrompt, roundSummary, roundTally };

package/lib/campaign-loop.js

@@ -79,6 +79,8 @@ function rankCampaignMembers(view, rsiSummary = null, events = null) {
     let streak = 0;
     for (let i = mine.length - 1; i >= 0; i -= 1) {
       const outcome = String(mine[i].outcome || '');
+      // held waits on a person's yes: it neither adds to a streak nor ends one
+      if (outcome === 'held') continue;
       if (outcome && outcome !== 'kept' && !mine[i].credited) streak += 1;
       else break;
     }

package/lib/campaign-missions.js

@@ -193,8 +193,11 @@ function missionCost(root, missionId, deps = {}) {
   return { cost_usd: cents / 100, runs: rows.length, uncosted_runs: uncosted };
 }
 
+// A mission whose last tick paused for a person's review was held, not
+// failed: the work waits on a yes, so the campaign should say so.
 function outcomeFor(mission) {
-  return mission.status === 'complete' ? 'kept' : 'failed';
+  if (mission.status === 'complete') return 'kept';
+  return mission.last_tick_status === 'paused-for-review' ? 'held' : 'failed';
 }
 
 // Called from saveMission with the record before and after. Only the step

package/lib/campaign-rsi.js

@@ -40,6 +40,12 @@ function dedupeLessons(lines) {
   return out;
 }
 
+// Held is a mission paused for a person's yes: neither kept nor failed, so it
+// adds no failure, streak, or lesson.
+function failedOutcome(outcome) {
+  return Boolean(outcome) && outcome !== 'kept' && outcome !== 'held';
+}
+
 function aggregateMembers(missions, failureOrder = missions) {
   const byMember = new Map();
   for (const m of missions) {
@@ -48,6 +54,7 @@ function aggregateMembers(missions, failureOrder = missions) {
       byMember.set(name, {
         member: name,
         missions: 0,
+        held: 0,
         kept: 0,
         failed: 0,
         reverted: 0,
@@ -63,12 +70,14 @@ function aggregateMembers(missions, failureOrder = missions) {
       });
     }
     const entry = byMember.get(name);
-    entry.missions += 1;
+    // held is not decided yet, so it stays out of the totals a rating divides by
+    if (m.outcome === 'held') entry.held += 1;
+    else entry.missions += 1;
     const cost = typeof m.cost_usd === 'number' && Number.isFinite(m.cost_usd) ? m.cost_usd : 0;
     entry.cost_usd = round(entry.cost_usd + cost, 4);
     if (m.outcome === 'kept') {
       entry.kept += 1;
-    } else if (m.outcome) {
+    } else if (failedOutcome(m.outcome)) {
       entry.failed += 1;
       if (m.outcome === 'reverted') entry.reverted += 1;
       entry.wasted_cost_usd = round(entry.wasted_cost_usd + cost, 4);
@@ -84,7 +93,7 @@ function aggregateMembers(missions, failureOrder = missions) {
   for (const m of failureOrder) {
     const entry = byMember.get(m.member || 'unknown');
     if (m.outcome === 'kept') entry.failure_streak = 0;
-    else if (m.outcome) {
+    else if (failedOutcome(m.outcome)) {
       entry.failure_streak += 1;
       if (entry.failure_streak >= 2) entry.repeat_failures += 1;
     }
@@ -223,7 +232,7 @@ function summarizeTrace(events) {
         `- ${m.member} finished ${m.mission_id} on ${m.campaign_id} with ${m.reward === 0 ? 'no reading gain' : `reading change ${round(m.reward, 4)}`}; tie verify directly to a failing judge check`
       );
     }
-    if (m.outcome && m.outcome !== 'kept') {
+    if (failedOutcome(m.outcome)) {
       rawLessons.push(
         `- ${m.member} had ${m.mission_id} end ${m.outcome} on ${m.campaign_id}; keep scope to one checkable slice`
       );
@@ -429,7 +438,7 @@ function writeRsiSnapshot(root, store, campaignId = null) {
     );
     const progressFile = path.join(root, 'atris', 'campaigns', cid, 'progress.md');
     const kept = (c.missions || []).filter((m) => m.outcome === 'kept').length;
-    const failed = (c.missions || []).filter((m) => m.outcome && m.outcome !== 'kept').length;
+    const failed = (c.missions || []).filter((m) => failedOutcome(m.outcome)).length;
     const progressLines = [
       `# Progress: ${c.title}`,
       '',
@@ -559,7 +568,7 @@ function selectNextCampaigns(store, rsiSummary = null) {
       : rankCampaignMembers(current, rsi, events);
     const benched = ranked.filter((r) => r.benched).map((r) => r.member);
     const warm = ranked.find((r) => !r.benched) || ranked[0] || { member: v.owner, overall: 75 };
-    const failedCount = (v.missions || []).filter((m) => m.status === 'ended' && m.outcome !== 'kept').length;
+    const failedCount = (v.missions || []).filter((m) => m.status === 'ended' && m.outcome !== 'kept' && m.outcome !== 'held').length;
     const recommendation = warm.overall < 65
       ? `add seat ${topStoreMember} (top ovr) to replace cold lineup (${ranked.map((r) => `${r.member} ${r.overall} ovr`).join(', ')})`
       : benched.length

package/lib/campaign-schema.js

@@ -33,8 +33,9 @@ const STATES = Object.freeze([
 const STOP_REASONS = Object.freeze(['judge_passed', 'stopped', 'done_by_human', 'budget_spent']);
 
 // A fault is a job that never ran (engine missing, crash before the first
-// step): the setup broke, not the work.
-const MISSION_OUTCOMES = Object.freeze(['kept', 'reverted', 'failed', 'fault']);
+// step): the setup broke, not the work. Held is a mission that paused for a
+// person's review before it could finish.
+const MISSION_OUTCOMES = Object.freeze(['kept', 'reverted', 'failed', 'fault', 'held']);
 
 // What a person or agent writes. Everything else is folded from events.
 const CAMPAIGN_FIELDS = Object.freeze({

package/lib/gm-phone-page.js

@@ -1615,12 +1615,28 @@ body.waiting .bet { position: absolute; left: 24px; right: 24px; width: auto; to
     if (reduced) {
       document.getElementById('lava').style.opacity = '0';
       planned('leave', 200);
-      setTimeout(function () { swap(); stageFade(); orb.melt(then, to, function () {}, fast); }, 200);
+      afterFade(b, 200, function () { swap(); stageFade(); orb.melt(then, to, function () {}, fast); });
       return;
     }
     orb.melt(then, to, swap, fast);
   }
 
+  // the card has faded all the way: its opacity fade ended, or ms passed with
+  // a frame to spare when none ran. A timer alone cut the last sixth of a fade
+  // that started a frame late on a slow phone, and the card vanished at 0.17.
+  function afterFade(node, ms, cb) {
+    var ran = false;
+    var finish = function (e) {
+      // eventPhase 2: the card's own fade, not one bubbling up from inside it
+      if (ran || (e && (e.eventPhase !== 2 || e.propertyName !== 'opacity'))) return;
+      ran = true;
+      node.removeEventListener('transitionend', finish);
+      cb();
+    };
+    node.addEventListener('transitionend', finish);
+    setTimeout(finish, ms + 50);
+  }
+
   // under reduced motion the sphere never travels: it fades in where it now sits
   // and its line fades in with it
   function stageFade() {
@@ -1951,14 +1967,14 @@ body.waiting .bet { position: absolute; left: 24px; right: 24px; width: auto; to
     b.classList.add('leave', 'fast');
     // under reduced motion the sphere fades out with the words, then fades in at its own place
     fadeSphere();
-    setTimeout(function () {
+    afterFade(b, 220, function () {
       b.hidden = true;
       b.classList.remove('leave', 'fast', 'holding', 'up');
       document.body.classList.remove('has-card', 'wide', 'waiting');
       stageFade();
       document.getElementById('orb').setAttribute('aria-label', 'the atris orb. tap to think of one new idea for the business');
       then();
-    }, 220);
+    });
   }
 
   // The idea lands: the calm line's words fade while the dots spiral in

package/lib/orb-context.js

@@ -4,6 +4,7 @@
 // 0ms-to-greeting is the contract (atris/features/orb-desktop/PLAN.md).
 const fs = require('fs');
 const path = require('path');
+const { localDay } = require('./local-day');
 
 const MAX_SUGGESTIONS = 12;
 const WARM_THREAD_WINDOW_MS = 48 * 60 * 60 * 1000;
@@ -37,7 +38,7 @@ function normalizeTime(value) {
 function todayKey(now) {
   const stamp = normalizeTime(now);
   if (!stamp) return '';
-  return new Date(stamp).toISOString().slice(0, 10);
+  return localDay(new Date(stamp));
 }
 
 function normalizeStatus(value) {
@@ -467,7 +468,7 @@ async function appendOrbChoice(root, label, when = new Date()) {
   const safeRoot = typeof root === 'string' && root ? path.resolve(root) : null;
   const cleanLabel = cleanTitle(label, 120);
   if (!safeRoot || !cleanLabel) return { ok: false, error: 'invalid root or label' };
-  const day = when.toISOString().slice(0, 10);
+  const day = localDay(when);
   const line = `orb: ${cleanLabel} · ${day}\n`;
   try {
     const nowPath = fs.existsSync(path.join(safeRoot, 'atris'))

package/lib/task-receipt.js

@@ -86,7 +86,9 @@ function writeTaskReceipt({ taskId, command, root = process.cwd(), runner } = {}
   const dir = runsDir(root);
   fs.mkdirSync(dir, { recursive: true });
   const now = new Date();
-  const date = now.toISOString().slice(0, 10);
+  // Local calendar day for the file name; toISOString() is the UTC day,
+  // already tomorrow in the evening west of Greenwich.
+  const date = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
   const safeTime = now.toISOString().replace(/[:.]/g, '-');
   const receiptFile = path.join(dir, `${date}-task-${slugifyTaskId(taskId)}-${safeTime}.json`);
   const receiptPath = path.relative(root, receiptFile);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "3.74.17",
+  "version": "3.74.19",
   "description": "you say what you want in plain words. atris builds it, checks it, and shows you proof.",
   "mcpName": "io.github.atrislabs/atris",
   "main": "bin/atris.js",