@aitne-sh/aitne 0.1.7 → 0.1.9

package/agent-assets/docs/features/memory-files/schedule.md

@@ -1,112 +1,155 @@
 ---
 schema_version: 1
 slug: features/memory-files/schedule
-title: daily/ files
+title: journal/daily/ files
 id: schedule-files
 aliases:
-  - schedule directory
+  - daily journal
   - daily directory
-  - per-date schedule
-  - daily/YYYY-MM-DD.md
+  - per-date journal
+  - journal/daily/YYYY-MM-DD.md
+  - schedule directory
 category: features
 summary: |
-  Per-date synthesis files (daily/YYYY-MM-DD.md) the morning routine
-  writes from yesterday.md plus the SQLite event log. They are the
-  read-only archive each day rolls into; the dashboard's Schedule view
-  also reads them.
+  Per-date diary files (journal/daily/YYYY-MM-DD.md) the morning
+  routine writes as a first-person retrospective of the previous
+  agent-day. They are a read-only archive composed by the daemon from
+  the Stage B journal session's output; weekly and monthly reviews
+  read them back.
 section: memory-files
 tags:
   - memory
-  - schedule
+  - journal
+  - routines
   - core
 status: stable
 ask_examples:
-  - Where does the agent store the day's archived plan?
-  - Why is yesterday still showing up in /schedule?
-  - How do I hand-edit a day's plan?
+  - Where does the agent store the day's diary?
+  - What is in journal/daily and how is it different from today.md?
+  - How do I change which sections the daily journal includes?
 locale: en-US
 created: 2026-04-25
-updated: 2026-04-26
+updated: 2026-05-28
 keywords:
-  - schedule
-  - daily
+  - daily journal
+  - diary
   - per-date
-  - calendar snapshot
+  - retrospective
+  - synthesis
 related:
   - features/routines/morning-routine
   - features/memory-files/today
+  - features/memory-files/agent-journal
   - concepts/agent-day
 ui_anchors:
   - /schedule
+process_keys:
+  - routine.morning_routine_journal
 context_files:
-  - daily/<date>.md
+  - journal/daily/<date>.md
 ---
 
-# daily/ Files
+# journal/daily/ Files
 
 ## In One Sentence
 
