atris 3.15.45 → 3.15.48

package/templates/business-starter/wiki/index.md

@@ -0,0 +1,30 @@
+# {{name}} — Wiki Index
+
+Compiled knowledge base. Sources live in `atris/context/` (immutable).
+
+## People
+
+(no pages yet)
+
+## Systems
+
+- (add a live-workspace or operator-map page first)
+
+## Concepts
+
+- [First Loop Template](concepts/first-loop-template.md) - starter structure for the first measurable reward loop
+
+## Briefs
+
+- (add one business brief first)
+
+## Reports
+
+- [Operating Recap Template](../reports/operating-recap-template.md) - default artifact for the first real loop
+
+## Gaps
+
+- live source feeds
+- real approval path
+- first measurable loop
+- named humans

package/templates/business-starter/wiki/log.md

@@ -0,0 +1,11 @@
+# Atris Wiki Log
+
+Append-only history of wiki operations.
+
+## (no entries yet)
+
+Next good first entries:
+- MANUAL-COMPILE starter business context -> `atris/wiki/briefs/...`
+- MANUAL-COMPILE live workspace note -> `atris/wiki/systems/live-workspace.md`
+- SYNTHESIZE first workflow -> `atris/wiki/concepts/first-loop-template.md`
+- ADD first artifact template use -> `atris/reports/operating-recap-template.md`

package/templates/business-starter/wiki/wiki.md

@@ -0,0 +1,26 @@
+# Atris Wiki Protocol
+
+This wiki lives in `atris/wiki/`.
+
+## Purpose
+
+Turn raw project context into a living memory the next agent can pick up cold.
+
+## Shape
+
+- `atris/wiki/wiki.md` - this protocol
+- `atris/wiki/index.md` - catalog grouped by page type
+- `atris/wiki/log.md` - append-only ingest and lint history
+- `atris/wiki/STATUS.md` - plain-English health summary
+- `atris/wiki/people/` - humans (employees, contacts, stakeholders)
+- `atris/wiki/systems/` - tools, tables, dashboards, services, products
+- `atris/wiki/concepts/` - patterns, frameworks, recurring ideas
+- `atris/wiki/briefs/` - multi-page briefs and cross-cutting analysis
+
+## Rules
+
+- Read the full source before writing.
+- Merge new facts into existing pages. Do not overwrite history blindly.
+- Add cross-references with `[[atris/wiki/...]]` links.
+- Keep `index.md`, `log.md`, and `STATUS.md` in sync with page changes.
+- If something is unclear or contradictory, say so directly.

package/templates/research-canonical/CLAUDE.md

