atris 2.2.0 → 2.2.2

package/atris/skills/clawhub/atris/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: atris
+description: Codebase intelligence — generates structured navigation maps with file:line references so agents stop re-scanning the same files every session. Use when exploring code, answering "where is X?", or onboarding to a new codebase.
+version: 1.1.0
+requires:
+  bins:
+    - rg
+tags:
+  - developer-tools
+  - codebase-navigation
+  - token-optimization
+  - code-map
+  - context-management
+---
+
+# Atris — Codebase Intelligence
+
+Maintain a structured map of the codebase with exact file:line references. One scan, permanent knowledge. Saves 80-95% of tokens on code exploration.
+
+## Scope
+
+- Use in any repo where you need to navigate code.
+- Creates `atris/MAP.md` as the single navigation index.
+
+## MAP-first rule
+
+Before searching for anything in the codebase:
+
+1. Read `atris/MAP.md`
+2. Found your keyword → go directly to file:line. Done.
+3. Not found → search once with `rg`, then **add the result to MAP.md**
+
+The map gets smarter every time you use it. Never let a discovery go unrecorded.
+
+## First time setup
+
+If `atris/MAP.md` doesn't exist, generate it:
+
+1. Create `atris/` folder in the project root
+2. Scan the codebase (rules below)
+3. Write the result to `atris/MAP.md`
+4. Tell the user: "Built your codebase map at atris/MAP.md."
+
+If `atris/MAP.md` already exists, use it. Regenerate only if the user requests it or the map is clearly stale (references missing files, line numbers way off).
+
+## How to scan
+
+Skip: `node_modules`, `.git`, `dist`, `build`, `vendor`, `__pycache__`, `.venv`, `.env*`, `*.key`, `*.pem`, `credentials*`, `secrets*`
+
+Use ripgrep to extract structure:
+
+```bash
+# Key definitions
+rg "^(export|function|class|const|def |async def |router\.|app\.|@app\.)" --line-number -g "!node_modules" -g "!.git" -g "!dist" -g "!.env*"
+
+# Route definitions
+rg "(get|post|put|delete|patch)\s*\(" --line-number -g "*.ts" -g "*.js" -g "*.py"
+
+# Entry points
+rg "listen|createServer|app\.start|if __name__" --line-number
+```
+
+## MAP.md structure
+
+```markdown
+# MAP.md — [Project Name] Navigation Guide
+
+> Generated by Atris | Last updated: YYYY-MM-DD
+
+## Quick Reference
+
+rg "functionName" path/to/file.ext    # Description (line N)
+rg "className" path/to/file.ext       # Description (line N)
+```
+
+Extract the top 15-25 most important symbols: entry points, exports, route handlers, main classes, config loaders.
+
+### By-Feature Map
+
+Group code by what it does. Every reference includes exact file path and line numbers.
+
+```markdown
+### Feature: User Authentication
+**Purpose:** Login, registration, token management
+- **Entry:** `src/auth/login.ts:45-89` (handleLogin)
+- **Validation:** `src/auth/validate.ts:12-67` (validateToken)
+- **Model:** `src/models/user.ts:8-34` (User schema)
+- **Routes:** `src/routes/auth.ts:5-28` (POST /login, POST /register)
+```
+
+### By-Concern Map
+
+Group by cross-cutting patterns (error handling, logging, auth middleware, etc).
+
+### Critical Files
+
+Flag high-impact files with why they matter and key functions with line numbers.
+
+### Entry Points
+
+How execution flows — dev server startup, request lifecycle, build pipeline.
+
+## Keeping it fresh
+
+Update MAP.md surgically when the codebase changes:
+
+- **New file** → add to relevant section
+- **Moved/renamed** → update all references
+- **New important function** → add to Quick Reference
+- **Deleted file** → remove from map
+- **Major refactor** → regenerate affected sections
+
+Small updates, not full regeneration. The map evolves with the code.
+
+## Anti-patterns
+
+- Searching without checking MAP first
+- Letting discoveries go unrecorded
+- Regenerating the full map when a surgical update would do
+- Including secrets, credentials, or .env files in the map
+- Guessing file locations instead of using the index

package/atris/skills/copy-editor/SKILL.md

@@ -1,13 +1,12 @@
 ---
 name: copy-editor
