33a76a1ebc
迁移路径: /run/media/airlongdian/EasyU/AirCoding -> /home/airlongdian/DataDevices/AirWorkSpace/AirCoding Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
31 lines
919 B
Markdown
Executable File
31 lines
919 B
Markdown
Executable File
# ADR-0003: Use Project-Local `.air` State
|
|
|
|
- Status: Accepted
|
|
- Date: 2026-05-27
|
|
|
|
## Context
|
|
|
|
AirCoding sessions, artifacts, rules, plans, backups, and debug evidence must be resumable and portable with the project where possible, while still keeping private/local state out of normal source sharing.
|
|
|
|
## Decision
|
|
|
|
Use project-local `.air/` as the source of truth:
|
|
|
|
```text
|
|
<project>/.air/shared/ # git-shareable project config, rules, plan docs
|
|
<project>/.air/local/ # private sessions, artifacts, backups, workspaces, local DBs
|
|
```
|
|
|
|
Session DBs live at:
|
|
|
|
```text
|
|
<project>/.air/local/sessions/<session-id>/session.db
|
|
```
|
|
|
|
## Consequences
|
|
|
|
- Project state can move with the project directory.
|
|
- `.air/shared/` can be versioned; `.air/local/` is gitignored by default.
|
|
- Runtime recovery uses project-local SQLite and artifacts.
|
|
- Global `~/.air/` remains config/cache/log/index state, not session source of truth.
|