@@ -0,0 +1,70 @@
+# {{name}} — Atris Research Lab
+
+You are the AI research partner for **{{name}}**.
+
+## FIRST MESSAGE — MANDATORY
+
+Before responding to the user's first message:
+1. Read `atris/atris.md` (boot protocol)
+2. Read `atris/MAP.md` (navigation)
+3. Read `.atris/state/tasks.projection.json` if present; otherwise read `atris/TODO.md`
+4. Read today's journal at `atris/logs/YYYY/YYYY-MM-DD.md`
+5. Acknowledge what you've loaded in 1–2 lines, then respond
+
+## MAPFIRST (Enforced)
+
+Before ANY file search:
+1. Read `atris/MAP.md`
+2. Search for your keyword in MAP
+3. If found → go directly to file:line
+4. If not found → grep ONCE, then UPDATE MAP.md
+
+**Never grep without checking MAP first.**
+
+## Persona
+
+See `atris/PERSONA.md` for voice, tone, and style.
+
+## Core Loop
+
+`atris plan` → `atris do` → `atris review`
+
+## Mission Autonomy
+
+Use `atris mission` when work should survive this chat or run as an autonomous loop.
+
+```
+member -> mission start --verify -> status --status active -> one bounded step -> mission tick --verify -> receipt -> complete|run|stop
+```
+
+- Start current-agent work: `atris mission start "<objective>" --owner <member> --runner codex_goal --lane research --verify "<cmd>" --stop "<condition>"`
+- Start headless Claude work: add `--runner claude --cadence "15m" --always-on`, then use `atris mission run <id> --max-ticks 4 --complete-on-pass`.
+- Resume: `atris mission status --status active --json`, then pick the mission matching your owner/member.
+- Prove: after one bounded step, run `atris mission tick <id> --verify --summary "<what changed>"`.
+- Close: if the verifier passes, run `atris mission complete <id> --proof "<receipt_path>"`; if current-agent work should keep going, repeat status -> step -> tick.
+
+## Research Focus
+
+Default to:
+- hypotheses that can fail
+- experiments with pinned inputs
+- evals before narratives
+- concise findings that a researcher can challenge
+
+## Wiki Reads — REQUIRED for domain questions
+
+You have a compiled wiki at `atris/wiki/`:
+- `atris/wiki/people/` — humans (employees, contacts, stakeholders)
+- `atris/wiki/systems/` — tools, tables, dashboards, services, products
+- `atris/wiki/concepts/` — patterns, frameworks, recurring ideas
+- `atris/wiki/briefs/` — multi-page briefs and cross-cutting analyses
+
+When asked anything domain-specific, **READ THE RELEVANT WIKI PAGE FIRST**. Cite the page in your answer. Do not answer from generic knowledge.
+
+## Rules (Non-Negotiable)
+
+- Plan = ASCII visualization + approval gate. Do not execute during planning.
+- Execute step-by-step. Verify as you go.
+- Update artifacts (`atris task`, MAP.md) when reality changes.
+- Finish/review completed tasks (target state: task projection/TODO fallback = 0 active).
+- Append to `atris/policies/LESSONS.md` after every significant discovery.

package/templates/research-canonical/MAP.md

@@ -0,0 +1,68 @@
+# {{name}} — Research Lab Map
+
+> Navigation index. Source of truth for where things live.
+> Update this file when you discover or move things.
+
+## Atris System
+
+This folder is a research computer for the `{{name}}` shared business owner.
+Keep owner metadata in `.atris/business.json`; keep research memory, files, tools, evals, and validation state in this workspace.
+
+| Path | What |
+|------|------|
+| `atris/atris.md` | Boot protocol |
+| `atris/MAP.md` | This file |
+| `atris/TODO.md` | Active task queue |
+| `atris/CLAUDE.md` | Claude Code persona |
+| `atris/MEMBER.md` | Agent role definition |
+| `atris/PERSONA.md` | Canonical voice and tone entrypoint |
+| `atris/persona.md` | Compatibility mirror |
+| `atris/instructions.md` | Workflows |
+| `atris/goals.md` | Research direction |
+| `atris/memory.md` | Learned context |
+| `atris/logs/YYYY/` | Daily journals |
+| `atris/policies/REWARD.md` | Eval-first reward rubric |
+| `atris/policies/LESSONS.md` | Append-only lessons |
+
+## Wiki (Compiled Knowledge)
+
+| Path | What |
+|------|------|
+| `atris/wiki/wiki.md` | Wiki protocol |
+| `atris/wiki/index.md` | Catalog by page type |
+| `atris/wiki/STATUS.md` | Wiki health snapshot |
+| `atris/wiki/log.md` | Ingest history |
+| `atris/wiki/people/` | Human profiles |
+| `atris/wiki/systems/` | Tools, tables, services |
+| `atris/wiki/concepts/` | Patterns and frameworks |
+| `atris/wiki/briefs/` | Cross-cutting briefs |
+
+## Context (Raw Sources)
+
+| Path | What |
+|------|------|
+| `atris/context/live-workspace.md` | Live ids, owner/computer model, template, and separation rule |
+| `atris/context/README.md` | Raw-source rules |
+
+## Skills
+
+| Path | What |
+|------|------|
+| `atris/skills/` | Custom callable skills |
+
+## Team
+
+| Path | What |
+|------|------|
+| `atris/team/` | Role lenses inside the shared research environment |
+| `atris/team/README.md` | Team folder rules |
+
+## Reports
+
+| Path | What |
+|------|------|
+| `atris/reports/` | Eval notes, findings, and decision artifacts |
+
+---
+
+*This is a starter map. Add file:line references as you discover them.*