-description: Detects AI writing patterns and fixes them. Use when reviewing any written output, including docs, READMEs, messages, PRDs. Based on Wikipedia's AI Cleanup patterns.
-triggers:
-  - copy edit
-  - review writing
-  - humanize
-  - deslopper
-  - ai patterns
-  - make it sound human
+description: Detects AI writing patterns and fixes them. Use when reviewing any written output, including docs, READMEs, messages, PRDs. Based on Wikipedia's AI Cleanup patterns. Triggers on "copy edit", "review writing", "humanize", "deslopper", "ai patterns", "make it sound human".
+version: 1.0.0
+tags:
+  - copy-editor
+  - writing
+  - anti-slop
+  - quality
 ---
 
 # Copy Editor: Remove AI Writing Patterns

package/atris/skills/design/SKILL.md

@@ -1,7 +1,11 @@
 ---
-name: atris-design
+name: design
 description: Frontend aesthetics policy. Use when building UI, components, landing pages, dashboards, or any frontend work. Prevents generic ai-generated look.
+version: 1.0.0
 allowed-tools: Read, Write, Edit, Bash, Glob
+tags:
+  - design
+  - frontend
 ---
 
 # atris-design

package/atris/skills/drive/SKILL.md

@@ -0,0 +1,363 @@
+---
+name: drive
+description: Google Drive integration via AtrisOS API. Browse, search, read, upload files and work with Google Sheets. Use when user asks about Drive, files, docs, sheets, or spreadsheets.
+version: 1.1.0
+tags:
+  - drive
+  - backend
+  - google-drive
+  - sheets
+---
+
+# Drive Agent
+
+> Drop this in `~/.claude/skills/drive/SKILL.md` and Claude Code becomes your Google Drive assistant.
+
+## Bootstrap (ALWAYS Run First)
+
+Before any Drive 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
+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 Drive connection status
+STATUS=$(curl -s "https://api.atris.ai/api/integrations/google-drive/status" \
+  -H "Authorization: Bearer $TOKEN")
+
+if echo "$STATUS" | grep -q "Token expired\|Not authenticated"; then
+  echo "Token expired. Please re-authenticate:"
+  echo "  Run: atris login --force"
+  exit 1
+fi
+
+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 Drive not connected. Getting authorization URL..."
+  AUTH=$(curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/start" \
+    -H "Authorization: Bearer $TOKEN" \
+    -H "Content-Type: application/json" \
+    -d '{}')
+
+  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 Drive:"
+  echo "$URL"
+  echo ""
+  echo "After authorizing, run your command again."
+  exit 0
+fi
+
+echo "Ready. Google Drive is connected."
+export ATRIS_TOKEN="$TOKEN"
+```
+
+---
+
+## 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 Shared Drives
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/shared-drives" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+Returns all shared/team drives the user has access to with `id` and `name`.
+
+### List Files
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/files?page_size=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**List files in a folder:**
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/files?folder_id=FOLDER_ID&page_size=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**List files in a shared drive:**
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/files?shared_drive_id=DRIVE_ID&page_size=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**NOTE:** All file operations (list, search, get, download, export) automatically include shared drive files. Use `shared_drive_id` only to scope results to a specific shared drive.
+
+### Search Files
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/search?q=quarterly+report&page_size=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+Simple queries search by file name. For advanced queries, use Drive query syntax:
+- `name contains 'budget'` — name search
+- `mimeType = 'application/vnd.google-apps.spreadsheet'` — only sheets
+- `mimeType = 'application/vnd.google-apps.document'` — only docs
+- `modifiedTime > '2026-01-01'` — recently modified
+
+### Get File Metadata
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/files/{file_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Download File
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/files/{file_id}/download" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+Returns base64-encoded content. For Google Docs/Sheets/Slides, use export instead.
+
+### Export Google Docs/Sheets/Slides
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/files/{file_id}/export?mime_type=text/plain" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**Export formats:**
+- `text/plain` — plain text (default, good for Docs)
+- `text/html` — HTML
+- `application/pdf` — PDF
+- `text/csv` — CSV (for Sheets)
+
+### Upload File
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/files" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "notes.txt",
+    "content": "File content here",
+    "mime_type": "text/plain"
+  }'
+```
+
+**Upload to a specific folder:**
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/files" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "report.txt",
+    "content": "File content here",
+    "mime_type": "text/plain",
+    "folder_id": "FOLDER_ID"
+  }'
+```
+
+---
+
+## Google Sheets
+
+Full read/write access to Google Sheets.
+
+### Get Spreadsheet Info
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/sheets/{spreadsheet_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+Returns sheet names, title, and metadata.
+
+### Read Cells
+```bash
+curl -s "https://api.atris.ai/api/integrations/google-drive/sheets/{spreadsheet_id}/values?range=Sheet1" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**Range uses A1 notation:**
+- `Sheet1` — entire sheet
+- `Sheet1!A1:D10` — specific range
+- `Sheet1!A:A` — entire column A
+- `Sheet1!1:1` — entire row 1
+
+### Update Cells
+```bash
+curl -s -X PUT "https://api.atris.ai/api/integrations/google-drive/sheets/{spreadsheet_id}/values" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "range": "Sheet1!A1:B2",
+    "values": [
+      ["Name", "Score"],
+      ["Alice", 95]
+    ]
+  }'
+```
+
+### Append Rows
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/sheets/{spreadsheet_id}/append" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "range": "Sheet1",
+    "values": [
+      ["Bob", 88],
+      ["Carol", 92]
+    ]
+  }'
+```
+
+---
+
+## Workflows
+
+### "Find a file in my Drive"
+1. Run bootstrap
+2. Search: `GET /google-drive/search?q=QUERY`
+3. Display: name, type, modified date for each result
+
+### "Read a Google Doc"
+1. Run bootstrap
+2. Search for the doc: `GET /google-drive/search?q=DOC_NAME`
+3. Export as text: `GET /google-drive/files/{id}/export?mime_type=text/plain`
+4. Display content
+
+### "Read a spreadsheet"
+1. Run bootstrap
+2. Search for the sheet: `GET /google-drive/search?q=SHEET_NAME`
+3. Get sheet info: `GET /google-drive/sheets/{id}` (to see sheet names)
+4. Read values: `GET /google-drive/sheets/{id}/values?range=Sheet1`
+5. Display as a table
+
+### "Add rows to a spreadsheet"
+1. Run bootstrap
+2. Find the sheet
+3. Read current data to understand the columns: `GET /google-drive/sheets/{id}/values?range=Sheet1!1:1`
+4. **Show user what will be appended, get approval**
+5. Append: `POST /google-drive/sheets/{id}/append`
+
+### "Browse a shared drive"
+1. Run bootstrap
+2. List shared drives: `GET /google-drive/shared-drives`
+3. Display drive names and IDs
+4. List files in chosen drive: `GET /google-drive/files?shared_drive_id=DRIVE_ID`
+
+### "Find a file across all drives"
+1. Run bootstrap
+2. Search: `GET /google-drive/search?q=QUERY` (automatically searches My Drive + all shared drives)
+3. Display results
+
+### "Upload a file to Drive"
+1. Run bootstrap
+2. Read the local file content
+3. **Confirm with user**: "Upload {filename} to Drive?"
+4. Upload: `POST /google-drive/files` with `{name, content, mime_type}`
+
+---
+
+## Error Handling
+
+| Error | Meaning | Solution |
+|-------|---------|----------|
+| `Token expired` | AtrisOS session expired | Run `atris login` |
+| `Google Drive not connected` | OAuth not completed | Re-run bootstrap |
+| `401 Unauthorized` | Invalid/expired token | Run `atris login` |
+| `400 Drive not connected` | No Drive credentials | Complete OAuth via bootstrap |
+| `429 Rate limited` | Too many requests | Wait 60s, retry |
+| `Invalid grant` | Google revoked access | Re-connect via bootstrap |
+
+---
+
+## Security Model
+
+1. **Local token** (`~/.atris/credentials.json`): Your AtrisOS auth token, stored locally with 600 permissions.
+2. **Drive credentials**: Google Drive refresh token is stored **server-side** in AtrisOS encrypted vault.
+3. **Access control**: AtrisOS API enforces that you can only access your own Drive.
+4. **OAuth scopes**: Only requests necessary Drive permissions (read, write files).
+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-drive/status" -H "Authorization: Bearer $TOKEN"
+
+# List shared drives
+curl -s "https://api.atris.ai/api/integrations/google-drive/shared-drives" -H "Authorization: Bearer $TOKEN"
+
+# List files (includes shared drive files)
+curl -s "https://api.atris.ai/api/integrations/google-drive/files" -H "Authorization: Bearer $TOKEN"
+
+# Search files
+curl -s "https://api.atris.ai/api/integrations/google-drive/search?q=budget" -H "Authorization: Bearer $TOKEN"
+
+# Read a Google Doc as text
+curl -s "https://api.atris.ai/api/integrations/google-drive/files/{file_id}/export?mime_type=text/plain" -H "Authorization: Bearer $TOKEN"
+
+# Read a spreadsheet
+curl -s "https://api.atris.ai/api/integrations/google-drive/sheets/{id}/values?range=Sheet1" -H "Authorization: Bearer $TOKEN"
+
+# Append rows to a sheet
+curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/sheets/{id}/append" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"range":"Sheet1","values":[["Alice",95]]}'
+
+# Upload a file
+curl -s -X POST "https://api.atris.ai/api/integrations/google-drive/files" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"name":"notes.txt","content":"Hello world","mime_type":"text/plain"}'
+```

