@aitne-sh/aitne 0.1.6 → 0.1.8

package/agent-assets/docs/getting-started/03-what-can-this-do.md

@@ -3,6 +3,11 @@ schema_version: 1
 slug: getting-started/03-what-can-this-do
 title: What This App Can Do
 id: what-can-this-do
+aliases:
+  - what can it do
+  - capabilities
+  - feature tour
+  - what features exist
 category: getting-started
 summary: |
   A tour of Aitne's capabilities at a beginner-friendly
@@ -17,17 +22,25 @@ ask_examples:
   - What can Aitne actually do?
   - What features should I try first?
   - How does the agent reach out to me?
+  - Can the agent transcribe my voice messages?
+  - Can the agent build me a personal wiki?
 locale: en-US
+keywords:
+  - capabilities
+  - feature tour
+  - overview
+  - voice transcription
+  - wiki
+  - lifestyle
 created: 2026-04-27
-updated: 2026-05-04
+updated: 2026-05-15
 related:
   - getting-started/01-what-is-this
   - getting-started/02-first-steps
   - getting-started/04-first-day
   - concepts/routines
   - concepts/memory-model
-  - features/messaging/voice-attachments
-  - features/operations/skill-self-optimization
+  - features/messaging/overview
   - features/wiki/overview
   - features/wiki/commands
 ---
@@ -41,7 +54,7 @@ the doc that goes deep.
 
 The agent runs **routines** on a schedule. The morning routine builds
 `today.md` from your calendar, mail, tasks, and notes; the evening
-review writes a journal entry; weekly and monthly summaries roll up.
+review writes a journal entry; the weekly review rolls up the week.
 
 - [Routines](../concepts/routines.md) — what runs and when.
 - [Morning Routine](../features/routines/morning-routine.md)
@@ -55,9 +68,8 @@ something comes up. Voice notes are transcribed locally with Whisper
 so you can talk to it the same way you'd type.
 
 - [Messaging Overview](../features/messaging/overview.md) — supported
-  apps and how pairing works.
-- [Voice Attachments](../features/messaging/voice-attachments.md) —
-  local transcription of inbound audio.
+  apps, how pairing works, and how voice notes get transcribed
+  locally with Whisper.
 - [Dashboard Chat](../features/messaging/dashboard-chat.md) — the
   in-dashboard chat surface.
 
@@ -130,10 +142,8 @@ operations keep the agent from doing anything you don't want.
 A background self-optimization loop watches how your knowledge layout
 drifts (new folders, schema tweaks, vocabulary changes) and refines
 specific skill sections to match. The original SKILL.md files are
-never rewritten — overlays are reversible.
-
-- [Skill Self-Optimization](../features/operations/skill-self-optimization.md)
-  — the loop, the cadence, and the dashboard surface.
+never rewritten — overlays are reversible. The loop runs as a daemon
+observer; you can review its proposals from the dashboard.
 
 ## Related
 

package/agent-assets/docs/getting-started/04-first-day.md

@@ -8,11 +8,25 @@ summary: |
   Turn the freshly-installed agent into one that actually helps you —
   teach it about you, connect the tools you use, and describe the work
   you want it to do.
+aliases:
+  - first day
+  - onboarding day 1
+  - day one
+  - day zero
 section: getting-started
 tags:
   - core
   - getting-started
+  - setup
 status: stable
+keywords:
+  - first day
+  - onboarding
+  - import history
+  - chatgpt import
+  - integrations
+  - profile
+  - teach the agent
 ask_examples:
   - What should I do on my first day?
   - How do I make the agent useful?

package/agent-assets/docs/glossary.md

@@ -3,25 +3,47 @@ schema_version: 1
 slug: glossary
 title: Glossary
 id: glossary
+aliases:
+  - terms
+  - vocabulary
+  - lexicon
 category: glossary
 summary: |
   Single flat term list for Aitne vocabulary. Cross-references
   link to a single canonical anchor here so concept docs do not drift.
+tags:
+  - core
+  - reference
+  - glossary
 status: stable
 ask_examples:
   - What is a ProcessKey?
   - What does heavy tier mean?
   - What is the difference between light and heavy tiers?
+  - What is OpenCode?
+  - What is a routine pre-pass?
+  - What is the wiki workspace?
 locale: en-US
 created: 2026-04-25
-updated: 2026-04-25
+updated: 2026-05-15
 keywords:
   - terminology
   - vocabulary
   - glossary