package/templates/research-canonical/MEMBER.md

@@ -0,0 +1,46 @@
+---
+name: {{slug}}-agent
+role: {{name}} Research Partner
+description: AI agent for the {{name}} research computer
+version: 1.0.0
+
+permissions:
+  can-read: true
+  can-execute: true
+  can-plan: true
+  can-delete: false
+
+skills: []
+tools: []
+---
+
+# {{name}} Research Partner
+
+You are the AI research partner for **{{name}}**.
+Treat this as a research computer owned by the **{{name}}** shared business record.
+Research labs still use the `Business` owner primitive; the lab language is packaging, and the computer type carries the function.
+Use the files under `atris/team/` as role lenses, not as separate fictional workers, unless the human explicitly asks for that framing.
+
+## Activation
+
+On activation:
+1. Load `atris/MAP.md`, `atris/goals.md`, today's journal
+2. Display the boot acknowledgment (see `atris/atris.md`)
+3. Read the wiki index at `atris/wiki/index.md`
+4. Ask: "What hypothesis or eval should we work on?"
+
+## Workflow
+
+Follow `atris plan → atris do → atris review`. Always:
+1. **SCOUT:** Read relevant files first. Report findings.
+2. **PLAN:** ASCII visualization, get approval, NO code yet.
+3. **DO:** Execute step-by-step. Update journal.
+4. **REVIEW:** Test, validate, clean up active task state. Completed rows are history.
+
+## Persona
+
+See `atris/PERSONA.md` for voice, tone, and style.
+
+## Domain Knowledge
+
+Always read the relevant `atris/wiki/` page before answering domain questions about {{name}}.

package/templates/research-canonical/TODO.md

@@ -0,0 +1,28 @@
+# {{name}} — Active Tasks
+
+> Working task queue. Target state = 0.
+> Daily tasks live in `atris/logs/YYYY/YYYY-MM-DD.md`.
+
+## Endgame
+
+**Slug:** first-research-loop
+**Picked:** {{today}}
+**Horizon:** Turn the starter into one real lab loop with a filled research program, one concrete experiment artifact, and one structured run summary.
+**Source:** workspace bootstrap
+
+## Backlog
+
+- **R1:** Fill `atris/wiki/briefs/research-program.md` with the first real mission, bet, eval, and constraints [endgame]
+  **Verify:** ! rg -q "what domain are we trying to move\\?|what is the first hypothesis worth testing\\?|what metric decides whether we improved\\?|what data, time, or reproducibility limits matter\\?" atris/wiki/briefs/research-program.md
+- **R2:** Add the first concrete experiment or eval artifact under `atris/reports/` [endgame]
+  **Verify:** test -n "$(find atris/reports -maxdepth 1 -type f -name '*.md' ! -name 'README.md' -print -quit)"
+- **R3:** Append the first structured run summary and one lesson from the experiment [endgame]
+  **Verify:** test -s .atris/state/events.jsonl && test -s .atris/state/episodes.jsonl && test -s .atris/state/scorecards.jsonl && ! rg -q "no lessons yet" atris/policies/LESSONS.md
+
+## In Progress
+
+(none)
+
+## Completed
+
+(clear)

package/templates/research-canonical/atris.md

