bvandeusen
016a2bd270
docs: clear briefing remnants and document journal system
...
The Briefing system was retired weeks ago and replaced with the
conversational Journal, but several current-state docs still
described it as live. Updates:
architecture.md
- settings keys: briefing_enabled / briefing_locations / office_days →
journal_config (JSON: locations, temp_unit, prep schedule)
- conversation_type: chat/briefing/mcp → chat/journal/mcp
- briefing_date column → day_date on Conversation
- "Briefing-Related Tables" section: dropped rss_feeds + rss_items
rows (retired with PR #43 ); kept weather_cache and clarified that
lat/lon now live in journal_config.locations, not on the cache row
- routes/chat.py description: dropped trailing "briefing conversation
routes" mention
- routes/briefing.py → routes/journal.py with the current endpoint
shape (config / today / day / days / weather / moments / trigger-
prep)
- services/briefing_pipeline + scheduler + conversations + profile →
services/journal_prep + journal_pipeline + journal_scheduler +
journal_search/moments + user_profile.build_profile_context
features.md
- "Daily Briefing" section rewritten as "Daily Journal":
conversational, single morning prep, right rail with weather +
upcoming events, profile-tab configuration, "what the assistant
has learned" framing
- Settings table: dropped Briefing tab row, added Profile tab row,
fixed Notifications row's stale briefing-push reference
api-reference.md
- /api/briefing/* endpoints replaced with /api/journal/* — config,
today/day/days, trigger-prep, weather (cached/current/refresh/
geocode), moments
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com >
2026-04-28 00:11:43 -04:00
bvandeusen
fddac2aa2f
fix(chat): always think on qwen3, drop content-based classifier
...
Content-based gating (_should_think) was introduced in 87fcaa6 to cut
TTFT on simple prompts, but it has no way to tell that short prompts
like "create a task titled X" are going to trigger a tool call — and
qwen3:14b's tool-call template is unreliable at think=False, producing
intermittent silent generations where output tokens burn but nothing
parses into content or tool_calls.
Reverting to always-on thinking restores the pre-87fcaa6 reliability
of tool emission at the cost of TTFT latency on short conversational
prompts. This also lets us delete the silent-round retry loop (which
can no longer fire) along with its bookkeeping.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-04-15 21:09:16 -04:00
bvandeusen
a6fe1c0d7c
docs: update architecture and features for tool consolidation
...
Update tools.py references to tools/ package, remove stale intent
router section, update research pipeline to multi-note output,
fix create_task references now merged into create_note.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com >
2026-04-12 13:56:13 -04:00
bvandeusen
87c55691fb
docs: update architecture and features for calendar + RAG scoping
...
- architecture.md: add Event model, services/events.py, routes/events.py,
CalendarView.vue, EventSlideOver.vue; update Conversation and Project
data model tables with new columns; update RAG Pipeline section with
three-value scope system, search_projects/set_rag_scope tools, and
project summary background job; fix dead-code note for models/event.py;
update execute_tool() signature docs; add services/projects.py entry
- features.md: replace CalDAV section with full Calendar section covering
internal store, AI tools, HomeView widget, and optional CalDAV sync;
update AI Chat scope chip description; remove done "Calendar view" item
from roadmap
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-25 18:16:41 -04:00
bvandeusen
fe6afbad17
docs: update architecture and development docs with recent additions
...
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-25 10:56:44 -04:00
bvandeusen
bf292e6019
docs: remove extraneous content — pipeline internals moved to architecture, changelog removed
...
- features.md: remove SQL impl detail from tasks section, sw.js reference from PWA section,
and entire "LLM Chat — Internal Pipeline" section (moved to architecture.md)
- architecture.md: add "LLM Pipeline Internals" section (intent routing, tool loop, duplicate
guards, context window, research pipeline, image cache)
- development.md: remove site-specific NFS path from custom runner instructions
- Remove changelog.md (duplicates git history)
- README.md: remove changelog link
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-25 08:38:44 -04:00
bvandeusen
e2133529a0
docs: add missing content from summary.md (API reference, Android app, file structure, LLM internals)
...
- docs/api-reference.md: complete REST API endpoint reference (~60+ routes)
- docs/android-app.md: Flutter companion app stack, architecture, feature status
- docs/architecture.md: detailed file-by-file reference for all backend services and frontend components
- docs/features.md: LLM pipeline internals (intent routing, tool loop, duplicate guards, image search, research pipeline), roadmap
- docs/development.md: full migration chain (0001–0026) with naming and caveats
- README.md: link to new api-reference and android-app docs
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-24 21:25:12 -04:00
bvandeusen
47e248d9ac
docs: restructure documentation into docs/ directory, slim README, add project .mcp.json
...
- README.md: reduced to overview + quick start + links to docs/
- docs/architecture.md: stack, design decisions, data models, key services
- docs/configuration.md: all env vars, docker-compose setup, production + security
- docs/development.md: dev workflow, CI/CD, migrations, release process
- docs/features.md: detailed feature breakdown + keyboard shortcuts
- docs/api-keys-and-mcp.md: API key management + Fable MCP install guide
- docs/sso-oauth.md: OAuth/OIDC setup (replaces docs/oauth-setup.md)
- docs/changelog.md: development history from summary.md
- Remove summary.md (content distributed across docs/)
- Remove docs/oauth-setup.md (superseded by docs/sso-oauth.md)
- .gitignore: add .mcp.json
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-24 21:03:15 -04:00