atris 2.2.0 → 2.2.2

package/GETTING_STARTED.md

@@ -39,9 +39,9 @@ The agent will:
 0. (Optional) Explore with you conversationally (`atris brainstorm`)
 1. Show you an **atris visualization** (diagram of the plan)
 2. Wait for your approval
-3. Create `atris/features/[name]/idea.md` + `build.md`
+3. Create `atris/features/[name]/idea.md` + `build.md` + `validate.md`
 4. Execute step by step
-5. Review and update docs (2-pass validation)
+5. Validate (fill in validate.md, harvest lessons if anything surprised you)
 
 💡 Tip: Use `atris brainstorm` if you're exploring options. Use `atris plan` when ready to build.
 

package/README.md

@@ -33,9 +33,9 @@ Then describe what you want to build. The agent will:
 0. (Optional) Explore with `atris brainstorm` if uncertain
 1. Show you a visualization
 2. Wait for approval
-3. Create `atris/features/[name]/idea.md` + `build.md`
+3. Create `atris/features/[name]/idea.md` + `build.md` + `validate.md`
 4. Execute step by step
-5. Review and update docs (2-pass)
+5. Validate (fill in validate.md, harvest lessons if anything surprised you)
 
 Commands: `brainstorm` (optional) → `plan` → `do` → `review`
 

package/atris/GETTING_STARTED.md

@@ -39,9 +39,9 @@ The agent will:
 0. (Optional) Explore with you conversationally (`atris brainstorm`)
 1. Show you an **atris visualization** (diagram of the plan)
 2. Wait for your approval
-3. Create `atris/features/[name]/idea.md` + `build.md`
+3. Create `atris/features/[name]/idea.md` + `build.md` + `validate.md`
 4. Execute step by step
-5. Review and update docs (2-pass validation)
+5. Validate (fill in validate.md, harvest lessons if anything surprised you)
 
 💡 Tip: Use `atris brainstorm` if you're exploring options. Use `atris plan` when ready to build.
 

package/atris/atris.md