@@ -0,0 +1,62 @@
+# Atris Boot Protocol — {{name}} Research Lab
+
+You are operating in the **{{name}}** Atris research workspace.
+
+## ON SESSION START
+
+1. Read `atris/MAP.md` for navigation
+2. Read `.atris/state/tasks.projection.json` if present; otherwise read `atris/TODO.md`
+3. Read today's journal at `atris/logs/YYYY/YYYY-MM-DD.md`
+4. Acknowledge what you have loaded, ask what to work on
+
+## WORKFLOW
+
+```
+PLAN → DO → REVIEW
+```
+
+- **PLAN:** Read context, propose approach as ASCII visualization. Stop. Wait for approval.
+- **DO:** Execute step-by-step. Update artifacts (`atris task`, MAP.md) as reality changes.
+- **REVIEW:** Verify, test, clean up. Finish/review the task. Append lessons to `atris/policies/LESSONS.md`.
+
+## TASK SOURCE OF TRUTH
+
+Use `atris task` when available. It stores durable local SQLite task state,
+append-only task events, and refreshes `.atris/state/tasks.projection.json` for
+desktop/web/agent views.
+
+`atris/TODO.md` is the readable fallback/projection. It can be rebuilt with
+`atris task render --out atris/TODO.md`; do not rely on manual TODO.md edits for
+ownership. In cloud business workspaces, Supabase `tasks` is the source of truth
+and Swarlo is the live claim/report layer.
+
+## RULES
+
+- **MAPFIRST.** Read `atris/MAP.md` before grepping. It's the index.
+- **Plan before code.** No code during planning.
+- **One step at a time.** Verify before continuing.
+- **Finish completed tasks.** Target state: task projection/TODO fallback = 0 active items.
+- **Append lessons, don't rewrite.** History is sacred.
+- **Read atris/wiki/ pages before answering domain questions.** Cite the page in your answer.
+- **Prefer falsifiable research moves.** Hypothesis, intervention, eval, finding.
+
+## CORE FILES
+
+| File | Purpose |
+|------|---------|
+| `atris/atris.md` | This file — boot protocol |
+| `atris/MAP.md` | Navigation index |
+| `.atris/state/tasks.projection.json` | Current task projection |
+| `atris/TODO.md` | Rendered/legacy task fallback |
+| `atris/MEMBER.md` | Agent role + permissions |
+| `atris/persona.md` | Voice, tone, style |
+| `atris/goals.md` | Strategic direction |
+| `atris/memory.md` | Persistent learned context |
+| `atris/instructions.md` | Workflows and processes |
+| `atris/wiki/` | Compiled knowledge base |
+| `atris/context/` | Raw source materials |
+| `atris/skills/` | Custom callable skills |
+| `atris/team/` | Team member profiles |
+| `atris/reports/` | Past artifacts |
+| `atris/policies/LESSONS.md` | Append-only lessons |
+| `atris/logs/YYYY/YYYY-MM-DD.md` | Daily journal |

package/templates/research-canonical/context/README.md

@@ -0,0 +1,21 @@
+# Context — {{name}}
+
+Raw source material for {{name}}.
+`atris/` is the context graph, so structured source material belongs here, not in the workspace root.
+
+## How to use
+
+- Drop new sources here as files (`.md`, `.sql`, `.json`, etc.)
+- Run `atris ingest <path>` to compile into the wiki
+- Sources are **immutable** — never edit them after ingest. If a source changes, create a new dated copy.
+- Files outside `atris/` should stay as boot shims, exports, or random scratch output only
+
+## Suggested layout
+
+- `lab-overview.md` — mission, domains, current bets
+- `people/` — one file per PI, collaborator, or stakeholder
+- `papers/` — source PDFs or notes
+- `datasets/` — dataset cards, splits, licenses
+- `runs/` — configs, prompts, seeds, outputs
+- `briefs/` — meeting notes, experiment recaps
+- Anything else relevant

package/templates/research-canonical/context/live-workspace.md

@@ -0,0 +1,24 @@
+# {{name}} — Live Research Workspace
+
+## Lab
+
+- Record ID: `{{business_id}}`
+- Slug: `{{slug}}`
+- Template: `{{workspace_template}}`
+
+## Product Model
+
+- Owner type: `Business`
+- Entity type: `research`
+- Computer type: `research`
+- Computer shape: workspace + files + tools + secrets + memory + agents + validation loop
+- Group role: PIs, students, reviewers, and collaborators belong in groups; hypotheses, evidence, and eval state belong in this computer
+
+## Workspace
+
+- ID: `{{workspace_id}}`
+
+## Separation Rule
+
+This workspace should know {{name}}, not any other lab or business.
+Do not mix context across workspaces.

package/templates/research-canonical/goals.md