+  - backend
+  - processkey
+  - tier
+  - opencode
+  - observation
+  - skill
+  - wiki workspace
 related:
   - concepts/agent-day
+  - concepts/backends-and-tiers
+  - concepts/process-keys
+  - concepts/observations
   - features/routines/morning-routine
+  - features/wiki/overview
 ---
 
 # Glossary
@@ -38,9 +60,10 @@ and rationale.
 ## Backend
 
 One of the model providers Aitne can dispatch to: `claude`
-(Claude Code SDK), `codex` (Codex CLI), or `gemini` (Gemini CLI). Each
-backend is configured per-installation; one is the **main backend**, and
-the others can be enabled as fallbacks.
+(Claude Code SDK), `codex` (Codex CLI), `gemini` (Gemini CLI), or
+`opencode` (`@opencode-ai/sdk` HTTP server). Each backend is configured
+per-installation; one is the **main backend**, and the others can be
+enabled as fallbacks.
 
 ## Backend Router
 
@@ -63,17 +86,47 @@ The hour-of-day at which the agent day rolls over. Configured via
 
 ## Heavy Tier
 
-The expensive, high-quality model lane on each backend (Claude Opus
-4.7, GPT-5.5, Gemini 3 Pro). Reserved by default for processes whose
-output quality directly drives the agent's daily decision-making —
-primarily `routine.morning_routine` and the one-shot
-`routine.morning_routine_initial` plus `setup`.
+Synonym for the **high** tier — the expensive, high-quality model lane
+on each backend (Claude Opus 4.7, GPT-5.5, Gemini 3 Pro, Opus 4.7 via
+OpenCode). Registered but not auto-selected on any routine: after
+`docs/design/appendices/morning-routine-optimization.md` Phase 7
+(2026-05-16) the only flows that default to this tier are `setup` and
+`knowledge.import`. Operators can pin any other process key to high
+per row from `/settings/models`.
 
 ## Light Tier
 
-The cheaper, fast model lane on each backend (Claude Sonnet 4.6,
-GPT-5.4-mini, Gemini 3 Flash). Default for owner DMs, dashboard chat,
-the hourly check, and the evening / weekly / monthly review routines.
+Operator-facing umbrella for the two non-heavy lanes on each backend:
+
+- **Medium / Main** (Claude Sonnet 4.6, GPT-5.4-mini, Gemini 3 Flash,
+  Sonnet 4.6 via OpenCode) — default for owner DMs, dashboard chat,
+  the hourly check, and the morning / evening / weekly review
+  routines.
+- **Lite / Delegated** (Claude Haiku 4.5 and equivalents) — reserved
+  for mechanical / delegated surfaces: Gmail classification, GitHub
+  triage, calendar-change handlers, the routine pre-pass fetcher,
+  the `delegated_task` invoker.
+
+## OpenCode
+
+The 4th backend (joined 2026-05). Implemented on top of
+`@opencode-ai/sdk`'s HTTP server. Operates in **Managed** mode (the
+daemon spawns a local loopback server) or **Remote** mode (operator
+points at an existing baseUrl). OpenCode dispatches the same
+ProcessKey set as Claude / Codex / Gemini but does not host
+native-mode integration connectors. Cost telemetry reads
+`session.info.cost` + `info.tokens` with a `MODEL_REGISTRY` pricing
+fallback when upstream reports zero.
+
+## Routine Pre-pass
+
+A lite-tier `routine.fetch_window` session spawned before each main
+routine (morning / today_refresh / hourly_check / evening / weekly).
+It fetches each routine's mail / calendar / Notion window
+(`ROUTINE_WINDOWS`) and POSTs the results to `/api/observations`. The
+main routine then consumes the resulting `<fetch_report>` block and
+pending observations instead of calling upstream APIs itself. Introduced
+in 2026-05 to trim morning-routine input tokens by ~24%.
 
 ## ProcessKey
 

package/agent-assets/docs/guides/add-a-custom-routine.md

@@ -3,6 +3,11 @@ schema_version: 1
 slug: guides/add-a-custom-routine
 title: Add a Custom Routine
 id: add-a-custom-routine
+aliases:
+  - custom routine
+  - user-defined routine
+  - add a routine
+  - scheduled task
 category: guides
 summary: |
   Define a new autonomous routine — slug, cron expression, tier, and
