atris 3.26.0 → 3.28.0

package/utils/update-check.js

@@ -2,7 +2,7 @@ const https = require('https');
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
-const { spawnSync } = require('child_process');
+const { spawn, spawnSync } = require('child_process');
 
 const PACKAGE_NAME = 'atris';
 const CHECK_INTERVAL_MS = 60 * 60 * 1000; // 1 hour
@@ -34,6 +34,8 @@ function getCacheData() {
       return {
         lastCheck: data.lastCheck ? new Date(data.lastCheck) : null,
         latestVersion: data.latestVersion || null,
+        lastAutoUpdate: data.lastAutoUpdate ? new Date(data.lastAutoUpdate) : null,
+        lastAutoUpdateVersion: data.lastAutoUpdateVersion || null,
       };
     }
   } catch (error) {
@@ -52,7 +54,11 @@ function saveCacheData(latestVersion) {
     if (!fs.existsSync(ATRIS_DIR)) {
       fs.mkdirSync(ATRIS_DIR, { recursive: true });
     }
+    const existing = fs.existsSync(CACHE_FILE)
+      ? JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'))
+      : {};
     const data = {
+      ...existing,
       lastCheck: new Date().toISOString(),
       latestVersion: latestVersion,
     };
@@ -62,6 +68,34 @@ function saveCacheData(latestVersion) {
   }
 }
 
+function markAutoUpdateStarted(latestVersion) {
+  try {
+    if (!fs.existsSync(ATRIS_DIR)) {
+      fs.mkdirSync(ATRIS_DIR, { recursive: true });
+    }
+    const existing = fs.existsSync(CACHE_FILE)
+      ? JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'))
+      : {};
+    fs.writeFileSync(CACHE_FILE, JSON.stringify({
+      ...existing,
+      lastAutoUpdate: new Date().toISOString(),
+      lastAutoUpdateVersion: latestVersion,
+    }, null, 2));
+  } catch (error) {
+    // Ignore cache write errors
+  }
+}
+
+function autoUpdateRecentlyStarted(latestVersion, now = new Date()) {
+  const cache = getCacheData();
+  return Boolean(
+    latestVersion &&
+    cache.lastAutoUpdate &&
+    cache.lastAutoUpdateVersion === latestVersion &&
+    now - cache.lastAutoUpdate < CHECK_INTERVAL_MS
+  );
+}
+
 /**
  * Fetch the latest version of atris from npm registry.
  * @returns {Promise<string>} Latest version string
@@ -189,7 +223,7 @@ function showUpdateNotification(updateInfo) {
   // Single yellow warning line — non-intrusive
   const yellow = '\x1b[33m';
   const reset = '\x1b[0m';
-  console.log(`${yellow}Update available: ${updateInfo.installed} → ${updateInfo.latest}. Run: npm install -g atris${reset}`);
+  console.log(`${yellow}Update available: ${updateInfo.installed} → ${updateInfo.latest}. Run: atris upgrade${reset}`);
 }
 
 function inspectInstallGitState(packageRoot = path.join(__dirname, '..')) {
@@ -237,37 +271,55 @@ function formatInstallGitWarning(state) {
   if (state.detached) flags.push(`detached HEAD${state.head ? ` ${state.head}` : ''}`);
   if (state.dirty) flags.push(`dirty worktree (${state.dirtyCount} file${state.dirtyCount === 1 ? '' : 's'})`);
   return `WARNING: Atris is running from a ${flags.join(' + ')} at ${state.root}.\n` +
-    'npm update may not change the code currently on PATH; resolve that checkout before trusting upgrade status.';
+    'npm install -g atris@latest may not change the code currently on PATH; resolve that checkout before trusting upgrade status.';
 }
 
-function autoUpdate(updateInfo) {
+function normalizeAutoUpdateMode(env = process.env) {
+  const raw = String(env.ATRIS_AUTO_UPDATE || '').trim().toLowerCase();
+  if (['0', 'false', 'no', 'off', 'notify'].includes(raw)) return 'off';
+  if (['1', 'true', 'yes', 'on', 'force'].includes(raw)) return 'force';
+  return 'auto';
+}
+
+function shouldAutoUpdate(updateInfo, state, env = process.env) {
   if (!updateInfo || !updateInfo.needsUpdate) return false;
 
-  const { execSync } = require('child_process');
+  const mode = normalizeAutoUpdateMode(env);
+  if (mode === 'off') return false;
+  if (mode === 'force') return true;
 
-  console.log('');
-  console.log(`⬆️  Updating atris ${updateInfo.installed} → ${updateInfo.latest}...`);
+  // Packaged npm installs are not git repositories. Git checkouts may be linked
+  // dev installs, where a global npm install would not update the code on PATH.
+  return !(state && state.isGitRepo);
+}
 
-  try {
-    execSync('npm update -g atris', { stdio: 'pipe', timeout: 30000 });
-    console.log(`✅ Updated to ${updateInfo.latest}`);
-
-    // Auto-sync skills into current project if atris/skills/ exists
-    try {
-      if (fs.existsSync(path.join(process.cwd(), 'atris', 'skills'))) {
-        execSync('atris sync', { stdio: 'pipe', timeout: 10000 });
-        console.log(`✅ Skills synced`);
-      }
-    } catch (e) {
-      // Sync failed — not critical
-    }
+function autoUpdate(updateInfo, options = {}) {
+  if (!updateInfo || !updateInfo.needsUpdate) return false;
+
+  const env = options.env || process.env;
+  const packageRoot = options.packageRoot || path.join(__dirname, '..');
+  const installState = options.installState || inspectInstallGitState(packageRoot);
+  if (!shouldAutoUpdate(updateInfo, installState, env)) return false;
+
+  const recentlyStarted = options.recentlyStarted || autoUpdateRecentlyStarted;
+  if (recentlyStarted(updateInfo.latest)) return false;
 
-    console.log('');
+  const spawnImpl = options.spawn || spawn;
+  const markStarted = options.markStarted || markAutoUpdateStarted;
+  const log = options.log || console.log;
+
+  try {
+    const child = spawnImpl('npm', ['install', '-g', `${PACKAGE_NAME}@latest`], {
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true,
+    });
+    if (child && typeof child.on === 'function') child.on('error', () => {});
+    if (child && typeof child.unref === 'function') child.unref();
+    markStarted(updateInfo.latest);
+    log(`Auto-update started: atris ${updateInfo.installed} -> ${updateInfo.latest} (background)`);
     return true;
   } catch (error) {
-    // npm update failed (permissions, network, etc) — fall back to notification
-    console.log(`⚠️  Auto-update failed. Run manually: npm update -g atris`);
-    console.log('');
     return false;
   }
 }
@@ -276,6 +328,7 @@ module.exports = {
   checkForUpdates,
   showUpdateNotification,
   autoUpdate,
+  shouldAutoUpdate,
   inspectInstallGitState,
   formatInstallGitWarning,
 };

package/atris/wiki/concepts/agent-activation-contract.md

@@ -1,81 +0,0 @@
----
-type: concept
-slug: agent-activation-contract
-title: Agent Activation Contract
-sources:
-  - atris/CLAUDE.md
-  - commands/activate.js
-last_compiled: 2026-06-23
-last_verified: 2026-06-23
-confidence: 0.9
-dependencies:
-  - atris/wiki/concepts/plan-do-review-loop.md
-  - atris/wiki/concepts/wiki-as-memory-substrate.md
-actionability: "Use this before changing agent boot instructions, `atris activate`, MAP-first behavior, first-message requirements, or durable-memory routing."
-created: 2026-05-10
-updated: 2026-06-23
-tags:
-  - agent-activation
-  - protocol
-  - mapfirst
----
-# Agent Activation Contract
-
-`atris/CLAUDE.md` is the editor-facing boot contract for agents entering an Atris-managed project. `commands/activate.js` is the runtime context panel agents use after that boot. Together they define what "activation" means before responding or editing.
-
-## Boot Sequence
-
-```text
-first message -> atris atris.md
-setup -> PERSONA + activate + wiki STATUS
-navigation -> MAP first, then one grep if needed
-work -> plan -> do -> review
-memory -> wiki or ingest durable knowledge
-```
-
-The first response path is explicit: run `atris atris.md`, show the welcome visualization, then answer. After that, agents load `atris/PERSONA.md`, run `atris activate`, and treat `atris/wiki/STATUS.md` as the current memory snapshot when it exists.
-
-## Runtime Activation
-
-`atris activate` refuses to run without an `atris/` folder and tells the operator to run `atris init` first. In a valid workspace it creates today's journal if missing, detects workspace state, loads current task context, reads `atris/wiki/STATUS.md`, and prints a narrow activation card.
-
-The activation card can include:
-
-- a handoff block from today's journal when `## Handoff` has structured context,
-- the last three deduped completions from journal history,
-- the current state summary from detected in-progress, backlog, and inbox items,
-- a learning count from `atris/learnings.jsonl`,
-- wiki health from `atris/wiki/STATUS.md`,
-- core file paths for persona, MAP, task view, journal, and wiki status.
-
-The command ends by pointing the operator back to `atris plan -> do -> review` or `atris log`. It is a read/load surface with one deliberate local side effect: ensuring the current journal file exists so the session is writable.
-
-## MAP-First Rule
-
-Before any file search, read `atris/MAP.md` and search the map for the target keyword. If the map has the location, go directly to that file and line. If not, grep once and update `MAP.md` so the next agent does not repeat the same scan.
-
-## Core Truth Surfaces
-
-- `atris/MAP.md` is navigation.
-- `atris/TODO.md` is the visible work queue; current task ownership lives in `atris task`.
-- `atris/logs/YYYY/YYYY-MM-DD.md` is the operating journal.
-- `atris/wiki/STATUS.md` is the current memory snapshot.
-- `atris/wiki/index.md` is the durable knowledge index.
-- `atris/atris.md` is the full protocol.
-
-## Execution Contract
-
-Work follows `atris plan -> atris do -> atris review`. Planning requires an ASCII visualization and an approval gate. Execution is step-by-step, with verification as reality changes. Completed tasks should be removed from the active queue; the target state is zero stale tasks.
-
-Durable project knowledge belongs in `atris/wiki/` or through the local wiki flow. Ephemeral progress belongs in task state and the daily journal, not in ad hoc context.
-
-`atris/CLAUDE.md` now also carries an explicit agent contract: before edits, claim or create one small task with `atris task` and write the goal/files/done/check contract into task dialogue; after edits, move proof-backed work to Review with `atris task ready <id> --proof "..."`. Proof-ready and human accept are separate gates: an agent's native goal can complete once proof is in Review, but only a human-run `atris task accept <id>` marks the task Done and awards AgentXP. Work that should outlive the chat runs through `atris mission` (start with a verifier, bounded step, `mission tick --verify`, then complete or continue).
-
-## Limits
-
-This page summarizes the activation contract only. Use `atris/atris.md` for the complete protocol, `atris/wiki/concepts/plan-do-review-loop.md` for stage ownership and proof, and `atris/wiki/concepts/wiki-as-memory-substrate.md` for wiki page shape and upkeep behavior. `atris activate` reports state; it does not claim tasks, finish work, or repair broken wiki pages.
-
-## Cross-References
-
-- [[atris/wiki/concepts/plan-do-review-loop.md]] - stage ownership, proof, and review closure
-- [[atris/wiki/concepts/wiki-as-memory-substrate.md]] - durable memory routing and wiki verification

package/atris/wiki/concepts/workspace-initialization-contract.md

@@ -1,73 +0,0 @@
----
-type: concept
-slug: workspace-initialization-contract
-title: Workspace Initialization Contract
-sources:
-  - commands/init.js
-last_compiled: 2026-06-23
-last_verified: 2026-06-23
-confidence: 0.86
-dependencies:
-  - atris/wiki/systems/atris-cli.md
-  - atris/wiki/concepts/agent-activation-contract.md
-  - atris/wiki/concepts/wiki-as-memory-substrate.md
-actionability: "Use this before changing `atris init`, workspace scaffolds, generated agent instructions, project detection, or boot hook behavior."
-created: 2026-05-10
-updated: 2026-06-23
-tags:
-  - initialization
-  - workspace
-  - scaffold
----
-# Workspace Initialization Contract
-
-`commands/init.js` defines the local contract for turning an arbitrary folder into an Atris-managed workspace. It is the repo-level bootstrap path, not the business workspace onboarding path.
-
-## Shape
-
-```text
-guard workspace -> create atris/ -> scaffold memory + teams + features
-                -> detect project -> inject team context
-                -> generate agent entry files + hooks
-                -> copy atris protocol
-```
-
-The command handles `atris init [--force]`. Help flags print usage without filesystem side effects. Normal execution refuses to run inside an existing `atris/` directory, inside a parent business workspace, or in a folder with `.atris/business.json` unless `--force` is present.
-
-## What Init Creates
-
-- Core workspace: `atris/`, `atris/atris.md`, `atris/PERSONA.md`, `atris/GETTING_STARTED.md`, `atris/MAP.md`, `atris/TODO.md`, `atris/now.md`, `atris/lessons.md`, and dated logs.
-- Memory surfaces: wiki scaffold via `ensureWikiScaffold`, feature templates, experiments harness, and `INTUITION.md`.
-- Team surfaces: `atris/team/<member>/MEMBER.md` plus `skills/`, `tools/`, and `context/` folders for default members.
-- Project profile: `.project-profile.json` from package files, framework hints, directory shape, and default test command.
-- Agent entry files: `AGENTS.md`, `.cursorrules`, `.cursor/rules/atris.mdc`, `.claude/commands/atris.md`, `.claude/commands/atris-autopilot.md`, `atris/CLAUDE.md`, `.claude/settings.json`, `.devin/config.local.json`, and root `CLAUDE.md` Atris markers.
-- Skills: package `atris/skills/` copied into the workspace and linked into `.claude/skills/` when possible.
-
-## Project Detection
-
-`detectProjectContext()` scans package files first, then framework-specific dependencies, then common structure directories. It detects Node, Python, Ruby, Go, Rust, Java, PHP, Elixir, D, iOS, and markdown-only knowledge bases. The resulting test command is a default hint (`npm test`, `pytest`, `go test ./...`, etc.), not a guarantee that validation is sufficient.
-
-`injectProjectPatterns()` writes that profile into navigator, executor, and validator specs so the first generated team has a local project shape before any agent starts work.
-
-## Generated Agent Contract
-
-The generated instruction files all point agents back to the same small operating loop:
-
-- run the Atris boot sequence before first response,
-- keep replies short,
-- use ASCII visuals for planning,
-- check `MAP.md` before code search,
-- use `atris task` for ownership and proof,
-- treat `TODO.md` as rendered state, not the task database.
-
-Claude-specific setup also adds a `SessionStart` hook that runs `atris atris.md` when `atris/` exists and a `Stop` hook that points to the autopilot stop hook.
-
-## Limits
-
-`atris init` bootstraps local files. It does not push to cloud, create a shared business owner, or reconcile template updates after custom edits. Use business commands for shared-owner workspaces and `atris update` / sync flows for canonical file refreshes.
-
-## Cross-References
-
-- [[atris/wiki/concepts/agent-activation-contract.md]] - the boot behavior generated agent files point to
-- [[atris/wiki/concepts/wiki-as-memory-substrate.md]] - the wiki scaffold and memory contract initialized by this command
-- [[atris/wiki/systems/atris-cli.md]] - repo-level command surface that includes `atris init`

package/atris/wiki/index.md

@@ -1,31 +0,0 @@
-# Atris Wiki Index
-
-## Entities
-
-- [[atris/wiki/people/jack-dorsey.md]] — Block / Twitter founder; AI-native company thesis
-- [[atris/wiki/systems/atris-cli.md]] — this project; dev-tool layer of the Atris stack
-- [[atris/wiki/systems/atris-business.md]] — sibling product; shared owners with persistent AI computers
-- [[atris/wiki/systems/atris-labs.md]] — reference business owner in the Atris fleet; default computer dogfood
-
-## Concepts
-
-- [[atris/wiki/concepts/intent-capability-composition.md]] — the operating loop; roadmap from gaps
-- [[atris/wiki/concepts/wiki-as-memory-substrate.md]] — what `atris/wiki/` is and isn't
-- [[atris/wiki/concepts/plan-do-review-loop.md]] — core Atris workflow and how local memory fits into it
-- [[atris/wiki/concepts/rebased-pack-co-first-loop.md]] — local-only business workspace first loop and proof guardrails
-- [[atris/wiki/concepts/atris-labs-goals.md]] — atris-labs north star, 2026 Q2 targets, standing constraints
-- [[atris/wiki/concepts/horizon-types.md]] — horizon slug prefix convention; type categories and inference rules
-- [[atris/wiki/concepts/verifiable-reward-loop.md]] — reward, scorecards, and why the repo now acts like an RL-style environment
-- [[atris/wiki/concepts/recursive-self-improvement-position.md]] — honest capability assessment: the loop is the RSI skeleton on the leverage axis, intelligence axis fixed by the model
-- [[atris/wiki/concepts/owner-computer-model.md]] — Owner = User | Business; constrained entity modes, typed computers, and groups as the social/access layer
-- [[atris/wiki/concepts/agent-activation-contract.md]] — editor-facing boot contract: first message, MAP-first, setup, and durable-memory routing
-- [[atris/wiki/concepts/workspace-initialization-contract.md]] — `atris init` bootstrap contract: guards, scaffolds, team context, generated agent files, and hooks
-- [[atris/wiki/concepts/glass-interface-principle.md]] — AI tool design doctrine: make reasoning visible and inspectable, not black-boxed
-
-## Briefs
-
-- [[atris/wiki/briefs/rebased-pack-co-starter-brief.md]] — starter brief for the local-only Rebased Pack Co smoke workspace
-- [[atris/wiki/briefs/atris-cli-overview.md]] — summary of CLI, owner/computer model, workspace layers, and why `atris/wiki/` exists
-- [[atris/wiki/briefs/atris-labs-workspace-protocol.md]] — atris-labs workspace protocol: on-load sequence, layout, surfaces, north star
-- [[atris/wiki/briefs/atrisos-generative-ui-product-surface.md]] — historical AtrisOS generative UI / block surface design note
-- [[atris/wiki/briefs/launch-post.md]] — historical launch drafts for the local-first wiki feature

package/atris/wiki/sources/atris-labs-2026-05-10.txt

@@ -1,14 +0,0 @@
-Source receipt for atris/wiki/systems/atris-labs.md
-Compiled: 2026-05-10
-
-Local evidence checked:
-- historical Atris Labs customer workspace docs
-- historical Atris Labs context status and pipeline notes
-- historical Atris Labs member profile notes
-- historical Atris Labs app workspace inventory
-- historical Atris Labs cloud workspace binding metadata
-
-Notes:
-- The previous wiki source is missing in this workspace.
-- Available status/pipeline files are historical March 2026 artifacts.
-- Treat this page as orientation, not a live company operating report.

package/atris/wiki/sources/atris-labs-goals-2026-05-10.txt

@@ -1,14 +0,0 @@
-Source receipt for atris/wiki/concepts/atris-labs-goals.md
-Compiled: 2026-05-10
-
-Local evidence checked:
-- atris/wiki/concepts/atris-labs-goals.md before refresh
-- atris/wiki/log.md historical ingest notes for missing goals.md
-- historical Atris Labs context status and pipeline notes
-- historical Atris Labs fundraising metrics notes
-- historical Atris Labs fundraising story notes
-
-Notes:
-- The previous goals source is missing in this workspace.
-- The page is retained as historical direction only.
-- Revenue/customer counts require live verification before operational use.

package/atris/wiki/sources/atrisos-generative-ui-product-surface-2026-05-10.txt

@@ -1,10 +0,0 @@
-Source receipt for atris/wiki/briefs/atrisos-generative-ui-product-surface.md
-Compiled: 2026-05-10
-
-Local evidence checked:
-- atris/wiki/briefs/atrisos-generative-ui-product-surface.md before metadata repair
-- atris/wiki/systems/atris-cli.md for current CLI/product context
-
-Notes:
-- This brief appears to be an in-session product/design synthesis from 2026-04-29.
-- It is retained as a historical design note, not a current design-system contract.

package/atris/wiki/sources/jack-dorsey-2026-05-10.txt

@@ -1,12 +0,0 @@
-Source receipt for atris/wiki/people/jack-dorsey.md
-Compiled: 2026-05-10
-
-External sources checked:
-- YouTube episode URL: https://www.youtube.com/watch?v=YTVSwOY19Qs
-- Sequoia transcript: https://sequoiacap.com/podcast/jack-dorsey-every-company-can-now-be-a-mini-agi/
-- Block essay: https://block.xyz/inside/from-hierarchy-to-intelligence
-
-Notes:
-- The Sequoia page provides the transcript for the episode linked from YouTube.
-- The Block essay is the co-authored primary written thesis by Jack Dorsey and Roelof Botha.
-- No Atris YouTube processing credits were spent for this refresh.