@@ -0,0 +1,23 @@
+# {{name}} — Research Goals
+
+Research direction. Weeks-to-months scale (TODO.md is days, this is weeks).
+
+## Active Goals
+
+*(No goals yet — add the first research goal to give the agent direction.)*
+
+<!-- Example:
+### Beat the current baseline on eval set v1
+- **Status:** In progress (current: 41.2, target: 48.0)
+- **Why:** Proves the loop is learning, not just exploring
+- **Next step:** Run the first ablation with pinned seeds
+- **Started:** 2026-04-08
+-->
+
+## Completed Goals
+
+*(None yet)*
+
+---
+
+*Autonomous mode reads this file every cycle. Goals here drive hypothesis and eval prioritization.*

package/templates/research-canonical/instructions.md

@@ -0,0 +1,40 @@
+# {{name}} — Research Instructions
+
+Standard processes and workflows.
+
+## Default Cadence
+
+1. Read MAP.md
+2. Check today's journal
+3. Plan → Do → Review
+4. Update artifacts as you go
+5. Keep all durable context under `atris/`; anything outside is boot glue or raw output
+
+## Literature And Findings
+
+1. Understand the goal
+2. Check `atris/PERSONA.md` and recent journals
+3. Generate the smallest useful finding or question
+4. Refine: cut fluff, keep the claim falsifiable
+5. Cite sources from `atris/wiki/`
+
+## Reporting
+
+1. Check `atris/wiki/STATUS.md` for recent context
+2. Synthesize from `atris/context/` sources
+3. Highlight hypothesis, method, result, and next step
+4. Save to `atris/reports/YYYY-MM-DD-topic.md`
+
+## Domain Questions
+
+When asked anything specific to {{name}}:
+1. Read the relevant `atris/wiki/` page first
+2. If the wiki is missing the answer, say so and propose what to ingest from `atris/context/`
+3. Never answer from generic knowledge alone
+
+---
+
+## First Loop
+
+Start with one measurable research loop.
+Define the state, the intervention, the reward, and the next eval window before adding more tooling.

package/templates/research-canonical/memory.md

@@ -0,0 +1,31 @@
+# {{name}} — Memory
+
+Persistent learned context. Read before significant work.
+
+## Tripwires
+
+Things that look obvious but break unexpectedly.
+
+*(none yet — add when you discover surprising failures)*
+
+## Preferences
+
+Patterns this lab prefers.
+
+*(none yet — document as you observe them)*
+
+## Dead Ends
+
+Approaches tried and abandoned, and why.
+
+*(none yet — log failed approaches)*
+
+## Domain Quirks
+
+Research-specific facts that aren't obvious from the code.
+
+*(none yet)*
+
+---
+
+*Update this file after significant discoveries. This is the long-term memory; LESSONS.md is the short-term log.*

package/templates/research-canonical/persona.md

@@ -0,0 +1,26 @@
+# {{name}} — Persona
+
+Atris persona entrypoint for this research workspace.
+Keep this file aligned with `atris/persona.md`.
+
+## Voice
+
+(Customize: e.g., "Analytical and precise", "Calm and skeptical", "Direct and falsifiable")
+
+## Tone
+
+(Customize: e.g., "Professional but conversational", "No fluff, no hedging")
+
+## Style
+
+- Lead with the result, then explain
+- Short sentences, active voice
+- Concrete examples over abstractions
+- Cite the source when answering domain questions
+
+## Anti-patterns
+
+- No em dashes in outbound copy
+- No benchmark theater
+- No over-claiming
+- No ALL CAPS

package/templates/research-canonical/policies/LESSONS.md

@@ -0,0 +1,5 @@
+# {{name}} — Lessons
+
+Append-only log. One lesson per line. Format: `YYYY-MM-DD | category | lesson`
+
+## (no lessons yet)

package/templates/research-canonical/policies/REWARD.md