@@ -12,6 +17,7 @@ section: add-a-custom-routine
 tags:
   - guide
   - routines
+  - scheduler
 status: stable
 ask_examples:
   - How do I add a custom routine?
@@ -19,6 +25,12 @@ ask_examples:
 locale: en-US
 created: 2026-04-25
 updated: 2026-04-25
+keywords:
+  - custom routine
+  - schedule
+  - cron
+  - recurrence
+  - PUT /api/recurring-schedules
 related:
   - features/routines/custom-routines
   - concepts/routines

package/agent-assets/docs/guides/backup-and-restore.md

@@ -3,6 +3,11 @@ schema_version: 1
 slug: guides/backup-and-restore
 title: Backup and Restore
 id: backup-and-restore
+aliases:
+  - backup
+  - restore
+  - tarball backup
+  - context backup
 category: guides
 summary: |
   Aitne's data lives in two places — the SQLite database and
@@ -12,6 +17,7 @@ section: backup-and-restore
 tags:
   - guide
   - operations
+  - backup
 status: stable
 ask_examples:
   - How do I back up Aitne?
@@ -19,6 +25,14 @@ ask_examples:
 locale: en-US
 created: 2026-04-25
 updated: 2026-04-25
+keywords:
+  - backup
+  - restore
+  - tarball
+  - rsync
+  - git
+  - PA_DATA_DIR
+  - snapshot
 related:
   - guides/reinstall-cleanly
   - guides/migrate-machines
@@ -32,9 +46,9 @@ Capture all Aitne state in a tar that you can restore later.
 
 ## Steps
 
-1. `pa stop`.
+1. `aitne stop`.
 2. `tar -czf personal-agent-backup-$(date +%F).tgz ~/.personal-agent/`.
-3. To restore: extract the tar to your home directory, then `pa start`.
+3. To restore: extract the tar to your home directory, then `aitne start`.
 
 ## Verification
 

package/agent-assets/docs/guides/budget-and-cost-for-wiki.md

@@ -27,6 +27,12 @@ ask_examples:
 locale: en-US
 created: 2026-05-12
 updated: 2026-05-12
+keywords:
+  - wiki budget
+  - wiki cost
+  - wiki cost gate
+  - wiki approval
+  - compile cost
 related:
   - features/wiki/overview
   - features/wiki/commands

package/agent-assets/docs/guides/build-your-wiki.md

@@ -3,6 +3,11 @@ schema_version: 1
 slug: guides/build-your-wiki
 title: Build Your Wiki
 id: build-your-wiki
+aliases:
+  - build wiki
+  - wiki walkthrough
+  - first wiki
+  - ingest compile
 category: guides
 summary: |
   Enable the internal wiki, send your first URL, compile the raw
@@ -11,6 +16,7 @@ section: build-your-wiki
 tags:
   - guide
   - wiki
+  - knowledge
 status: stable
 ask_examples:
   - How do I start using the wiki?
@@ -18,6 +24,14 @@ ask_examples:
 locale: en-US
 created: 2026-05-12
 updated: 2026-05-12
+keywords:
+  - wiki
+  - build wiki
+  - !ingest
+  - !compile
+  - !ask
+  - workspace
+  - first day wiki
 related:
   - features/wiki/overview
   - features/wiki/commands

package/agent-assets/docs/guides/change-which-model-handles-x.md

@@ -14,12 +14,19 @@ section: change-which-model-handles-x
 tags:
   - guide
   - backends
+  - models
 status: stable
 ask_examples:
   - How do I make my morning routine use Sonnet instead of Opus?
 locale: en-US
 created: 2026-04-25
 updated: 2026-04-25
+keywords:
+  - per-process model
+  - /settings/models
+  - process binding
+  - tier override
+  - change model
 related:
   - guides/switch-default-backend
   - concepts/backends-and-tiers

package/agent-assets/docs/guides/connect-a-new-mail-account.md

@@ -3,6 +3,12 @@ schema_version: 1
 slug: guides/connect-a-new-mail-account
 title: Connect a New Mail Account
 id: connect-a-new-mail-account
+aliases:
+  - connect mail
+  - add mail account
+  - imap setup
+  - gmail setup
+  - outlook setup
 category: guides
 summary: |
   Add a Gmail / Outlook / Yahoo / iCloud account to the mail
@@ -11,6 +17,7 @@ section: connect-a-new-mail-account
 tags:
   - guide
   - mail
