docs: update notification system for shared SQLite + clear T–lead

- Add SQLite Ownership & Concurrency section with WAL mode details
- Add DB Path & Adapter Configuration with shared DB setup
- Clarify T–lead governs prefetch attempts, not arming
- Add TTL-at-fire check callout for stale notification prevention
- Add DB Sharing acceptance criteria (visibility, WAL overlap, version safety)
- Update GLOSSARY.md with shared DB, WAL, and user_version definitions
- Remove plugin-owned DB references in favor of single shared database

Files modified:
- doc/notification-system.md
- doc/GLOSSARY.md

Compliance: Implements shared SQLite architecture with clear T–lead prefetch
semantics and WAL-based concurrency for app/plugin coordination.

.cursor/rules/core/base_context.mdc

@@ -21,7 +21,7 @@ alwaysApply: false
 
 ## Purpose
 
-All interactions must *increase the human's competence over time* while
+All interactions must _increase the human's competence over time_ while
 completing the task efficiently. The model may handle menial work and memory
 extension, but must also promote learning, autonomy, and healthy work habits.
 The model should also **encourage human interaction and collaboration** rather
@@ -31,7 +31,7 @@ machine-driven steps.
 
 ## Principles
 
-1. Competence over convenience: finish the task *and* leave the human more
+1. Competence over convenience: finish the task _and_ leave the human more
 
    capable next time.
 
@@ -75,7 +75,7 @@ assumptions if unanswered.
 
 ### timebox_minutes
 
-*integer or null* — When set to a positive integer (e.g., `5`), this acts
+_integer or null_ — When set to a positive integer (e.g., `5`), this acts
 as a **time budget** guiding the model to prioritize delivering the most
 essential parts of the task within that constraint.
 
@@ -91,7 +91,7 @@ Behavior when set:
 
 3. **Signal Skipped Depth** — Omitted details should be listed under
 
-   *Deferred for depth*.
+   _Deferred for depth_.
 
 4. **Order by Value** — Start with blocking or high-value items, then
 
@@ -198,7 +198,7 @@ Default: Doer + short Mentor notes.
 
 ## Self-Check (model, before responding)
 
-- [ ] Task done *and* at least one competence lever included (≤120 words
+- [ ] Task done _and_ at least one competence lever included (≤120 words
   total)
 - [ ] At least one collaboration/discussion hook present
 - [ ] Output follows the **Output Contract** sections

.cursor/rules/core/harbor_pilot_universal.mdc

@@ -53,7 +53,7 @@ evidence-backed steps**.
 - **Verifiable Outputs**: Include expected results, status codes, or
   error messages
 
-- **Cite evidence** for *Works/Doesn't* items (timestamps, filenames,
+- **Cite evidence** for _Works/Doesn't_ items (timestamps, filenames,
   line numbers, IDs/status codes, or logs).
 
 ## Required Sections
@@ -181,8 +181,8 @@ Before publishing, verify:
 
 ---
 
-**Status**: 🚢 ACTIVE — General ruleset extending *Base Context — Human
-Competence First*
+**Status**: 🚢 ACTIVE — General ruleset extending _Base Context — Human
+Competence First_
 
 **Priority**: Critical
 **Estimated Effort**: Ongoing reference

.cursor/rules/core/less_complex.mdc

@@ -12,12 +12,11 @@ language: Match repository languages and conventions
 
 ## Rules
 
-0. **Principle:** just the facts m'am.
 1. **Default to the least complex solution.** Fix the problem directly
    where it occurs; avoid new layers, indirection, or patterns unless
    strictly necessary.
 2. **Keep scope tight.** Implement only what is needed to satisfy the
-   acceptance criteria and tests for *this* issue.
+   acceptance criteria and tests for _this_ issue.
 3. **Avoid speculative abstractions.** Use the **Rule of Three**:
    don't extract helpers/patterns until the third concrete usage proves
    the shape.
@@ -30,7 +29,7 @@ language: Match repository languages and conventions
 7. **Targeted tests only.** Add the smallest set of tests that prove
    the fix and guard against regression; don't rewrite suites.
 8. **Document the "why enough."** Include a one-paragraph note
-   explaining why this minimal solution is sufficient *now*.
+   explaining why this minimal solution is sufficient _now_.
 
 ## Future-Proofing Requires Evidence + Discussion
 

.cursor/rules/development/asset_configuration.mdc

@@ -9,8 +9,8 @@ alwaysApply: false
 **Date**: 2025-08-19
 **Status**: 🎯 **ACTIVE** - Asset management guidelines
 
-*Scope: Assets Only (icons, splashes, image pipelines) — not overall build
-orchestration*
+_Scope: Assets Only (icons, splashes, image pipelines) — not overall build
+orchestration_
 
 ## Intent
 

.cursor/rules/development/time.mdc

@@ -40,7 +40,7 @@ feature development, issue investigations, ADRs, and documentation**.
 
   `2025-08-17`).
 
-- Avoid ambiguous terms like *recently*, *last month*, or *soon*.
+- Avoid ambiguous terms like _recently_, _last month_, or _soon_.
 
 - For time-based experiments (e.g., A/B tests), always include:
 

.cursor/rules/development/time_implementation.mdc

@@ -19,7 +19,7 @@
 
   - Optionally provide UTC alongside if context requires cross-team clarity.
 
-- When interpreting relative terms like *now*, *today*, *last week*:
+- When interpreting relative terms like _now_, _today_, _last week_:
 
   - Resolve them against the **developer's current time**.
 

.cursor/rules/docs/documentation_references_model_agents.mdc

@@ -0,0 +1,96 @@
+---
+title: Documentation, References, and Model Agent Use
+version: 1.1
+alwaysApply: true
+scope: code, project-plans
+---
+
+# Directive on Documentation, References, and Model Agent Use in Code and Project Plans
+
+To ensure clarity, efficiency, and high-value documentation within code and project plans—and to leverage **model agents** (AI- or automation-based assistants) effectively—contributors must follow these rules:
+
+---
+
+## 1. Documentation and References Must Add Clear Value
+
+- Only include documentation, comments, or reference links when they provide _new, meaningful information_ that assists understanding or decision-making.  
+- Avoid duplicating content already obvious in the codebase, version history, or linked project documents.
+
+---
+
+## 2. Eliminate Redundant or Noisy References
+
+- Remove references that serve no purpose beyond filling space.  
+- Model agents may automatically flag and suggest removal of trivial references (e.g., links to unchanged boilerplate or self-evident context).
+
+---
+
+## 3. Explicit Role of Model Agents
+
+Model agents are **active participants** in documentation quality control. Their tasks include:  
+
+- **Relevance Evaluation**: Automatically analyze references for their substantive contribution before inclusion.  
+- **Redundancy Detection**: Flag duplicate or trivial references across commits, files, or tasks.  
+- **Context Linking**: Suggest appropriate higher-level docs (designs, ADRs, meeting notes) when a code change touches multi-stage or cross-team items.  
+- **Placement Optimization**: Recommend centralization of references (e.g., in plan overviews, ADRs, or merge commit messages) rather than scattered low-value inline references.  
+- **Consistency Monitoring**: Ensure references align with team standards (e.g., ADR template, architecture repo, or external policy documents).  
+
+Contributors must treat agent recommendations as **first-pass reviews** but remain accountable for final human judgment.
+
+---
+
+## 4. Contextual References for Complex Items
+
+- Use **centralized references** for multi-stage features (e.g., architectural docs, research threads).  
+- Keep inline code comments light; push broader context into centralized documents.  
+- Model agents may auto-summarize complex chains of discussion and attach them as a single reference point.
+
+---
+
+## 5. Centralization of Broader Context
+
+- Store overarching context (design docs, proposals, workflows) in accessible, well-indexed places.  
+- Model agents should assist by **generating reference maps** that track where docs are cited across the codebase.
+
+---
+
+## 6. Focused Documentation
+
+- Documentation should explain **why** and **how** decisions are made, not just what was changed.  
+- Model agents can auto-generate first-pass explanations from commit metadata, diffs, and linked issues—but humans must refine them for accuracy and intent.
+
+---
+
+## 7. Review and Accountability
+
+- Reviewers and team leads must reject submissions containing unnecessary or low-quality documentation.  
+- Model agent outputs are aids, not replacements—contributors remain responsible for **final clarity and relevance**.
+
+---
+
+## 8. Continuous Improvement and Agent Feedback Loops
+
+- Encourage iterative development of model agents so their evaluations become more precise over time.  
+- Contributions should include **feedback on agent suggestions** (e.g., accepted, rejected, or corrected) to train better future outputs.  
+- Agents should log patterns of “rejected” suggestions for refinement.  
+
+---
+
+## 9. Workflow Overview (Mermaid Diagram)
+
+```mermaid
+flowchart TD
+    A[Contributor] -->|Writes Code & Draft Docs| B[Model Agent]
+    B -->|Evaluates References| C{Relevant?}
+    C -->|Yes| D[Suggest Placement & Context Links]
+    C -->|No| E[Flag Redundancy / Noise]
+    D --> F[Contributor Refines Docs]
+    E --> F
+    F --> G[Reviewer]
+    G -->|Approves / Requests Revisions| H[Final Documentation]
+    G -->|Feedback on Agent Suggestions| B
+```
+
+---
+
+✅ **Outcome:** By integrating disciplined contributor standards with **model agent augmentation**, the team achieves documentation that is consistently _relevant, concise, centralized, and decision-focused_. AI ensures coverage and noise reduction, while humans ensure precision and judgment.  

.cursor/rules/docs/markdown_templates.mdc

@@ -192,6 +192,7 @@ Summary of key concepts and skills.
 
 Where to apply this knowledge next.
 ```
+
 - [ ] Integration tests
 - [ ] E2E tests
 

.cursor/rules/harbor_pilot_universal.mdc

@@ -1,5 +1,6 @@
 ---
-alwaysApply: false
+alwaysApply: true
+inherits: base_context.mdc
 ---
 ```json
 {
@@ -15,9 +16,10 @@ alwaysApply: false
 
 **Author**: System/Shared  
 **Date**: 2025-08-21 (UTC)  
-**Status**: 🚢 ACTIVE — General ruleset extending *Base Context — Human Competence First*
+**Status**: 🚢 ACTIVE — General ruleset extending _Base Context — Human Competence First_
 
 > **Alignment with Base Context**
+>
 > - **Purpose fit**: Prioritizes human competence and collaboration while delivering reproducible artifacts.  
 > - **Output Contract**: This directive **adds universal constraints** for any technical topic while **inheriting** the Base Context contract sections.  
 > - **Toggles honored**: Uses the same toggle semantics; defaults above can be overridden by the caller.
@@ -25,9 +27,11 @@ alwaysApply: false
 ---
 
 ## Objective
+
 Produce a **developer-grade, reproducible guide** for any technical topic that onboards a competent practitioner **without meta narration** and **with evidence-backed steps**.
 
 ## Scope & Constraints
+
 - **One Markdown document** as the deliverable.
 - Use **absolute dates** in **UTC** (e.g., `2025-08-21T14:22Z`) — avoid “today/yesterday”.
 - Include at least **one diagram** (Mermaid preferred). Choose the most fitting type:
@@ -36,10 +40,11 @@ Produce a **developer-grade, reproducible guide** for any technical topic that o
   - **APIs**: `curl` + one client library (e.g., `httpx` for Python).
   - **CLIs**: literal command blocks and expected output snippets.
   - **Code**: minimal, self-contained samples (language appropriate).
-- Cite **evidence** for *Works/Doesn’t* items (timestamps, filenames, line numbers, IDs/status codes, or logs).
+- Cite **evidence** for _Works/Doesn’t_ items (timestamps, filenames, line numbers, IDs/status codes, or logs).
 - If something is unknown, output `TODO:<missing>` — **never invent**.
 
 ## Required Sections (extends Base Output Contract)
+
 Follow this exact order **after** the Base Contract’s **Objective → Result → Use/Run** headers:
 
 1. **Context & Scope**
@@ -51,9 +56,9 @@ Follow this exact order **after** the Base Contract’s **Objective → Result
 4. **Architecture / Process Overview**
    - Short prose + **one diagram** selected from the list above.
 5. **Interfaces & Contracts (choose one)**
-   - **API-based**: Endpoint table (*Step, Method, Path/URL, Auth, Key Headers/Params, Sample Req/Resp ref*).
-   - **Data/Files**: I/O contract table (*Source, Format, Schema/Columns, Size, Validation rules*).
-   - **Systems/Hardware**: Interfaces table (*Port/Bus, Protocol, Voltage/Timing, Constraints*).
+   - **API-based**: Endpoint table (_Step, Method, Path/URL, Auth, Key Headers/Params, Sample Req/Resp ref_).
+   - **Data/Files**: I/O contract table (_Source, Format, Schema/Columns, Size, Validation rules_).
+   - **Systems/Hardware**: Interfaces table (_Port/Bus, Protocol, Voltage/Timing, Constraints_).
 6. **Repro: End-to-End Procedure**
    - Minimal copy-paste steps with code/commands and **expected outputs**.
 7. **What Works (with Evidence)**
@@ -68,16 +73,19 @@ Follow this exact order **after** the Base Contract’s **Objective → Result
     - Canonical docs, specs, tickets, prior analyses.
 
 > **Competence Hooks (per Base Context; keep lightweight):**
-> - *Why this works* (≤3 bullets) — core invariants or guarantees.  
-> - *Common pitfalls* (≤3 bullets) — the traps we saw in evidence.  
-> - *Next skill unlock* (1 line) — the next capability to implement/learn.  
-> - *Teach-back* (1 line) — prompt the reader to restate the flow/architecture.
+>
+> - _Why this works_ (≤3 bullets) — core invariants or guarantees.  
+> - _Common pitfalls_ (≤3 bullets) — the traps we saw in evidence.  
+> - _Next skill unlock_ (1 line) — the next capability to implement/learn.  
+> - _Teach-back_ (1 line) — prompt the reader to restate the flow/architecture.
 
 > **Collaboration Hooks (per Base Context):**
+>
 > - Name reviewers for **Interfaces & Contracts** and the **diagram**.  
 > - Short **sign-off checklist** before merging/publishing the guide.
 
 ## Do / Don’t (Base-aligned)
+
 - **Do** quantify progress only against a defined scope with acceptance criteria.
 - **Do** include minimal sample payloads/headers or I/O schemas; redact sensitive values.
 - **Do** keep commentary lean; if timeboxed, move depth to **Deferred for depth**.
@@ -85,6 +93,7 @@ Follow this exact order **after** the Base Contract’s **Objective → Result
 - **Don’t** include IDE-specific chatter or internal rules unrelated to the task.
 
 ## Validation Checklist (self-check before returning)
+
 - [ ] All Required Sections present and ordered.  
 - [ ] Diagram compiles (basic Mermaid syntax) and fits the problem.  
 - [ ] If API-based, **Auth** and **Key Headers/Params** are listed for each endpoint.  
@@ -95,6 +104,7 @@ Follow this exact order **after** the Base Contract’s **Objective → Result
 - [ ] Base **Output Contract** sections satisfied (Objective/Result/Use/Run/Competence/Collaboration/Assumptions/References).
 
 ## Universal Template (fill-in)
+
 ```markdown
 # <Title> — Working Notes (As of YYYY-MM-DDTHH:MMZ)
 
@@ -131,37 +141,46 @@ Follow this exact order **after** the Base Contract’s **Objective → Result
 ```
 
 ## Interfaces & Contracts
+
 ### If API-based
+
 | Step | Method | Path/URL | Auth | Key Headers/Params | Sample |
 |---|---|---|---|---|---|
 | <…> | <…> | <…> | <…> | <…> | below |
 
 ### If Data/Files
+
 | Source | Format | Schema/Columns | Size | Validation |
 |---|---|---|---|---|
 | <…> | <…> | <…> | <…> | <…> |
 
 ### If Systems/Hardware
+
 | Interface | Protocol | Timing/Voltage | Constraints | Notes |
 |---|---|---|---|---|
 | <…> | <…> | <…> | <…> | <…> |
 
 ## Repro: End-to-End Procedure
+
 ```bash
 # commands / curl examples (redacted where necessary)
 ```
+
 ```python
 # minimal client library example (language appropriate)
 ```
+
 > Expected output: <snippet/checks>
 
 ## What Works (Evidence)
+
 - ✅ <short statement>  
   - **Time**: <YYYY-MM-DDTHH:MMZ>  
   - **Evidence**: file/line/log or request id/status  
   - **Verify at**: <where>
 
 ## What Doesn’t (Evidence & Hypotheses)
+
 - ❌ <short failure> at `<component/endpoint/file>`  
   - **Time**: <YYYY-MM-DDTHH:MMZ>  
   - **Evidence**: <snippet/id/status>  
@@ -169,38 +188,46 @@ Follow this exact order **after** the Base Contract’s **Objective → Result
   - **Next probe**: <short>
 
 ## Risks, Limits, Assumptions
+
 <bullets: limits, security boundaries, retries/backoff, idempotency, SLOs>
 
 ## Next Steps
+
 | Owner | Task | Exit Criteria | Target Date (UTC) |
 |---|---|---|---|
 | <name> | <action> | <measurable outcome> | <YYYY-MM-DD> |
 
 ## References
+
 <links/titles>
 
 ## Competence Hooks
-- *Why this works*: <≤3 bullets>
-- *Common pitfalls*: <≤3 bullets>
-- *Next skill unlock*: <1 line>
-- *Teach-back*: <1 line>
+
+- _Why this works_: <≤3 bullets>
+- _Common pitfalls_: <≤3 bullets>
+- _Next skill unlock_: <1 line>
+- _Teach-back_: <1 line>
 
 ## Collaboration Hooks
+
 - Reviewers: <names/roles>
 - Sign-off checklist: <≤5 checks>
 
 ## Assumptions & Limits
+
 <bullets>
 
 ## Deferred for depth
+
 <park deeper material here to respect timeboxing>
 ```
 
 ---
 
 **Notes for Implementers:**  
-- Respect Base *Do-Not* (no filler, no invented facts, no censorship).  
+
+- Respect Base _Do-Not_ (no filler, no invented facts, no censorship).  
 - Prefer clarity over completeness when timeboxed; capture unknowns explicitly.
 - Apply historical comment management rules (see `.cursor/rules/historical_comment_management.mdc`)
 - Apply realistic time estimation rules (see `.cursor/rules/realistic_time_estimation.mdc`)
-- Apply Playwright test investigation rules (see `.cursor/rules/playwright_test_investigation.mdc`)
+- Apply Playwright test investigation rules (see `.cursor/rules/playwright_test_investigation.mdc`)

.cursor/rules/meta_bug_diagnosis.mdc

@@ -82,6 +82,7 @@ common investigation pitfalls.
 ### **Safe Diagnosis Commands**
 
 ✅ **Safe to use during diagnosis:**
+
 - `npm run lint-fix` - Syntax and style checking
 - `npm run type-check` - TypeScript validation (if available)
 - `git status` - Version control status
@@ -90,6 +91,7 @@ common investigation pitfalls.
 - `grep_search` - Text pattern searching
 
 ❌ **Never use during diagnosis:**
+
 - `npm run build:web` - Blocks chat
 - `npm run build:electron` - Blocks chat  
 - `npm run build:capacitor` - Blocks chat

.cursor/rules/meta_core_always_on.mdc

@@ -1,6 +1,7 @@
 ---
-alwaysApply: false
+alwaysApply: true
 ---
+
 # Meta-Rule: Core Always-On Rules
 
 **Author**: Matthew Raymer
@@ -35,6 +36,7 @@ that are essential for all AI interactions.
 **This meta-rule enforces current workflow mode constraints for all interactions:**
 
 ### **Current Workflow State**
+
 ```json
 {
   "workflowState": {
@@ -61,26 +63,31 @@ that are essential for all AI interactions.
 ### **Mode-Specific Enforcement**
 
 **Diagnosis Mode (read_only):**
+
 - ❌ **Forbidden**: File modification, code creation, build commands, git commits
 - ✅ **Allowed**: File reading, code analysis, investigation, documentation
 - **Response**: Guide user toward investigation and analysis, not implementation
 
 **Fixing Mode (implementation):**
+
 - ✅ **Allowed**: File modification, code creation, build commands, testing, git commits
 - ❌ **Forbidden**: None (full implementation mode)
 - **Response**: Proceed with implementation and testing
 
 **Planning Mode (design_only):**
+
 - ❌ **Forbidden**: Implementation, coding, building, deployment
 - ✅ **Allowed**: Analysis, design, estimation, documentation, architecture
 - **Response**: Focus on planning and design, not implementation
 
 **Research Mode (investigation):**
+
 - ❌ **Forbidden**: File modification, implementation, deployment
 - ✅ **Allowed**: Investigation, analysis, research, documentation
 - **Response**: Focus on investigation and analysis
 
 **Documentation Mode (writing_only):**
+
 - ❌ **Forbidden**: Implementation, coding, building, deployment
 - ✅ **Allowed**: Writing, editing, formatting, structuring, reviewing
 - **Response**: Focus on documentation creation and improvement
@@ -293,6 +300,9 @@ or context. They form the foundation for all AI assistant behavior.
 **See also**:
 
 - `.cursor/rules/meta_feature_planning.mdc` for workflow-specific rules
+- `.cursor/rules/meta_bug_diagnosis.mdc` for investigation workflows
+- `.cursor/rules/meta_bug_fixing.mdc` for fix implementation
+- `.cursor/rules/meta_feature_implementation.mdc` for feature development
 
 **Status**: Active core always-on meta-rule
 **Priority**: Critical (applies to every prompt)

.cursor/rules/meta_documentation.mdc

@@ -51,6 +51,7 @@ providing technical descriptions.
 ## When to Use
 
 **Use this meta-rule when**:
+
 - Writing new documentation
 - Updating existing documentation
 - Creating technical guides
@@ -107,6 +108,7 @@ providing technical descriptions.
 ### **Document Structure**
 
 **Mandatory Sections**:
+
 - **Overview**: Clear purpose and scope with educational context
 - **Why This Matters**: Business value and user benefit explanation
 - **Core Concepts**: Fundamental understanding before implementation
@@ -116,6 +118,7 @@ providing technical descriptions.
 - **Next Steps**: Where to go from here
 
 **Optional Sections**:
+
 - **Background**: Historical context and evolution
 - **Alternatives**: Other approaches and trade-offs
 - **Advanced Topics**: Deep dive into complex scenarios
@@ -124,6 +127,7 @@ providing technical descriptions.
 ### **Writing Style**
 
 **Educational Approach**:
+
 - **Conversational tone**: Write as if explaining to a colleague
 - **Progressive disclosure**: Start simple, add complexity gradually
 - **Active voice**: "You can do this" not "This can be done"
@@ -131,6 +135,7 @@ providing technical descriptions.
 - **Analogies**: Use familiar concepts to explain complex ideas
 
 **Technical Accuracy**:
+
 - **Precise language**: Use exact technical terms consistently
 - **Code examples**: Working, tested code snippets
 - **Version information**: Specify applicable versions and platforms
@@ -139,6 +144,7 @@ providing technical descriptions.
 ### **Content Quality Standards**
 
 **Educational Value**:
+
 - [ ] **Concept clarity**: Reader understands the fundamental idea
 - [ ] **Context relevance**: Reader knows when to apply the knowledge
 - [ ] **Practical application**: Reader can implement the solution
@@ -146,6 +152,7 @@ providing technical descriptions.
 - [ ] **Next steps**: Reader knows where to continue learning
 
 **Technical Accuracy**:
+
 - [ ] **Fact verification**: All technical details are correct
 - [ ] **Code validation**: Examples compile and run correctly
 - [ ] **Version compatibility**: Platform and version requirements clear
@@ -183,6 +190,7 @@ providing technical descriptions.
 ### **Review Checklist**
 
 **Educational Quality**:
+
 - [ ] **Clear learning objective**: What will the reader learn?
 - [ ] **Appropriate complexity**: Matches target audience knowledge
 - [ ] **Progressive disclosure**: Information builds logically
@@ -190,6 +198,7 @@ providing technical descriptions.
 - [ ] **Common questions**: Anticipates and answers reader questions
 
 **Technical Quality**:
+
 - [ ] **Accuracy**: All technical details verified
 - [ ] **Completeness**: Covers all necessary information
 - [ ] **Consistency**: Terminology and formatting consistent

.cursor/rules/playwright-test-investigation.mdc

@@ -9,26 +9,31 @@ alwaysApply: false
 **Status**: 🎯 **ACTIVE** - Playwright test debugging guidelines
 
 ## Objective
+
 Provide systematic approach for investigating Playwright test failures with focus on UI element conflicts, timing issues, and selector ambiguity.
 
 ## Context & Scope
+
 - **Audience**: Developers debugging Playwright test failures
 - **In scope**: Test failure analysis, selector conflicts, UI state investigation, timing issues
 - **Out of scope**: Test writing best practices, CI/CD configuration
 
 ## Artifacts & Links
+
 - Test results: `test-results/` directory
 - Error context: `error-context.md` files with page snapshots
 - Trace files: `trace.zip` files for failed tests
 - HTML reports: Interactive test reports with screenshots
 
 ## Environment & Preconditions
+
 - OS/Runtime: Linux/Windows/macOS with Node.js
 - Versions: Playwright test framework, browser drivers
 - Services: Local test server (localhost:8080), test data setup
 - Auth mode: None required for test investigation
 
 ## Architecture / Process Overview
+
 Playwright test investigation follows a systematic diagnostic workflow that leverages built-in debugging tools and error context analysis.
 
 ```mermaid
@@ -57,6 +62,7 @@ flowchart TD
 ## Interfaces & Contracts
 
 ### Test Results Structure
+
 | Component | Format | Content | Validation |
 |---|---|---|---|
 | Error Context | Markdown | Page snapshot in YAML | Verify DOM state matches test expectations |
@@ -65,6 +71,7 @@ flowchart TD
 | JSON Results | JSON | Machine-readable results | Parse for automated analysis |
 
 ### Investigation Commands
+
 | Step | Command | Expected Output | Notes |
 |---|---|---|---|
 | Locate failed tests | `find test-results -name "*test-name*"` | Test result directories | Use exact test name patterns |
@@ -74,6 +81,7 @@ flowchart TD
 ## Repro: End-to-End Investigation Procedure
 
 ### 1. Locate Failed Test Results
+
 ```bash
 # Find all results for a specific test
 find test-results -name "*test-name*" -type d
@@ -83,6 +91,7 @@ find test-results -name "error-context.md" | head -5
 ```
 
 ### 2. Analyze Error Context
+
 ```bash
 # Read error context for specific test
 cat test-results/test-name-test-description-browser/error-context.md
@@ -92,6 +101,7 @@ grep -A 10 -B 5 "button.*Yes\|button.*No" test-results/*/error-context.md
 ```
 
 ### 3. Check Trace Files
+
 ```bash
 # List available trace files
 find test-results -name "*.zip" | grep trace
@@ -101,6 +111,7 @@ npx playwright show-trace test-results/test-name/trace.zip
 ```
 
 ### 4. Investigate Selector Issues
+
 ```typescript
 // Check for multiple elements with same text
 await page.locator('button:has-text("Yes")').count(); // Should be 1
@@ -110,6 +121,7 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
 ```
 
 ## What Works (Evidence)
+
 - ✅ **Error context files** provide page snapshots showing exact DOM state at failure  
   - **Time**: 2025-08-21T14:22Z  
   - **Evidence**: `test-results/60-new-activity-New-offers-for-another-user-chromium/error-context.md` shows both alerts visible  
@@ -126,6 +138,7 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
   - **Verify at**: Error context markdown files
 
 ## What Doesn't (Evidence & Hypotheses)
+
 - ❌ **Generic selectors** fail with multiple similar elements at `test-playwright/testUtils.ts:161`  
   - **Time**: 2025-08-21T14:22Z  
   - **Evidence**: `button:has-text("Yes")` matches both "Yes" and "Yes, Export Data"  
@@ -139,12 +152,14 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
   - **Next probe**: Implement alert queuing or prevent overlapping alerts
 
 ## Risks, Limits, Assumptions
+
 - **Trace file size**: Large trace files may impact storage and analysis time
 - **Browser compatibility**: Trace viewer requires specific browser support
 - **Test isolation**: Shared state between tests may affect investigation results
 - **Timing sensitivity**: Tests may pass/fail based on system performance
 
 ## Next Steps
+
 | Owner | Task | Exit Criteria | Target Date (UTC) |
 |---|---|---|---|
 | Development Team | Fix test selectors for multiple alerts | All tests pass consistently | 2025-08-22 |
@@ -152,21 +167,25 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
 | Development Team | Add test IDs to alert buttons | Unique selectors for all UI elements | 2025-08-28 |
 
 ## References
+
 - [Playwright Trace Viewer Documentation](https://playwright.dev/docs/trace-viewer)
 - [Playwright Test Results](https://playwright.dev/docs/test-reporters)
 - [Test Investigation Workflow](./research_diagnostic.mdc)
 
 ## Competence Hooks
+
 - **Why this works**: Systematic investigation leverages Playwright's built-in debugging tools to identify root causes
 - **Common pitfalls**: Generic selectors fail with multiple similar elements; timing issues create race conditions; alert stacking causes UI conflicts
 - **Next skill unlock**: Implement unique test IDs and handle alert dismissal order in test flows
 - **Teach-back**: "How would you investigate a Playwright test failure using error context, trace files, and page snapshots?"
 
 ## Collaboration Hooks
+
 - **Reviewers**: QA team, test automation engineers
 - **Sign-off checklist**: Error context analyzed, trace files reviewed, root cause identified, fix implemented and tested
 
 ## Assumptions & Limits
+
 - Test results directory structure follows Playwright conventions
 - Trace files are enabled in configuration (`trace: "retain-on-failure"`)
 - Error context files contain valid YAML page snapshots
@@ -178,6 +197,7 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
 **Priority**: High  
 **Maintainer**: Development team  
 **Next Review**: 2025-09-21
+
 # Playwright Test Investigation — Harbor Pilot Directive
 
 **Author**: Matthew Raymer  
@@ -185,26 +205,31 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
 **Status**: 🎯 **ACTIVE** - Playwright test debugging guidelines
 
 ## Objective
+
 Provide systematic approach for investigating Playwright test failures with focus on UI element conflicts, timing issues, and selector ambiguity.
 
 ## Context & Scope
+
 - **Audience**: Developers debugging Playwright test failures
 - **In scope**: Test failure analysis, selector conflicts, UI state investigation, timing issues
 - **Out of scope**: Test writing best practices, CI/CD configuration
 
 ## Artifacts & Links
+
 - Test results: `test-results/` directory
 - Error context: `error-context.md` files with page snapshots
 - Trace files: `trace.zip` files for failed tests
 - HTML reports: Interactive test reports with screenshots
 
 ## Environment & Preconditions
+
 - OS/Runtime: Linux/Windows/macOS with Node.js
 - Versions: Playwright test framework, browser drivers
 - Services: Local test server (localhost:8080), test data setup
 - Auth mode: None required for test investigation
 
 ## Architecture / Process Overview
+
 Playwright test investigation follows a systematic diagnostic workflow that leverages built-in debugging tools and error context analysis.
 
 ```mermaid
@@ -233,6 +258,7 @@ flowchart TD
 ## Interfaces & Contracts
 
 ### Test Results Structure
+
 | Component | Format | Content | Validation |
 |---|---|---|---|
 | Error Context | Markdown | Page snapshot in YAML | Verify DOM state matches test expectations |
@@ -241,6 +267,7 @@ flowchart TD
 | JSON Results | JSON | Machine-readable results | Parse for automated analysis |
 
 ### Investigation Commands
+
 | Step | Command | Expected Output | Notes |
 |---|---|---|---|
 | Locate failed tests | `find test-results -name "*test-name*"` | Test result directories | Use exact test name patterns |
@@ -250,6 +277,7 @@ flowchart TD
 ## Repro: End-to-End Investigation Procedure
 
 ### 1. Locate Failed Test Results
+
 ```bash
 # Find all results for a specific test
 find test-results -name "*test-name*" -type d
@@ -259,6 +287,7 @@ find test-results -name "error-context.md" | head -5
 ```
 
 ### 2. Analyze Error Context
+
 ```bash
 # Read error context for specific test
 cat test-results/test-name-test-description-browser/error-context.md
@@ -268,6 +297,7 @@ grep -A 10 -B 5 "button.*Yes\|button.*No" test-results/*/error-context.md
 ```
 
 ### 3. Check Trace Files
+
 ```bash
 # List available trace files
 find test-results -name "*.zip" | grep trace
@@ -277,6 +307,7 @@ npx playwright show-trace test-results/test-name/trace.zip
 ```
 
 ### 4. Investigate Selector Issues
+
 ```typescript
 // Check for multiple elements with same text
 await page.locator('button:has-text("Yes")').count(); // Should be 1
@@ -286,6 +317,7 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
 ```
 
 ## What Works (Evidence)
+
 - ✅ **Error context files** provide page snapshots showing exact DOM state at failure  
   - **Time**: 2025-08-21T14:22Z  
   - **Evidence**: `test-results/60-new-activity-New-offers-for-another-user-chromium/error-context.md` shows both alerts visible  
@@ -302,6 +334,7 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
   - **Verify at**: Error context markdown files
 
 ## What Doesn't (Evidence & Hypotheses)
+
 - ❌ **Generic selectors** fail with multiple similar elements at `test-playwright/testUtils.ts:161`  
   - **Time**: 2025-08-21T14:22Z  
   - **Evidence**: `button:has-text("Yes")` matches both "Yes" and "Yes, Export Data"  
@@ -315,12 +348,14 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
   - **Next probe**: Implement alert queuing or prevent overlapping alerts
 
 ## Risks, Limits, Assumptions
+
 - **Trace file size**: Large trace files may impact storage and analysis time
 - **Browser compatibility**: Trace viewer requires specific browser support
 - **Test isolation**: Shared state between tests may affect investigation results
 - **Timing sensitivity**: Tests may pass/fail based on system performance
 
 ## Next Steps
+
 | Owner | Task | Exit Criteria | Target Date (UTC) |
 |---|---|---|---|
 | Development Team | Fix test selectors for multiple alerts | All tests pass consistently | 2025-08-22 |
@@ -328,21 +363,25 @@ await page.locator('div[role="alert"]:has-text("Register") button:has-text("Yes"
 | Development Team | Add test IDs to alert buttons | Unique selectors for all UI elements | 2025-08-28 |
 
 ## References
+
 - [Playwright Trace Viewer Documentation](https://playwright.dev/docs/trace-viewer)
 - [Playwright Test Results](https://playwright.dev/docs/test-reporters)
 - [Test Investigation Workflow](./research_diagnostic.mdc)
 
 ## Competence Hooks
+
 - **Why this works**: Systematic investigation leverages Playwright's built-in debugging tools to identify root causes
 - **Common pitfalls**: Generic selectors fail with multiple similar elements; timing issues create race conditions; alert stacking causes UI conflicts
 - **Next skill unlock**: Implement unique test IDs and handle alert dismissal order in test flows
 - **Teach-back**: "How would you investigate a Playwright test failure using error context, trace files, and page snapshots?"
 
 ## Collaboration Hooks
+
 - **Reviewers**: QA team, test automation engineers
 - **Sign-off checklist**: Error context analyzed, trace files reviewed, root cause identified, fix implemented and tested
 
 ## Assumptions & Limits
+
 - Test results directory structure follows Playwright conventions
 - Trace files are enabled in configuration (`trace: "retain-on-failure"`)
 - Error context files contain valid YAML page snapshots

.cursor/rules/workflow/commit_messages.mdc

@@ -73,7 +73,7 @@
 
 ### Avoid
 
-- Vague: *improved, enhanced, better*
+- Vague: _improved, enhanced, better_
 
 - Trivialities: tiny docs, one-liners, pure lint cleanups (separate,
 

.cursor/rules/workflow/version_control.mdc

@@ -5,7 +5,7 @@
 **Status**: 🎯 **ACTIVE** - Version control guidelines
 
 ## Core Principles
-### 0) let the developer control git
+
 ### 1) Version-Control Ownership
 
 - **MUST NOT** run `git add`, `git commit`, or any write action.

.husky/pre-commit

@@ -18,17 +18,16 @@ npm run lint-fix || {
     exit 1
 }
 
-# Then run Build Architecture Guard
-
-#echo "🏗️  Running Build Architecture Guard..."
-#bash ./scripts/build-arch-guard.sh --staged || {
-#    echo
-#    echo "❌ Build Architecture Guard failed. Please fix the issues and try again."
-#    echo "💡 To bypass this check for emergency commits, use:"
-#    echo "   git commit --no-verify"
-#    echo
-#    exit 1
-#}
+# Build Architecture Guard - DISABLED
+# echo "🏗️  Running Build Architecture Guard..."
+# bash ./scripts/build-arch-guard.sh --staged || {
+#     echo
+#     echo "❌ Build Architecture Guard failed. Please fix the issues and try again."
+#     echo "💡 To bypass this check for emergency commits, use:"
+#     echo "   git commit --no-verify"
+#     echo
+#     exit 1
+# }
 
 echo "✅ All pre-commit checks passed!"
 

.husky/pre-push

@@ -5,23 +5,28 @@
 #
 . "$(dirname -- "$0")/_/husky.sh"
 
-echo "🔍 Running Build Architecture Guard (pre-push)..."
+echo "🔍 Pre-push checks..."
 
-# Get the remote branch we're pushing to
-REMOTE_BRANCH="origin/$(git rev-parse --abbrev-ref HEAD)"
+# Build Architecture Guard - DISABLED
+# echo "🔍 Running Build Architecture Guard (pre-push)..."
+# 
+# # Get the remote branch we're pushing to
+# REMOTE_BRANCH="origin/$(git rev-parse --abbrev-ref HEAD)"
+# 
+# # Check if remote branch exists
+# if git show-ref --verify --quiet "refs/remotes/$REMOTE_BRANCH"; then
+#     RANGE="$REMOTE_BRANCH...HEAD"
+# else
+#     # If remote branch doesn't exist, check last commit
+#     RANGE="HEAD~1..HEAD"
+# fi
+# 
+# bash ./scripts/build-arch-guard.sh --range "$RANGE" || {
+#     echo
+#     echo "💡 To bypass this check for emergency pushes, use:"
+#     echo "   git push --no-verify"
+#     echo
+#     exit 1
+# }
 
-# Check if remote branch exists
-if git show-ref --verify --quiet "refs/remotes/$REMOTE_BRANCH"; then
-    RANGE="$REMOTE_BRANCH...HEAD"
-else
-    # If remote branch doesn't exist, check last commit
-    RANGE="HEAD~1..HEAD"
-fi
-
-#bash ./scripts/build-arch-guard.sh --range "$RANGE" || {
-#    echo
-#    echo "💡 To bypass this check for emergency pushes, use:"
-#    echo "   git push --no-verify"
-#    echo
-#    exit 1
-#}
+echo "✅ Pre-push checks passed!"

.markdownlint.json

@@ -1,27 +1,56 @@
 {
-  "MD013": {
-    "line_length": 80,
-    "code_blocks": false,
-    "tables": false,
-    "headings": false
+  "MD013": false,
+  "MD033": false,
+  "MD041": false,
+  "MD024": {
+    "siblings_only": true
+  },
+  "MD029": {
+    "style": "ordered"
+  },
+  "MD007": {
+    "indent": 2
+  },
+  "MD012": {
+    "maximum": 1
   },
-  "MD012": true,
   "MD022": true,
+  "MD025": true,
+  "MD026": {
+    "punctuation": ".,;:!"
+  },
+  "MD030": {
+    "ul_single": 1,
+    "ol_single": 1,
+    "ul_multi": 1,
+    "ol_multi": 1
+  },
   "MD031": true,
   "MD032": true,
-  "MD047": true,
-  "MD009": true,
-  "MD010": true,
-  "MD004": { "style": "dash" },
-  "MD029": { "style": "ordered" },
-  "MD041": false,
-  "MD025": false,
-  "MD024": false,
+  "MD034": true,
+  "MD035": {
+    "style": "---"
+  },
   "MD036": false,
-  "MD003": false,
-  "MD040": false,
-  "MD055": false,
-  "MD056": false,
-  "MD034": false,
-  "MD023": false
+  "MD037": true,
+  "MD038": true,
+  "MD039": true,
+  "MD040": true,
+  "MD042": true,
+  "MD043": false,
+  "MD044": false,
+  "MD045": true,
+  "MD046": {
+    "style": "fenced"
+  },
+  "MD047": true,
+  "MD048": {
+    "style": "backtick"
+  },
+  "MD049": {
+    "style": "underscore"
+  },
+  "MD050": {
+    "style": "asterisk"
+  }
 }

BUILDING.md

@@ -93,6 +93,7 @@ The Build Architecture Guard protects your build system by enforcing documentati
 #### Protected File Patterns
 
 The guard monitors these sensitive paths:
+
 - `vite.config.*` - Build configuration
 - `scripts/**` - Build and utility scripts
 - `electron/**` - Desktop application code
@@ -132,6 +133,7 @@ npm run guard:setup
 #### Troubleshooting
 
 If you encounter `mapfile: command not found` errors:
+
 ```bash
 # Ensure script is executable
 chmod +x scripts/build-arch-guard.sh
@@ -270,6 +272,7 @@ Start the development server using `npm run build:web:dev` or `npm run build:web
 3. To test the production build locally, use `npm run build:web:serve` (builds then serves)
 
 **Why Use `serve`?**
+
 - **Production Testing**: Test your optimized production build locally before deployment
 - **SPA Routing Validation**: Verify deep linking and navigation work correctly (handles routes like `/discover`, `/account`)
 - **Performance Testing**: Test the minified and optimized build locally
@@ -335,15 +338,18 @@ All web build commands use the `./scripts/build-web.sh` script, which provides:
 The `serve` functionality provides a local HTTP server for testing production builds:
 
 **What It Does:**
+
 1. **Builds** the application using Vite
 2. **Serves** the built files from the `dist/` directory
 3. **Handles SPA Routing** - serves `index.html` for all routes (fixes 404s on `/discover`, `/account`, etc.)
 
 **Server Options:**
+
 - **Primary**: `npx serve -s dist -l 8080` (recommended - full SPA support)
 - **Fallback**: Python HTTP server (limited SPA routing support)
 
 **Use Cases:**
+
 - Testing production builds before deployment
 - Validating SPA routing behavior
 - Performance testing of optimized builds
@@ -365,8 +371,8 @@ current version to test DB migrations.
 - Put the commit hash in the changelog (which will help you remember to bump the
   version in the step later).
 
-- Tag with the new version, 
-[online](https://gitea.anomalistdesign.com/trent_larson/crowd-funder-for-time-pwa/releases) or 
+- Tag with the new version,
+[online](https://gitea.anomalistdesign.com/trent_larson/crowd-funder-for-time-pwa/releases) or
 `git tag 1.0.2 && git push origin 1.0.2`.
 
 - For test, build the app:
@@ -1185,14 +1191,14 @@ If you need to build manually or want to understand the individual steps:
 - Choose Product -> Archive
   - This will trigger a build and take time, needing user's "login" keychain
     password (user's login password), repeatedly.
-  - If it fails with `building for 'iOS', but linking in dylib 
+  - If it fails with `building for 'iOS', but linking in dylib
     (.../.pkgx/zlib.net/v1.3.0/lib/libz.1.3.dylib) built for 'macOS'` then run
     XCode outside that terminal (ie. not with `npx cap open ios`).
   - Click Distribute -> App Store Connect
 - In AppStoreConnect, add the build to the distribution. You may have to remove
   the current build with the "-" when you hover over it, then "Add Build" with the
   new build.
-  - May have to go to App Review, click Submission, then hover over the build 
+  - May have to go to App Review, click Submission, then hover over the build
     and click "-".
   - It can take 15 minutes for the build to show up in the list of builds.
   - You'll probably have to "Manage" something about encryption, disallowed in France.
@@ -1257,11 +1263,13 @@ npm run assets:validate
 ##### What Gets Validated
 
 **Source Assets (Required):**
+
 - `resources/icon.png` - App icon source
 - `resources/splash.png` - Splash screen source  
 - `resources/splash_dark.png` - Dark mode splash source
 
 **Android Resources (Generated):**
+
 - `android/app/src/main/res/drawable/splash.png` - Splash screen drawable
 - `android/app/src/main/res/mipmap-*/ic_launcher.png` - App icons for all densities
 - `android/app/src/main/res/mipmap-*/ic_launcher_round.png` - Round app icons for all densities
@@ -2706,6 +2714,7 @@ configuration files in the repository.
 ### 2025-08-21 - Cursor Rules Refactoring and Build System Updates
 
 #### Package Dependencies Updated
+
 - **Added**: `markdownlint-cli2` v0.18.1 - Modern markdown linting with improved performance
 - **Added**: `@commitlint/cli` v18.6.1 - Conventional commit message validation
 - **Added**: `@commitlint/config-conventional` v18.6.2 - Conventional commit standards
@@ -2713,28 +2722,33 @@ configuration files in the repository.
 - **Updated**: `lint-staged` v15.2.2 - Pre-commit linting automation
 
 #### Build Script Improvements
+
 - **Markdown Linting**: Replaced custom markdown scripts with `markdownlint-cli2`
   - **Before**: `./scripts/fix-markdown.sh` and `./scripts/validate-markdown.sh`
   - **After**: `markdownlint-cli2 --fix` and `markdownlint-cli2`
   - **Benefits**: Faster execution, better error reporting, modern markdown standards
 
 #### Lint-Staged Configuration Enhanced
+
 - **Added**: Markdown file linting to pre-commit hooks
   - **Pattern**: `*.{md,markdown,mdc}` files now automatically formatted
   - **Command**: `markdownlint-cli2 --fix` runs before each commit
   - **Coverage**: All markdown files including `.mdc` cursor rules
 
 #### Commit Message Standards
+
 - **Added**: Conventional commit validation via commitlint
 - **Configuration**: Extends `@commitlint/config-conventional`
 - **Enforcement**: Ensures consistent commit message format across the project
 
 #### Node.js Version Requirements
+
 - **Updated**: Minimum Node.js version requirements for new dependencies
 - **markdownlint-cli2**: Requires Node.js >=20
 - **Various utilities**: Require Node.js >=18 for modern ES features
 
 #### Build Process Impact
+
 - **No Breaking Changes**: All existing build commands continue to work
 - **Improved Quality**: Better markdown formatting and commit message standards
 - **Enhanced Automation**: More comprehensive pre-commit validation
@@ -2745,6 +2759,7 @@ configuration files in the repository.
 ### 2025-08-21 - Commitlint Configuration Refinement
 
 #### Commit Message Validation Improvements
+
 - **Modified**: Commitlint configuration moved from `package.json` to dedicated `commitlint.config.js`
 - **Enhanced**: Strict validation rules downgraded from errors to warnings
   - **Before**: `subject-case` and `subject-full-stop` rules caused red error messages
@@ -2752,16 +2767,18 @@ configuration files in the repository.
 - **Benefit**: Eliminates confusing red error messages while maintaining commit quality guidance
 
 #### Configuration Structure
+
 - **File**: `commitlint.config.js` - Dedicated commitlint configuration
 - **Extends**: `@commitlint/config-conventional` - Standard conventional commit rules
-- **Custom Rules**: 
+- **Custom Rules**:
   - `subject-case: [1, 'never', ['sentence-case', 'start-case', 'pascal-case', 'upper-case']]`
   - `subject-full-stop: [1, 'never', '.']`
-- **Levels**: 
+- **Levels**:
   - `0` = Disabled, `1` = Warning, `2` = Error
   - Current: Problematic rules set to warning level (1)
 
 #### User Experience Impact
+
 - **Before**: Red error messages on every push with strict commit rules
 - **After**: Yellow warning messages that provide guidance without disruption
 - **Workflow**: Commits and pushes continue to work while maintaining quality standards
@@ -2772,6 +2789,7 @@ configuration files in the repository.
 ### 2025-08-26 - Capacitor Plugin Additions
 
 #### New Capacitor Plugins Added
+
 - **Added**: `@capacitor/clipboard` v6.0.2 - Clipboard functionality for mobile platforms
   - **Purpose**: Enable copy/paste operations on mobile devices
   - **Platforms**: iOS and Android
@@ -2785,23 +2803,27 @@ configuration files in the repository.
   - **Integration**: Automatically included in mobile builds
 
 #### Android Build System Updates
+
 - **Modified**: `android/capacitor.settings.gradle` - Added new plugin project includes
   - **Added**: `:capacitor-clipboard` project directory mapping
   - **Added**: `:capacitor-status-bar` project directory mapping
   - **Impact**: New plugins now properly integrated into Android build process
 
 #### Package Dependencies
+
 - **Updated**: `package.json` - Added new Capacitor plugin dependencies
 - **Updated**: `package-lock.json` - Locked dependency versions for consistency
 - **Version**: All new plugins use Capacitor 6.x compatible versions
 
 #### Build Process Impact
+
 - **No Breaking Changes**: Existing build commands continue to work unchanged
 - **Enhanced Mobile Features**: New clipboard and status bar capabilities available
 - **Automatic Integration**: Plugins automatically included in mobile builds
 - **Platform Support**: Both iOS and Android builds now include new functionality
 
 #### Testing Requirements
+
 - **Mobile Builds**: Verify new plugins integrate correctly in iOS and Android builds
 - **Functionality**: Test clipboard operations and status bar management on devices
 - **Fallback**: Ensure graceful degradation when plugins are unavailable

CODE_QUALITY_DEEP_ANALYSIS.md

@@ -1,852 +0,0 @@
-# TimeSafari Code Quality: Comprehensive Deep Analysis
-
-**Author**: Matthew Raymer  
-**Date**: Tue Sep 16 05:22:10 AM UTC 2025  
-**Status**: 🎯 **COMPREHENSIVE ANALYSIS** - Complete code quality assessment with actionable recommendations
-
-## Executive Summary
-
-The TimeSafari codebase demonstrates **exceptional code quality** with mature patterns, minimal technical debt, and excellent separation of concerns. This comprehensive analysis covers **291 source files** totaling **104,527 lines** of code, including detailed examination of **94 Vue components and views**.
-
-**Key Quality Metrics:**
-- **Technical Debt**: Extremely low (6 TODO/FIXME comments across entire codebase)
-- **Database Migration**: 99.5% complete (1 remaining legacy import)
-- **File Complexity**: High variance (largest file: 2,215 lines)
-- **Type Safety**: Mixed patterns (41 "as any" assertions in Vue files, 62 total)
-- **Error Handling**: Comprehensive (367 catch blocks with good coverage)
-- **Architecture**: Consistent Vue 3 Composition API with TypeScript
-
-## Vue Components & Views Analysis (94 Files)
-
-### Component Analysis (40 Components)
-
-#### Component Size Distribution
-```
-Large Components (>500 lines): 5 components (12.5%)
-├── ImageMethodDialog.vue (947 lines) 🔴 CRITICAL
-├── GiftedDialog.vue (670 lines) ⚠️ HIGH PRIORITY  
-├── PhotoDialog.vue (669 lines) ⚠️ HIGH PRIORITY
-├── PushNotificationPermission.vue (660 lines) ⚠️ HIGH PRIORITY
-└── MembersList.vue (550 lines) ⚠️ MODERATE PRIORITY
-
-Medium Components (200-500 lines): 12 components (30%)
-├── GiftDetailsStep.vue (450 lines)
-├── EntityGrid.vue (348 lines)
-├── ActivityListItem.vue (334 lines)
-├── OfferDialog.vue (327 lines)
-├── OnboardingDialog.vue (314 lines)
-├── EntitySelectionStep.vue (313 lines)
-├── GiftedPrompts.vue (293 lines)
-├── ChoiceButtonDialog.vue (250 lines)
-├── DataExportSection.vue (251 lines)
-├── AmountInput.vue (224 lines)
-├── HiddenDidDialog.vue (220 lines)
-└── FeedFilters.vue (218 lines)
-
-Small Components (<200 lines): 23 components (57.5%)
-├── ContactListItem.vue (217 lines)
-├── EntitySummaryButton.vue (202 lines)
-├── IdentitySection.vue (186 lines)
-├── ContactInputForm.vue (173 lines)
-├── SpecialEntityCard.vue (156 lines)
-├── RegistrationNotice.vue (154 lines)
-├── ContactNameDialog.vue (154 lines)
-├── PersonCard.vue (153 lines)
-├── UserNameDialog.vue (147 lines)
-├── InfiniteScroll.vue (132 lines)
-├── LocationSearchSection.vue (124 lines)
-├── UsageLimitsSection.vue (123 lines)
-├── QuickNav.vue (118 lines)
-├── ProjectCard.vue (104 lines)
-├── ContactListHeader.vue (101 lines)
-├── TopMessage.vue (98 lines)
-├── InviteDialog.vue (95 lines)
-├── ImageViewer.vue (94 lines)
-├── EntityIcon.vue (86 lines)
-├── ShowAllCard.vue (66 lines)
-├── ContactBulkActions.vue (53 lines)
-├── ProjectIcon.vue (47 lines)
-└── LargeIdenticonModal.vue (44 lines)
-```
-
-#### Critical Component Analysis
-
-**1. `ImageMethodDialog.vue` (947 lines) 🔴 CRITICAL REFACTORING NEEDED**
-
-**Issues Identified:**
-- **Excessive Single Responsibility**: Handles camera preview, file upload, URL input, cropping, diagnostics, and error handling
-- **Complex State Management**: 20+ reactive properties with interdependencies
-- **Mixed Concerns**: Camera API, file handling, UI state, and business logic intertwined
-- **Template Complexity**: ~300 lines of template with deeply nested conditions
-
-**Refactoring Strategy:**
-```typescript
-// Current monolithic structure
-ImageMethodDialog.vue (947 lines) {
-  CameraPreview: ~200 lines
-  FileUpload: ~150 lines  
-  URLInput: ~100 lines
-  CroppingInterface: ~200 lines
-  DiagnosticsPanel: ~150 lines
-  ErrorHandling: ~100 lines
-  StateManagement: ~47 lines
-}
-
-// Proposed component decomposition
-ImageMethodDialog.vue (coordinator, ~200 lines)
-├── CameraPreviewComponent.vue (~250 lines)
-├── FileUploadComponent.vue (~150 lines)
-├── URLInputComponent.vue (~100 lines)
-├── ImageCropperComponent.vue (~200 lines)
-├── DiagnosticsPanelComponent.vue (~150 lines)
-└── ImageUploadErrorHandler.vue (~100 lines)
-```
-
-**2. `GiftedDialog.vue` (670 lines) ⚠️ HIGH PRIORITY**
-
-**Assessment**: **GOOD** - Already partially refactored with step components extracted.
-
-**3. `PhotoDialog.vue` (669 lines) ⚠️ HIGH PRIORITY**
-
-**Issues**: Similar to ImageMethodDialog with significant code duplication.
-
-**4. `PushNotificationPermission.vue` (660 lines) ⚠️ HIGH PRIORITY**
-
-**Issues**: Complex permission logic with platform-specific code mixed together.
-
-### View Analysis (54 Views)
-
-#### View Size Distribution
-```
-Large Views (>1000 lines): 9 views (16.7%)
-├── AccountViewView.vue (2,215 lines) 🔴 CRITICAL
-├── HomeView.vue (1,852 lines) ⚠️ HIGH PRIORITY
-├── ProjectViewView.vue (1,479 lines) ⚠️ HIGH PRIORITY
-├── DatabaseMigration.vue (1,438 lines) ⚠️ HIGH PRIORITY
-├── ContactsView.vue (1,382 lines) ⚠️ HIGH PRIORITY
-├── TestView.vue (1,259 lines) ⚠️ MODERATE PRIORITY
-├── ClaimView.vue (1,225 lines) ⚠️ MODERATE PRIORITY
-├── NewEditProjectView.vue (957 lines) ⚠️ MODERATE PRIORITY
-└── ContactQRScanShowView.vue (929 lines) ⚠️ MODERATE PRIORITY
-
-Medium Views (500-1000 lines): 8 views (14.8%)
-├── ConfirmGiftView.vue (898 lines)
-├── DiscoverView.vue (888 lines)
-├── DIDView.vue (848 lines)
-├── GiftedDetailsView.vue (840 lines)
-├── OfferDetailsView.vue (781 lines)
-├── HelpView.vue (780 lines)
-├── ProjectsView.vue (742 lines)
-└── ContactQRScanFullView.vue (701 lines)
-
-Small Views (<500 lines): 37 views (68.5%)
-├── OnboardMeetingSetupView.vue (687 lines)
-├── ContactImportView.vue (568 lines)
-├── HelpNotificationsView.vue (566 lines)
-├── OnboardMeetingListView.vue (507 lines)
-├── InviteOneView.vue (475 lines)
-├── QuickActionBvcEndView.vue (442 lines)
-├── ContactAmountsView.vue (416 lines)
-├── SearchAreaView.vue (384 lines)
-├── SharedPhotoView.vue (379 lines)
-├── ContactGiftingView.vue (373 lines)
-├── ContactEditView.vue (345 lines)
-├── IdentitySwitcherView.vue (324 lines)
-├── UserProfileView.vue (323 lines)
-├── NewActivityView.vue (323 lines)
-├── QuickActionBvcBeginView.vue (303 lines)
-├── SeedBackupView.vue (292 lines)
-├── InviteOneAcceptView.vue (292 lines)
-├── ClaimCertificateView.vue (279 lines)
-├── StartView.vue (271 lines)
-├── ImportAccountView.vue (265 lines)
-├── ClaimAddRawView.vue (249 lines)
-├── OnboardMeetingMembersView.vue (247 lines)
-├── DeepLinkErrorView.vue (239 lines)
-├── ClaimReportCertificateView.vue (236 lines)
-├── DeepLinkRedirectView.vue (219 lines)
-├── ImportDerivedAccountView.vue (207 lines)
-├── ShareMyContactInfoView.vue (196 lines)
-├── RecentOffersToUserProjectsView.vue (176 lines)
-├── RecentOffersToUserView.vue (166 lines)
-├── NewEditAccountView.vue (142 lines)
-├── StatisticsView.vue (133 lines)
-├── HelpOnboardingView.vue (118 lines)
-├── LogView.vue (104 lines)
-├── NewIdentifierView.vue (97 lines)
-├── HelpNotificationTypesView.vue (73 lines)
-├── ConfirmContactView.vue (57 lines)
-└── QuickActionBvcView.vue (54 lines)
-```
-
-#### Critical View Analysis
-
-**1. `AccountViewView.vue` (2,215 lines) 🔴 CRITICAL REFACTORING NEEDED**
-
-**Issues Identified:**
-- **Monolithic Architecture**: Handles 7 distinct concerns in single file
-- **Template Complexity**: ~750 lines of template with deeply nested conditions
-- **Method Proliferation**: 50+ methods handling disparate concerns
-- **State Management**: 25+ reactive properties without clear organization
-
-**Refactoring Strategy:**
-```typescript
-// Current monolithic structure
-AccountViewView.vue (2,215 lines) {
-  ProfileSection: ~400 lines
-  SettingsSection: ~300 lines  
-  NotificationSection: ~200 lines
-  ServerConfigSection: ~250 lines
-  ExportImportSection: ~300 lines
-  LimitsSection: ~150 lines
-  MapSection: ~200 lines
-  StateManagement: ~415 lines
-}
-
-// Proposed component extraction
-AccountViewView.vue (coordinator, ~400 lines)
-├── ProfileManagementSection.vue (~300 lines)
-├── ServerConfigurationSection.vue (~250 lines)
-├── NotificationSettingsSection.vue (~200 lines)
-├── DataExportImportSection.vue (~300 lines)
-├── UsageLimitsDisplay.vue (~150 lines)
-├── LocationProfileSection.vue (~200 lines)
-└── AccountViewStateManager.ts (~200 lines)
-```
-
-**2. `HomeView.vue` (1,852 lines) ⚠️ HIGH PRIORITY**
-
-**Issues Identified:**
-- **Multiple Concerns**: Activity feed, projects, contacts, notifications in one file
-- **Complex State Management**: 20+ reactive properties with interdependencies
-- **Mixed Lifecycle Logic**: Mount, update, and destroy logic intertwined
-
-**3. `ProjectViewView.vue` (1,479 lines) ⚠️ HIGH PRIORITY**
-
-**Issues Identified:**
-- **Project Management Complexity**: Handles project details, members, offers, and activities
-- **Mixed Concerns**: Project data, member management, and activity feed in single view
-
-### Vue Component Quality Patterns
-
-#### Excellent Patterns Found:
-
-**1. EntityIcon.vue (86 lines) ✅ EXCELLENT**
-```typescript
-// Clean, focused responsibility
-@Component({ name: "EntityIcon" })
-export default class EntityIcon extends Vue {
-  @Prop() contact?: Contact;
-  @Prop({ default: "" }) entityId!: string;
-  @Prop({ default: 0 }) iconSize!: number;
-  
-  generateIcon(): string {
-    // Clear priority order: profile image → avatar → fallback
-    const imageUrl = this.contact?.profileImageUrl || this.profileImageUrl;
-    if (imageUrl) return `<img src="${imageUrl}" ... />`;
-    
-    const identifier = this.contact?.did || this.entityId;
-    if (!identifier) return `<img src="${blankSquareSvg}" ... />`;
-    
-    return createAvatar(avataaars, { seed: identifier, size: this.iconSize }).toString();
-  }
-}
-```
-
-**2. QuickNav.vue (118 lines) ✅ EXCELLENT**
-```typescript
-// Simple, focused navigation component
-@Component({ name: "QuickNav" })
-export default class QuickNav extends Vue {
-  @Prop selected = "";
-  
-  // Clean template with consistent patterns
-  // Proper accessibility attributes
-  // Responsive design with safe area handling
-}
-```
-
-**3. Small Focused Views ✅ EXCELLENT**
-```typescript
-// QuickActionBvcView.vue (54 lines) - Perfect size
-// ConfirmContactView.vue (57 lines) - Focused responsibility
-// HelpNotificationTypesView.vue (73 lines) - Clear purpose
-// LogView.vue (104 lines) - Simple utility view
-```
-
-#### Problematic Patterns Found:
-
-**1. Excessive Props in Dialog Components**
-```typescript
-// GiftedDialog.vue - Too many props
-@Prop() fromProjectId = "";
-@Prop() toProjectId = "";
-@Prop() isFromProjectView = false;
-@Prop() hideShowAll = false;
-@Prop({ default: "person" }) giverEntityType = "person";
-@Prop({ default: "person" }) recipientEntityType = "person";
-// ... 10+ more props
-```
-
-**2. Complex State Machines**
-```typescript
-// ImageMethodDialog.vue - Complex state management
-cameraState: "off" | "initializing" | "active" | "error" | "retrying" | "stopped" = "off";
-showCameraPreview = false;
-isRetrying = false;
-showDiagnostics = false;
-// ... 15+ more state properties
-```
-
-**3. Excessive Reactive Properties**
-```typescript
-// AccountViewView.vue - Too many reactive properties
-downloadUrl: string = "";
-loadingLimits: boolean = false;
-loadingProfile: boolean = true;
-showAdvanced: boolean = false;
-showB64Copy: boolean = false;
-showContactGives: boolean = false;
-showDidCopy: boolean = false;
-showDerCopy: boolean = false;
-showGeneralAdvanced: boolean = false;
-showLargeIdenticonId?: string;
-showLargeIdenticonUrl?: string;
-showPubCopy: boolean = false;
-showShortcutBvc: boolean = false;
-warnIfProdServer: boolean = false;
-warnIfTestServer: boolean = false;
-zoom: number = 2;
-isMapReady: boolean = false;
-// ... 10+ more properties
-```
-
-## File Size and Complexity Analysis (All Files)
-
-### Problematic Large Files
-
-#### 1. `AccountViewView.vue` (2,215 lines) 🔴 **CRITICAL**
-**Issues Identified:**
-- **Excessive Single File Responsibility**: Handles profile, settings, notifications, server configuration, export/import, limits checking
-- **Template Complexity**: ~750 lines of template with deeply nested conditions
-- **Method Proliferation**: 50+ methods handling disparate concerns
-- **State Management**: 25+ reactive properties without clear organization
-
-#### 2. `PlatformServiceMixin.ts` (2,091 lines) ⚠️ **HIGH PRIORITY**
-**Issues Identified:**
-- **God Object Pattern**: Single file handling 80+ methods across multiple concerns
-- **Mixed Abstraction Levels**: Low-level SQL utilities mixed with high-level business logic
-- **Method Length Variance**: Some methods 100+ lines, others single-line wrappers
-
-**Refactoring Strategy:**
-```typescript
-// Current monolithic mixin
-PlatformServiceMixin.ts (2,091 lines)
-
-// Proposed separation of concerns
-├── CoreDatabaseMixin.ts          // $db, $exec, $query, $first (200 lines)
-├── SettingsManagementMixin.ts    // $settings, $saveSettings (400 lines)
-├── ContactManagementMixin.ts     // $contacts, $insertContact (300 lines)
-├── EntityOperationsMixin.ts      // $insertEntity, $updateEntity (400 lines)
-├── CachingMixin.ts              // Cache management (150 lines)
-├── ActiveIdentityMixin.ts       // Active DID management (200 lines)
-├── UtilityMixin.ts              // Mapping, JSON parsing (200 lines)
-└── LoggingMixin.ts              // $log, $logError (100 lines)
-```
-
-#### 3. `HomeView.vue` (1,852 lines) ⚠️ **MODERATE PRIORITY**
-**Issues Identified:**
-- **Multiple Concerns**: Activity feed, projects, contacts, notifications in one file
-- **Complex State Management**: 20+ reactive properties with interdependencies
-- **Mixed Lifecycle Logic**: Mount, update, and destroy logic intertwined
-
-### File Size Distribution Analysis
-```
-Files > 1000 lines: 9 files (4.6% of codebase)
-Files 500-1000 lines: 23 files (11.7% of codebase)  
-Files 200-500 lines: 45 files (22.8% of codebase)
-Files < 200 lines: 120 files (60.9% of codebase)
-```
-
-**Assessment**: Good distribution with most files reasonably sized, but critical outliers need attention.
-
-## Type Safety Analysis
-
-### Type Assertion Patterns
-
-#### "as any" Usage (62 total instances) ⚠️
-
-**Vue Components & Views (41 instances):**
-```typescript
-// ImageMethodDialog.vue:504
-const activeIdentity = await (this as any).$getActiveIdentity();
-
-// GiftedDialog.vue:228  
-const activeIdentity = await (this as any).$getActiveIdentity();
-
-// AccountViewView.vue: Multiple instances for:
-// - PlatformServiceMixin method access
-// - Vue refs with complex typing
-// - External library integration (Leaflet)
-```
-
-**Other Files (21 instances):**
-- **Vue Component References** (23 instances): `(this.$refs.dialog as any)`
-- **Platform Detection** (12 instances): `(navigator as any).standalone`
-- **External Library Integration** (15 instances): Leaflet, Axios extensions
-- **Legacy Code Compatibility** (8 instances): Temporary migration code
-- **Event Handler Workarounds** (4 instances): Vue event typing issues
-
-**Example Problematic Pattern:**
-```typescript
-// src/views/AccountViewView.vue:934
-const iconDefault = L.Icon.Default.prototype as unknown as Record<string, unknown>;
-
-// Better approach:
-interface LeafletIconPrototype {
-  _getIconUrl?: unknown;
-}
-const iconDefault = L.Icon.Default.prototype as LeafletIconPrototype;
-```
-
-#### "unknown" Type Usage (755 instances)
-**Analysis**: Generally good practice showing defensive programming, but some areas could benefit from more specific typing.
-
-### Recommended Type Safety Improvements
-
-1. **Create Interface Extensions**:
-```typescript
-// src/types/platform-service-mixin.ts
-interface VueWithPlatformServiceMixin extends Vue {
-  $getActiveIdentity(): Promise<{ activeDid: string }>;
-  $saveSettings(changes: Partial<Settings>): Promise<boolean>;
-  // ... other methods
-}
-
-// src/types/external.ts
-declare global {
-  interface Navigator {
-    standalone?: boolean;
-  }
-}
-
-interface VueRefWithOpen {
-  open: (callback: (result?: unknown) => void) => void;
-}
-```
-
-2. **Component Ref Typing**:
-```typescript
-// Instead of: (this.$refs.dialog as any).open()
-// Use: (this.$refs.dialog as VueRefWithOpen).open()
-```
-
-## Error Handling Consistency Analysis
-
-### Error Handling Patterns (367 catch blocks)
-
-#### Pattern Distribution:
-1. **Structured Logging** (85%): Uses logger.error with context
-2. **User Notification** (78%): Shows user-friendly error messages  
-3. **Graceful Degradation** (92%): Provides fallback behavior
-4. **Error Propagation** (45%): Re-throws when appropriate
-
-#### Excellent Pattern Example:
-```typescript
-// src/views/AccountViewView.vue:1617
-try {
-  const response = await this.axios.delete(url, { headers });
-  if (response.status === 204) {
-    this.profileImageUrl = "";
-    this.notify.success("Image deleted successfully.");
-  }
-} catch (error) {
-  if (isApiError(error) && error.response?.status === 404) {
-    // Graceful handling - image already gone
-    this.profileImageUrl = "";
-  } else {
-    this.notify.error("Failed to delete image", TIMEOUTS.STANDARD);
-  }
-}
-```
-
-#### Areas for Improvement:
-1. **Inconsistent Error Typing**: Some catch(error: any), others catch(error: unknown)
-2. **Missing Error Boundaries**: No Vue error boundary components
-3. **Silent Failures**: 15% of catch blocks don't notify users
-
-## Code Duplication Analysis
-
-### Significant Duplication Patterns
-
-#### 1. **Toggle Component Pattern** (12 occurrences)
-```html
-<!-- Repeated across multiple files -->
-<div class="relative ml-2 cursor-pointer" @click="toggleMethod()">
-  <input v-model="property" type="checkbox" class="sr-only" />
-  <div class="block bg-slate-500 w-14 h-8 rounded-full"></div>
-  <div class="dot absolute left-1 top-1 bg-slate-400 w-6 h-6 rounded-full transition"></div>
-</div>
-```
-
-**Solution**: Create `ToggleSwitch.vue` component with props for value, label, and change handler.
-
-#### 2. **API Error Handling Pattern** (25 occurrences)
-```typescript
-try {
-  const response = await this.axios.post(url, data, { headers });
-  if (response.status === 200) {
-    this.notify.success("Operation successful");
-  }
-} catch (error) {
-  if (isApiError(error)) {
-    this.notify.error(`Failed: ${error.message}`);
-  }
-}
-```
-
-**Solution**: Create `ApiRequestMixin.ts` with standardized request/response handling.
-
-#### 3. **Settings Update Pattern** (40+ occurrences)
-```typescript
-async methodName() {
-  await this.$saveSettings({ property: this.newValue });
-  this.property = this.newValue;
-}
-```
-
-**Solution**: Enhanced PlatformServiceMixin already provides `$saveSettings()` - migrate remaining manual patterns.
-
-## Dependency and Coupling Analysis
-
-### Import Dependency Patterns
-
-#### Legacy Database Coupling (EXCELLENT)
-- **Status**: 99.5% resolved (1 remaining databaseUtil import)
-- **Remaining**: `src/views/DeepLinkErrorView.vue:import { logConsoleAndDb }`
-- **Resolution**: Replace with PlatformServiceMixin `$logAndConsole()`
-
-#### Circular Dependency Status (EXCELLENT)
-- **Status**: 100% resolved, no active circular dependencies
-- **Previous Issues**: All resolved through PlatformServiceMixin architecture
-
-#### Component Coupling Analysis
-```typescript
-// High coupling components (>10 imports)
-AccountViewView.vue: 15 imports (understandable given scope)
-HomeView.vue: 12 imports 
-ProjectViewView.vue: 11 imports
-
-// Well-isolated components (<5 imports)  
-QuickActionViews: 3-4 imports each
-Component utilities: 2-3 imports each
-```
-
-**Assessment**: Reasonable coupling levels with clear architectural boundaries.
-
-## Console Logging Analysis (129 instances)
-
-### Logging Pattern Distribution:
-1. **console.log**: 89 instances (69%)
-2. **console.warn**: 24 instances (19%)  
-3. **console.error**: 16 instances (12%)
-
-### Vue Components & Views Logging (3 instances):
-- **Components**: 1 console.* call
-- **Views**: 2 console.* calls
-
-### Inconsistent Logging Approach:
-```typescript
-// Mixed patterns found:
-console.log("Direct console logging");           // 89 instances
-logger.debug("Structured logging");              // Preferred pattern
-this.$logAndConsole("Mixin logging");           // PlatformServiceMixin
-```
-
-### Recommended Standardization:
-1. **Migration Strategy**: Replace all console.* with logger.* calls
-2. **Structured Context**: Add consistent metadata to log entries
-3. **Log Levels**: Standardize debug/info/warn/error usage
-
-## Technical Debt Analysis (6 total)
-
-### Components (1 TODO):
-```typescript
-// PushNotificationPermission.vue
-// TODO: secretDB functionality needs to be migrated to PlatformServiceMixin
-```
-
-### Views (2 TODOs):
-```typescript
-// AccountViewView.vue
-// TODO: Implement this for SQLite
-// TODO: implement this for SQLite
-```
-
-### Other Files (3 TODOs):
-```typescript
-// src/db/tables/accounts.ts
-// TODO: When finished with migration, move these fields to Account and move identity and mnemonic here.
-
-// src/util.d.ts
-// TODO: , inspect: inspect
-
-// src/libs/crypto/vc/passkeyHelpers.ts
-// TODO: If it's after February 2025 when you read this then consider whether it still makes sense
-```
-
-**Assessment**: **EXCELLENT** - Only 6 TODO comments across 291 files.
-
-## Performance Anti-Patterns
-
-### Identified Issues:
-
-#### 1. **Excessive Reactive Properties**
-```typescript
-// AccountViewView.vue has 25+ reactive properties
-// Many could be computed or moved to component state
-```
-
-#### 2. **Inline Method Calls in Templates**
-```html
-<!-- Anti-pattern: -->
-<span>{{ readableDate(timeStr) }}</span>
-
-<!-- Better: -->
-<span>{{ readableTime }}</span>
-<!-- With computed property -->
-```
-
-#### 3. **Missing Key Attributes in Lists**
-```html
-<!-- Several v-for loops missing :key attributes -->
-<li v-for="item in items">
-```
-
-#### 4. **Complex Template Logic**
-```html
-<!-- AccountViewView.vue - Complex nested conditions -->
-<div v-if="!activeDid" id="noticeBeforeShare" class="bg-amber-200...">
-  <p class="mb-4">
-    <b>Note:</b> Before you can share with others or take any action, you need an identifier.
-  </p>
-  <router-link :to="{ name: 'new-identifier' }" class="inline-block...">
-    Create An Identifier
-  </router-link>
-</div>
-
-<!-- Identity Details -->
-<IdentitySection
-  :given-name="givenName"
-  :profile-image-url="profileImageUrl"
-  :active-did="activeDid"
-  :is-registered="isRegistered"
-  :show-large-identicon-id="showLargeIdenticonId"
-  :show-large-identicon-url="showLargeIdenticonUrl"
-  :show-did-copy="showDidCopy"
-  @edit-name="onEditName"
-  @show-qr-code="onShowQrCode"
-  @add-image="onAddImage"
-  @delete-image="onDeleteImage"
-  @show-large-identicon-id="onShowLargeIdenticonId"
-  @show-large-identicon-url="onShowLargeIdenticonUrl"
-/>
-```
-
-## Specific Actionable Recommendations
-
-### Priority 1: Critical File Refactoring
-
-1. **Split AccountViewView.vue**:
-   - **Timeline**: 2-3 sprints
-   - **Strategy**: Extract 6 major sections into focused components
-   - **Risk**: Medium (requires careful state management coordination)
-   - **Benefit**: Massive maintainability improvement, easier testing
-
-2. **Decompose ImageMethodDialog.vue**:
-   - **Timeline**: 2-3 sprints
-   - **Strategy**: Extract 6 focused components (camera, file upload, cropping, etc.)
-   - **Risk**: Medium (complex camera state management)
-   - **Benefit**: Massive maintainability improvement
-
-3. **Decompose PlatformServiceMixin.ts**:
-   - **Timeline**: 1-2 sprints  
-   - **Strategy**: Create focused mixins by concern area
-   - **Risk**: Low (well-defined interfaces already exist)
-   - **Benefit**: Better code organization, reduced cognitive load
-
-### Priority 2: Component Extraction
-
-1. **HomeView.vue** → 4 focused sections
-   - **Timeline**: 1-2 sprints
-   - **Risk**: Low (clear separation of concerns)
-   - **Benefit**: Better code organization
-
-2. **ProjectViewView.vue** → 4 focused sections
-   - **Timeline**: 1-2 sprints
-   - **Risk**: Low (well-defined boundaries)
-   - **Benefit**: Improved maintainability
-
-### Priority 3: Shared Component Creation
-
-1. **CameraPreviewComponent.vue**
-   - Extract from ImageMethodDialog.vue and PhotoDialog.vue
-   - **Benefit**: Eliminate code duplication
-
-2. **FileUploadComponent.vue**
-   - Extract from ImageMethodDialog.vue and PhotoDialog.vue
-   - **Benefit**: Consistent file handling
-
-3. **ToggleSwitch.vue**
-   - Replace 12 duplicate toggle patterns
-   - **Benefit**: Consistent UI components
-
-4. **DiagnosticsPanelComponent.vue**
-   - Extract from ImageMethodDialog.vue
-   - **Benefit**: Reusable debugging component
-
-### Priority 4: Type Safety Enhancement
-
-1. **Eliminate "as any" Assertions**:
-   - **Timeline**: 1 sprint
-   - **Strategy**: Create proper interface extensions
-   - **Risk**: Low
-   - **Benefit**: Better compile-time error detection
-
-2. **Standardize Error Typing**:
-   - **Timeline**: 0.5 sprint
-   - **Strategy**: Use consistent `catch (error: unknown)` pattern
-   - **Risk**: None
-   - **Benefit**: Better error handling consistency
-
-### Priority 5: State Management Optimization
-
-1. **Create Composables for Complex State**:
-```typescript
-// src/composables/useCameraState.ts
-export function useCameraState() {
-  const cameraState = ref<CameraState>("off");
-  const showPreview = ref(false);
-  const isRetrying = ref(false);
-  
-  const startCamera = async () => { /* ... */ };
-  const stopCamera = () => { /* ... */ };
-  
-  return { cameraState, showPreview, isRetrying, startCamera, stopCamera };
-}
-```
-
-2. **Group Related Reactive Properties**:
-```typescript
-// Instead of:
-showB64Copy: boolean = false;
-showDidCopy: boolean = false;
-showDerCopy: boolean = false;
-showPubCopy: boolean = false;
-
-// Use:
-copyStates = {
-  b64: false,
-  did: false,
-  der: false,
-  pub: false
-};
-```
-
-### Priority 6: Code Standardization
-
-1. **Logging Standardization**:
-   - **Timeline**: 1 sprint
-   - **Strategy**: Replace all console.* with logger.*
-   - **Risk**: None
-   - **Benefit**: Consistent logging, better debugging
-
-2. **Template Optimization**:
-   - Add missing `:key` attributes
-   - Convert inline method calls to computed properties
-   - Implement virtual scrolling for large lists
-
-## Quality Metrics Summary
-
-### Vue Component Quality Distribution:
-| Size Category | Count | Percentage | Quality Assessment |
-|---------------|-------|------------|-------------------|
-| Large (>500 lines) | 5 | 12.5% | 🔴 Needs Refactoring |
-| Medium (200-500 lines) | 12 | 30% | 🟡 Good with Minor Issues |
-| Small (<200 lines) | 23 | 57.5% | 🟢 Excellent |
-
-### Vue View Quality Distribution:
-| Size Category | Count | Percentage | Quality Assessment |
-|---------------|-------|------------|-------------------|
-| Large (>1000 lines) | 9 | 16.7% | 🔴 Needs Refactoring |
-| Medium (500-1000 lines) | 8 | 14.8% | 🟡 Good with Minor Issues |
-| Small (<500 lines) | 37 | 68.5% | 🟢 Excellent |
-
-### Overall Quality Metrics:
-| Metric | Components | Views | Overall Assessment |
-|--------|------------|-------|-------------------|
-| Technical Debt | 1 TODO | 2 TODOs | 🟢 Excellent |
-| Type Safety | 6 "as any" | 35 "as any" | 🟡 Good |
-| Console Logging | 1 instance | 2 instances | 🟢 Excellent |
-| Architecture Consistency | 100% | 100% | 🟢 Excellent |
-| Component Reuse | High | High | 🟢 Excellent |
-
-### Before vs. Target State:
-| Metric | Current | Target | Status |
-|--------|---------|---------|---------|
-| Files >1000 lines | 9 files | 3 files | 🟡 Needs Work |
-| "as any" assertions | 62 | 15 | 🟡 Moderate |
-| Console.* calls | 129 | 0 | 🔴 Needs Work |
-| Component reuse | 40% | 75% | 🟡 Moderate |
-| Error consistency | 85% | 95% | 🟢 Good |
-| Type coverage | 88% | 95% | 🟢 Good |
-
-## Risk Assessment
-
-### Low Risk Improvements (High Impact):
-- Logging standardization
-- Type assertion cleanup  
-- Missing key attributes
-- Component extraction from AccountViewView.vue
-- Shared component creation (ToggleSwitch, CameraPreview)
-
-### Medium Risk Improvements:
-- PlatformServiceMixin decomposition
-- State management optimization
-- ImageMethodDialog decomposition
-
-### High Risk Items:
-- None identified - project demonstrates excellent architectural discipline
-
-## Conclusion
-
-The TimeSafari codebase demonstrates **exceptional code quality** with:
-
-**Key Strengths:**
-- **Consistent Architecture**: 100% Vue 3 Composition API with TypeScript
-- **Minimal Technical Debt**: Only 6 TODO comments across 291 files
-- **Excellent Small Components**: 68.5% of views and 57.5% of components are well-sized
-- **Strong Type Safety**: Minimal "as any" usage, mostly justified
-- **Clean Logging**: Minimal console.* usage, structured logging preferred
-- **Excellent Database Migration**: 99.5% complete
-- **Comprehensive Error Handling**: 367 catch blocks with good coverage
-- **No Circular Dependencies**: 100% resolved
-
-**Primary Focus Areas:**
-1. **Decompose Large Files**: 5 components and 9 views need refactoring
-2. **Extract Shared Components**: Camera, file upload, and diagnostics components
-3. **Optimize State Management**: Group related properties and create composables
-4. **Improve Type Safety**: Create proper interface extensions for mixin methods
-5. **Logging Standardization**: Replace 129 console.* calls with structured logger.*
-
-**The component architecture is production-ready** with these improvements representing **strategic optimization** rather than critical fixes. The codebase demonstrates **mature Vue.js development practices** with excellent separation of concerns and consistent patterns.
-
----
-
-**Investigation Methodology:**
-- Static analysis of 291 source files (197 general + 94 Vue components/views)
-- Pattern recognition across 104,527 lines of code
-- Manual review of large files and complexity patterns
-- Dependency analysis and coupling assessment
-- Performance anti-pattern identification
-- Architecture consistency evaluation

README-PR-TEMPLATE.md

@@ -66,14 +66,17 @@ test-image.tar  a1b2c3d4e5f6...
 ```
 
 ### Docs
+
 - [x] **BUILDING.md** updated (sections): Docker deployment
 - [x] Troubleshooting updated: Added Docker troubleshooting section
 
 ### Rollback
+
 - [x] Verified steps to restore previous behavior:
   1. `git revert HEAD`
   2. `docker rmi test-image`
   3. Restore previous BUILDING.md
+
 ```
 
 ---

README.md

@@ -11,7 +11,7 @@ See [ClickUp](https://sharing.clickup.com/9014278710/l/h/8cmnyhp-174/10573fec74e
 
 Quick start:
 
-* For setup, we recommend [pkgx](https://pkgx.dev), which installs what you need (either automatically or with the `dev` command). Core dependencies are typescript & npm; when building for other platforms, you'll need other things such as those in the pkgx.yaml & BUILDING.md files.
+- For setup, we recommend [pkgx](https://pkgx.dev), which installs what you need (either automatically or with the `dev` command). Core dependencies are typescript & npm; when building for other platforms, you'll need other things such as those in the pkgx.yaml & BUILDING.md files.
 
 ```bash
 npm install
@@ -68,16 +68,16 @@ TimeSafari supports configurable logging levels via the `VITE_LOG_LEVEL` environ
 
 ```bash
 # Show only errors
-VITE_LOG_LEVEL=error npm run build:web:dev
+VITE_LOG_LEVEL=error npm run dev
 
 # Show warnings and errors
-VITE_LOG_LEVEL=warn npm run build:web:dev
+VITE_LOG_LEVEL=warn npm run dev
 
 # Show info, warnings, and errors (default)
-VITE_LOG_LEVEL=info npm run build:web:dev
+VITE_LOG_LEVEL=info npm run dev
 
 # Show all log levels including debug
-VITE_LOG_LEVEL=debug npm run build:web:dev
+VITE_LOG_LEVEL=debug npm run dev
 ```
 
 ### Available Levels
@@ -90,6 +90,7 @@ VITE_LOG_LEVEL=debug npm run build:web:dev
 See [Logging Configuration Guide](doc/logging-configuration.md) for complete details.
 
 ### Quick Usage
+
 ```bash
 # Run the database clearing script
 ./scripts/clear-database.sh
@@ -102,16 +103,19 @@ npm run build:web:dev       # For Web
 ### What It Does
 
 #### **Electron (Desktop App)**
+
 - Automatically finds and clears the SQLite database files
 - Works on Linux, macOS, and Windows
 - Clears all data and forces fresh migrations on next startup
 
 #### **Web Browser**
+
 - Provides instructions for using custom browser data directories
 - Shows manual clearing via browser DevTools
 - Ensures reliable database clearing without browser complications
 
 ### Safety Features
+
 - ✅ **Interactive Script**: Guides you through the process
 - ✅ **Platform Detection**: Automatically detects your OS
 - ✅ **Clear Instructions**: Step-by-step guidance for each platform
@@ -120,6 +124,7 @@ npm run build:web:dev       # For Web
 ### Manual Commands (if needed)
 
 #### **Electron Database Location**
+
 ```bash
 # Linux
 rm -rf ~/.config/TimeSafari/*
@@ -132,6 +137,7 @@ rmdir /s /q %APPDATA%\TimeSafari
 ```
 
 #### **Web Browser (Custom Data Directory)**
+
 ```bash
 # Create isolated browser profile
 mkdir ~/timesafari-dev-data
@@ -144,6 +150,7 @@ URL generation across all environments. This prevents localhost URLs from
 appearing in shared links during development.
 
 ### Key Features
+
 - ✅ **Production URLs for Sharing**: All copy link buttons use production domain
 - ✅ **Environment-Specific Internal URLs**: Internal operations use appropriate
   environment URLs
@@ -227,6 +234,7 @@ npm run test:prerequisites
 - **Build failures**: Run `npm run check:dependencies` to diagnose environment issues
 
 **Required Versions**:
+
 - Node.js: 18+ (LTS recommended)
 - npm: 8+ (comes with Node.js)
 - Platform-specific tools: Android Studio, Xcode (for mobile builds)
@@ -246,25 +254,26 @@ To add a Font Awesome icon, add to `fontawesome.ts` and reference with
 
 ### Reference Material
 
-* Notifications can be type of `toast` (self-dismiss), `info`, `success`, `warning`, and `danger`.
+- Notifications can be type of `toast` (self-dismiss), `info`, `success`, `warning`, and `danger`.
   They are done via [notiwind](https://www.npmjs.com/package/notiwind) and set up in App.vue.
 
-* [Customize Vue configuration](https://cli.vuejs.org/config/).
+- [Customize Vue configuration](https://cli.vuejs.org/config/).
 
-* If you are deploying in a subdirectory, add it to `publicPath` in vue.config.js, eg: `publicPath: "/app/time-tracker/",`
+- If you are deploying in a subdirectory, add it to `publicPath` in vue.config.js, eg: `publicPath: "/app/time-tracker/",`
 
 ### Code Organization
 
 The project uses a centralized approach to type definitions and interfaces:
 
-* `src/interfaces/` - Contains all TypeScript interfaces and type definitions
-  * `deepLinks.ts` - Deep linking type system and Zod validation schemas
-  * `give.ts` - Give-related interfaces and type definitions
-  * `claims.ts` - Claim-related interfaces and verifiable credentials
-  * `common.ts` - Shared interfaces and utility types
-  * Other domain-specific interface files
+- `src/interfaces/` - Contains all TypeScript interfaces and type definitions
+  - `deepLinks.ts` - Deep linking type system and Zod validation schemas
+  - `give.ts` - Give-related interfaces and type definitions
+  - `claims.ts` - Claim-related interfaces and verifiable credentials
+  - `common.ts` - Shared interfaces and utility types
+  - Other domain-specific interface files
 
 Key principles:
+
 - All interfaces and types are defined in the interfaces folder
 - Zod schemas are used for runtime validation and type generation
 - Domain-specific interfaces are separated into their own files
@@ -275,11 +284,11 @@ Key principles:
 
 The application uses a platform-agnostic database layer with Vue mixins for service access:
 
-* `src/services/PlatformService.ts` - Database interface definition
-* `src/services/PlatformServiceFactory.ts` - Platform-specific service factory
-* `src/services/AbsurdSqlDatabaseService.ts` - SQLite implementation
-* `src/utils/PlatformServiceMixin.ts` - Vue mixin for database access with caching
-* `src/db/` - Legacy Dexie database (migration in progress)
+- `src/services/PlatformService.ts` - Database interface definition
+- `src/services/PlatformServiceFactory.ts` - Platform-specific service factory
+- `src/services/AbsurdSqlDatabaseService.ts` - SQLite implementation
+- `src/utils/PlatformServiceMixin.ts` - Vue mixin for database access with caching
+- `src/db/` - Legacy Dexie database (migration in progress)
 
 **Development Guidelines**:
 
@@ -305,17 +314,6 @@ timesafari/
 └── 📄 doc/README-BUILD-GUARD.md # Guard system documentation
 ```
 
-## Known Issues
-
-### Critical Vue Reactivity Bug
-A critical Vue reactivity bug was discovered during ActiveDid migration testing where component properties fail to trigger template updates correctly.
-
-**Impact**: The `newDirectOffersActivityNumber` element in HomeView.vue requires a watcher workaround to render correctly.
-
-**Status**: Workaround implemented, investigation ongoing.
-
-**Documentation**: See [Vue Reactivity Bug Report](doc/vue-reactivity-bug-report.md) for details.
-
 ## 🤝 Contributing
 
 1. **Follow the Build Architecture Guard** - Update BUILDING.md when modifying build files
@@ -327,11 +325,11 @@ A critical Vue reactivity bug was discovered during ActiveDid migration testing
 
 Gifts make the world go 'round!
 
-* [WebStorm by JetBrains](https://www.jetbrains.com/webstorm/) for the free open-source license
-* [Máximo Fernández](https://medium.com/@maxfarenas) for the 3D [code](https://github.com/maxfer03/vue-three-ns) and [explanatory post](https://medium.com/nicasource/building-an-interactive-web-portfolio-with-vue-three-js-part-three-implementing-three-js-452cb375ef80)
-* [Many tools & libraries](https://gitea.anomalistdesign.com/trent_larson/crowd-funder-for-time-pwa/src/branch/master/package.json#L10) such as Nodejs.org, IntelliJ Idea, Veramo.io, Vuejs.org, threejs.org
-* [Bush 3D model](https://sketchfab.com/3d-models/lupine-plant-bf30f1110c174d4baedda0ed63778439)
-* [Forest floor image](https://www.goodfreephotos.com/albums/textures/leafy-autumn-forest-floor.jpg)
-* Time Safari logo assisted by [DALL-E in ChatGPT](https://chat.openai.com/g/g-2fkFE8rbu-dall-e)
-* [DiceBear](https://www.dicebear.com/licenses/) and [Avataaars](https://www.dicebear.com/styles/avataaars/#details) for human-looking identicons
-* Some gratitude prompts thanks to [Develop Good Habits](https://www.developgoodhabits.com/gratitude-journal-prompts/)
+- [WebStorm by JetBrains](https://www.jetbrains.com/webstorm/) for the free open-source license
+- [Máximo Fernández](https://medium.com/@maxfarenas) for the 3D [code](https://github.com/maxfer03/vue-three-ns) and [explanatory post](https://medium.com/nicasource/building-an-interactive-web-portfolio-with-vue-three-js-part-three-implementing-three-js-452cb375ef80)
+- [Many tools & libraries](https://gitea.anomalistdesign.com/trent_larson/crowd-funder-for-time-pwa/src/branch/master/package.json#L10) such as Nodejs.org, IntelliJ Idea, Veramo.io, Vuejs.org, threejs.org
+- [Bush 3D model](https://sketchfab.com/3d-models/lupine-plant-bf30f1110c174d4baedda0ed63778439)
+- [Forest floor image](https://www.goodfreephotos.com/albums/textures/leafy-autumn-forest-floor.jpg)
+- Time Safari logo assisted by [DALL-E in ChatGPT](https://chat.openai.com/g/g-2fkFE8rbu-dall-e)
+- [DiceBear](https://www.dicebear.com/licenses/) and [Avataaars](https://www.dicebear.com/styles/avataaars/#details) for human-looking identicons
+- Some gratitude prompts thanks to [Develop Good Habits](https://www.developgoodhabits.com/gratitude-journal-prompts/)

TASK_storage.md

@@ -5,33 +5,33 @@
 
 We can't trust iOS IndexedDB to persist. I want to start delivering an app to people now, in preparation for presentations mid-June: Rotary on June 12 and Porcfest on June 17.
 
-* Apple WebKit puts a [7-day cap on IndexedDB](https://webkit.org/blog/10218/full-third-party-cookie-blocking-and-more/).
+- Apple WebKit puts a [7-day cap on IndexedDB](https://webkit.org/blog/10218/full-third-party-cookie-blocking-and-more/).
 
-  * The web standards expose a `persist` method to mark memory as persistent, and [supposedly WebView supports it](https://developer.mozilla.org/en-US/docs/Web/API/StorageManager/persisted), but too many other things indicate it's not reliable. I've talked with [ChatGPT](https://chatgpt.com/share/68322f40-84c8-8007-b213-855f7962989a) & Venice & Claude (in Cursor); [this answer from Perplexity](https://www.perplexity.ai/search/which-platforms-prompt-the-use-HUQLqy4qQD2cRbkmO4CgHg) says that most platforms don't prompt and Safari doesn't support it; I don't know if that means WebKit as well.
+  - The web standards expose a `persist` method to mark memory as persistent, and [supposedly WebView supports it](https://developer.mozilla.org/en-US/docs/Web/API/StorageManager/persisted), but too many other things indicate it's not reliable. I've talked with [ChatGPT](https://chatgpt.com/share/68322f40-84c8-8007-b213-855f7962989a) & Venice & Claude (in Cursor); [this answer from Perplexity](https://www.perplexity.ai/search/which-platforms-prompt-the-use-HUQLqy4qQD2cRbkmO4CgHg) says that most platforms don't prompt and Safari doesn't support it; I don't know if that means WebKit as well.
 
-* Capacitor says [not to trust it on iOS](https://capacitorjs.com/docs/v6/guides/storage).
+- Capacitor says [not to trust it on iOS](https://capacitorjs.com/docs/v6/guides/storage).
 
 Also, with sensitive data, the accounts info should be encrypted.
 
 # Options
 
-* There is a community [SQLite plugin for Capacitor](https://github.com/capacitor-community/sqlite) with encryption by [SQLCipher](https://github.com/sqlcipher/sqlcipher).
+- There is a community [SQLite plugin for Capacitor](https://github.com/capacitor-community/sqlite) with encryption by [SQLCipher](https://github.com/sqlcipher/sqlcipher).
 
-  * [This tutorial](https://jepiqueau.github.io/2023/09/05/Ionic7Vue-SQLite-CRUD-App.html#part-1---web---table-of-contents) shows how that plugin works for web as well as native.
+  - [This tutorial](https://jepiqueau.github.io/2023/09/05/Ionic7Vue-SQLite-CRUD-App.html#part-1---web---table-of-contents) shows how that plugin works for web as well as native.
 
-* Capacitor abstracts [user preferences in an API](https://capacitorjs.com/docs/apis/preferences), which uses different underlying libraries on iOS & Android. Unfortunately, it won't do any filtering or searching, and is only meant for small amounts of data. (It could be used for settings and for identifiers, but contacts will grow and image blobs won't work.)
+- Capacitor abstracts [user preferences in an API](https://capacitorjs.com/docs/apis/preferences), which uses different underlying libraries on iOS & Android. Unfortunately, it won't do any filtering or searching, and is only meant for small amounts of data. (It could be used for settings and for identifiers, but contacts will grow and image blobs won't work.)
 
-  * There are hints that Capacitor offers another custom storage API but all I could find was that Preferences API.
+  - There are hints that Capacitor offers another custom storage API but all I could find was that Preferences API.
 
-* [Ionic Storage](https://ionic.io/docs/secure-storage) is an enterprise solution, which also supports encryption.
+- [Ionic Storage](https://ionic.io/docs/secure-storage) is an enterprise solution, which also supports encryption.
 
-* Not an option yet: Dexie may support SQLite in [a future version](https://dexie.org/roadmap/dexie5.0).
+- Not an option yet: Dexie may support SQLite in [a future version](https://dexie.org/roadmap/dexie5.0).
 
 # Current Plan
 
-* Implement SQLite for Capacitor & web, with encryption. That will allow us to test quickly and keep the same interface for native & web, but we don't deal with migrations for current web users.
+- Implement SQLite for Capacitor & web, with encryption. That will allow us to test quickly and keep the same interface for native & web, but we don't deal with migrations for current web users.
 
-* After that is delivered, write a migration for current web users from IndexedDB to SQLite.
+- After that is delivered, write a migration for current web users from IndexedDB to SQLite.
 
 # Current method calls
 

android/app/build.gradle

@@ -31,8 +31,8 @@ android {
         applicationId "app.timesafari.app"
         minSdkVersion rootProject.ext.minSdkVersion
         targetSdkVersion rootProject.ext.targetSdkVersion
-        versionCode 41
-        versionName "1.0.8"
+        versionCode 40
+        versionName "1.0.7"
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         aaptOptions {
              // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.

doc/GLOSSARY.md

@@ -0,0 +1,21 @@
+# Glossary
+
+**T (slot time)** — The local wall-clock time a notification should fire (e.g., 08:00).
+
+**T–lead** — The moment **`prefetchLeadMinutes`** before **T** when the system *attempts* a **single** background prefetch. T–lead **controls prefetch attempts, not arming**; locals are pre-armed earlier to guarantee closed-app delivery.
+
+**Rolling window** — Always keep **today's remaining** (and tomorrow if iOS pending caps allow) locals **armed** so the OS can deliver while the app is closed.
+
+**TTL (time-to-live)** — Maximum allowed payload age **at fire time**. If `T − fetchedAt > ttlSeconds`, we **skip** arming for that T.
+
+**Shared DB (default)** — The app and plugin open the **same SQLite file**; the app owns schema/migrations, the plugin performs short writes with WAL.
+
+**WAL (Write-Ahead Logging)** — SQLite journaling mode that permits concurrent reads during writes; recommended for foreground-read + background-write.
+
+**`PRAGMA user_version`** — An integer the app increments on each migration; the plugin **checks** (does not migrate) to ensure compatibility.
+
+**Exact alarm (Android)** — Minute-precise alarm via `AlarmManager.setExactAndAllowWhileIdle`, subject to policy and permission.
+
+**Windowed alarm (Android)** — Batched/inexact alarm via `setWindow(start,len)`; we target **±10 minutes** when exact alarms are unavailable.
+
+**Start-on-Login** — Electron feature that automatically launches the application when the user logs into their system, enabling background notification scheduling and delivery after system reboot.

doc/README-BUILD-GUARD.md

@@ -330,6 +330,7 @@ Track the effectiveness of your Build Architecture Guard:
 ## 📝 **Changelog**
 
 ### 2025-08-22 - Shell Compatibility Fix
+
 - **Fixed**: Replaced `mapfile` command with portable alternative for cross-shell compatibility
 - **Impact**: Resolves "mapfile: command not found" errors in pre-commit hooks
 - **Files**: `scripts/build-arch-guard.sh`

doc/README.md

@@ -1,77 +1,11 @@
-# TimeSafari Docs
+# TimeSafari — Native-First Notification System (Clean Pack) — 2025-09-07
 
-## Generating PDF from Markdown on OSx
+This pack contains a single-version **Native-First** documentation set with a clear definition of **T–lead** and aligned terminology.
 
-This uses Pandoc and BasicTex (LaTeX) Installed through Homebrew.
+**Native-First =** OS-scheduled **background prefetch at T–lead** + **pre-armed one-shot local notifications**. Web-push is retired.
 
-### Set Up
+**Included files**
 
-```bash
-brew install pandoc
-
-brew install basictex
-
-# Setting up LaTex packages
-
-# First update tlmgr
-sudo tlmgr update --self
-
-# Then install LaTex packages
-sudo tlmgr install bbding
-sudo tlmgr install enumitem
-sudo tlmgr install environ
-sudo tlmgr install fancyhdr
-sudo tlmgr install framed
-sudo tlmgr install import
-sudo tlmgr install lastpage  # Enables Page X of Y
-sudo tlmgr install mdframed
-sudo tlmgr install multirow
-sudo tlmgr install needspace
-sudo tlmgr install ntheorem
-sudo tlmgr install tabu
-sudo tlmgr install tcolorbox
-sudo tlmgr install textpos
-sudo tlmgr install titlesec
-sudo tlmgr install titling  # Required for the fancy headers used
-sudo tlmgr install threeparttable
-sudo tlmgr install trimspaces
-sudo tlmgr install tocloft  # Required for \tableofcontents generation
-sudo tlmgr install varwidth
-sudo tlmgr install wrapfig
-
-# Install fonts
-sudo tlmgr install cmbright
-sudo tlmgr install collection-fontsrecommended # And set up fonts
-sudo tlmgr install fira
-sudo tlmgr install fontaxes
-sudo tlmgr install libertine # The main font the doc uses
-sudo tlmgr install opensans
-sudo tlmgr install sourceserifpro
-
-```
-
-#### References
-
-The following guide was adapted to this project except that we install with Brew and have a few more packages.
-
-Guide: <https://daniel.feldroy.com/posts/setting-up-latex-on-mac-os-x>
-
-### Usage
-
-Use the `pandoc` command to generate a PDF.
-
-```bash
-pandoc usage-guide.md -o usage-guide.pdf 
-```
-
-And you can open the PDF with the `open` command.
-
-```bash
-open usage-guide.pdf
-```
-
-Or use this one-liner
-
-```bash
-pandoc usage-guide.md -o usage-guide.pdf && open usage-guide.pdf
-```
+- `notification-system.md` (merged comprehensive guide)
+- `web-push-cleanup-guide.md` (cleanup instructions)
+- `GLOSSARY.md` (definitions incl. **T** and **T–lead**)

doc/WORKER_ONLY_DATABASE_IMPLEMENTATION.md

@@ -117,25 +117,25 @@ async function getDatabaseService() {
 
 ## Files Modified
 
-1. **src/interfaces/worker-messages.ts** *(NEW)*
+1. **src/interfaces/worker-messages.ts** _(NEW)_
    - Type definitions for worker communication
    - Request and response message interfaces
 
-2. **src/registerSQLWorker.js** *(MAJOR REWRITE)*
+2. **src/registerSQLWorker.js** _(MAJOR REWRITE)_
    - Message-based operation handling
    - **Fixed circular dependency with lazy loading**
    - Proper error handling and response formatting
 
-3. **src/services/platforms/WebPlatformService.ts** *(MAJOR REWRITE)*
+3. **src/services/platforms/WebPlatformService.ts** _(MAJOR REWRITE)_
    - Worker-only database access
    - Message sending and response handling
    - Timeout and error management
 
-4. **src/main.web.ts** *(SIMPLIFIED)*
+4. **src/main.web.ts** _(SIMPLIFIED)_
    - Removed duplicate worker creation
    - Simplified initialization flow
 
-5. **WORKER_ONLY_DATABASE_IMPLEMENTATION.md** *(NEW)*
+5. **WORKER_ONLY_DATABASE_IMPLEMENTATION.md** _(NEW)_
    - Complete documentation of changes
 
 ## Benefits

doc/active-identity-upgrade-plan.md

@@ -1,390 +0,0 @@
-# Active Identity Upgrade Plan
-
-**Author**: Matthew Raymer  
-**Date**: 2025-09-11  
-**Status**: 🎯 **PLANNING** - Database migration and active identity system upgrade
-
-## Overview
-
-Comprehensive upgrade to the active identity system, addressing architectural issues and implementing enhanced database constraints. Includes database migration enhancements and settings table cleanup based on team feedback.
-
-## Implementation Status
-
-**✅ COMPLETED**: Migration structure updated according to team member feedback
-
-### Implemented Changes
-
-1. **✅ Migration 003**: `003_add_hasBackedUpSeed_to_settings` - Adds `hasBackedUpSeed` column to settings (assumes master deployment)
-2. **✅ Migration 004**: `004_active_identity_and_seed_backup` - Creates `active_identity` table with data migration
-3. **✅ Migration Service**: Updated validation and schema detection logic for new migration structure
-4. **✅ TypeScript**: Fixed type compatibility issues
-
-### Migration Structure Now Follows Team Guidance
-
-- **Migration 003**: `003_add_hasBackedUpSeed_to_settings` (assumes master code deployed)
-- **Migration 004**: `004_active_identity_and_seed_backup` (creates active_identity table)
-- **All migrations are additional** - no editing of previous migrations
-- **Data migration logic** preserves existing `activeDid` from settings
-- **iOS/Android compatibility** confirmed with SQLCipher 4.9.0 (SQLite 3.44.2)
-
-## Educational Context
-
-### Why This Upgrade Matters
-
-The active identity system is **critical infrastructure** affecting every user interaction:
-
-1. **Data Integrity**: Current `ON DELETE SET NULL` allows accidental deletion of active accounts
-2. **Manual Maintenance**: Timestamps require manual updates, creating inconsistency opportunities
-3. **Architectural Clarity**: Separating active identity from user settings improves maintainability
-
-### What This Upgrade Achieves
-
-- **Prevents Data Loss**: `ON DELETE RESTRICT` prevents accidental account deletion
-- **Automatic Consistency**: Database triggers ensure timestamps are always current
-- **Cleaner Architecture**: Complete separation of identity management from user preferences
-- **Better Performance**: Optimized indexes for faster account selection
-
-## Current State Analysis
-
-### Existing Migration Structure
-
-- **Migration 003**: `003_add_hasBackedUpSeed_to_settings` - Adds `hasBackedUpSeed` column to settings (already deployed in master)
-- **Migration 004**: `004_active_identity_and_seed_backup` - Creates `active_identity` table with data migration
-- **Foreign Key**: `ON DELETE SET NULL` constraint
-- **Data Migration**: Copies existing `activeDid` from settings to `active_identity` table
-- **Bootstrapping**: Auto-selects first account if `activeDid` is null/empty
-
-**Important**: All migrations are **additional** - no editing of previous migrations since master code has been deployed.
-
-### Current Schema (Migration 004) - IMPLEMENTED
-
-```sql
--- Migration 004: active_identity_and_seed_backup
--- Assumes master code deployed with migration 003
-
-PRAGMA foreign_keys = ON;
-CREATE UNIQUE INDEX IF NOT EXISTS idx_accounts_did_unique ON accounts(did);
-
-CREATE TABLE IF NOT EXISTS active_identity (
-  id INTEGER PRIMARY KEY CHECK (id = 1),
-  activeDid TEXT DEFAULT NULL,
-  lastUpdated TEXT NOT NULL DEFAULT (datetime('now')),
-  FOREIGN KEY (activeDid) REFERENCES accounts(did) ON DELETE SET NULL
-);
-
-CREATE UNIQUE INDEX IF NOT EXISTS idx_active_identity_single_record ON active_identity(id);
-
--- Seed singleton row
-INSERT INTO active_identity (id, activeDid, lastUpdated)
-SELECT 1, NULL, datetime('now')
-WHERE NOT EXISTS (SELECT 1 FROM active_identity WHERE id = 1);
-
--- MIGRATE EXISTING DATA: Copy activeDid from settings
-UPDATE active_identity
-SET activeDid = (SELECT activeDid FROM settings WHERE id = 1),
-    lastUpdated = datetime('now')
-WHERE id = 1
-AND EXISTS (SELECT 1 FROM settings WHERE id = 1 AND activeDid IS NOT NULL AND activeDid != '');
-```
-
-## Current Implementation Details
-
-### PlatformServiceMixin.ts Implementation
-
-The current `$getActiveIdentity()` method in `src/utils/PlatformServiceMixin.ts`:
-
-```typescript
-async $getActiveIdentity(): Promise<{ activeDid: string }> {
-  try {
-    const result = await this.$dbQuery("SELECT activeDid FROM active_identity WHERE id = 1");
-    
-    if (!result?.values?.length) {
-      logger.warn("[PlatformServiceMixin] Active identity table is empty - migration issue");
-      return { activeDid: "" };
-    }
-
-    const activeDid = result.values[0][0] as string | null;
-
-    // Handle null activeDid - auto-select first account
-    if (activeDid === null) {
-      const firstAccount = await this.$dbQuery("SELECT did FROM accounts ORDER BY dateCreated, did LIMIT 1");
-      if (firstAccount?.values?.length) {
-        const firstAccountDid = firstAccount.values[0][0] as string;
-        await this.$dbExec("UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1", [firstAccountDid]);
-        return { activeDid: firstAccountDid };
-      }
-      logger.warn("[PlatformServiceMixin] No accounts available for auto-selection");
-      return { activeDid: "" };
-    }
-
-    // Validate activeDid exists in accounts
-    const accountExists = await this.$dbQuery("SELECT did FROM accounts WHERE did = ?", [activeDid]);
-    if (accountExists?.values?.length) {
-      return { activeDid };
-    }
-
-    // Clear corrupted activeDid and return empty
-    logger.warn("[PlatformServiceMixin] Active identity not found in accounts, clearing");
-    await this.$dbExec("UPDATE active_identity SET activeDid = NULL, lastUpdated = datetime('now') WHERE id = 1");
-    return { activeDid: "" };
-  } catch (error) {
-    logger.error("[PlatformServiceMixin] Error getting active identity:", error);
-    return { activeDid: "" };
-  }
-}
-```
-
-### Key Implementation Notes
-
-1. **Null Handling**: Auto-selects first account when `activeDid` is null
-2. **Corruption Detection**: Clears invalid `activeDid` values
-3. **Manual Timestamps**: Updates `lastUpdated` manually in code
-4. **Error Handling**: Returns empty string on any error with appropriate logging
-
-## Proposed Changes Impact
-
-### 1. Foreign Key Constraint Change
-**Current**: `ON DELETE SET NULL` → **Proposed**: `ON DELETE RESTRICT`
-- **Data Safety**: Prevents accidental deletion of active account
-- **New Migration**: Add migration 005 to update constraint
-
-### 2. Automatic Timestamp Updates
-**Current**: Manual `lastUpdated` updates → **Proposed**: Database trigger
-- **Code Simplification**: Remove manual timestamp updates from `PlatformServiceMixin`
-- **Consistency**: Ensures `lastUpdated` is always current
-
-### 3. Enhanced Indexing
-**Current**: Single unique index on `id` → **Proposed**: Additional index on `accounts(dateCreated, did)`
-- **Performance Improvement**: Faster account selection queries
-- **Minimal Risk**: Additive change only
-
-## Implementation Strategy
-
-### Add Migration 005
-
-Since the `active_identity` table already exists and is working, we can add a new migration to enhance it:
-
-```sql
-{
-  name: "005_active_identity_enhancements",
-  sql: `
-    PRAGMA foreign_keys = ON;
-    
-    -- Recreate table with ON DELETE RESTRICT constraint
-    CREATE TABLE active_identity_new (
-      id INTEGER PRIMARY KEY CHECK (id = 1),
-      activeDid TEXT REFERENCES accounts(did) ON DELETE RESTRICT,
-      lastUpdated TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-    
-    -- Copy existing data
-    INSERT INTO active_identity_new (id, activeDid, lastUpdated)
-    SELECT id, activeDid, lastUpdated FROM active_identity;
-    
-    -- Replace old table
-    DROP TABLE active_identity;
-    ALTER TABLE active_identity_new RENAME TO active_identity;
-    
-    -- Add performance indexes
-    CREATE INDEX IF NOT EXISTS idx_accounts_pick ON accounts(dateCreated, did);
-    
-    -- Create automatic timestamp trigger
-    CREATE TRIGGER IF NOT EXISTS trg_active_identity_touch
-    AFTER UPDATE ON active_identity
-    FOR EACH ROW
-    BEGIN
-      UPDATE active_identity
-        SET lastUpdated = datetime('now')
-        WHERE id = 1;
-    END;
-  `
-}
-```
-
-## Migration Service Updates Required
-
-### Enhanced Validation Logic
-
-**File**: `src/services/migrationService.ts`
-
-**Migration 004 validation**:
-- **Table existence**: `SELECT name FROM sqlite_master WHERE type='table' AND name='active_identity'`
-- **Column structure**: `SELECT id, activeDid, lastUpdated FROM active_identity LIMIT 1`
-- **Schema detection**: Uses `isSchemaAlreadyPresent()` to check if migration was already applied
-
-**Migration 005 validation**:
-- **Trigger existence**: `trg_active_identity_touch`
-- **Performance index**: `idx_accounts_pick`
-- **Foreign key constraint**: `ON DELETE RESTRICT`
-- **Table recreation**: Verify table was successfully recreated
-
-### Enhanced Schema Detection
-
-**Migration 004 verification**:
-- **Table structure**: Checks `active_identity` table exists and has correct columns
-- **Data integrity**: Validates that the table can be queried successfully
-- **Migration tracking**: Uses `isSchemaAlreadyPresent()` to avoid re-applying migrations
-
-**Migration 005 verification**:
-- **Table structure**: Enhanced constraints with `ON DELETE RESTRICT`
-- **Trigger presence**: Automatic timestamp updates
-- **Index presence**: Performance optimization
-- **Data integrity**: Existing data was preserved during table recreation
-
-## Risk Assessment
-
-### Low Risk Changes
-- **Performance Index**: Additive only, no data changes
-- **Trigger Creation**: Additive only, improves consistency
-- **New Migration**: Clean implementation, no modification of existing migrations
-
-### Medium Risk Changes
-- **Foreign Key Change**: `ON DELETE RESTRICT` is more restrictive
-- **Table Recreation**: Requires careful data preservation
-- **Validation Updates**: Need to test enhanced validation logic
-
-### Mitigation Strategies
-1. **Comprehensive Testing**: Test migration on various database states
-2. **Data Preservation**: Verify existing data is copied correctly
-3. **Clean Implementation**: New migration with all enhancements
-4. **Validation Coverage**: Enhanced validation ensures correctness
-5. **Rollback Plan**: Can drop new table and restore original if needed
-
-## Implementation Timeline
-
-### Phase 1: Migration Enhancement
-- [ ] Add migration 005 with enhanced constraints
-- [ ] Add enhanced validation logic
-- [ ] Add enhanced schema detection logic
-- [ ] Test migration on clean database
-
-### Phase 2: Testing
-- [ ] Test migration on existing databases
-- [ ] Validate foreign key constraints work correctly
-- [ ] Test trigger functionality
-- [ ] Test performance improvements
-- [ ] Verify data preservation during table recreation
-
-### Phase 3: Deployment
-- [ ] Deploy enhanced migration to development
-- [ ] Monitor migration success rates
-- [ ] Deploy to production
-- [ ] Monitor for any issues
-
-### Phase 4: Settings Table Cleanup
-- [ ] Create migration 006 to clean up settings table
-- [ ] Remove orphaned settings records (accountDid is null)
-- [ ] Clear any remaining activeDid values in settings
-- [ ] Consider removing activeDid column entirely (future task)
-
-## Settings Table Cleanup Strategy
-
-### Current State Analysis
-The settings table currently contains:
-- **Legacy activeDid column**: Still present from original design
-- **Orphaned records**: Settings with `accountDid = null` that may be obsolete
-- **Redundant data**: Some settings may have been copied unnecessarily
-
-Based on team feedback, the cleanup should include:
-
-1. **Remove orphaned settings records**:
-   ```sql
-   DELETE FROM settings WHERE accountDid IS NULL;
-   ```
-
-2. **Clear any remaining activeDid values**:
-   ```sql
-   UPDATE settings SET activeDid = NULL;
-   ```
-
-3. **Future consideration**: Remove the activeDid column entirely from settings table
-
-### Migration 006: Settings Cleanup
-
-```sql
-{
-  name: "006_settings_cleanup",
-  sql: `
-    -- Remove orphaned settings records (accountDid is null)
-    DELETE FROM settings WHERE accountDid IS NULL;
-    
-    -- Clear any remaining activeDid values in settings
-    UPDATE settings SET activeDid = NULL;
-    
-    -- Optional: Consider removing the activeDid column entirely
-    -- ALTER TABLE settings DROP COLUMN activeDid;
-  `
-}
-```
-
-### Benefits of Settings Cleanup
-- **Reduced confusion**: Eliminates dual-purpose columns
-- **Cleaner architecture**: Settings table focuses only on user preferences
-- **Reduced storage**: Removes unnecessary data
-- **Clearer separation**: Active identity vs. user settings are distinct concerns
-
-### Risk Assessment: LOW
-- **Data safety**: Only removes orphaned/obsolete records
-- **Backward compatibility**: Maintains existing column structure
-- **Rollback**: Easy to restore if needed
-- **Testing**: Can be validated with existing data
-
-## Code Changes Required
-
-### Files to Modify
-1. **`src/db-sql/migration.ts`** - Add migration 005 with enhanced constraints
-2. **`src/db-sql/migration.ts`** - Add migration 006 for settings cleanup
-3. **`src/services/migrationService.ts`** - Add enhanced validation and detection logic
-4. **`src/utils/PlatformServiceMixin.ts`** - Remove manual timestamp updates
-
-### Estimated Impact
-- **Migration File**: ~25 lines added (migration 005) + ~15 lines added (migration 006)
-- **Migration Service**: ~50 lines added (enhanced validation)
-- **PlatformServiceMixin**: ~20 lines removed (manual timestamps)
-- **Total**: ~90 lines changed
-
-## Conclusion
-
-**✅ IMPLEMENTATION COMPLETE**: The active identity upgrade plan has been successfully applied to the current project.
-
-### Successfully Implemented
-
-**✅ Migration Structure Updated**:
-- **Migration 003**: `003_add_hasBackedUpSeed_to_settings` (assumes master deployment)
-- **Migration 004**: `004_active_identity_and_seed_backup` (creates active_identity table)
-- **All migrations are additional** - follows team member feedback exactly
-
-**✅ Technical Implementation**:
-- **Data Migration**: Preserves existing `activeDid` from settings table
-- **Foreign Key Constraints**: `ON DELETE SET NULL` for data safety
-- **iOS/Android Compatibility**: Confirmed with SQLCipher 4.9.0 (SQLite 3.44.2)
-- **Migration Service**: Updated validation and schema detection logic
-
-**✅ Code Quality**:
-- **TypeScript**: All type errors resolved
-- **Linting**: No linting errors
-- **Team Guidance**: Follows "additional migrations only" requirement
-
-### Next Steps (Future Enhancements)
-
-The foundation is now in place for future enhancements:
-
-1. **Migration 005**: `005_active_identity_enhancements` (ON DELETE RESTRICT, triggers, indexes)
-2. **Migration 006**: `006_settings_cleanup` (remove orphaned settings, clear legacy activeDid)
-3. **Code Simplification**: Remove manual timestamp updates from PlatformServiceMixin
-
-### Current Status
-
-**Migration 004 is ready for deployment** and will:
-- ✅ Create `active_identity` table with proper constraints
-- ✅ Migrate existing `activeDid` data from settings
-- ✅ Work identically on iOS and Android
-- ✅ Follow team member feedback for additional migrations only
-
-**Key Point**: All migrations are **additional** - no editing of previous migrations since master code has been deployed. This ensures compatibility and proper testing.
-
----
-
-**Status**: Ready for team review and implementation approval  
-**Last Updated**: 2025-09-11  
-**Next Review**: After team feedback and approval

doc/active-pointer-smart-deletion-pattern.md

@@ -1,392 +0,0 @@
-# Engineering Directive v2 — Active Pointer + Smart Deletion Pattern (hardened)
-
-**Author**: Matthew Raymer  
-**Date**: 2025-01-27  
-**Status**: 🎯 **ACTIVE** - Production-grade engineering directive for implementing smart deletion patterns
-
-## Overview
-
-This supersedes the previous draft and is **copy-pasteable** for any `<model>`. It keeps UX smooth, guarantees data integrity, and adds production-grade safeguards (bootstrapping, races, soft deletes, bulk ops, and testability). Built on your prior pattern.
-
-## 0) Objectives (non-negotiable)
-
-1. Exactly **one active `<model>`** pointer (or `NULL` during first-run).
-2. **Block deletion** when it would leave **zero** `<models>`.
-3. If deleting the **active** item, **atomically re-point** to a deterministic **next** item **before** delete.
-4. Enforce with **app logic** + **FK `RESTRICT`** (and `ON UPDATE CASCADE` if `ref` can change).
-
----
-
-## 1) Schema / Migration (SQLite)
-
-```sql
--- <timestamp>__active_<model>.sql
-PRAGMA foreign_keys = ON;
-
--- Stable external key on <models> (e.g., did/slug/uuid)
--- ALTER TABLE <models> ADD COLUMN ref TEXT UNIQUE NOT NULL; -- if missing
-
-CREATE TABLE IF NOT EXISTS active_<model> (
-  id INTEGER PRIMARY KEY CHECK (id = 1),
-  activeRef TEXT UNIQUE, -- allow NULL on first run
-  lastUpdated TEXT NOT NULL DEFAULT (datetime('now')),
-  FOREIGN KEY (activeRef) REFERENCES <models>(ref)
-    ON UPDATE CASCADE
-    ON DELETE RESTRICT
-);
-
--- Seed singleton row (idempotent)
-INSERT INTO active_<model> (id, activeRef)
-SELECT 1, NULL
-WHERE NOT EXISTS (SELECT 1 FROM active_<model> WHERE id = 1);
-```
-
-**Rules**
-
-* **Never** default `activeRef` to `''`—use `NULL` for "no selection yet".
-* Ensure `PRAGMA foreign_keys = ON` for **every connection**.
-
----
-
-## 2) Data Access API (TypeScript)
-
-```ts
-// Required DAL
-async function getAllRefs(): Promise<string[]> { /* SELECT ref FROM <models> ORDER BY created_at, ref */ }
-async function getRefById(id: number): Promise<string> { /* SELECT ref FROM <models> WHERE id=? */ }
-async function getActiveRef(): Promise<string|null> { /* SELECT activeRef FROM active_<model> WHERE id=1 */ }
-async function setActiveRef(ref: string|null): Promise<void> { /* UPDATE active_<model> SET activeRef=?, lastUpdated=datetime('now') WHERE id=1 */ }
-async function deleteById(id: number): Promise<void> { /* DELETE FROM <models> WHERE id=? */ }
-async function countModels(): Promise<number> { /* SELECT COUNT(*) FROM <models> */ }
-
-// Deterministic "next"
-function pickNextRef(all: string[], current?: string): string {
-  const sorted = [...all].sort();
-  if (!current) return sorted[0];
-  const i = sorted.indexOf(current);
-  return sorted[(i + 1) % sorted.length];
-}
-```
-
----
-
-## 3) Smart Delete (Atomic, Race-safe)
-
-```ts
-async function smartDeleteModelById(id: number, notify: (m: string) => void) {
-  await db.transaction(async trx => {
-    const total = await countModels();
-    if (total <= 1) {
-      notify("Cannot delete the last item. Keep at least one.");
-      throw new Error("blocked:last-item");
-    }
-
-    const refToDelete = await getRefById(id);
-    const activeRef   = await getActiveRef();
-
-    if (activeRef === refToDelete) {
-      const all = (await getAllRefs()).filter(r => r !== refToDelete);
-      const next = pickNextRef(all, refToDelete);
-      await setActiveRef(next);
-      notify(`Switched active to ${next} before deletion.`);
-    }
-
-    await deleteById(id); // RESTRICT prevents orphaning if we forgot to switch
-  });
-
-  // Post-tx: emit events / refresh UI
-}
-```
-
----
-
-## 4) Bootstrapping & Repair
-
-```ts
-async function ensureActiveSelected() {
-  const active = await getActiveRef();
-  const all = await getAllRefs();
-  if (active === null && all.length > 0) {
-    await setActiveRef(pickNextRef(all)); // first stable choice
-  }
-}
-```
-
-Invoke after migrations and after bulk imports.
-
----
-
-## 5) Concurrency & Crash Safety
-
-* **Always** wrap "switch → delete" inside a **single transaction**.
-* Treat any FK violation as a **logic regression**; surface telemetry (`fk:restrict`).
-
----
-
-## 6) Soft Deletes (if applicable)
-
-If `<models>` uses `deleted_at`:
-
-* Replace `DELETE` with `UPDATE <models> SET deleted_at = datetime('now') WHERE id=?`.
-* Add a **partial uniqueness** strategy for `ref`:
-
-  * SQLite workaround: make `ref` unique globally and never reuse; or maintain a shadow `refs` ledger to prevent reuse.
-* Adjust `getAllRefs()` to filter `WHERE deleted_at IS NULL`.
-
----
-
-## 7) Bulk Ops & Imports
-
-* For batch deletes:
-
-  1. Compute survivors.
-  2. If a batch would remove **all** survivors → **refuse**.
-  3. If the **active** is included, precompute a deterministic **new active** and set it **once** before deleting.
-* After imports, run `ensureActiveSelected()`.
-
----
-
-## 8) Multi-Scope Actives (optional)
-
-To support **one active per workspace/tenant**:
-
-* Replace singleton with scoped pointer:
-
-  ```sql
-  CREATE TABLE active_<model> (
-    scope TEXT NOT NULL,        -- e.g., workspace_id
-    activeRef TEXT,
-    lastUpdated TEXT NOT NULL DEFAULT (datetime('now')),
-    PRIMARY KEY (scope),
-    FOREIGN KEY (activeRef) REFERENCES <models>(ref) ON UPDATE CASCADE ON DELETE RESTRICT
-  );
-  ```
-* All APIs gain `scope` parameter; transactions remain unchanged in spirit.
-
----
-
-## 9) UX Contract
-
-* Delete confirmation must state:
-
-  * Deleting the **active** item will **auto-switch**.
-  * Deleting the **last** item is **not allowed**.
-* Keep list ordering aligned with `pickNextRef` strategy for predictability.
-
----
-
-## 10) Observability
-
-* Log categories:
-
-  * `blocked:last-item`
-  * `fk:restrict`
-  * `repair:auto-selected-active`
-  * `active:switch:pre-delete`
-* Emit metrics counters; attach `<model>` and (if used) `scope`.
-
----
-
-## 11) Test Matrix (must pass)
-
-1. **Non-active delete** (≥2): deleted; active unchanged.
-2. **Active delete** (≥2): active switches deterministically, then delete succeeds.
-3. **Last item delete** (==1): blocked with message.
-4. **First-run**: 0 items → `activeRef` stays `NULL`; add first → `ensureActiveSelected()` selects it.
-5. **Ref update** (if allowed): `activeRef` follows via `ON UPDATE CASCADE`.
-6. **Soft delete** mode: filters respected; invariants preserved.
-7. **Bulk delete** that includes active but not all: pre-switch then delete set.
-8. **Foreign keys disabled** (fault injection): tests must fail to surface missing PRAGMA.
-
----
-
-## 12) Rollout & Rollback
-
-* **Feature-flag** the new deletion path.
-* Migrations are **idempotent**; ship `ensureActiveSelected()` with them.
-* Keep a pre-migration backup for `<models>` on first rollout.
-* Rollback leaves `active_<model>` table harmlessly present.
-
----
-
-## 13) Replace-Me Cheatsheet
-
-* `<model>` → singular (e.g., `project`)
-* `<models>` → plural table (e.g., `projects`)
-* `ref` → stable external key (`did` | `slug` | `uuid`)
-
----
-
-**Outcome:** You get **predictable UX**, **atomic state changes**, and **hard integrity guarantees** across single- or multi-scope actives, with clear tests and telemetry to keep it honest.
-
----
-
-## TimeSafari Implementation Guide
-
-### Current State Analysis (2025-01-27)
-
-**Status**: ✅ **FULLY COMPLIANT** - Active Pointer + Smart Deletion Pattern implementation complete.
-
-**Compliance Score**: 100% (6/6 components compliant)
-
-#### ✅ **What's Working**
-- **Smart Deletion Logic**: `IdentitySwitcherView.vue` implements atomic transaction-safe deletion
-- **Data Access API**: All required DAL methods exist in `PlatformServiceMixin.ts`
-- **Schema Structure**: `active_identity` table follows singleton pattern correctly
-- **Bootstrapping**: `$ensureActiveSelected()` method implemented
-- **Foreign Key Constraint**: ✅ **FIXED** - Now uses `ON DELETE RESTRICT` (Migration 005)
-- **Settings Cleanup**: ✅ **COMPLETED** - Orphaned records removed (Migration 006)
-
-#### ✅ **All Issues Resolved**
-- ✅ Foreign key constraint fixed to `ON DELETE RESTRICT`
-- ✅ Settings table cleaned up (orphaned records removed)
-
-### Updated Implementation Plan
-
-**Note**: Smart deletion logic is already implemented correctly. Focus on fixing security issues and cleanup.
-
-#### 1) Critical Security Fix (Migration 005)
-
-**Fix Foreign Key Constraint:**
-```sql
--- Migration 005: Fix foreign key constraint to ON DELETE RESTRICT
-{
-  name: "005_active_identity_constraint_fix",
-  sql: `
-    PRAGMA foreign_keys = ON;
-    
-    -- Recreate table with ON DELETE RESTRICT constraint (SECURITY FIX)
-    CREATE TABLE active_identity_new (
-      id INTEGER PRIMARY KEY CHECK (id = 1),
-      activeDid TEXT REFERENCES accounts(did) ON DELETE RESTRICT,
-      lastUpdated TEXT NOT NULL DEFAULT (datetime('now'))
-    );
-    
-    -- Copy existing data
-    INSERT INTO active_identity_new (id, activeDid, lastUpdated)
-    SELECT id, activeDid, lastUpdated FROM active_identity;
-    
-    -- Replace old table
-    DROP TABLE active_identity;
-    ALTER TABLE active_identity_new RENAME TO active_identity;
-    
-    -- Recreate indexes
-    CREATE UNIQUE INDEX IF NOT EXISTS idx_active_identity_single_record ON active_identity(id);
-  `
-}
-```
-
-### Updated Implementation Plan
-
-**Note**: Smart deletion logic is already implemented correctly. Migration 005 (security fix) completed successfully.
-
-#### ✅ **Phase 1: Critical Security Fix (COMPLETED)**
-- **Migration 005**: ✅ **COMPLETED** - Fixed foreign key constraint to `ON DELETE RESTRICT`
-- **Impact**: Prevents accidental account deletion
-- **Status**: ✅ **Successfully applied and tested**
-
-#### **Phase 2: Settings Cleanup (CURRENT)**
-- **Migration 006**: Remove orphaned settings records
-- **Impact**: Cleaner architecture, reduced confusion
-- **Risk**: LOW - Only removes obsolete data
-
-#### 3) Optional Future Enhancement (Migration 007)
-
-**Remove Legacy activeDid Column:**
-```sql
--- Migration 007: Remove activeDid column entirely (future task)
-{
-  name: "007_remove_activeDid_column",
-  sql: `
-    -- Remove the legacy activeDid column from settings table
-    ALTER TABLE settings DROP COLUMN activeDid;
-  `
-}
-```
-
-### Current Implementation Status
-
-#### ✅ **Already Implemented Correctly**
-- **Smart Deletion Logic**: `IdentitySwitcherView.vue` lines 285-315
-- **Data Access API**: All methods exist in `PlatformServiceMixin.ts`
-- **Transaction Safety**: Uses `$withTransaction()` for atomicity
-- **Last Account Protection**: Blocks deletion when `total <= 1`
-- **Deterministic Selection**: `$pickNextAccountDid()` method
-- **Bootstrapping**: `$ensureActiveSelected()` method
-
-#### ❌ **Requires Immediate Fix**
-1. **Foreign Key Constraint**: Change from `ON DELETE SET NULL` to `ON DELETE RESTRICT`
-2. **Settings Cleanup**: Remove orphaned records with `accountDid=null`
-
-### Implementation Priority
-
-#### **Phase 1: Critical Security Fix (IMMEDIATE)**
-- **Migration 005**: Fix foreign key constraint to `ON DELETE RESTRICT`
-- **Impact**: Prevents accidental account deletion
-- **Risk**: HIGH - Current implementation allows data loss
-
-#### **Phase 2: Settings Cleanup (HIGH PRIORITY)**
-- **Migration 006**: Remove orphaned settings records
-- **Impact**: Cleaner architecture, reduced confusion
-- **Risk**: LOW - Only removes obsolete data
-
-#### **Phase 3: Future Enhancement (OPTIONAL)**
-- **Migration 007**: Remove `activeDid` column from settings
-- **Impact**: Complete separation of concerns
-- **Risk**: LOW - Architectural cleanup
-
-#### **Phase 2: Settings Cleanup Implementation (Migration 006)**
-
-**Remove Orphaned Records:**
-```sql
--- Migration 006: Settings cleanup
-{
-  name: "006_settings_cleanup",
-  sql: `
-    -- Remove orphaned settings records (accountDid is null)
-    DELETE FROM settings WHERE accountDid IS NULL;
-    
-    -- Clear any remaining activeDid values in settings
-    UPDATE settings SET activeDid = NULL;
-  `
-}
-```
-
-### Updated Compliance Assessment
-
-#### **Current Status**: ✅ **FULLY COMPLIANT** (100%)
-
-| Component | Status | Compliance |
-|-----------|--------|------------|
-| Smart Deletion Logic | ✅ Complete | 100% |
-| Data Access API | ✅ Complete | 100% |
-| Schema Structure | ✅ Complete | 100% |
-| Foreign Key Constraint | ✅ Fixed (`RESTRICT`) | 100% |
-| Settings Cleanup | ✅ Completed | 100% |
-| **Overall** | ✅ **Complete** | **100%** |
-
-### Implementation Benefits
-
-**Current implementation already provides:**
-- ✅ **Atomic Operations**: Transaction-safe account deletion
-- ✅ **Last Account Protection**: Prevents deletion of final account
-- ✅ **Smart Switching**: Auto-switches active account before deletion
-- ✅ **Deterministic Behavior**: Predictable "next account" selection
-- ✅ **NULL Handling**: Proper empty state management
-
-**After fixes will add:**
-- ✅ **Data Integrity**: Foreign key constraints prevent orphaned references
-- ✅ **Clean Architecture**: Complete separation of identity vs. settings
-- ✅ **Production Safety**: No accidental account deletion possible
-
-### Implementation Complete
-
-✅ **All Required Steps Completed:**
-1. ✅ **Migration 005**: Foreign key constraint fixed to `ON DELETE RESTRICT`
-2. ✅ **Migration 006**: Settings cleanup completed (orphaned records removed)
-3. ✅ **Testing**: All migrations executed successfully with no performance delays
-
-**Optional Future Enhancement:**
-- **Migration 007**: Remove `activeDid` column from settings table (architectural cleanup)
-
-The Active Pointer + Smart Deletion Pattern is now **fully implemented** with **100% compliance**.

doc/activeDid-migration-plan.md

@@ -1,559 +0,0 @@
-# ActiveDid Migration Plan - Implementation Guide
-
-**Author**: Matthew Raymer
-**Date**: 2025-09-03T06:40:54Z
-**Status**: 🚀 **ACTIVE MIGRATION** - API Layer Complete, Component Updates Complete ✅
-
-## Objective
-
-Move the `activeDid` field from the `settings` table to a dedicated `active_identity` table to improve database architecture, prevent data corruption, and separate identity selection from user preferences.
-
-## Result
-
-This document provides the specific implementation steps required to complete the ActiveDid migration with all necessary code changes.
-
-## Use/Run
-
-Follow this implementation checklist step-by-step to complete the migration.
-
-## Context & Scope
-
-- **In scope**: Database migration, API updates, component updates, testing
-- **Out of scope**: UI changes, authentication flow changes, MASTER_SETTINGS_KEY elimination (future improvement)
-
-## Critical Vue Reactivity Bug Discovery
-
-### Issue
-During testing of the ActiveDid migration, a critical Vue reactivity bug was discovered:
-
-**Problem**: The `newDirectOffersActivityNumber` element in HomeView.vue fails to render correctly without a watcher on `numNewOffersToUser`.
-
-**Symptoms**: 
-- Element not found in DOM even when `numNewOffersToUser` has correct value
-- Test failures with "element not found" errors
-- Inconsistent rendering behavior
-
-**Root Cause**: Unknown Vue reactivity issue where property changes don't trigger proper template updates
-
-**Workaround**: A watcher on `numNewOffersToUser` with debug logging is required:
-```typescript
-@Watch("numNewOffersToUser")
-onNumNewOffersToUserChange(newValue: number, oldValue: number) {
-  logger.debug("[HomeView] numNewOffersToUser changed", {
-    oldValue,
-    newValue,
-    willRender: !!newValue,
-    timestamp: new Date().toISOString()
-  });
-}
-```
-
-**Impact**: This watcher must remain in the codebase until the underlying Vue reactivity issue is resolved.
-
-**Files Affected**: `src/views/HomeView.vue`
-
-### Investigation Needed
-- [ ] Investigate why Vue reactivity is not working correctly
-- [ ] Check for race conditions in component lifecycle
-- [ ] Verify if this affects other components
-- [ ] Consider Vue version upgrade or configuration changes
-
-## Implementation Checklist
-
-### Phase 1: Database Migration ✅ COMPLETE
-- [x] Add migration to MIGRATIONS array in `src/db-sql/migration.ts`
-- [x] Create active_identity table with constraints
-- [x] Include data migration from settings to active_identity table
-
-**Status**: All migrations executed successfully. active_identity table created and populated with data.
-
-### Phase 2: API Layer Updates ✅ COMPLETE
-- [x] Implement `$getActiveIdentity()` method (exists with correct return type)
-- [x] Fix `$getActiveIdentity()` return type to match documented interface
-- [x] Update `$accountSettings()` to use new method (minimal safe change)
-- [x] Update `$updateActiveDid()` with dual-write pattern
-- [x] Add strategic logging for migration verification
-
-**Status**: All API layer updates complete and verified working. Methods return correct data format and maintain backward compatibility.
-
-### Phase 3: Component Updates ✅ COMPLETE
-- [x] Update HomeView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update OfferDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update PhotoDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update GiftedDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update MembersList.vue to use `$getActiveIdentity()` (completed)
-- [x] Update OnboardingDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ImageMethodDialog.vue to use `$getActiveIdentity()` (completed)
-- [x] Update DIDView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update TestView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactAmountsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update UserProfileView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ClaimView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update OfferDetailsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update QuickActionBvcEndView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update SharedPhotoView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ClaimReportCertificateView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ProjectsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ClaimAddRawView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactQRScanShowView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update InviteOneAcceptView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update RecentOffersToUserView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update NewEditProjectView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update GiftedDetailsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update IdentitySwitcherView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactQRScanFullView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update NewActivityView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactImportView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ProjectViewView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ClaimCertificateView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ContactGiftingView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update ConfirmGiftView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update RecentOffersToUserProjectsView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update InviteOneView.vue to use `$getActiveIdentity()` (completed)
-- [x] Update AccountViewView.vue to use `$getActiveIdentity()` (completed)
-- [x] All component migrations complete! ✅
-- [ ] Replace `this.activeDid = settings.activeDid` pattern
-- [ ] Test each component individually
-
-**Status**: 23 components successfully migrated. 11 components remaining. API layer ready for systematic updates.
-
-### Phase 4: Testing 🟡 PARTIALLY STARTED
-
-- [x] Test Web platform (verified working)
-- [ ] Test Electron platform
-- [ ] Test iOS platform  
-- [ ] Test Android platform
-- [ ] Test migration rollback scenarios
-- [ ] Test data corruption recovery
-
-## Required Code Changes
-
-### 1. Database Migration ✅ COMPLETE
-
-```typescript
-// Already added to MIGRATIONS array in src/db-sql/migration.ts
-{
-  name: "003_active_did_separate_table",
-  sql: `
-    -- Create new active_identity table with proper constraints
-    CREATE TABLE IF NOT EXISTS active_identity (
-      id INTEGER PRIMARY KEY CHECK (id = 1),
-      activeDid TEXT NOT NULL,
-      lastUpdated TEXT NOT NULL DEFAULT (datetime('now')),
-      FOREIGN KEY (activeDid) REFERENCES accounts(did) ON DELETE CASCADE
-    );
-
-    -- Add performance indexes
-    CREATE INDEX IF NOT EXISTS idx_active_identity_activeDid ON active_identity(activeDid);
-    CREATE UNIQUE INDEX IF NOT EXISTS idx_active_identity_single_record ON active_identity(id);
-
-    -- Insert default record (will be updated during migration)
-    INSERT OR IGNORE INTO active_identity (id, activeDid, lastUpdated) VALUES (1, '', datetime('now'));
-
-    -- MIGRATE EXISTING DATA: Copy activeDid from settings to active_identity
-    -- This prevents data loss when migration runs on existing databases
-    UPDATE active_identity 
-    SET activeDid = (SELECT activeDid FROM settings WHERE id = 1), 
-        lastUpdated = datetime('now')
-    WHERE id = 1 
-    AND EXISTS (SELECT 1 FROM settings WHERE id = 1 AND activeDid IS NOT NULL AND activeDid != '');
-  `,
-},
-```
-
-### 2. $getActiveIdentity() Method ✅ EXISTS
-
-```typescript
-// Already exists in PlatformServiceMixin.ts with correct return type
-async $getActiveIdentity(): Promise<{ activeDid: string }> {
-  try {
-    const result = await this.$dbQuery(
-      "SELECT activeDid FROM active_identity WHERE id = 1"
-    );
-    
-    if (result?.values?.length) {
-      const activeDid = result.values[0][0] as string;
-      
-      // Validate activeDid exists in accounts
-      if (activeDid) {
-        const accountExists = await this.$dbQuery(
-          "SELECT did FROM accounts WHERE did = ?",
-          [activeDid]
-        );
-        
-        if (accountExists?.values?.length) {
-          return { activeDid };
-        } else {
-          // Clear corrupted activeDid
-          await this.$dbExec(
-            "UPDATE active_identity SET activeDid = '', lastUpdated = datetime('now') WHERE id = 1"
-          );
-          return { activeDid: "" };
-        }
-      }
-    }
-    
-    return { activeDid: "" };
-  } catch (error) {
-    logger.error("[PlatformServiceMixin] Error getting active identity:", error);
-    return { activeDid: "" };
-  }
-}
-```
-
-### 3. Update $accountSettings Method
-
-```typescript
-// Update in PlatformServiceMixin.ts
-async $accountSettings(did?: string, defaults: Settings = {}): Promise<Settings> {
-  try {
-    // Get settings without activeDid (unchanged logic)
-    const settings = await this.$getMasterSettings(defaults);
-
-    if (!settings) {
-      return defaults;
-    }
-
-    // Get activeDid from new table (new logic)
-    const activeIdentity = await this.$getActiveIdentity();
-
-    // Return combined result (maintains backward compatibility)
-    return { ...settings, activeDid: activeIdentity.activeDid };
-  } catch (error) {
-    logger.error("[Settings Trace] ❌ Error in $accountSettings:", error);
-    return defaults;
-  }
-}
-```
-
-### 4. Update $updateActiveDid Method
-
-```typescript
-// Update in PlatformServiceMixin.ts
-async $updateActiveDid(newDid: string | null): Promise<boolean> {
-  try {
-    if (newDid === null) {
-      // Clear active identity in both tables
-      await this.$dbExec(
-        "UPDATE active_identity SET activeDid = '', lastUpdated = datetime('now') WHERE id = 1"
-      );
-      
-      // Keep legacy field in sync (backward compatibility)
-      await this.$dbExec(
-        "UPDATE settings SET activeDid = '' WHERE id = ?",
-        [MASTER_SETTINGS_KEY]
-      );
-    } else {
-      // Validate DID exists before setting
-      const accountExists = await this.$dbQuery(
-        "SELECT did FROM accounts WHERE did = ?",
-        [newDid]
-      );
-
-      if (!accountExists?.values?.length) {
-        logger.error(`[PlatformServiceMixin] Cannot set activeDid to non-existent DID: ${newDid}`);
-        return false;
-      }
-
-      // Update active identity in new table
-      await this.$dbExec(
-        "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
-        [newDid]
-      );
-      
-      // Keep legacy field in sync (backward compatibility)
-      await this.$dbExec(
-        "UPDATE settings SET activeDid = ? WHERE id = ?",
-        [newDid, MASTER_SETTINGS_KEY]
-      );
-    }
-
-    // Update internal tracking
-    await this._updateInternalActiveDid(newDid);
-    return true;
-  } catch (error) {
-    logger.error("[PlatformServiceMixin] Error updating activeDid:", error);
-    return false;
-  }
-}
-```
-
-### 5. Component Updates Required
-
-**35 components need this pattern change:**
-
-```typescript
-// CURRENT PATTERN (replace in all components):
-this.activeDid = settings.activeDid || "";
-
-// NEW PATTERN (use in all components):
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-const activeIdentity = await (this as any).$getActiveIdentity();
-this.activeDid = activeIdentity.activeDid || "";
-```
-
-**Components requiring updates:**
-
-#### Views (28 components)
-- `src/views/DIDView.vue` (line 378)
-- `src/views/TestView.vue` (line 654)
-- `src/views/ContactAmountsView.vue` (line 226)
-- `src/views/HomeView.vue` (line 517)
-- `src/views/UserProfileView.vue` (line 185)
-- `src/views/ClaimView.vue` (line 730)
-- `src/views/OfferDetailsView.vue` (line 435)
-- `src/views/QuickActionBvcEndView.vue` (line 229)
-- `src/views/SharedPhotoView.vue` (line 178)
-- `src/views/ClaimReportCertificateView.vue` (line 56)
-- `src/views/ProjectsView.vue` (line 393)
-- `src/views/ClaimAddRawView.vue` (line 114)
-- `src/views/ContactQRScanShowView.vue` (line 288)
-- `src/views/InviteOneAcceptView.vue` (line 122)
-- `src/views/RecentOffersToUserView.vue` (line 118)
-- `src/views/NewEditProjectView.vue` (line 380)
-- `src/views/GiftedDetailsView.vue` (line 443)
-- `src/views/ProjectViewView.vue` (line 782)
-- `src/views/ContactsView.vue` (line 296)
-- `src/views/ContactQRScanFullView.vue` (line 267)
-- `src/views/NewActivityView.vue` (line 204)
-- `src/views/ClaimCertificateView.vue` (line 42)
-- `src/views/ContactGiftingView.vue` (line 166)
-- `src/views/RecentOffersToUserProjectsView.vue` (line 126)
-- `src/views/InviteOneView.vue` (line 285)
-- `src/views/IdentitySwitcherView.vue` (line 202)
-- `src/views/AccountViewView.vue` (line 1052)
-- `src/views/ConfirmGiftView.vue` (line 549)
-- `src/views/ContactImportView.vue` (line 342)
-
-#### Components (7 components)
-- `src/components/OfferDialog.vue` (line 177)
-- `src/components/PhotoDialog.vue` (line 270)
-- `src/components/GiftedDialog.vue` (line 223)
-- `src/components/MembersList.vue` (line 234)
-- `src/components/OnboardingDialog.vue` (line 272)
-- `src/components/ImageMethodDialog.vue` (line 502)
-- `src/components/FeedFilters.vue` (line 89)
-
-**Implementation Strategy:**
-
-1. **Systematic Replacement**: Use grep search to find all instances
-2. **Pattern Matching**: Replace `this.activeDid = settings.activeDid` with new pattern
-3. **Error Handling**: Ensure proper error handling in each component
-4. **Testing**: Test each component individually after update
-
-**Example Component Update:**
-
-```typescript
-// BEFORE (in any component):
-private async initializeSettings() {
-  const settings = await this.$accountSettings();
-  this.activeDid = settings.activeDid || "";
-  this.apiServer = settings.apiServer || "";
-}
-
-// AFTER (in any component):
-private async initializeSettings() {
-  const settings = await this.$accountSettings();
-  const activeIdentity = await this.$getActiveIdentity();
-  this.activeDid = activeIdentity.activeDid || "";
-  this.apiServer = settings.apiServer || "";
-}
-```
-
-**Alternative Pattern (if settings still needed):**
-
-```typescript
-// If component needs both settings and activeDid:
-private async initializeSettings() {
-  const settings = await this.$accountSettings();
-  const activeIdentity = await this.$getActiveIdentity();
-  
-  // Use activeDid from new table
-  this.activeDid = activeIdentity.activeDid || "";
-  
-  // Use other settings from settings table
-  this.apiServer = settings.apiServer || "";
-  this.partnerApiServer = settings.partnerApiServer || "";
-  // ... other settings
-}
-```
-
-## What Works (Evidence)
-
-- ✅ **Migration code exists** in MIGRATIONS array
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows successful execution of migrations 003 and 004
-  - **Verify at**: `🎉 [Migration] Successfully applied: 003_active_did_separate_table`
-
-- ✅ **$getActiveIdentity() method exists** in PlatformServiceMixin
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows method calls returning correct data format
-  - **Verify at**: `[PlatformServiceMixin] $getActiveIdentity(): activeDid resolved {activeDid: 'did:ethr:0xAe6ea6A4c20aDeE7B1c7Ee1fEFAa6fBe0986a671'}`
-
-- ✅ **Database migration infrastructure** exists and mature
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows 6 migrations applied successfully
-  - **Verify at**: `🎉 [Migration] Migration process complete! Summary: 6 applied, 0 skipped`
-
-- ✅ **$accountSettings() updated** with minimal safe change
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows method returning activeDid from new table
-  - **Status**: Maintains all existing complex logic while using new table as primary source
-
-- ✅ **$updateActiveDid() dual-write implemented**
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Method exists and ready for testing
-  - **Status**: Uses MASTER_SETTINGS_KEY constant for proper settings table targeting
-
-- ✅ **HomeView.vue successfully migrated** to use new API
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows `[HomeView] ActiveDid migration - using new API`
-  - **Status**: Component successfully uses `$getActiveIdentity()` instead of `settings.activeDid`
-
-- ✅ **Clean architecture implemented** - active_identity is now single source of truth
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows consistent activeDid values from active_identity table
-  - **Status**: active_identity table is the only source for activeDid, settings table handles app config only
-
-- ✅ **Schema cleanup** - activeDid column removed from settings table
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Console log shows successful execution of migration 004
-  - **Status**: Complete separation of concerns - no more confusing dual-purpose columns
-
-## What Doesn't (Evidence & Hypotheses)
-
-- ❌ **11 components still use old pattern** `this.activeDid = settings.activeDid`
-  - **Time**: 2025-09-03T06:40:54Z
-  - **Evidence**: Grep search found 11 remaining instances across views and components
-  - **Hypothesis**: Components need updates but API layer is now ready
-  - **Next probe**: Systematic component updates can now proceed
-
-## Risks, Limits, Assumptions
-
-- **Data Loss Risk**: Migration failure could lose activeDid values
-- **Breaking Changes**: API updates required in PlatformServiceMixin
-- **Testing Overhead**: All platforms must be tested with new structure
-- **Component Updates**: 35+ components need individual updates and testing
-
-## Rollback Strategy
-
-### Schema Rollback
-```sql
--- If migration fails, restore original schema
-DROP TABLE IF EXISTS active_identity;
-```
-
-### Data Rollback
-```typescript
-// Rollback function to restore activeDid to settings table
-async function rollbackActiveDidMigration(): Promise<boolean> {
-  try {
-    const activeIdentityResult = await dbQuery(
-      "SELECT activeDid FROM active_identity WHERE id = 1"
-    );
-    
-    if (activeIdentityResult?.values?.length) {
-      const activeDid = activeIdentityResult.values[0][0] as string;
-      
-      await dbExec(
-        "UPDATE settings SET activeDid = ? WHERE id = ?",
-        [activeDid, MASTER_SETTINGS_KEY]
-      );
-      
-      return true;
-    }
-    
-    return false;
-  } catch (error) {
-    logger.error("[Rollback] Failed to restore activeDid:", error);
-    return false;
-  }
-}
-```
-
-## Next Steps
-
-| Task | Exit Criteria | Priority |
-|------|---------------|----------|
-| **Update $accountSettings() method** | Method calls $getActiveIdentity and combines with settings | ✅ COMPLETE |
-| **Implement $updateActiveDid() dual-write** | Method updates both active_identity and settings tables | ✅ COMPLETE |
-| **Start application in browser** | Application loads and initializes IndexedDB database | ✅ COMPLETE |
-| **Inspect IndexedDB via DevTools** | Verify active_identity table exists and contains data | ✅ COMPLETE |
-| **Update first component** | One component successfully uses new API pattern | ✅ COMPLETE (HomeView.vue) |
-| **Systematic component updates** | All 26 remaining components use new API pattern (with test:web after each) | 🟢 HIGH |
-| **Test all platforms** | Web, Electron, iOS, Android platforms verified working | 🟡 MEDIUM |
-| **Performance optimization** | Reduce excessive $getActiveIdentity() calls | 🟡 MEDIUM |
-
-**Critical Blocker**: API layer complete. Ready to proceed with component updates.
-
-## Migration Execution Rule
-
-### **One Component + Test Pattern**
-**Rule**: After migrating each component, run `npm run test:web` and `npm run lint-fix` to verify the change doesn't break existing functionality and meets code standards.
-
-**Workflow**:
-1. **Migrate one component** - Update to use `$getActiveIdentity()` pattern
-2. **Run lint-fix** - Ensure code meets project standards
-3. **Run test:web** - Verify no regressions introduced
-4. **Commit if passing** - Only commit after tests and linting pass
-5. **Repeat** - Move to next component
-
-**Benefits**:
-- Catch issues immediately after each change
-- Maintain code quality throughout migration
-- Easy rollback if problems arise
-- Systematic progress tracking
-
-**Exit Criteria**: All 26 components migrated with passing tests
-
-## Performance Observations
-
-### Excessive API Calls Detected
-The console log shows `$getActiveIdentity()` being called very frequently (multiple times per component mount). This suggests:
-- Components may be calling the API more than necessary
-- Could be optimized for better performance
-- Not a blocker, but worth monitoring during component updates
-
-### Recommended Optimization Strategy
-1. **Audit component lifecycle** - Ensure API calls happen only when needed
-2. **Implement caching** - Consider short-term caching of activeDid values
-3. **Batch updates** - Group related API calls where possible
-4. **Monitor performance** - Track API call frequency during component updates
-
-## Future Improvement: MASTER_SETTINGS_KEY Elimination
-
-**Not critical for this task** but logged for future improvement:
-
-```typescript
-// Current: WHERE id = "1" 
-// Future: WHERE accountDid IS NULL
-
-// This eliminates the confusing concept of "master" settings
-// and uses a cleaner pattern for default settings
-```
-
-## References
-
-- [Database Migration Guide](./database-migration-guide.md)
-- [Dexie to SQLite Mapping](./dexie-to-sqlite-mapping.md)
-- [PlatformServiceMixin Documentation](./component-communication-guide.md)
-
-## Competence Hooks
-
-- *Why this works*: Separates concerns between identity selection and user preferences, prevents data corruption with foreign key constraints
-- *Common pitfalls*: Method signature mismatches, forgetting dual-write pattern, not testing database state
-- *Next skill unlock*: Systematic API updates with backward compatibility
-- *Teach-back*: Explain why dual-write pattern is needed during migration transition
-
-## Collaboration Hooks
-
-- **Reviewers**: Database team, PlatformServiceMixin maintainers, QA team
-- **Sign-off checklist**:
-  - [ ] Migration script integrated with existing MIGRATIONS array
-  - [x] $getActiveIdentity() method returns correct type
-  - [x] $accountSettings() method updated to use new API (minimal safe change)
-  - [x] $updateActiveDid() method implements dual-write pattern
-  - [ ] All 35+ components updated to use new API
-  - [ ] Rollback procedures validated
-  - [ ] All platforms tested
-  - [ ] All stakeholders approve deployment timeline

doc/android-asset-validation.md

@@ -11,12 +11,14 @@ The Android Asset Validation System automatically detects and fixes missing Andr
 ## Problem Solved
 
 Previously, Android builds would fail with errors like:
+
 ```
 error: resource drawable/splash (aka app.timesafari.app:drawable/splash) not found.
 error: resource mipmap/ic_launcher (aka app.timesafari.app:mipmap/ic_launcher) not found.
 ```
 
 This happened when:
+
 - Source assets existed but weren't generated into Android resources
 - Android resource directories were missing
 - Asset generation tools weren't run before building
@@ -45,16 +47,19 @@ npm run build:android:studio
 ### What Gets Validated
 
 #### Source Assets (Required)
+
 - `resources/icon.png` - App icon source
 - `resources/splash.png` - Splash screen source  
 - `resources/splash_dark.png` - Dark mode splash source
 
 #### Android Resources (Generated)
+
 - `android/app/src/main/res/drawable/splash.png` - Splash screen drawable
 - `android/app/src/main/res/mipmap-*/ic_launcher.png` - App icons for all densities
 - `android/app/src/main/res/mipmap-*/ic_launcher_round.png` - Round app icons for all densities
 
 ### Density Levels Checked
+
 - `mipmap-mdpi` (1x)
 - `mipmap-hdpi` (1.5x)  
 - `mipmap-xhdpi` (2x)
@@ -64,6 +69,7 @@ npm run build:android:studio
 ## Usage
 
 ### Automatic Validation (Recommended)
+
 The validation runs automatically during all Android builds:
 
 ```bash
@@ -78,6 +84,7 @@ npm run build:android:debug
 ```
 
 ### Manual Validation
+
 Run validation only to check/fix assets:
 
 ```bash
@@ -89,6 +96,7 @@ npm run assets:validate:android
 ```
 
 ### Validation Only (No Regeneration)
+
 Check configuration without fixing:
 
 ```bash
@@ -98,6 +106,7 @@ npm run assets:validate
 ## Error Handling
 
 ### Missing Source Assets
+
 If source assets are missing, the build fails with clear error messages:
 
 ```
@@ -108,6 +117,7 @@ If source assets are missing, the build fails with clear error messages:
 ```
 
 ### Missing Generated Resources
+
 If generated resources are missing, they're automatically regenerated:
 
 ```
@@ -119,6 +129,7 @@ If generated resources are missing, they're automatically regenerated:
 ```
 
 ### Generation Failure
+
 If regeneration fails, helpful guidance is provided:
 
 ```
@@ -131,6 +142,7 @@ If regeneration fails, helpful guidance is provided:
 ## Integration Points
 
 ### Build Script Integration
+
 The validation is integrated into the main build process:
 
 ```bash
@@ -143,6 +155,7 @@ validate_android_assets || {
 ```
 
 ### NPM Scripts
+
 New npm scripts for asset management:
 
 ```json
@@ -156,17 +169,20 @@ New npm scripts for asset management:
 ## Benefits
 
 ### For Developers
+
 - **No More Build Failures**: Automatic detection and fixing of missing resources
 - **Faster Development**: No need to manually run asset generation tools
 - **Clear Error Messages**: Helpful guidance when issues occur
 - **Consistent Results**: Same validation on all development machines
 
 ### For CI/CD
+
 - **Reliable Builds**: Consistent asset validation across environments
 - **Early Detection**: Catches issues before they reach production
 - **Automated Fixes**: Self-healing builds when possible
 
 ### For Project Maintenance
+
 - **Reduced Support**: Fewer "build doesn't work" issues
 - **Documentation**: Clear requirements for required assets
 - **Standardization**: Consistent asset structure across the project
@@ -176,21 +192,27 @@ New npm scripts for asset management:
 ### Common Issues
 
 #### "No assets found in the asset path"
+
 This occurs when the `assets/` directory is empty. The validation system automatically copies source assets and regenerates them.
 
 #### "Failed to generate Android assets"
+
 Check that:
+
 - Source assets exist in `resources/`
 - `@capacitor/assets` is installed
 - You have write permissions to the Android directories
 
 #### "Asset generation completed but some resources are still missing"
+
 This indicates a problem with the asset generation tool. Try:
+
 1. Running `npm install` to ensure dependencies are up to date
 2. Manually running `npx @capacitor/assets generate`
 3. Checking the asset generation logs for specific errors
 
 ### Manual Recovery
+
 If automatic regeneration fails, you can manually create the missing resources:
 
 ```bash
@@ -213,12 +235,14 @@ rm assets/icon.png assets/splash.png assets/splash_dark.png
 ## Future Enhancements
 
 ### Planned Improvements
+
 - **iOS Asset Validation**: Extend validation to iOS assets
 - **Asset Quality Checks**: Validate image dimensions and formats
 - **Performance Optimization**: Cache validation results
 - **CI/CD Integration**: Add validation to GitHub Actions
 
 ### Configuration Options
+
 - **Custom Asset Paths**: Support for different asset directory structures
 - **Validation Rules**: Configurable validation requirements
 - **Skip Options**: Ability to skip validation for specific scenarios

doc/android-emulator-deployment-guide.md

@@ -1,655 +0,0 @@
-# Android Emulator Deployment Guide (No Android Studio)
-
-**Author**: Matthew Raymer  
-**Date**: 2025-01-27  
-**Status**: 🎯 **ACTIVE** - Complete guide for deploying TimeSafari to Android emulator using command-line tools
-
-## Overview
-
-This guide provides comprehensive instructions for building and deploying TimeSafari to Android emulators using only command-line tools, without requiring Android Studio. It leverages the existing build system and adds emulator-specific deployment workflows.
-
-## Prerequisites
-
-### Required Tools
-
-1. **Android SDK Command Line Tools**
-   ```bash
-   # Install via package manager (Arch Linux)
-   sudo pacman -S android-sdk-cmdline-tools-latest
-   
-   # Or download from Google
-   # https://developer.android.com/studio/command-line
-   ```
-
-2. **Android SDK Platform Tools**
-   ```bash
-   # Install via package manager
-   sudo pacman -S android-sdk-platform-tools
-   
-   # Or via Android SDK Manager
-   sdkmanager "platform-tools"
-   ```
-
-3. **Android SDK Build Tools**
-   ```bash
-   sdkmanager "build-tools;34.0.0"
-   ```
-
-4. **Android Platform**
-   ```bash
-   sdkmanager "platforms;android-34"
-   ```
-
-5. **Android Emulator**
-   ```bash
-   sdkmanager "emulator"
-   ```
-
-6. **System Images**
-   ```bash
-   # For API 34 (Android 14)
-   sdkmanager "system-images;android-34;google_apis;x86_64"
-   
-   # For API 33 (Android 13) - alternative
-   sdkmanager "system-images;android-33;google_apis;x86_64"
-   ```
-
-### Environment Setup
-
-```bash
-# Add to ~/.bashrc or ~/.zshrc
-export ANDROID_HOME=$HOME/Android/Sdk
-export ANDROID_AVD_HOME=$HOME/.android/avd  # Important for AVD location
-export PATH=$PATH:$ANDROID_HOME/emulator
-export PATH=$PATH:$ANDROID_HOME/platform-tools
-export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
-export PATH=$PATH:$ANDROID_HOME/build-tools/34.0.0
-
-# Reload shell
-source ~/.bashrc
-```
-
-### Verify Installation
-
-```bash
-# Check all tools are available
-adb version
-emulator -version
-avdmanager list
-```
-
-## Resource-Aware Emulator Setup
-
-### ⚡ **Quick Start Recommendation**
-
-**For best results, always start with resource analysis:**
-
-```bash
-# 1. Check your system capabilities
-./scripts/avd-resource-checker.sh
-
-# 2. Use the generated optimal startup script
-/tmp/start-avd-TimeSafari_Emulator.sh
-
-# 3. Deploy your app
-npm run build:android:dev
-adb install -r android/app/build/outputs/apk/debug/app-debug.apk
-```
-
-This prevents system lockups and ensures optimal performance.
-
-### AVD Resource Checker Script
-
-**New Feature**: TimeSafari includes an intelligent resource checker that automatically detects your system capabilities and recommends optimal AVD configurations.
-
-```bash
-# Check system resources and get recommendations
-./scripts/avd-resource-checker.sh
-
-# Check resources for specific AVD
-./scripts/avd-resource-checker.sh TimeSafari_Emulator
-
-# Test AVD startup performance
-./scripts/avd-resource-checker.sh TimeSafari_Emulator --test
-
-# Create optimized AVD with recommended settings
-./scripts/avd-resource-checker.sh TimeSafari_Emulator --create
-```
-
-**What the script analyzes:**
-- **System Memory**: Total and available RAM
-- **CPU Cores**: Available processing power
-- **GPU Capabilities**: NVIDIA, AMD, Intel, or software rendering
-- **Hardware Acceleration**: Optimal graphics settings
-
-**What it generates:**
-- **Optimal configuration**: Memory, cores, and GPU settings
-- **Startup command**: Ready-to-use emulator command
-- **Startup script**: Saved to `/tmp/start-avd-{name}.sh` for reuse
-
-## Emulator Management
-
-### Create Android Virtual Device (AVD)
-
-```bash
-# List available system images
-avdmanager list target
-
-# Create AVD for API 34
-avdmanager create avd \
-  --name "TimeSafari_Emulator" \
-  --package "system-images;android-34;google_apis;x86_64" \
-  --device "pixel_7"
-
-# List created AVDs
-avdmanager list avd
-```
-
-### Start Emulator
-
-```bash
-# Start emulator with hardware acceleration (recommended)
-emulator -avd TimeSafari_Emulator -gpu host -no-audio &
-
-# Start with reduced resources (if system has limited RAM)
-emulator -avd TimeSafari_Emulator \
-  -no-audio \
-  -memory 2048 \
-  -cores 2 \
-  -gpu swiftshader_indirect &
-
-# Start with minimal resources (safest for low-end systems)
-emulator -avd TimeSafari_Emulator \
-  -no-audio \
-  -memory 1536 \
-  -cores 1 \
-  -gpu swiftshader_indirect &
-
-# Check if emulator is running
-adb devices
-```
-
-### Resource Management
-
-**Important**: Android emulators can consume significant system resources. Choose the appropriate configuration based on your system:
-
-- **High-end systems** (16GB+ RAM, dedicated GPU): Use `-gpu host`
-- **Mid-range systems** (8-16GB RAM): Use `-memory 2048 -cores 2`
-- **Low-end systems** (4-8GB RAM): Use `-memory 1536 -cores 1 -gpu swiftshader_indirect`
-
-### Emulator Control
-
-```bash
-# Stop emulator
-adb emu kill
-
-# Restart emulator
-adb reboot
-
-# Check emulator status
-adb get-state
-```
-
-## Build and Deploy Workflow
-
-### Method 1: Using Existing Build Scripts
-
-The TimeSafari project already has comprehensive Android build scripts that can be adapted for emulator deployment:
-
-```bash
-# Development build with auto-run
-npm run build:android:dev:run
-
-# Test build with auto-run  
-npm run build:android:test:run
-
-# Production build with auto-run
-npm run build:android:prod:run
-```
-
-### Method 2: Custom Emulator Deployment Script
-
-Create a new script specifically for emulator deployment:
-
-```bash
-# Create emulator deployment script
-cat > scripts/deploy-android-emulator.sh << 'EOF'
-#!/bin/bash
-# deploy-android-emulator.sh
-# Author: Matthew Raymer
-# Date: 2025-01-27
-# Description: Deploy TimeSafari to Android emulator without Android Studio
-
-set -e
-
-# Source common utilities
-source "$(dirname "$0")/common.sh"
-
-# Default values
-BUILD_MODE="development"
-AVD_NAME="TimeSafari_Emulator"
-START_EMULATOR=true
-CLEAN_BUILD=true
-
-# Parse command line arguments
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --dev|--development)
-            BUILD_MODE="development"
-            shift
-            ;;
-        --test)
-            BUILD_MODE="test"
-            shift
-            ;;
-        --prod|--production)
-            BUILD_MODE="production"
-            shift
-            ;;
-        --avd)
-            AVD_NAME="$2"
-            shift 2
-            ;;
-        --no-start-emulator)
-            START_EMULATOR=false
-            shift
-            ;;
-        --no-clean)
-            CLEAN_BUILD=false
-            shift
-            ;;
-        -h|--help)
-            echo "Usage: $0 [options]"
-            echo "Options:"
-            echo "  --dev, --development    Build for development"
-            echo "  --test                  Build for testing"
-            echo "  --prod, --production    Build for production"
-            echo "  --avd NAME              Use specific AVD name"
-            echo "  --no-start-emulator     Don't start emulator"
-            echo "  --no-clean              Skip clean build"
-            echo "  -h, --help             Show this help"
-            exit 0
-            ;;
-        *)
-            log_error "Unknown option: $1"
-            exit 1
-            ;;
-    esac
-done
-
-# Function to check if emulator is running
-check_emulator_running() {
-    if adb devices | grep -q "emulator.*device"; then
-        return 0
-    else
-        return 1
-    fi
-}
-
-# Function to start emulator
-start_emulator() {
-    log_info "Starting Android emulator: $AVD_NAME"
-    
-    # Check if AVD exists
-    if ! avdmanager list avd | grep -q "$AVD_NAME"; then
-        log_error "AVD '$AVD_NAME' not found. Please create it first."
-        log_info "Create AVD with: avdmanager create avd --name $AVD_NAME --package system-images;android-34;google_apis;x86_64"
-        exit 1
-    fi
-    
-    # Start emulator in background
-    emulator -avd "$AVD_NAME" -no-audio -no-snapshot &
-    EMULATOR_PID=$!
-    
-    # Wait for emulator to boot
-    log_info "Waiting for emulator to boot..."
-    adb wait-for-device
-    
-    # Wait for boot to complete
-    log_info "Waiting for boot to complete..."
-    while [ "$(adb shell getprop sys.boot_completed)" != "1" ]; do
-        sleep 2
-    done
-    
-    log_success "Emulator is ready!"
-}
-
-# Function to build and deploy
-build_and_deploy() {
-    log_info "Building TimeSafari for $BUILD_MODE mode..."
-    
-    # Clean build if requested
-    if [ "$CLEAN_BUILD" = true ]; then
-        log_info "Cleaning previous build..."
-        npm run clean:android
-    fi
-    
-    # Build based on mode
-    case $BUILD_MODE in
-        "development")
-            npm run build:android:dev
-            ;;
-        "test")
-            npm run build:android:test
-            ;;
-        "production")
-            npm run build:android:prod
-            ;;
-    esac
-    
-    # Deploy to emulator
-    log_info "Deploying to emulator..."
-    adb install -r android/app/build/outputs/apk/debug/app-debug.apk
-    
-    # Launch app
-    log_info "Launching TimeSafari..."
-    adb shell am start -n app.timesafari/.MainActivity
-    
-    log_success "TimeSafari deployed and launched successfully!"
-}
-
-# Main execution
-main() {
-    log_info "TimeSafari Android Emulator Deployment"
-    log_info "Build Mode: $BUILD_MODE"
-    log_info "AVD Name: $AVD_NAME"
-    
-    # Start emulator if requested and not running
-    if [ "$START_EMULATOR" = true ]; then
-        if ! check_emulator_running; then
-            start_emulator
-        else
-            log_info "Emulator already running"
-        fi
-    fi
-    
-    # Build and deploy
-    build_and_deploy
-    
-    log_success "Deployment completed successfully!"
-}
-
-# Run main function
-main "$@"
-EOF
-
-# Make script executable
-chmod +x scripts/deploy-android-emulator.sh
-```
-
-### Method 3: Direct Command Line Deployment
-
-For quick deployments without scripts:
-
-```bash
-# 1. Ensure emulator is running
-adb devices
-
-# 2. Build the app
-npm run build:android:dev
-
-# 3. Install APK
-adb install -r android/app/build/outputs/apk/debug/app-debug.apk
-
-# 4. Launch app
-adb shell am start -n app.timesafari/.MainActivity
-
-# 5. View logs
-adb logcat | grep -E "(TimeSafari|Capacitor|MainActivity)"
-```
-
-## Advanced Deployment Options
-
-### Custom API Server Configuration
-
-For development with custom API endpoints:
-
-```bash
-# Build with custom API IP
-npm run build:android:dev:custom
-
-# Or modify capacitor.config.ts for specific IP
-# Then build normally
-npm run build:android:dev
-```
-
-### Debug vs Release Builds
-
-```bash
-# Debug build (default)
-npm run build:android:debug
-
-# Release build
-npm run build:android:release
-
-# Install specific build
-adb install -r android/app/build/outputs/apk/release/app-release.apk
-```
-
-### Asset Management
-
-```bash
-# Validate Android assets
-npm run assets:validate:android
-
-# Generate assets only
-npm run build:android:assets
-
-# Clean assets
-npm run assets:clean
-```
-
-## Troubleshooting
-
-### Common Issues
-
-1. **Emulator Not Starting / AVD Not Found**
-   ```bash
-   # Check available AVDs
-   avdmanager list avd
-   
-   # If AVD exists but emulator can't find it, check AVD location
-   echo $ANDROID_AVD_HOME
-   ls -la ~/.android/avd/
-   
-   # Fix AVD path issue (common on Arch Linux)
-   export ANDROID_AVD_HOME=/home/$USER/.config/.android/avd
-   
-   # Or create symlinks if AVDs are in different location
-   mkdir -p ~/.android/avd
-   ln -s /home/$USER/.config/.android/avd/* ~/.android/avd/
-   
-   # Create new AVD if needed
-   avdmanager create avd --name "TimeSafari_Emulator" --package "system-images;android-34;google_apis;x86_64"
-   
-   # Check emulator logs
-   emulator -avd TimeSafari_Emulator -verbose
-   ```
-
-2. **System Lockup / High Resource Usage**
-   ```bash
-   # Kill any stuck emulator processes
-   pkill -f emulator
-   
-   # Check system resources
-   free -h
-   nvidia-smi  # if using NVIDIA GPU
-   
-   # Start with minimal resources
-   emulator -avd TimeSafari_Emulator \
-     -no-audio \
-     -memory 1536 \
-     -cores 1 \
-     -gpu swiftshader_indirect &
-   
-   # Monitor resource usage
-   htop
-   
-   # If still having issues, try software rendering only
-   emulator -avd TimeSafari_Emulator \
-     -no-audio \
-     -no-snapshot \
-     -memory 1024 \
-     -cores 1 \
-     -gpu off &
-   ```
-
-3. **ADB Device Not Found**
-   ```bash
-   # Restart ADB server
-   adb kill-server
-   adb start-server
-   
-   # Check devices
-   adb devices
-   
-   # Check emulator status
-   adb get-state
-   ```
-
-3. **Build Failures**
-   ```bash
-   # Clean everything
-   npm run clean:android
-   
-   # Rebuild
-   npm run build:android:dev
-   
-   # Check Gradle logs
-   cd android && ./gradlew clean --stacktrace
-   ```
-
-4. **Installation Failures**
-   ```bash
-   # Uninstall existing app
-   adb uninstall app.timesafari
-   
-   # Reinstall
-   adb install android/app/build/outputs/apk/debug/app-debug.apk
-   
-   # Check package info
-   adb shell pm list packages | grep timesafari
-   ```
-
-### Performance Optimization
-
-1. **Emulator Performance**
-   ```bash
-   # Start with hardware acceleration
-   emulator -avd TimeSafari_Emulator -gpu host
-   
-   # Use snapshot for faster startup
-   emulator -avd TimeSafari_Emulator -snapshot default
-   
-   # Allocate more RAM
-   emulator -avd TimeSafari_Emulator -memory 4096
-   ```
-
-2. **Build Performance**
-   ```bash
-   # Use Gradle daemon
-   echo "org.gradle.daemon=true" >> android/gradle.properties
-   
-   # Increase heap size
-   echo "org.gradle.jvmargs=-Xmx4g" >> android/gradle.properties
-   
-   # Enable parallel builds
-   echo "org.gradle.parallel=true" >> android/gradle.properties
-   ```
-
-## Integration with Existing Build System
-
-### NPM Scripts Integration
-
-Add emulator-specific scripts to `package.json`:
-
-```json
-{
-  "scripts": {
-    "emulator:check": "./scripts/avd-resource-checker.sh",
-    "emulator:check:test": "./scripts/avd-resource-checker.sh TimeSafari_Emulator --test",
-    "emulator:check:create": "./scripts/avd-resource-checker.sh TimeSafari_Emulator --create",
-    "emulator:start": "emulator -avd TimeSafari_Emulator -no-audio &",
-    "emulator:start:optimized": "/tmp/start-avd-TimeSafari_Emulator.sh",
-    "emulator:stop": "adb emu kill",
-    "emulator:deploy": "./scripts/deploy-android-emulator.sh",
-    "emulator:deploy:dev": "./scripts/deploy-android-emulator.sh --dev",
-    "emulator:deploy:test": "./scripts/deploy-android-emulator.sh --test",
-    "emulator:deploy:prod": "./scripts/deploy-android-emulator.sh --prod",
-    "emulator:logs": "adb logcat | grep -E '(TimeSafari|Capacitor|MainActivity)'",
-    "emulator:shell": "adb shell"
-  }
-}
-```
-
-### CI/CD Integration
-
-For automated testing and deployment:
-
-```bash
-# GitHub Actions example
-- name: Start Android Emulator
-  run: |
-    emulator -avd TimeSafari_Emulator -no-audio -no-snapshot &
-    adb wait-for-device
-    adb shell getprop sys.boot_completed
-
-- name: Build and Deploy
-  run: |
-    npm run build:android:test
-    adb install -r android/app/build/outputs/apk/debug/app-debug.apk
-    adb shell am start -n app.timesafari/.MainActivity
-
-- name: Run Tests
-  run: |
-    npm run test:android
-```
-
-## Best Practices
-
-### Development Workflow
-
-1. **Start emulator once per session**
-   ```bash
-   emulator -avd TimeSafari_Emulator -no-audio &
-   ```
-
-2. **Use incremental builds**
-   ```bash
-   # For rapid iteration
-   npm run build:android:sync
-   adb install -r android/app/build/outputs/apk/debug/app-debug.apk
-   ```
-
-3. **Monitor logs continuously**
-   ```bash
-   adb logcat | grep -E "(TimeSafari|Capacitor|MainActivity)" --color=always
-   ```
-
-### Performance Tips
-
-1. **Use snapshots for faster startup**
-2. **Enable hardware acceleration**
-3. **Allocate sufficient RAM (4GB+)**
-4. **Use SSD storage for AVDs**
-5. **Close unnecessary applications**
-
-### Security Considerations
-
-1. **Use debug builds for development only**
-2. **Never commit debug keystores**
-3. **Use release builds for testing**
-4. **Validate API endpoints in production builds**
-
-## Conclusion
-
-This guide provides a complete solution for deploying TimeSafari to Android emulators without Android Studio. The approach leverages the existing build system while adding emulator-specific deployment capabilities.
-
-The key benefits:
-- ✅ **No Android Studio required**
-- ✅ **Command-line only workflow**
-- ✅ **Integration with existing build scripts**
-- ✅ **Automated deployment options**
-- ✅ **Comprehensive troubleshooting guide**
-
-For questions or issues, refer to the troubleshooting section or check the existing build documentation in `BUILDING.md`.

doc/architecture-decisions.md

@@ -122,4 +122,4 @@ export default class HomeView extends Vue {
 
 ---
 
-*This decision was made based on the current codebase architecture and team expertise. The mixin approach provides the best balance of performance, developer experience, and architectural consistency for the TimeSafari application.*
+_This decision was made based on the current codebase architecture and team expertise. The mixin approach provides the best balance of performance, developer experience, and architectural consistency for the TimeSafari application._

doc/error-diagnostics-log.md

@@ -92,5 +92,5 @@ Multiple stack traces showing Vue router navigation and component mounting cycle
 3. Address API/server issues in separate debugging session
 
 ---
-*Log Entry by: Migration Assistant*  
-*Session: ProjectsView.vue Triple Migration Pattern*
+_Log Entry by: Migration Assistant_  
+_Session: ProjectsView.vue Triple Migration Pattern_

doc/meta_rule_usage_guide.md

@@ -32,6 +32,7 @@ you apply 1-3 meta-rules that automatically include everything you need.
 ### **Step 1: Always Start with Core Always-On**
 
 **Every single interaction** starts with:
+
 ```
 meta_core_always_on.mdc
 ```
@@ -65,12 +66,14 @@ meta_core_always_on + meta_research + meta_bug_diagnosis
 **Important**: Meta-rules represent **workflow phases**, not a rigid sequence. You can:
 
 ### **Jump Between Phases Freely**
+
 - **Start with diagnosis** if you already know the problem
 - **Go back to research** if your fix reveals new issues  
 - **Switch to planning** mid-implementation if scope changes
 - **Document at any phase** - not just at the end
 
 ### **Mode Switching by Invoking Meta-Rules**
+
 Each meta-rule invocation **automatically switches your workflow mode**:
 
 ```
@@ -80,11 +83,13 @@ Planning Mode → Invoke @meta_feature_implementation → Implementation Mode
 ```
 
 ### **Phase Constraints, Not Sequence Constraints**
+
 - **Within each phase**: Clear constraints on what you can/cannot do
 - **Between phases**: Complete freedom to move as needed
 - **No forced order**: Choose the phase that matches your current need
 
 ### **Example of Flexible Workflow**
+
 ```
 1. Start with @meta_research (investigation mode)
 2. Jump to @meta_bug_diagnosis (diagnosis mode) 
@@ -103,16 +108,19 @@ Planning Mode → Invoke @meta_feature_implementation → Implementation Mode
 **Scenario**: User reports that the contact list isn't loading properly
 
 **Initial Meta-Rule Selection**:
+
 ```
 meta_core_always_on + meta_research + meta_bug_diagnosis
 ```
 
 **What This Gives You**:
+
 - **Core Always-On**: Human competence focus, time standards, context
 - **Research**: Systematic investigation methodology, evidence collection
 - **Bug Diagnosis**: Defect analysis framework, root cause identification
 
 **Flexible Workflow**:
+
 1. Apply core always-on for foundation
 2. Use research meta-rule for systematic investigation
 3. Switch to bug diagnosis when you have enough evidence
@@ -125,16 +133,19 @@ meta_core_always_on + meta_research + meta_bug_diagnosis
 **Scenario**: Building a new contact search feature
 
 **Meta-Rule Selection**:
+
 ```
 meta_core_always_on + meta_feature_planning + meta_feature_implementation
 ```
 
 **What This Gives You**:
+
 - **Core Always-On**: Foundation principles and context
 - **Feature Planning**: Requirements analysis, architecture planning
 - **Feature Implementation**: Development workflow, testing strategy
 
 **Iterative Workflow**:
+
 1. Start with core always-on
 2. Use feature planning for design and requirements
 3. Switch to feature implementation for coding and testing
@@ -147,15 +158,18 @@ meta_core_always_on + meta_feature_planning + meta_feature_implementation
 **Scenario**: Writing a migration guide for the new database system
 
 **Meta-Rule Selection**:
+
 ```
 meta_core_always_on + meta_documentation
 ```
 
 **What This Gives You**:
+
 - **Core Always-On**: Foundation and context
 - **Documentation**: Educational focus, templates, quality standards
 
 **Parallel Workflow**:
+
 1. Apply core always-on for foundation
 2. Use documentation meta-rule for educational content creation
 3. **Can research** while documenting if you need more information
@@ -198,27 +212,35 @@ Each meta-rule includes success criteria. Use these to validate your work:
 ## Common Meta-Rule Combinations
 
 ### **Research + Diagnosis**
+
 ```
 meta_core_always_on + meta_research + meta_bug_diagnosis
 ```
+
 **Use for**: Complex bug investigations requiring systematic analysis
 
 ### **Planning + Implementation**
+
 ```
 meta_core_always_on + meta_feature_planning + meta_feature_implementation
 ```
+
 **Use for**: End-to-end feature development from concept to deployment
 
 ### **Research + Planning**
+
 ```
 meta_core_always_on + meta_research + meta_feature_planning
 ```
+
 **Use for**: Feasibility research and solution design
 
 ### **Documentation + Context**
+
 ```
 meta_core_always_on + meta_documentation + [context-specific]
 ```
+
 **Use for**: Creating comprehensive, educational documentation
 
 ## Best Practices

doc/migration-004-complexity-resolution-plan.md

@@ -1,198 +0,0 @@
-# Migration 004 Complexity Resolution Plan
-
-**Document Version**: 1.3  
-**Author**: Matthew Raymer  
-**Date**: 2025-01-27  
-**Status**: Implementation Phase - Phase 1 Complete  
-
-## Problem Summary
-
-The current migration 004 implementation has become overly complex with multiple critical issues that create serious risks for data integrity and application performance.
-
-### Four Most Critical Issues
-
-1. **Duplicate SQL Definitions**: Migration 004 SQL exists in three separate locations (main sql field, statements array, recovery logic), making it impossible to ensure all users run identical statements.
-
-2. **Non-Atomic Execution**: Individual statements continue executing even if earlier statements fail, causing partial data migration and potential data loss.
-
-3. **Incorrect Database Result Handling**: Code assumes PlatformService abstraction format when called directly from raw database services, causing runtime errors.
-
-4. **Duplicate Execution Risk**: Recovery logic could re-run statements that already executed successfully, leading to data corruption.
-
-## Resolution Principles
-
-**Guiding Principle**: All migrations must execute from a single SQL source in the MIGRATIONS array, as one atomic statement.
-
-- **Single Source of Truth**: Only one place defines migration SQL
-- **Atomic Operations**: Migration succeeds completely or fails completely  
-- **Database Agnostic**: Result handling works with any database service
-- **Minimal Overhead**: No unnecessary logging or validation
-- **Simple Recovery**: If migration fails, it should be obvious and fixable
-
-## Implementation Phases
-
-### Phase 1: Simplify Migration Definition ✅ COMPLETED
-**Objective**: Establish single source of truth for migration SQL
-
-**Actions**:
-- ✅ Remove `statements` array from migration 004 definition
-- ✅ Keep only the single `sql` field as the authoritative source
-- ✅ Remove all recovery logic that duplicates SQL statements
-- ✅ Ensure migration SQL is self-contained and atomic
-
-**Deliverables**:
-- ✅ Clean migration definition with single SQL source
-- ✅ Removed duplicate SQL definitions
-- ✅ Eliminated recovery logic complexity
-
-### Phase 2: Fix Database Result Handling ✅ COMPLETED
-**Objective**: Make result handling database-agnostic
-
-**Actions**:
-- ✅ Remove DatabaseResult type assumptions from migration code
-- ✅ Implement proper result extraction based on actual database service
-- ✅ Use the `extractMigrationNames` function pattern consistently
-- ✅ Make result handling work with any database service implementation
-- ✅ Normalize results from AbsurdSqlDatabaseService and CapacitorPlatformService into shared internal format
-
-**Deliverables**:
-- ✅ Database-agnostic result handling
-- ✅ Consistent result extraction across all database services
-- ✅ Removed type casting assumptions
-- ✅ Shared internal result format for all database services
-
-### Phase 3: Ensure Atomic Execution ✅ COMPLETED
-**Objective**: Guarantee migration succeeds completely or fails completely
-
-**Actions**:
-- ✅ Modify migration service to execute single SQL block only
-- ✅ Remove individual statement execution logic
-- ✅ Implement proper error handling that prevents partial execution
-- ✅ Ensure migration tracking is accurate
-- ✅ Provide explicit rollback/restore instructions for migration failures
-- ✅ Ensure migration logs indicate failure cause and required operator action
-
-**Deliverables**:
-- ✅ Atomic migration execution
-- ✅ Proper error handling
-- ✅ Accurate migration tracking
-- ✅ Clear recovery procedures
-
-### Phase 4: Remove Excessive Debugging ✅ COMPLETED
-**Objective**: Eliminate performance overhead from debugging code
-
-**Actions**:
-- ✅ Remove detailed logging that slows startup
-- ✅ Keep only essential error logging
-- ✅ Remove complex validation logic that runs on every startup
-- ✅ Move debugging code to test page or development-only mode
-
-**Deliverables**:
-- ✅ Faster application startup
-- ✅ Cleaner production code
-- ✅ Debugging available only when needed
-
-### Phase 5: Testing & Validation
-**Objective**: Ensure simplified migration works correctly
-
-**Actions**:
-- Test migration execution with different database services
-- Verify no duplicate execution occurs
-- Confirm proper error handling
-- Validate data integrity after migration
-- Test rollback/restore scenarios to confirm system recovery paths
-- Test edge cases: empty database, partially migrated database, already-migrated database
-- Test concurrency scenarios (multiple app instances/migrations starting simultaneously)
-- Test cross-platform/device differences (SQLite, AbsurdSQL, Capacitor DB adapters)
-
-**Deliverables**:
-- Working migration system
-- No duplicate execution
-- Proper error handling
-- Data integrity maintained
-- Validated recovery procedures
-- Edge case coverage confirmed
-- Documented test results as artifacts for future regression testing
-
-## Performance & Debugging
-
-**Current Issue**: Excessive logging and validation code runs on every app startup, slowing application performance.
-
-**Solution**: 
-- Debugging/logging is acceptable in development/test environments
-- Production startup must not be slowed by migration debugging
-- Move complex validation to test page or development-only mode
-- Keep only essential error logging for production
-
-## Rollback & Recovery Procedures
-
-### Manual Rollback Steps
-1. **Stop Application**: Ensure no active database connections
-2. **Restore Database**: Use snapshot/backup to restore pre-migration state
-3. **Clear Migration Tracking**: Remove migration 004 entry from migrations table
-4. **Verify State**: Confirm active_identity table is removed and settings.activeDid is restored
-5. **Restart Application**: Test normal operation
-
-### Automated Rollback
-- **Automated Detection**: Migration service detects failure and triggers rollback
-- **Database Restore**: Automated restoration from pre-migration snapshot
-- **Logging**: Detailed rollback logs with failure cause and recovery actions
-- **Validation**: Automated verification of rollback success
-
-### Recovery Validation
-- **Data Integrity Check**: Verify all data is consistent with pre-migration state
-- **Migration Status**: Confirm migration tracking reflects correct state
-- **Application Functionality**: Test core features work correctly
-- **Performance Baseline**: Confirm startup performance matches pre-migration levels
-
-## Files Requiring Changes
-
-### Core Migration Files (Primary Changes)
-- `src/db-sql/migration.ts` - Remove duplicate SQL definitions, fix DatabaseResult usage, remove recovery logic
-- `src/services/migrationService.ts` - Remove individual statement execution, ensure atomic execution
-
-### Database Service Files (Result Handling Fixes)
-- `src/services/AbsurdSqlDatabaseService.ts` - Fix result extraction for migration queries
-- `src/services/platforms/CapacitorPlatformService.ts` - Fix result extraction for migration queries
-
-**Note**: Verify all file paths match repository reality as part of CI validation.
-
-## Success Criteria
-
-- [ ] Migration 004 SQL defined in single location only
-- [ ] Migration executes atomically (all-or-nothing)
-- [ ] Database result handling works with all database services
-- [ ] No duplicate statement execution possible
-- [ ] Startup time reduced by at least 20% compared to pre-fix baseline (measured via cold app start profiling logs)
-- [ ] Migration tracking is accurate and reliable
-- [ ] Error handling is clear and actionable
-
-## Next Steps
-
-1. **Review and Approve Plan**: Get stakeholder approval for this approach
-2. **Phase 1 Implementation**: Begin with simplifying migration definition
-3. **Testing**: Validate each phase before proceeding
-4. **Assign Migration Owner**: Designate clear owner for future migration reviews
-5. **Create Review Checklist**: Define lightweight checklist (SQL duplication, atomicity, error handling) to prevent recurrence
-
-## Dependencies
-
-- Migration service architecture
-- Database service implementations
-- Testing infrastructure
-- Documentation system
-- Seed datasets or controlled test states for reproducible validation
-- Snapshot/restore utilities for rollback testing
-
-## Lessons Learned
-
-**Process Improvement Note**: This migration complexity highlights the importance of closer review and consolidation of AI-generated code. Uncontrolled proliferation of generated logic leads to fragmentation, review fatigue, and system instability. Future development should prioritize:
-
-- Single source of truth for all critical logic
-- Atomic operations over complex multi-step processes  
-- Regular consolidation and simplification of generated code
-- Clear ownership and review processes for migration logic
-
----
-
-*This document will be updated as the implementation progresses and new insights are gained.*

doc/notification-system.md

@@ -0,0 +1,231 @@
+# TimeSafari — Native-First Notification System
+
+**Status:** Ready for implementation  
+**Date:** 2025-09-07  
+**Author:** Matthew Raymer
+
+---
+
+## Executive Summary
+
+Ship a **single, Native-First** notification system: OS-scheduled **background prefetch at T–lead** + **pre-armed** local notifications. Web-push is retired.
+
+### What we deliver
+
+- **Closed-app delivery:** Pre-armed locals fire even if the app is closed.
+- **Freshness:** One prefetch attempt per slot at **T–lead**; ETag/TTL controls; skip when stale.
+- **Android precision:** Exact alarms with permission; windowed fallback (±10m) otherwise.
+- **Resilience:** Re-arm after reboot/time-change (Android receivers; iOS on next wake/silent push).
+- **Cross-platform:** Same TS API (iOS/Android/Electron). Electron is best-effort while running.
+
+### Success signals
+
+- High delivery reliability, minute-precision on Android with permission.
+- Prefetch budget hit rate at **T–lead**; zero stale deliveries beyond TTL.
+
+---
+
+## Strategic Plan
+
+### Goal
+
+Deliver 1..M daily notifications with **OS background prefetch at T–lead** and **rolling-window safety** so messages display with fresh content even when the app is closed.
+
+### Tenets
+
+- **Reliability first:** OS delivers once scheduled; no JS at delivery time.
+- **Freshness with guardrails:** Prefetch at **T–lead**; enforce **TTL-at-fire**; ETag-aware.
+- **Single system:** One TS API; native adapters swap under the hood.
+- **Platform honesty:** Android exactness via permission; iOS best-effort budget.
+
+### Architecture (high level)
+
+App (Vue/TS) → Orchestrator (policy) → Native Adapters:
+
+- **SchedulerNative** — AlarmManager (Android) / UNUserNotificationCenter (iOS)  
+- **BackgroundPrefetchNative** — WorkManager (Android) / BGTaskScheduler (+ silent push) (iOS)  
+- **DataStore** — SQLite
+
+**Storage (single shared DB):** The app and the native plugin will use **the same SQLite database file**. The app owns schema/migrations; the plugin opens the same file with WAL enabled and performs short, serialized writes. This keeps one source of truth for payloads, delivery logs, and config.
+
+### SQLite Ownership & Concurrency
+
+* **One DB file:** The plugin opens the **same path** the app uses (no second DB).
+* **Migrations owned by app:** The app executes schema migrations and bumps `PRAGMA user_version`. The plugin **never** migrates; it **asserts** the expected version.
+* **WAL mode:** Open DB with `journal_mode=WAL`, `synchronous=NORMAL`, `busy_timeout=5000`, `foreign_keys=ON`. WAL allows foreground reads while a background job commits quickly.
+* **Single-writer discipline:** Background jobs write in **short transactions** (UPSERT per slot), then return.
+* **Encryption (optional):** If using SQLCipher, the **same key** is used by both app and plugin. Do not mix encrypted and unencrypted openings.
+
+### Scheduling & T–lead
+
+- **Arm** a rolling window (today + tomorrow within iOS cap).  
+- **Attempt** a single **online-first** fetch per slot at **T–lead = T − prefetchLeadMinutes**.  
+- If prefetch is skipped, the armed local **still fires** using cached content.
+
+### Policies
+
+- **TTL-at-fire:** If (T − fetchedAt) > `ttlSeconds` → **skip** arming.  
+- **Android exactness:** Request `SCHEDULE_EXACT_ALARM`; fallback **±10m** window.  
+- **Reboot/time change:** Android receivers re-arm next 24h; iOS on next wake/silent push.  
+- **No delivery-time mutation:** iOS locals cannot be mutated by NSE; render before scheduling.
+
+---
+
+## Implementation Guide
+
+### 1) Interfaces (TS stable)
+
+- **SchedulerNative**: `scheduleExact({slotId, whenMs, title, body, extra})`, `scheduleWindow(..., windowLenMs)`, `cancelBySlot`, `rescheduleAll`, `capabilities()`
+- **BackgroundPrefetchNative**: `schedulePrefetch(slotId, atMs)`, `cancelPrefetch(slotId)`
+- **DataStore**: SQLite adapters (notif_contents, notif_deliveries, notif_config)
+- **Public API**: `configure`, `requestPermissions`, `runFullPipelineNow`, `reschedule`, `getState`
+
+### DB Path & Adapter Configuration
+
+* **Configure option:** `dbPath: string` (absolute path or platform alias) is passed from JS to the plugin during `configure()`.
+* **Shared tables:**
+
+  * `notif_contents(slot_id, payload_json, fetched_at, etag, …)`
+  * `notif_deliveries(slot_id, fire_at, delivered_at, status, error_code, …)`
+  * `notif_config(k, v)`
+* **Open settings:**
+
+  * `journal_mode=WAL`
+  * `synchronous=NORMAL`
+  * `busy_timeout=5000`
+  * `foreign_keys=ON`
+
+**Type (TS) extension**
+
+```ts
+export type ConfigureOptions = {
+  // …existing fields…
+  dbPath: string;                 // shared DB file the plugin will open
+  storage: 'shared';              // canonical value; plugin-owned DB is not used
+};
+```
+
+**Plugin side (pseudo)**
+
+```kotlin
+// Android open
+val db = SQLiteDatabase.openDatabase(dbPath, null, SQLiteDatabase.OPEN_READWRITE)
+db.execSQL("PRAGMA journal_mode=WAL")
+db.execSQL("PRAGMA synchronous=NORMAL")
+db.execSQL("PRAGMA foreign_keys=ON")
+db.execSQL("PRAGMA busy_timeout=5000")
+// Verify schema version
+val uv = rawQuery("PRAGMA user_version").use { it.moveToFirst(); it.getInt(0) }
+require(uv >= MIN_EXPECTED_VERSION) { "Schema version too old" }
+```
+
+```swift
+// iOS open (FMDB / SQLite3)
+// Set WAL via PRAGMA after open; check user_version the same way.
+```
+
+### 2) Templating & Arming
+
+- Render `title/body` **before** scheduling; pass via **SchedulerNative**.
+- Route all arming through **SchedulerNative** to centralize Android exact/window semantics.
+
+### 3) T–lead (single attempt)
+
+**T–lead governs prefetch, not arming.** We **arm** one-shot locals as part of the rolling window so closed-app delivery is guaranteed. At **T–lead = T − prefetchLeadMinutes**, the **native background job** attempts **one** 12s ETag-aware fetch. If fresh content arrives and will not violate **TTL-at-fire**, we (re)arm the upcoming slot; if the OS skips the wake, the pre-armed local still fires with cached content.
+
+- Compute T–lead = `whenMs - prefetchLeadMinutes*60_000`.
+- `BackgroundPrefetchNative.schedulePrefetch(slotId, atMs=T–lead)`.
+- On wake: **ETag** fetch (timeout **12s**), persist, optionally cancel & re-arm if within TTL.
+- Never fetch at delivery time.
+
+### 4) TTL-at-fire
+
+**TTL-at-fire:** Before arming for time **T**, compute `T − fetchedAt`. If that exceeds `ttlSeconds`, **do not arm** (skip). This prevents posting stale notifications when the app has been closed for a long time.
+
+`if (whenMs - fetchedAt) > ttlSeconds*1000 → skip`
+
+### 5) Android specifics
+
+- Request `SCHEDULE_EXACT_ALARM`; deep-link if denied; fallback to `setWindow(start,len)` (±10m).
+- Receivers: `BOOT_COMPLETED`, `TIMEZONE_CHANGED`, `TIME_SET` → recompute & re-arm for next 24h and schedule T–lead prefetch.
+
+### 6) iOS specifics
+
+- `BGTaskScheduler` for T–lead prefetch (best-effort). Optional silent push nudge.
+- Locals: `UNCalendarNotificationTrigger` (one-shots); no NSE mutation for locals.
+
+### 7) Network & Timeouts
+
+- Content fetch: **12s** timeout; single attempt at T–lead; ETag/304 respected.
+- ACK/Error: **8s** timeout, fire-and-forget.
+
+### 8) Electron
+
+- Notifications while app is running; recommend **Start-on-Login**. No true background scheduling when fully closed.
+
+### 9) Telemetry
+
+- Record `scheduled|shown|error`; ACK deliveries (8s timeout); include slot/times/TZ/app version.
+
+---
+
+## Capability Matrix
+
+| Capability | Android (Native) | iOS (Native) | Electron | Web |
+|---|---|---|---|---|
+| Multi-daily locals (closed app) | ✅ | ✅ | ✅ (app running) | — |
+| Prefetch at T–lead (app closed) | ✅ WorkManager | ⚠️ BGTask (best-effort) | ✅ (app running) | — |
+| Re-arm after reboot/time-change | ✅ Receivers | ⚠️ On next wake/silent push | ✅ Start-on-Login | — |
+| Minute-precision alarms | ✅ with exact permission | ❌ not guaranteed | ✅ timer best-effort | — |
+| Delivery-time mutation for locals | ❌ | ❌ | — | — |
+| ETag/TTL enforcement | ✅ | ✅ | ✅ | — |
+| Rolling-window safety | ✅ | ✅ | ✅ | — |
+
+---
+
+## Acceptance Criteria
+
+### Core
+
+- **Closed-app delivery:** Armed locals fire at T with last rendered content. No delivery-time network.
+- **T–lead prefetch:** Single background attempt at **T–lead**; if skipped, delivery still occurs from cache.
+- **TTL-at-fire:** No armed local violates TTL at T.
+
+### Android
+
+- **Exact permission path:** With `SCHEDULE_EXACT_ALARM` → within ±1m; else **±10m** window.
+- **Reboot recovery:** After reboot, receivers re-arm next 24h and schedule T–lead prefetch.
+- **TZ/DST change:** Recompute & re-arm; future slots align to new wall-clock.
+
+### iOS
+
+- **BGTask budget respected:** Prefetch often runs but may be skipped; delivery still occurs via rolling window.
+- **Force-quit caveat:** No background execution after user terminate; delivery still occurs if pre-armed.
+
+### Electron
+
+- **Running-app rule:** Delivery only while app runs; with Start-on-Login, after reboot the orchestrator re-arms and subsequent slots deliver.
+
+### Network
+
+- Content fetch timeout **12s**; ACK/Error **8s**; no retries inside lead; ETag honored.
+
+### Observability
+
+- Log/telemetry for `scheduled|shown|error`; ACK payload includes slot, times, device TZ, app version.
+
+### DB Sharing
+
+* **Shared DB visibility:** A background prefetch writes `notif_contents`; the foreground UI **immediately** reads the same row.
+* **WAL overlap:** With the app reading while the plugin commits, no user-visible blocking occurs.
+* **Version safety:** If `user_version` is behind, the plugin emits an error and does not write (protects against partial installs).
+
+---
+
+## Web-Push Cleanup
+
+Web-push functionality has been retired due to unreliability. All web-push related code paths and documentation sections should be removed or marked as deprecated. See `web-push-cleanup-guide.md` for detailed cleanup steps.
+
+---
+
+_This document consolidates the Native-First notification system strategy, implementation details, capabilities, and acceptance criteria into a single comprehensive reference._

doc/seed-phrase-reminder-implementation.md

@@ -1,181 +0,0 @@
-# Seed Phrase Backup Reminder Implementation
-
-## Overview
-
-This implementation adds a modal dialog that reminds users to back up their seed phrase if they haven't done so yet. The reminder appears after specific user actions and includes a 24-hour cooldown to avoid being too intrusive.
-
-## Features
-
-- **Modal Dialog**: Uses the existing notification group modal system from `App.vue`
-- **Smart Timing**: Only shows when `hasBackedUpSeed = false`
-- **24-Hour Cooldown**: Uses localStorage to prevent showing more than once per day
-- **Action-Based Triggers**: Shows after specific user actions
-- **User Choice**: "Backup Identifier Seed" or "Remind me Later" options
-
-## Implementation Details
-
-### Core Utility (`src/utils/seedPhraseReminder.ts`)
-
-The main utility provides:
-
-- `shouldShowSeedReminder(hasBackedUpSeed)`: Checks if reminder should be shown
-- `markSeedReminderShown()`: Updates localStorage timestamp
-- `createSeedReminderNotification()`: Creates the modal configuration
-- `showSeedPhraseReminder(hasBackedUpSeed, notifyFunction)`: Main function to show reminder
-
-### Trigger Points
-
-The reminder is shown after these user actions:
-
-**Note**: The reminder is triggered by **claim creation** actions, not claim confirmations. This focuses on when users are actively creating new content rather than just confirming existing claims.
-
-1. **Profile Saving** (`AccountViewView.vue`)
-   - After clicking "Save Profile" button
-   - Only when profile save is successful
-
-2. **Claim Creation** (Multiple views)
-   - `ClaimAddRawView.vue`: After submitting raw claims
-   - `GiftedDialog.vue`: After creating gifts/claims
-   - `GiftedDetailsView.vue`: After recording gifts/claims
-   - `OfferDialog.vue`: After creating offers
-
-3. **QR Code Views Exit**
-   - `ContactQRScanFullView.vue`: When exiting via back button
-   - `ContactQRScanShowView.vue`: When exiting via back button
-
-### Modal Configuration
-
-```typescript
-{
-  group: "modal",
-  type: "confirm",
-  title: "Backup Your Identifier Seed?",
-  text: "It looks like you haven't backed up your identifier seed yet. It's important to back it up as soon as possible to secure your identity.",
-  yesText: "Backup Identifier Seed",
-  noText: "Remind me Later",
-  onYes: () => navigate to /seed-backup,
-  onNo: () => mark as shown for 24 hours,
-  onCancel: () => mark as shown for 24 hours
-}
-```
-
-**Important**: The modal is configured with `timeout: -1` to ensure it stays open until the user explicitly interacts with one of the buttons. This prevents the dialog from closing automatically.
-
-### Cooldown Mechanism
-
-- **Storage Key**: `seedPhraseReminderLastShown`
-- **Cooldown Period**: 24 hours (24 * 60 * 60 * 1000 milliseconds)
-- **Implementation**: localStorage with timestamp comparison
-- **Fallback**: Shows reminder if timestamp is invalid or missing
-
-## User Experience
-
-### When Reminder Appears
-
-- User has not backed up their seed phrase (`hasBackedUpSeed = false`)
-- At least 24 hours have passed since last reminder
-- User performs one of the trigger actions
-- **1-second delay** after the success message to allow users to see the confirmation
-
-### User Options
-
-1. **"Backup Identifier Seed"**: Navigates to `/seed-backup` page
-2. **"Remind me Later"**: Dismisses and won't show again for 24 hours
-3. **Cancel/Close**: Same behavior as "Remind me Later"
-
-### Frequency Control
-
-- **First Time**: Always shows if user hasn't backed up
-- **Subsequent**: Only shows after 24-hour cooldown
-- **Automatic Reset**: When user completes seed backup (`hasBackedUpSeed = true`)
-
-## Technical Implementation
-
-### Error Handling
-
-- Graceful fallback if localStorage operations fail
-- Logging of errors for debugging
-- Non-blocking implementation (doesn't affect main functionality)
-
-### Integration Points
-
-- **Platform Service**: Uses `$accountSettings()` to check backup status
-- **Notification System**: Integrates with existing `$notify` system
-- **Router**: Uses `window.location.href` for navigation
-
-### Performance Considerations
-
-- Minimal localStorage operations
-- No blocking operations
-- Efficient timestamp comparisons
-- **Timing Behavior**: 1-second delay before showing reminder to improve user experience flow
-
-## Testing
-
-### Manual Testing Scenarios
-
-1. **First Time User**
-   - Create new account
-   - Perform trigger action (save profile, create claim, exit QR view)
-   - Verify reminder appears
-
-2. **Repeat User (Within 24h)**
-   - Perform trigger action
-   - Verify reminder does NOT appear
-
-3. **Repeat User (After 24h)**
-   - Wait 24+ hours
-   - Perform trigger action
-   - Verify reminder appears again
-
-4. **User Who Has Backed Up**
-   - Complete seed backup
-   - Perform trigger action
-   - Verify reminder does NOT appear
-
-5. **QR Code View Exit**
-   - Navigate to QR code view (full or show)
-   - Exit via back button
-   - Verify reminder appears (if conditions are met)
-
-### Browser Testing
-
-- Test localStorage functionality
-- Verify timestamp handling
-- Check navigation to seed backup page
-
-## Future Enhancements
-
-### Potential Improvements
-
-1. **Customizable Cooldown**: Allow users to set reminder frequency
-2. **Progressive Urgency**: Increase reminder frequency over time
-3. **Analytics**: Track reminder effectiveness and user response
-4. **A/B Testing**: Test different reminder messages and timing
-
-### Configuration Options
-
-- Reminder frequency settings
-- Custom reminder messages
-- Different trigger conditions
-- Integration with other notification systems
-
-## Maintenance
-
-### Monitoring
-
-- Check localStorage usage in browser dev tools
-- Monitor user feedback about reminder frequency
-- Track navigation success to seed backup page
-
-### Updates
-
-- Modify reminder text in `createSeedReminderNotification()`
-- Adjust cooldown period in `REMINDER_COOLDOWN_MS` constant
-- Add new trigger points as needed
-
-## Conclusion
-
-This implementation provides a non-intrusive way to remind users about seed phrase backup while respecting their preferences and avoiding notification fatigue. The 24-hour cooldown ensures users aren't overwhelmed while maintaining the importance of the security reminder.
-
-The feature is fully integrated with the existing codebase architecture and follows established patterns for notifications, error handling, and user interaction.

doc/verification-party-system-plan.md

@@ -1,375 +0,0 @@
-# TimeSafari Identity Verification Party System Plan
-
-## Objectives
-
-* Maintain strict conformity with TimeSafari's existing **DID, contact, and identity management**.
-* Ensure **offline-first reliability** with background sync and retry logic.
-* Provide **minimal, mobile-first UX** with single-tap core actions and QR-driven flows.
-
-## Architecture
-
-* Use a **single atomic migration** (`005_verification_party_system.sql`) following `registerMigration()` + `MIGRATIONS` array pattern.
-* Standardize timestamps (`dateCreated`, `dateVerified`) in **ISO-8601 UTC**.
-* Add `verification_session_logs` for audit trail and debugging.
-
-## Workflow
-
-* **Pre-Party**: Enforce RSVP via DID signing challenge; cache DID QR locally.
-* **In-Party**: Dual-mode verification (Fast Scan + Deep Verify) with **trust presets**.
-* **Post-Party**: Queue verifications for delayed sync; issue signed receipts; auto-create verified contacts.
-
-## Services
-
-* `VerificationPartyService`: Monolithic class aligned with existing service pattern.
-* `DidVerificationService`: Pluggable methods (QR, NFC, manual, photo ID).
-* `TrustNetworkService`: Add caching + **trust decay** unless renewed.
-
-## Security
-
-* Store **hashes of evidence** only (not raw PII).
-* Encrypt data with **per-user derived keys**.
-* Provide **per-verification sharing controls** (private, party-only, global).
-
-## UI/UX
-
-* Single-tap flows for RSVP, scan, verify.
-* Embed **trust level criteria** in UI to reduce inconsistency.
-* Optimize QR scanning and trust graph for **battery savings**.
-* Follow existing **i18n service** for multi-language support.
-
-## Priorities
-
-1. Migration + offline queue
-2. Dual-mode verification UI
-3. Trust graph caching + decay
-4. Privacy-hardened evidence handling
-5. Notification constants + helper integration
-
----
-
-## Database Schema
-
-### Migration 005: Verification Party System
-Add to `src/db-sql/migration.ts` in the `MIGRATIONS` array:
-
-```typescript
-{
-  name: "005_verification_party_system",
-  sql: `
-    -- Migration 005: verification_party_system
-    -- Adds identity verification party functionality
-    
-    -- Enable foreign key constraints for data integrity
-    PRAGMA foreign_keys = ON;
-    
-    -- Create verification_parties table
-    CREATE TABLE IF NOT EXISTS verification_parties (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      partyId TEXT UNIQUE NOT NULL,
-      organizerDid TEXT NOT NULL,
-      name TEXT NOT NULL,
-      description TEXT,
-      location TEXT,
-      scheduledDate TEXT,
-      maxParticipants INTEGER DEFAULT 50,
-      status TEXT DEFAULT 'planned',
-      dateCreated TEXT DEFAULT (datetime('now')),
-      FOREIGN KEY (organizerDid) REFERENCES accounts(did)
-    );
-    
-    -- Create party_participants table
-    CREATE TABLE IF NOT EXISTS party_participants (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      partyId TEXT NOT NULL,
-      participantDid TEXT NOT NULL,
-      status TEXT DEFAULT 'invited',
-      verificationCount INTEGER DEFAULT 0,
-      rsvpDate TEXT,
-      checkInDate TEXT,
-      dateCreated TEXT DEFAULT (datetime('now')),
-      FOREIGN KEY (partyId) REFERENCES verification_parties(partyId),
-      FOREIGN KEY (participantDid) REFERENCES accounts(did)
-    );
-    
-    -- Create did_verifications table
-    CREATE TABLE IF NOT EXISTS did_verifications (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      verifierDid TEXT NOT NULL,
-      verifiedDid TEXT NOT NULL,
-      partyId TEXT,
-      verificationMethod TEXT,
-      verificationNotes TEXT,
-      verificationLevel INTEGER DEFAULT 1,
-      verificationEvidenceHash TEXT,
-      dateVerified TEXT DEFAULT (datetime('now')),
-      FOREIGN KEY (verifierDid) REFERENCES accounts(did),
-      FOREIGN KEY (verifiedDid) REFERENCES accounts(did),
-      FOREIGN KEY (partyId) REFERENCES verification_parties(partyId)
-    );
-    
-    -- Create verification_session_logs table
-    CREATE TABLE IF NOT EXISTS verification_session_logs (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      partyId TEXT NOT NULL,
-      sessionAction TEXT NOT NULL,
-      participantDid TEXT,
-      actionData TEXT,
-      dateCreated TEXT DEFAULT (datetime('now')),
-      FOREIGN KEY (partyId) REFERENCES verification_parties(partyId),
-      FOREIGN KEY (participantDid) REFERENCES accounts(did)
-    );
-    
-    -- Create indexes for performance
-    CREATE INDEX IF NOT EXISTS idx_verification_parties_organizer ON verification_parties(organizerDid);
-    CREATE INDEX IF NOT EXISTS idx_verification_parties_status ON verification_parties(status);
-    CREATE INDEX IF NOT EXISTS idx_party_participants_party ON party_participants(partyId);
-    CREATE INDEX IF NOT EXISTS idx_party_participants_did ON party_participants(participantDid);
-    CREATE INDEX IF NOT EXISTS idx_did_verifications_verifier ON did_verifications(verifierDid);
-    CREATE INDEX IF NOT EXISTS idx_did_verifications_verified ON did_verifications(verifiedDid);
-    CREATE INDEX IF NOT EXISTS idx_did_verifications_party ON did_verifications(partyId);
-    CREATE INDEX IF NOT EXISTS idx_session_logs_party ON verification_session_logs(partyId);
-  `
-}
-```
-
----
-
-## TypeScript Interfaces
-
-### Required Interface Definitions
-Add to `src/interfaces/verification-party.ts`:
-
-```typescript
-/**
- * Verification Party entity interface
- */
-export interface VerificationParty {
-  id: number;
-  partyId: string;
-  organizerDid: string;
-  name: string;
-  description?: string;
-  location?: string;
-  scheduledDate?: string;
-  maxParticipants: number;
-  status: 'planned' | 'active' | 'completed' | 'cancelled';
-  dateCreated: string;
-}
-
-/**
- * Party Participant entity interface
- */
-export interface PartyParticipant {
-  id: number;
-  partyId: string;
-  participantDid: string;
-  status: 'invited' | 'confirmed' | 'attended' | 'verified';
-  verificationCount: number;
-  rsvpDate?: string;
-  checkInDate?: string;
-  dateCreated: string;
-}
-
-/**
- * DID Verification entity interface
- */
-export interface DidVerification {
-  id: number;
-  verifierDid: string;
-  verifiedDid: string;
-  partyId?: string;
-  verificationMethod: 'qr_scan' | 'manual_entry' | 'photo_id' | 'nfc';
-  verificationNotes?: string;
-  verificationLevel: number; // 1-5 trust level
-  verificationEvidenceHash?: string; // Hash of verification evidence
-  dateVerified: string;
-}
-
-/**
- * Verification Session Log entity interface
- */
-export interface VerificationSessionLog {
-  id: number;
-  partyId: string;
-  sessionAction: 'party_started' | 'participant_joined' | 'verification_completed' | 'sync_attempted';
-  participantDid?: string;
-  actionData?: string; // JSON blob of action-specific data
-  dateCreated: string;
-}
-```
-
----
-
-## PlatformServiceMixin Integration
-
-### Required Methods
-Add to `PlatformServiceMixin`:
-
-```typescript
-// Add to PlatformServiceMixin methods
-async $insertVerificationParty(party: Partial<VerificationParty>): Promise<boolean> {
-  return this.$insertEntity('verification_parties', party, [
-    'partyId', 'organizerDid', 'name', 'description', 'location', 
-    'scheduledDate', 'maxParticipants', 'status', 'dateCreated'
-  ]);
-}
-
-async $insertPartyParticipant(participant: Partial<PartyParticipant>): Promise<boolean> {
-  return this.$insertEntity('party_participants', participant, [
-    'partyId', 'participantDid', 'status', 'verificationCount',
-    'rsvpDate', 'checkInDate', 'dateCreated'
-  ]);
-}
-
-async $insertDidVerification(verification: Partial<DidVerification>): Promise<boolean> {
-  return this.$insertEntity('did_verifications', verification, [
-    'verifierDid', 'verifiedDid', 'partyId', 'verificationMethod',
-    'verificationNotes', 'verificationLevel', 'verificationEvidenceHash', 'dateVerified'
-  ]);
-}
-
-async $getVerificationParties(): Promise<VerificationParty[]> {
-  const results = await this.$dbQuery('SELECT * FROM verification_parties ORDER BY dateCreated DESC');
-  return this.$mapResults(results, (row) => ({
-    id: row[0] as number,
-    partyId: row[1] as string,
-    organizerDid: row[2] as string,
-    name: row[3] as string,
-    description: row[4] as string,
-    location: row[5] as string,
-    scheduledDate: row[6] as string,
-    maxParticipants: row[7] as number,
-    status: row[8] as VerificationParty['status'],
-    dateCreated: row[9] as string,
-  }));
-}
-
-async $getPartyParticipants(partyId: string): Promise<PartyParticipant[]> {
-  const results = await this.$dbQuery(
-    'SELECT * FROM party_participants WHERE partyId = ? ORDER BY dateCreated DESC',
-    [partyId]
-  );
-  return this.$mapResults(results, (row) => ({
-    id: row[0] as number,
-    partyId: row[1] as string,
-    participantDid: row[2] as string,
-    status: row[3] as PartyParticipant['status'],
-    verificationCount: row[4] as number,
-    rsvpDate: row[5] as string,
-    checkInDate: row[6] as string,
-    dateCreated: row[7] as string,
-  }));
-}
-```
-
----
-
-## Notification Constants
-
-### Required Notification Constants
-Add to `src/constants/notifications.ts`:
-
-```typescript
-// Used in: VerificationPartyCreateView.vue (createParty method)
-export const NOTIFY_PARTY_CREATED = {
-  title: "Verification Party Created",
-  message: "Your verification party has been created successfully."
-};
-
-// Used in: VerificationPartyJoinView.vue (joinParty method)
-export const NOTIFY_PARTY_JOINED = {
-  title: "Party Joined",
-  message: "You have successfully joined the verification party."
-};
-
-// Used in: VerificationPartyActiveView.vue (submitManualVerification method)
-export const NOTIFY_VERIFICATION_COMPLETED = {
-  title: "Identity Verified",
-  message: "You have successfully verified this person's identity."
-};
-
-// Used in: VerificationPartyService.ts (syncVerifications method)
-export const NOTIFY_VERIFICATION_SYNCED = {
-  title: "Verifications Synced",
-  message: "Your verification data has been synchronized successfully."
-};
-
-// Used in: VerificationPartyActiveView.vue (error handling)
-export const NOTIFY_VERIFICATION_FAILED = {
-  title: "Verification Failed",
-  message: "There was an error completing the verification. Please try again."
-};
-```
-
-### Notification Helper Integration
-Use existing `createNotifyHelpers()` pattern in components:
-
-```typescript
-// In VerificationPartyCreateView.vue
-const { success, error } = createNotifyHelpers(this.$notify);
-
-// Usage
-success("Party created successfully!");
-error("Failed to create party. Please try again.");
-```
-
----
-
-## Component Implementation Pattern
-
-### VerificationPartyCreateView.vue Structure
-```typescript
-@Component({
-  name: "VerificationPartyCreateView",
-  components: {
-    QuickNav,
-    TopMessage,
-    EntityIcon,
-  },
-  mixins: [PlatformServiceMixin],
-})
-export default class VerificationPartyCreateView extends Vue {
-  // Use PlatformServiceMixin methods
-  async createParty(): Promise<void> {
-    const partyData: Partial<VerificationParty> = {
-      partyId: `party_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
-      organizerDid: (await this.$getActiveIdentity()).activeDid,
-      name: this.partyForm.name,
-      description: this.partyForm.description,
-      location: this.partyForm.location,
-      scheduledDate: this.partyForm.scheduledDate,
-      maxParticipants: this.partyForm.maxParticipants,
-      status: 'planned',
-      dateCreated: new Date().toISOString(),
-    };
-    
-    const success = await this.$insertVerificationParty(partyData);
-    if (success) {
-      this.$notify(NOTIFY_PARTY_CREATED);
-      this.$router.push(`/verification-party/${partyData.partyId}`);
-    } else {
-      this.$notify(NOTIFY_VERIFICATION_FAILED);
-    }
-  }
-}
-```
-
----
-
-## Architecture Conformity Checklist
-
-### ✅ **100% CONFORMANT PATTERNS**
-- **Migration Structure**: ✅ Follows existing `registerMigration()` and `MIGRATIONS` array pattern
-- **Database Schema**: ✅ Uses `INTEGER PRIMARY KEY AUTOINCREMENT` and `camelCase` field naming
-- **Component Architecture**: ✅ Integrates `@Component` decorator and `PlatformServiceMixin`
-- **Service Pattern**: ✅ Single monolithic service class following TimeSafari conventions
-- **Notification System**: ✅ Uses existing `NOTIFY_*` constants and `createNotifyHelpers()`
-- **UI Components**: ✅ Leverages existing `QuickNav`, `TopMessage`, `EntityIcon` components
-- **TypeScript Interfaces**: ✅ Proper interface definitions following existing patterns
-- **PlatformServiceMixin Integration**: ✅ Uses existing `$insertEntity()` and `$mapResults()` methods
-- **Database Operations**: ✅ Follows existing `$dbQuery()`, `$dbExec()` patterns
-- **Error Handling**: ✅ Uses existing logger and error handling patterns
-
-### 📊 **FINAL CONFORMITY SCORE: 100%**
-
-The verification party system plan now achieves complete conformity with TimeSafari's existing architecture patterns, naming conventions, and integration approaches.

doc/web-push-cleanup-guide.md

@@ -0,0 +1,551 @@
+# TimeSafari Web-Push Cleanup Guide
+
+**Status:** 🚀 Native-First Implementation  
+**Date:** 2025-01-27T14:30Z (UTC)  
+**Author:** Matthew Raymer  
+**Scope:** Web-push code cleanup and deprecation  
+**Goal:** Remove or quarantine all web-push code paths and mark as deprecated.
+
+---
+
+## Executive Summary
+
+This document provides a comprehensive cleanup guide for removing web-push code
+paths from TimeSafari. Web-push has been retired for unreliability, and the
+system now focuses on native mobile reliability with Electron best-effort support.
+
+---
+
+## Cleanup Strategy
+
+### Phase 1: Identify Web-Push Code Paths
+
+#### Service Worker Files
+
+- [ ] `sw_scripts/notification-click.js` - Mark as deprecated
+- [ ] `sw_scripts/` directory - Review for web-push dependencies
+- [ ] Service worker registration code - Remove or quarantine
+
+#### Web-Specific Code
+
+- [ ] Web push notification handlers
+- [ ] Service worker event listeners
+- [ ] Web notification API usage
+- [ ] Push subscription management
+
+#### Configuration Files
+
+- [ ] VitePWA plugin configuration
+- [ ] Service worker build configuration
+- [ ] Web push manifest files
+
+### Phase 2: Mark as Deprecated
+
+#### Code Comments
+
+```javascript
+// DEPRECATED: Web-push notification handling
+// This code is kept for reference but not used in production
+// Replaced by Native-First notification system
+```
+
+#### Documentation Updates
+
+- [ ] Mark web-push sections as deprecated
+- [ ] Add deprecation notices
+- [ ] Update README files
+- [ ] Update API documentation
+
+### Phase 3: Remove or Quarantine
+
+#### Complete Removal
+
+- [ ] Web push subscription code
+- [ ] Service worker notification handlers
+- [ ] Web-specific notification APIs
+- [ ] Push message handling
+
+#### Quarantine (Keep for Reference)
+
+- [ ] Service worker registration code
+- [ ] Web push configuration
+- [ ] Historical web-push tests
+
+---
+
+## Detailed Cleanup Tasks
+
+### 1. Service Worker Cleanup
+
+#### Files to Deprecate
+
+**`sw_scripts/notification-click.js`**
+
+```javascript
+// DEPRECATED: Service worker notification handling
+// This code is kept for reference but not used in production
+// Replaced by Native-First notification system
+
+// Original web-push notification click handler
+self.addEventListener('notificationclick', (event) => {
+  // DEPRECATED: Web-push only
+  event.notification.close();
+
+  const slotId = event.notification.data?.slotId;
+  const route = slotId ? '/#/daily' : '/#/notifications';
+
+  event.waitUntil(
+    clients.openWindow(route).catch(() => {
+      return clients.openWindow('/');
+    })
+  );
+});
+```
+
+**Service Worker Registration**
+
+```javascript
+// DEPRECATED: Service worker registration
+// This code is kept for reference but not used in production
+// Replaced by Native-First notification system
+
+if ('serviceWorker' in navigator && process.env.VITE_PLATFORM === 'web') {
+  // DEPRECATED: Web-push only
+  navigator.serviceWorker.register('/sw.js')
+    .then(registration => {
+      console.log('Service Worker registered:', registration);
+    })
+    .catch(error => {
+      console.error('Service Worker registration failed:', error);
+    });
+}
+```
+
+### 2. Web Push API Cleanup
+
+#### Push Subscription Management
+
+```javascript
+// DEPRECATED: Web push subscription management
+// This code is kept for reference but not used in production
+// Replaced by Native-First notification system
+
+class WebPushManager {
+  // DEPRECATED: Web-push only
+  async subscribeToPush() {
+    // Implementation kept for reference
+  }
+
+  // DEPRECATED: Web-push only
+  async unsubscribeFromPush() {
+    // Implementation kept for reference
+  }
+}
+```
+
+#### Push Message Handling
+
+```javascript
+// DEPRECATED: Push message handling
+// This code is kept for reference but not used in production
+// Replaced by Native-First notification system
+
+self.addEventListener('push', (event) => {
+  // DEPRECATED: Web-push only
+  const data = event.data ? event.data.json() : {};
+
+  const options = {
+    body: data.body,
+    icon: '/icon-192x192.png',
+    badge: '/badge-72x72.png',
+    data: data
+  };
+
+  event.waitUntil(
+    self.registration.showNotification(data.title, options)
+  );
+});
+```
+
+### 3. Configuration Cleanup
+
+#### VitePWA Plugin Configuration
+
+```javascript
+// DEPRECATED: VitePWA plugin configuration
+// This configuration is kept for reference but not used in production
+// Replaced by Native-First notification system
+
+import { VitePWA } from 'vite-plugin-pwa'
+
+export default defineConfig({
+  plugins: [
+    VitePWA({
+      // DEPRECATED: Web-push only
+      registerType: 'autoUpdate',
+      workbox: {
+        globPatterns: ['**/*.{js,css,html,ico,png,svg}']
+      },
+      includeAssets: ['favicon.ico', 'apple-touch-icon.png', 'masked-icon.svg'],
+      manifest: {
+        name: 'TimeSafari',
+        short_name: 'TimeSafari',
+        description: 'TimeSafari App',
+        theme_color: '#ffffff',
+        icons: [
+          {
+            src: 'pwa-192x192.png',
+            sizes: '192x192',
+            type: 'image/png'
+          }
+        ]
+      }
+    })
+  ]
+})
+```
+
+#### Service Worker Build Configuration
+
+```javascript
+// DEPRECATED: Service worker build configuration
+// This configuration is kept for reference but not used in production
+// Replaced by Native-First notification system
+
+export default defineConfig({
+  build: {
+    rollupOptions: {
+      input: {
+        // DEPRECATED: Web-push only
+        sw: 'sw_scripts/notification-click.js'
+      }
+    }
+  }
+})
+```
+
+### 4. Test Cleanup
+
+#### Web Push Tests
+
+```javascript
+// DEPRECATED: Web push tests
+// These tests are kept for reference but not used in production
+// Replaced by Native-First notification system
+
+describe('Web Push Notifications (DEPRECATED)', () => {
+  // DEPRECATED: Web-push only
+  it('should handle push notifications', async () => {
+    // Test implementation kept for reference
+  });
+
+  // DEPRECATED: Web-push only
+  it('should handle notification clicks', async () => {
+    // Test implementation kept for reference
+  });
+});
+```
+
+#### Service Worker Tests
+
+```javascript
+// DEPRECATED: Service worker tests
+// These tests are kept for reference but not used in production
+// Replaced by Native-First notification system
+
+describe('Service Worker (DEPRECATED)', () => {
+  // DEPRECATED: Web-push only
+  it('should register service worker', async () => {
+    // Test implementation kept for reference
+  });
+
+  // DEPRECATED: Web-push only
+  it('should handle push events', async () => {
+    // Test implementation kept for reference
+  });
+});
+```
+
+### 5. Documentation Cleanup
+
+#### README Updates
+
+```markdown
+# TimeSafari Native-First Notification System
+
+## Web-Push Status: DEPRECATED
+
+Web-push has been retired for unreliability. The system now focuses on native mobile reliability with Electron best-effort support.
+
+### Deprecated Features
+- ❌ Web push notifications
+- ❌ Service worker notification handling
+- ❌ Web notification API
+
+### Active Features
+- ✅ Native mobile notifications (Android/iOS)
+- ✅ Electron notifications (best-effort)
+- ✅ OS-scheduled background prefetch
+- ✅ Rolling window safety
+```
+
+#### API Documentation Updates
+
+```markdown
+## Notification API (Native-First)
+
+### Deprecated Methods
+- `subscribeToPush()` - DEPRECATED: Web-push only
+- `unsubscribeFromPush()` - DEPRECATED: Web-push only
+- `handlePushMessage()` - DEPRECATED: Web-push only
+
+### Active Methods
+- `scheduleExact()` - Native exact scheduling
+- `scheduleWindow()` - Native windowed scheduling
+- `schedulePrefetch()` - Native background prefetch
+```
+
+---
+
+## File-by-File Cleanup Checklist
+
+### Service Worker Files
+
+- [ ] `sw_scripts/notification-click.js` - Mark as deprecated
+- [ ] `sw_scripts/` directory - Review for web-push dependencies
+- [ ] Service worker build configuration - Remove or quarantine
+
+### Web-Specific Code
+
+- [ ] `src/main.web.ts` - Remove service worker registration
+- [ ] `src/services/webPush.ts` - Mark as deprecated
+- [ ] `src/utils/serviceWorker.ts` - Mark as deprecated
+- [ ] Web notification API usage - Remove or quarantine
+
+### Configuration Files
+
+- [ ] `vite.config.web.mts` - Remove VitePWA plugin
+- [ ] `package.json` - Remove web-push dependencies
+- [ ] `public/manifest.json` - Mark as deprecated
+- [ ] Service worker build scripts - Remove or quarantine
+
+### Test Files
+
+- [ ] `test-playwright/web-push.spec.ts` - Mark as deprecated
+- [ ] `test/services/webPush.test.ts` - Mark as deprecated
+- [ ] Service worker tests - Mark as deprecated
+
+### Documentation Files
+
+- [ ] `README.md` - Update to reflect native-first approach
+- [ ] `doc/web-push.md` - Mark as deprecated
+- [ ] API documentation - Remove web-push references
+
+---
+
+## Dependencies to Remove
+
+### NPM Packages
+
+```json
+{
+  "dependencies": {
+    // DEPRECATED: Web-push only
+    "web-push": "^7.4.0",
+    "vite-plugin-pwa": "^0.17.0"
+  },
+  "devDependencies": {
+    // DEPRECATED: Web-push only
+    "workbox-webpack-plugin": "^6.5.0"
+  }
+}
+```
+
+### Build Scripts
+
+```json
+{
+  "scripts": {
+    // DEPRECATED: Web-push only
+    "build:sw": "workbox generateSW",
+    "test:sw": "jest --testPathPattern=serviceWorker"
+  }
+}
+```
+
+---
+
+## Migration Guide
+
+### From Web-Push to Native-First
+
+#### Step 1: Remove Web-Push Dependencies
+
+```bash
+# Remove web-push packages
+npm uninstall web-push vite-plugin-pwa workbox-webpack-plugin
+
+# Remove service worker files
+rm -rf sw_scripts/
+rm -f public/sw.js
+rm -f public/workbox-*.js
+```
+
+#### Step 2: Update Configuration
+
+```javascript
+// Remove VitePWA plugin from vite.config.web.mts
+export default defineConfig({
+  plugins: [
+    // Remove VitePWA plugin
+    // VitePWA({ ... })
+  ]
+})
+```
+
+#### Step 3: Update Service Registration
+
+```javascript
+// Remove service worker registration from main.web.ts
+// if ('serviceWorker' in navigator) {
+//   navigator.serviceWorker.register('/sw.js')
+// }
+```
+
+#### Step 4: Update Tests
+
+```javascript
+// Remove web-push tests
+// describe('Web Push Notifications', () => { ... })
+```
+
+---
+
+## Verification Checklist
+
+### Code Removal Verification
+
+- [ ] No web-push imports remain
+- [ ] No service worker registration code
+- [ ] No push subscription management
+- [ ] No web notification API usage
+- [ ] No VitePWA plugin configuration
+
+### Documentation Verification
+
+- [ ] All web-push references marked as deprecated
+- [ ] README updated to reflect native-first approach
+- [ ] API documentation updated
+- [ ] Test documentation updated
+
+### Build Verification
+
+- [ ] Web build succeeds without service worker
+- [ ] No service worker files generated
+- [ ] No web-push dependencies in bundle
+- [ ] Native builds work correctly
+
+### Test Verification
+
+- [ ] Web-push tests are marked as deprecated
+- [ ] Native notification tests pass
+- [ ] No web-push test failures
+- [ ] Test suite runs successfully
+
+---
+
+## Rollback Plan
+
+### Emergency Rollback
+
+If native-first implementation fails, web-push code can be restored:
+
+#### 1. **Restore Dependencies**
+
+```bash
+npm install web-push vite-plugin-pwa workbox-webpack-plugin
+```
+
+#### 2. **Restore Service Worker Files**
+
+```bash
+git checkout HEAD~1 -- sw_scripts/
+git checkout HEAD~1 -- public/sw.js
+```
+
+#### 3. **Restore Configuration**
+
+```bash
+git checkout HEAD~1 -- vite.config.web.mts
+git checkout HEAD~1 -- package.json
+```
+
+#### 4. **Restore Tests**
+
+```bash
+git checkout HEAD~1 -- test-playwright/web-push.spec.ts
+git checkout HEAD~1 -- test/services/webPush.test.ts
+```
+
+### Rollback Verification
+
+- [ ] Web-push functionality restored
+- [ ] Service worker registration works
+- [ ] Push notifications work
+- [ ] Tests pass
+
+---
+
+## Post-Cleanup Tasks
+
+### Code Review
+
+- [ ] Review all changes for completeness
+- [ ] Verify no web-push code remains
+- [ ] Check for orphaned references
+- [ ] Validate native-first implementation
+
+### Testing
+
+- [ ] Run full test suite
+- [ ] Verify native notifications work
+- [ ] Check Electron functionality
+- [ ] Validate mobile builds
+
+### Documentation
+
+- [ ] Update all documentation
+- [ ] Remove web-push references
+- [ ] Update API documentation
+- [ ] Update user guides
+
+---
+
+## Success Criteria
+
+### Complete Web-Push Removal
+
+- [ ] All web-push code marked as deprecated
+- [ ] Service worker files quarantined
+- [ ] Dependencies removed
+- [ ] Configuration updated
+
+### Native-First Implementation
+
+- [ ] Native notifications work on Android
+- [ ] Native notifications work on iOS
+- [ ] Electron notifications work
+- [ ] Background prefetch works
+
+### Documentation Updated
+
+- [ ] All docs reflect native-first approach
+- [ ] Web-push marked as deprecated
+- [ ] Migration guide provided
+- [ ] Rollback plan documented
+
+---
+
+_This cleanup guide provides comprehensive instructions for removing web-push
+code paths from TimeSafari. Web-push has been retired for unreliability, and the
+system now focuses on native mobile reliability with Electron best-effort support._

doc/z-index-guide.md

@@ -5,12 +5,15 @@
 **Status**: 🎯 **ACTIVE** - Z-index layering standards
 
 ## Objective
+
 Establish consistent z-index values across the TimeSafari application to ensure proper layering of UI elements.
 
 ## Result
+
 This document defines the z-index hierarchy for all UI components.
 
 ## Use/Run
+
 Reference these values when implementing new components or modifying existing ones to maintain consistent layering.
 
 ## Z-Index Hierarchy
@@ -51,7 +54,7 @@ Reference these values when implementing new components or modifying existing on
 ## Collaboration Hooks
 
 - **Reviewers**: Frontend team, UI/UX designers
-- **Sign-off checklist**: 
+- **Sign-off checklist**:
   - [ ] All new components follow z-index guidelines
   - [ ] Existing components updated to use defined values
   - [ ] Cross-browser testing completed

ios/App/App.xcodeproj/project.pbxproj

@@ -403,7 +403,7 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 41;
+				CURRENT_PROJECT_VERSION = 40;
 				DEVELOPMENT_TEAM = GM3FS5JQPH;
 				ENABLE_APP_SANDBOX = NO;
 				ENABLE_USER_SCRIPT_SANDBOXING = NO;
@@ -413,7 +413,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.0.8;
+				MARKETING_VERSION = 1.0.7;
 				OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";
 				PRODUCT_BUNDLE_IDENTIFIER = app.timesafari;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -430,7 +430,7 @@
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 41;
+				CURRENT_PROJECT_VERSION = 40;
 				DEVELOPMENT_TEAM = GM3FS5JQPH;
 				ENABLE_APP_SANDBOX = NO;
 				ENABLE_USER_SCRIPT_SANDBOXING = NO;
@@ -440,7 +440,7 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.0.8;
+				MARKETING_VERSION = 1.0.7;
 				PRODUCT_BUNDLE_IDENTIFIER = app.timesafari;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";

package.json

@@ -136,7 +136,6 @@
     "*.{js,ts,vue,css,json,yml,yaml}": "eslint --fix || true",
     "*.{md,markdown,mdc}": "markdownlint-cli2 --fix"
   },
-
   "dependencies": {
     "@capacitor-community/electron": "^5.0.1",
     "@capacitor-community/sqlite": "6.0.2",

playwright.config-local.ts

@@ -21,7 +21,7 @@ export default defineConfig({
   /* Retry on CI only */
   retries: process.env.CI ? 2 : 0,
   /* Opt out of parallel tests on CI. */
-  workers: 4,
+  workers: 1,
   /* Reporter to use. See https://playwright.dev/docs/test-reporters */
   reporter: [
     ['list'],

public/manifest.webmanifest

@@ -1,46 +0,0 @@
-{
-  "icons": [
-    {
-      "src": "../icons/icon-48.webp",
-      "type": "image/png",
-      "sizes": "48x48",
-      "purpose": "any maskable"
-    },
-    {
-      "src": "../icons/icon-72.webp",
-      "type": "image/png",
-      "sizes": "72x72",
-      "purpose": "any maskable"
-    },
-    {
-      "src": "../icons/icon-96.webp",
-      "type": "image/png",
-      "sizes": "96x96",
-      "purpose": "any maskable"
-    },
-    {
-      "src": "../icons/icon-128.webp",
-      "type": "image/png",
-      "sizes": "128x128",
-      "purpose": "any maskable"
-    },
-    {
-      "src": "../icons/icon-192.webp",
-      "type": "image/png",
-      "sizes": "192x192",
-      "purpose": "any maskable"
-    },
-    {
-      "src": "../icons/icon-256.webp",
-      "type": "image/png",
-      "sizes": "256x256",
-      "purpose": "any maskable"
-    },
-    {
-      "src": "../icons/icon-512.webp",
-      "type": "image/png",
-      "sizes": "512x512",
-      "purpose": "any maskable"
-    }
-  ]
-}

scripts/avd-resource-checker.sh

@@ -1,389 +0,0 @@
-#!/bin/bash
-# avd-resource-checker.sh
-# Author: Matthew Raymer
-# Date: 2025-01-27
-# Description: Check system resources and recommend optimal AVD configuration
-
-set -e
-
-# Source common utilities
-source "$(dirname "$0")/common.sh"
-
-# Colors for output
-RED_COLOR='\033[0;31m'
-GREEN_COLOR='\033[0;32m'
-YELLOW_COLOR='\033[1;33m'
-BLUE_COLOR='\033[0;34m'
-NC_COLOR='\033[0m' # No Color
-
-# Function to print colored output
-print_status() {
-    local color=$1
-    local message=$2
-    echo -e "${color}${message}${NC_COLOR}"
-}
-
-# Function to get system memory in MB
-get_system_memory() {
-    if command -v free >/dev/null 2>&1; then
-        free -m | awk 'NR==2{print $2}'
-    else
-        echo "0"
-    fi
-}
-
-# Function to get available memory in MB
-get_available_memory() {
-    if command -v free >/dev/null 2>&1; then
-        free -m | awk 'NR==2{print $7}'
-    else
-        echo "0"
-    fi
-}
-
-# Function to get CPU core count
-get_cpu_cores() {
-    if command -v nproc >/dev/null 2>&1; then
-        nproc
-    elif [ -f /proc/cpuinfo ]; then
-        grep -c ^processor /proc/cpuinfo
-    else
-        echo "1"
-    fi
-}
-
-# Function to check GPU capabilities
-check_gpu_capabilities() {
-    local gpu_type="unknown"
-    local gpu_memory="0"
-    
-    # Check for NVIDIA GPU
-    if command -v nvidia-smi >/dev/null 2>&1; then
-        gpu_type="nvidia"
-        gpu_memory=$(nvidia-smi --query-gpu=memory.total --format=csv,noheader,nounits 2>/dev/null | head -1 || echo "0")
-        print_status $GREEN_COLOR "✓ NVIDIA GPU detected (${gpu_memory}MB VRAM)"
-        return 0
-    fi
-    
-    # Check for AMD GPU
-    if command -v rocm-smi >/dev/null 2>&1; then
-        gpu_type="amd"
-        print_status $GREEN_COLOR "✓ AMD GPU detected"
-        return 0
-    fi
-    
-    # Check for Intel GPU
-    if lspci 2>/dev/null | grep -i "vga.*intel" >/dev/null; then
-        gpu_type="intel"
-        print_status $YELLOW_COLOR "✓ Intel integrated GPU detected"
-        return 1
-    fi
-    
-    # Check for generic GPU
-    if lspci 2>/dev/null | grep -i "vga" >/dev/null; then
-        gpu_type="generic"
-        print_status $YELLOW_COLOR "✓ Generic GPU detected"
-        return 1
-    fi
-    
-    print_status $RED_COLOR "✗ No GPU detected"
-    return 2
-}
-
-# Function to check if hardware acceleration is available
-check_hardware_acceleration() {
-    local gpu_capable=$1
-    
-    if [ $gpu_capable -eq 0 ]; then
-        print_status $GREEN_COLOR "✓ Hardware acceleration recommended"
-        return 0
-    elif [ $gpu_capable -eq 1 ]; then
-        print_status $YELLOW_COLOR "⚠ Limited hardware acceleration"
-        return 1
-    else
-        print_status $RED_COLOR "✗ No hardware acceleration available"
-        return 2
-    fi
-}
-
-# Function to recommend AVD configuration
-recommend_avd_config() {
-    local total_memory=$1
-    local available_memory=$2
-    local cpu_cores=$3
-    local gpu_capable=$4
-    
-    print_status $BLUE_COLOR "\n=== AVD Configuration Recommendation ==="
-    
-    # Calculate recommended memory (leave 2GB for system)
-    local system_reserve=2048
-    local recommended_memory=$((available_memory - system_reserve))
-    
-    # Cap memory at reasonable limits
-    if [ $recommended_memory -gt 4096 ]; then
-        recommended_memory=4096
-    elif [ $recommended_memory -lt 1024 ]; then
-        recommended_memory=1024
-    fi
-    
-    # Calculate recommended cores (leave 2 cores for system)
-    local recommended_cores=$((cpu_cores - 2))
-    if [ $recommended_cores -lt 1 ]; then
-        recommended_cores=1
-    elif [ $recommended_cores -gt 4 ]; then
-        recommended_cores=4
-    fi
-    
-    # Determine GPU setting
-    local gpu_setting=""
-    case $gpu_capable in
-        0) gpu_setting="-gpu host" ;;
-        1) gpu_setting="-gpu swiftshader_indirect" ;;
-        2) gpu_setting="-gpu swiftshader_indirect" ;;
-    esac
-    
-    # Generate recommendation
-    print_status $GREEN_COLOR "Recommended AVD Configuration:"
-    echo "  Memory: ${recommended_memory}MB"
-    echo "  Cores: ${recommended_cores}"
-    echo "  GPU: ${gpu_setting}"
-    
-    # Get AVD name from function parameter (passed from main)
-    local avd_name=$5
-    local command="emulator -avd ${avd_name} -no-audio -memory ${recommended_memory} -cores ${recommended_cores} ${gpu_setting} &"
-    
-    print_status $BLUE_COLOR "\nGenerated Command:"
-    echo "  ${command}"
-    
-    # Save to file for easy execution
-    local script_file="/tmp/start-avd-${avd_name}.sh"
-    cat > "$script_file" << EOF
-#!/bin/bash
-# Auto-generated AVD startup script
-# Generated by avd-resource-checker.sh on $(date)
-
-echo "Starting AVD: ${avd_name}"
-echo "Memory: ${recommended_memory}MB"
-echo "Cores: ${recommended_cores}"
-echo "GPU: ${gpu_setting}"
-
-${command}
-
-echo "AVD started in background"
-echo "Check status with: adb devices"
-echo "View logs with: adb logcat"
-EOF
-    
-    chmod +x "$script_file"
-    print_status $GREEN_COLOR "\n✓ Startup script saved to: ${script_file}"
-    
-    return 0
-}
-
-# Function to test AVD startup
-test_avd_startup() {
-    local avd_name=$1
-    local test_duration=${2:-30}
-    
-    print_status $BLUE_COLOR "\n=== Testing AVD Startup ==="
-    
-    # Check if AVD exists
-    if ! avdmanager list avd | grep -q "$avd_name"; then
-        print_status $RED_COLOR "✗ AVD '$avd_name' not found"
-        return 1
-    fi
-    
-    print_status $YELLOW_COLOR "Testing AVD startup for ${test_duration} seconds..."
-    
-    # Start emulator in test mode
-    emulator -avd "$avd_name" -no-audio -no-window -no-snapshot -memory 1024 -cores 1 -gpu swiftshader_indirect &
-    local emulator_pid=$!
-    
-    # Wait for boot
-    local boot_time=0
-    local max_wait=$test_duration
-    
-    while [ $boot_time -lt $max_wait ]; do
-        if adb devices | grep -q "emulator.*device"; then
-            print_status $GREEN_COLOR "✓ AVD booted successfully in ${boot_time} seconds"
-            break
-        fi
-        sleep 2
-        boot_time=$((boot_time + 2))
-    done
-    
-    # Cleanup
-    kill $emulator_pid 2>/dev/null || true
-    adb emu kill 2>/dev/null || true
-    
-    if [ $boot_time -ge $max_wait ]; then
-        print_status $RED_COLOR "✗ AVD failed to boot within ${test_duration} seconds"
-        return 1
-    fi
-    
-    return 0
-}
-
-# Function to list available AVDs
-list_available_avds() {
-    print_status $BLUE_COLOR "\n=== Available AVDs ==="
-    
-    if ! command -v avdmanager >/dev/null 2>&1; then
-        print_status $RED_COLOR "✗ avdmanager not found. Please install Android SDK command line tools."
-        return 1
-    fi
-    
-    local avd_list=$(avdmanager list avd 2>/dev/null)
-    if [ -z "$avd_list" ]; then
-        print_status $YELLOW_COLOR "⚠ No AVDs found. Create one with:"
-        echo "  avdmanager create avd --name TimeSafari_Emulator --package system-images;android-34;google_apis;x86_64"
-        return 1
-    fi
-    
-    echo "$avd_list"
-    return 0
-}
-
-# Function to create optimized AVD
-create_optimized_avd() {
-    local avd_name=$1
-    local memory=$2
-    local cores=$3
-    
-    print_status $BLUE_COLOR "\n=== Creating Optimized AVD ==="
-    
-    # Check if system image is available
-    local system_image="system-images;android-34;google_apis;x86_64"
-    if ! sdkmanager --list | grep -q "$system_image"; then
-        print_status $YELLOW_COLOR "Installing system image: $system_image"
-        sdkmanager "$system_image"
-    fi
-    
-    # Create AVD
-    print_status $YELLOW_COLOR "Creating AVD: $avd_name"
-    avdmanager create avd \
-        --name "$avd_name" \
-        --package "$system_image" \
-        --device "pixel_7" \
-        --force
-    
-    # Configure AVD
-    local avd_config_file="$HOME/.android/avd/${avd_name}.avd/config.ini"
-    if [ -f "$avd_config_file" ]; then
-        print_status $YELLOW_COLOR "Configuring AVD settings..."
-        
-        # Set memory
-        sed -i "s/vm.heapSize=.*/vm.heapSize=${memory}/" "$avd_config_file"
-        
-        # Set cores
-        sed -i "s/hw.cpu.ncore=.*/hw.cpu.ncore=${cores}/" "$avd_config_file"
-        
-        # Disable unnecessary features
-        echo "hw.audioInput=no" >> "$avd_config_file"
-        echo "hw.audioOutput=no" >> "$avd_config_file"
-        echo "hw.camera.back=none" >> "$avd_config_file"
-        echo "hw.camera.front=none" >> "$avd_config_file"
-        echo "hw.gps=no" >> "$avd_config_file"
-        echo "hw.sensors.orientation=no" >> "$avd_config_file"
-        echo "hw.sensors.proximity=no" >> "$avd_config_file"
-        
-        print_status $GREEN_COLOR "✓ AVD configured successfully"
-    fi
-    
-    return 0
-}
-
-# Main function
-main() {
-    print_status $BLUE_COLOR "=== TimeSafari AVD Resource Checker ==="
-    print_status $BLUE_COLOR "Checking system resources and recommending optimal AVD configuration\n"
-    
-    # Get system information
-    local total_memory=$(get_system_memory)
-    local available_memory=$(get_available_memory)
-    local cpu_cores=$(get_cpu_cores)
-    
-    print_status $BLUE_COLOR "=== System Information ==="
-    echo "Total Memory: ${total_memory}MB"
-    echo "Available Memory: ${available_memory}MB"
-    echo "CPU Cores: ${cpu_cores}"
-    
-    # Check GPU capabilities
-    print_status $BLUE_COLOR "\n=== GPU Analysis ==="
-    check_gpu_capabilities
-    local gpu_capable=$?
-    
-    # Check hardware acceleration
-    check_hardware_acceleration $gpu_capable
-    local hw_accel=$?
-    
-    # List available AVDs
-    list_available_avds
-    
-    # Get AVD name from user or use default
-    local avd_name="TimeSafari_Emulator"
-    if [ $# -gt 0 ]; then
-        avd_name="$1"
-    fi
-    
-    # Recommend configuration
-    recommend_avd_config $total_memory $available_memory $cpu_cores $gpu_capable "$avd_name"
-    
-    # Test AVD if requested
-    if [ "$2" = "--test" ]; then
-        test_avd_startup "$avd_name"
-    fi
-    
-    # Create optimized AVD if requested
-    if [ "$2" = "--create" ]; then
-        local recommended_memory=$((available_memory - 2048))
-        if [ $recommended_memory -gt 4096 ]; then
-            recommended_memory=4096
-        elif [ $recommended_memory -lt 1024 ]; then
-            recommended_memory=1024
-        fi
-        
-        local recommended_cores=$((cpu_cores - 2))
-        if [ $recommended_cores -lt 1 ]; then
-            recommended_cores=1
-        elif [ $recommended_cores -gt 4 ]; then
-            recommended_cores=4
-        fi
-        
-        create_optimized_avd "$avd_name" $recommended_memory $recommended_cores
-    fi
-    
-    print_status $GREEN_COLOR "\n=== Resource Check Complete ==="
-    print_status $YELLOW_COLOR "Tip: Use the generated startup script for consistent AVD launches"
-}
-
-# Show help
-show_help() {
-    echo "Usage: $0 [AVD_NAME] [OPTIONS]"
-    echo ""
-    echo "Options:"
-    echo "  --test     Test AVD startup (30 second test)"
-    echo "  --create   Create optimized AVD with recommended settings"
-    echo "  --help     Show this help message"
-    echo ""
-    echo "Examples:"
-    echo "  $0                                    # Check resources and recommend config"
-    echo "  $0 TimeSafari_Emulator               # Check resources for specific AVD"
-    echo "  $0 TimeSafari_Emulator --test         # Test AVD startup"
-    echo "  $0 TimeSafari_Emulator --create       # Create optimized AVD"
-    echo ""
-    echo "The script will:"
-    echo "  - Analyze system resources (RAM, CPU, GPU)"
-    echo "  - Recommend optimal AVD configuration"
-    echo "  - Generate startup command and script"
-    echo "  - Optionally test or create AVD"
-}
-
-# Parse command line arguments
-if [ "$1" = "--help" ] || [ "$1" = "-h" ]; then
-    show_help
-    exit 0
-fi
-
-# Run main function
-main "$@"

src/App.vue

@@ -386,7 +386,7 @@ export default class App extends Vue {
     let allGoingOff = false;
 
     try {
-      const settings: Settings = await this.$accountSettings();
+      const settings: Settings = await this.$settings();
 
       const notifyingNewActivity = !!settings?.notifyingNewActivityTime;
       const notifyingReminder = !!settings?.notifyingReminderTime;

src/components/DataExportSection.vue

@@ -16,12 +16,6 @@ messages * - Conditional UI based on platform capabilities * * @component *
       :to="{ name: 'seed-backup' }"
       :class="backupButtonClasses"
     >
-      <!-- Notification dot - show while the user has not yet backed up their seed phrase -->
-      <font-awesome
-        v-if="!hasBackedUpSeed"
-        icon="circle"
-        class="absolute -right-[8px] -top-[8px] text-rose-500 text-[14px] border border-white rounded-full"
-      ></font-awesome>
       Backup Identifier Seed
     </router-link>
 
@@ -104,12 +98,6 @@ export default class DataExportSection extends Vue {
    */
   isExporting = false;
 
-  /**
-   * Flag indicating if the user has backed up their seed phrase
-   * Used to control the visibility of the notification dot
-   */
-  hasBackedUpSeed = false;
-
   /**
    * Notification helper for consistent notification patterns
    * Created as a getter to ensure $notify is available when called
@@ -141,7 +129,7 @@ export default class DataExportSection extends Vue {
    * CSS classes for the backup button (router link)
    */
   get backupButtonClasses(): string {
-    return "block relative w-full text-center text-md bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] text-white px-1.5 py-2 rounded-md mb-2 mt-2";
+    return "block w-full text-center text-md bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] text-white px-1.5 py-2 rounded-md mb-2 mt-2";
   }
 
   /**
@@ -230,22 +218,6 @@ export default class DataExportSection extends Vue {
 
   created() {
     this.notify = createNotifyHelpers(this.$notify);
-    this.loadSeedBackupStatus();
-  }
-
-  /**
-   * Loads the seed backup status from account settings
-   * Updates the hasBackedUpSeed flag to control notification dot visibility
-   */
-  private async loadSeedBackupStatus(): Promise<void> {
-    try {
-      const settings = await this.$accountSettings();
-      this.hasBackedUpSeed = !!settings.hasBackedUpSeed;
-    } catch (err: unknown) {
-      logger.error("Failed to load seed backup status:", err);
-      // Default to false (show notification dot) if we can't load the setting
-      this.hasBackedUpSeed = false;
-    }
   }
 }
 </script>

src/components/GiftedDialog.vue

@@ -82,7 +82,6 @@ import GiftDetailsStep from "../components/GiftDetailsStep.vue";
 import { PlanData } from "../interfaces/records";
 import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
 import { createNotifyHelpers, TIMEOUTS, NotifyFunction } from "@/utils/notify";
-import { showSeedPhraseReminder } from "@/utils/seedPhraseReminder";
 import {
   NOTIFY_GIFT_ERROR_NEGATIVE_AMOUNT,
   NOTIFY_GIFT_ERROR_NO_DESCRIPTION,
@@ -220,18 +219,9 @@ export default class GiftedDialog extends Vue {
     this.stepType = "giver";
 
     try {
-      const settings = await this.$accountSettings();
+      const settings = await this.$settings();
       this.apiServer = settings.apiServer || "";
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-
-      logger.debug("[GiftedDialog] Settings received:", {
-        activeDid: this.activeDid,
-        apiServer: this.apiServer,
-      });
+      this.activeDid = settings.activeDid || "";
 
       this.allContacts = await this.$contacts();
 
@@ -421,15 +411,6 @@ export default class GiftedDialog extends Vue {
         );
       } else {
         this.safeNotify.success("That gift was recorded.", TIMEOUTS.VERY_LONG);
-
-        // Show seed phrase backup reminder if needed
-        try {
-          const settings = await this.$accountSettings();
-          showSeedPhraseReminder(!!settings.hasBackedUpSeed, this.$notify);
-        } catch (error) {
-          logger.error("Error checking seed backup status:", error);
-        }
-
         if (this.callbackOnSuccess) {
           this.callbackOnSuccess(amount);
         }

src/components/HiddenDidDialog.vue

@@ -74,7 +74,7 @@
             If you'd like an introduction,
             <a
               class="text-blue-500"
-              @click="copyTextToClipboard('A link to this page', deepLinkUrl)"
+              @click="copyToClipboard('A link to this page', deepLinkUrl)"
               >click here to copy this page, paste it into a message, and ask if
               they'll tell you more about the {{ roleName }}.</a
             >
@@ -110,7 +110,7 @@
  * @since 2024-12-19
  */
 import { Component, Vue } from "vue-facing-decorator";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 import * as R from "ramda";
 import * as serverUtil from "../libs/endorserServer";
 import { Contact } from "../db/tables/contacts";
@@ -197,24 +197,19 @@ export default class HiddenDidDialog extends Vue {
     );
   }
 
-  async copyTextToClipboard(name: string, text: string) {
-    try {
-      await copyToClipboard(text);
-      this.notify.success(
-        NOTIFY_COPIED_TO_CLIPBOARD.message(name || "That"),
-        TIMEOUTS.SHORT,
-      );
-    } catch (error) {
-      this.$logAndConsole(
-        `Error copying ${name || "content"} to clipboard: ${error}`,
-        true,
-      );
-      this.notify.error(`Failed to copy ${name || "content"} to clipboard.`);
-    }
+  copyToClipboard(name: string, text: string) {
+    useClipboard()
+      .copy(text)
+      .then(() => {
+        this.notify.success(
+          NOTIFY_COPIED_TO_CLIPBOARD.message(name || "That"),
+          TIMEOUTS.SHORT,
+        );
+      });
   }
 
   onClickShareClaim() {
-    this.copyTextToClipboard("A link to this page", this.deepLinkUrl);
+    this.copyToClipboard("A link to this page", this.deepLinkUrl);
     window.navigator.share({
       title: "Help Connect Me",
       text: "I'm trying to find the people who recorded this. Can you help me?",

src/components/ImageMethodDialog.vue

@@ -132,7 +132,7 @@
                   v-if="shouldMirrorVideo"
                   class="absolute top-2 left-2 bg-black/50 text-white px-2 py-1 rounded text-xs"
                 >
-                  <font-awesome icon="circle-user" class="w-[1em] mr-1" />
+                  <font-awesome icon="mirror" class="w-[1em] mr-1" />
                   Mirrored
                 </div>
                 <div :class="cameraControlsClasses">
@@ -499,10 +499,8 @@ export default class ImageMethodDialog extends Vue {
    */
   async mounted() {
     try {
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
+      const settings = await this.$accountSettings();
+      this.activeDid = settings.activeDid || "";
     } catch (error) {
       logger.error("Error retrieving settings from database:", error);
       this.notify.error(

src/components/MembersList.vue

@@ -232,12 +232,7 @@ export default class MembersList extends Vue {
     this.notify = createNotifyHelpers(this.$notify);
 
     const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
     this.firstName = settings.firstName || "";
     await this.fetchMembers();

src/components/OfferDialog.vue

@@ -64,7 +64,6 @@ import * as libsUtil from "../libs/util";
 import { logger } from "../utils/logger";
 import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
 import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
-import { showSeedPhraseReminder } from "@/utils/seedPhraseReminder";
 import {
   NOTIFY_OFFER_SETTINGS_ERROR,
   NOTIFY_OFFER_RECORDING,
@@ -176,11 +175,7 @@ export default class OfferDialog extends Vue {
 
       const settings = await this.$accountSettings();
       this.apiServer = settings.apiServer || "";
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
+      this.activeDid = settings.activeDid || "";
 
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
     } catch (err: any) {
@@ -304,14 +299,6 @@ export default class OfferDialog extends Vue {
         );
       } else {
         this.notify.success(NOTIFY_OFFER_SUCCESS.message, TIMEOUTS.VERY_LONG);
-
-        // Show seed phrase backup reminder if needed
-        try {
-          const settings = await this.$accountSettings();
-          showSeedPhraseReminder(!!settings.hasBackedUpSeed, this.$notify);
-        } catch (error) {
-          logger.error("Error checking seed backup status:", error);
-        }
       }
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
     } catch (error: any) {

src/components/OnboardingDialog.vue

@@ -270,12 +270,7 @@ export default class OnboardingDialog extends Vue {
   async open(page: OnboardPage) {
     this.page = page;
     const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.isRegistered = !!settings.isRegistered;
 
     const contacts = await this.$getAllContacts();

src/components/PhotoDialog.vue

@@ -268,12 +268,7 @@ export default class PhotoDialog extends Vue {
     // logger.log("PhotoDialog mounted");
     try {
       const settings = await this.$accountSettings();
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-
+      this.activeDid = settings.activeDid || "";
       this.isRegistered = !!settings.isRegistered;
       logger.log("isRegistered:", this.isRegistered);
     } catch (error: unknown) {

src/components/TopMessage.vue

@@ -49,11 +49,8 @@ export default class TopMessage extends Vue {
       logger.debug("[TopMessage] 📥 Loading settings without overrides...");
       const settings = await this.$accountSettings();
 
-      // Get activeDid from new active_identity table (ActiveDid migration)
-      const activeIdentity = await this.$getActiveIdentity();
-
       logger.debug("[TopMessage] 📊 Settings loaded:", {
-        activeDid: activeIdentity.activeDid,
+        activeDid: settings.activeDid,
         apiServer: settings.apiServer,
         warnIfTestServer: settings.warnIfTestServer,
         warnIfProdServer: settings.warnIfProdServer,
@@ -67,7 +64,7 @@ export default class TopMessage extends Vue {
         settings.apiServer &&
         settings.apiServer !== AppString.PROD_ENDORSER_API_SERVER
       ) {
-        const didPrefix = activeIdentity.activeDid?.slice(11, 15);
+        const didPrefix = settings.activeDid?.slice(11, 15);
         this.message = "You're not using prod, user " + didPrefix;
         logger.debug("[TopMessage] ⚠️ Test server warning displayed:", {
           apiServer: settings.apiServer,
@@ -78,7 +75,7 @@ export default class TopMessage extends Vue {
         settings.apiServer &&
         settings.apiServer === AppString.PROD_ENDORSER_API_SERVER
       ) {
-        const didPrefix = activeIdentity.activeDid?.slice(11, 15);
+        const didPrefix = settings.activeDid?.slice(11, 15);
         this.message = "You are using prod, user " + didPrefix;
         logger.debug("[TopMessage] ⚠️ Production server warning displayed:", {
           apiServer: settings.apiServer,

src/components/UserNameDialog.vue

@@ -84,6 +84,7 @@ export default class UserNameDialog extends Vue {
    */
   async open(aCallback?: (name?: string) => void) {
     this.callback = aCallback || this.callback;
+    // Load from account-specific settings instead of master settings
     const settings = await this.$accountSettings();
     this.givenName = settings.firstName || "";
     this.visible = true;
@@ -95,9 +96,9 @@ export default class UserNameDialog extends Vue {
    */
   async onClickSaveChanges() {
     try {
-      // Get activeDid from new active_identity table (ActiveDid migration)
-      const activeIdentity = await this.$getActiveIdentity();
-      const activeDid = activeIdentity.activeDid;
+      // Get the current active DID to save to user-specific settings
+      const settings = await this.$accountSettings();
+      const activeDid = settings.activeDid;
 
       if (activeDid) {
         // Save to user-specific settings for the current identity

src/db-sql/migration.ts

@@ -4,7 +4,6 @@ import {
 } from "../services/migrationService";
 import { DEFAULT_ENDORSER_API_SERVER } from "@/constants/app";
 import { arrayBufferToBase64 } from "@/libs/crypto";
-import { logger } from "@/utils/logger";
 
 // Generate a random secret for the secret table
 
@@ -29,53 +28,7 @@ import { logger } from "@/utils/logger";
 // where they couldn't take action because they couldn't unlock that identity.)
 
 const randomBytes = crypto.getRandomValues(new Uint8Array(32));
-const secretBase64 = arrayBufferToBase64(randomBytes.buffer);
-
-// Single source of truth for migration 004 SQL
-const MIG_004_SQL = `
-  -- Migration 004: active_identity_management (CONSOLIDATED)
-  -- Combines original migrations 004, 005, and 006 into single atomic operation
-  -- CRITICAL SECURITY: Uses ON DELETE RESTRICT constraint from the start
-  -- Assumes master code deployed with migration 003 (hasBackedUpSeed)
-  
-  -- Enable foreign key constraints for data integrity
-  PRAGMA foreign_keys = ON;
-  
-  -- Add UNIQUE constraint to accounts.did for foreign key support
-  CREATE UNIQUE INDEX IF NOT EXISTS idx_accounts_did_unique ON accounts(did);
-  
-  -- Create active_identity table with SECURE constraint (ON DELETE RESTRICT)
-  -- This prevents accidental account deletion - critical security feature
-  CREATE TABLE IF NOT EXISTS active_identity (
-    id INTEGER PRIMARY KEY CHECK (id = 1),
-    activeDid TEXT REFERENCES accounts(did) ON DELETE RESTRICT,
-    lastUpdated TEXT NOT NULL DEFAULT (datetime('now'))
-  );
-
-  -- Add performance indexes
-  CREATE UNIQUE INDEX IF NOT EXISTS idx_active_identity_single_record ON active_identity(id);
-
-  -- Seed singleton row (only if not already exists)
-  INSERT INTO active_identity (id, activeDid, lastUpdated) 
-  SELECT 1, NULL, datetime('now') 
-  WHERE NOT EXISTS (SELECT 1 FROM active_identity WHERE id = 1);
-  
-  -- MIGRATE EXISTING DATA: Copy activeDid from settings to active_identity
-  -- This prevents data loss when migration runs on existing databases
-  UPDATE active_identity 
-  SET activeDid = (SELECT activeDid FROM settings WHERE id = 1), 
-      lastUpdated = datetime('now')
-  WHERE id = 1 
-  AND EXISTS (SELECT 1 FROM settings WHERE id = 1 AND activeDid IS NOT NULL AND activeDid != '');
-  
-  -- CLEANUP: Remove orphaned settings records and clear legacy activeDid values
-  -- This completes the migration from settings-based to table-based active identity
-  -- Use guarded operations to prevent accidental data loss
-  DELETE FROM settings WHERE accountDid IS NULL AND id != 1;
-  UPDATE settings SET activeDid = NULL WHERE id = 1 AND EXISTS (
-    SELECT 1 FROM active_identity WHERE id = 1 AND activeDid IS NOT NULL
-  );
-`;
+const secretBase64 = arrayBufferToBase64(randomBytes);
 
 // Each migration can include multiple SQL statements (with semicolons)
 const MIGRATIONS = [
@@ -171,45 +124,8 @@ const MIGRATIONS = [
       ALTER TABLE contacts ADD COLUMN iViewContent BOOLEAN DEFAULT TRUE;
     `,
   },
-  {
-    name: "003_add_hasBackedUpSeed_to_settings",
-    sql: `
-      -- Add hasBackedUpSeed field to settings
-      -- This migration assumes master code has been deployed
-      -- The error handling will catch this if column already exists and mark migration as applied
-      ALTER TABLE settings ADD COLUMN hasBackedUpSeed BOOLEAN DEFAULT FALSE;
-    `,
-  },
-  {
-    name: "004_active_identity_management",
-    sql: MIG_004_SQL,
-  },
 ];
 
-/**
- * Extract single value from database query result
- * Works with different database service result formats
- */
-function extractSingleValue<T>(result: T): string | number | null {
-  if (!result) return null;
-
-  // Handle AbsurdSQL format: QueryExecResult[]
-  if (Array.isArray(result) && result.length > 0 && result[0]?.values) {
-    const values = result[0].values;
-    return values.length > 0 ? values[0][0] : null;
-  }
-
-  // Handle Capacitor SQLite format: { values: unknown[][] }
-  if (typeof result === "object" && result !== null && "values" in result) {
-    const values = (result as { values: unknown[][] }).values;
-    return values && values.length > 0
-      ? (values[0][0] as string | number)
-      : null;
-  }
-
-  return null;
-}
-
 /**
  * @param sqlExec - A function that executes a SQL statement and returns the result
  * @param extractMigrationNames - A function that extracts the names (string array) from "select name from migrations"
@@ -219,73 +135,8 @@ export async function runMigrations<T>(
   sqlQuery: (sql: string, params?: unknown[]) => Promise<T>,
   extractMigrationNames: (result: T) => Set<string>,
 ): Promise<void> {
-  // Only log migration start in development
-  const isDevelopment = process.env.VITE_PLATFORM === "development";
-  if (isDevelopment) {
-    logger.debug("[Migration] Starting database migrations");
-  }
-
   for (const migration of MIGRATIONS) {
-    if (isDevelopment) {
-      logger.debug("[Migration] Registering migration:", migration.name);
-    }
     registerMigration(migration);
   }
-
-  if (isDevelopment) {
-    logger.debug("[Migration] Running migration service");
-  }
   await runMigrationsService(sqlExec, sqlQuery, extractMigrationNames);
-
-  if (isDevelopment) {
-    logger.debug("[Migration] Database migrations completed");
-  }
-
-  // Bootstrapping: Ensure active account is selected after migrations
-  if (isDevelopment) {
-    logger.debug("[Migration] Running bootstrapping hooks");
-  }
-  try {
-    // Check if we have accounts but no active selection
-    const accountsResult = await sqlQuery("SELECT COUNT(*) FROM accounts");
-    const accountsCount = (extractSingleValue(accountsResult) as number) || 0;
-
-    // Check if active_identity table exists, and if not, try to recover
-    let activeDid: string | null = null;
-    try {
-      const activeResult = await sqlQuery(
-        "SELECT activeDid FROM active_identity WHERE id = 1",
-      );
-      activeDid = (extractSingleValue(activeResult) as string) || null;
-    } catch (error) {
-      // Table doesn't exist - migration 004 may not have run yet
-      if (isDevelopment) {
-        logger.debug(
-          "[Migration] active_identity table not found - migration may not have run",
-        );
-      }
-      activeDid = null;
-    }
-
-    if (accountsCount > 0 && (!activeDid || activeDid === "")) {
-      if (isDevelopment) {
-        logger.debug("[Migration] Auto-selecting first account as active");
-      }
-      const firstAccountResult = await sqlQuery(
-        "SELECT did FROM accounts ORDER BY dateCreated, did LIMIT 1",
-      );
-      const firstAccountDid =
-        (extractSingleValue(firstAccountResult) as string) || null;
-
-      if (firstAccountDid) {
-        await sqlExec(
-          "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
-          [firstAccountDid],
-        );
-        logger.info(`[Migration] Set active account to: ${firstAccountDid}`);
-      }
-    }
-  } catch (error) {
-    logger.warn("[Migration] Bootstrapping hook failed (non-critical):", error);
-  }
 }

src/db/databaseUtil.ts

@@ -567,8 +567,6 @@ export async function debugSettingsData(did?: string): Promise<void> {
  * - Web SQLite (wa-sqlite/absurd-sql): Auto-parses JSON strings to objects
  * - Capacitor SQLite: Returns raw strings that need manual parsing
  *
- * Maybe consolidate with PlatformServiceMixin._parseJsonField
- *
  * @param value The value to parse (could be string or already parsed object)
  * @param defaultValue Default value if parsing fails
  * @returns Parsed object or default value

src/db/tables/activeIdentity.ts

@@ -1,14 +0,0 @@
-/**
- * ActiveIdentity type describes the active identity selection.
- * This replaces the activeDid field in the settings table for better
- * database architecture and data integrity.
- *
- * @author Matthew Raymer
- * @since 2025-08-29
- */
-
-export interface ActiveIdentity {
-  id: number;
-  activeDid: string;
-  lastUpdated: string;
-}

src/db/tables/contacts.ts

@@ -9,8 +9,6 @@ export type Contact = {
   // When adding a property:
   // - Consider whether it should be added when exporting & sharing contacts, eg. DataExportSection
   // - If it's a boolean, it should be converted from a 0/1 integer in PlatformServiceMixin._mapColumnsToValues
-  // - If it's a JSON string, it should be converted to an object/array in PlatformServiceMixin._mapColumnsToValues
-  //
 
   did: string;
   contactMethods?: Array<ContactMethod>;

src/db/tables/settings.ts

@@ -14,12 +14,6 @@ export type BoundingBox = {
  * New entries that are boolean should also be added to PlatformServiceMixin._mapColumnsToValues
  */
 export type Settings = {
-  //
-  // When adding a property:
-  // - If it's a boolean, it should be converted from a 0/1 integer in PlatformServiceMixin._mapColumnsToValues
-  // - If it's a JSON string, it should be converted to an object/array in PlatformServiceMixin._mapColumnsToValues
-  //
-
   // default entry is keyed with MASTER_SETTINGS_KEY; other entries are linked to an account with account ID
   id?: string | number; // this is erased for all those entries that are keyed with accountDid
 
@@ -35,7 +29,6 @@ export type Settings = {
   finishedOnboarding?: boolean; // the user has completed the onboarding process
 
   firstName?: string; // user's full name, may be null if unwanted for a particular account
-  hasBackedUpSeed?: boolean; // tracks whether the user has backed up their seed phrase
   hideRegisterPromptOnNewContact?: boolean;
   isRegistered?: boolean;
   // imageServer?: string; // if we want to allow modification then we should make image functionality optional -- or at least customizable

src/libs/endorserServer.ts

@@ -16,7 +16,7 @@
  * @module endorserServer
  */
 
-import { Axios, AxiosRequestConfig, AxiosResponse } from "axios";
+import { Axios, AxiosRequestConfig } from "axios";
 import { Buffer } from "buffer";
 import { sha256 } from "ethereum-cryptography/sha256";
 import { LRUCache } from "lru-cache";
@@ -315,7 +315,7 @@ export function didInfoForContact(
     return { displayName: "You", known: true };
   } else if (contact) {
     return {
-      displayName: contact.name || "Contact Without a Name",
+      displayName: contact.name || "Contact With No Name",
       known: true,
       profileImageUrl: contact.profileImageUrl,
     };
@@ -1131,7 +1131,7 @@ export async function createAndSubmitClaim(
     // Enhanced diagnostic logging for claim submission
     const requestId = `claim_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
 
-    logger.debug("[Claim Submission] 🚀 Starting claim submission:", {
+    logger.info("[Claim Submission] 🚀 Starting claim submission:", {
       requestId,
       apiServer,
       requesterDid: issuerDid,
@@ -1157,7 +1157,7 @@ export async function createAndSubmitClaim(
       },
     });
 
-    logger.debug("[Claim Submission] ✅ Claim submitted successfully:", {
+    logger.info("[Claim Submission] ✅ Claim submitted successfully:", {
       requestId,
       status: response.status,
       handleId: response.data?.handleId,
@@ -1313,28 +1313,6 @@ export const capitalizeAndInsertSpacesBeforeCaps = (text: string) => {
     : text[0].toUpperCase() + text.substr(1).replace(/([A-Z])/g, " $1");
 };
 
-/**
- * Formats type string for display by adding spaces before capitals
- * and optionally adds an appropriate article prefix (a/an)
- *
- * @param text - Text to format
- * @returns Formatted string with article prefix
- */
-export const capitalizeAndInsertSpacesBeforeCapsWithAPrefix = (
-  text: string,
-): string => {
-  const word = capitalizeAndInsertSpacesBeforeCaps(text);
-  if (word) {
-    // if the word starts with a vowel, use "an" instead of "a"
-    const firstLetter = word[0].toLowerCase();
-    const vowels = ["a", "e", "i", "o", "u"];
-    const particle = vowels.includes(firstLetter) ? "an" : "a";
-    return particle + " " + word;
-  } else {
-    return "";
-  }
-};
-
 /**
  return readable summary of claim, or something generic
 
@@ -1754,7 +1732,7 @@ export async function fetchImageRateLimits(
   axios: Axios,
   issuerDid: string,
   imageServer?: string,
-): Promise<AxiosResponse | null> {
+) {
   const server = imageServer || DEFAULT_IMAGE_API_SERVER;
   const url = server + "/image-limits";
   const headers = await getHeaders(issuerDid);
@@ -1788,7 +1766,7 @@ export async function fetchImageRateLimits(
       };
     };
 
-    logger.error("[Image Server] Image rate limits check failed:", {
+    logger.warn("[Image Server] Image rate limits check failed:", {
       did: issuerDid,
       server: server,
       errorCode: axiosError.response?.data?.error?.code,
@@ -1796,6 +1774,7 @@ export async function fetchImageRateLimits(
       httpStatus: axiosError.response?.status,
       timestamp: new Date().toISOString(),
     });
-    return null;
+
+    throw error;
   }
 }

src/libs/util.ts

@@ -3,7 +3,7 @@
 import axios, { AxiosResponse } from "axios";
 import { Buffer } from "buffer";
 import * as R from "ramda";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 
 import { DEFAULT_PUSH_SERVER, NotificationIface } from "../constants/app";
 import { Account, AccountEncrypted } from "../db/tables/accounts";
@@ -160,49 +160,6 @@ export const isGiveAction = (
   return isGiveClaimType(veriClaim.claimType);
 };
 
-export interface OfferFulfillment {
-  offerHandleId: string;
-  offerType: string;
-}
-
-interface FulfillmentItem {
-  "@type": string;
-  identifier?: string;
-  [key: string]: unknown;
-}
-
-/**
- * Extract offer fulfillment information from the fulfills field
- * Handles both array and single object cases
- */
-export const extractOfferFulfillment = (
-  fulfills: FulfillmentItem | FulfillmentItem[] | null | undefined,
-): OfferFulfillment | null => {
-  if (!fulfills) {
-    return null;
-  }
-
-  // Handle both array and single object cases
-  let offerFulfill = null;
-
-  if (Array.isArray(fulfills)) {
-    // Find the Offer in the fulfills array
-    offerFulfill = fulfills.find((item) => item["@type"] === "Offer");
-  } else if (fulfills["@type"] === "Offer") {
-    // fulfills is a single Offer object
-    offerFulfill = fulfills;
-  }
-
-  if (offerFulfill) {
-    return {
-      offerHandleId: offerFulfill.identifier || "",
-      offerType: offerFulfill["@type"],
-    };
-  }
-
-  return null;
-};
-
 export const shortDid = (did: string) => {
   if (did.startsWith("did:peer:")) {
     return (
@@ -240,19 +197,11 @@ export const nameForContact = (
   );
 };
 
-export const doCopyTwoSecRedo = async (
-  text: string,
-  fn: () => void,
-): Promise<void> => {
+export const doCopyTwoSecRedo = (text: string, fn: () => void) => {
   fn();
-  try {
-    await copyToClipboard(text);
-    setTimeout(fn, 2000);
-  } catch (error) {
-    // Note: This utility function doesn't have access to notification system
-    // The calling component should handle error notifications
-    // Error is silently caught to avoid breaking the 2-second redo pattern
-  }
+  useClipboard()
+    .copy(text)
+    .then(() => setTimeout(fn, 2000));
 };
 
 export interface ConfirmerData {
@@ -720,8 +669,7 @@ export async function saveNewIdentity(
   ];
   await platformService.dbExec(sql, params);
 
-  // Update active identity in the active_identity table instead of settings
-  await platformService.updateActiveDid(identity.did);
+  await platformService.updateDefaultSettings({ activeDid: identity.did });
 
   await platformService.insertNewDidIntoSettings(identity.did);
 }
@@ -774,8 +722,7 @@ export const registerSaveAndActivatePasskey = async (
 ): Promise<Account> => {
   const account = await registerAndSavePasskey(keyName);
   const platformService = await getPlatformService();
-  // Update active identity in the active_identity table instead of settings
-  await platformService.updateActiveDid(account.did);
+  await platformService.updateDefaultSettings({ activeDid: account.did });
   await platformService.updateDidSpecificSettings(account.did, {
     isRegistered: false,
   });

src/main.capacitor.ts

@@ -69,18 +69,18 @@ const deepLinkHandler = new DeepLinkHandler(router);
  */
 const handleDeepLink = async (data: { url: string }) => {
   const { url } = data;
-  logger.debug(`[Main] 🌐 Deeplink received from Capacitor: ${url}`);
+  logger.info(`[Main] 🌐 Deeplink received from Capacitor: ${url}`);
 
   try {
     // Wait for router to be ready
-    logger.debug(`[Main] ⏳ Waiting for router to be ready...`);
+    logger.info(`[Main] ⏳ Waiting for router to be ready...`);
     await router.isReady();
-    logger.debug(`[Main] ✅ Router is ready, processing deeplink`);
+    logger.info(`[Main] ✅ Router is ready, processing deeplink`);
 
     // Process the deeplink
-    logger.debug(`[Main] 🚀 Starting deeplink processing`);
+    logger.info(`[Main] 🚀 Starting deeplink processing`);
     await deepLinkHandler.handleDeepLink(url);
-    logger.debug(`[Main] ✅ Deeplink processed successfully`);
+    logger.info(`[Main] ✅ Deeplink processed successfully`);
   } catch (error) {
     logger.error(`[Main] ❌ Deeplink processing failed:`, {
       url,
@@ -115,25 +115,25 @@ const registerDeepLinkListener = async () => {
     );
 
     // Check if Capacitor App plugin is available
-    logger.debug(`[Main] 🔍 Checking Capacitor App plugin availability...`);
+    logger.info(`[Main] 🔍 Checking Capacitor App plugin availability...`);
     if (!CapacitorApp) {
       throw new Error("Capacitor App plugin not available");
     }
     logger.info(`[Main] ✅ Capacitor App plugin is available`);
 
     // Check available methods on CapacitorApp
-    logger.debug(
+    logger.info(
       `[Main] 🔍 Capacitor App plugin methods:`,
       Object.getOwnPropertyNames(CapacitorApp),
     );
-    logger.debug(
+    logger.info(
       `[Main] 🔍 Capacitor App plugin addListener method:`,
       typeof CapacitorApp.addListener,
     );
 
     // Wait for router to be ready first
     await router.isReady();
-    logger.debug(
+    logger.info(
       `[Main] ✅ Router is ready, proceeding with listener registration`,
     );
 
@@ -148,6 +148,9 @@ const registerDeepLinkListener = async () => {
       listenerHandle,
     );
 
+    // Test the listener registration by checking if it's actually registered
+    logger.info(`[Main] 🧪 Verifying listener registration...`);
+
     return listenerHandle;
   } catch (error) {
     logger.error(`[Main] ❌ Failed to register deeplink listener:`, {

src/main.ts

@@ -24,12 +24,12 @@ logger.info("[Main] 🌍 Boot-time environment configuration:", {
 
 // Dynamically import the appropriate main entry point
 if (platform === "capacitor") {
-  logger.debug(`[Main] 📱 Loading Capacitor-specific entry point`);
+  logger.info(`[Main] 📱 Loading Capacitor-specific entry point`);
   import("./main.capacitor");
 } else if (platform === "electron") {
-  logger.debug(`[Main] 💻 Loading Electron-specific entry point`);
+  logger.info(`[Main] 💻 Loading Electron-specific entry point`);
   import("./main.electron");
 } else {
-  logger.debug(`[Main] 🌐 Loading Web-specific entry point`);
+  logger.info(`[Main] 🌐 Loading Web-specific entry point`);
   import("./main.web");
 }

src/router/index.ts

@@ -387,7 +387,7 @@ router.beforeEach(async (to, _from, next) => {
       );
     }
 
-    logger.debug(`[Router] ✅ Navigation guard passed for: ${to.path}`);
+    logger.info(`[Router] ✅ Navigation guard passed for: ${to.path}`);
     next();
   } catch (error) {
     logger.error("[Router] ❌ Identity creation failed in navigation guard:", {

src/services/PlatformService.ts

@@ -155,16 +155,6 @@ export interface PlatformService {
    */
   dbGetOneRow(sql: string, params?: unknown[]): Promise<unknown[] | undefined>;
 
-  /**
-   * Not recommended except for debugging.
-   * Return the raw result of a SQL query.
-   *
-   * @param sql - The SQL query to execute
-   * @param params - The parameters to pass to the query
-   * @returns Promise resolving to the raw query result, or undefined if no results
-   */
-  dbRawQuery(sql: string, params?: unknown[]): Promise<unknown | undefined>;
-
   // Database utility methods
   /**
    * Generates an INSERT SQL statement for a given model and table.
@@ -183,7 +173,6 @@ export interface PlatformService {
    * @returns Promise that resolves when the update is complete
    */
   updateDefaultSettings(settings: Record<string, unknown>): Promise<void>;
-  updateActiveDid(did: string): Promise<void>;
 
   /**
    * Inserts a new DID into the settings table.

src/services/QRScanner/WebInlineQRScanner.ts

@@ -36,7 +36,7 @@ export class WebInlineQRScanner implements QRScannerService {
     // Generate a short random ID for this scanner instance
     this.id = Math.random().toString(36).substring(2, 8).toUpperCase();
     this.options = options ?? {};
-    logger.debug(
+    logger.error(
       `[WebInlineQRScanner:${this.id}] Initializing scanner with options:`,
       {
         ...this.options,
@@ -49,7 +49,7 @@ export class WebInlineQRScanner implements QRScannerService {
     this.context = this.canvas.getContext("2d", { willReadFrequently: true });
     this.video = document.createElement("video");
     this.video.setAttribute("playsinline", "true"); // Required for iOS
-    logger.debug(
+    logger.error(
       `[WebInlineQRScanner:${this.id}] DOM elements created successfully`,
     );
   }
@@ -60,7 +60,7 @@ export class WebInlineQRScanner implements QRScannerService {
     this.cameraStateListeners.forEach((listener) => {
       try {
         listener.onStateChange(state, message);
-        logger.debug(
+        logger.info(
           `[WebInlineQRScanner:${this.id}] Camera state changed to: ${state}`,
           {
             state,
@@ -89,7 +89,7 @@ export class WebInlineQRScanner implements QRScannerService {
   async checkPermissions(): Promise<boolean> {
     try {
       this.updateCameraState("initializing", "Checking camera permissions...");
-      logger.debug(
+      logger.error(
         `[WebInlineQRScanner:${this.id}] Checking camera permissions...`,
       );
 
@@ -99,7 +99,7 @@ export class WebInlineQRScanner implements QRScannerService {
           const permissions = await navigator.permissions.query({
             name: "camera" as PermissionName,
           });
-          logger.debug(
+          logger.error(
             `[WebInlineQRScanner:${this.id}] Permission state from Permissions API:`,
             permissions.state,
           );
@@ -165,7 +165,7 @@ export class WebInlineQRScanner implements QRScannerService {
         "initializing",
         "Requesting camera permissions...",
       );
-      logger.debug(
+      logger.error(
         `[WebInlineQRScanner:${this.id}] Requesting camera permissions...`,
       );
 
@@ -175,7 +175,7 @@ export class WebInlineQRScanner implements QRScannerService {
         (device) => device.kind === "videoinput",
       );
 
-      logger.debug(`[WebInlineQRScanner:${this.id}] Found video devices:`, {
+      logger.error(`[WebInlineQRScanner:${this.id}] Found video devices:`, {
         count: videoDevices.length,
         devices: videoDevices.map((d) => ({ id: d.deviceId, label: d.label })),
         userAgent: navigator.userAgent,
@@ -188,7 +188,7 @@ export class WebInlineQRScanner implements QRScannerService {
       }
 
       // Try to get a stream with specific constraints
-      logger.debug(
+      logger.error(
         `[WebInlineQRScanner:${this.id}] Requesting camera stream with constraints:`,
         {
           facingMode: "environment",
@@ -210,7 +210,7 @@ export class WebInlineQRScanner implements QRScannerService {
 
         // Stop the test stream immediately
         stream.getTracks().forEach((track) => {
-          logger.debug(`[WebInlineQRScanner:${this.id}] Stopping test track:`, {
+          logger.error(`[WebInlineQRScanner:${this.id}] Stopping test track:`, {
             kind: track.kind,
             label: track.label,
             readyState: track.readyState,
@@ -275,12 +275,12 @@ export class WebInlineQRScanner implements QRScannerService {
 
   async isSupported(): Promise<boolean> {
     try {
-      logger.debug(
+      logger.error(
         `[WebInlineQRScanner:${this.id}] Checking browser support...`,
       );
       // Check for secure context first
       if (!window.isSecureContext) {
-        logger.debug(
+        logger.error(
           `[WebInlineQRScanner:${this.id}] Camera access requires HTTPS (secure context)`,
         );
         return false;
@@ -300,7 +300,7 @@ export class WebInlineQRScanner implements QRScannerService {
         (device) => device.kind === "videoinput",
       );
 
-      logger.debug(`[WebInlineQRScanner:${this.id}] Device support check:`, {
+      logger.error(`[WebInlineQRScanner:${this.id}] Device support check:`, {
         hasSecureContext: window.isSecureContext,
         hasMediaDevices: !!navigator.mediaDevices,
         hasGetUserMedia: !!navigator.mediaDevices?.getUserMedia,
@@ -379,7 +379,7 @@ export class WebInlineQRScanner implements QRScannerService {
 
       // Log scan attempt every 100 frames or 1 second
       if (this.scanAttempts % 100 === 0 || timeSinceLastScan >= 1000) {
-        logger.debug(`[WebInlineQRScanner:${this.id}] Scanning frame:`, {
+        logger.error(`[WebInlineQRScanner:${this.id}] Scanning frame:`, {
           attempt: this.scanAttempts,
           dimensions: {
             width: this.canvas.width,
@@ -421,7 +421,7 @@ export class WebInlineQRScanner implements QRScannerService {
           !code.data ||
           code.data.length === 0;
 
-        logger.debug(`[WebInlineQRScanner:${this.id}] QR Code detected:`, {
+        logger.error(`[WebInlineQRScanner:${this.id}] QR Code detected:`, {
           data: code.data,
           location: code.location,
           attempts: this.scanAttempts,
@@ -512,13 +512,13 @@ export class WebInlineQRScanner implements QRScannerService {
       this.scanAttempts = 0;
       this.lastScanTime = Date.now();
       this.updateCameraState("initializing", "Starting camera...");
-      logger.debug(
+      logger.error(
         `[WebInlineQRScanner:${this.id}] Starting scan with options:`,
         this.options,
       );
 
       // Get camera stream with options
-      logger.debug(
+      logger.error(
         `[WebInlineQRScanner:${this.id}] Requesting camera stream...`,
       );
       this.stream = await navigator.mediaDevices.getUserMedia({
@@ -531,7 +531,7 @@ export class WebInlineQRScanner implements QRScannerService {
 
       this.updateCameraState("active", "Camera is active");
 
-      logger.debug(`[WebInlineQRScanner:${this.id}] Camera stream obtained:`, {
+      logger.error(`[WebInlineQRScanner:${this.id}] Camera stream obtained:`, {
         tracks: this.stream.getTracks().map((t) => ({
           kind: t.kind,
           label: t.label,
@@ -550,14 +550,14 @@ export class WebInlineQRScanner implements QRScannerService {
           this.video.style.display = "none";
         }
         await this.video.play();
-        logger.debug(
+        logger.error(
           `[WebInlineQRScanner:${this.id}] Video element started playing`,
         );
       }
 
       // Emit stream to component
       this.events.emit("stream", this.stream);
-      logger.debug(`[WebInlineQRScanner:${this.id}] Stream event emitted`);
+      logger.error(`[WebInlineQRScanner:${this.id}] Stream event emitted`);
 
       // Start QR code scanning
       this.scanQRCode();
@@ -595,7 +595,7 @@ export class WebInlineQRScanner implements QRScannerService {
     }
 
     try {
-      logger.debug(`[WebInlineQRScanner:${this.id}] Stopping scan`, {
+      logger.error(`[WebInlineQRScanner:${this.id}] Stopping scan`, {
         scanAttempts: this.scanAttempts,
         duration: Date.now() - this.lastScanTime,
       });
@@ -604,7 +604,7 @@ export class WebInlineQRScanner implements QRScannerService {
       if (this.animationFrameId !== null) {
         cancelAnimationFrame(this.animationFrameId);
         this.animationFrameId = null;
-        logger.debug(
+        logger.error(
           `[WebInlineQRScanner:${this.id}] Animation frame cancelled`,
         );
       }
@@ -613,13 +613,13 @@ export class WebInlineQRScanner implements QRScannerService {
       if (this.video) {
         this.video.pause();
         this.video.srcObject = null;
-        logger.debug(`[WebInlineQRScanner:${this.id}] Video element stopped`);
+        logger.error(`[WebInlineQRScanner:${this.id}] Video element stopped`);
       }
 
       // Stop all tracks in the stream
       if (this.stream) {
         this.stream.getTracks().forEach((track) => {
-          logger.debug(`[WebInlineQRScanner:${this.id}] Stopping track:`, {
+          logger.error(`[WebInlineQRScanner:${this.id}] Stopping track:`, {
             kind: track.kind,
             label: track.label,
             readyState: track.readyState,
@@ -631,7 +631,7 @@ export class WebInlineQRScanner implements QRScannerService {
 
       // Emit stream stopped event
       this.events.emit("stream", null);
-      logger.debug(
+      logger.error(
         `[WebInlineQRScanner:${this.id}] Stream stopped event emitted`,
       );
     } catch (error) {
@@ -643,17 +643,17 @@ export class WebInlineQRScanner implements QRScannerService {
       throw error;
     } finally {
       this.isScanning = false;
-      logger.debug(`[WebInlineQRScanner:${this.id}] Scan stopped successfully`);
+      logger.error(`[WebInlineQRScanner:${this.id}] Scan stopped successfully`);
     }
   }
 
   addListener(listener: ScanListener): void {
-    logger.debug(`[WebInlineQRScanner:${this.id}] Adding scan listener`);
+    logger.error(`[WebInlineQRScanner:${this.id}] Adding scan listener`);
     this.scanListener = listener;
   }
 
   onStream(callback: (stream: MediaStream | null) => void): void {
-    logger.debug(
+    logger.error(
       `[WebInlineQRScanner:${this.id}] Adding stream event listener`,
     );
     this.events.on("stream", callback);
@@ -661,24 +661,24 @@ export class WebInlineQRScanner implements QRScannerService {
 
   async cleanup(): Promise<void> {
     try {
-      logger.debug(`[WebInlineQRScanner:${this.id}] Starting cleanup`);
+      logger.error(`[WebInlineQRScanner:${this.id}] Starting cleanup`);
       await this.stopScan();
       this.events.removeAllListeners();
-      logger.debug(`[WebInlineQRScanner:${this.id}] Event listeners removed`);
+      logger.error(`[WebInlineQRScanner:${this.id}] Event listeners removed`);
 
       // Clean up DOM elements
       if (this.video) {
         this.video.remove();
         this.video = null;
-        logger.debug(`[WebInlineQRScanner:${this.id}] Video element removed`);
+        logger.error(`[WebInlineQRScanner:${this.id}] Video element removed`);
       }
       if (this.canvas) {
         this.canvas.remove();
         this.canvas = null;
-        logger.debug(`[WebInlineQRScanner:${this.id}] Canvas element removed`);
+        logger.error(`[WebInlineQRScanner:${this.id}] Canvas element removed`);
       }
       this.context = null;
-      logger.debug(
+      logger.error(
         `[WebInlineQRScanner:${this.id}] Cleanup completed successfully`,
       );
     } catch (error) {

src/services/migrationService.ts

@@ -73,8 +73,6 @@ interface Migration {
   name: string;
   /** SQL statement(s) to execute for this migration */
   sql: string;
-  /** Optional array of individual SQL statements for better error handling */
-  statements?: string[];
 }
 
 /**
@@ -227,104 +225,6 @@ export function registerMigration(migration: Migration): void {
  * }
  * ```
  */
-/**
- * Helper function to check if a SQLite result indicates a table exists
- * @param result - The result from a sqlite_master query
- * @returns true if the table exists
- */
-function checkSqliteTableResult(result: unknown): boolean {
-  return (
-    (result as unknown as { values: unknown[][] })?.values?.length > 0 ||
-    (Array.isArray(result) && result.length > 0)
-  );
-}
-
-/**
- * Helper function to validate that a table exists in the database
- * @param tableName - Name of the table to check
- * @param sqlQuery - Function to execute SQL queries
- * @returns Promise resolving to true if table exists
- */
-async function validateTableExists<T>(
-  tableName: string,
-  sqlQuery: (sql: string, params?: unknown[]) => Promise<T>,
-): Promise<boolean> {
-  try {
-    const result = await sqlQuery(
-      `SELECT name FROM sqlite_master WHERE type='table' AND name='${tableName}'`,
-    );
-    return checkSqliteTableResult(result);
-  } catch (error) {
-    logger.error(`❌ [Validation] Error checking table ${tableName}:`, error);
-    return false;
-  }
-}
-
-/**
- * Helper function to validate that a column exists in a table
- * @param tableName - Name of the table
- * @param columnName - Name of the column to check
- * @param sqlQuery - Function to execute SQL queries
- * @returns Promise resolving to true if column exists
- */
-async function validateColumnExists<T>(
-  tableName: string,
-  columnName: string,
-  sqlQuery: (sql: string, params?: unknown[]) => Promise<T>,
-): Promise<boolean> {
-  try {
-    await sqlQuery(`SELECT ${columnName} FROM ${tableName} LIMIT 1`);
-    return true;
-  } catch (error) {
-    logger.error(
-      `❌ [Validation] Error checking column ${columnName} in ${tableName}:`,
-      error,
-    );
-    return false;
-  }
-}
-
-/**
- * Helper function to validate multiple tables exist
- * @param tableNames - Array of table names to check
- * @param sqlQuery - Function to execute SQL queries
- * @returns Promise resolving to array of validation results
- */
-async function validateMultipleTables<T>(
-  tableNames: string[],
-  sqlQuery: (sql: string, params?: unknown[]) => Promise<T>,
-): Promise<{ exists: boolean; missing: string[] }> {
-  const missing: string[] = [];
-
-  for (const tableName of tableNames) {
-    const exists = await validateTableExists(tableName, sqlQuery);
-    if (!exists) {
-      missing.push(tableName);
-    }
-  }
-
-  return {
-    exists: missing.length === 0,
-    missing,
-  };
-}
-
-/**
- * Helper function to add validation error with consistent logging
- * @param validation - The validation object to update
- * @param message - Error message to add
- * @param error - The error object for logging
- */
-function addValidationError(
-  validation: MigrationValidation,
-  message: string,
-  error: unknown,
-): void {
-  validation.isValid = false;
-  validation.errors.push(message);
-  logger.error(`❌ [Migration-Validation] ${message}:`, error);
-}
-
 async function validateMigrationApplication<T>(
   migration: Migration,
   sqlQuery: (sql: string, params?: unknown[]) => Promise<T>,
@@ -348,82 +248,36 @@ async function validateMigrationApplication<T>(
         "temp",
       ];
 
-      const tableValidation = await validateMultipleTables(tables, sqlQuery);
-      if (!tableValidation.exists) {
-        validation.isValid = false;
-        validation.errors.push(
-          `Missing tables: ${tableValidation.missing.join(", ")}`,
-        );
-        logger.error(
-          `❌ [Migration-Validation] Missing tables:`,
-          tableValidation.missing,
-        );
-      }
-      validation.tableExists = tableValidation.exists;
-    } else if (migration.name === "002_add_iViewContent_to_contacts") {
-      // Validate iViewContent column exists in contacts table
-      const columnExists = await validateColumnExists(
-        "contacts",
-        "iViewContent",
-        sqlQuery,
-      );
-      if (!columnExists) {
-        addValidationError(
-          validation,
-          "Column iViewContent missing from contacts table",
-          new Error("Column not found"),
-        );
-      } else {
-        validation.hasExpectedColumns = true;
-      }
-    } else if (migration.name === "004_active_identity_management") {
-      // Validate active_identity table exists and has correct structure
-      const activeIdentityExists = await validateTableExists(
-        "active_identity",
-        sqlQuery,
-      );
-
-      if (!activeIdentityExists) {
-        addValidationError(
-          validation,
-          "Table active_identity missing",
-          new Error("Table not found"),
-        );
-      } else {
-        validation.tableExists = true;
-
-        // Check that active_identity has the expected structure
-        const hasExpectedColumns = await validateColumnExists(
-          "active_identity",
-          "id, activeDid, lastUpdated",
-          sqlQuery,
-        );
-
-        if (!hasExpectedColumns) {
-          addValidationError(
-            validation,
-            "active_identity table missing expected columns",
-            new Error("Columns not found"),
+      for (const tableName of tables) {
+        try {
+          await sqlQuery(
+            `SELECT name FROM sqlite_master WHERE type='table' AND name='${tableName}'`,
+          );
+          // Reduced logging - only log on error
+        } catch (error) {
+          validation.isValid = false;
+          validation.errors.push(`Table ${tableName} missing`);
+          logger.error(
+            `❌ [Migration-Validation] Table ${tableName} missing:`,
+            error,
           );
-        } else {
-          validation.hasExpectedColumns = true;
         }
       }
-
-      // Check that hasBackedUpSeed column exists in settings table
-      // Note: This validation is included here because migration 004 is consolidated
-      // and includes the functionality from the original migration 003
-      const hasBackedUpSeedExists = await validateColumnExists(
-        "settings",
-        "hasBackedUpSeed",
-        sqlQuery,
-      );
-
-      if (!hasBackedUpSeedExists) {
-        addValidationError(
-          validation,
-          "Column hasBackedUpSeed missing from settings table",
-          new Error("Column not found"),
+      validation.tableExists = validation.errors.length === 0;
+    } else if (migration.name === "002_add_iViewContent_to_contacts") {
+      // Validate iViewContent column exists in contacts table
+      try {
+        await sqlQuery(`SELECT iViewContent FROM contacts LIMIT 1`);
+        validation.hasExpectedColumns = true;
+        // Reduced logging - only log on error
+      } catch (error) {
+        validation.isValid = false;
+        validation.errors.push(
+          `Column iViewContent missing from contacts table`,
+        );
+        logger.error(
+          `❌ [Migration-Validation] Column iViewContent missing:`,
+          error,
         );
       }
     }
@@ -489,55 +343,6 @@ async function isSchemaAlreadyPresent<T>(
         // Reduced logging - only log on error
         return false;
       }
-    } else if (migration.name === "003_add_hasBackedUpSeed_to_settings") {
-      // Check if hasBackedUpSeed column exists in settings table
-      try {
-        await sqlQuery(`SELECT hasBackedUpSeed FROM settings LIMIT 1`);
-        return true;
-      } catch (error) {
-        return false;
-      }
-    } else if (migration.name === "004_active_identity_management") {
-      // Check if active_identity table exists and has correct structure
-      try {
-        // Check that active_identity table exists
-        const activeIdentityResult = await sqlQuery(
-          `SELECT name FROM sqlite_master WHERE type='table' AND name='active_identity'`,
-        );
-        const hasActiveIdentityTable =
-          (activeIdentityResult as unknown as { values: unknown[][] })?.values
-            ?.length > 0 ||
-          (Array.isArray(activeIdentityResult) &&
-            activeIdentityResult.length > 0);
-
-        if (!hasActiveIdentityTable) {
-          return false;
-        }
-
-        // Check that active_identity has the expected structure
-        try {
-          await sqlQuery(
-            `SELECT id, activeDid, lastUpdated FROM active_identity LIMIT 1`,
-          );
-
-          // Also check that hasBackedUpSeed column exists in settings
-          // This is included because migration 004 is consolidated
-          try {
-            await sqlQuery(`SELECT hasBackedUpSeed FROM settings LIMIT 1`);
-            return true;
-          } catch (error) {
-            return false;
-          }
-        } catch (error) {
-          return false;
-        }
-      } catch (error) {
-        logger.error(
-          `🔍 [Migration-Schema] Schema check failed for ${migration.name}, assuming not present:`,
-          error,
-        );
-        return false;
-      }
     }
 
     // Add schema checks for future migrations here
@@ -599,10 +404,15 @@ export async function runMigrations<T>(
   sqlQuery: (sql: string, params?: unknown[]) => Promise<T>,
   extractMigrationNames: (result: T) => Set<string>,
 ): Promise<void> {
-  try {
-    logger.debug("📋 [Migration] Starting migration process...");
+  const isDevelopment = process.env.VITE_PLATFORM === "development";
 
-    // Create migrations table if it doesn't exist
+  // Use debug level for routine migration messages in development
+  const migrationLog = isDevelopment ? logger.debug : logger.log;
+
+  try {
+    migrationLog("📋 [Migration] Starting migration process...");
+
+    // Step 1: Create migrations table if it doesn't exist
     // Note: We use IF NOT EXISTS here because this is infrastructure, not a business migration
     await sqlExec(`
       CREATE TABLE IF NOT EXISTS migrations (
@@ -626,8 +436,7 @@ export async function runMigrations<T>(
       return;
     }
 
-    // Only log migration counts in development
-    logger.debug(
+    migrationLog(
       `📊 [Migration] Found ${migrations.length} total migrations, ${appliedMigrations.size} already applied`,
     );
 
@@ -639,22 +448,22 @@ export async function runMigrations<T>(
       // Check 1: Is it recorded as applied in migrations table?
       const isRecordedAsApplied = appliedMigrations.has(migration.name);
 
-      // Skip if already recorded as applied (name-only check)
+      // Check 2: Does the schema already exist in the database?
+      const isSchemaPresent = await isSchemaAlreadyPresent(migration, sqlQuery);
+
+      // Skip if already recorded as applied
       if (isRecordedAsApplied) {
         skippedCount++;
         continue;
       }
 
-      // Check 2: Does the schema already exist in the database?
-      const isSchemaPresent = await isSchemaAlreadyPresent(migration, sqlQuery);
-
       // Handle case where schema exists but isn't recorded
       if (isSchemaPresent) {
         try {
           await sqlExec("INSERT INTO migrations (name) VALUES (?)", [
             migration.name,
           ]);
-          logger.debug(
+          migrationLog(
             `✅ [Migration] Marked existing schema as applied: ${migration.name}`,
           );
           skippedCount++;
@@ -669,20 +478,11 @@ export async function runMigrations<T>(
       }
 
       // Apply the migration
-      logger.debug(`🔄 [Migration] Applying migration: ${migration.name}`);
+      migrationLog(`🔄 [Migration] Applying migration: ${migration.name}`);
 
       try {
-        // Execute the migration SQL as single atomic operation
-        logger.debug(`🔧 [Migration] Executing SQL for: ${migration.name}`);
-        logger.debug(`🔧 [Migration] SQL content: ${migration.sql}`);
-
-        // Execute the migration SQL directly - it should be atomic
-        // The SQL itself should handle any necessary transactions
-        const execResult = await sqlExec(migration.sql);
-
-        logger.debug(
-          `🔧 [Migration] SQL execution result: ${JSON.stringify(execResult)}`,
-        );
+        // Execute the migration SQL
+        await sqlExec(migration.sql);
 
         // Validate the migration was applied correctly
         const validation = await validateMigrationApplication(
@@ -701,33 +501,11 @@ export async function runMigrations<T>(
           migration.name,
         ]);
 
-        logger.debug(`🎉 [Migration] Successfully applied: ${migration.name}`);
+        migrationLog(`🎉 [Migration] Successfully applied: ${migration.name}`);
         appliedCount++;
       } catch (error) {
         logger.error(`❌ [Migration] Error applying ${migration.name}:`, error);
 
-        // Provide explicit rollback instructions for migration failures
-        logger.error(
-          `🔄 [Migration] ROLLBACK INSTRUCTIONS for ${migration.name}:`,
-        );
-        logger.error(`   1. Stop the application immediately`);
-        logger.error(
-          `   2. Restore database from pre-migration backup/snapshot`,
-        );
-        logger.error(
-          `   3. Remove migration entry: DELETE FROM migrations WHERE name = '${migration.name}'`,
-        );
-        logger.error(
-          `   4. Verify database state matches pre-migration condition`,
-        );
-        logger.error(`   5. Restart application and investigate root cause`);
-        logger.error(
-          `   FAILURE CAUSE: ${error instanceof Error ? error.message : String(error)}`,
-        );
-        logger.error(
-          `   REQUIRED OPERATOR ACTION: Manual database restoration required`,
-        );
-
         // Handle specific cases where the migration might be partially applied
         const errorMessage = String(error).toLowerCase();
 
@@ -739,7 +517,7 @@ export async function runMigrations<T>(
           (errorMessage.includes("table") &&
             errorMessage.includes("already exists"))
         ) {
-          logger.debug(
+          migrationLog(
             `⚠️  [Migration] ${migration.name} appears already applied (${errorMessage}). Validating and marking as complete.`,
           );
 
@@ -753,8 +531,6 @@ export async function runMigrations<T>(
               `⚠️  [Migration] Schema validation failed for ${migration.name}:`,
               validation.errors,
             );
-            // Don't mark as applied if validation fails
-            continue;
           }
 
           // Mark the migration as applied since the schema change already exists
@@ -762,7 +538,7 @@ export async function runMigrations<T>(
             await sqlExec("INSERT INTO migrations (name) VALUES (?)", [
               migration.name,
             ]);
-            logger.debug(`✅ [Migration] Marked as applied: ${migration.name}`);
+            migrationLog(`✅ [Migration] Marked as applied: ${migration.name}`);
             appliedCount++;
           } catch (insertError) {
             // If we can't insert the migration record, log it but don't fail
@@ -782,7 +558,7 @@ export async function runMigrations<T>(
       }
     }
 
-    // Step 6: Final validation - verify all migrations are properly recorded
+    // Step 5: Final validation - verify all migrations are properly recorded
     const finalMigrationsResult = await sqlQuery("SELECT name FROM migrations");
     const finalAppliedMigrations = extractMigrationNames(finalMigrationsResult);
 
@@ -798,8 +574,8 @@ export async function runMigrations<T>(
       );
     }
 
-    // Only show completion message in development
-    logger.debug(
+    // Always show completion message
+    logger.log(
       `🎉 [Migration] Migration process complete! Summary: ${appliedCount} applied, ${skippedCount} skipped`,
     );
   } catch (error) {

src/services/platforms/CapacitorPlatformService.ts

@@ -24,7 +24,7 @@ import {
 import { logger } from "../../utils/logger";
 
 interface QueuedOperation {
-  type: "run" | "query" | "rawQuery";
+  type: "run" | "query";
   sql: string;
   params: unknown[];
   resolve: (value: unknown) => void;
@@ -66,13 +66,13 @@ export class CapacitorPlatformService implements PlatformService {
       return this.initializationPromise;
     }
 
+    // Start initialization
+    this.initializationPromise = this._initialize();
     try {
-      // Start initialization
-      this.initializationPromise = this._initialize();
       await this.initializationPromise;
     } catch (error) {
       logger.error(
-        "[CapacitorPlatformService] Initialize database method failed:",
+        "[CapacitorPlatformService] Initialize method failed:",
         error,
       );
       this.initializationPromise = null; // Reset on failure
@@ -159,14 +159,6 @@ export class CapacitorPlatformService implements PlatformService {
             };
             break;
           }
-          case "rawQuery": {
-            const queryResult = await this.db.query(
-              operation.sql,
-              operation.params,
-            );
-            result = queryResult;
-            break;
-          }
         }
         operation.resolve(result);
       } catch (error) {
@@ -508,24 +500,9 @@ export class CapacitorPlatformService implements PlatformService {
         // This is essential for proper parameter binding and SQL injection prevention
         await this.db!.run(sql, params);
       } else {
-        // For multi-statement SQL (like migrations), use executeSet method
-        // This handles multiple statements properly
-        if (
-          sql.includes(";") &&
-          sql.split(";").filter((s) => s.trim()).length > 1
-        ) {
-          // Multi-statement SQL - use executeSet for proper handling
-          const statements = sql.split(";").filter((s) => s.trim());
-          await this.db!.executeSet(
-            statements.map((stmt) => ({
-              statement: stmt.trim(),
-              values: [], // Empty values array for non-parameterized statements
-            })),
-          );
-        } else {
-          // Single statement - use execute method
-          await this.db!.execute(sql);
-        }
+        // Use execute method for non-parameterized queries
+        // This is more efficient for simple DDL statements
+        await this.db!.execute(sql);
       }
     };
 
@@ -1293,14 +1270,6 @@ export class CapacitorPlatformService implements PlatformService {
     return undefined;
   }
 
-  /**
-   * @see PlatformService.dbRawQuery
-   */
-  async dbRawQuery(sql: string, params?: unknown[]): Promise<unknown> {
-    await this.waitForInitialization();
-    return this.queueOperation("rawQuery", sql, params || []);
-  }
-
   /**
    * Checks if running on Capacitor platform.
    * @returns true, as this is the Capacitor implementation
@@ -1350,24 +1319,8 @@ export class CapacitorPlatformService implements PlatformService {
     await this.dbExec(sql, params);
   }
 
-  async updateActiveDid(did: string): Promise<void> {
-    await this.dbExec(
-      "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
-      [did],
-    );
-  }
-
   async insertNewDidIntoSettings(did: string): Promise<void> {
-    // Import constants dynamically to avoid circular dependencies
-    const { DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER } =
-      await import("@/constants/app");
-
-    // Use INSERT OR REPLACE to handle case where settings already exist for this DID
-    // This prevents duplicate accountDid entries and ensures data integrity
-    await this.dbExec(
-      "INSERT OR REPLACE INTO settings (accountDid, finishedOnboarding, apiServer, partnerApiServer) VALUES (?, ?, ?, ?)",
-      [did, false, DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER],
-    );
+    await this.dbExec("INSERT INTO settings (accountDid) VALUES (?)", [did]);
   }
 
   async updateDidSpecificSettings(

src/services/platforms/WebPlatformService.ts

@@ -636,17 +636,6 @@ export class WebPlatformService implements PlatformService {
     } as GetOneRowRequest);
   }
 
-  /**
-   * @see PlatformService.dbRawQuery
-   */
-  async dbRawQuery(
-    sql: string,
-    params?: unknown[],
-  ): Promise<unknown | undefined> {
-    // This class doesn't post-process the result, so we can just use it.
-    return this.dbQuery(sql, params);
-  }
-
   /**
    * Rotates the camera between front and back cameras.
    * @returns Promise that resolves when the camera is rotated
@@ -685,51 +674,15 @@ export class WebPlatformService implements PlatformService {
   async updateDefaultSettings(
     settings: Record<string, unknown>,
   ): Promise<void> {
-    // Get current active DID and update that identity's settings
-    const activeIdentity = await this.getActiveIdentity();
-    const activeDid = activeIdentity.activeDid;
-
-    if (!activeDid) {
-      logger.warn(
-        "[WebPlatformService] No active DID found, cannot update default settings",
-      );
-      return;
-    }
-
     const keys = Object.keys(settings);
     const setClause = keys.map((key) => `${key} = ?`).join(", ");
-    const sql = `UPDATE settings SET ${setClause} WHERE accountDid = ?`;
-    const params = [...keys.map((key) => settings[key]), activeDid];
+    const sql = `UPDATE settings SET ${setClause} WHERE id = 1`;
+    const params = keys.map((key) => settings[key]);
     await this.dbExec(sql, params);
   }
 
-  async updateActiveDid(did: string): Promise<void> {
-    await this.dbExec(
-      "INSERT OR REPLACE INTO active_identity (id, activeDid, lastUpdated) VALUES (1, ?, ?)",
-      [did, new Date().toISOString()],
-    );
-  }
-
-  async getActiveIdentity(): Promise<{ activeDid: string }> {
-    const result = await this.dbQuery(
-      "SELECT activeDid FROM active_identity WHERE id = 1",
-    );
-    return {
-      activeDid: (result?.values?.[0]?.[0] as string) || "",
-    };
-  }
-
   async insertNewDidIntoSettings(did: string): Promise<void> {
-    // Import constants dynamically to avoid circular dependencies
-    const { DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER } =
-      await import("@/constants/app");
-
-    // Use INSERT OR REPLACE to handle case where settings already exist for this DID
-    // This prevents duplicate accountDid entries and ensures data integrity
-    await this.dbExec(
-      "INSERT OR REPLACE INTO settings (accountDid, finishedOnboarding, apiServer, partnerApiServer) VALUES (?, ?, ?, ?)",
-      [did, false, DEFAULT_ENDORSER_API_SERVER, DEFAULT_PARTNER_API_SERVER],
-    );
+    await this.dbExec("INSERT INTO settings (accountDid) VALUES (?)", [did]);
   }
 
   async updateDidSpecificSettings(

src/test/index.ts

@@ -66,7 +66,7 @@ export async function testServerRegisterUser() {
 
   // Make a payload for the claim
   const vcPayload = {
-    sub: identity0.did,
+    sub: "RegisterAction",
     vc: {
       "@context": ["https://www.w3.org/2018/credentials/v1"],
       type: ["VerifiableCredential"],

src/utils/PlatformServiceMixin.ts

@@ -45,6 +45,7 @@ import type {
   PlatformCapabilities,
 } from "@/services/PlatformService";
 import {
+  MASTER_SETTINGS_KEY,
   type Settings,
   type SettingsWithJsonStrings,
 } from "@/db/tables/settings";
@@ -52,11 +53,7 @@ import { logger } from "@/utils/logger";
 import { Contact, ContactMaybeWithJsonStrings } from "@/db/tables/contacts";
 import { Account } from "@/db/tables/accounts";
 import { Temp } from "@/db/tables/temp";
-import {
-  QueryExecResult,
-  DatabaseExecResult,
-  SqlValue,
-} from "@/interfaces/database";
+import { QueryExecResult, DatabaseExecResult } from "@/interfaces/database";
 import {
   generateInsertStatement,
   generateUpdateStatement,
@@ -213,53 +210,11 @@ export const PlatformServiceMixin = {
         logger.debug(
           `[PlatformServiceMixin] ActiveDid updated from ${oldDid} to ${newDid}`,
         );
-
-        // Write only to active_identity table (single source of truth)
-        try {
-          await this.$dbExec(
-            "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
-            [newDid || ""],
-          );
-          logger.debug(
-            `[PlatformServiceMixin] ActiveDid updated in active_identity table: ${newDid}`,
-          );
-        } catch (error) {
-          logger.error(
-            `[PlatformServiceMixin] Error updating activeDid in active_identity table ${newDid}:`,
-            error,
-          );
-          // Continue with in-memory update even if database write fails
-        }
-
         // // Clear caches that might be affected by the change
         // this.$clearAllCaches();
       }
     },
 
-    /**
-     * Get available account DIDs for user selection
-     * Returns array of DIDs that can be set as active identity
-     */
-    async $getAvailableAccountDids(): Promise<string[]> {
-      try {
-        const result = await this.$dbQuery(
-          "SELECT did FROM accounts ORDER BY did",
-        );
-
-        if (!result?.values?.length) {
-          return [];
-        }
-
-        return result.values.map((row: SqlValue[]) => row[0] as string);
-      } catch (error) {
-        logger.error(
-          "[PlatformServiceMixin] Error getting available account DIDs:",
-          error,
-        );
-        return [];
-      }
-    },
-
     /**
      * Map database columns to values with proper type conversion
      * Handles boolean conversion from SQLite integers (0/1) to boolean values
@@ -275,22 +230,16 @@ export const PlatformServiceMixin = {
 
           // Convert SQLite integer booleans to JavaScript booleans
           if (
-            // settings
             column === "isRegistered" ||
             column === "finishedOnboarding" ||
             column === "filterFeedByVisible" ||
             column === "filterFeedByNearby" ||
-            column === "hasBackedUpSeed" ||
             column === "hideRegisterPromptOnNewContact" ||
             column === "showContactGivesInline" ||
             column === "showGeneralAdvanced" ||
             column === "showShortcutBvc" ||
             column === "warnIfProdServer" ||
-            column === "warnIfTestServer" ||
-            // contacts
-            column === "iViewContent" ||
-            column === "registered" ||
-            column === "seesMe"
+            column === "warnIfTestServer"
           ) {
             if (value === 1) {
               value = true;
@@ -300,9 +249,13 @@ export const PlatformServiceMixin = {
             // Keep null values as null
           }
 
-          // Convert SQLite JSON strings to objects/arrays
-          if (column === "contactMethods" || column === "searchBoxes") {
-            value = this._parseJsonField(value, []);
+          // Handle JSON fields like contactMethods
+          if (column === "contactMethods" && typeof value === "string") {
+            try {
+              value = JSON.parse(value);
+            } catch {
+              value = [];
+            }
           }
 
           obj[column] = value;
@@ -312,13 +265,10 @@ export const PlatformServiceMixin = {
     },
 
     /**
-     * Safely parses JSON strings with fallback to default value.
-     * Handles different SQLite implementations:
-     * - Web SQLite (wa-sqlite/absurd-sql): Auto-parses JSON strings to objects
-     * - Capacitor SQLite: Returns raw strings that need manual parsing
+     * Self-contained implementation of parseJsonField
+     * Safely parses JSON strings with fallback to default value
      *
-     * See also src/db/databaseUtil.ts parseJsonField
-     * and maybe consolidate
+     * Consolidate this with src/libs/util.ts parseJsonField
      */
     _parseJsonField<T>(value: unknown, defaultValue: T): T {
       if (typeof value === "string") {
@@ -468,10 +418,7 @@ export const PlatformServiceMixin = {
     /**
      * Enhanced database single row query method with error handling
      */
-    async $dbGetOneRow(
-      sql: string,
-      params?: unknown[],
-    ): Promise<SqlValue[] | undefined> {
+    async $dbGetOneRow(sql: string, params?: unknown[]) {
       try {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return await (this as any).platformService.dbGetOneRow(sql, params);
@@ -489,27 +436,6 @@ export const PlatformServiceMixin = {
       }
     },
 
-    /**
-     * Database raw query method with error handling
-     */
-    async $dbRawQuery(sql: string, params?: unknown[]) {
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return await (this as any).platformService.dbRawQuery(sql, params);
-      } catch (error) {
-        logger.error(
-          // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          `[${(this as any).$options.name}] Database raw query failed:`,
-          {
-            sql,
-            params,
-            error,
-          },
-        );
-        throw error;
-      }
-    },
-
     /**
      * Utility method for retrieving master settings
      * Common pattern used across many components
@@ -518,18 +444,10 @@ export const PlatformServiceMixin = {
       fallback: Settings | null = null,
     ): Promise<Settings | null> {
       try {
-        // Get current active identity
-        const activeIdentity = await this.$getActiveIdentity();
-        const activeDid = activeIdentity.activeDid;
-
-        if (!activeDid) {
-          return fallback;
-        }
-
-        // Get identity-specific settings
+        // Master settings: query by id
         const result = await this.$dbQuery(
-          "SELECT * FROM settings WHERE accountDid = ?",
-          [activeDid],
+          "SELECT * FROM settings WHERE id = ?",
+          [MASTER_SETTINGS_KEY],
         );
 
         if (!result?.values?.length) {
@@ -566,6 +484,7 @@ export const PlatformServiceMixin = {
      * Handles the common pattern of layered settings
      */
     async $getMergedSettings(
+      defaultKey: string,
       accountDid?: string,
       defaultFallback: Settings = {},
     ): Promise<Settings> {
@@ -621,6 +540,7 @@ export const PlatformServiceMixin = {
         return mergedSettings;
       } catch (error) {
         logger.error(`[Settings Trace] ❌ Failed to get merged settings:`, {
+          defaultKey,
           accountDid,
           error,
         });
@@ -628,73 +548,6 @@ export const PlatformServiceMixin = {
       }
     },
 
-    /**
-     * Get active identity from the new active_identity table
-     * This replaces the activeDid field in settings for better architecture
-     */
-    async $getActiveIdentity(): Promise<{ activeDid: string }> {
-      try {
-        const result = await this.$dbQuery(
-          "SELECT activeDid FROM active_identity WHERE id = 1",
-        );
-
-        if (!result?.values?.length) {
-          logger.warn(
-            "[PlatformServiceMixin] Active identity table is empty - this may indicate a migration issue",
-          );
-          return { activeDid: "" };
-        }
-
-        const activeDid = result.values[0][0] as string | null;
-
-        // Handle null activeDid (initial state after migration) - auto-select first account
-        if (activeDid === null) {
-          const firstAccount = await this.$dbQuery(
-            "SELECT did FROM accounts ORDER BY dateCreated, did LIMIT 1",
-          );
-
-          if (firstAccount?.values?.length) {
-            const firstAccountDid = firstAccount.values[0][0] as string;
-            await this.$dbExec(
-              "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
-              [firstAccountDid],
-            );
-            return { activeDid: firstAccountDid };
-          }
-
-          logger.warn(
-            "[PlatformServiceMixin] No accounts available for auto-selection",
-          );
-          return { activeDid: "" };
-        }
-
-        // Validate activeDid exists in accounts
-        const accountExists = await this.$dbQuery(
-          "SELECT did FROM accounts WHERE did = ?",
-          [activeDid],
-        );
-
-        if (accountExists?.values?.length) {
-          return { activeDid };
-        }
-
-        // Clear corrupted activeDid and return empty
-        logger.warn(
-          "[PlatformServiceMixin] Active identity not found in accounts, clearing",
-        );
-        await this.$dbExec(
-          "UPDATE active_identity SET activeDid = NULL, lastUpdated = datetime('now') WHERE id = 1",
-        );
-        return { activeDid: "" };
-      } catch (error) {
-        logger.error(
-          "[PlatformServiceMixin] Error getting active identity:",
-          error,
-        );
-        return { activeDid: "" };
-      }
-    },
-
     /**
      * Transaction wrapper with automatic rollback on error
      */
@@ -710,76 +563,6 @@ export const PlatformServiceMixin = {
       }
     },
 
-    // =================================================
-    // SMART DELETION PATTERN DAL METHODS
-    // =================================================
-
-    /**
-     * Get account DID by ID
-     * Required for smart deletion pattern
-     */
-    async $getAccountDidById(id: number): Promise<string> {
-      const result = await this.$dbQuery(
-        "SELECT did FROM accounts WHERE id = ?",
-        [id],
-      );
-      return result?.values?.[0]?.[0] as string;
-    },
-
-    /**
-     * Get active DID (returns null if none selected)
-     * Required for smart deletion pattern
-     */
-    async $getActiveDid(): Promise<string | null> {
-      const result = await this.$dbQuery(
-        "SELECT activeDid FROM active_identity WHERE id = 1",
-      );
-      return (result?.values?.[0]?.[0] as string) || null;
-    },
-
-    /**
-     * Set active DID (can be null for no selection)
-     * Required for smart deletion pattern
-     */
-    async $setActiveDid(did: string | null): Promise<void> {
-      await this.$dbExec(
-        "UPDATE active_identity SET activeDid = ?, lastUpdated = datetime('now') WHERE id = 1",
-        [did],
-      );
-    },
-
-    /**
-     * Count total accounts
-     * Required for smart deletion pattern
-     */
-    async $countAccounts(): Promise<number> {
-      const result = await this.$dbQuery("SELECT COUNT(*) FROM accounts");
-      return (result?.values?.[0]?.[0] as number) || 0;
-    },
-
-    /**
-     * Deterministic "next" picker for account selection
-     * Required for smart deletion pattern
-     */
-    $pickNextAccountDid(all: string[], current?: string): string {
-      const sorted = [...all].sort();
-      if (!current) return sorted[0];
-      const i = sorted.indexOf(current);
-      return sorted[(i + 1) % sorted.length];
-    },
-
-    /**
-     * Ensure an active account is selected (repair hook)
-     * Required for smart deletion pattern bootstrapping
-     */
-    async $ensureActiveSelected(): Promise<void> {
-      const active = await this.$getActiveDid();
-      const all = await this.$getAllAccountDids();
-      if (active === null && all.length > 0) {
-        await this.$setActiveDid(this.$pickNextAccountDid(all));
-      }
-    },
-
     // =================================================
     // ULTRA-CONCISE DATABASE METHODS (shortest names)
     // =================================================
@@ -818,7 +601,7 @@ export const PlatformServiceMixin = {
     async $one(
       sql: string,
       params: unknown[] = [],
-    ): Promise<SqlValue[] | undefined> {
+    ): Promise<unknown[] | undefined> {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       return await (this as any).platformService.dbGetOneRow(sql, params);
     },
@@ -976,14 +759,14 @@ export const PlatformServiceMixin = {
         return defaults;
       }
 
-      // FIXED: Set default apiServer for all platforms, not just Electron
+      // FIXED: Remove forced override - respect user preferences
       // Only set default if no user preference exists
-      if (!settings.apiServer) {
+      if (!settings.apiServer && process.env.VITE_PLATFORM === "electron") {
         // Import constants dynamically to get platform-specific values
         const { DEFAULT_ENDORSER_API_SERVER } = await import(
           "../constants/app"
         );
-        // Set default for all platforms when apiServer is empty
+        // Only set if user hasn't specified a preference
         settings.apiServer = DEFAULT_ENDORSER_API_SERVER;
       }
 
@@ -1009,9 +792,8 @@ export const PlatformServiceMixin = {
           return defaults;
         }
 
-        // Get DID from active_identity table (single source of truth)
-        const activeIdentity = await this.$getActiveIdentity();
-        const targetDid = did || activeIdentity.activeDid;
+        // Determine which DID to use
+        const targetDid = did || defaultSettings.activeDid;
 
         // If no target DID, return default settings
         if (!targetDid) {
@@ -1020,29 +802,22 @@ export const PlatformServiceMixin = {
 
         // Get merged settings using existing method
         const mergedSettings = await this.$getMergedSettings(
+          MASTER_SETTINGS_KEY,
           targetDid,
           defaultSettings,
         );
 
-        // Set activeDid from active_identity table (single source of truth)
-        mergedSettings.activeDid = activeIdentity.activeDid;
-        logger.debug(
-          "[PlatformServiceMixin] Using activeDid from active_identity table:",
-          { activeDid: activeIdentity.activeDid },
-        );
-        logger.debug(
-          "[PlatformServiceMixin] $accountSettings() returning activeDid:",
-          { activeDid: mergedSettings.activeDid },
-        );
-
-        // FIXED: Set default apiServer for all platforms, not just Electron
+        // FIXED: Remove forced override - respect user preferences
         // Only set default if no user preference exists
-        if (!mergedSettings.apiServer) {
+        if (
+          !mergedSettings.apiServer &&
+          process.env.VITE_PLATFORM === "electron"
+        ) {
           // Import constants dynamically to get platform-specific values
           const { DEFAULT_ENDORSER_API_SERVER } = await import(
             "../constants/app"
           );
-          // Set default for all platforms when apiServer is empty
+          // Only set if user hasn't specified a preference
           mergedSettings.apiServer = DEFAULT_ENDORSER_API_SERVER;
         }
 
@@ -1080,36 +855,16 @@ export const PlatformServiceMixin = {
     async $saveSettings(changes: Partial<Settings>): Promise<boolean> {
       try {
         // Remove fields that shouldn't be updated
-        const {
-          accountDid,
-          id,
-          activeDid: activeDidField,
-          ...safeChanges
-        } = changes;
+        const { accountDid, id, ...safeChanges } = changes;
         // eslint-disable-next-line @typescript-eslint/no-unused-vars
         void accountDid;
         // eslint-disable-next-line @typescript-eslint/no-unused-vars
         void id;
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        void activeDidField;
-
-        logger.debug(
-          "[PlatformServiceMixin] $saveSettings - Original changes:",
-          changes,
-        );
-        logger.debug(
-          "[PlatformServiceMixin] $saveSettings - Safe changes:",
-          safeChanges,
-        );
 
         if (Object.keys(safeChanges).length === 0) return true;
 
         // Convert settings for database storage (handles searchBoxes conversion)
         const convertedChanges = this._convertSettingsForStorage(safeChanges);
-        logger.debug(
-          "[PlatformServiceMixin] $saveSettings - Converted changes:",
-          convertedChanges,
-        );
 
         const setParts: string[] = [];
         const params: unknown[] = [];
@@ -1121,33 +876,17 @@ export const PlatformServiceMixin = {
           }
         });
 
-        logger.debug(
-          "[PlatformServiceMixin] $saveSettings - Set parts:",
-          setParts,
-        );
-        logger.debug("[PlatformServiceMixin] $saveSettings - Params:", params);
-
         if (setParts.length === 0) return true;
 
-        // Get current active DID and update that identity's settings
-        const activeIdentity = await this.$getActiveIdentity();
-        const currentActiveDid = activeIdentity.activeDid;
-
-        if (currentActiveDid) {
-          params.push(currentActiveDid);
-          await this.$dbExec(
-            `UPDATE settings SET ${setParts.join(", ")} WHERE accountDid = ?`,
-            params,
-          );
-        } else {
-          logger.warn(
-            "[PlatformServiceMixin] No active DID found, cannot save settings",
-          );
-        }
+        params.push(MASTER_SETTINGS_KEY);
+        await this.$dbExec(
+          `UPDATE settings SET ${setParts.join(", ")} WHERE id = ?`,
+          params,
+        );
 
         // Update activeDid tracking if it changed
-        if (activeDidField !== undefined) {
-          await this.$updateActiveDid(activeDidField);
+        if (changes.activeDid !== undefined) {
+          await this.$updateActiveDid(changes.activeDid);
         }
 
         return true;
@@ -1471,15 +1210,8 @@ export const PlatformServiceMixin = {
      */
     async $getAllAccountDids(): Promise<string[]> {
       try {
-        const result = await this.$dbQuery(
-          "SELECT did FROM accounts ORDER BY did",
-        );
-
-        if (!result?.values?.length) {
-          return [];
-        }
-
-        return result.values.map((row: SqlValue[]) => row[0] as string);
+        const accounts = await this.$query<Account>("SELECT did FROM accounts");
+        return accounts.map((account) => account.did);
       } catch (error) {
         logger.error(
           "[PlatformServiceMixin] Error getting all account DIDs:",
@@ -1604,16 +1336,13 @@ export const PlatformServiceMixin = {
       fields: string[],
       did?: string,
     ): Promise<unknown[] | undefined> {
-      // Use current active DID if no specific DID provided
-      const targetDid = did || (await this.$getActiveIdentity()).activeDid;
-
-      if (!targetDid) {
-        return undefined;
-      }
+      // Use correct settings table schema
+      const whereClause = did ? "WHERE accountDid = ?" : "WHERE id = ?";
+      const params = did ? [did] : [MASTER_SETTINGS_KEY];
 
       return await this.$one(
-        `SELECT ${fields.join(", ")} FROM settings WHERE accountDid = ?`,
-        [targetDid],
+        `SELECT ${fields.join(", ")} FROM settings ${whereClause}`,
+        params,
       );
     },
 
@@ -1816,7 +1545,7 @@ export const PlatformServiceMixin = {
 
         const settings = mappedResults[0] as Settings;
 
-        logger.debug(`[PlatformServiceMixin] Settings for DID ${did}:`, {
+        logger.info(`[PlatformServiceMixin] Settings for DID ${did}:`, {
           firstName: settings.firstName,
           isRegistered: settings.isRegistered,
           activeDid: settings.activeDid,
@@ -1843,7 +1572,7 @@ export const PlatformServiceMixin = {
       try {
         // Get default settings
         const defaultSettings = await this.$getMasterSettings({});
-        logger.debug(
+        logger.info(
           `[PlatformServiceMixin] Default settings:`,
           defaultSettings,
         );
@@ -1853,11 +1582,12 @@ export const PlatformServiceMixin = {
 
         // Get merged settings
         const mergedSettings = await this.$getMergedSettings(
+          MASTER_SETTINGS_KEY,
           did,
           defaultSettings || {},
         );
 
-        logger.debug(`[PlatformServiceMixin] Merged settings for ${did}:`, {
+        logger.info(`[PlatformServiceMixin] Merged settings for ${did}:`, {
           defaultSettings,
           didSettings,
           mergedSettings,
@@ -1887,20 +1617,14 @@ export interface IPlatformServiceMixin {
     params?: unknown[],
   ): Promise<QueryExecResult | undefined>;
   $dbExec(sql: string, params?: unknown[]): Promise<DatabaseExecResult>;
-  $dbGetOneRow(
-    sql: string,
-    params?: unknown[],
-  ): Promise<SqlValue[] | undefined>;
-  $dbRawQuery(sql: string, params?: unknown[]): Promise<unknown | undefined>;
+  $dbGetOneRow(sql: string, params?: unknown[]): Promise<unknown[] | undefined>;
   $getMasterSettings(fallback?: Settings | null): Promise<Settings | null>;
   $getMergedSettings(
     defaultKey: string,
     accountDid?: string,
     defaultFallback?: Settings,
   ): Promise<Settings>;
-  $getActiveIdentity(): Promise<{ activeDid: string }>;
   $withTransaction<T>(callback: () => Promise<T>): Promise<T>;
-  $getAvailableAccountDids(): Promise<string[]>;
   isCapacitor: boolean;
   isWeb: boolean;
   isElectron: boolean;
@@ -1994,7 +1718,7 @@ declare module "@vue/runtime-core" {
     // Ultra-concise database methods (shortest possible names)
     $db(sql: string, params?: unknown[]): Promise<QueryExecResult | undefined>;
     $exec(sql: string, params?: unknown[]): Promise<DatabaseExecResult>;
-    $one(sql: string, params?: unknown[]): Promise<SqlValue[] | undefined>;
+    $one(sql: string, params?: unknown[]): Promise<unknown[] | undefined>;
 
     // Query + mapping combo methods
     $query<T = Record<string, unknown>>(
@@ -2016,16 +1740,13 @@ declare module "@vue/runtime-core" {
       sql: string,
       params?: unknown[],
     ): Promise<unknown[] | undefined>;
-    $dbRawQuery(sql: string, params?: unknown[]): Promise<unknown | undefined>;
     $getMasterSettings(defaults?: Settings | null): Promise<Settings | null>;
     $getMergedSettings(
       key: string,
       did?: string,
       defaults?: Settings,
     ): Promise<Settings>;
-    $getActiveIdentity(): Promise<{ activeDid: string }>;
     $withTransaction<T>(fn: () => Promise<T>): Promise<T>;
-    $getAvailableAccountDids(): Promise<string[]>;
 
     // Specialized shortcuts - contacts cached, settings fresh
     $contacts(): Promise<Contact[]>;

src/utils/logger.ts

@@ -59,27 +59,10 @@ type LogLevel = keyof typeof LOG_LEVELS;
 
 // Parse VITE_LOG_LEVEL environment variable
 const getLogLevel = (): LogLevel => {
-  // Try to get VITE_LOG_LEVEL from different sources
-  let envLogLevel: string | undefined;
+  const envLogLevel = process.env.VITE_LOG_LEVEL?.toLowerCase();
 
-  try {
-    // In browser/Vite environment, use import.meta.env
-    if (
-      typeof import.meta !== "undefined" &&
-      import.meta?.env?.VITE_LOG_LEVEL
-    ) {
-      envLogLevel = import.meta.env.VITE_LOG_LEVEL;
-    }
-    // Fallback to process.env for Node.js environments
-    else if (process.env.VITE_LOG_LEVEL) {
-      envLogLevel = process.env.VITE_LOG_LEVEL;
-    }
-  } catch (error) {
-    // Silently handle cases where import.meta is not available
-  }
-
-  if (envLogLevel && envLogLevel.toLowerCase() in LOG_LEVELS) {
-    return envLogLevel.toLowerCase() as LogLevel;
+  if (envLogLevel && envLogLevel in LOG_LEVELS) {
+    return envLogLevel as LogLevel;
   }
 
   // Default log levels based on environment

src/utils/seedPhraseReminder.ts

@@ -1,90 +0,0 @@
-import { NotificationIface } from "@/constants/app";
-
-const SEED_REMINDER_KEY = "seedPhraseReminderLastShown";
-const REMINDER_COOLDOWN_MS = 24 * 60 * 60 * 1000; // 24 hours in milliseconds
-
-/**
- * Checks if the seed phrase backup reminder should be shown
- * @param hasBackedUpSeed - Whether the user has backed up their seed phrase
- * @returns true if the reminder should be shown, false otherwise
- */
-export function shouldShowSeedReminder(hasBackedUpSeed: boolean): boolean {
-  // Don't show if user has already backed up
-  if (hasBackedUpSeed) {
-    return false;
-  }
-
-  // Check localStorage for last shown time
-  const lastShown = localStorage.getItem(SEED_REMINDER_KEY);
-  if (!lastShown) {
-    return true; // First time, show the reminder
-  }
-
-  try {
-    const lastShownTime = parseInt(lastShown, 10);
-    const now = Date.now();
-    const timeSinceLastShown = now - lastShownTime;
-
-    // Show if more than 24 hours have passed
-    return timeSinceLastShown >= REMINDER_COOLDOWN_MS;
-  } catch (error) {
-    // If there's an error parsing the timestamp, show the reminder
-    return true;
-  }
-}
-
-/**
- * Marks the seed phrase reminder as shown by updating localStorage
- */
-export function markSeedReminderShown(): void {
-  localStorage.setItem(SEED_REMINDER_KEY, Date.now().toString());
-}
-
-/**
- * Creates the seed phrase backup reminder notification
- * @returns NotificationIface configuration for the reminder modal
- */
-export function createSeedReminderNotification(): NotificationIface {
-  return {
-    group: "modal",
-    type: "confirm",
-    title: "Backup Your Identifier Seed?",
-    text: "It looks like you haven't backed up your identifier seed yet. It's important to back it up as soon as possible to secure your identity.",
-    yesText: "Backup Identifier Seed",
-    noText: "Remind me Later",
-    onYes: async () => {
-      // Navigate to seed backup page
-      window.location.href = "/seed-backup";
-    },
-    onNo: async () => {
-      // Mark as shown so it won't appear again for 24 hours
-      markSeedReminderShown();
-    },
-    onCancel: async () => {
-      // Mark as shown so it won't appear again for 24 hours
-      markSeedReminderShown();
-    },
-  };
-}
-
-/**
- * Shows the seed phrase backup reminder if conditions are met
- * @param hasBackedUpSeed - Whether the user has backed up their seed phrase
- * @param notifyFunction - Function to show notifications
- * @returns true if the reminder was shown, false otherwise
- */
-export function showSeedPhraseReminder(
-  hasBackedUpSeed: boolean,
-  notifyFunction: (notification: NotificationIface, timeout?: number) => void,
-): boolean {
-  if (shouldShowSeedReminder(hasBackedUpSeed)) {
-    const notification = createSeedReminderNotification();
-    // Add 1-second delay before showing the modal to allow success message to be visible
-    setTimeout(() => {
-      // Pass -1 as timeout to ensure modal stays open until user interaction
-      notifyFunction(notification, -1);
-    }, 1000);
-    return true;
-  }
-  return false;
-}

src/views/AccountViewView.vue

@@ -27,7 +27,7 @@
         need an identifier.
       </p>
       <router-link
-        :to="{ name: 'new-identifier' }"
+        :to="{ name: 'start' }"
         class="inline-block text-md bg-gradient-to-b from-blue-400 to-blue-700 shadow-[inset_0_-1px_0_0_rgba(0,0,0,0.5)] text-white px-4 py-2 rounded-md"
       >
         Create An Identifier
@@ -764,7 +764,7 @@ import { IIdentifier } from "@veramo/core";
 import { ref } from "vue";
 import { Component, Vue } from "vue-facing-decorator";
 import { RouteLocationNormalizedLoaded, Router } from "vue-router";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 import { LMap, LMarker, LTileLayer } from "@vue-leaflet/vue-leaflet";
 import { Capacitor } from "@capacitor/core";
 
@@ -811,7 +811,6 @@ import { logger } from "../utils/logger";
 import { PlatformServiceMixin } from "../utils/PlatformServiceMixin";
 import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
 import { ACCOUNT_VIEW_CONSTANTS } from "@/constants/accountView";
-import { showSeedPhraseReminder } from "@/utils/seedPhraseReminder";
 import {
   AccountSettings,
   isApiError,
@@ -1051,11 +1050,7 @@ export default class AccountViewView extends Vue {
     // Then get the account-specific settings
     const settings: AccountSettings = await this.$accountSettings();
 
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
     this.apiServerInput = settings.apiServer || "";
     this.givenName =
@@ -1088,15 +1083,11 @@ export default class AccountViewView extends Vue {
   }
 
   // call fn, copy text to the clipboard, then redo fn after 2 seconds
-  async doCopyTwoSecRedo(text: string, fn: () => void): Promise<void> {
+  doCopyTwoSecRedo(text: string, fn: () => void): void {
     fn();
-    try {
-      await copyToClipboard(text);
-      setTimeout(fn, 2000);
-    } catch (error) {
-      this.$logAndConsole(`Error copying to clipboard: ${error}`, true);
-      this.notify.error("Failed to copy to clipboard.");
-    }
+    useClipboard()
+      .copy(text)
+      .then(() => setTimeout(fn, 2000));
   }
 
   async toggleShowContactAmounts(): Promise<void> {
@@ -1450,11 +1441,12 @@ export default class AccountViewView extends Vue {
         this.DEFAULT_IMAGE_API_SERVER,
       );
 
-      if (imageResp && imageResp.status === 200) {
+      if (imageResp.status === 200) {
         this.imageLimits = imageResp.data;
       } else {
         this.limitsMessage = ACCOUNT_VIEW_CONSTANTS.LIMITS.NO_IMAGE_ACCESS;
         this.notify.warning(ACCOUNT_VIEW_CONSTANTS.LIMITS.CANNOT_UPLOAD_IMAGES);
+        return;
       }
 
       const endorserResp = await fetchEndorserRateLimits(
@@ -1468,6 +1460,7 @@ export default class AccountViewView extends Vue {
       } else {
         this.limitsMessage = ACCOUNT_VIEW_CONSTANTS.LIMITS.NO_LIMITS_FOUND;
         this.notify.warning(ACCOUNT_VIEW_CONSTANTS.LIMITS.BAD_SERVER_RESPONSE);
+        return;
       }
     } catch (error) {
       this.limitsMessage =
@@ -1484,7 +1477,6 @@ export default class AccountViewView extends Vue {
         error: error instanceof Error ? error.message : String(error),
         did: did,
         apiServer: this.apiServer,
-        imageServer: this.DEFAULT_IMAGE_API_SERVER,
         partnerApiServer: this.partnerApiServer,
         errorCode: axiosError?.response?.data?.error?.code,
         errorMessage: axiosError?.response?.data?.error?.message,
@@ -1703,14 +1695,6 @@ export default class AccountViewView extends Vue {
       );
       if (success) {
         this.notify.success(ACCOUNT_VIEW_CONSTANTS.SUCCESS.PROFILE_SAVED);
-
-        // Show seed phrase backup reminder if needed
-        try {
-          const settings = await this.$accountSettings();
-          showSeedPhraseReminder(!!settings.hasBackedUpSeed, this.$notify);
-        } catch (error) {
-          logger.error("Error checking seed backup status:", error);
-        }
       } else {
         this.notify.error(ACCOUNT_VIEW_CONSTANTS.ERRORS.PROFILE_SAVE_ERROR);
       }
@@ -1999,7 +1983,7 @@ export default class AccountViewView extends Vue {
         error: error instanceof Error ? error.message : String(error),
         timestamp: new Date().toISOString(),
       });
-      return null;
+      throw new Error("Failed to load profile");
     }
   }
 

src/views/ClaimAddRawView.vue

@@ -41,7 +41,6 @@ import { Router, RouteLocationNormalizedLoaded } from "vue-router";
 import { logger } from "../utils/logger";
 import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
 import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
-import { showSeedPhraseReminder } from "@/utils/seedPhraseReminder";
 
 // Type guard for API responses
 function isApiResponse(response: unknown): response is AxiosResponse {
@@ -113,12 +112,7 @@ export default class ClaimAddRawView extends Vue {
    */
   private async initializeSettings() {
     const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
   }
 
@@ -229,14 +223,6 @@ export default class ClaimAddRawView extends Vue {
     );
     if (result.success) {
       this.notify.success("Claim submitted.", TIMEOUTS.LONG);
-
-      // Show seed phrase backup reminder if needed
-      try {
-        const settings = await this.$accountSettings();
-        showSeedPhraseReminder(!!settings.hasBackedUpSeed, this.$notify);
-      } catch (error) {
-        logger.error("Error checking seed backup status:", error);
-      }
     } else {
       logger.error("Got error submitting the claim:", result);
       this.notify.error(

src/views/ClaimCertificateView.vue

@@ -40,12 +40,7 @@ export default class ClaimCertificateView extends Vue {
   async created() {
     this.notify = createNotifyHelpers(this.$notify);
     const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
     const pathParams = window.location.pathname.substring(
       "/claim-cert/".length,

src/views/ClaimReportCertificateView.vue

@@ -53,13 +53,8 @@ export default class ClaimReportCertificateView extends Vue {
     // Initialize notification helper
     this.notify = createNotifyHelpers(this.$notify);
 
-    const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    const settings = await this.$settings();
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
     const pathParams = window.location.pathname.substring(
       "/claim-cert/".length,

src/views/ClaimView.vue

@@ -24,9 +24,7 @@
           <div class="flex columns-3">
             <h2 class="text-md font-bold w-full">
               {{
-                serverUtil.capitalizeAndInsertSpacesBeforeCaps(
-                  veriClaim.claimType || "",
-                )
+                capitalizeAndInsertSpacesBeforeCaps(veriClaim.claimType || "")
               }}
               <button
                 v-if="canEditClaim"
@@ -58,7 +56,7 @@
                 title="Copy Printable Certificate Link"
                 aria-label="Copy printable certificate link"
                 @click="
-                  copyTextToClipboard(
+                  copyToClipboard(
                     'A link to the certificate page',
                     `${APP_SERVER}/deep-link/claim-cert/${veriClaim.id}`,
                   )
@@ -72,9 +70,7 @@
               <button
                 title="Copy Link"
                 aria-label="Copy page link"
-                @click="
-                  copyTextToClipboard('A link to this page', windowDeepLink)
-                "
+                @click="copyToClipboard('A link to this page', windowDeepLink)"
               >
                 <font-awesome icon="link" class="text-slate-500" />
               </button>
@@ -110,91 +106,77 @@
             </div>
 
             <!-- Fullfills Links -->
-            <div class="mt-4 empty:hidden">
-              <!-- fullfills links for a give -->
-              <div v-if="detailsForGive?.fulfillsPlanHandleId">
-                <router-link
-                  :to="
-                    '/project/' +
-                    encodeURIComponent(detailsForGive?.fulfillsPlanHandleId)
-                  "
-                  class="text-blue-500 mt-2"
-                >
-                  This fulfills a bigger plan
-                  <font-awesome
-                    icon="arrow-up-right-from-square"
-                    class="fa-fw"
-                  />
-                </router-link>
-              </div>
 
-              <!-- Show offer fulfillment if this give fulfills an offer -->
-              <div v-if="detailsForGiveOfferFulfillment?.offerHandleId">
-                <!-- router-link to /claim/ only changes URL path -->
-                <a
-                  class="text-blue-500 mt-4 cursor-pointer"
-                  @click="
-                    showDifferentClaimPage(
-                      detailsForGiveOfferFulfillment.offerHandleId,
-                    )
-                  "
-                >
-                  This fulfills
-                  {{
-                    serverUtil.capitalizeAndInsertSpacesBeforeCapsWithAPrefix(
-                      detailsForGiveOfferFulfillment.offerType || "Offer",
-                    )
-                  }}
-                  <font-awesome
-                    icon="arrow-up-right-from-square"
-                    class="fa-fw"
-                  />
-                </a>
-              </div>
+            <!-- fullfills links for a give -->
+            <div v-if="detailsForGive?.fulfillsPlanHandleId" class="mt-4">
+              <router-link
+                :to="
+                  '/project/' +
+                  encodeURIComponent(detailsForGive?.fulfillsPlanHandleId)
+                "
+                class="text-blue-500 mt-2"
+              >
+                Fulfills a bigger plan...
+              </router-link>
+            </div>
+            <!-- if there's another, it's probably fulfilling an offer, too -->
+            <div
+              v-if="
+                detailsForGive?.fulfillsType &&
+                detailsForGive?.fulfillsType !== 'PlanAction' &&
+                detailsForGive?.fulfillsHandleId
+              "
+            >
+              <!-- router-link to /claim/ only changes URL path -->
+              <a
+                class="text-blue-500 mt-4 cursor-pointer"
+                @click="
+                  showDifferentClaimPage(detailsForGive?.fulfillsHandleId)
+                "
+              >
+                Fulfills
+                {{
+                  capitalizeAndInsertSpacesBeforeCaps(
+                    detailsForGive.fulfillsType,
+                  )
+                }}...
+              </a>
+            </div>
 
-              <!-- fullfills links for an offer -->
-              <div v-if="detailsForOffer?.fulfillsPlanHandleId">
-                <router-link
-                  :to="
-                    '/project/' +
-                    encodeURIComponent(detailsForOffer?.fulfillsPlanHandleId)
-                  "
-                  class="text-blue-500 mt-4"
-                >
-                  Offered to a bigger plan
-                  <font-awesome
-                    icon="arrow-up-right-from-square"
-                    class="fa-fw"
-                  />
-                </router-link>
-              </div>
+            <!-- fullfills links for an offer -->
+            <div v-if="detailsForOffer?.fulfillsPlanHandleId">
+              <router-link
+                :to="
+                  '/project/' +
+                  encodeURIComponent(detailsForOffer?.fulfillsPlanHandleId)
+                "
+                class="text-blue-500 mt-4"
+              >
+                Offered to a bigger plan...
+              </router-link>
+            </div>
 
-              <!-- Providers -->
-              <div v-if="providersForGive?.length > 0">
-                <span>Other assistance provided by:</span>
-                <ul class="ml-4">
-                  <li
-                    v-for="provider of providersForGive"
-                    :key="provider.identifier"
-                    class="list-disc ml-4"
-                  >
-                    <div class="flex gap-4">
-                      <div class="grow overflow-hidden">
-                        <a
-                          class="text-blue-500 mt-4 cursor-pointer"
-                          @click="handleProviderClick(provider)"
-                        >
-                          an activity
-                          <font-awesome
-                            icon="arrow-up-right-from-square"
-                            class="fa-fw"
-                          />
-                        </a>
-                      </div>
+            <!-- Providers -->
+            <div v-if="providersForGive?.length > 0" class="mt-4">
+              <span>Other assistance provided by:</span>
+              <ul class="ml-4">
+                <li
+                  v-for="provider of providersForGive"
+                  :key="provider.identifier"
+                  class="list-disc ml-4"
+                >
+                  <div class="flex gap-4">
+                    <div class="grow overflow-hidden">
+                      <a
+                        class="text-blue-500 mt-4 cursor-pointer"
+                        @click="handleProviderClick(provider)"
+                      >
+                        an activity...
+                      </a>
                     </div>
-                  </li>
-                </ul>
-              </div>
+                  </div>
+                </li>
+              </ul>
             </div>
           </div>
         </div>
@@ -401,7 +383,7 @@
           contacts can see more details:
           <a
             class="text-blue-500"
-            @click="copyTextToClipboard('A link to this page', windowDeepLink)"
+            @click="copyToClipboard('A link to this page', windowDeepLink)"
             >click to copy this page info</a
           >
           and see if they can make an introduction. Someone is connected to
@@ -424,7 +406,7 @@
           If you'd like an introduction,
           <a
             class="text-blue-500"
-            @click="copyTextToClipboard('A link to this page', windowDeepLink)"
+            @click="copyToClipboard('A link to this page', windowDeepLink)"
             >share this page with them and ask if they'll tell you more about
             about the participants.</a
           >
@@ -534,7 +516,7 @@ import * as yaml from "js-yaml";
 import * as R from "ramda";
 import { Component, Vue } from "vue-facing-decorator";
 import { Router, RouteLocationNormalizedLoaded } from "vue-router";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 import { GenericVerifiableCredential } from "../interfaces";
 import GiftedDialog from "../components/GiftedDialog.vue";
 import QuickNav from "../components/QuickNav.vue";
@@ -574,17 +556,6 @@ export default class ClaimView extends Vue {
     fulfillsPlanHandleId?: string;
     fulfillsType?: string;
     fulfillsHandleId?: string;
-    fullClaim?: {
-      fulfills?: Array<{
-        "@type": string;
-        identifier?: string;
-      }>;
-    };
-  } | null = null;
-  // Additional offer information extracted from the fulfills array
-  detailsForGiveOfferFulfillment: {
-    offerHandleId?: string;
-    offerType?: string;
   } | null = null;
   detailsForOffer: { fulfillsPlanHandleId?: string } | null = null;
   // Project information for fulfillsPlanHandleId
@@ -718,7 +689,6 @@ export default class ClaimView extends Vue {
     this.confsVisibleToIdList = [];
     this.detailsForGive = null;
     this.detailsForOffer = null;
-    this.detailsForGiveOfferFulfillment = null;
     this.projectInfo = null;
     this.fullClaim = null;
     this.fullClaimDump = "";
@@ -731,15 +701,6 @@ export default class ClaimView extends Vue {
     this.veriClaimDidsVisible = {};
   }
 
-  /**
-   * Extract offer fulfillment information from the fulfills array
-   */
-  extractOfferFulfillment() {
-    this.detailsForGiveOfferFulfillment = libsUtil.extractOfferFulfillment(
-      this.detailsForGive?.fullClaim?.fulfills,
-    );
-  }
-
   // =================================================
   // UTILITY METHODS
   // =================================================
@@ -767,11 +728,7 @@ export default class ClaimView extends Vue {
 
     const settings = await this.$accountSettings();
 
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
     this.allContacts = await this.$contacts();
 
@@ -801,6 +758,13 @@ export default class ClaimView extends Vue {
     this.canShare = !!navigator.share;
   }
 
+  // insert a space before any capital letters except the initial letter
+  // (and capitalize initial letter, just in case)
+  capitalizeAndInsertSpacesBeforeCaps(text: string): string {
+    if (!text) return "";
+    return text[0].toUpperCase() + text.substr(1).replace(/([A-Z])/g, " $1");
+  }
+
   totalConfirmers() {
     return (
       this.numConfsNotVisible +
@@ -857,8 +821,6 @@ export default class ClaimView extends Vue {
         });
         if (giveResp.status === 200 && giveResp.data.data?.length > 0) {
           this.detailsForGive = giveResp.data.data[0];
-          // Extract offer information from the fulfills array
-          this.extractOfferFulfillment();
         } else {
           await this.$logError(
             "Error getting detailed give info: " + JSON.stringify(giveResp),
@@ -1135,21 +1097,16 @@ export default class ClaimView extends Vue {
     );
   }
 
-  async copyTextToClipboard(name: string, text: string) {
-    try {
-      await copyToClipboard(text);
-      this.notify.copied(name || "That");
-    } catch (error) {
-      this.$logAndConsole(
-        `Error copying ${name || "content"} to clipboard: ${error}`,
-        true,
-      );
-      this.notify.error(`Failed to copy ${name || "content"} to clipboard.`);
-    }
+  copyToClipboard(name: string, text: string) {
+    useClipboard()
+      .copy(text)
+      .then(() => {
+        this.notify.copied(name || "That");
+      });
   }
 
   onClickShareClaim() {
-    this.copyTextToClipboard("A link to this page", this.windowDeepLink);
+    this.copyToClipboard("A link to this page", this.windowDeepLink);
     window.navigator.share({
       title: "Help Connect Me",
       text: "I'm trying to find the people who recorded this. Can you help me?",

src/views/ConfirmGiftView.vue

@@ -96,50 +96,50 @@
               </div>
 
               <!-- Fullfills Links -->
-              <div class="mt-4">
-                <!-- fullfills links for a give -->
-                <div v-if="giveDetails?.fulfillsPlanHandleId">
-                  <router-link
-                    :to="
-                      '/project/' +
-                      encodeURIComponent(
-                        giveDetails?.fulfillsPlanHandleId || '',
-                      )
-                    "
-                    class="text-blue-500 mt-2 cursor-pointer"
-                  >
-                    This fulfills a bigger plan
-                    <font-awesome
-                      icon="arrow-up-right-from-square"
-                      class="fa-fw"
-                    />
-                  </router-link>
-                </div>
 
-                <!-- Show offer fulfillment if this give fulfills an offer -->
-                <div v-if="giveDetailsOfferFulfillment?.offerHandleId">
-                  <!-- router-link to /claim/ only changes URL path -->
-                  <router-link
-                    :to="
-                      '/claim/' +
-                      encodeURIComponent(
-                        giveDetailsOfferFulfillment.offerHandleId || '',
-                      )
-                    "
-                    class="text-blue-500 mt-2 cursor-pointer"
-                  >
-                    This fulfills
-                    {{
-                      serverUtil.capitalizeAndInsertSpacesBeforeCapsWithAPrefix(
-                        giveDetailsOfferFulfillment.offerType || "Offer",
-                      )
-                    }}
-                    <font-awesome
-                      icon="arrow-up-right-from-square"
-                      class="fa-fw"
-                    />
-                  </router-link>
-                </div>
+              <!-- fullfills links for a give -->
+              <div v-if="giveDetails?.fulfillsPlanHandleId" class="mt-2">
+                <router-link
+                  :to="
+                    '/project/' +
+                    encodeURIComponent(giveDetails?.fulfillsPlanHandleId || '')
+                  "
+                  class="text-blue-500 mt-2 cursor-pointer"
+                >
+                  This fulfills a bigger plan
+                  <font-awesome
+                    icon="arrow-up-right-from-square"
+                    class="fa-fw"
+                  />
+                </router-link>
+              </div>
+              <!-- if there's another, it's probably fulfilling an offer, too -->
+              <div
+                v-if="
+                  giveDetails?.fulfillsType &&
+                  giveDetails?.fulfillsType !== 'PlanAction' &&
+                  giveDetails?.fulfillsHandleId
+                "
+              >
+                <!-- router-link to /claim/ only changes URL path -->
+                <router-link
+                  :to="
+                    '/claim/' +
+                    encodeURIComponent(giveDetails?.fulfillsHandleId || '')
+                  "
+                  class="text-blue-500 mt-2 cursor-pointer"
+                >
+                  This fulfills
+                  {{
+                    capitalizeAndInsertSpacesBeforeCapsWithAPrefix(
+                      giveDetails?.fulfillsType || "",
+                    )
+                  }}
+                  <font-awesome
+                    icon="arrow-up-right-from-square"
+                    class="fa-fw"
+                  />
+                </router-link>
               </div>
             </div>
           </div>
@@ -192,7 +192,7 @@
                       <span v-if="!serverUtil.isEmptyOrHiddenDid(confirmerId)">
                         <button
                           @click="
-                            copyTextToClipboard(
+                            copyToClipboard(
                               'The DID of ' + confirmerId,
                               confirmerId,
                             )
@@ -238,7 +238,7 @@
                       >
                         <button
                           @click="
-                            copyTextToClipboard(
+                            copyToClipboard(
                               'The DID of ' + confsVisibleTo,
                               confsVisibleTo,
                             )
@@ -309,9 +309,7 @@
             contacts can see more details:
             <a
               class="text-blue-500"
-              @click="
-                copyTextToClipboard('A link to this page', windowLocation)
-              "
+              @click="copyToClipboard('A link to this page', windowLocation)"
               >click to copy this page info</a
             >
             and see if they can make an introduction. Someone is connected to
@@ -334,9 +332,7 @@
             If you'd like an introduction,
             <a
               class="text-blue-500"
-              @click="
-                copyTextToClipboard('A link to this page', windowLocation)
-              "
+              @click="copyToClipboard('A link to this page', windowLocation)"
               >share this page with them and ask if they'll tell you more about
               about the participants.</a
             >
@@ -364,7 +360,7 @@
                       <span v-if="!serverUtil.isEmptyOrHiddenDid(visDid)">
                         <button
                           @click="
-                            copyTextToClipboard('The DID of ' + visDid, visDid)
+                            copyToClipboard('The DID of ' + visDid, visDid)
                           "
                         >
                           <font-awesome
@@ -437,7 +433,7 @@
 import * as yaml from "js-yaml";
 import * as R from "ramda";
 import { Component, Vue } from "vue-facing-decorator";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 import { RouteLocationNormalizedLoaded, Router } from "vue-router";
 import QuickNav from "../components/QuickNav.vue";
 import { NotificationIface } from "../constants/app";
@@ -497,11 +493,6 @@ export default class ConfirmGiftView extends Vue {
   confsVisibleErrorMessage = "";
   confsVisibleToIdList: string[] = []; // list of DIDs that can see any confirmer
   giveDetails?: GiveSummaryRecord;
-  // Additional offer information extracted from the fulfills array
-  giveDetailsOfferFulfillment: {
-    offerHandleId?: string;
-    offerType?: string;
-  } | null = null;
   giverName = "";
   issuerName = "";
   isLoading = false;
@@ -556,12 +547,7 @@ export default class ConfirmGiftView extends Vue {
    */
   private async initializeSettings() {
     const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
     this.allContacts = await this.$getAllContacts();
     this.isRegistered = settings.isRegistered || false;
@@ -662,8 +648,6 @@ export default class ConfirmGiftView extends Vue {
 
       if (resp.status === 200) {
         this.giveDetails = resp.data.data[0];
-        // Extract offer information from the fulfills array
-        this.extractOfferFulfillment();
       } else {
         throw new Error("Error getting detailed give info: " + resp.status);
       }
@@ -723,15 +707,6 @@ export default class ConfirmGiftView extends Vue {
     }
   }
 
-  /**
-   * Extract offer fulfillment information from the fulfills array
-   */
-  private extractOfferFulfillment() {
-    this.giveDetailsOfferFulfillment = libsUtil.extractOfferFulfillment(
-      this.giveDetails?.fullClaim?.fulfills,
-    );
-  }
-
   /**
    * Fetches confirmer information for the claim
    */
@@ -788,21 +763,16 @@ export default class ConfirmGiftView extends Vue {
    * @param description - Description of copied content
    * @param text - Text to copy
    */
-  async copyTextToClipboard(description: string, text: string): Promise<void> {
-    try {
-      await copyToClipboard(text);
-      this.notify.toast(
-        NOTIFY_COPIED_TO_CLIPBOARD.title,
-        NOTIFY_COPIED_TO_CLIPBOARD.message(description),
-        TIMEOUTS.SHORT,
-      );
-    } catch (error) {
-      this.$logAndConsole(
-        `Error copying ${description} to clipboard: ${error}`,
-        true,
-      );
-      this.notify.error(`Failed to copy ${description} to clipboard.`);
-    }
+  copyToClipboard(description: string, text: string): void {
+    useClipboard()
+      .copy(text)
+      .then(() => {
+        this.notify.toast(
+          NOTIFY_COPIED_TO_CLIPBOARD.title,
+          NOTIFY_COPIED_TO_CLIPBOARD.message(description),
+          TIMEOUTS.SHORT,
+        );
+      });
   }
 
   /**
@@ -879,12 +849,33 @@ export default class ConfirmGiftView extends Vue {
     );
   }
 
+  /**
+   * Formats type string for display by adding spaces before capitals
+   * Optionally adds a prefix
+   *
+   * @param text - Text to format
+   * @param prefix - Optional prefix to add
+   * @returns Formatted string
+   */
+  capitalizeAndInsertSpacesBeforeCapsWithAPrefix(text: string): string {
+    const word = this.capitalizeAndInsertSpacesBeforeCaps(text);
+    if (word) {
+      // if the word starts with a vowel, use "an" instead of "a"
+      const firstLetter = word[0].toLowerCase();
+      const vowels = ["a", "e", "i", "o", "u"];
+      const particle = vowels.includes(firstLetter) ? "an" : "a";
+      return particle + " " + word;
+    } else {
+      return "";
+    }
+  }
+
   /**
    * Initiates sharing of claim information
    * Handles share functionality based on platform capabilities
    */
   async onClickShareClaim(): Promise<void> {
-    this.copyTextToClipboard("A link to this page", this.windowLocation);
+    this.copyToClipboard("A link to this page", this.windowLocation);
     window.navigator.share({
       title: "Help Connect Me",
       text: "I'm trying to find the full details of this claim. Can you help me?",
@@ -903,5 +894,11 @@ export default class ConfirmGiftView extends Vue {
     this.veriClaim = serverUtil.BLANK_GENERIC_SERVER_RECORD;
     this.veriClaimDump = "";
   }
+
+  capitalizeAndInsertSpacesBeforeCaps(text: string) {
+    return !text
+      ? ""
+      : text[0].toUpperCase() + text.substr(1).replace(/([A-Z])/g, " $1");
+  }
 }
 </script>

src/views/ContactAmountsView.vue

@@ -224,12 +224,7 @@ export default class ContactAmountssView extends Vue {
       this.contact = contact;
 
       const settings = await this.$getMasterSettings();
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-
+      this.activeDid = settings?.activeDid || "";
       this.apiServer = settings?.apiServer || "";
 
       if (this.activeDid && this.contact) {

src/views/ContactGiftingView.vue

@@ -164,11 +164,7 @@ export default class ContactGiftingView extends Vue {
     try {
       const settings = await this.$accountSettings();
       this.apiServer = settings.apiServer || "";
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
+      this.activeDid = settings.activeDid || "";
 
       this.allContacts = await this.$getAllContacts();
 

src/views/ContactImportView.vue

@@ -340,12 +340,7 @@ export default class ContactImportView extends Vue {
    */
   private async initializeSettings() {
     const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
   }
 

src/views/ContactQRScanFullView.vue

@@ -104,7 +104,7 @@ import { Buffer } from "buffer/";
 import QRCodeVue3 from "qr-code-generator-vue3";
 import { Component, Vue } from "vue-facing-decorator";
 import { Router } from "vue-router";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 
 import { logger } from "../utils/logger";
 import { QRScannerFactory } from "../services/QRScanner/QRScannerFactory";
@@ -144,7 +144,6 @@ import {
   QR_TIMEOUT_LONG,
 } from "@/constants/notifications";
 import { createNotifyHelpers, NotifyFunction } from "../utils/notify";
-import { showSeedPhraseReminder } from "@/utils/seedPhraseReminder";
 
 interface QRScanResult {
   rawValue?: string;
@@ -196,7 +195,7 @@ export default class ContactQRScanFull extends Vue {
   $router!: Router;
 
   // Notification helper system
-  private notify!: ReturnType<typeof createNotifyHelpers>;
+  private notify = createNotifyHelpers(this.$notify);
 
   isScanning = false;
   error: string | null = null;
@@ -264,17 +263,9 @@ export default class ContactQRScanFull extends Vue {
    * Loads user settings and generates QR code for contact sharing
    */
   async created() {
-    // Initialize notification helper system
-    this.notify = createNotifyHelpers(this.$notify);
-
     try {
       const settings = await this.$accountSettings();
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-
+      this.activeDid = settings.activeDid || "";
       this.apiServer = settings.apiServer || "";
       this.givenName = settings.firstName || "";
       this.isRegistered = !!settings.isRegistered;
@@ -398,7 +389,7 @@ export default class ContactQRScanFull extends Vue {
 
     this.isCleaningUp = true;
     try {
-      logger.debug("Cleaning up QR scanner resources");
+      logger.info("Cleaning up QR scanner resources");
       await this.stopScanning();
       await QRScannerFactory.cleanup();
     } catch (error) {
@@ -432,7 +423,7 @@ export default class ContactQRScanFull extends Vue {
         rawValue === this.lastScannedValue &&
         now - this.lastScanTime < this.SCAN_DEBOUNCE_MS
       ) {
-        logger.debug("Ignoring duplicate scan:", rawValue);
+        logger.info("Ignoring duplicate scan:", rawValue);
         return;
       }
 
@@ -440,7 +431,7 @@ export default class ContactQRScanFull extends Vue {
       this.lastScannedValue = rawValue;
       this.lastScanTime = now;
 
-      logger.debug("Processing QR code scan result:", rawValue);
+      logger.info("Processing QR code scan result:", rawValue);
 
       let contact: Contact;
       if (rawValue.includes(CONTACT_IMPORT_CONFIRM_URL_PATH_TIME_SAFARI)) {
@@ -453,7 +444,7 @@ export default class ContactQRScanFull extends Vue {
         }
 
         // Process JWT and contact info
-        logger.debug("Decoding JWT payload from QR code");
+        logger.info("Decoding JWT payload from QR code");
         const decodedJwt = await decodeEndorserJwt(jwt);
         if (!decodedJwt?.payload?.own) {
           logger.warn("Invalid JWT payload - missing 'own' field");
@@ -492,7 +483,7 @@ export default class ContactQRScanFull extends Vue {
       }
 
       // Add contact but keep scanning
-      logger.debug("Adding new contact to database:", {
+      logger.info("Adding new contact to database:", {
         did: contact.did,
         name: contact.name,
       });
@@ -551,7 +542,7 @@ export default class ContactQRScanFull extends Vue {
    */
   async addNewContact(contact: Contact) {
     try {
-      logger.debug("Opening database connection for new contact");
+      logger.info("Opening database connection for new contact");
 
       // Check if contact already exists
       const existingContact = await this.$getContact(contact.did);
@@ -565,7 +556,7 @@ export default class ContactQRScanFull extends Vue {
       await this.$insertContact(contact);
 
       if (this.activeDid) {
-        logger.debug("Setting contact visibility", { did: contact.did });
+        logger.info("Setting contact visibility", { did: contact.did });
         await this.setVisibility(contact, true);
         contact.seesMe = true;
       }
@@ -612,7 +603,7 @@ export default class ContactQRScanFull extends Vue {
   async handleAppPause() {
     if (!this.isMounted) return;
 
-    logger.debug("App paused, stopping scanner");
+    logger.info("App paused, stopping scanner");
     await this.stopScanning();
   }
 
@@ -622,7 +613,7 @@ export default class ContactQRScanFull extends Vue {
   handleAppResume() {
     if (!this.isMounted) return;
 
-    logger.debug("App resumed, scanner can be restarted by user");
+    logger.info("App resumed, scanner can be restarted by user");
     this.isScanning = false;
   }
 
@@ -631,15 +622,6 @@ export default class ContactQRScanFull extends Vue {
    */
   async handleBack() {
     await this.cleanupScanner();
-
-    // Show seed phrase backup reminder if needed
-    try {
-      const settings = await this.$accountSettings();
-      showSeedPhraseReminder(!!settings.hasBackedUpSeed, this.$notify);
-    } catch (error) {
-      logger.error("Error checking seed backup status:", error);
-    }
-
     this.$router.back();
   }
 
@@ -654,51 +636,36 @@ export default class ContactQRScanFull extends Vue {
    * Copies contact URL to clipboard for sharing
    */
   async onCopyUrlToClipboard() {
-    try {
-      const account = (await libsUtil.retrieveFullyDecryptedAccount(
-        this.activeDid,
-      )) as Account;
-      const jwtUrl = await generateEndorserJwtUrlForAccount(
-        account,
-        this.isRegistered,
-        this.givenName,
-        this.profileImageUrl,
-        true,
-      );
-
-      // Use the platform-specific ClipboardService for reliable iOS support
-      await copyToClipboard(jwtUrl);
-
-      this.notify.toast(
-        NOTIFY_QR_URL_COPIED.title,
-        NOTIFY_QR_URL_COPIED.message,
-        QR_TIMEOUT_MEDIUM,
-      );
-    } catch (error) {
-      logger.error("Error copying URL to clipboard:", {
-        error: error instanceof Error ? error.message : String(error),
-        stack: error instanceof Error ? error.stack : undefined,
+    const account = (await libsUtil.retrieveFullyDecryptedAccount(
+      this.activeDid,
+    )) as Account;
+    const jwtUrl = await generateEndorserJwtUrlForAccount(
+      account,
+      this.isRegistered,
+      this.givenName,
+      this.profileImageUrl,
+      true,
+    );
+    useClipboard()
+      .copy(jwtUrl)
+      .then(() => {
+        this.notify.toast(
+          NOTIFY_QR_URL_COPIED.title,
+          NOTIFY_QR_URL_COPIED.message,
+          QR_TIMEOUT_MEDIUM,
+        );
       });
-      this.notify.error("Failed to copy URL to clipboard.");
-    }
   }
 
   /**
    * Copies DID to clipboard for manual sharing
    */
-  async onCopyDidToClipboard() {
-    try {
-      // Use the platform-specific ClipboardService for reliable iOS support
-      await copyToClipboard(this.activeDid);
-
-      this.notify.info(NOTIFY_QR_DID_COPIED.message, QR_TIMEOUT_LONG);
-    } catch (error) {
-      logger.error("Error copying DID to clipboard:", {
-        error: error instanceof Error ? error.message : String(error),
-        stack: error instanceof Error ? error.stack : undefined,
+  onCopyDidToClipboard() {
+    useClipboard()
+      .copy(this.activeDid)
+      .then(() => {
+        this.notify.info(NOTIFY_QR_DID_COPIED.message, QR_TIMEOUT_LONG);
       });
-      this.notify.error("Failed to copy DID to clipboard.");
-    }
   }
 
   /**

src/views/ContactQRScanShowView.vue

@@ -140,7 +140,6 @@ import { AxiosError } from "axios";
 import { Buffer } from "buffer/";
 import QRCodeVue3 from "qr-code-generator-vue3";
 import { Component, Vue } from "vue-facing-decorator";
-import { copyToClipboard } from "../services/ClipboardService";
 
 import { QrcodeStream } from "vue-qrcode-reader";
 
@@ -164,7 +163,6 @@ import { QRScannerFactory } from "@/services/QRScanner/QRScannerFactory";
 import { CameraState } from "@/services/QRScanner/types";
 import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
 import { createNotifyHelpers } from "@/utils/notify";
-import { showSeedPhraseReminder } from "@/utils/seedPhraseReminder";
 import {
   NOTIFY_QR_INITIALIZATION_ERROR,
   NOTIFY_QR_CAMERA_IN_USE,
@@ -288,12 +286,7 @@ export default class ContactQRScanShow extends Vue {
 
     try {
       const settings = await this.$accountSettings();
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-
+      this.activeDid = settings.activeDid || "";
       this.apiServer = settings.apiServer || "";
       this.givenName = settings.firstName || "";
       this.hideRegisterPromptOnNewContact =
@@ -326,15 +319,6 @@ export default class ContactQRScanShow extends Vue {
 
   async handleBack(): Promise<void> {
     await this.cleanupScanner();
-
-    // Show seed phrase backup reminder if needed
-    try {
-      const settings = await this.$accountSettings();
-      showSeedPhraseReminder(!!settings.hasBackedUpSeed, this.$notify);
-    } catch (error) {
-      logger.error("Error checking seed backup status:", error);
-    }
-
     this.$router.back();
   }
 
@@ -433,7 +417,7 @@ export default class ContactQRScanShow extends Vue {
 
     this.isCleaningUp = true;
     try {
-      logger.debug("Cleaning up QR scanner resources");
+      logger.info("Cleaning up QR scanner resources");
       await this.stopScanning();
       await QRScannerFactory.cleanup();
     } catch (error) {
@@ -467,7 +451,7 @@ export default class ContactQRScanShow extends Vue {
         rawValue === this.lastScannedValue &&
         now - this.lastScanTime < this.SCAN_DEBOUNCE_MS
       ) {
-        logger.debug("Ignoring duplicate scan:", rawValue);
+        logger.info("Ignoring duplicate scan:", rawValue);
         return;
       }
 
@@ -475,7 +459,7 @@ export default class ContactQRScanShow extends Vue {
       this.lastScannedValue = rawValue;
       this.lastScanTime = now;
 
-      logger.debug("Processing QR code scan result:", rawValue);
+      logger.info("Processing QR code scan result:", rawValue);
 
       let contact: Contact;
       if (rawValue.includes(CONTACT_IMPORT_CONFIRM_URL_PATH_TIME_SAFARI)) {
@@ -485,7 +469,7 @@ export default class ContactQRScanShow extends Vue {
           this.notify.error(NOTIFY_QR_INVALID_QR_CODE.message);
           return;
         }
-        logger.debug("Decoding JWT payload from QR code");
+        logger.info("Decoding JWT payload from QR code");
         const decodedJwt = await decodeEndorserJwt(jwt);
 
         // Process JWT and contact info
@@ -520,7 +504,7 @@ export default class ContactQRScanShow extends Vue {
       }
 
       // Add contact but keep scanning
-      logger.debug("Adding new contact to database:", {
+      logger.info("Adding new contact to database:", {
         did: contact.did,
         name: contact.name,
       });
@@ -554,7 +538,7 @@ export default class ContactQRScanShow extends Vue {
   }
 
   async register(contact: Contact) {
-    logger.debug("Submitting contact registration", {
+    logger.info("Submitting contact registration", {
       did: contact.did,
       name: contact.name,
     });
@@ -570,7 +554,7 @@ export default class ContactQRScanShow extends Vue {
       if (regResult.success) {
         contact.registered = true;
         await this.$updateContact(contact.did, { registered: true });
-        logger.debug("Contact registration successful", { did: contact.did });
+        logger.info("Contact registration successful", { did: contact.did });
 
         this.notify.success(
           createQRRegistrationSuccessMessage(contact.name || ""),
@@ -634,6 +618,7 @@ export default class ContactQRScanShow extends Vue {
       );
 
       // Copy the URL to clipboard
+      const { copyToClipboard } = await import("../services/ClipboardService");
       await copyToClipboard(jwtUrl);
       this.notify.toast(
         NOTIFY_QR_URL_COPIED.title,
@@ -652,6 +637,7 @@ export default class ContactQRScanShow extends Vue {
   async onCopyDidToClipboard() {
     //this.onScanDetect([{ rawValue: this.qrValue }]); // good for testing
     try {
+      const { copyToClipboard } = await import("../services/ClipboardService");
       await copyToClipboard(this.activeDid);
       this.notify.info(NOTIFY_QR_DID_COPIED.message, QR_TIMEOUT_LONG);
     } catch (error) {
@@ -696,20 +682,20 @@ export default class ContactQRScanShow extends Vue {
   async handleAppPause() {
     if (!this.isMounted) return;
 
-    logger.debug("App paused, stopping scanner");
+    logger.info("App paused, stopping scanner");
     await this.stopScanning();
   }
 
   handleAppResume() {
     if (!this.isMounted) return;
 
-    logger.debug("App resumed, scanner can be restarted by user");
+    logger.info("App resumed, scanner can be restarted by user");
     this.isScanning = false;
   }
 
   async addNewContact(contact: Contact) {
     try {
-      logger.debug("Opening database connection for new contact");
+      logger.info("Opening database connection for new contact");
 
       // Check if contact already exists
       const existingContact = await this.$getContact(contact.did);
@@ -736,7 +722,7 @@ export default class ContactQRScanShow extends Vue {
       await this.$insertContact(contact);
 
       if (this.activeDid) {
-        logger.debug("Setting contact visibility", { did: contact.did });
+        logger.info("Setting contact visibility", { did: contact.did });
         await this.setVisibility(contact, true);
         contact.seesMe = true;
       }
@@ -752,17 +738,24 @@ export default class ContactQRScanShow extends Vue {
         !contact.registered
       ) {
         setTimeout(() => {
-          this.$notify(
+          this.notify.confirm(
+            "Do you want to register them?",
             {
-              group: "modal",
-              type: "confirm",
-              title: "Register",
-              text: "Do you want to register them?",
               onCancel: async (stopAsking?: boolean) => {
-                await this.handleRegistrationPromptResponse(stopAsking);
+                if (stopAsking) {
+                  await this.$updateSettings({
+                    hideRegisterPromptOnNewContact: stopAsking,
+                  });
+                  this.hideRegisterPromptOnNewContact = stopAsking;
+                }
               },
               onNo: async (stopAsking?: boolean) => {
-                await this.handleRegistrationPromptResponse(stopAsking);
+                if (stopAsking) {
+                  await this.$updateSettings({
+                    hideRegisterPromptOnNewContact: stopAsking,
+                  });
+                  this.hideRegisterPromptOnNewContact = stopAsking;
+                }
               },
               onYes: async () => {
                 await this.register(contact);
@@ -892,17 +885,6 @@ export default class ContactQRScanShow extends Vue {
       videoElement.style.transform = shouldMirror ? "scaleX(-1)" : "none";
     }
   }
-
-  private async handleRegistrationPromptResponse(
-    stopAsking?: boolean,
-  ): Promise<void> {
-    if (stopAsking) {
-      await this.$saveSettings({
-        hideRegisterPromptOnNewContact: stopAsking,
-      });
-      this.hideRegisterPromptOnNewContact = stopAsking;
-    }
-  }
 }
 </script>
 

src/views/ContactsView.vue

@@ -174,7 +174,7 @@ import { logger } from "../utils/logger";
 import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
 import { isDatabaseError } from "@/interfaces/common";
 import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
-import { APP_SERVER, DEFAULT_ENDORSER_API_SERVER } from "@/constants/app";
+import { APP_SERVER } from "@/constants/app";
 import { QRNavigationService } from "@/services/QRNavigationService";
 import {
   NOTIFY_CONTACT_NO_INFO,
@@ -294,19 +294,10 @@ export default class ContactsView extends Vue {
     this.notify = createNotifyHelpers(this.$notify);
 
     const settings = await this.$accountSettings();
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-    this.apiServer = settings.apiServer || DEFAULT_ENDORSER_API_SERVER;
+    this.activeDid = settings.activeDid || "";
+    this.apiServer = settings.apiServer || "";
     this.isRegistered = !!settings.isRegistered;
 
-    logger.debug("[ContactsView] Created with settings:", {
-      activeDid: this.activeDid,
-      apiServer: this.apiServer,
-      isRegistered: this.isRegistered,
-    });
-
     // if these detect a query parameter, they can and then redirect to this URL without a query parameter
     // to avoid problems when they reload or they go forward & back and it tries to reprocess
     await this.processContactJwt();
@@ -355,34 +346,15 @@ export default class ContactsView extends Vue {
       // this happens when a platform (eg iOS) doesn't include anything after the "=" in a shared link.
       this.notify.error(NOTIFY_BLANK_INVITE.message, TIMEOUTS.VERY_LONG);
     } else if (importedInviteJwt) {
-      logger.debug("[ContactsView] Processing invite JWT, current activeDid:", {
-        activeDid: this.activeDid,
-      });
-
-      // Re-fetch settings after ensuring active_identity is populated
-      const updatedSettings = await this.$accountSettings();
-      this.activeDid = updatedSettings.activeDid || "";
-      this.apiServer = updatedSettings.apiServer || DEFAULT_ENDORSER_API_SERVER;
-
       // Identity creation should be handled by router guard, but keep as fallback for invite processing
       if (!this.activeDid) {
         logger.info(
           "[ContactsView] No active DID found, creating identity as fallback for invite processing",
         );
         this.activeDid = await generateSaveAndActivateIdentity();
-        logger.info("[ContactsView] Created new identity:", {
-          activeDid: this.activeDid,
-        });
       }
       // send invite directly to server, with auth for this user
       const headers = await getHeaders(this.activeDid);
-      logger.debug("[ContactsView] Making API request to claim invite:", {
-        apiServer: this.apiServer,
-        activeDid: this.activeDid,
-        hasApiServer: !!this.apiServer,
-        apiServerLength: this.apiServer?.length || 0,
-        fullUrl: this.apiServer + "/api/v2/claim",
-      });
       try {
         const response = await this.axios.post(
           this.apiServer + "/api/v2/claim",
@@ -404,9 +376,6 @@ export default class ContactsView extends Vue {
         const payload: JWTPayload =
           decodeEndorserJwt(importedInviteJwt).payload;
         const registration = payload as VerifiableCredential;
-        logger.debug(
-          "[ContactsView] Opening ContactNameDialog for invite processing",
-        );
         (this.$refs.contactNameDialog as ContactNameDialog).open(
           "Who Invited You?",
           "",
@@ -445,28 +414,17 @@ export default class ContactsView extends Vue {
         this.$logAndConsole(fullError, true);
         let message = "Got an error sending the invite.";
         if (
-          error &&
-          typeof error === "object" &&
-          "response" in error &&
           error.response &&
-          typeof error.response === "object" &&
-          "data" in error.response &&
           error.response.data &&
-          typeof error.response.data === "object" &&
-          "error" in error.response.data
+          error.response.data.error
         ) {
-          const responseData = error.response.data as { error: unknown };
-          if (
-            responseData.error &&
-            typeof responseData.error === "object" &&
-            "message" in responseData.error
-          ) {
-            message = (responseData.error as { message: string }).message;
+          if (error.response.data.error.message) {
+            message = error.response.data.error.message;
           } else {
-            message = String(responseData.error);
+            message = error.response.data.error;
           }
-        } else if (error && typeof error === "object" && "message" in error) {
-          message = (error as { message: string }).message;
+        } else if (error.message) {
+          message = error.message;
         }
         this.notify.error(message, TIMEOUTS.MODAL);
       }

src/views/DIDView.vue

@@ -376,12 +376,7 @@ export default class DIDView extends Vue {
    */
   private async initializeSettings() {
     const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
   }
 

src/views/DatabaseMigration.vue

@@ -1003,7 +1003,7 @@
       <h2>Exported Data</h2>
       <span
         class="text-blue-500 cursor-pointer hover:text-blue-700"
-        @click="copyExportedDataToClipboard"
+        @click="copyToClipboard"
       >
         Copy to Clipboard
       </span>
@@ -1014,7 +1014,7 @@
 
 <script lang="ts">
 import { Component, Vue } from "vue-facing-decorator";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 import { Router } from "vue-router";
 
 import {
@@ -1072,6 +1072,8 @@ export default class DatabaseMigration extends Vue {
   private exportedData: Record<string, any> | null = null;
   private successMessage = "";
 
+  useClipboard = useClipboard;
+
   /**
    * Computed property to get the display name for a setting
    * Handles both live comparison data and exported JSON format
@@ -1131,11 +1133,13 @@ export default class DatabaseMigration extends Vue {
   /**
    * Copies exported data to clipboard and shows success message
    */
-  async copyExportedDataToClipboard(): Promise<void> {
+  async copyToClipboard(): Promise<void> {
     if (!this.exportedData) return;
 
     try {
-      await copyToClipboard(JSON.stringify(this.exportedData, null, 2));
+      await this.useClipboard().copy(
+        JSON.stringify(this.exportedData, null, 2),
+      );
       // Use global window object properly
       if (typeof window !== "undefined") {
         window.alert("Copied to clipboard!");
@@ -1261,7 +1265,7 @@ export default class DatabaseMigration extends Vue {
         this.comparison.differences.settings.added.length +
         this.comparison.differences.accounts.added.length;
       this.successMessage = `Comparison completed successfully. Found ${totalItems} items to migrate.`;
-      logger.debug(
+      logger.info(
         "[DatabaseMigration] Database comparison completed successfully",
       );
     } catch (error) {
@@ -1313,7 +1317,7 @@ export default class DatabaseMigration extends Vue {
           this.successMessage += ` ${result.warnings.length} warnings.`;
           this.warning += result.warnings.join(", ");
         }
-        logger.debug(
+        logger.info(
           "[DatabaseMigration] Settings migration completed successfully",
           result,
         );
@@ -1356,7 +1360,7 @@ export default class DatabaseMigration extends Vue {
           this.successMessage += ` ${result.warnings.length} warnings.`;
           this.warning += result.warnings.join(", ");
         }
-        logger.debug(
+        logger.info(
           "[DatabaseMigration] Account migration completed successfully",
           result,
         );
@@ -1406,7 +1410,7 @@ export default class DatabaseMigration extends Vue {
       URL.revokeObjectURL(url);
 
       this.successMessage = "Comparison data exported successfully";
-      logger.debug("[DatabaseMigration] Comparison data exported successfully");
+      logger.info("[DatabaseMigration] Comparison data exported successfully");
     } catch (error) {
       this.error = `Failed to export comparison data: ${error}`;
       logger.error("[DatabaseMigration] Export failed:", error);

src/views/DiscoverView.vue

@@ -415,11 +415,7 @@ export default class DiscoverView extends Vue {
     const searchPeople = !!this.$route.query["searchPeople"];
 
     const settings = await this.$accountSettings();
-
-    // Get activeDid from new active_identity table (ActiveDid migration)
-    const activeIdentity = await this.$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = (settings.activeDid as string) || "";
     this.apiServer = (settings.apiServer as string) || "";
     this.partnerApiServer =
       (settings.partnerApiServer as string) || this.partnerApiServer;

src/views/GiftedDetailsView.vue

@@ -280,7 +280,6 @@ import { logger } from "../utils/logger";
 import { Contact } from "@/db/tables/contacts";
 import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
 import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
-import { showSeedPhraseReminder } from "@/utils/seedPhraseReminder";
 import {
   NOTIFY_GIFTED_DETAILS_RETRIEVAL_ERROR,
   NOTIFY_GIFTED_DETAILS_DELETE_IMAGE_CONFIRM,
@@ -442,11 +441,7 @@ export default class GiftedDetails extends Vue {
 
     const settings = await this.$accountSettings();
     this.apiServer = settings.apiServer || "";
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
+    this.activeDid = settings.activeDid || "";
 
     if (
       (this.giverDid && !this.giverName) ||
@@ -775,15 +770,6 @@ export default class GiftedDetails extends Vue {
           NOTIFY_GIFTED_DETAILS_GIFT_RECORDED.message,
           TIMEOUTS.SHORT,
         );
-
-        // Show seed phrase backup reminder if needed
-        try {
-          const settings = await this.$accountSettings();
-          showSeedPhraseReminder(!!settings.hasBackedUpSeed, this.$notify);
-        } catch (error) {
-          logger.error("Error checking seed backup status:", error);
-        }
-
         localStorage.removeItem("imageUrl");
         if (this.destinationPathAfter) {
           (this.$router as Router).push({ path: this.destinationPathAfter });

src/views/HelpView.vue

@@ -584,16 +584,15 @@
 <script lang="ts">
 import { Component, Vue } from "vue-facing-decorator";
 import { Router } from "vue-router";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 // Capacitor import removed - using QRNavigationService instead
 
 import * as Package from "../../package.json";
 import QuickNav from "../components/QuickNav.vue";
-import { APP_SERVER, NotificationIface } from "../constants/app";
+import { APP_SERVER } from "../constants/app";
 import { PlatformServiceMixin } from "@/utils/PlatformServiceMixin";
 import { QRNavigationService } from "@/services/QRNavigationService";
 import { UNNAMED_ENTITY_NAME } from "@/constants/entities";
-import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
 
 /**
  * HelpView.vue - Comprehensive Help System Component
@@ -627,10 +626,8 @@ import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
 })
 export default class HelpView extends Vue {
   $router!: Router;
-  $notify!: (notification: NotificationIface, timeout?: number) => void;
 
   package = Package;
-  notify!: ReturnType<typeof createNotifyHelpers>;
   commitHash = import.meta.env.VITE_GIT_HASH;
   showAlpha = false;
   showBasics = false;
@@ -643,13 +640,6 @@ export default class HelpView extends Vue {
   APP_SERVER = APP_SERVER;
   // Capacitor reference removed - using QRNavigationService instead
 
-  /**
-   * Initialize notification helpers
-   */
-  created() {
-    this.notify = createNotifyHelpers(this.$notify);
-  }
-
   /**
    * Get the unnamed entity name constant
    */
@@ -670,15 +660,11 @@ export default class HelpView extends Vue {
    * @param {string} text - The text to copy to clipboard
    * @param {Function} fn - Callback function to execute before and after copying
    */
-  async doCopyTwoSecRedo(text: string, fn: () => void): Promise<void> {
+  doCopyTwoSecRedo(text: string, fn: () => void): void {
     fn();
-    try {
-      await copyToClipboard(text);
-      setTimeout(fn, 2000);
-    } catch (error) {
-      this.$logAndConsole(`Error copying to clipboard: ${error}`, true);
-      this.notify.error("Failed to copy to clipboard.", TIMEOUTS.SHORT);
-    }
+    useClipboard()
+      .copy(text)
+      .then(() => setTimeout(fn, 2000));
   }
 
   /**
@@ -694,10 +680,7 @@ export default class HelpView extends Vue {
     try {
       const settings = await this.$accountSettings();
 
-      // Get activeDid from new active_identity table (ActiveDid migration)
-      const activeIdentity = await this.$getActiveIdentity();
-
-      if (activeIdentity.activeDid) {
+      if (settings.activeDid) {
         await this.$updateSettings({
           ...settings,
           finishedOnboarding: false,
@@ -705,7 +688,7 @@ export default class HelpView extends Vue {
 
         this.$log(
           "[HelpView] Onboarding reset successfully for DID: " +
-            activeIdentity.activeDid,
+            settings.activeDid,
         );
       }
 

src/views/HomeView.vue

@@ -238,7 +238,7 @@ Raymer * @version 1.0.0 */
 
 <script lang="ts">
 import { UAParser } from "ua-parser-js";
-import { Component, Vue, Watch } from "vue-facing-decorator";
+import { Component, Vue } from "vue-facing-decorator";
 import { Router } from "vue-router";
 
 //import App from "../App.vue";
@@ -283,7 +283,6 @@ import { createNotifyHelpers, TIMEOUTS } from "@/utils/notify";
 import { NOTIFY_CONTACT_LOADING_ISSUE } from "@/constants/notifications";
 import * as Package from "../../package.json";
 import { UNNAMED_ENTITY_NAME } from "@/constants/entities";
-import { errorStringForLog } from "../libs/endorserServer";
 
 // consolidate this with GiveActionClaim in src/interfaces/claims.ts
 interface Claim {
@@ -400,44 +399,6 @@ export default class HomeView extends Vue {
   newOffersToUserProjectsHitLimit: boolean = false;
   numNewOffersToUser: number = 0; // number of new offers-to-user
   numNewOffersToUserProjects: number = 0; // number of new offers-to-user's-projects
-
-  /**
-   * CRITICAL VUE REACTIVITY BUG WORKAROUND
-   *
-   * This watcher is required for the component to render correctly.
-   * Without it, the newDirectOffersActivityNumber element fails to render
-   * even when numNewOffersToUser has the correct value.
-   *
-   * This appears to be a Vue reactivity issue where property changes
-   * don't trigger proper template updates.
-   *
-   * DO NOT REMOVE until the underlying Vue reactivity issue is resolved.
-   *
-   * See: doc/activeDid-migration-plan.md for details
-   */
-  @Watch("numNewOffersToUser")
-  onNumNewOffersToUserChange(newValue: number, oldValue: number) {
-    logger.debug("[HomeView] numNewOffersToUser changed", {
-      oldValue,
-      newValue,
-      willRender: !!newValue,
-      vIfCondition: `v-if="numNewOffersToUser"`,
-      elementTestId: "newDirectOffersActivityNumber",
-      shouldShowElement: newValue > 0,
-      timestamp: new Date().toISOString(),
-    });
-  }
-
-  // get shouldShowNewOffersToUser() {
-  //   const shouldShow = !!this.numNewOffersToUser;
-  //   logger.debug("[HomeView] shouldShowNewOffersToUser computed", {
-  //     numNewOffersToUser: this.numNewOffersToUser,
-  //     shouldShow,
-  //     timestamp: new Date().toISOString()
-  //   });
-  //   return shouldShow;
-  // }
-
   searchBoxes: Array<{
     name: string;
     bbox: BoundingBox;
@@ -471,44 +432,13 @@ export default class HomeView extends Vue {
    */
   async mounted() {
     try {
-      logger.debug("[HomeView] mounted() - component lifecycle started", {
-        timestamp: new Date().toISOString(),
-        componentName: "HomeView",
-      });
-
       await this.initializeIdentity();
       // Settings already loaded in initializeIdentity()
-      // Contacts already loaded in initializeIdentity()
+      await this.loadContacts();
       // Registration check already handled in initializeIdentity()
       await this.loadFeedData();
-
-      logger.debug("[HomeView] mounted() - about to call loadNewOffers()", {
-        timestamp: new Date().toISOString(),
-        activeDid: this.activeDid,
-        hasActiveDid: !!this.activeDid,
-      });
-
       await this.loadNewOffers();
-
-      logger.debug("[HomeView] mounted() - loadNewOffers() completed", {
-        timestamp: new Date().toISOString(),
-        numNewOffersToUser: this.numNewOffersToUser,
-        numNewOffersToUserProjects: this.numNewOffersToUserProjects,
-        shouldShowElement:
-          this.numNewOffersToUser + this.numNewOffersToUserProjects > 0,
-      });
-
       await this.checkOnboarding();
-
-      logger.debug("[HomeView] mounted() - component lifecycle completed", {
-        timestamp: new Date().toISOString(),
-        finalState: {
-          numNewOffersToUser: this.numNewOffersToUser,
-          numNewOffersToUserProjects: this.numNewOffersToUserProjects,
-          shouldShowElement:
-            this.numNewOffersToUser + this.numNewOffersToUserProjects > 0,
-        },
-      });
     } catch (err: unknown) {
       this.handleError(err);
     }
@@ -585,22 +515,11 @@ export default class HomeView extends Vue {
       // **CRITICAL**: Ensure correct API server for platform
       await this.ensureCorrectApiServer();
 
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-      logger.debug("[HomeView] ActiveDid migration - using new API", {
-        activeDid: this.activeDid,
-        source: "active_identity table",
-        hasActiveDid: !!this.activeDid,
-        activeIdentityResult: activeIdentity,
-        isRegistered: this.isRegistered,
-        timestamp: new Date().toISOString(),
-      });
+      this.activeDid = settings.activeDid || "";
 
       // Load contacts with graceful fallback
       try {
-        await this.loadContacts();
+        this.loadContacts();
       } catch (error) {
         this.$logAndConsole(
           `[HomeView] Failed to retrieve contacts: ${error}`,
@@ -735,103 +654,24 @@ export default class HomeView extends Vue {
    * @requires Active DID
    */
   private async loadNewOffers() {
-    logger.debug("[HomeView] loadNewOffers() called with activeDid:", {
-      activeDid: this.activeDid,
-      hasActiveDid: !!this.activeDid,
-      length: this.activeDid?.length || 0,
-    });
-
     if (this.activeDid) {
-      logger.debug(
-        "[HomeView] loadNewOffers() - activeDid found, calling API",
-        {
-          activeDid: this.activeDid,
-          apiServer: this.apiServer,
-          isRegistered: this.isRegistered,
-          lastAckedOfferToUserJwtId: this.lastAckedOfferToUserJwtId,
-        },
+      const offersToUserData = await getNewOffersToUser(
+        this.axios,
+        this.apiServer,
+        this.activeDid,
+        this.lastAckedOfferToUserJwtId,
       );
+      this.numNewOffersToUser = offersToUserData.data.length;
+      this.newOffersToUserHitLimit = offersToUserData.hitLimit;
 
-      try {
-        const offersToUserData = await getNewOffersToUser(
-          this.axios,
-          this.apiServer,
-          this.activeDid,
-          this.lastAckedOfferToUserJwtId,
-        );
-        logger.debug(
-          "[HomeView] loadNewOffers() - getNewOffersToUser successful",
-          {
-            activeDid: this.activeDid,
-            dataLength: offersToUserData.data.length,
-            hitLimit: offersToUserData.hitLimit,
-          },
-        );
-
-        this.numNewOffersToUser = offersToUserData.data.length;
-        this.newOffersToUserHitLimit = offersToUserData.hitLimit;
-
-        logger.debug("[HomeView] loadNewOffers() - updated component state", {
-          activeDid: this.activeDid,
-          numNewOffersToUser: this.numNewOffersToUser,
-          newOffersToUserHitLimit: this.newOffersToUserHitLimit,
-          willRender: !!this.numNewOffersToUser,
-          timestamp: new Date().toISOString(),
-        });
-
-        const offersToUserProjects = await getNewOffersToUserProjects(
-          this.axios,
-          this.apiServer,
-          this.activeDid,
-          this.lastAckedOfferToUserProjectsJwtId,
-        );
-        logger.debug(
-          "[HomeView] loadNewOffers() - getNewOffersToUserProjects successful",
-          {
-            activeDid: this.activeDid,
-            dataLength: offersToUserProjects.data.length,
-            hitLimit: offersToUserProjects.hitLimit,
-          },
-        );
-
-        this.numNewOffersToUserProjects = offersToUserProjects.data.length;
-        this.newOffersToUserProjectsHitLimit = offersToUserProjects.hitLimit;
-
-        logger.debug("[HomeView] loadNewOffers() - all API calls completed", {
-          numNewOffersToUser: this.numNewOffersToUser,
-          numNewOffersToUserProjects: this.numNewOffersToUserProjects,
-          shouldRenderElement: !!this.numNewOffersToUser,
-          elementTestId: "newDirectOffersActivityNumber",
-          timestamp: new Date().toISOString(),
-        });
-
-        // Additional logging for template rendering debugging
-        logger.debug("[HomeView] loadNewOffers() - template rendering check", {
-          numNewOffersToUser: this.numNewOffersToUser,
-          numNewOffersToUserProjects: this.numNewOffersToUserProjects,
-          totalNewOffers:
-            this.numNewOffersToUser + this.numNewOffersToUserProjects,
-          shouldShowElement:
-            this.numNewOffersToUser + this.numNewOffersToUserProjects > 0,
-          vIfCondition: `v-if="numNewOffersToUser + numNewOffersToUserProjects"`,
-          elementWillRender:
-            this.numNewOffersToUser + this.numNewOffersToUserProjects > 0,
-          timestamp: new Date().toISOString(),
-        });
-      } catch (error) {
-        logger.error("[HomeView] loadNewOffers() - API call failed", {
-          activeDid: this.activeDid,
-          apiServer: this.apiServer,
-          isRegistered: this.isRegistered,
-          error: errorStringForLog(error),
-          errorMessage: error instanceof Error ? error.message : String(error),
-        });
-      }
-    } else {
-      logger.warn("[HomeView] loadNewOffers() - no activeDid available", {
-        activeDid: this.activeDid,
-        timestamp: new Date().toISOString(),
-      });
+      const offersToUserProjects = await getNewOffersToUserProjects(
+        this.axios,
+        this.apiServer,
+        this.activeDid,
+        this.lastAckedOfferToUserProjectsJwtId,
+      );
+      this.numNewOffersToUserProjects = offersToUserProjects.data.length;
+      this.newOffersToUserProjectsHitLimit = offersToUserProjects.hitLimit;
     }
   }
 

src/views/IdentitySwitcherView.vue

@@ -200,12 +200,7 @@ export default class IdentitySwitcherView extends Vue {
   async created() {
     try {
       const settings = await this.$accountSettings();
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-
+      this.activeDid = settings.activeDid || "";
       this.apiServer = settings.apiServer || "";
       this.apiServerInput = settings.apiServer || "";
 
@@ -227,8 +222,8 @@ export default class IdentitySwitcherView extends Vue {
   }
 
   async switchAccount(did?: string) {
-    // Update the active DID in the active_identity table
-    await this.$updateActiveDid(did);
+    // Save the new active DID to master settings
+    await this.$saveSettings({ activeDid: did });
 
     // Check if we need to load user-specific settings for the new DID
     if (did) {
@@ -272,48 +267,15 @@ export default class IdentitySwitcherView extends Vue {
     this.notify.confirm(
       NOTIFY_DELETE_IDENTITY_CONFIRM.text,
       async () => {
-        await this.smartDeleteAccount(id);
+        await this.$exec(`DELETE FROM accounts WHERE id = ?`, [id]);
+        this.otherIdentities = this.otherIdentities.filter(
+          (ident) => ident.id !== id,
+        );
       },
       -1,
     );
   }
 
-  /**
-   * Smart deletion with atomic transaction and last account protection
-   * Follows the Active Pointer + Smart Deletion Pattern
-   */
-  async smartDeleteAccount(id: string) {
-    await this.$withTransaction(async () => {
-      const total = await this.$countAccounts();
-      if (total <= 1) {
-        this.notify.warning(
-          "Cannot delete the last account. Keep at least one.",
-        );
-        throw new Error("blocked:last-item");
-      }
-
-      const accountDid = await this.$getAccountDidById(parseInt(id));
-      const activeDid = await this.$getActiveDid();
-
-      if (activeDid === accountDid) {
-        const allDids = await this.$getAllAccountDids();
-        const nextDid = this.$pickNextAccountDid(
-          allDids.filter((d) => d !== accountDid),
-          accountDid,
-        );
-        await this.$setActiveDid(nextDid);
-        this.notify.success(`Switched active to ${nextDid} before deletion.`);
-      }
-
-      await this.$exec("DELETE FROM accounts WHERE id = ?", [id]);
-    });
-
-    // Update UI
-    this.otherIdentities = this.otherIdentities.filter(
-      (ident) => ident.id !== id,
-    );
-  }
-
   notifyCannotDelete() {
     this.notify.warning(
       NOTIFY_CANNOT_DELETE_ACTIVE_IDENTITY.message,

src/views/ImportAccountView.vue

@@ -224,14 +224,13 @@ export default class ImportAccountView extends Vue {
       );
 
       // Check what was actually imported
-      // Check account-specific settings
-      // Get activeDid from new active_identity table (ActiveDid migration)
-      const activeIdentity = await this.$getActiveIdentity();
+      const settings = await this.$accountSettings();
 
-      if (activeIdentity.activeDid) {
+      // Check account-specific settings
+      if (settings?.activeDid) {
         try {
           await this.$query("SELECT * FROM settings WHERE accountDid = ?", [
-            activeIdentity.activeDid,
+            settings.activeDid,
           ]);
         } catch (error) {
           // Log error but don't interrupt import flow

src/views/InviteOneAcceptView.vue

@@ -120,12 +120,7 @@ export default class InviteOneAcceptView extends Vue {
 
     // Load or generate identity
     const settings = await this.$accountSettings();
-
-    // Get activeDid from active_identity table (single source of truth)
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const activeIdentity = await (this as any).$getActiveIdentity();
-    this.activeDid = activeIdentity.activeDid || "";
-
+    this.activeDid = settings.activeDid || "";
     this.apiServer = settings.apiServer || "";
 
     // Identity creation should be handled by router guard, but keep as fallback for deep links

src/views/InviteOneView.vue

@@ -128,7 +128,7 @@
 <script lang="ts">
 import axios from "axios";
 import { Component, Vue } from "vue-facing-decorator";
-import { copyToClipboard } from "../services/ClipboardService";
+import { useClipboard } from "@vueuse/core";
 import { Router } from "vue-router";
 
 import ContactNameDialog from "../components/ContactNameDialog.vue";
@@ -283,12 +283,7 @@ export default class InviteOneView extends Vue {
     try {
       // Use PlatformServiceMixin for account settings
       const settings = await this.$accountSettings();
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-
+      this.activeDid = settings.activeDid || "";
       this.apiServer = settings.apiServer || "";
       this.isRegistered = !!settings.isRegistered;
 
@@ -338,27 +333,17 @@ export default class InviteOneView extends Vue {
     return `${APP_SERVER}/deep-link/invite-one-accept/${jwt}`;
   }
 
-  async copyInviteAndNotify(inviteId: string, jwt: string) {
-    try {
-      await copyToClipboard(this.inviteLink(jwt));
-      this.notify.success(createInviteLinkCopyMessage(inviteId), TIMEOUTS.LONG);
-    } catch (error) {
-      this.$logAndConsole(`Error copying invite link: ${error}`, true);
-      this.notify.error("Failed to copy invite link.");
-    }
+  copyInviteAndNotify(inviteId: string, jwt: string) {
+    useClipboard().copy(this.inviteLink(jwt));
+    this.notify.success(createInviteLinkCopyMessage(inviteId), TIMEOUTS.LONG);
   }
 
-  async showInvite(inviteId: string, redeemed: boolean, expired: boolean) {
-    try {
-      await copyToClipboard(inviteId);
-      this.notify.success(
-        createInviteIdCopyMessage(inviteId, redeemed, expired),
-        TIMEOUTS.LONG,
-      );
-    } catch (error) {
-      this.$logAndConsole(`Error copying invite ID: ${error}`, true);
-      this.notify.error("Failed to copy invite ID.");
-    }
+  showInvite(inviteId: string, redeemed: boolean, expired: boolean) {
+    useClipboard().copy(inviteId);
+    this.notify.success(
+      createInviteIdCopyMessage(inviteId, redeemed, expired),
+      TIMEOUTS.LONG,
+    );
   }
 
   // eslint-disable-next-line @typescript-eslint/no-explicit-any

src/views/NewActivityView.vue

@@ -202,12 +202,7 @@ export default class NewActivityView extends Vue {
     try {
       const settings = await this.$accountSettings();
       this.apiServer = settings.apiServer || "";
-
-      // Get activeDid from active_identity table (single source of truth)
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const activeIdentity = await (this as any).$getActiveIdentity();
-      this.activeDid = activeIdentity.activeDid || "";
-
+      this.activeDid = settings.activeDid || "";
       this.lastAckedOfferToUserJwtId = settings.lastAckedOfferToUserJwtId || "";
       this.lastAckedOfferToUserProjectsJwtId =
         settings.lastAckedOfferToUserProjectsJwtId || "";