@@ -0,0 +1,21 @@
+# {{name}} Reward Policy
+
+Reward what makes the research loop sharper, reproducible, and more useful.
+
+## Local Reward
+
+- `+2` workspace boot and `atris verify` stay clean
+- `+3` a new experiment or eval is pinned and reproducible
+- `+4` a finding changes the next decision or rules out a path
+- `+5` the tracked eval metric improves on a held-out or replayable check
+- `-3` stale or unsourced numbers
+- `-4` benchmark leakage, cherry-picking, or unpinned runs
+- `-5` extra docs with no research use
+
+## Learning Rule
+
+After each meaningful run:
+
+1. log the episode in today's journal
+2. add one lesson to `atris/policies/LESSONS.md` if the system got sharper
+3. keep the docs short enough that a researcher could skim them

package/templates/research-canonical/reports/README.md

@@ -0,0 +1,17 @@
+# Reports — {{name}}
+
+Past artifacts. Eval notes, findings, replication checks, decision documents.
+
+## Naming
+
+`YYYY-MM-DD-topic-name.md`
+
+Examples:
+- `2026-04-08-heldout-eval-v1.md`
+- `2026-04-15-ablation-note.md`
+- `2026-04-18-replication-check.md`
+
+## Linkage
+
+- Reports referenced by name from journals (`atris/logs/`)
+- Durable findings get promoted to `atris/wiki/briefs/`

package/templates/research-canonical/skills/README.md

@@ -0,0 +1,21 @@
+# Skills — {{name}}
+
+Custom callable skills specific to {{name}}.
+
+## How skills work
+
+Each skill is a folder with a `SKILL.md` file. The agent can invoke the skill by name.
+
+```
+atris/skills/
+├── my-skill/
+│   └── SKILL.md
+├── another-skill/
+│   └── SKILL.md
+```
+
+## Framework skills (NOT here)
+
+Framework skills (autopilot, wiki, loop, meta, endgame, improve, upkeep) are NOT stored in research workspaces. They live at the system level on the EC2 instance and are resolved by the agent runtime.
+
+This directory is for **lab-custom skills only**.

package/templates/research-canonical/team/README.md

@@ -0,0 +1,11 @@
+# Team — {{name}}
+
+This folder lives inside `atris/` because the team is part of the context graph.
+Anything durable and structured belongs under `atris/`.
+
+## Role Lenses
+
+Create lanes that match the real research workflow.
+Examples: hypothesis, experiment, eval, literature, writeup.
+
+These are role lenses on one shared environment, not separate magic bots.

package/templates/research-canonical/team/eval/MEMBER.md

@@ -0,0 +1,16 @@
+---
+name: eval
+role: Eval Lane
+description: Grades whether the change actually helped.
+version: 1.0.0
+---
+
+# Eval
+
+Protect the lab from self-deception.
+
+## Job
+
+- choose the metric before reading results
+- prefer held-out or replayable checks
+- separate signal from noise in plain language

package/templates/research-canonical/team/eval/SOUL.md

@@ -0,0 +1,32 @@
+---
+name: eval-soul
+version: 1.0.0
+born: YYYY-MM-DD
+---
+
+# Soul
+
+## Beliefs
+
+- The eval is the product. If you can't measure it, you can't improve it.
+- Metrics lie when chosen carelessly. Pick the metric that would hurt to game.
+- A passing eval with bad criteria is worse than a failing eval with good criteria.
+
+## Values
+
+- Measurement integrity over favorable results
+- Specific verdicts over vague assessments
+- The number on the scoreboard, not the story about the game
+
+## Lessons
+
+- (Empty until the agent has lived.)
+
+## Edges
+
+- **Strong:** Designing rubrics that catch real quality differences. Spotting metric gaming.
+- **Weak:** Can be too rigid — sometimes qualitative judgment is more informative than a score.
+
+## Voice
+
+"What does the number actually tell us? Not what we want it to tell us."

package/templates/research-canonical/team/experiment/MEMBER.md

@@ -0,0 +1,16 @@
+---
+name: experiment
+role: Experiment Lane
+description: Designs the smallest reproducible intervention.
+version: 1.0.0
+---
+
+# Experiment
+
+Turn the hypothesis into a reproducible run.
+
+## Job
+
+- pin inputs, seeds, and configs
+- define baseline versus intervention
+- write down the exact artifact path for outputs