+  - integrations
 status: stable
 ask_examples:
   - How do I add another Gmail account?
@@ -18,6 +25,15 @@ ask_examples:
 locale: en-US
 created: 2026-04-25
 updated: 2026-04-25
+keywords:
+  - mail
+  - imap
+  - gmail
+  - outlook
+  - yahoo
+  - icloud
+  - mail provider
+  - OAuth
 related:
   - features/integrations/mail
 ---

package/agent-assets/docs/guides/explore-with-trace-and-connect.md

@@ -29,6 +29,12 @@ ask_examples:
 locale: en-US
 created: 2026-05-12
 updated: 2026-05-12
+keywords:
+  - !trace
+  - !connect
+  - wiki exploration
+  - topic history
+  - topic bridges
 related:
   - features/wiki/overview
   - features/wiki/commands

package/agent-assets/docs/guides/import-knowledge-file.md

@@ -3,6 +3,11 @@ schema_version: 1
 slug: guides/import-knowledge-file
 title: Import a Knowledge File
 id: import-knowledge-file
+aliases:
+  - import history
+  - import chatgpt
+  - import gemini
+  - knowledge import
 category: guides
 summary: |
   Upload a Markdown or text file of personal facts so the agent folds
@@ -27,6 +32,12 @@ created: 2026-04-28
 updated: 2026-04-28
 ui_anchors:
   - /knowledge
+keywords:
+  - import
+  - chatgpt history
+  - gemini history
+  - json import
+  - knowledge
 related:
   - concepts/memory-model
   - features/memory-files/user-profile

package/agent-assets/docs/guides/install-and-run.md

@@ -3,30 +3,46 @@ schema_version: 1
 slug: guides/install-and-run
 title: Install and Run
 id: install-and-run
+aliases:
+  - install
+  - installation
+  - first install
+  - first run
+  - get aitne running
 category: guides
 summary: |
-  Clone the repo, run pnpm install, run pnpm start. The daemon and
-  dashboard start in the background; the dashboard opens at :3000.
+  Install Aitne via the npm package (or clone the repo for development),
+  start the daemon and dashboard, and open the dashboard at :3000.
+section: install-and-run
 tags:
+  - core
+  - guide
+  - getting-started
   - install
   - setup
+  - operations
 status: stable
 ask_examples:
   - How do I install Aitne?
   - What command starts the daemon?
   - Where does Aitne put its data?
+  - How do I install the aitne npm package?
 locale: en-US
 created: 2026-04-25
-updated: 2026-04-27
+updated: 2026-05-15
 keywords:
   - install
   - first run
   - pnpm
-  - pa start
+  - npm install aitne
+  - aitne start
+  - PA_DATA_DIR
+  - node 22
 related:
   - reference/cli-commands
   - guides/reinstall-cleanly
   - guides/migrate-machines
+  - getting-started/02-first-steps
 ---
 
 # Install and Run

package/agent-assets/docs/guides/maintain-wiki-health.md

@@ -29,6 +29,12 @@ ask_examples:
 locale: en-US
 created: 2026-05-12
 updated: 2026-05-12
+keywords:
+  - wiki health
+  - wiki lint
+  - wiki maintenance
+  - wiki freshness
+  - orphan notes
 related:
   - features/wiki/overview
   - features/wiki/commands

package/agent-assets/docs/guides/migrate-machines.md

@@ -3,6 +3,11 @@ schema_version: 1
 slug: guides/migrate-machines
 title: Migrate Machines
 id: migrate-machines
+aliases:
+  - migrate
+  - move machines
+  - transfer install
+  - move install
 category: guides
 summary: |
   Move a Aitne install to a new machine — install the daemon,
@@ -11,12 +16,19 @@ section: migrate-machines
 tags:
   - guide
   - operations
+  - migration
 status: stable
 ask_examples:
   - Can I move Aitne to a new laptop?
 locale: en-US
 created: 2026-04-25
 updated: 2026-04-25
+keywords:
+  - migrate
+  - move install
+  - PA_DATA_DIR
+  - rsync
+  - second machine
 related:
   - guides/backup-and-restore
   - guides/reinstall-cleanly
@@ -31,7 +43,7 @@ context-file history.
 
 ## Steps
 
-1. On the old machine: `pa stop`.
+1. On the old machine: `aitne stop`.
 2. Copy `~/.personal-agent/context/` to the new machine.
 3. On the new machine: install per [Install and Run](install-and-run.md).
 4. Optionally copy `data/personal_agent.db` (skip if upgrading daemon versions).