-`daily/YYYY-MM-DD.md` is the morning routine's synthesized archive of
-the agent-day; the dashboard's Schedule view and downstream routines
-read from this directory.
-
-> **Heads up — directory renamed.** The mechanical
-> `schedule/YYYY-MM-DD.md` copy was retired in B-007. The morning
-> routine now synthesizes `daily/YYYY-MM-DD.md` from `yesterday.md`
-> plus the SQLite event log instead. Hand-pruning the old `schedule/`
-> directory is safe.
-
-## What It Does
-
-Each file under `~/.personal-agent/context/daily/` corresponds to one
-**agent day** (the file name uses the agent-day date, not the calendar
-date — see [Agent Day](../../concepts/agent-day.md)). The morning
-routine writes the file shortly after rolling `today.md` →
-`yesterday.md`. It contains:
-
-- Calendar events from connected calendars.
-- Mail-driven items the agent flagged for that day.
-- Preparation Timeline rows from `roadmap.md` whose offset fired that day.
-- Carryover items the agent did not finish.
-
-The synthesis is template-driven and reads from the in-process DB
-snapshot of the closing `today.md` plus the day's event records, so
-late edits made directly to `today.md` after rotation cannot retroactively
-rewrite a previous `daily/` file.
-
-## When It Runs / How It Is Triggered
-
-The morning routine writes today's file once at start-of-day. Other
-routines read it but do not rewrite.
-
-## What It Outputs
-
-- A Markdown file with sections for events, preparations, and
-  carryover items.
-- A `last_updated` line so the dashboard knows freshness.
+`journal/daily/YYYY-MM-DD.md` is the morning routine's first-person
+diary of the **previous** agent-day — what the user did, who they met,
+what they talked about — composed by the daemon and kept as a
+read-only archive that the weekly and monthly reviews read back.
+
+> **Renamed from `schedule/`.** The old mechanical `schedule/YYYY-MM-DD.md`
+> copy was retired. Today the morning routine synthesizes a diary at
+> `journal/daily/YYYY-MM-DD.md` instead — a retrospective, not a plan.
+> Pruning any leftover `schedule/` directory is safe.
+
+## What It Is (and What It Is Not)
+
+This is a **diary of what already happened**, written for the user in
+their own voice. It is the opposite end of the day from
+[today.md](today.md):
+
+- **`state/today.md`** is the live, forward-looking plan for the
+  *current* agent-day — calendar events ahead, items to prepare,
+  carryover.
+- **`journal/daily/<date>.md`** is the finished, retrospective record
+  of a *past* agent-day. Once written it is not rewritten.
+
+It is also distinct from [journal/agent.md](agent-journal.md): the
+daily journal is the *user's* diary, while `journal/agent.md` is the
+agent's own decision log. Agent-side telemetry (action counts, retry
+stats) never appears here.
+
+## What It Contains
+
+Each file under `~/.personal-agent/context/journal/daily/` corresponds
+to one **agent day** (the file name uses the agent-day date, not the
+calendar date — see [Agent Day](../../concepts/agent-day.md)). The body
+typically includes:
+
+- `## Summary` — a first-person recap of the day.
+- `## Schedule` — the events and meetings that actually took place.
+- `## Tasks` — what the user worked on.
+- `## Conversations` — who they talked to and about what.
+
+When the `browser_history` integration is active, a reading/research
+surface is woven in from the day's browser digest. Daemon-owned
+frontmatter (`date`, `weekday`, `calendar_events`, `messages_handled`,
+`projects`, `people`, `tags`, `content_hash`, `updated`) is filled in
+automatically. The exact sections and tone are governed by the
+journal-format and journal-export policy files (see
+[Configuration](#configuration)).
+
+## When It Runs / How It Is Written
+
+The daily journal is **Stage B of the 04:00 morning routine**
+(process key `routine.morning_routine_journal`, lite tier), which runs
+in parallel with Stage A's `state/today.md` rollover. Stage B authors
+the body of *yesterday's* file; because the agent has no write tools,
+its output is two XML-tagged blocks that the daemon's
+`DailyJournalComposer` extracts, frames with frontmatter, and writes
+atomically to disk.
+
+Because the synthesis reads pre-aggregated facts captured at rotation
+time, late edits made directly to `state/today.md` after rollover
+cannot retroactively rewrite an already-written `journal/daily/` file.
+
+Other routines (weekly and monthly reviews) read these files back but
+do not rewrite them.
 
 ## Where in the Dashboard
 
-- **Schedule (`/schedule`)** reads adjacent `daily/<date>.md` files
-  to render the past/today/upcoming columns. Hand-edits are picked up
-  on the next view refresh.
+The daily journal does **not** appear on the Schedule page — that page
+shows the scheduler's wake-ups and recurring routines, not these files.
+
+- **Journal settings (`/settings/journal`)** is where you shape the
+  output: the Format and Export rule files control which sections
+  appear, the voice, the required frontmatter, and the redaction /
+  inclusion rules applied on every synthesis run. Edits take effect on
+  the next morning routine.
 
 ## Configuration
 
-There is nothing to configure on these files directly; they are a
-side effect of the morning routine. Retention is unlimited — old
-files accumulate. A manual prune (`rm daily/2025-*.md`) is safe.
+There is nothing to configure on the files themselves; they are a
+side effect of the morning routine. To change *what* gets written, edit
+the journal Format and Export rules at `/settings/journal`.
+
+Retention is unlimited — old files accumulate. A manual prune
+(`rm ~/.personal-agent/context/journal/daily/2025-*.md`) is safe.
 
 ## When Something Goes Wrong
 
-- An **empty** daily file usually means the morning routine did not
-  run. See [Morning Routine Didn't Run](../../troubleshooting/morning-routine-didnt-run.md).
-- A view that **shows yesterday** is the day-boundary subtlety:
-  before `dayBoundaryHour`, the agent day is still yesterday. See
-  [Agent Day](../../concepts/agent-day.md).
+- A **missing or empty** daily file usually means the morning routine
+  did not run. See
+  [Morning Routine Didn't Run](../../troubleshooting/morning-routine-didnt-run.md).
+- An entry **dated to the wrong day** is the day-boundary subtlety:
+  before `dayBoundaryHour` (default 04:00 local), the agent day is
+  still yesterday. See [Agent Day](../../concepts/agent-day.md).
 
 ## Related
 
-- [Morning Routine](../routines/morning-routine.md) — the writer.
-- [today.md](today.md) — the live, hand-editable surface for the
-  current agent day.
+- [Morning Routine](../routines/morning-routine.md) — the writer (Stage B).
+- [today.md](today.md) — the live, forward-looking plan for the
+  current agent-day.
+- [journal/agent.md](agent-journal.md) — the agent's own decision log,
+  distinct from this user diary.

package/agent-assets/docs/features/memory-files/today.md

@@ -8,13 +8,14 @@ aliases:
   - day plan
 category: features
 summary: |
-  today.md is the live, hand-editable plan for the current agent day.
-  The morning routine writes it; the operator and the agent both
-  append to it during the day.
+  today.md is the live plan for the current agent day. The morning
+  routine rebuilds it each day; the hourly check, evening review,
+  and the operator all read and append to it during the day.
 section: memory-files
 tags:
   - core
   - memory
+  - today
 status: stable
 ask_examples:
   - What is in today.md?
@@ -22,52 +23,77 @@ ask_examples:
   - Why does today.md keep getting rewritten?
 locale: en-US
 created: 2026-04-25
-updated: 2026-04-25
+updated: 2026-05-28
 keywords:
   - today
   - day plan
+  - agent log
+  - handoff
 related:
   - features/routines/morning-routine
+  - features/routines/hourly-check
+  - features/routines/evening-review
   - features/memory-files/schedule
   - concepts/agent-day
+ui_anchors:
+  - /knowledge?tab=context-files
+api_endpoints:
+  - PUT /api/context/*
+  - PATCH /api/context/*
 context_files:
-  - today.md
+  - state/today.md
 ---
 
 # today.md
 
 ## In One Sentence
 
-The single live file that captures the day's plan, log, tasks, and
-hand-off — rebuilt by the morning routine, appended-to by everything
-else during the day.
+The single live file for the current agent day — plan, log, tasks, and
+hand-off. The morning routine rebuilds it; everything else during the
+day appends to it.
 
 ## What It Does
 
-Sections:
+today.md holds six sections, written in this order:
 
-- **User Schedule** — calendar events.
-- **Tasks** — today's external + agent-tracked tasks.
-- **Agent Plan** — what the agent intends to work on today.
-- **Agent Log** — what actually happened.
-- **Handoff** — what carries to tomorrow.
+- **User Schedule** — the day's calendar events.
+- **User Tasks** — today's external tasks plus agent-tracked to-dos.
+- **Agent Plan** — what the agent intends to work on today (each row is
+  registered as a schedule entry by the morning routine).
+- **Agent Notes** — look-ahead items and date-bound memos folded in from
+  inbox triage.
+- **Agent Log** — what actually happened, appended throughout the day.
+- **Handoff** — what carries over to tomorrow.
 
 ## When It Runs / How It Is Triggered
 
-- The morning routine fully rewrites it.
-- The hourly check appends short observations under Agent Log.
-- The evening review reads it before writing the journal.
+- The **morning routine** fully rebuilds today.md (the daemon first
+  rotates the previous day's file to `state/yesterday.md`).
+- The **hourly check** routes new observations into the right section
+  and appends short status lines under Agent Log.
+- The **evening review** finalizes the file — it updates Agent Log and
+  the Handoff section before writing the daily journal.
+
+## How It Is Written
+
+The agent never edits today.md with a file tool. All writes go through
+the daemon's context API — `PUT`/`PATCH /api/context/state/today` (the
+canonical, class-prefixed path). A `today-write-lock` serializes writes
+during the morning routine: while the lock is held, a write to
+`state/today` must carry the `X-Lock-Id` header or it is rejected.
 
 ## Where in the Dashboard
 
-- **Knowledge → Context Files → today.md** to view and edit.
+- **Knowledge → Context Files → today.md** to view and edit by hand.
 
 ## When Something Goes Wrong
 
-- An empty today.md after the morning hour: see [Morning Routine
-  Didn't Run](../../troubleshooting/morning-routine-didnt-run.md).
+- An empty today.md after the morning hour: see
+  [Morning routine didn't run](../../troubleshooting/morning-routine-didnt-run.md).
 
 ## Related
 
-- [Morning Routine](../routines/morning-routine.md)
+- [Morning routine](../routines/morning-routine.md)
+- [Hourly check](../routines/hourly-check.md)
+- [Evening review](../routines/evening-review.md)
 - [schedule/ files](schedule.md)

package/agent-assets/docs/features/memory-files/user-profile.md

@@ -1,18 +1,19 @@
 ---
 schema_version: 1
 slug: features/memory-files/user-profile
-title: user/profile.md
+title: identity/profile.md
 id: user-profile
 aliases:
   - user.md
   - user/profile.md
+  - identity/profile.md
   - user profile
   - about-me
 category: features
 summary: |
-  user/profile.md is the agent's stable profile of the operator — role,
-  focus areas, preferences, names of important people. The agent reads
-  it on every session and appends with the operator's permission.
+  identity/profile.md is the agent's stable profile of the operator — role,
+  focus areas, preferences, names of important people. The agent reads it
+  on every session and appends only with the operator's permission.
 section: memory-files
 tags:
   - memory
@@ -20,25 +21,36 @@ tags:
   - core
 status: stable
 ask_examples:
-  - What is user/profile.md?
+  - What is identity/profile.md?
   - How do I tell the agent something about me?
   - Will the agent change my profile without asking?
 locale: en-US
 created: 2026-04-25
-updated: 2026-04-25
+updated: 2026-05-28
+keywords:
+  - user profile
+  - identity/profile.md
+  - identity slices
+  - people
+  - expertise
 related:
   - getting-started/04-first-day
   - concepts/memory-model
+process_keys:
+  - routine.user_profile_sweep
+api_endpoints:
+  - PUT /api/context/*
+  - PATCH /api/context/*
 context_files:
-  - user/profile.md
-  - user/people.md
-  - user/work.md
-  - user/expertise.md
-  - user/personal.md
-  - user/goals.md
+  - identity/profile.md
+  - identity/people.md
+  - identity/work.md
+  - identity/expertise.md
+  - identity/personal.md
+  - identity/goals.md
 ---
 
-# user/profile.md
+# identity/profile.md
 
 ## In One Sentence
 
@@ -47,35 +59,59 @@ every session and appends only with explicit permission.
 
 ## What It Does
 
-- Captures who you are, what you do, who matters in your life.
-- Pinned at the top of every session prompt so the agent has the
-  same baseline understanding turn-to-turn.
-- The companion files in the `user/` directory split the dossier into
-  topic-shaped slices: `user/people.md`, `user/work.md`,
-  `user/expertise.md`, `user/personal.md`, `user/goals.md`. The agent
-  loads them on demand instead of inlining everything.
+- Captures who you are, what you do, and who matters in your life.
+- Is pinned at the top of every session prompt, so the agent keeps
+  the same baseline understanding of you turn-to-turn.
+- Anchors a set of companion slices in the `identity/` directory that
+  split the dossier into topic-shaped files:
+  `identity/people.md`, `identity/work.md`, `identity/expertise.md`,
+  `identity/personal.md`, `identity/goals.md`. The agent loads these on
+  demand instead of inlining everything into every prompt.
+
+> Older docs and exports may call these files `user/profile.md`,
+> `user/people.md`, and so on. `user/` is a legacy alias for
+> `identity/`; the daemon rewrites it in-process, so the current
+> canonical location is `identity/`.
 
 ## When It Runs / How It Is Triggered
 
-Read continuously. Written only when the operator says "remember
-that…" or during a profile sweep routine
-(`routine.user_profile_sweep`).
+- **Read continuously** — loaded at the start of every session.
+- **Written** only when you say "remember that…" in a DM, or during
+  the profile sweep routine (`routine.user_profile_sweep`), which
+  routes captured facts into the appropriate `identity/*.md` slice.
+
+The agent never edits these files directly. It writes through the
+daemon's context API — for example
+`PATCH /api/context/identity/profile.md` — the single validated write
+path with locks and backup snapshots.
 
 ## Where in the Dashboard
 
-- **Knowledge → Context Files → user/profile.md** to view and edit.
-  The other `user/*.md` slices are listed alongside.
-- **Knowledge → Upload** to seed `user/*.md` from a Markdown / text
-  file — useful for migrating an existing profile out of ChatGPT,
-  Gemini, Obsidian, or Notion. See
-  [Import a Knowledge File](../../guides/import-knowledge-file.md).
+- **Knowledge → Context Files** (`/knowledge?tab=context-files`) to
+  view and edit `identity/profile.md`. The other `identity/*.md`
+  slices are listed alongside it.
+- **Knowledge → Upload** (`/knowledge?tab=upload`) to seed the
+  `identity/*.md` slices from a Markdown or text file — useful when
+  migrating an existing profile out of ChatGPT, Gemini, Obsidian, or
+  Notion. See [Import a Knowledge File](../../guides/import-knowledge-file.md).
+
+## Example
+
+To tell the agent a durable fact about yourself, just say it in a DM:
+
+> remember that my manager is Priya and we sync every Monday at 10am
+
+The agent appends a line to the relevant slice (here `identity/people.md`)
+after confirming, and recalls it in future sessions.
 
 ## When Something Goes Wrong
 
-- The agent forgets something it should remember: append it to
-  the appropriate `user/*.md` slice by hand.
+- **The agent forgets something it should remember:** open
+  **Knowledge → Context Files** and append it to the appropriate
+  `identity/*.md` slice by hand.
 
 ## Related
 
 - [Memory Model](../../concepts/memory-model.md)
+- [First Day](../../getting-started/04-first-day.md)
 - [Import a Knowledge File](../../guides/import-knowledge-file.md)