package/atris/skills/email-agent/SKILL.md

@@ -1,6 +1,11 @@
 ---
 name: email-agent
 description: Gmail integration via AtrisOS API. Read, send, archive emails. Use when user asks about email, inbox, or wants to send/check messages.
+version: 1.1.0
+tags:
+  - email-agent
+  - backend
+  - email
 ---
 
 # Email Agent
@@ -166,6 +171,58 @@ curl -s -X POST "https://api.atris.ai/api/integrations/gmail/send" \
   }'
 ```
 
+### Drafts
+
+**List drafts:**
+```bash
+curl -s "https://api.atris.ai/api/integrations/gmail/drafts?max_results=20" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**Read a draft:**
+```bash
+curl -s "https://api.atris.ai/api/integrations/gmail/drafts/{draft_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**Create a draft:**
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/drafts" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "to": "recipient@example.com",
+    "subject": "Subject line",
+    "body": "Draft body text"
+  }'
+```
+
+Supports same fields as send: `cc`, `bcc`, `attachments`, plus `thread_id` to attach to an existing thread.
+
+**Update a draft:**
+```bash
+curl -s -X PUT "https://api.atris.ai/api/integrations/gmail/drafts/{draft_id}" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "to": "recipient@example.com",
+    "subject": "Updated subject",
+    "body": "Updated body"
+  }'
+```
+
+**Send a draft:**
+```bash
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/drafts/{draft_id}/send" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**Delete a draft:**
+```bash
+curl -s -X DELETE "https://api.atris.ai/api/integrations/gmail/drafts/{draft_id}" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
 ### Archive Email
 ```bash
 # Single message
@@ -214,6 +271,25 @@ curl -s -X DELETE "https://api.atris.ai/api/integrations/gmail" \
 4. **Show user what will be archived, get approval**
 5. Batch archive: `POST /batch-archive`
 
+### "Show my drafts"
+1. Run bootstrap
+2. List drafts: `GET /gmail/drafts?max_results=20`
+3. Display: to, subject, snippet for each
+
+### "Draft an email to X about Y"
+1. Run bootstrap
+2. Compose email content
+3. **Show user the draft for review**
+4. On approval: `POST /gmail/drafts` with `{to, subject, body}`
+5. Confirm: "Draft saved! You can find it in Gmail."
+
+### "Send draft about X"
+1. Run bootstrap
+2. List drafts: `GET /gmail/drafts`
+3. Find matching draft by subject/recipient
+4. **Show user the draft content, confirm they want to send it**
+5. Send: `POST /gmail/drafts/{draft_id}/send`
+
 ### "Archive all from [sender]"
 1. Run bootstrap
 2. Search: `GET /messages?query=from:{sender}`
@@ -285,4 +361,16 @@ curl -s "https://api.atris.ai/api/integrations/gmail/messages?query=in:inbox&max
 curl -s -X POST "https://api.atris.ai/api/integrations/gmail/send" \
   -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
   -d '{"to":"email@example.com","subject":"Hi","body":"Hello!"}'
+
+# List drafts
+curl -s "https://api.atris.ai/api/integrations/gmail/drafts" -H "Authorization: Bearer $TOKEN"
+
+# Create draft
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/drafts" \
+  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
+  -d '{"to":"email@example.com","subject":"Hi","body":"Draft text"}'
+
+# Send a draft
+curl -s -X POST "https://api.atris.ai/api/integrations/gmail/drafts/{draft_id}/send" \
+  -H "Authorization: Bearer $TOKEN"
 ```

package/atris/skills/memory/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: memory
 description: Search and reason over Atris journal history. Use when user asks about past work, decisions, history, or patterns. Uses RLM pattern (grep first, reason second).
+version: 1.0.0
+tags:
+  - memory
 ---
 
 # Atris Memory Skill

package/atris/skills/meta/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: meta
 description: Metacognition skill for AI agents. Use when starting work, feeling stuck, output feels off, or before complex tasks. Teaches how to think about thinking.
+version: 1.0.0
+tags:
+  - meta
+  - metacognition
 ---
 
 # Meta Skill