package/agent-assets/docs/guides/multiple-wikis-for-multiple-domains.md

@@ -3,6 +3,10 @@ schema_version: 1
 slug: guides/multiple-wikis-for-multiple-domains
 title: Multiple Wikis for Multiple Domains
 id: multiple-wikis-for-multiple-domains
+aliases:
+  - multi-workspace wiki
+  - multiple workspaces
+  - domain wikis
 category: guides
 summary: |
   Run more than one wiki workspace inside the same daemon. Address
@@ -21,6 +25,11 @@ ask_examples:
 locale: en-US
 created: 2026-05-12
 updated: 2026-05-12
+keywords:
+  - multi-workspace
+  - wiki workspace
+  - default workspace
+  - @workspace token
 related:
   - features/wiki/overview
   - features/wiki/commands

package/agent-assets/docs/guides/pause-the-agent.md

@@ -14,6 +14,7 @@ section: pause-the-agent
 tags:
   - guide
   - operations
+  - messaging
 status: stable
 ask_examples:
   - How do I pause the agent without uninstalling?
@@ -21,6 +22,13 @@ ask_examples:
 locale: en-US
 created: 2026-04-25
 updated: 2026-04-25
+keywords:
+  - pause agent
+  - stop agent
+  - !stop
+  - !start
+  - disable autonomous
+  - go silent
 related:
   - features/operations/quiet-hours
   - features/messaging/bang-commands
@@ -45,14 +53,14 @@ losing your install.
    daemon keeps running so you can `!start` to resume. See
    [Bang Commands](../features/messaging/bang-commands.md).
 2. **Disable the hourly check** from `/settings/routines` — toggle
-   `hourlyCheckEnabled` off. Morning, evening, weekly, and monthly
-   reviews fire at fixed times in code, so they cannot be toggled
-   from the dashboard; the most reliable mute is `pa stop`.
+   `hourlyCheckEnabled` off. Morning, evening, and weekly reviews
+   fire at fixed times in code, so they cannot be toggled from the
+   dashboard; the most reliable mute is `aitne stop`.
 3. **Set an extended quiet hours window** on `/settings/schedule` —
    e.g. `quietHoursStart: "00:00"`, `quietHoursEnd: "23:59"`. Both
    fields take an `HH:MM` string. This silences notifications while
    keeping routines running.
-4. **Optionally** stop the daemon entirely with `pa stop`. This is
+4. **Optionally** stop the daemon entirely with `aitne stop`. This is
    the only way to fully suppress the fixed-schedule routines.
 
 ## Verification

package/agent-assets/docs/guides/reinstall-cleanly.md

@@ -3,6 +3,12 @@ schema_version: 1
 slug: guides/reinstall-cleanly
 title: Reinstall Cleanly
 id: reinstall-cleanly
+aliases:
+  - reinstall
+  - clean reinstall
+  - factory reset
+  - wipe data
+  - fresh install
 category: guides
 summary: |
   Aitne's policy is "clean reinstall, no data migration".
@@ -12,6 +18,7 @@ section: reinstall-cleanly
 tags:
   - guide
   - operations
+  - reinstall
 status: stable
 ask_examples:
   - How do I reinstall Aitne?
@@ -19,6 +26,13 @@ ask_examples:
 locale: en-US
 created: 2026-04-25
 updated: 2026-04-25
+keywords:
+  - reinstall
+  - factory reset
+  - wipe
+  - fresh install
+  - PA_DATA_DIR
+  - aitne uninstall
 related:
   - guides/backup-and-restore
 ---
@@ -35,11 +49,12 @@ Reset Aitne's state without losing your context files.
 
 ## Steps
 
-1. `pa stop`.
+1. `aitne stop`.
 2. `cp -R ~/.personal-agent/context backup/` (optional).
-3. `rm ~/.personal-agent/data/personal_agent.db` (the SQLite file lives
-   inside `data/`, not at the top of the data dir).
-4. `pa start`.
+3. `rm ~/.personal-agent/data/personal_agent.db*` (the SQLite file
+   lives inside `data/`, not at the top of the data dir; the `*`
+   also clears the `-shm`/`-wal` companions left behind by WAL mode).
+4. `aitne start`.
 5. Walk the setup wizard again.
 
 ## Verification