@@ -91,9 +91,9 @@ Stage: PLAN → do → review   (capitalize current stage)
 plan → do → review
 ```
 
-- **PLAN** — ASCII visualization, get approval, NO code yet
-- **DO** — Execute step-by-step, update journal
-- **REVIEW** — Test, validate, clean up, delete completed tasks
+- **PLAN** — ASCII visualization, get approval, NO code yet. Create `atris/features/[name]/idea.md` + `build.md` + `validate.md` for substantial work.
+- **DO** — Execute build.md step-by-step, update journal
+- **REVIEW** — Fill in validate.md, test, clean up. If anything surprised you, append to `atris/lessons.md`.
 
 ---
 
@@ -141,6 +141,7 @@ Specs loaded at activate from `team/*.md`
 |------|---------|
 | `MAP.md` | Where is X? (navigation) |
 | `TODO.md` | Task queue (target: 0) |
+| `lessons.md` | What we learned (append-only, read by navigator, written by validator) |
 | `logs/YYYY/MM-DD.md` | Journal (daily) |
 | `PERSONA.md` | Communication style |
 | `team/` | Agent behaviors |

package/atris/features/README.md

@@ -10,15 +10,18 @@ Each feature gets its own folder:
 
 ```
 atris/features/
-├── _templates/           # Templates for new features
-│   ├── idea.md.template  # Problem, solution, visualization
-│   └── build.md.template # Step-by-step build instructions
+├── _templates/               # Templates for new features
+│   ├── idea.md.template      # Problem, solution, visualization
+│   ├── build.md.template     # Step-by-step build instructions
+│   └── validate.md.template  # Proof it works (or didn't)
 ├── feature-name-1/
-│   ├── idea.md           # Why we're building this
-│   └── build.md          # How to build it
+│   ├── idea.md               # Why we're building this
+│   ├── build.md              # How to build it
+│   └── validate.md           # Proof it works
 └── feature-name-2/
     ├── idea.md
-    └── build.md
+    ├── build.md
+    └── validate.md
 ```
 
 ---
@@ -30,7 +33,7 @@ atris/features/
 Run `atris` or `atris plan` and describe what you want. The agent will:
 1. Show visualization
 2. Wait for approval
-3. Create the feature folder with idea.md + build.md
+3. Create the feature folder with idea.md + build.md + validate.md
 
 ### Manual
 
@@ -41,31 +44,33 @@ If you want to create a feature manually:
 mkdir atris/features/your-feature-name
 cp atris/features/_templates/idea.md.template atris/features/your-feature-name/idea.md
 cp atris/features/_templates/build.md.template atris/features/your-feature-name/build.md
+cp atris/features/_templates/validate.md.template atris/features/your-feature-name/validate.md
 
 # Fill in the templates
 # Edit idea.md (problem, solution, visualization)
 # Edit build.md (step-by-step implementation)
+# Edit validate.md (proof it works — filled by validator)
 ```
 
 ---
 
 ## Workflow
 
-**Navigator Agent:**
+**Navigator Agent (idea.md):**
 1. Shows visualization
 2. Gets approval
-3. Creates `idea.md` + `build.md`
+3. Creates `idea.md` + `build.md` + `validate.md` (from templates)
 4. Adds entry to this README
 
-**Executor Agent:**
+**Executor Agent (build.md):**
 1. Reads `build.md`
 2. Executes step by step
 3. Updates status as work progresses
 
-**Validator Agent:**
-1. Verifies build matches spec
-2. Runs tests
-3. Updates status to "complete"
+**Validator Agent (validate.md):**
+1. Fills in `validate.md` — runs every check, records pass/fail
+2. If all pass → status "complete", lessons learned to journal
+3. If any fail → status stays "in-progress", lessons learned to journal
 4. Updates MAP.md if needed
 
 ---
@@ -74,12 +79,33 @@ cp atris/features/_templates/build.md.template atris/features/your-feature-name/
 
 ### Active Features
 
-(No active features in development)
+#### audit-gaps
+Close remaining audit gaps from self-audit
+- **Files:** atris/team/*.md, atris/features/README.md
+- **Status:** complete
+- **Keywords:** audit, persona, cleanup
+- **What:** Add PERSONA.md reference to all 5 agent specs, clean up stale feature statuses
 
 ---
 
 ### Completed Features
 
+#### self-improving-loop
+Make Atris recursive — validate.md lessons feed back into the next idea.md
+- **Files:** atris/lessons.md (new), atris.md, atris/team/navigator.md, atris/team/validator.md, atris/MAP.md
+- **Status:** complete
+- **Keywords:** recursion, lessons, feedback-loop, self-improving, lessons.md
+- **What:** lessons.md accumulates validated learnings; navigator reads them before planning; validator harvests them after validating
+- **Completed:** 2026-02-09
+
+#### wire-the-loop
+Connect lessons.md and validate.md to every CLI command and doc that references them
+- **Files:** commands/init.js, commands/workflow.js, commands/status.js, bin/atris.js, GETTING_STARTED.md, README.md, atris/atris.md
+- **Status:** complete
+- **Keywords:** wiring, cli, docs, lessons, validate, init, plan, review, status
+- **What:** 8 surgical edits to wire lessons.md and validate.md into init, plan, review, status, docs, and spec
+- **Completed:** 2026-02-09
+
 #### brainstorm — v2.0.0
 Conversational exploration mode for uncertain ideas
 - **Files:** bin/atris.js, atris/atris.md, atris/PERSONA.md, GETTING_STARTED.md, README.md, atris/MAP.md

package/atris/skills/README.md

@@ -29,14 +29,40 @@ cp -r atris/skills/[name] ~/.codex/skills/
 | autopilot | PRD-driven autonomous execution | — |
 | backend | Backend architecture anti-patterns | `policies/atris-backend.md` |
 | design | Frontend aesthetics policy | `policies/atris-design.md` |
+| calendar | Google Calendar integration via AtrisOS | — |
+| drive | Google Drive + Sheets integration via AtrisOS | — |
 | email-agent | Gmail integration via AtrisOS | — |
 | memory | Context and memory management | — |
 | meta | Metacognition for agents | `policies/LESSONS.md` |
 | writing | Essay process with gates | `policies/writing.md` |
 | copy-editor | Detects and fixes AI writing patterns | - |
+| skill-improver | Audit and improve skills against Anthropic guide | — |
+
+## ClawHub (External Distribution)
+
+Skills we publish to OpenClaw's ClawHub marketplace. These have YAML frontmatter and are formatted for external agents.
+
+| Skill | Description | Status |
+|-------|-------------|--------|
+| clawhub/atris | Codebase intelligence — MAP.md navigation for any agent | Ready to publish |
+
+```bash
+# Publish to ClawHub
+clawhub publish atris/skills/clawhub/atris --slug atris --name "Atris" --version 1.0.0
+```
+
+## Managing Skills
+
+```bash
+atris skill list              # Show all skills with compliance status
+atris skill audit [name|--all]  # Validate against Anthropic skill guide
+atris skill fix [name|--all]    # Auto-fix common issues
+```
 
 ## Creating Skills
 
 1. Create `atris/skills/[name]/SKILL.md`
-2. Create `atris/policies/[name].md` (optional)
-3. Install to your agent (see Integration above)
+2. Run `atris skill audit [name]` to validate
+3. Create `atris/policies/[name].md` (optional)
+4. Install to your agent (see Integration above)
+5. For external distribution, put in `atris/skills/clawhub/[name]/`

package/atris/skills/atris/SKILL.md

@@ -1,6 +1,13 @@
 ---
 name: atris
 description: Atris workflow enforcement for repos using atris/ (MAP, TODO, journal, features, plan-do-review, anti-slop). Use when the user asks to follow the Atris system or mentions atris, MAP.md, TODO.md, journal/logs, features, plan/do/review, or anti-slop policies.
+version: 1.0.0
+tags:
+  - atris
+  - workflow
+  - memory
+  - navigation
+  - anti-slop
 ---
 
 # Atris Skill

package/atris/skills/autopilot/SKILL.md

@@ -1,7 +1,11 @@
 ---
 name: autopilot
-description: PRD-driven autonomous execution - give it a task, it loops until done
-triggers: [autopilot, autonomous, "get it done", "finish this", "ship it"]
+description: PRD-driven autonomous execution - give it a task, it loops until done Triggers on "autopilot", "autonomous", "get it done", "finish this", "ship it".
+version: 1.0.0
+tags:
+  - autopilot
+  - workflow
+  - automation
 ---
 
 # Autopilot Skill
@@ -42,7 +46,7 @@ Autonomous task execution. Plan → Do → Review loop until acceptance criteria
 │     │ REVIEW: Validator checks             │          │
 │     │   - Check acceptance criteria        │          │
 │     │   - If fail: [REVIEW_FAILED] reason  │          │
-│     │   - If pass: <promise>COMPLETE</promise>        │
+│     │   - If pass: [COMPLETE]        │
 │     └──────────────────────────────────────┘          │
 │                                                       │
 │  3. OUTPUT                                            │
@@ -84,7 +88,7 @@ atris autopilot "Add feature" --iterations=3 --verbose
 
 ## Stop Conditions
 
-1. `<promise>COMPLETE</promise>` — All acceptance criteria met
+1. `[COMPLETE]` — All acceptance criteria met
 2. Max iterations reached (default: 5)
 3. Error that can't be recovered
 

package/atris/skills/backend/SKILL.md

@@ -1,7 +1,12 @@
 ---
-name: atris-backend
+name: backend
 description: Backend architecture policy. Use when building APIs, services, data access, or any backend work. Prevents over-engineering.
+version: 1.0.0
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+tags:
+  - backend
+  - architecture
+  - anti-patterns
 ---
 
 # atris-backend

package/atris/skills/calendar/SKILL.md

@@ -0,0 +1,301 @@
+---
+name: calendar
+description: Google Calendar integration via AtrisOS API. View, create, and manage calendar events. Use when user asks about calendar, schedule, meetings, or events.
+version: 1.0.0
+tags:
+  - calendar
+  - backend
+  - google-calendar
+---
+
+# Calendar Agent
+
+> Drop this in `~/.claude/skills/calendar/SKILL.md` and Claude Code becomes your calendar assistant.
+
+## Bootstrap (ALWAYS Run First)
+
+Before any calendar operation, run this bootstrap to ensure everything is set up:
+
+```bash
+#!/bin/bash
+set -e
+
+# 1. Check if atris CLI is installed
+if ! command -v atris &> /dev/null; then
+  echo "Installing atris CLI..."
+  npm install -g atris
+fi
+
+# 2. Check if logged in to AtrisOS
+if [ ! -f ~/.atris/credentials.json ]; then
+  echo "Not logged in to AtrisOS."
+  echo ""
+  echo "Option 1 (interactive): Run 'atris login' and follow prompts"
+  echo "Option 2 (non-interactive): Get token from https://atris.ai/auth/cli"
+  echo "                           Then run: atris login --token YOUR_TOKEN"
+  echo ""
+  exit 1
+fi
+
+# 3. Extract token (try node first, then python3, then jq)
+if command -v node &> /dev/null; then
+  TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+elif command -v python3 &> /dev/null; then
+  TOKEN=$(python3 -c "import json,os; print(json.load(open(os.path.expanduser('~/.atris/credentials.json')))['token'])")
+elif command -v jq &> /dev/null; then
+  TOKEN=$(jq -r '.token' ~/.atris/credentials.json)
+else
+  echo "Error: Need node, python3, or jq to read credentials"
+  exit 1
+fi
+
+# 4. Check Google Calendar connection status (also validates token)
+STATUS=$(curl -s "https://api.atris.ai/api/integrations/google-calendar/status" \
+  -H "Authorization: Bearer $TOKEN")
+
+# Check for token expiry
+if echo "$STATUS" | grep -q "Token expired\|Not authenticated"; then
+  echo "Token expired. Please re-authenticate:"
+  echo "  Run: atris login --force"
+  exit 1
+fi
+
+# Parse connected status
+if command -v node &> /dev/null; then
+  CONNECTED=$(node -e "try{console.log(JSON.parse('$STATUS').connected||false)}catch(e){console.log(false)}")
+elif command -v python3 &> /dev/null; then
+  CONNECTED=$(echo "$STATUS" | python3 -c "import sys,json; print(json.load(sys.stdin).get('connected', False))")
+else
+  CONNECTED=$(echo "$STATUS" | jq -r '.connected // false')
+fi
+
+if [ "$CONNECTED" != "true" ] && [ "$CONNECTED" != "True" ]; then
+  echo "Google Calendar not connected. Getting authorization URL..."
+  AUTH=$(curl -s -X POST "https://api.atris.ai/api/integrations/google-calendar/start" \
+    -H "Authorization: Bearer $TOKEN" \
+    -H "Content-Type: application/json" \
+    -d '{"redirect_uri":"https://api.atris.ai/api/integrations/google-calendar/callback"}')
+
+  if command -v node &> /dev/null; then
+    URL=$(node -e "try{console.log(JSON.parse('$AUTH').auth_url||'')}catch(e){console.log('')}")
+  elif command -v python3 &> /dev/null; then
+    URL=$(echo "$AUTH" | python3 -c "import sys,json; print(json.load(sys.stdin).get('auth_url', ''))")
+  else
+    URL=$(echo "$AUTH" | jq -r '.auth_url // empty')
+  fi
+
+  echo ""
+  echo "Open this URL to connect your Google Calendar:"
+  echo "$URL"
+  echo ""
+  echo "After authorizing, run your calendar command again."
+  exit 0
+fi
+
+echo "Ready. Google Calendar is connected."
+export ATRIS_TOKEN="$TOKEN"
+```
+
+**Important**: Run this script ONCE before calendar operations. If it exits with instructions, follow them, then run again.
+
+---
+
+## API Reference
+
+Base: `https://api.atris.ai/api/integrations`
+
+All requests require: `-H "Authorization: Bearer $TOKEN"`
+
+### Get Token (after bootstrap)
+```bash
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+```
+
+### List Events
+```bash
+# Next 7 days (default)
+curl -s "https://api.atris.ai/api/integrations/google-calendar/events" \
+  -H "Authorization: Bearer $TOKEN"
+
+# Next N days
+curl -s "https://api.atris.ai/api/integrations/google-calendar/events?days=14" \
+  -H "Authorization: Bearer $TOKEN"
+
+# Custom date range (ISO 8601)
+curl -s "https://api.atris.ai/api/integrations/google-calendar/events?time_min=2026-02-15T00:00:00Z&time_max=2026-02-16T00:00:00Z" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Get Today's Events
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-calendar/events/today" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Get Single Event
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-calendar/events/{event_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Create Event
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/google-calendar/events" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "summary": "Meeting with Sushanth",
+    "start": "2026-02-15T14:00:00-08:00",
+    "end": "2026-02-15T15:00:00-08:00",
+    "description": "Discuss AI transformation roadmap",
+    "location": "Zoom",
+    "attendees": ["sushanth@pallet.com"],
+    "timezone": "America/Los_Angeles"
+  }'
+```
+
+**IMPORTANT:** Use `POST` to create events. Do NOT use `PUT` — that is for updating existing events.
+
+### Update Event
+```bash
+curl -s -X PUT "https://api.atris.ai/api/integrations/google-calendar/events/{event_id}" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "summary": "Updated meeting title",
+    "start": "2026-02-15T15:00:00-08:00",
+    "end": "2026-02-15T16:00:00-08:00",
+    "timezone": "America/Los_Angeles"
+  }'
+```
+
+### Delete Event
+```bash
+curl -s -X DELETE "https://api.atris.ai/api/integrations/google-calendar/events/{event_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Check Connection Status
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-calendar/status" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Disconnect Google Calendar
+```bash
+curl -s -X DELETE "https://api.atris.ai/api/integrations/google-calendar" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+---
+
+## Workflows
+
+### "What's on my calendar today?"
+1. Run bootstrap
+2. Get events: `GET /google-calendar/events/today`
+3. Display events sorted by start time: time, title, location
+4. If no events: "Your calendar is clear today."
+
+### "What's my schedule this week?"
+1. Run bootstrap
+2. Get events: `GET /google-calendar/events?days=7`
+3. Group by day, display each day's events
+
+### "Schedule a meeting with X"
+1. Run bootstrap
+2. Create event: `POST /google-calendar/events` with summary, start, end, attendees
+3. Confirm: "Meeting created! [link]"
+
+### "Do I have any meetings this afternoon?"
+1. Run bootstrap
+2. Get events: `GET /google-calendar/events/today`
+3. Filter events where start time is after 12:00 PM in user's timezone
+4. Display matching events or "No meetings this afternoon."
+
+### "When is my next meeting?"
+1. Run bootstrap
+2. Get events: `GET /google-calendar/events/today`
+3. Find the next event after current time
+4. Display: "Your next meeting is [title] at [time]" or "No more meetings today."
+
+### "Cancel my 3pm meeting"
+1. Run bootstrap
+2. List events: `GET /google-calendar/events/today`
+3. Find event at 3pm
+4. **Confirm with user** before deleting
+5. Delete: `DELETE /google-calendar/events/{event_id}`
+
+---
+
+## Display Format
+
+When showing calendar events, use this format:
+
+```
+Today's Schedule (Feb 15, 2026)
+
+  9:00 AM - 9:30 AM   Team Standup
+                       Google Meet
+
+ 10:00 AM - 11:00 AM  Product Review
+                       Conference Room B
+                       with alice@example.com, bob@example.com
+
+  1:00 PM - 1:30 PM   1:1 with Manager
+                       Zoom
+
+3 events today
+```
+
+**Rules:**
+- Sort by start time
+- Show location if available
+- Show attendees if available (max 3, then "and N more")
+- Use 12-hour format with AM/PM
+- For all-day events, show "All day" instead of times
+
+---
+
+## Error Handling
+
+| Error | Meaning | Solution |
+|-------|---------|----------|
+| `Token expired` | AtrisOS session expired | Run `atris login` |
+| `Calendar not connected` | OAuth not completed | Re-run bootstrap, complete OAuth flow |
+| `401 Unauthorized` | Invalid/expired token | Run `atris login` |
+| `400 Calendar not connected` | No calendar credentials | Complete OAuth via bootstrap |
+| `429 Rate limited` | Too many requests | Wait 60s, retry |
+| `Invalid grant` | Google revoked access | Re-connect calendar via bootstrap |
+
+---
+
+## Security Model
+
+1. **Local token** (`~/.atris/credentials.json`): Your AtrisOS auth token, stored locally with 600 permissions.
+
+2. **Calendar credentials**: Your Google Calendar refresh token is stored **server-side** in AtrisOS encrypted vault. Never stored on your local machine.
+
+3. **Access control**: AtrisOS API enforces that you can only access your own calendar. No cross-user access possible.
+
+4. **OAuth scopes**: Only requests necessary Calendar permissions (read events, manage events).
+
+5. **HTTPS only**: All API communication encrypted in transit.
+
+---
+
+## Quick Reference
+
+```bash
+# Setup (one time)
+npm install -g atris && atris login
+
+# Get token
+TOKEN=$(node -e "console.log(require('$HOME/.atris/credentials.json').token)")
+
+# Check connection
+curl -s "https://api.atris.ai/api/integrations/google-calendar/status" -H "Authorization: Bearer $TOKEN"
+
+# Today's events
+curl -s "https://api.atris.ai/api/integrations/google-calendar/events/today" -H "Authorization: Bearer $TOKEN"
+```