docs: complete accountlink UIKit validation, add daily log, and document force-path testing guide

- Created daily log entries for May 13, 14, 18, 19, 20, and 21, capturing work done, findings, and next steps.
- Established a daily logs index for easy navigation of daily notes.
- Developed templates for daily logs, decisions, meeting notes, people, systems, and work items to standardize documentation.
- Introduced base files for filtering and displaying various types of project knowledge, including daily notes, decisions, people, systems, work items, and workstreams.
- Added maps for current work, fidelity apps, and fidelity domain to enhance project navigation and context.

.agents/rules/copilot-prompt-engineering.md

@@ -19,10 +19,10 @@ Use this skill when the user wants a prompt for another AI assistant, GitHub Cop
    - test strategy
    - story/PR drafting
 2. Pull only the relevant context:
-   - `project-knowledge/02-work-items/` for ticket-specific context
+   - `workspaces/fidelity/project-knowledge/02-work-items/` for ticket-specific context
-   - `project-knowledge/03-context/systems/` for component context
+   - `workspaces/fidelity/project-knowledge/03-context/systems/` for component context
-   - `project-knowledge/03-context/workstreams/` for recurring constraints
+   - `workspaces/fidelity/project-knowledge/03-context/workstreams/` for recurring constraints
-   - `project-knowledge/03-context/ios/` for Swift/iOS guidance
+   - `workspaces/fidelity/project-knowledge/03-context/ios/` for Swift/iOS guidance
 3. Make the prompt self-contained.
 4. Tell the target AI what to inspect before acting.
 5. State constraints, non-goals, and validation expectations.

.agents/rules/ios-swift-answering.md

@@ -12,8 +12,8 @@ Use this skill for Swift, SwiftUI, iOS architecture, concurrency, testing, or de
 ## Workflow
 
 1. Identify whether the question is general Swift/iOS or Fidelity-specific.
-2. Read `project-knowledge/03-context/ios/current-practices.md` for currentness rules.
+2. Read `workspaces/fidelity/project-knowledge/03-context/ios/current-practices.md` for currentness rules.
-3. Read `project-knowledge/03-context/ios/project-swift-guidance.md` when the answer may affect XFlow, Fid4, XFlowViewMaker, FTFrameworks, feature flags, or consumer validation.
+3. Read `workspaces/fidelity/project-knowledge/03-context/ios/project-swift-guidance.md` when the answer may affect XFlow, Fid4, XFlowViewMaker, FTFrameworks, feature flags, or consumer validation.
 4. If the answer depends on current Apple APIs, Xcode versions, dependency tooling, package-manager behavior, testing frameworks, or migration guidance, verify with official/primary documentation before making strong claims.
 5. Separate:
    - current best practice

.agents/workflows/ai-prompt.md

@@ -8,9 +8,9 @@ Read:
 
 @core/README.md
 @core/memory/operational-memory.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
 @agent-memory/workflows/ai-to-ai-prompting.md
 
 Read active profile, if present:
@@ -23,13 +23,13 @@ Relevant active work item files, if available:
 import re
 from pathlib import Path
 
-summary = Path("project-knowledge/01-current/work-items.md")
+summary = Path("workspaces/fidelity/project-knowledge/01-current/work-items.md")
 if not summary.is_file():
     print("No work item files available.")
     raise SystemExit(0)
 
 text = summary.read_text()
-paths = re.findall(r"Detail: `(project-knowledge/02-work-items/[^`]+)`", text)
+paths = re.findall(r"Detail: `(workspaces/fidelity/project-knowledge/02-work-items/[^`]+)`", text)
 if not paths:
     print("No work item files available.")
     raise SystemExit(0)

.agents/workflows/archive-import.md

@@ -10,26 +10,25 @@ Inputs:
 
 - `$ARGUMENTS` may contain an export path, channel names, or date filters
 - if no explicit path is given, use `AIW_SLACK_EXPORT_PATH` when available
-- Fidelity profile alias: `FIDELITY_SLACK_EXPORT_PATH`
 - otherwise, if `archives/slack/export/` exists, use it as the default import source
 - if no channels are specified, auto-detect channels using `AIW_CHANNEL_PREFIX`
 - Fidelity default prefix: `fidelity`
 
 Run the importer:
 
-!`prefix="${AIW_CHANNEL_PREFIX:-fidelity}"; if [ -n "$ARGUMENTS" ]; then python3 scripts/slack/import_slack_export.py $ARGUMENTS; elif [ -n "$AIW_SLACK_EXPORT_PATH" ]; then python3 scripts/slack/import_slack_export.py --export-path "$AIW_SLACK_EXPORT_PATH" --channel-prefix "$prefix"; elif [ -n "$FIDELITY_SLACK_EXPORT_PATH" ]; then python3 scripts/slack/import_slack_export.py --export-path "$FIDELITY_SLACK_EXPORT_PATH" --channel-prefix "$prefix"; elif [ -d archives/slack/export ]; then python3 scripts/slack/import_slack_export.py --export-path archives/slack/export --channel-prefix "$prefix"; else echo "Provide archive import arguments, set AIW_SLACK_EXPORT_PATH, set FIDELITY_SLACK_EXPORT_PATH, or place an extracted export in archives/slack/export."; fi`
+!`prefix="${AIW_CHANNEL_PREFIX:-fidelity}"; if [ -n "$ARGUMENTS" ]; then python3 scripts/slack/import_slack_export.py $ARGUMENTS; elif [ -n "$AIW_SLACK_EXPORT_PATH" ]; then python3 scripts/slack/import_slack_export.py --export-path "$AIW_SLACK_EXPORT_PATH" --channel-prefix "$prefix"; elif [ -d archives/slack/export ]; then python3 scripts/slack/import_slack_export.py --export-path archives/slack/export --channel-prefix "$prefix"; else echo "Provide archive import arguments, set AIW_SLACK_EXPORT_PATH, or place an extracted export in archives/slack/export."; fi`
 
 Read:
 
 @core/README.md
 @core/memory/operational-memory.md
 @core/integrations/communication-model.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
 @agent-memory/memory/context-maintenance.md
-@project-knowledge/04-people/index.md
+@workspaces/fidelity/project-knowledge/04-people/index.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
 
 Imported summary, if present:
 
@@ -44,11 +43,11 @@ Instructions:
 - treat the archive as historical evidence
 - promote durable project-relevant context automatically when confidence is high
 - prefer durable role/person associations, recurring architecture patterns, repeated work-item references, approval/scope history, and process lessons
-- create or update `project-knowledge/04-people/*.md` when a human repeatedly affects project flow
+- create or update `workspaces/fidelity/project-knowledge/04-people/*.md` when a human repeatedly affects project flow
 - avoid promoting outdated daily status unless it changes current understanding
 - update existing memory when the archive clarifies or corrects it
 - keep ambiguous or likely outdated facts as archive-only context
-- write promoted memory to `project-knowledge/`
+- write promoted memory to `workspaces/fidelity/project-knowledge/`
 
 Return:
 

.agents/workflows/communication-sync.md

@@ -7,21 +7,20 @@ Use the configured live communication connector to fetch fresh evidence and main
 Preferred command sources:
 
 - `AIW_MATTERMOST_SYNC_CMD`
-- Fidelity profile alias: `FIDELITY_MATTERMOST_SYNC_CMD`
+- Built-in wrapper: `bash scripts/mattermost/sync.sh`
-- workspace fallback: `bash scripts/mattermost/sync.sh`
 
 Run the connector:
 
-!`if [ -n "$AIW_MATTERMOST_SYNC_CMD" ]; then bash -lc "$AIW_MATTERMOST_SYNC_CMD"; elif [ -n "$FIDELITY_MATTERMOST_SYNC_CMD" ]; then bash -lc "$FIDELITY_MATTERMOST_SYNC_CMD"; elif [ -f scripts/mattermost/sync.sh ]; then bash scripts/mattermost/sync.sh; else echo "No live communication sync command is configured."; fi`
+!`if [ -n "$AIW_MATTERMOST_SYNC_CMD" ]; then bash -lc "$AIW_MATTERMOST_SYNC_CMD"; elif [ -f scripts/mattermost/sync.sh ]; then bash scripts/mattermost/sync.sh; else echo "No live communication sync command is configured."; fi`
 
 Read:
 
 @core/README.md
 @core/memory/operational-memory.md
 @core/integrations/communication-model.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
 @agent-memory/memory/context-maintenance.md
 
 Fresh communication evidence:
@@ -31,13 +30,13 @@ Fresh communication evidence:
 Instructions:
 
 - if the sync command failed, stop and do not edit workspace memory
-- prefer local proxy mirror evidence when present; legacy sync output is fallback evidence
+- prefer local proxy mirror evidence when present; use the configured sync wrapper only when a fresh API pull is required
 - treat connector output as evidence, not automatically as project truth
 - promote only explicit, project-relevant, high-confidence facts
-- default destination is `project-knowledge/06-daily/$(date +%F).md`
+- default destination is `workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md`
-- update `project-knowledge/01-current/current-work.md` only for facts that materially change the active work window
+- update `workspaces/fidelity/project-knowledge/01-current/current-work.md` only for facts that materially change the active work window
-- update `project-knowledge/02-work-items/*.md` for explicit work-item IDs, approved titles, points, scope, and status notes
+- update `workspaces/fidelity/project-knowledge/02-work-items/*.md` for explicit work-item IDs, approved titles, points, scope, and status notes
-- keep `project-knowledge/01-current/work-items.md` aligned as the compact summary of active work items
+- keep `workspaces/fidelity/project-knowledge/01-current/work-items.md` aligned as the compact summary of active work items
 - do not write tooling noise, sync status, or generic chat chatter into project memory
 - if a fact is ambiguous, skip it rather than asking what to do
 

.agents/workflows/copilot-prompt.md

@@ -9,14 +9,14 @@ Read:
 @core/README.md
 @core/memory/operational-memory.md
 @prompts/copilot-prompt.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
 @agent-memory/workflows/ai-to-ai-prompting.md
-@project-knowledge/03-context/ios/index.md
+@workspaces/fidelity/project-knowledge/03-context/ios/index.md
-@project-knowledge/03-context/ios/project-swift-guidance.md
+@workspaces/fidelity/project-knowledge/03-context/ios/project-swift-guidance.md
-@project-knowledge/03-context/systems/index.md
+@workspaces/fidelity/project-knowledge/03-context/systems/index.md
-@project-knowledge/03-context/workstreams/index.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/index.md
 
 Active profile, if present:
 
@@ -28,13 +28,13 @@ Detailed active work item files, if available:
 import re
 from pathlib import Path
 
-summary = Path("project-knowledge/01-current/work-items.md")
+summary = Path("workspaces/fidelity/project-knowledge/01-current/work-items.md")
 if not summary.is_file():
     print("No work item files available.")
     raise SystemExit(0)
 
 text = summary.read_text()
-paths = re.findall(r"Detail: `(project-knowledge/02-work-items/[^`]+)`", text)
+paths = re.findall(r"Detail: `(workspaces/fidelity/project-knowledge/02-work-items/[^`]+)`", text)
 if not paths:
     print("No work item files available.")
     raise SystemExit(0)

.agents/workflows/fidelity-context.md

@@ -11,14 +11,14 @@ Use these files as the baseline context:
 @agent-memory/behavior/learning-sessions.md
 @agent-memory/memory/promotion-rules.md
 @agent-memory/integrations/technical-verification.md
-@project-knowledge/00-start/start-here.md
+@workspaces/fidelity/project-knowledge/00-start/start-here.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/process/communication.md
+@workspaces/fidelity/project-knowledge/03-context/process/communication.md
-@project-knowledge/03-context/ios/index.md
+@workspaces/fidelity/project-knowledge/03-context/ios/index.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
-@project-knowledge/04-people/index.md
+@workspaces/fidelity/project-knowledge/04-people/index.md
 
 Today's date:
 
@@ -26,11 +26,11 @@ Today's date:
 
 Today's canonical daily note, if present:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 Latest daily notes available:
 
-!`if [ -d project-knowledge/06-daily ]; then ls -1 project-knowledge/06-daily 2>/dev/null | sort | tail -n 3; else echo "No daily notes directory available."; fi`
+!`if [ -d workspaces/fidelity/project-knowledge/06-daily ]; then ls -1 workspaces/fidelity/project-knowledge/06-daily 2>/dev/null | sort | tail -n 3; else echo "No daily notes directory available."; fi`
 
 Detailed active work item files, if available:
 
@@ -38,13 +38,13 @@ Detailed active work item files, if available:
 import re
 from pathlib import Path
 
-summary = Path("project-knowledge/01-current/work-items.md")
+summary = Path("workspaces/fidelity/project-knowledge/01-current/work-items.md")
 if not summary.is_file():
     print("No work item files available.")
     raise SystemExit(0)
 
 text = summary.read_text()
-paths = re.findall(r"Detail: `(project-knowledge/02-work-items/[^`]+)`", text)
+paths = re.findall(r"Detail: `(workspaces/fidelity/project-knowledge/02-work-items/[^`]+)`", text)
 if not paths:
     print("No work item files available.")
     raise SystemExit(0)

.agents/workflows/latest-message.md

@@ -2,7 +2,7 @@
 description: Force-sync Mattermost and answer from the latest matching message
 ---
 
-Refresh/read Mattermost first, then answer the user's question from the freshest evidence. Prefer the local proxy mirror when it is present; legacy sync output is fallback evidence.
+Refresh/read Mattermost first, then answer the user's question from the freshest evidence. Prefer the local proxy mirror when it is present; use the configured sync wrapper only when a fresh API pull is required.
 
 Use this when the user asks for:
 
@@ -13,7 +13,7 @@ Use this when the user asks for:
 
 Run sync/fallback refresh:
 
-!`start=$(date +%s); if [ -n "$AIW_MATTERMOST_SYNC_CMD" ]; then bash -lc "$AIW_MATTERMOST_SYNC_CMD"; elif [ -n "$FIDELITY_MATTERMOST_SYNC_CMD" ]; then bash -lc "$FIDELITY_MATTERMOST_SYNC_CMD"; elif [ -f scripts/mattermost/sync.sh ]; then bash scripts/mattermost/sync.sh; else echo "No Mattermost sync command is configured."; fi; status=$?; end=$(date +%s); echo "__MATTERMOST_SYNC_SECONDS__=$((end - start))"; exit "$status"`
+!`start=$(date +%s); if [ -n "$AIW_MATTERMOST_SYNC_CMD" ]; then bash -lc "$AIW_MATTERMOST_SYNC_CMD"; elif [ -f scripts/mattermost/sync.sh ]; then bash scripts/mattermost/sync.sh; else echo "No Mattermost sync command is configured."; fi; status=$?; end=$(date +%s); echo "__MATTERMOST_SYNC_SECONDS__=$((end - start))"; exit "$status"`
 
 Read a focused slice of refreshed Mattermost context, preferring the proxy mirror:
 

.agents/workflows/log-note.md

@@ -9,15 +9,15 @@ Read:
 @README.md
 @core/README.md
 @core/memory/operational-memory.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/workstreams/index.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/index.md
 @agent-memory/memory/context-maintenance.md
 
 Today's existing log, if present:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 Incorporate these new rough notes into today's log:
 
@@ -26,7 +26,7 @@ $ARGUMENTS
 Instructions:
 
 - use `workspace-memory-curation` when available
-- Update or create `project-knowledge/06-daily/$(date +%F).md`
+- Update or create `workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md`
 - Maintain daily-note frontmatter for Obsidian Bases: `date`, `focus`, `work-items`, `blockers`, and `updated`
 - Preserve concrete technical meaning
 - Capture both technical findings and communication context when relevant

.agents/workflows/manager-update.md

@@ -9,16 +9,16 @@ Use `professional-communication` when available.
 Read:
 
 @prompts/manager-update.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/process/communication.md
+@workspaces/fidelity/project-knowledge/03-context/process/communication.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
-@project-knowledge/04-people/index.md
+@workspaces/fidelity/project-knowledge/04-people/index.md
 
 Today's log, if present:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 Latest Mattermost context, if available:
 
@@ -30,13 +30,13 @@ Detailed active work item files, if available:
 import re
 from pathlib import Path
 
-summary = Path("project-knowledge/01-current/work-items.md")
+summary = Path("workspaces/fidelity/project-knowledge/01-current/work-items.md")
 if not summary.is_file():
     print("No work item files available.")
     raise SystemExit(0)
 
 text = summary.read_text()
-paths = re.findall(r"Detail: `(project-knowledge/02-work-items/[^`]+)`", text)
+paths = re.findall(r"Detail: `(workspaces/fidelity/project-knowledge/02-work-items/[^`]+)`", text)
 if not paths:
     print("No work item files available.")
     raise SystemExit(0)

.agents/workflows/mattermost-sync.md

@@ -7,12 +7,11 @@ Use the configured Mattermost sync command and/or local proxy mirror evidence to
 Preferred command sources:
 
 - `AIW_MATTERMOST_SYNC_CMD`
-- Fidelity profile alias: `FIDELITY_MATTERMOST_SYNC_CMD`
+- Built-in wrapper: `bash scripts/mattermost/sync.sh`
-- fallback: `bash scripts/mattermost/sync.sh`
 
 Run the command and use its output as fresh communication context:
 
-!`if [ -n "$AIW_MATTERMOST_SYNC_CMD" ]; then bash -lc "$AIW_MATTERMOST_SYNC_CMD"; elif [ -n "$FIDELITY_MATTERMOST_SYNC_CMD" ]; then bash -lc "$FIDELITY_MATTERMOST_SYNC_CMD"; elif [ -f scripts/mattermost/sync.sh ]; then bash scripts/mattermost/sync.sh; else echo "No Mattermost sync command is configured."; fi`
+!`if [ -n "$AIW_MATTERMOST_SYNC_CMD" ]; then bash -lc "$AIW_MATTERMOST_SYNC_CMD"; elif [ -f scripts/mattermost/sync.sh ]; then bash scripts/mattermost/sync.sh; else echo "No Mattermost sync command is configured."; fi`
 
 Fresh Mattermost evidence, preferring the proxy mirror:
 
@@ -24,15 +23,15 @@ Then:
 
 - if the command fails, stop there and do not edit any workspace files
 - prefer the local proxy mirror via `scripts/mattermost-proxy/read-context.py --mode latest` when it has evidence
-- otherwise use `ai/inbox/mattermost-latest.md` if it exists and is non-empty
+- otherwise use `workspaces/fidelity/inbox/mattermost-latest.md` if it exists and is non-empty
 - otherwise use `scripts/mattermost/generated/mattermost_context.jsonl` if it exists and is non-empty
 - apply the memory promotion rules from `agent-memory/memory/promotion-rules.md`
 - treat Mattermost output as live communication evidence; the agent decides what becomes promoted memory
 - automatically promote explicit, project-relevant, high-confidence facts
-- default destination is `project-knowledge/06-daily/$(date +%F).md`
+- default destination is `workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md`
-- update `project-knowledge/01-current/current-work.md` only for facts that materially change the current work window
+- update `workspaces/fidelity/project-knowledge/01-current/current-work.md` only for facts that materially change the current work window
-- update `project-knowledge/02-work-items/*.md` for explicit Jira IDs, approved titles, points, scope, and status notes
+- update `workspaces/fidelity/project-knowledge/02-work-items/*.md` for explicit Jira IDs, approved titles, points, scope, and status notes
-- keep `project-knowledge/01-current/work-items.md` aligned as the compact summary of active ticket files
+- keep `workspaces/fidelity/project-knowledge/01-current/work-items.md` aligned as the compact summary of active ticket files
 - do not write tooling noise, sync status, or generic chat chatter into project memory
 - if a fact is ambiguous, skip it rather than asking the user what to do
 

.agents/workflows/memory-create.md

@@ -22,11 +22,11 @@ Read:
 
 @core/integrations/memory-vault-model.md
 @agent-memory/workflows/workspace-architecture.md
-@project-knowledge/09-templates/work-item.md
+@workspaces/fidelity/project-knowledge/09-templates/work-item.md
-@project-knowledge/09-templates/person.md
+@workspaces/fidelity/project-knowledge/09-templates/person.md
-@project-knowledge/09-templates/decision.md
+@workspaces/fidelity/project-knowledge/09-templates/decision.md
-@project-knowledge/09-templates/system.md
+@workspaces/fidelity/project-knowledge/09-templates/system.md
-@project-knowledge/09-templates/workstream.md
+@workspaces/fidelity/project-knowledge/09-templates/workstream.md
 
 Instructions:
 

.agents/workflows/promote-project-context.md

@@ -8,17 +8,17 @@ Read:
 
 @core/README.md
 @core/memory/operational-memory.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/systems/index.md
+@workspaces/fidelity/project-knowledge/03-context/systems/index.md
-@project-knowledge/03-context/workstreams/index.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/index.md
-@project-knowledge/03-context/workstreams/flow-page-references.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/flow-page-references.md
-@project-knowledge/03-context/process/index.md
+@workspaces/fidelity/project-knowledge/03-context/process/index.md
 
 Today's log, if present:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 Current Mattermost inbox, if present:
 
@@ -37,20 +37,20 @@ Instructions:
 - Promote only confirmed project-relevant facts
 - Ignore tooling noise and sync status
 - Update the smallest correct set of files among:
-  - `project-knowledge/06-daily/$(date +%F).md`
+  - `workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md`
-  - `project-knowledge/01-current/current-work.md`
+  - `workspaces/fidelity/project-knowledge/01-current/current-work.md`
-  - `project-knowledge/02-work-items/*.md`
+  - `workspaces/fidelity/project-knowledge/02-work-items/*.md`
-  - `project-knowledge/01-current/work-items.md`
+  - `workspaces/fidelity/project-knowledge/01-current/work-items.md`
-  - `project-knowledge/03-context/project.md`
+  - `workspaces/fidelity/project-knowledge/03-context/project.md`
-  - `project-knowledge/03-context/systems/*.md`
+  - `workspaces/fidelity/project-knowledge/03-context/systems/*.md`
-  - `project-knowledge/03-context/workstreams/*.md`
+  - `workspaces/fidelity/project-knowledge/03-context/workstreams/*.md`
-  - `project-knowledge/03-context/process/*.md`
+  - `workspaces/fidelity/project-knowledge/03-context/process/*.md`
-  - `project-knowledge/05-decisions/*.md`
+  - `workspaces/fidelity/project-knowledge/05-decisions/*.md`
   - `.opencode/commands/*.md` when command behavior needs to change
   - `prompts/*.md` when a reusable output template needs to change
   - `.opencode/agents/*.md` or `AGENTS.md` when default agent behavior needs to change
   - `.agents/skills/*/SKILL.md` when a specialized workflow needs to change
-  - `project-knowledge/00-start/*.md` when durable project onboarding guidance needs to change
+  - `workspaces/fidelity/project-knowledge/00-start/*.md` when durable project onboarding guidance needs to change
   - `agent-memory/**/*.md` when agent learning, promotion, verification, or self-maintenance behavior needs to change
 - Prefer concrete project updates over broad summaries
 - If a fact is still ambiguous, do not promote it

.agents/workflows/slack-import.md

@@ -10,7 +10,6 @@ Inputs:
 
 - `$ARGUMENTS` may contain an export path, channel names, or date filters
 - if no explicit path is given in the arguments, use `AIW_SLACK_EXPORT_PATH` when available
-- Fidelity profile alias: `FIDELITY_SLACK_EXPORT_PATH`
 - otherwise, if `archives/slack/export/` exists, use it as the default import source
 - if no channels are specified, auto-detect channels using `AIW_CHANNEL_PREFIX`
 - Fidelity default prefix: `fidelity`
@@ -20,21 +19,21 @@ Inputs:
 
 First, run the importer:
 
-!`prefix="${AIW_CHANNEL_PREFIX:-fidelity}"; if [ -n "$ARGUMENTS" ]; then python3 scripts/slack/import_slack_export.py $ARGUMENTS; elif [ -n "$AIW_SLACK_EXPORT_PATH" ]; then python3 scripts/slack/import_slack_export.py --export-path "$AIW_SLACK_EXPORT_PATH" --channel-prefix "$prefix"; elif [ -n "$FIDELITY_SLACK_EXPORT_PATH" ]; then python3 scripts/slack/import_slack_export.py --export-path "$FIDELITY_SLACK_EXPORT_PATH" --channel-prefix "$prefix"; elif [ -d archives/slack/export ]; then python3 scripts/slack/import_slack_export.py --export-path archives/slack/export --channel-prefix "$prefix"; else echo "Provide Slack import arguments, set AIW_SLACK_EXPORT_PATH, set FIDELITY_SLACK_EXPORT_PATH, or place an extracted export in archives/slack/export."; fi`
+!`prefix="${AIW_CHANNEL_PREFIX:-fidelity}"; if [ -n "$ARGUMENTS" ]; then python3 scripts/slack/import_slack_export.py $ARGUMENTS; elif [ -n "$AIW_SLACK_EXPORT_PATH" ]; then python3 scripts/slack/import_slack_export.py --export-path "$AIW_SLACK_EXPORT_PATH" --channel-prefix "$prefix"; elif [ -d archives/slack/export ]; then python3 scripts/slack/import_slack_export.py --export-path archives/slack/export --channel-prefix "$prefix"; else echo "Provide Slack import arguments, set AIW_SLACK_EXPORT_PATH, or place an extracted export in archives/slack/export."; fi`
 
 Read:
 
 @core/README.md
 @core/memory/operational-memory.md
 @core/integrations/communication-model.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/systems/index.md
+@workspaces/fidelity/project-knowledge/03-context/systems/index.md
-@project-knowledge/03-context/workstreams/index.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/index.md
-@project-knowledge/03-context/process/index.md
+@workspaces/fidelity/project-knowledge/03-context/process/index.md
-@project-knowledge/04-people/index.md
+@workspaces/fidelity/project-knowledge/04-people/index.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
 
 Imported summary, if present:
 
@@ -55,7 +54,7 @@ Instructions:
   - durable role/person associations
   - recurring architecture or debugging patterns
   - past approvals or decisions that still matter
-- create or update `project-knowledge/04-people/*.md` when the archive shows a human repeatedly contributing across channels, years, or high-signal technical/process discussions
+- create or update `workspaces/fidelity/project-knowledge/04-people/*.md` when the archive shows a human repeatedly contributing across channels, years, or high-signal technical/process discussions
 - store people conservatively:
   - exact role only when explicitly supported by the archive
   - otherwise store collaboration pattern, communication style, and project relationship
@@ -70,7 +69,7 @@ Instructions:
 - avoid promoting outdated daily status unless it changes current understanding
 - update existing memory when the archive clarifies or corrects it
 - if historical facts are ambiguous or likely outdated, summarize them as archived context instead of promoting them
-- write promoted memory to `project-knowledge/`
+- write promoted memory to `workspaces/fidelity/project-knowledge/`
 
 Return:
 

.agents/workflows/standup.md

@@ -32,7 +32,7 @@ import subprocess
 from pathlib import Path
 from datetime import datetime
 
-cmd = os.environ.get("AIW_MATTERMOST_SYNC_CMD") or os.environ.get("FIDELITY_MATTERMOST_SYNC_CMD")
+cmd = os.environ.get("AIW_MATTERMOST_SYNC_CMD")
 today = datetime.now().astimezone().date().isoformat()
 
 commands = []
@@ -66,16 +66,16 @@ PY`
 Read:
 
 @prompts/standup.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/workstreams/flow-page-references.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/flow-page-references.md
-@project-knowledge/03-context/process/communication.md
+@workspaces/fidelity/project-knowledge/03-context/process/communication.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
 
 Today's log, if present:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 Latest refreshed Mattermost context, if present:
 
@@ -87,13 +87,13 @@ Detailed active work item files, if available:
 import re
 from pathlib import Path
 
-summary = Path("project-knowledge/01-current/work-items.md")
+summary = Path("workspaces/fidelity/project-knowledge/01-current/work-items.md")
 if not summary.is_file():
     print("No work item files available.")
     raise SystemExit(0)
 
 text = summary.read_text()
-paths = re.findall(r"Detail: `(project-knowledge/02-work-items/[^`]+)`", text)
+paths = re.findall(r"Detail: `(workspaces/fidelity/project-knowledge/02-work-items/[^`]+)`", text)
 if not paths:
     print("No work item files available.")
     raise SystemExit(0)
@@ -118,11 +118,11 @@ Before drafting:
 - if documentation or root cause updates directly support a story, roll them into that story's update instead of listing them separately
 - exclude items that are not directly tied to a story unless they are true blockers
 - when one Jira item has multiple concrete updates, group them under one top-level `JIRA-ID - Title` bullet with indented markdown sub-bullets instead of repeating the same Jira line
-- use `project-knowledge/03-context/workstreams/flow-page-references.md` to preserve real flow/page identifiers when shorthand appears in logs or messages
+- use `workspaces/fidelity/project-knowledge/03-context/workstreams/flow-page-references.md` to preserve real flow/page identifiers when shorthand appears in logs or messages
 - for standups that will also be sent to Teams, prefer plain language over internal implementation jargon; avoid unexplained terms like `fallback`
 - if work is in release-process waiting state, show the parallel story work explicitly instead of implying idle waiting
 - if Mattermost sync failed, acknowledge that internally and rely on the latest saved workspace context instead of inventing fresher communication
-- prefer only the detailed work-item files referenced by `project-knowledge/01-current/work-items.md`; do not mine unrelated or completed ticket files unless they are explicitly active in current memory
+- prefer only the detailed work-item files referenced by `workspaces/fidelity/project-knowledge/01-current/work-items.md`; do not mine unrelated or completed ticket files unless they are explicitly active in current memory
 
 Return a standup that is:
 

.agents/workflows/story-draft.md

@@ -21,18 +21,18 @@ Read:
 @core/README.md
 @core/memory/operational-memory.md
 @prompts/story-draft.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/workstreams/index.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/index.md
-@project-knowledge/03-context/process/communication.md
+@workspaces/fidelity/project-knowledge/03-context/process/communication.md
-@project-knowledge/03-context/process/jira-story-rules.md
+@workspaces/fidelity/project-knowledge/03-context/process/jira-story-rules.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
-@project-knowledge/04-people/index.md
+@workspaces/fidelity/project-knowledge/04-people/index.md
 
 Today's log, if present:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 Latest Mattermost context, if available:
 
@@ -44,13 +44,13 @@ Detailed active work item files, if available:
 import re
 from pathlib import Path
 
-summary = Path("project-knowledge/01-current/work-items.md")
+summary = Path("workspaces/fidelity/project-knowledge/01-current/work-items.md")
 if not summary.is_file():
     print("No work item files available.")
     raise SystemExit(0)
 
 text = summary.read_text()
-paths = re.findall(r"Detail: `(project-knowledge/02-work-items/[^`]+)`", text)
+paths = re.findall(r"Detail: `(workspaces/fidelity/project-knowledge/02-work-items/[^`]+)`", text)
 if not paths:
     print("No work item files available.")
     raise SystemExit(0)

.agents/workflows/swift-help.md

@@ -6,14 +6,14 @@ Answer the user's Swift/iOS programming question using current iOS practices and
 
 Read:
 
-@project-knowledge/03-context/ios/index.md
+@workspaces/fidelity/project-knowledge/03-context/ios/index.md
-@project-knowledge/03-context/ios/current-practices.md
+@workspaces/fidelity/project-knowledge/03-context/ios/current-practices.md
-@project-knowledge/03-context/ios/project-swift-guidance.md
+@workspaces/fidelity/project-knowledge/03-context/ios/project-swift-guidance.md
 @agent-memory/integrations/technical-verification.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/systems/index.md
+@workspaces/fidelity/project-knowledge/03-context/systems/index.md
-@project-knowledge/03-context/workstreams/index.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/index.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
 
 User question:
 

.agents/workflows/sync-context.md

@@ -7,20 +7,20 @@ Use this command when new information should become part of the persistent works
 Read:
 
 @README.md
-@project-knowledge/00-start/start-here.md
+@workspaces/fidelity/project-knowledge/00-start/start-here.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/systems/index.md
+@workspaces/fidelity/project-knowledge/03-context/systems/index.md
-@project-knowledge/03-context/workstreams/index.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/index.md
-@project-knowledge/03-context/workstreams/flow-page-references.md
+@workspaces/fidelity/project-knowledge/03-context/workstreams/flow-page-references.md
 @agent-memory/memory/context-maintenance.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
-@project-knowledge/04-people/index.md
+@workspaces/fidelity/project-knowledge/04-people/index.md
 
 Today's existing log, if present:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 New information to incorporate:
 
@@ -31,21 +31,21 @@ Instructions:
 - use `workspace-memory-curation` when available
 - Treat direct user corrections and learning-session updates as memory sources.
 - For learning-session updates, prefer durable project understanding over transient ticket status.
-- Route durable learning to architecture/process/system/workstream notes; route only truly current operational state to `project-knowledge/01-current/` or `project-knowledge/06-daily/`.
+- Route durable learning to architecture/process/system/workstream notes; route only truly current operational state to `workspaces/fidelity/project-knowledge/01-current/` or `workspaces/fidelity/project-knowledge/06-daily/`.
 - If the new information corrects the agent's uncertainty handling or recurring behavior, update the command, prompt, agent, skill, or process rule that controls that behavior.
 - Decide whether the new information belongs in:
-  - today's daily note: `project-knowledge/06-daily/$(date +%F).md`
+  - today's daily note: `workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md`
-  - current work: `project-knowledge/01-current/current-work.md`
+  - current work: `workspaces/fidelity/project-knowledge/01-current/current-work.md`
-  - work items: `project-knowledge/02-work-items/*.md`
+  - work items: `workspaces/fidelity/project-knowledge/02-work-items/*.md`
-  - active work summary: `project-knowledge/01-current/work-items.md`
+  - active work summary: `workspaces/fidelity/project-knowledge/01-current/work-items.md`
-  - project overview: `project-knowledge/03-context/project.md`
+  - project overview: `workspaces/fidelity/project-knowledge/03-context/project.md`
-  - systems: `project-knowledge/03-context/systems/`
+  - systems: `workspaces/fidelity/project-knowledge/03-context/systems/`
-  - workstreams: `project-knowledge/03-context/workstreams/`
+  - workstreams: `workspaces/fidelity/project-knowledge/03-context/workstreams/`
-  - process: `project-knowledge/03-context/process/`
+  - process: `workspaces/fidelity/project-knowledge/03-context/process/`
-  - manager mapping: `project-knowledge/04-people/manager.md`
+  - manager mapping: `workspaces/fidelity/project-knowledge/04-people/manager.md`
-  - people roster: `project-knowledge/04-people/index.md`
+  - people roster: `workspaces/fidelity/project-knowledge/04-people/index.md`
-  - people notes: `project-knowledge/04-people/*.md`
+  - people notes: `workspaces/fidelity/project-knowledge/04-people/*.md`
-  - decisions: `project-knowledge/05-decisions/`
+  - decisions: `workspaces/fidelity/project-knowledge/05-decisions/`
   - `.agents/workflows/*.md`
   - `.agents/rules/*.md`
   - `prompts/*.md`

.agents/workflows/translate.md

@@ -16,14 +16,14 @@ $ARGUMENTS
 Read:
 
 @prompts/mattermost-translation.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/process/communication.md
+@workspaces/fidelity/project-knowledge/03-context/process/communication.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
-@project-knowledge/04-people/index.md
+@workspaces/fidelity/project-knowledge/04-people/index.md
 
 If relevant, use today's log for context:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 Return:
 

.agents/workflows/workspace-context.md

@@ -14,14 +14,14 @@ Read core:
 
 Read active workspace memory:
 
-@project-knowledge/00-start/start-here.md
+@workspaces/fidelity/project-knowledge/00-start/start-here.md
-@project-knowledge/01-current/current-work.md
+@workspaces/fidelity/project-knowledge/01-current/current-work.md
-@project-knowledge/01-current/work-items.md
+@workspaces/fidelity/project-knowledge/01-current/work-items.md
-@project-knowledge/03-context/project.md
+@workspaces/fidelity/project-knowledge/03-context/project.md
-@project-knowledge/03-context/process/communication.md
+@workspaces/fidelity/project-knowledge/03-context/process/communication.md
-@project-knowledge/03-context/ios/index.md
+@workspaces/fidelity/project-knowledge/03-context/ios/index.md
-@project-knowledge/04-people/manager.md
+@workspaces/fidelity/project-knowledge/04-people/manager.md
-@project-knowledge/04-people/index.md
+@workspaces/fidelity/project-knowledge/04-people/index.md
 
 Read active profile, preferring the configured profile and falling back to Fidelity:
 
@@ -33,11 +33,11 @@ Today's date:
 
 Today's canonical daily note, if present:
 
-!`if [ -f project-knowledge/06-daily/$(date +%F).md ]; then cat project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
+!`if [ -f workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md ]; then cat workspaces/fidelity/project-knowledge/06-daily/$(date +%F).md; else echo "No daily note exists for today yet."; fi`
 
 Latest daily notes available:
 
-!`if [ -d project-knowledge/06-daily ]; then ls -1 project-knowledge/06-daily 2>/dev/null | sort | tail -n 3; else echo "No daily notes directory available."; fi`
+!`if [ -d workspaces/fidelity/project-knowledge/06-daily ]; then ls -1 workspaces/fidelity/project-knowledge/06-daily 2>/dev/null | sort | tail -n 3; else echo "No daily notes directory available."; fi`
 
 Detailed active work item files, if available:
 
@@ -45,13 +45,13 @@ Detailed active work item files, if available:
 import re
 from pathlib import Path
 
-summary = Path("project-knowledge/01-current/work-items.md")
+summary = Path("workspaces/fidelity/project-knowledge/01-current/work-items.md")
 if not summary.is_file():
     print("No work item files available.")
     raise SystemExit(0)
 
 text = summary.read_text()
-paths = re.findall(r"Detail: `(project-knowledge/02-work-items/[^`]+)`", text)
+paths = re.findall(r"Detail: `(workspaces/fidelity/project-knowledge/02-work-items/[^`]+)`", text)
 if not paths:
     print("No work item files available.")
     raise SystemExit(0)

.gitignore

@@ -8,13 +8,13 @@ __pycache__/
 .venv/
 
 # Mattermost raw inbox artifacts
-ai/inbox/mattermost-latest.md
+workspaces/*/inbox/mattermost-latest.md
-ai/inbox/mattermost-*.md
+workspaces/*/inbox/mattermost-*.md
-ai/inbox/mattermost-status.json
+workspaces/*/inbox/mattermost-status.json
-ai/inbox/mattermost-mirror/*
+workspaces/*/inbox/mattermost-mirror/*
-!ai/inbox/mattermost-mirror/.gitkeep
+!workspaces/*/inbox/mattermost-mirror/.gitkeep
-ai/inbox/photos/*
+workspaces/*/inbox/photos/*
-!ai/inbox/photos/.gitkeep
+!workspaces/*/inbox/photos/.gitkeep
 
 # Local build artifact for the iPhone photo inbox pasteboard helper
 scripts/iphone-photo-inbox/.env
@@ -29,14 +29,14 @@ scripts/mattermost-proxy/.env
 
 # Obsidian local runtime state
 /.obsidian/
-project-knowledge/.obsidian/workspace*.json
+workspaces/*/project-knowledge/.obsidian/workspace*.json
-project-knowledge/.obsidian/workspace-mobile*.json
+workspaces/*/project-knowledge/.obsidian/workspace-mobile*.json
-project-knowledge/.obsidian/graph.json
+workspaces/*/project-knowledge/.obsidian/graph.json
-project-knowledge/.obsidian/hotkeys.json
+workspaces/*/project-knowledge/.obsidian/hotkeys.json
-project-knowledge/.obsidian/community-plugins.json
+workspaces/*/project-knowledge/.obsidian/community-plugins.json
-project-knowledge/.obsidian/plugins/
+workspaces/*/project-knowledge/.obsidian/plugins/
-project-knowledge/.obsidian/snippets/
+workspaces/*/project-knowledge/.obsidian/snippets/
-project-knowledge/.obsidian/cache/
+workspaces/*/project-knowledge/.obsidian/cache/
 .trash/
 
 # Antigravity CLI local workspace configuration

.opencode/agents/fidelity.md

@@ -12,21 +12,21 @@ Behavior rules:
 
 - Treat `core/` as the reusable project-independent operating model.
 - Treat `profiles/fidelity/profile.md` as the active Fidelity project profile.
-- Treat `project-knowledge/` as the canonical clean project knowledge base for humans and AI.
+- Treat `workspaces/fidelity/project-knowledge/` as the canonical clean project knowledge base for humans and AI.
 - Treat `agent-memory/` as the operating memory for agent behavior, learning, promotion, verification, and self-maintenance rules.
 - Treat `scripts/memory/` as the project-agnostic access layer for note creation, project-knowledge search, Base queries, and health checks.
 - Treat `scripts/obsidian/` as the current Obsidian adapter. Do not couple durable memory rules to Obsidian-specific behavior.
-- Treat `ai/inbox/` and generated connector files as raw evidence only, not promoted memory.
+- Treat `workspaces/fidelity/inbox/` and generated connector files as raw evidence only, not promoted memory.
-- For Mattermost context, prefer the local proxy mirror in `ai/inbox/mattermost-mirror/` when present. Use `scripts/mattermost-proxy/read-context.py` or the mirror views (`latest.*`, `by-date/`, `channels/`, `threads/`) before falling back to legacy `ai/inbox/mattermost-latest.md` or `scripts/mattermost/generated/` artifacts.
+- For Mattermost context, prefer the local proxy mirror in `workspaces/fidelity/inbox/mattermost-mirror/` when present. Use `scripts/mattermost-proxy/read-context.py` or the mirror views (`latest.*`, `by-date/`, `channels/`, `threads/`) before falling back to legacy `workspaces/fidelity/inbox/mattermost-latest.md` or `scripts/mattermost/generated/` artifacts.
-- Keep Obsidian Bases clean: do not let templates in `project-knowledge/09-templates/` appear as real daily notes, work items, people, decisions, systems, or workstreams.
+- Keep Obsidian Bases clean: do not let templates in `workspaces/fidelity/project-knowledge/09-templates/` appear as real daily notes, work items, people, decisions, systems, or workstreams.
-- Role mapping notes such as `project-knowledge/04-people/manager.md` are `type: role-map`; actual people profiles are `type: person`.
+- Role mapping notes such as `workspaces/fidelity/project-knowledge/04-people/manager.md` are `type: role-map`; actual people profiles are `type: person`.
 - When editing canonical project notes, update useful metadata at the same time: `updated`, `systems`, `workstreams`, `people`, `related`, `focus`, `work-items`, and `blockers` when applicable.
 - When creating a new typed note, prefer `bash scripts/memory/memory.sh create <type> <slug> [title]`, then inspect and refine the generated Markdown.
 - When checking project knowledge quality, use `bash scripts/memory/memory.sh health` and direct file inspection.
 - Work item notes should preserve Jira ID/title and explicit relationships so standups, Bases, and graph navigation stay useful.
 - Daily notes should include `focus`, `work-items`, and `blockers` when those values are clear.
 - Before answering a prompt that depends on current state, verify the latest relevant files instead of relying only on conversation history.
-- If the prompt asks for the latest Mattermost message, the last message from Jeff/current manager, or what someone just said, refresh or read the freshest Mattermost evidence before answering; the proxy mirror is the primary source when it is present, and legacy sync artifacts are fallback evidence.
+- If the prompt asks for the latest Mattermost message, the last message from Jeff/current manager, or what someone just said, refresh or read the freshest Mattermost evidence before answering; the proxy mirror is the primary source when it is present, and configured sync artifacts are secondary evidence.
 - Treat latest-message prompts as read-first: answer from refreshed evidence and report memory update candidates instead of editing canonical memory by default.
 - For learning-style questions, answer from known context and verified facts only; explicitly label unknowns, assumptions, and inferences.
 - For learning sessions, prioritize durable architecture, process, ownership, debugging strategy, release mechanics, domain concepts, and decision rules over transient ticket status.
@@ -39,21 +39,21 @@ Behavior rules:
 - When the user corrects how the workspace should behave, update the linked operational surface too: commands in `.opencode/commands/`, prompt templates in `prompts/`, agent rules in `AGENTS.md` or `.opencode/agents/`, skills in `.agents/skills/`, and agent operating rules in `agent-memory/` when those files control the behavior.
 - If existing context is stale, correct it directly instead of leaving conflicting versions.
 - Promote information carefully:
-  - daily facts go to `project-knowledge/06-daily/YYYY-MM-DD.md`
+  - daily facts go to `workspaces/fidelity/project-knowledge/06-daily/YYYY-MM-DD.md`
-  - current priorities go to `project-knowledge/01-current/current-work.md`
+  - current priorities go to `workspaces/fidelity/project-knowledge/01-current/current-work.md`
-  - active Jira-linked work goes to `project-knowledge/02-work-items/*.md`
+  - active Jira-linked work goes to `workspaces/fidelity/project-knowledge/02-work-items/*.md`
-  - the active-work summary goes to `project-knowledge/01-current/work-items.md`
+  - the active-work summary goes to `workspaces/fidelity/project-knowledge/01-current/work-items.md`
-  - durable project knowledge overview goes to `project-knowledge/03-context/project.md`
+  - durable project knowledge overview goes to `workspaces/fidelity/project-knowledge/03-context/project.md`
-  - system-specific durable knowledge goes to `project-knowledge/03-context/systems/`
+  - system-specific durable knowledge goes to `workspaces/fidelity/project-knowledge/03-context/systems/`
-  - workstream-specific durable knowledge goes to `project-knowledge/03-context/workstreams/`
+  - workstream-specific durable knowledge goes to `workspaces/fidelity/project-knowledge/03-context/workstreams/`
-  - project-facing process knowledge goes to `project-knowledge/03-context/process/`
+  - project-facing process knowledge goes to `workspaces/fidelity/project-knowledge/03-context/process/`
-  - confirmed team or manager communication preferences go to `project-knowledge/04-people/manager.md`
+  - confirmed team or manager communication preferences go to `workspaces/fidelity/project-knowledge/04-people/manager.md`
-  - role-to-person mapping and recurring stakeholders go to `project-knowledge/04-people/`
+  - role-to-person mapping and recurring stakeholders go to `workspaces/fidelity/project-knowledge/04-people/`
-  - confirmed decisions go to `project-knowledge/05-decisions/`
+  - confirmed decisions go to `workspaces/fidelity/project-knowledge/05-decisions/`
 - behavioral rules for how this workspace should respond go to the exact command, prompt, agent, skill, or `agent-memory/` file that enforces that behavior
-- Use generic `AIW_*` integration variables for new tooling and keep `FIDELITY_*` only as Fidelity-profile aliases.
+- Use generic `AIW_*` integration variables for workspace tooling.
 - Default to writing new same-day information to today's log unless a more durable destination is clearly better.
-- Write canonical memory to `project-knowledge/`.
+- Write canonical memory to `workspaces/fidelity/project-knowledge/`.
 - Update preexisting memory when a new prompt clarifies or corrects something already stored.
 - Do not wait for a dedicated sync command if the correct memory update is already obvious.
 - For analysis, drafting, review, or translation prompts, answer first and persist second unless saving the fact is required to produce the answer safely.
@@ -63,7 +63,7 @@ Behavior rules:
 - If the memory interface or Obsidian adapter fails, continue with direct Markdown operations when safe and do not promote the failure as project memory.
 - Do not over-promote uncertain information. Keep uncertain items in the daily log.
 - When drafting communication, preserve technical meaning and improve clarity in natural US English.
-- When answering Swift/iOS programming questions, use the project-local iOS skills and `project-knowledge/03-context/ios/`.
+- When answering Swift/iOS programming questions, use the project-local iOS skills and `workspaces/fidelity/project-knowledge/03-context/ios/`.
 - When answering programming, dependency-management, package-manager, CI/build, testing, or architecture-practice questions, verify with primary/current documentation when the topic may be outdated, disputed, version-sensitive, or project-critical.
 - For CocoaPods, podspecs, private spec repos, trunk/CDN behavior, SPM, Xcode, Swift, and Apple frameworks, do not rely only on model memory before giving strong advice.
 - When generating prompts for GitHub Copilot or another AI, use `agent-memory/workflows/ai-to-ai-prompting.md` and the `copilot-prompt-engineering` skill.

.opencode/agents/workspace.md

@@ -12,12 +12,12 @@ Behavior rules:
 
 - Load `core/` first for project-independent operating rules.
 - Load the active profile from `AIW_PROJECT_PROFILE` when available; otherwise use the configured project files in this workspace.
-- Treat `project-knowledge/` as the canonical clean project knowledge base.
+- Treat `workspaces/fidelity/project-knowledge/` as the canonical clean project knowledge base.
 - Treat `agent-memory/` as the operating memory for agent behavior, learning, promotion, verification, and self-maintenance rules.
 - Treat `scripts/memory/` as the stable memory access layer.
 - Treat tool-specific integrations such as Obsidian as replaceable adapters.
-- Treat profile files as configuration and `ai/inbox/` plus generated connector files as raw evidence.
+- Treat profile files as configuration and `workspaces/fidelity/inbox/` plus generated connector files as raw evidence.
-- For live communication context, prefer project-local mirror evidence under `ai/inbox/*-mirror/` through its reader script when available, then fall back to legacy inbox/generated connector artifacts.
+- For live communication context, prefer project-local mirror evidence under `workspaces/fidelity/inbox/*-mirror/` through its reader script when available, then fall back to legacy inbox/generated connector artifacts.
 - Keep Obsidian Bases clean by excluding templates and typing role maps separately from people.
 - When updating canonical project notes, maintain relationship metadata and `updated` fields so project knowledge remains useful to both humans and agents.
 - Before answering current-state questions, inspect current state, active work items, recent logs, and inbox evidence when available.
@@ -39,11 +39,11 @@ Behavior rules:
 
 Memory destinations:
 
-- daily facts -> `project-knowledge/06-daily/YYYY-MM-DD.md`
+- daily facts -> `workspaces/fidelity/project-knowledge/06-daily/YYYY-MM-DD.md`
-- current priorities -> `project-knowledge/01-current/current-work.md`
+- current priorities -> `workspaces/fidelity/project-knowledge/01-current/current-work.md`
-- active work items -> `project-knowledge/02-work-items/*.md`
+- active work items -> `workspaces/fidelity/project-knowledge/02-work-items/*.md`
-- active-work summary -> `project-knowledge/01-current/work-items.md`
+- active-work summary -> `workspaces/fidelity/project-knowledge/01-current/work-items.md`
-- durable project knowledge -> `project-knowledge/03-context/`
+- durable project knowledge -> `workspaces/fidelity/project-knowledge/03-context/`
-- people and roles -> `project-knowledge/04-people/`
+- people and roles -> `workspaces/fidelity/project-knowledge/04-people/`
-- confirmed decisions -> `project-knowledge/05-decisions/`
+- confirmed decisions -> `workspaces/fidelity/project-knowledge/05-decisions/`
 - reusable behavior -> `.opencode/commands/`, `prompts/`, `.opencode/agents/`, `.agents/skills/`, `agent-memory/`, `core/`, or `scripts/`

.opencode/plugins/mattermost-inbox.js

@@ -20,9 +20,7 @@ function envFlag(name, defaultValue = false) {
 }
 
 async function resolveSyncCommand(directory) {
-  const configured =
+  const configured = process.env.AIW_MATTERMOST_SYNC_CMD?.trim()
-    process.env.AIW_MATTERMOST_SYNC_CMD?.trim() ||
-    process.env.FIDELITY_MATTERMOST_SYNC_CMD?.trim()
   if (configured) return configured
 
   const fallbackScript = path.join(directory, "scripts/mattermost/sync.sh")
@@ -43,6 +41,21 @@ async function resolveSyncContent(directory, stdoutText) {
   return (generated || "").trim()
 }
 
+async function resolveProfileInbox(directory) {
+  const profile = process.env.AIW_PROJECT_PROFILE?.trim() || "fidelity"
+  const configured = process.env.AIW_PROJECT_INBOX_DIR?.trim()
+  if (configured) return path.isAbsolute(configured) ? configured : path.join(directory, configured)
+
+  const workspaceConfigPath = path.join(directory, "profiles", profile, "workspace.json")
+  try {
+    const config = JSON.parse(await readFile(workspaceConfigPath, "utf8"))
+    const inboxDir = config?.inbox_dir || `workspaces/${profile}/inbox`
+    return path.isAbsolute(inboxDir) ? inboxDir : path.join(directory, inboxDir)
+  } catch {
+    return path.join(directory, "workspaces", profile, "inbox")
+  }
+}
+
 function extractPromptText(event) {
   const candidates = [
     event?.properties?.text,
@@ -101,7 +114,6 @@ function requiresFreshMattermost(promptText) {
     process.env.AIW_COMMUNICATION_FRESH_TERMS,
     process.env.AIW_MANAGER_NAME,
     process.env.AIW_PRIMARY_STAKEHOLDER,
-    process.env.FIDELITY_MANAGER_NAME,
     "jeff",
     "fidelity-preguntas",
   ]
@@ -133,7 +145,6 @@ export const MattermostInbox = async ({ $, directory, client }) => {
 
     const intervalMinutes = Number.parseInt(
       process.env.AIW_MATTERMOST_SYNC_INTERVAL_MINUTES ||
-        process.env.FIDELITY_MATTERMOST_SYNC_INTERVAL_MINUTES ||
         "15",
       10,
     )
@@ -144,14 +155,12 @@ export const MattermostInbox = async ({ $, directory, client }) => {
     lastSyncAt = now
     const syncStartedAt = Date.now()
 
-    const inboxDir = path.join(directory, "ai/inbox")
+    const inboxDir = await resolveProfileInbox(directory)
     const latestPath = path.join(inboxDir, "mattermost-latest.md")
     const statusPath = path.join(inboxDir, "mattermost-status.json")
 
     const commandSource = process.env.AIW_MATTERMOST_SYNC_CMD?.trim()
       ? "aiw-env"
-      : process.env.FIDELITY_MATTERMOST_SYNC_CMD?.trim()
-        ? "fidelity-env"
       : "workspace-default"
 
     try {

AGENTS.md

@@ -19,15 +19,15 @@ Keep the always-loaded context small. The hot set is:
 - `agent-memory/memory/promotion-rules.md`
 - `agent-memory/integrations/technical-verification.md`
 - `agent-memory/workflows/ai-to-ai-prompting.md`
-- `project-knowledge/00-start/start-here.md`
+- `workspaces/fidelity/project-knowledge/00-start/start-here.md`
-- `project-knowledge/01-current/current-work.md`
+- `workspaces/fidelity/project-knowledge/01-current/current-work.md`
-- `project-knowledge/01-current/work-items.md`
+- `workspaces/fidelity/project-knowledge/01-current/work-items.md`
-- `project-knowledge/03-context/project.md`
+- `workspaces/fidelity/project-knowledge/03-context/project.md`
-- `project-knowledge/03-context/process/communication.md`
+- `workspaces/fidelity/project-knowledge/03-context/process/communication.md`
-- `project-knowledge/03-context/ios/index.md`
+- `workspaces/fidelity/project-knowledge/03-context/ios/index.md`
-- `project-knowledge/03-context/ios/project-swift-guidance.md`
+- `workspaces/fidelity/project-knowledge/03-context/ios/project-swift-guidance.md`
-- `project-knowledge/04-people/manager.md`
+- `workspaces/fidelity/project-knowledge/04-people/manager.md`
-- `project-knowledge/04-people/index.md`
+- `workspaces/fidelity/project-knowledge/04-people/index.md`
 
 Load everything else lazily when the task actually needs it.
 
@@ -36,14 +36,14 @@ Do not preemptively load broad context sets, all work-item files, or all process
 ## Required Behavior
 
 - Assume the workspace may contain stale context until checked.
-- Treat `project-knowledge/` as the canonical clean project memory for humans and AI. Treat `agent-memory/` as agent operating memory. Treat `ai/inbox/` as raw evidence only.
+- Treat `workspaces/fidelity/project-knowledge/` as the canonical clean project memory for humans and AI. Treat `agent-memory/` as agent operating memory. Treat `workspaces/fidelity/inbox/` as raw evidence only.
 - Treat `scripts/memory/` as the project-agnostic interface for creating notes, searching memory, querying Bases, and running project knowledge health checks.
 - Treat `scripts/obsidian/` as the current Obsidian adapter, not as the core memory abstraction.
-- Keep Obsidian Bases clean: templates in `project-knowledge/09-templates/` must not be treated as real notes, and role mapping files such as `project-knowledge/04-people/manager.md` must not be typed as people.
+- Keep Obsidian Bases clean: templates in `workspaces/fidelity/project-knowledge/09-templates/` must not be treated as real notes, and role mapping files such as `workspaces/fidelity/project-knowledge/04-people/manager.md` must not be typed as people.
 - Maintain useful project-note properties when editing canonical notes, especially work-item relationships (`systems`, `workstreams`, `people`, `related`) and daily note fields (`focus`, `work-items`, `blockers`).
-- Before answering questions that depend on current work state, inspect `project-knowledge/01-current/current-work.md` and the latest relevant daily note under `project-knowledge/06-daily/`.
+- Before answering questions that depend on current work state, inspect `workspaces/fidelity/project-knowledge/01-current/current-work.md` and the latest relevant daily note under `workspaces/fidelity/project-knowledge/06-daily/`.
 - Prefer lazy loading over eager loading. Pull in only the smallest relevant files for the active task.
-- For Mattermost evidence, prefer the local proxy mirror under `ai/inbox/mattermost-mirror/` when present. Use `scripts/mattermost-proxy/read-context.py` or mirror views (`latest.*`, `by-date/`, `channels/`, `threads/`) before falling back to legacy `ai/inbox/mattermost-latest.md` or `scripts/mattermost/generated/` artifacts.
+- For Mattermost evidence, prefer the local proxy mirror under `workspaces/fidelity/inbox/mattermost-mirror/` when present. Use `scripts/mattermost-proxy/read-context.py` or mirror views (`latest.*`, `by-date/`, `channels/`, `threads/`) before falling back to legacy `workspaces/fidelity/inbox/mattermost-latest.md` or `scripts/mattermost/generated/` artifacts.
 - If the user asks for the latest/last/recent Mattermost message, the latest message from Jeff/current manager, or what someone just said, use the explicit latest-message flow and answer from the freshest refreshed evidence; the proxy mirror is primary when available.
 - If automatic refresh is uncertain and the proxy mirror is not available, run the Mattermost sync command, then answer from the refreshed inbox only.
 - Treat latest-message flows as read-first. Report memory update candidates, but do not edit canonical memory from that command unless the user explicitly asks to promote the fact.
@@ -60,12 +60,12 @@ Do not preemptively load broad context sets, all work-item files, or all process
 - Treat sync failures as operational errors, not project context.
 - If a patch or edit verification fails while making a non-essential memory update, stop retrying and return the user-facing answer with the failed target noted.
 - `mattermost-sync` should automatically promote high-confidence project facts without asking what to promote.
-- Prefer `project-knowledge/06-daily/` as the default destination for new Mattermost-derived facts.
+- Prefer `workspaces/fidelity/project-knowledge/06-daily/` as the default destination for new Mattermost-derived facts.
-- Promote to `project-knowledge/01-current/current-work.md` only when the fact materially changes active work over the next few days.
+- Promote to `workspaces/fidelity/project-knowledge/01-current/current-work.md` only when the fact materially changes active work over the next few days.
-- Keep explicit Jira IDs and approved titles visible in `project-knowledge/02-work-items/` and summarize active items in `project-knowledge/01-current/work-items.md` when they are useful for future standups or manager updates.
+- Keep explicit Jira IDs and approved titles visible in `workspaces/fidelity/project-knowledge/02-work-items/` and summarize active items in `workspaces/fidelity/project-knowledge/01-current/work-items.md` when they are useful for future standups or manager updates.
-- Promote to `project-knowledge/03-context/project.md` only when the fact changes durable project understanding.
+- Promote to `workspaces/fidelity/project-knowledge/03-context/project.md` only when the fact changes durable project understanding.
-- When a repeatedly mentioned person becomes relevant to project flow, create or update a file under `project-knowledge/04-people/`.
+- When a repeatedly mentioned person becomes relevant to project flow, create or update a file under `workspaces/fidelity/project-knowledge/04-people/`.
-- Keep role-to-person mapping explicit in `project-knowledge/04-people/manager.md` and the roster in `project-knowledge/04-people/index.md`.
+- Keep role-to-person mapping explicit in `workspaces/fidelity/project-knowledge/04-people/manager.md` and the roster in `workspaces/fidelity/project-knowledge/04-people/index.md`.
 - Never promote tooling chatter, sync status, or generic conversation noise.
 - Direct user prompts are also memory sources. Do not limit memory updates to explicit sync commands.
 - If a new prompt corrects prior understanding, update the canonical file directly instead of keeping both versions alive.
@@ -77,8 +77,8 @@ Do not preemptively load broad context sets, all work-item files, or all process
 - If a previous context file is now stale or inaccurate, update that file directly.
 - Prefer correcting canonical context over appending contradictory notes.
 - Keep changes concise and auditable.
-- When the topic is architectural or historical, prefer updating the relevant file under `project-knowledge/03-context/systems/`, `project-knowledge/03-context/workstreams/`, or project-facing `project-knowledge/03-context/process/` instead of overloading `project-knowledge/03-context/project.md`.
+- When the topic is architectural or historical, prefer updating the relevant file under `workspaces/fidelity/project-knowledge/03-context/systems/`, `workspaces/fidelity/project-knowledge/03-context/workstreams/`, or project-facing `workspaces/fidelity/project-knowledge/03-context/process/` instead of overloading `workspaces/fidelity/project-knowledge/03-context/project.md`.
-- When the user asks Swift, SwiftUI, iOS architecture, testing, or debugging questions, use `project-knowledge/03-context/ios/` and the local OpenCode iOS skills before answering.
+- When the user asks Swift, SwiftUI, iOS architecture, testing, or debugging questions, use `workspaces/fidelity/project-knowledge/03-context/ios/` and the local OpenCode iOS skills before answering.
 - When the user asks about programming concepts, dependency tooling, package managers, CI/build tooling, testing frameworks, or practices that may be outdated or opinion-sensitive, verify against primary/current documentation before making strong claims.
 - For CocoaPods, podspecs, private specs repos, trunk/CDN behavior, Swift Package Manager, Xcode, Swift, Apple frameworks, and similar project-linked tooling, do not rely only on memory.
 - When the user asks for a prompt for another AI, GitHub Copilot, or the Fidelity development machine, use `agent-memory/workflows/ai-to-ai-prompting.md` and generate a self-contained prompt.

DECOMMISSIONED.md

@@ -0,0 +1,24 @@
+# Decommissioned Workspace
+
+This repository is no longer the active AIWorkspace runtime.
+
+As of 2026-05-22, the active split is:
+
+- reusable core: `/Users/david/Developer/ai-workspace`
+- Fidelity context pack: `/Users/david/Developer/fidelity-ai-context`
+- local project registry: `~/Library/Application Support/AIWorkspace/projects.json`
+- runtime state: `~/Library/Application Support/AIWorkspace/runtime/`
+- logs: `~/Library/Logs/AIWorkspace/`
+
+Do not start services from this repository unless intentionally rolling back.
+
+Use the new core instead:
+
+```bash
+cd /Users/david/Developer/ai-workspace
+python3 scripts/aiw/services.py status --project fidelity
+python3 scripts/aiw/services.py doctor --project fidelity
+```
+
+The old profile-based service manager may report services as `externally running`
+because the new core owns the same health ports.

GEMINI.md

@@ -7,9 +7,9 @@ Shared rules and context already live in the normal workspace files. Do not dupl
 Read these first:
 
 @./AGENTS.md
-@./project-knowledge/00-start/start-here.md
+@./workspaces/fidelity/project-knowledge/00-start/start-here.md
-@./project-knowledge/01-current/current-work.md
+@./workspaces/fidelity/project-knowledge/01-current/current-work.md
-@./project-knowledge/01-current/work-items.md
+@./workspaces/fidelity/project-knowledge/01-current/work-items.md
 
 ## Tool Surface
 
@@ -17,7 +17,7 @@ Read these first:
 - `.agents/` is the canonical shared cross-platform surface for workflows and reusable rule/skill content.
 - `.opencode/` is the OpenCode compatibility/runtime surface.
 - `.agent/` is an alias for tools that expect the singular directory naming.
-- `project-knowledge/` is canonical project memory.
+- `workspaces/fidelity/project-knowledge/` is canonical project memory.
 - `agent-memory/` is agent operating memory.
 
 ## Gemini-Specific Operating Notes
@@ -26,4 +26,4 @@ Read these first:
 - Follow `AGENTS.md` as the shared source of truth for answer-first behavior, memory promotion, and lazy loading.
 - For analysis, review, translation, or drafting prompts, answer first and persist second unless saving the fact is clearly required to produce a safe answer.
 - Do not create new canonical notes in the critical path of a simple answer unless the user explicitly asked to save the information or the destination is obvious and non-blocking.
-- When memory should be updated, prefer the smallest correct change to `project-knowledge/` and avoid duplicating stale and corrected versions.
+- When memory should be updated, prefer the smallest correct change to `workspaces/fidelity/project-knowledge/` and avoid duplicating stale and corrected versions.

README.md

@@ -1,368 +1,216 @@
-# AI Workspace - Fidelity Profile
+# AI Workspace
 
-Reusable AI-native companion workspace with Fidelity configured as the first real project profile.
+> **Decommissioned:** this repository is no longer the active AIWorkspace runtime.
+> Active services now run from `/Users/david/Developer/ai-workspace`, and Fidelity
+> context lives in `/Users/david/Developer/fidelity-ai-context`. See
+> [`DECOMMISSIONED.md`](DECOMMISSIONED.md) before using this repo.
 
-This repository is not the product codebase. It is an operational context layer used to keep project state current, capture communication evidence, prepare standups, draft clear stakeholder updates, and generate self-contained prompts for another AI that has access to the implementation codebase.
+AI Workspace is a local, profile-based companion workspace for AI-assisted professional work. It keeps project memory, raw evidence, local services, and AI client integrations organized so agents can work from current, auditable context instead of chat history alone.
 
-The reusable logic lives in `core/`. The clean project second brain lives in `project-knowledge/`. Agent operating memory lives in `agent-memory/`. Fidelity-specific setup lives in the active profile under `profiles/fidelity/`.
+The first real profile in this repository is `fidelity`, but the reusable model is intentionally project-independent.
 
-Shared cross-platform workflow/rule content lives in `.agents/`. OpenCode reads that content through `.opencode/` compatibility paths, and Gemini-compatible entry context starts at `GEMINI.md`.
+## What This Repo Is
 
----
+Use this repository beside your real implementation work to:
 
-## Purpose
+- maintain human-readable project memory;
+- capture communication or screenshot evidence before curation;
+- generate standups, stakeholder updates, and AI-to-AI prompts;
+- expose bounded local context to AI clients through MCP;
+- manage local services such as capture tools, context servers, and inbox helpers;
+- support long-running AI workflows with durable state artifacts.
 
-- Provide a reusable file-based AI workspace pattern
+This repository is not the product codebase. It is a context and workflow layer.
-- Keep Fidelity context current outside the main development machine
-- Turn fragmented daily work into reusable AI-ready context
-- Support standups, manager updates, Jira notes, and debugging summaries
-- Generate high-quality prompts for GitHub Copilot or another AI on the Fidelity development machine
-- Improve communication quality without losing technical accuracy
 
----
+## Architecture At A Glance
 
-## Operating Model
+```text
-
+Communication / photos / archives / manual notes
-You work on Fidelity from a different machine.
+        ↓
-
+Raw profile inbox evidence
-This workspace is used to:
+        ↓
-
+Human or agent curation
-- record what happened during implementation and debugging
+        ↓
-- sync relevant communication from Mattermost
+Canonical Markdown project knowledge
-- preserve current project context between sessions
+        ↓
-- draft messages for the current manager or stakeholder with the right tone and scope
+Derived local index
-- translate rough notes into concise native-sounding English
+        ↓
-- generate self-contained prompts for another AI that does have access to the product codebase
+Read-only MCP context server
+        ↓
+OpenCode / Claude Code / Copilot / Antigravity / other AI clients
+```
 
 Core principle:
 
-Context must be updated before asking AI to write.
+```text
+Markdown project knowledge is canonical. Inboxes, indexes, chat memory, and cloud memory are supporting layers.
+```
 
-Reusable principle:
+## Main Folders
 
-Integrations extract evidence. The agent promotes memory.
+| Path | Purpose |
+|---|---|
+| `docs/` | Simple project-independent documentation for developers adopting the workspace |
+| `core/` | Reusable operating model and architecture notes |
+| `profiles/` | Project-specific configuration and assumptions |
+| `workspaces/<profile>/project-knowledge/` | Profile-owned canonical Markdown vault |
+| `agent-memory/` | Agent behavior, promotion, verification, and workflow memory |
+| `workspaces/<profile>/inbox/` | Profile-owned raw evidence before promotion into canonical memory |
+| `scripts/aiw/` | Service manager and local indexer |
+| `scripts/mcp/` | MCP servers exposing bounded local context |
+| `scripts/memory/` | Project-agnostic interface for canonical memory operations |
+| `scripts/obsidian/` | Current Obsidian adapter |
+| `scripts/mattermost-proxy/` | Mattermost proxy mirror connector for local evidence capture |
+| `scripts/iphone-photo-inbox/` | Local photo inbox receiver |
+| `apps/mac/AIWorkspace/` | macOS menu bar app for service visibility and control |
 
----
+## Quick Start
 
-## Reusable Architecture
+Run basic checks for the active profile:
 
-### /project-knowledge
+```bash
+python3 scripts/aiw/services.py doctor --profile fidelity
+python3 scripts/aiw/services.py status --profile fidelity
+python3 scripts/aiw/indexer.py build --profile fidelity
+```
 
-Canonical Obsidian second brain and transferable project knowledge.
+Start the read-only context MCP server:
 
-- `00-start/` -> onboarding, glossary, and start-here
+```bash
-- `01-current/` -> current work and active work-item summary
+python3 scripts/aiw/services.py start aiw-context-mcp --profile fidelity
-- `02-work-items/` -> ticket/task notes with metadata properties
+```
-- `03-context/` -> systems, workstreams, project-facing process, and iOS context
-- `04-people/` -> people, roles, and collaboration context
-- `05-decisions/` -> durable decisions
-- `06-daily/` -> daily notes
-- `07-maps/` -> graph hubs and semantic maps
-- `08-bases/` -> Obsidian Bases
-- `09-templates/` -> Obsidian templates
-- `attachments/` -> vault assets
 
-### /agent-memory
+HTTP endpoint:
 
-Agent operating memory.
+```text
+http://127.0.0.1:8765/mcp
+```
 
-- `behavior/` -> agent learning and self-maintenance rules
+Health endpoint:
-- `memory/` -> promotion, correction, and context-maintenance rules
-- `integrations/` -> memory interface, Obsidian adapter, communication sources, and technical verification
-- `workflows/` -> AI-to-AI prompting and workspace behavior model
-- `maps/` -> agent-side navigation maps
 
-### /.agents
+```text
+http://127.0.0.1:8765/health
+```
 
-Shared cross-platform workflow and rule source.
+## Documentation
 
-- `workflows/` -> reusable workflow definitions used by OpenCode-compatible commands and Antigravity-compatible workflow views
+Start here:
-- `rules/` -> reusable skill/rule content
-- `skills/` -> skill-path compatibility layer pointing at `rules/`
 
-### /.opencode
+- [Getting Started](docs/getting-started.md)
+- [Architecture](docs/architecture.md)
+- [Profiles](docs/profiles.md)
+- [Memory Model](docs/memory-model.md)
+- [MCP](docs/mcp.md)
+- [Services](docs/services.md)
+- [Local RAG Index](docs/local-rag-index.md)
+- [Security and Privacy](docs/security-and-privacy.md)
 
-OpenCode runtime surface.
+Profile-specific project knowledge starts at:
 
-- `commands/` -> OpenCode slash commands, currently linked to `.agents/workflows/`
+- `workspaces/fidelity/project-knowledge/00-start/start-here.md` for the current Fidelity vault
-- `skills/` -> OpenCode skills, currently linked to shared `.agents/` content
+- `profiles/fidelity/profile.md` for the Fidelity profile declaration
-- `agents/` -> OpenCode agent definitions
+- `profiles/example/profile.md` for a sanitized reusable profile example
-- `plugins/` -> OpenCode-specific plugins
 
-### /core
+## Profiles
 
-Project-independent workspace logic.
+A profile represents one project, client, team, or workflow. It declares project assumptions, context sources, local services, and workflow defaults.
 
-- `README.md` -> reusable operating model
+Current profiles:
-- `memory/operational-memory.md` -> reusable memory classes, promotion rules, correction rules, self-maintenance rules
-- `integrations/communication-model.md` -> live communication and historical archive connector contract
-- `profiles/create-project-profile.md` -> checklist for adapting the workspace to another project
 
-### /profiles
+```text
+profiles/fidelity/
+profiles/example/
+```
 
-Project-specific configuration.
+Each profile resolves memory and inbox paths from `profiles/<profile>/workspace.json`. Fidelity data now lives under `workspaces/fidelity/`.
 
-- `profiles/fidelity/` -> active Fidelity implementation profile
+## Memory Model
-- `profiles/example/` -> non-sensitive example profile for new projects
 
-Profiles declare project assumptions, communication sources, work-item system, stakeholders, enabled commands, and enabled skills.
+The workspace separates memory by responsibility:
 
----
+- `workspaces/<profile>/project-knowledge/`: canonical project facts for humans and AI;
+- `workspaces/<profile>/inbox/`: raw evidence;
+- `agent-memory/`: rules for how agents behave;
+- `.aiw/indexes/`: derived local search indexes;
+- external systems such as mem9: optional agent recall, not project truth.
 
-## Project Scope
+Do not treat generated connector output or vector indexes as authoritative memory. Promote durable facts into the smallest correct Markdown file.
 
-Fidelity iOS ecosystem:
+## MCP Model
 
-- Fid4
+`aiw-context-mcp` exposes profile-bounded, read-only context through MCP tools and resources. It does not capture traffic, send messages, or promote memory.
-- XFlowSDK
-- FTFrameworks
-- REST migration replacing GraphQL over time
-- Discourse and AO issues that require careful classification
 
----
+Current examples:
 
-## Runtime Structure
+- `project_current_context`
+- `project_search_memory`
+- `memory_hybrid_search`
+- `communication_latest`
+- `communication_standup_context`
+- `photos_latest`
 
-### /ai
+## Service Manager
 
-Runtime inbox for communication evidence.
+The service manager provides a single local lifecycle surface:
 
-- `inbox/` -> communication evidence and transient inbox files before promotion into `project-knowledge/`
+```bash
+python3 scripts/aiw/services.py start --profile fidelity
+python3 scripts/aiw/services.py stop --profile fidelity
+python3 scripts/aiw/services.py status --profile fidelity --json
+python3 scripts/aiw/services.py logs aiw-context-mcp --profile fidelity
+```
 
-### /prompts
+Runtime logs, PID files, and state live under `.aiw/runtime/` and are ignored.
 
-Reusable prompts for:
+## Local Index
 
-- standups
+Build a derived search index over canonical Markdown:
-- Mattermost updates
-- manager communication
-- issue clarification
 
-### /workflows
+```bash
+python3 scripts/aiw/indexer.py build --profile fidelity
+python3 scripts/aiw/indexer.py search "dismissal lifecycle" --profile fidelity
+```
 
-Repeatable working guides for:
+Indexes live under `.aiw/indexes/` and are ignored because they are rebuildable local artifacts.
 
-- daily context sync
+## Security Defaults
-- flow debugging
-- external issue analysis
 
-### /scripts
+- Keep secrets in ignored `.env` files.
+- Do not commit raw tokens, cookies, session IDs, or captured headers.
+- Keep MCP read-only by default.
+- Treat inboxes and generated indexes as sensitive local artifacts.
+- Use cloud memory systems only with an explicit data policy.
 
-Helpers for automation around memory access, context generation, communication drafting, and imports.
+## Tests
 
-- `scripts/aiw/` -> local AI Workspace service manager for profile services such as the Mattermost proxy mirror, Photo Inbox, and context MCP
+```bash
-- `scripts/mcp/` -> local MCP servers that expose bounded read-only workspace context to AI clients
+python3 scripts/aiw/test_services.py
-- `scripts/memory/` -> project-agnostic interface for canonical memory
+python3 scripts/aiw/test_profile.py
-- `scripts/obsidian/` -> current Obsidian adapter and URI helpers
+python3 scripts/aiw/test_indexer.py
-- `scripts/mattermost/` -> live communication connector
+python3 scripts/mcp/aiw-context-mcp/test_server.py
-- `scripts/slack/` -> historical archive importer
+python3 scripts/iphone-photo-inbox/test_receiver.py
+```
 
-### /project-knowledge/.obsidian
+## Adoption Strategy
 
-Optional Obsidian vault configuration.
+Recommended order for new projects:
 
-Open `project-knowledge/` as the Obsidian vault. Do not open the repository root as the vault.
+1. Create an isolated profile:
 
-Portable vault configuration can be versioned, while local layout and plugin runtime files are ignored.
+   ```bash
+   python3 scripts/aiw/profile.py create my-project --display-name "My Project"
+   ```
 
-Obsidian is the current visual interface over canonical memory. The reusable memory access layer is `scripts/memory/`, so the workspace can later swap Obsidian for another Markdown knowledge tool without changing the memory model.
+2. Configure only the services the project needs.
+3. Keep raw evidence outside canonical memory.
+4. Build the local index.
+5. Connect AI clients through MCP.
+6. Promote durable facts into Markdown as work progresses.
 
----
+Validate the profile layout with:
 
-## Daily Usage
+```bash
+python3 scripts/aiw/profile.py doctor --profile my-project
+```
 
-### Start of day
+The reusable core should not depend on a company name, ticket prefix, channel name, programming stack, or AI client.
-
-Read:
-
-- `project-knowledge/00-start/start-here.md`
-- `project-knowledge/01-current/current-work.md`
-- `project-knowledge/01-current/work-items.md`
-- `project-knowledge/03-context/project.md`
-- `project-knowledge/04-people/manager.md`
-- `project-knowledge/04-people/index.md`
-- latest file under `project-knowledge/06-daily/`
-
-### During the day
-
-Capture:
-
-- implementation progress from the main development machine
-- Mattermost conversations that change scope or priorities
-- debugging findings
-- open questions, blockers, and follow-ups
-
-Write updates in:
-
-- `project-knowledge/06-daily/YYYY-MM-DD.md`
-
-### Before sending a message
-
-Confirm:
-
-- context
-- current observation
-- requested or implied action
-- whether the issue is external behavior or regression
-- whether the flow is authenticated or non-authenticated
-
-### End of day
-
-Update:
-
-- today log
-- current state
-- next communication needs for the current manager or stakeholder
-
----
-
-## Expected Output
-
-This workspace should help produce:
-
-- high-signal standups
-- clearer Mattermost updates
-- concise supervisor communication
-- better issue framing
-- more reliable AI-generated English
-
----
-
-## OpenCode Entry Point
-
-This workspace is designed to work well with the OpenCode VS Code extension.
-
-Recommended usage:
-
-1. Open this repository as its own VS Code workspace.
-2. Start OpenCode from the integrated terminal at the repository root.
-3. Begin each session with `/workspace-context` or the Fidelity alias `/fidelity-context`.
-4. As new information appears during the day, update context before asking for drafting help.
-
-Project commands live under `.opencode/commands/` and are intended to:
-
-- load the reusable core plus active project profile
-- sync live communication context into the workspace inbox
-- draft standups
-- draft manager updates
-- draft prompts for another AI on the implementation machine
-- force-refresh and inspect latest communication messages
-- convert rough notes into daily log updates
-
-This keeps AI output tied to the latest workspace state instead of relying on chat memory alone.
-
-Cross-platform note:
-
-- `.agents/` is the shared source of truth for reusable workflows/rules
-- `.opencode/` is the OpenCode execution layer
-- `.agent/` may exist as a naming alias for tools that look for singular agent directories
-- `GEMINI.md` is the Gemini CLI entrypoint for shared workspace context
-
----
-
-## Generic Commands
-
-- `/workspace-context` -> load core plus active profile
-- `/memory-health` -> check canonical memory and adapter health
-- `/memory-create` -> create a typed canonical note through the memory interface
-- `/communication-sync` -> sync live communication evidence and promote high-confidence memory
-- `/archive-import` -> import historical archive evidence
-- `/ai-prompt` -> generate a self-contained prompt for another AI
-- `/standup` -> generate a work-item-aware daily standup
-- `/manager-update` -> draft stakeholder-ready status
-- `/translate` -> rewrite rough notes into professional English
-- `/sync-context` -> incorporate new facts or corrections into memory
-
-Compatibility aliases remain available for the Fidelity profile:
-
-- `/fidelity-context`
-- `/mattermost-sync`
-- `/slack-import`
-- `/copilot-prompt`
-- `/swift-help`
-
----
-
-## Communication Memory Flow
-
-This workspace supports a live-memory pattern for communication sources such as Mattermost.
-
-Recommended setup:
-
-1. Use the workspace-local script at `scripts/mattermost/sync.sh`, or override it with `AIW_MATTERMOST_SYNC_CMD`.
-2. Let OpenCode run with the project plugins enabled.
-3. The Mattermost inbox plugin will periodically refresh `ai/inbox/mattermost-latest.md`.
-4. Promote durable facts from the inbox into `project-knowledge/06-daily/`, `project-knowledge/01-current/`, `project-knowledge/02-work-items/`, and `project-knowledge/03-context/`.
-
-Use `/communication-sync` or `/mattermost-sync` when you want to force a refresh manually.
-
-Generic environment variables:
-
-- `AIW_PROJECT_PROFILE`
-- `AIW_CHANNEL_PREFIX`
-- `AIW_MATTERMOST_SYNC_CMD`
-- `AIW_MATTERMOST_SYNC_INTERVAL_MINUTES`
-- `AIW_SLACK_EXPORT_PATH`
-
-The `FIDELITY_*` variables remain supported as Fidelity-profile aliases, but new reusable setup should prefer `AIW_*`.
-
----
-
-## Project Knowledge Vault
-
-Open `project-knowledge/` as the Obsidian vault. The repository root remains the technical workspace for OpenCode, scripts, profiles, runtime inboxes, and generated evidence.
-
-Recommended entry point:
-
-- `project-knowledge/00-start/start-here.md`
-- `project-knowledge/00-start/onboarding.md` for new members
-- `project-knowledge/00-start/glossary.md` for terminology
-- `project-knowledge/07-maps/` for graph hubs
-
-Use Obsidian for:
-
-- visual navigation
-- graph/backlink review
-- manual review of work items, people, decisions, and logs
-- lightweight editing of the same Markdown memory files
-
-Do not use Obsidian as a second memory database. The source of truth remains the versioned Markdown files under `project-knowledge/`.
-
-Runtime/evidence stays outside the vault:
-
-- `.opencode/`
-- `scripts/`
-- `core/`
-- `profiles/`
-- `ai/inbox/`
-- `scripts/*/generated/`
-
-Ignored Obsidian runtime files include workspace layout, plugin cache, snippets, and local plugin installs.
-
-Project-agnostic memory helpers live under `scripts/memory/`:
-
-- `scripts/memory/memory.sh create <type> <slug> [title]`
-- `scripts/memory/memory.sh search <query> [folder]`
-- `scripts/memory/memory.sh base-query <base-name> [format]`
-- `scripts/memory/memory.sh health`
-
-Obsidian adapter helpers live under `scripts/obsidian/`:
-
-- `scripts/obsidian/cli.sh <obsidian-cli-command>`
-- `scripts/obsidian/open.sh <vault-relative-path>`
-- `scripts/obsidian/daily.sh`
-- `scripts/obsidian/search.sh <query>`
-- `scripts/obsidian/uri.sh <action> key=value`
-
----
-
-## Creating Another Project
-
-1. Copy `profiles/example/` to `profiles/<project>/`.
-2. Fill in `profiles/<project>/profile.md`.
-3. Set `AIW_PROJECT_PROFILE=<project>`.
-4. Configure any communication connector with `AIW_*` variables.
-5. Create or adapt `project-knowledge/` for the project-specific canonical memory.
-6. Use `/workspace-context` to load the core plus active profile.
-
-See `core/profiles/create-project-profile.md` for the full checklist.

agent-memory/README.md

@@ -11,7 +11,7 @@ tags:
 
 This folder contains the operating memory for the AI agent.
 
-It is not Fidelity project documentation. Do not transfer this folder as project knowledge for a new engineer. Transfer `project-knowledge/` for the project second brain, and use this folder to explain how the agent should maintain that knowledge.
+It is not Fidelity project documentation. Do not transfer this folder as project knowledge for a new engineer. Transfer `workspaces/fidelity/project-knowledge/` for the project second brain, and use this folder to explain how the agent should maintain that knowledge.
 
 ---
 
@@ -28,8 +28,8 @@ It is not Fidelity project documentation. Do not transfer this folder as project
 
 ## Relationship To Project Knowledge
 
-- `project-knowledge/` is the clean Obsidian vault and project second brain.
+- `workspaces/fidelity/project-knowledge/` is the clean Obsidian vault and project second brain.
 - `agent-memory/` is the agent operating manual.
-- `ai/inbox/` and connector `generated/` folders are evidence, not canonical memory.
+- `workspaces/fidelity/inbox/` and connector `generated/` folders are evidence, not canonical memory.
 - `scripts/memory/` is the project-agnostic interface for reading, searching, creating, querying, and validating project knowledge.
 - `scripts/obsidian/` is the current Obsidian adapter and must not become the core abstraction.

agent-memory/behavior/agent-behavior.md

@@ -27,10 +27,10 @@ This applies to:
 - debugging discussions
 - corrections to previous understanding
 
-The agent must not wait for a separate promotion command. The agent should proactively update `project-knowledge/` (including 01-current, 02-work-items, 03-context, 04-people, 06-daily) within the same conversational turn when new information is clear, durable, and the destination is obvious.
+The agent must not wait for a separate promotion command. The agent should proactively update `workspaces/fidelity/project-knowledge/` (including 01-current, 02-work-items, 03-context, 04-people, 06-daily) within the same conversational turn when new information is clear, durable, and the destination is obvious.
 
-- When editing `project-knowledge/`, write as a human engineer maintaining shared project documentation.
+- When editing `workspaces/fidelity/project-knowledge/`, write as a human engineer maintaining shared project documentation.
-- Keep agent-operating logic out of `project-knowledge/`; store that logic in prompts, commands, skills, agents, or `agent-memory/`.
+- Keep agent-operating logic out of `workspaces/fidelity/project-knowledge/`; store that logic in prompts, commands, skills, agents, or `agent-memory/`.
 - Answer-first rule: when the user's main goal is analysis, review, translation, or drafting, answer first unless persistence is required to avoid losing a clear durable fact.
 - Do not create a brand-new canonical note during the critical path of the answer unless the user explicitly asked to save the fact or the new note is the smallest correct update.
 - Prefer updating an existing canonical note over creating a new file when both are valid.
@@ -71,7 +71,7 @@ Avoid low-value learning-session questions such as:
 - whether a specific PR was approved today
 - whether a ticket moved columns today
 - what the next standup line should be
-- temporary sequencing questions that belong in `project-knowledge/01-current/` or `project-knowledge/06-daily/`
+- temporary sequencing questions that belong in `workspaces/fidelity/project-knowledge/01-current/` or `workspaces/fidelity/project-knowledge/06-daily/`
 
 Prefer high-value questions such as:
 
@@ -130,7 +130,7 @@ Examples:
 - A standup formatting correction should update `prompts/standup.md` and the shared workflow in `.agents/workflows/standup.md`.
 - A Mattermost freshness correction should update the Mattermost command/plugin instructions.
 - A Copilot prompt-structure correction should update `prompts/copilot-prompt.md`, `.agents/workflows/copilot-prompt.md`, or the shared skill/rule source.
-- A Swift answer-quality correction should update the relevant iOS skill or `project-knowledge/03-context/ios/` guidance.
+- A Swift answer-quality correction should update the relevant iOS skill or `workspaces/fidelity/project-knowledge/03-context/ios/` guidance.
 
 Keep the daily log as evidence of what happened, but make the reusable behavior live in the file that controls that behavior.
 
@@ -138,7 +138,7 @@ Keep the daily log as evidence of what happened, but make the reusable behavior
 
 ## File Selection
 
-### `project-knowledge/06-daily/YYYY-MM-DD.md`
+### `workspaces/fidelity/project-knowledge/06-daily/YYYY-MM-DD.md`
 
 Default destination for:
 
@@ -148,7 +148,7 @@ Default destination for:
 - story and approval movement
 - context that is important now but may evolve later
 
-### `project-knowledge/01-current/current-work.md`
+### `workspaces/fidelity/project-knowledge/01-current/current-work.md`
 
 Use when the fact changes the active work window, including:
 
@@ -157,28 +157,28 @@ Use when the fact changes the active work window, including:
 - current blockers or debugging constraints
 - manager direction that changes the next few days of work
 
-### `project-knowledge/02-work-items/*.md` and `project-knowledge/01-current/work-items.md`
+### `workspaces/fidelity/project-knowledge/02-work-items/*.md` and `workspaces/fidelity/project-knowledge/01-current/work-items.md`
 
-Use `project-knowledge/02-work-items/*.md` as the canonical memory for current Jira-linked work that should remain easy to reference across sessions, especially:
+Use `workspaces/fidelity/project-knowledge/02-work-items/*.md` as the canonical memory for current Jira-linked work that should remain easy to reference across sessions, especially:
 
 - Jira IDs
 - approved or explicit titles
 - currently relevant status notes
 - current points or scope notes
 
-Use `project-knowledge/01-current/work-items.md` as the summary view of what is active now.
+Use `workspaces/fidelity/project-knowledge/01-current/work-items.md` as the summary view of what is active now.
 
 These files should help standups and manager updates mention work items precisely.
 
-### `project-knowledge/03-context/project.md`
+### `workspaces/fidelity/project-knowledge/03-context/project.md`
 
 Use for durable project knowledge that should survive beyond the current work window.
 
-### `project-knowledge/04-people/manager.md`
+### `workspaces/fidelity/project-knowledge/04-people/manager.md`
 
 Use only when a communication preference or manager expectation becomes stable enough to reuse repeatedly.
 
-### `project-knowledge/04-people/index.md` and `project-knowledge/04-people/*.md`
+### `workspaces/fidelity/project-knowledge/04-people/index.md` and `workspaces/fidelity/project-knowledge/04-people/*.md`
 
 Use these files for:
 
@@ -192,7 +192,7 @@ When the role is not explicit, store:
 - what kinds of topics they influence
 - how they affect approvals, scope, debugging, or communication
 
-### `project-knowledge/05-decisions/*.md`
+### `workspaces/fidelity/project-knowledge/05-decisions/*.md`
 
 Use for explicit confirmed decisions with ongoing impact.
 

agent-memory/behavior/self-maintenance.md

@@ -21,7 +21,7 @@ The agent must keep the workspace behavior aligned with recurring user correctio
 - Update `.opencode/agents/` and `AGENTS.md` for default agent behavior.
 - Update `.agents/skills/` for specialized workflows.
 - Update `agent-memory/` for reusable agent operating rules.
-- Update `project-knowledge/` only when the correction changes project knowledge or project-facing process documentation.
+- Update `workspaces/fidelity/project-knowledge/` only when the correction changes project knowledge or project-facing process documentation.
 
 ---
 

agent-memory/integrations/communication-sources.md

@@ -17,24 +17,24 @@ Communication connectors extract evidence. The agent decides what to promote.
 
 Mattermost is the current live communication connector.
 
-- Primary local evidence is the Mattermost proxy mirror under `ai/inbox/mattermost-mirror/` when present.
+- Primary local evidence is the Mattermost proxy mirror under `workspaces/fidelity/inbox/mattermost-mirror/` when present.
-- Prefer `ai/inbox/mattermost-mirror/latest.md` / `latest.jsonl` for latest-message context, `by-date/YYYY/MM/YYYY-MM-DD.jsonl` for daily/standup context, `channels/<channel>/YYYY/MM/YYYY-MM-DD.jsonl` for channel-specific context, and `threads/<root-or-post-id>.jsonl` for thread-specific context.
+- Prefer `workspaces/fidelity/inbox/mattermost-mirror/latest.md` / `latest.jsonl` for latest-message context, `by-date/YYYY/MM/YYYY-MM-DD.jsonl` for daily/standup context, `channels/<channel>/YYYY/MM/YYYY-MM-DD.jsonl` for channel-specific context, and `threads/<root-or-post-id>.jsonl` for thread-specific context.
-- Use `scripts/mattermost-proxy/read-context.py` from commands/workflows instead of reading ad hoc files; it prefers the proxy mirror and falls back to legacy sync artifacts.
+- Use `scripts/mattermost-proxy/read-context.py` from commands/workflows instead of reading ad hoc files; it prefers the profile proxy mirror and can read configured sync artifacts when a mirror is unavailable.
-- Legacy fresh output may still go to `ai/inbox/mattermost-latest.md`.
+- Legacy fresh output may still go to `workspaces/fidelity/inbox/mattermost-latest.md`.
 - Legacy generated extraction artifacts stay under `scripts/mattermost/generated/`.
 - Failed syncs must not update project knowledge.
 - Latest-message requests must refresh Mattermost before answering.
-- Latest-message requests are read-first. The agent may identify a memory update candidate, but should not edit `project-knowledge/` from the latest-message command unless the user explicitly asks to promote the fact.
+- Latest-message requests are read-first. The agent may identify a memory update candidate, but should not edit `workspaces/fidelity/project-knowledge/` from the latest-message command unless the user explicitly asks to promote the fact.
 - Standup generation is a separate required-refresh flow: it must fetch Mattermost before drafting, even though general prompts should not sync automatically.
 - Standup reads should use the focused reader mode, `scripts/mattermost-proxy/read-context.py --mode standup --today YYYY-MM-DD`, which reads date-bucketed previous-workday/today records and should use the active profile's configured `AIW_MATTERMOST_CONTEXT_CHANNELS` when available. Avoid loading broad mirror `latest.md` into standup prompts because it may include stale or unrelated channels and waste tokens. Keep project-specific channel names out of reusable connector code.
 - If adding MCP support for Mattermost, treat it as a read-only query wrapper over the existing proxy mirror and `read-context.py`, not as a replacement for the capture/mirror pipeline. Keep the mirror's file layout as canonical raw evidence and expose only narrow tools such as latest, standup/date, channel, and thread reads with channel filters and limits.
-- Do not build a write-capable Mattermost MCP or expose tokens, cookies, raw headers, or broad unfiltered raw dumps through MCP. MCP output should remain evidence for agent reasoning; promotion to `project-knowledge/` still follows normal memory rules.
+- Do not build a write-capable Mattermost MCP or expose tokens, cookies, raw headers, or broad unfiltered raw dumps through MCP. MCP output should remain evidence for agent reasoning; promotion to `workspaces/fidelity/project-knowledge/` still follows normal memory rules.
-- If the proxy mirror is running, treat it as fresher than legacy `mattermost-latest.md` / generated JSONL. Do not ignore mirror evidence merely because a legacy sync command also ran.
+- If the proxy mirror is running, treat it as fresher than generated sync artifacts. Do not ignore mirror evidence merely because a sync command also ran.
 - Do not refresh Mattermost just because a prompt mentions a manager or stakeholder.
 - Treat document review, message polishing, translation, and "does this align with Jeff's expectations?" prompts as normal drafting tasks unless the user explicitly asks for the latest message or fresh Mattermost evidence.
 - The OpenCode plugin syncs automatically only for explicit latest-message requests by default.
 - Optional aggressive sync can be enabled with `AIW_MATTERMOST_SYNC_ON_SESSION=true` or `AIW_MATTERMOST_SYNC_ON_PROMPT=true`, but these should stay off for low-latency daily use.
-- When invoking Mattermost sync from OpenCode, do not use parameter expansion that places a command with spaces into a single shell word, such as `${VAR:-bash scripts/mattermost/sync.sh}`. Run configured command strings via `bash -lc "$AIW_MATTERMOST_SYNC_CMD"` / `bash -lc "$FIDELITY_MATTERMOST_SYNC_CMD"`, and run the fallback as separate words: `bash scripts/mattermost/sync.sh`.
+- When invoking Mattermost sync from OpenCode, do not use parameter expansion that places a command with spaces into a single shell word, such as `${VAR:-bash scripts/mattermost/sync.sh}`. Run configured command strings via `bash -lc "$AIW_MATTERMOST_SYNC_CMD"`, and run the built-in wrapper as separate words: `bash scripts/mattermost/sync.sh`.
 
 ---
 
@@ -42,6 +42,6 @@ Mattermost is the current live communication connector.
 
 Slack export import is the current historical archive connector.
 
-- Archive evidence stays outside `project-knowledge/`.
+- Archive evidence stays outside `workspaces/fidelity/project-knowledge/`.
 - Promote only durable project facts, people context, process rules, or historical architecture lessons.
 - Do not promote dated status details unless they explain current context.

agent-memory/integrations/mem9.md

@@ -15,7 +15,7 @@ Use mem9 as a cross-session, cross-agent recall layer without replacing the work
 
 ## Source Of Truth
 
-`project-knowledge/` remains the canonical human-readable Fidelity project memory.
+`workspaces/fidelity/project-knowledge/` remains the canonical human-readable Fidelity project memory.
 
 `agent-memory/` remains the canonical operating memory for agent behavior, workflows, promotion rules, and integration guidance.
 
@@ -46,7 +46,7 @@ Do not bulk-import raw inboxes, generated sync output, full chat transcripts, or
 
 1. Recall mem9 early for user preferences and relevant workspace history.
 2. Load hot Markdown context from `AGENTS.md` / `opencode.json` instructions.
-3. For current-work questions, still inspect `project-knowledge/01-current/current-work.md` and the latest relevant daily note.
+3. For current-work questions, still inspect `workspaces/fidelity/project-knowledge/01-current/current-work.md` and the latest relevant daily note.
 4. Answer or act from verified context.
 5. When the interaction adds durable knowledge, update canonical Markdown first; store a compact mem9 memory only if it improves future recall.
 

agent-memory/integrations/memory-interface.md

@@ -15,20 +15,16 @@ Use `scripts/memory/memory.sh` as the project-agnostic interface to project know
 
 ## Default Root
 
-The primary project knowledge directory is `project-knowledge/`.
+The primary project knowledge directory is `workspaces/fidelity/project-knowledge/`.
 
-Environment variable precedence:
+Configuration precedence:
 
-1. `AIW_PROJECT_KNOWLEDGE_DIR`
+1. `AIW_PROJECT_PROFILE`
-2. `AIW_MEMORY_VAULT_DIR`
+2. `profiles/<profile>/workspace.json`
-3. `AIW_OBSIDIAN_VAULT_DIR`
+3. optional local `AIW_PROJECT_KNOWLEDGE_DIR` override
-4. `<workspace-root>/project-knowledge`
-
-`AIW_MEMORY_VAULT_DIR` and `AIW_OBSIDIAN_VAULT_DIR` are transition aliases only.
 
 ---
 
 ## Agent Rule
 
 Prefer the memory interface for typed note creation, search, Base queries, and health checks. Use direct Markdown edits when the adapter fails or when precise edits are simpler and safer.
-

agent-memory/integrations/obsidian.md

@@ -16,13 +16,13 @@ Obsidian is the current interface over canonical Markdown memory. The workspace-
 
 ## Recommended Start
 
-Open the `project-knowledge/` folder as the Obsidian vault, not the repository root and not `agent-memory/`.
+Open the `workspaces/fidelity/project-knowledge/` folder as the Obsidian vault, not the repository root and not `agent-memory/`.
 
 Open:
 
-- [Start Here](../../project-knowledge/00-start/start-here.md)
+- [Start Here](../../workspaces/fidelity/project-knowledge/00-start/start-here.md)
-- [New Member Onboarding](../../project-knowledge/00-start/onboarding.md)
+- [New Member Onboarding](../../workspaces/fidelity/project-knowledge/00-start/onboarding.md)
-- [Knowledge Maps](../../project-knowledge/07-maps/index.md)
+- [Knowledge Maps](../../workspaces/fidelity/project-knowledge/07-maps/index.md)
 
 ---
 
@@ -32,26 +32,26 @@ Open:
 
 Start with:
 
-- [New Member Onboarding](../../project-knowledge/00-start/onboarding.md)
+- [New Member Onboarding](../../workspaces/fidelity/project-knowledge/00-start/onboarding.md)
-- [Glossary](../../project-knowledge/00-start/glossary.md)
+- [Glossary](../../workspaces/fidelity/project-knowledge/00-start/glossary.md)
-- [Current Work Map](../../project-knowledge/07-maps/current-work.md)
+- [Current Work Map](../../workspaces/fidelity/project-knowledge/07-maps/current-work.md)
-- [Fidelity Domain Map](../../project-knowledge/07-maps/fidelity-domain.md)
+- [Fidelity Domain Map](../../workspaces/fidelity/project-knowledge/07-maps/fidelity-domain.md)
 
 ### Daily Work View
 
 Start with:
 
-- [Current Work Map](../../project-knowledge/07-maps/current-work.md)
+- [Current Work Map](../../workspaces/fidelity/project-knowledge/07-maps/current-work.md)
-- [Work Items Map](../../project-knowledge/07-maps/work-items.md)
+- [Work Items Map](../../workspaces/fidelity/project-knowledge/07-maps/work-items.md)
-- [Daily Notes Index](../../project-knowledge/06-daily/index.md)
+- [Daily Notes Index](../../workspaces/fidelity/project-knowledge/06-daily/index.md)
 
 ### System Understanding View
 
 Start with:
 
-- [Fidelity Domain Map](../../project-knowledge/07-maps/fidelity-domain.md)
+- [Fidelity Domain Map](../../workspaces/fidelity/project-knowledge/07-maps/fidelity-domain.md)
-- [Fidelity Apps Map](../../project-knowledge/07-maps/fidelity-apps.md)
+- [Fidelity Apps Map](../../workspaces/fidelity/project-knowledge/07-maps/fidelity-apps.md)
-- [People Map](../../project-knowledge/07-maps/people.md)
+- [People Map](../../workspaces/fidelity/project-knowledge/07-maps/people.md)
 
 ---
 

agent-memory/maps/ai-workspace-core.md

@@ -50,4 +50,4 @@ Reusable workspace logic and project-independent operating rules.
 ## Project Profile
 
 - Active project profile: `profiles/fidelity/profile.md`
-- Project knowledge vault: `project-knowledge/`
+- Project knowledge vault: `workspaces/fidelity/project-knowledge/`

agent-memory/maps/tooling.md

@@ -75,5 +75,5 @@ Commands, prompts, skills, workflows, and automation surfaces that make the work
 - Project-agnostic memory scripts: `scripts/memory/`
 - Current Obsidian adapter: `scripts/obsidian/`
 - Obsidian MCP migration plan: `agent-memory/workflows/obsidian-mcp-migration.md`
-- Project knowledge vault: `project-knowledge/`
+- Project knowledge vault: `workspaces/fidelity/project-knowledge/`
 - Agent operating memory: `agent-memory/`

agent-memory/memory/context-maintenance.md

@@ -18,22 +18,22 @@ Keep this workspace useful as living memory instead of a pile of disconnected no
 
 - Update canonical context when a durable fact changes.
 - Prefer correcting stale context over appending contradictory notes.
-- Keep `project-knowledge/` human-facing and project-facing: write it as an engineer maintaining shared project notes, not as an AI maintaining its own operating instructions.
+- Keep `workspaces/fidelity/project-knowledge/` human-facing and project-facing: write it as an engineer maintaining shared project notes, not as an AI maintaining its own operating instructions.
-- Do not place agent-only logic, output contracts, prompting tactics, evaluation heuristics, or command-behavior rules in `project-knowledge/` unless a human engineer on the project would reasonably want that exact guidance there.
+- Do not place agent-only logic, output contracts, prompting tactics, evaluation heuristics, or command-behavior rules in `workspaces/fidelity/project-knowledge/` unless a human engineer on the project would reasonably want that exact guidance there.
-- Put agent behavior, prompt logic, formatting contracts, and slash-command rules in `agent-memory/`, `.opencode/commands/`, `prompts/`, `.opencode/agents/`, or `.agents/skills/` instead of `project-knowledge/`.
+- Put agent behavior, prompt logic, formatting contracts, and slash-command rules in `agent-memory/`, `.opencode/commands/`, `prompts/`, `.opencode/agents/`, or `.agents/skills/` instead of `workspaces/fidelity/project-knowledge/`.
 - If a canonical note appears in an Obsidian Base, update its frontmatter properties together with the prose content.
 - When changing frontmatter properties on existing canonical notes, prefer Obsidian CLI property operations through `scripts/obsidian/cli.sh` when available so YAML spacing and property formatting stay clean; fall back to direct Markdown edits only when the CLI is unavailable or the operation is unsupported.
-- Keep templates under `project-knowledge/09-templates/` out of real-note Bases by filtering the template folder.
+- Keep templates under `workspaces/fidelity/project-knowledge/09-templates/` out of real-note Bases by filtering the template folder.
 - Role mapping files should not use `type: person`; reserve `type: person` for actual people profiles.
 - Work-item notes should keep known `systems`, `workstreams`, `people`, and `related` properties current.
 - Daily notes should keep `focus`, `work-items`, and `blockers` properties current when the values are clear.
 - Use the smallest correct destination:
-  - `project-knowledge/06-daily/YYYY-MM-DD.md` for daily progress and evolving findings
+  - `workspaces/fidelity/project-knowledge/06-daily/YYYY-MM-DD.md` for daily progress and evolving findings
-  - `project-knowledge/01-current/current-work.md` for near-term active work
+  - `workspaces/fidelity/project-knowledge/01-current/current-work.md` for near-term active work
-  - `project-knowledge/02-work-items/*.md` for canonical Jira-linked active work
+  - `workspaces/fidelity/project-knowledge/02-work-items/*.md` for canonical Jira-linked active work
-  - `project-knowledge/01-current/work-items.md` for the compact active-work summary
+  - `workspaces/fidelity/project-knowledge/01-current/work-items.md` for the compact active-work summary
-  - `project-knowledge/03-context/` for durable project knowledge
+  - `workspaces/fidelity/project-knowledge/03-context/` for durable project knowledge
-  - `project-knowledge/04-people/` for named person context
+  - `workspaces/fidelity/project-knowledge/04-people/` for named person context
   - `.opencode/commands/`, `prompts/`, `.opencode/agents/`, `.agents/skills/`, `agent-memory/`, `core/`, or `scripts/` for reusable behavior rules that control how the workspace responds
 
 ---

agent-memory/memory/operational-memory.md

@@ -17,12 +17,12 @@ The reusable model lives in `core/memory/operational-memory.md`. This file recor
 
 ## Memory Classes
 
-- `daily`: dated progress and evidence in `project-knowledge/06-daily/`.
+- `daily`: dated progress and evidence in `workspaces/fidelity/project-knowledge/06-daily/`.
-- `state`: near-term active work in `project-knowledge/01-current/`.
+- `state`: near-term active work in `workspaces/fidelity/project-knowledge/01-current/`.
-- `work-items`: ticket-scoped memory in `project-knowledge/02-work-items/`.
+- `work-items`: ticket-scoped memory in `workspaces/fidelity/project-knowledge/02-work-items/`.
-- `stable-context`: durable systems, workstreams, process, and iOS context in `project-knowledge/03-context/`.
+- `stable-context`: durable systems, workstreams, process, and iOS context in `workspaces/fidelity/project-knowledge/03-context/`.
-- `people`: collaborators, stakeholders, and role mappings in `project-knowledge/04-people/`.
+- `people`: collaborators, stakeholders, and role mappings in `workspaces/fidelity/project-knowledge/04-people/`.
-- `decisions`: accepted durable decisions in `project-knowledge/05-decisions/`.
+- `decisions`: accepted durable decisions in `workspaces/fidelity/project-knowledge/05-decisions/`.
 - `tooling-behavior`: agent and workspace behavior in `agent-memory/`, `.opencode/`, `prompts/`, `scripts/`, and `core/`.
 
 ---
@@ -31,9 +31,9 @@ The reusable model lives in `core/memory/operational-memory.md`. This file recor
 
 Raw evidence stays outside project knowledge:
 
-- `ai/inbox/`
+- `workspaces/fidelity/inbox/`
 - `scripts/mattermost/generated/`
 - `scripts/slack/generated/`
 
-Only curated, high-confidence project facts should be promoted into `project-knowledge/`.
+Only curated, high-confidence project facts should be promoted into `workspaces/fidelity/project-knowledge/`.
 

agent-memory/memory/promotion-rules.md

@@ -25,7 +25,7 @@ If a fact is ambiguous, skip it or keep it only in the daily log with appropriat
 
 ## File Selection
 
-### Promote to `project-knowledge/06-daily/YYYY-MM-DD.md`
+### Promote to `workspaces/fidelity/project-knowledge/06-daily/YYYY-MM-DD.md`
 
 Use the daily log for:
 
@@ -37,7 +37,7 @@ Use the daily log for:
 
 Daily logs are the default destination for most promoted Mattermost facts.
 
-### Promote to `project-knowledge/01-current/current-work.md`
+### Promote to `workspaces/fidelity/project-knowledge/01-current/current-work.md`
 
 Use current state only for facts that materially affect active work over the next few days, such as:
 
@@ -48,9 +48,9 @@ Use current state only for facts that materially affect active work over the nex
 
 Do not copy every daily update into current state.
 
-### Promote to `project-knowledge/02-work-items/*.md` and `project-knowledge/01-current/work-items.md`
+### Promote to `workspaces/fidelity/project-knowledge/02-work-items/*.md` and `workspaces/fidelity/project-knowledge/01-current/work-items.md`
 
-Use `project-knowledge/02-work-items/*.md` for:
+Use `workspaces/fidelity/project-knowledge/02-work-items/*.md` for:
 
 - explicit Jira IDs
 - approved or explicit story titles
@@ -60,9 +60,9 @@ Use `project-knowledge/02-work-items/*.md` for:
 
 If a Jira item is likely to appear again in standups or manager updates, it belongs here.
 
-Use `project-knowledge/01-current/work-items.md` as the compact summary of which ticket files are active.
+Use `workspaces/fidelity/project-knowledge/01-current/work-items.md` as the compact summary of which ticket files are active.
 
-### Promote to `project-knowledge/03-context/project.md`
+### Promote to `workspaces/fidelity/project-knowledge/03-context/project.md`
 
 Use project context only for durable project knowledge that should survive beyond the current work window, such as:
 
@@ -73,11 +73,11 @@ Use project context only for durable project knowledge that should survive beyon
 
 Do not promote story-specific daily movement into project context unless it changes durable project understanding.
 
-### Promote to `project-knowledge/05-decisions/*.md`
+### Promote to `workspaces/fidelity/project-knowledge/05-decisions/*.md`
 
 Use decisions only for explicit confirmed decisions with medium or long-term impact.
 
-### Promote to `project-knowledge/04-people/index.md` and `project-knowledge/04-people/*.md`
+### Promote to `workspaces/fidelity/project-knowledge/04-people/index.md` and `workspaces/fidelity/project-knowledge/04-people/*.md`
 
 Use these files when:
 
@@ -141,5 +141,5 @@ Given Mattermost updates like:
 Automatic behavior should be:
 
 - add all of them to today's log if they are relevant to today's work
-- promote only the currently actionable subset to `project-knowledge/01-current/current-work.md`
+- promote only the currently actionable subset to `workspaces/fidelity/project-knowledge/01-current/current-work.md`
-- keep story-specific details out of `project-knowledge/03-context/project.md` unless they reveal a durable project rule
+- keep story-specific details out of `workspaces/fidelity/project-knowledge/03-context/project.md` unless they reveal a durable project rule

agent-memory/workflows/obsidian-mcp-migration.md

@@ -11,7 +11,7 @@ tags: [obsidian, mcp, migration, memory]
 
 Replace the current Obsidian CLI-backed adapter path with an Obsidian MCP-first integration while preserving the workspace memory model:
 
-- `project-knowledge/` remains the canonical source of truth
+- `workspaces/fidelity/project-knowledge/` remains the canonical source of truth
 - `scripts/memory/` remains the stable workspace memory contract
 - direct Markdown edits remain the safe fallback for precise curation
 - Obsidian stays an adapter/navigation layer, not a second memory store
@@ -66,7 +66,7 @@ The migration should change the adapter, not the memory model.
 
 - Do not move canonical memory out of Markdown
 - Do not encode promotion rules into the MCP layer
-- Do not make `project-knowledge/` depend on Obsidian-only storage
+- Do not make `workspaces/fidelity/project-knowledge/` depend on Obsidian-only storage
 - Do not remove direct Markdown editing as a fallback
 - Do not delete the current scripts until MCP coverage is validated in real use
 
@@ -116,7 +116,7 @@ Current Phase 1 checklist:
 - [x] Add OpenCode MCP config using `OBSIDIAN_API_KEY` environment substitution.
 - [x] Export `OBSIDIAN_API_KEY` in the shell that launches OpenCode.
 - [x] Restart OpenCode and confirm `opencode mcp list` shows `obsidian` connected.
-- [x] Validate read/search tools against `project-knowledge/` notes.
+- [x] Validate read/search tools against `workspaces/fidelity/project-knowledge/` notes.
 - [x] Validate write/append/delete behavior on a disposable test note before touching canonical memory.
 - [ ] Determine whether Bases/properties/backlinks/template behavior needs to remain on the existing CLI/direct-Markdown path.
 
@@ -208,9 +208,9 @@ Delete later only if truly unused:
 
 ### Keep
 
-- `project-knowledge/.obsidian/`
+- `workspaces/fidelity/project-knowledge/.obsidian/`
-- `project-knowledge/08-bases/*.base`
+- `workspaces/fidelity/project-knowledge/08-bases/*.base`
-- `project-knowledge/09-templates/`
+- `workspaces/fidelity/project-knowledge/09-templates/`
 - `scripts/memory/`
 
 ### Deprecate then remove

agent-memory/workflows/prompt-engineering-lessons.md

@@ -51,4 +51,4 @@ Capture reusable prompting lessons so the agent does not need to re-research the
 
 - Treat prompt improvement as eval-driven iteration: identify the exact bad output pattern, add the smallest correction, and check whether it fixes the failure without bloating the prompt.
 - When a correction is about workspace behavior, update the controlling prompt or command immediately so the next run benefits.
-- Keep project memory clean while improving prompt quality; do not store agent heuristics in `project-knowledge/`.
+- Keep project memory clean while improving prompt quality; do not store agent heuristics in `workspaces/fidelity/project-knowledge/`.

agent-memory/workflows/workspace-architecture.md

@@ -11,7 +11,7 @@ related:
 
 This repository separates project knowledge from agent operation:
 
-- `project-knowledge/` is the clean Obsidian second brain and transferable project memory.
+- `workspaces/fidelity/project-knowledge/` is the clean Obsidian second brain and transferable project memory.
 - `agent-memory/` is the operating manual for the AI agent.
 - Everything else is technical runtime, reusable core, profile configuration, scripts, commands, prompts, or raw evidence.
 
@@ -42,10 +42,10 @@ These folders are intentionally outside Obsidian memory:
 - `core/` stores reusable workspace logic.
 - `profiles/` stores project-specific profile declarations.
 - `scripts/` stores connectors, importers, and wrappers.
-- `ai/inbox/` stores live evidence from communication sync.
+- `workspaces/fidelity/inbox/` stores live evidence from communication sync.
 - `scripts/*/generated/` stores extracted evidence.
 
-Runtime and generated files can be used as evidence, but durable project facts should be promoted into `project-knowledge/`.
+Runtime and generated files can be used as evidence, but durable project facts should be promoted into `workspaces/fidelity/project-knowledge/`.
 
 Agent behavior rules belong in `agent-memory/`, not in the project vault.
 
@@ -55,7 +55,7 @@ Agent behavior rules belong in `agent-memory/`, not in the project vault.
 
 Use `scripts/memory/` as the platform-agnostic interface to canonical memory.
 
-Obsidian is the current visual and CLI-backed adapter, but the source of truth remains Markdown under `project-knowledge/`.
+Obsidian is the current visual and CLI-backed adapter, but the source of truth remains Markdown under `workspaces/fidelity/project-knowledge/`.
 
 - Agents use `scripts/memory/memory.sh create` when a new typed note is needed.
 - Agents use `scripts/memory/memory.sh search` or direct Markdown reads for context lookup.
@@ -66,6 +66,6 @@ Obsidian is the current visual and CLI-backed adapter, but the source of truth r
 
 ## Memory Rule
 
-Promoted memory lives in `project-knowledge/`.
+Promoted memory lives in `workspaces/fidelity/project-knowledge/`.
 
 Raw inbox and generated connector evidence stays outside the vault until the agent promotes durable facts.

agent-memory/workflows/workspace-model.md

@@ -15,7 +15,7 @@ It separates reusable tooling, project knowledge, and agent operating memory:
 
 - `core/` contains reusable project-independent operating rules
 - `profiles/<project>/` contains project-specific configuration and assumptions
-- `project-knowledge/` contains transferable project documentation and current work memory
+- `workspaces/fidelity/project-knowledge/` contains transferable project documentation and current work memory
 - `agent-memory/` contains agent behavior, learning, promotion, integration, and verification rules
 
 ---
@@ -48,14 +48,14 @@ When the user corrects a recurring behavior, the workspace should update the fil
 
 - `core/` for reusable project-independent behavior
 - `profiles/<project>/` for project-specific assumptions
-- `project-knowledge/.obsidian/` only for portable Obsidian configuration, not project memory content
+- `workspaces/fidelity/project-knowledge/.obsidian/` only for portable Obsidian configuration, not project memory content
 - `scripts/memory/` for project-agnostic memory access, creation, search, Base queries, and health checks
 - `scripts/obsidian/` for the current Obsidian adapter, not for core memory semantics
 - `.agents/workflows/` for slash commands (with `.opencode/commands/` for compatibility)
 - `prompts/` for reusable drafting templates
 - `.agents/rules/` and `AGENTS.md` for default agent behavior
 - `.agents/skills/` for specialized workflows. Do not mirror into `.opencode/skills/`; OpenCode discovers `.agents/skills/` directly.
-- `project-knowledge/00-start/` and `project-knowledge/03-context/process/` for project-facing onboarding and process rules
+- `workspaces/fidelity/project-knowledge/00-start/` and `workspaces/fidelity/project-knowledge/03-context/process/` for project-facing onboarding and process rules
 - `agent-memory/` for agent-specific behavior, learning, promotion, verification, and self-maintenance rules
 
 Daily logs can preserve evidence, but they should not be the only place where a reusable behavior rule lives.

apps/mac/AIWorkspace/README.md

@@ -28,6 +28,21 @@ Install to `~/Applications/AIWorkspace.app`:
 apps/mac/AIWorkspace/scripts/package-app.sh --install
 ```
 
+The script defaults to the per-user install location because this workspace is a
+developer-local utility and frequent rebuilds should not require `sudo`. To
+install system-wide instead, pass an explicit install directory:
+
+```bash
+INSTALL_DIR=/Applications apps/mac/AIWorkspace/scripts/package-app.sh --install
+APP_PATH=/Applications/AIWorkspace.app apps/mac/AIWorkspace/scripts/install-start-at-login.sh
+```
+
+Avoid keeping both `~/Applications/AIWorkspace.app` and
+`/Applications/AIWorkspace.app` installed unless you are intentionally comparing
+builds. They share the same bundle identifier (`com.aiworkspace.menu`) and can
+confuse LaunchServices, login item registration, and which copy opens at login.
+If both exist, quit any running AI Workspace instances and remove the stale copy.
+
 ## Build a DMG
 
 ```bash

apps/mac/AIWorkspace/Sources/main.swift

@@ -4,11 +4,51 @@ import ServiceManagement
 import SwiftUI
 
 private let workspaceRoot = URL(fileURLWithPath: "/Users/david/Developer/fidelity-ai-workspace", isDirectory: true)
-private let defaultProfile = "fidelity"
+
+struct ProfileConfig {
+    let id: String
+    let displayName: String
+    let knowledgeDir: String
+
+    static func discoverDefault() -> ProfileConfig {
+        let profilesRoot = workspaceRoot.appendingPathComponent("profiles", isDirectory: true)
+        let candidates = (try? FileManager.default.contentsOfDirectory(at: profilesRoot, includingPropertiesForKeys: nil)) ?? []
+        let configs = candidates.compactMap { directory -> ProfileConfig? in
+            let configURL = directory.appendingPathComponent("workspace.json")
+            guard let data = try? Data(contentsOf: configURL),
+                  let decoded = try? JSONDecoder().decode(ProfileWorkspaceConfig.self, from: data)
+            else { return nil }
+            return ProfileConfig(
+                id: decoded.profile ?? directory.lastPathComponent,
+                displayName: decoded.displayName ?? decoded.profile ?? directory.lastPathComponent,
+                knowledgeDir: decoded.knowledgeDir ?? "workspaces/\(decoded.profile ?? directory.lastPathComponent)/project-knowledge"
+            )
+        }
+        if let fidelity = configs.first(where: { $0.id == "fidelity" }) {
+            return fidelity
+        }
+        if let first = configs.sorted(by: { $0.id < $1.id }).first {
+            return first
+        }
+        return ProfileConfig(id: "fidelity", displayName: "Fidelity", knowledgeDir: "workspaces/fidelity/project-knowledge")
+    }
+}
+
+private struct ProfileWorkspaceConfig: Decodable {
+    let profile: String?
+    let displayName: String?
+    let knowledgeDir: String?
+
+    enum CodingKeys: String, CodingKey {
+        case profile
+        case displayName = "display_name"
+        case knowledgeDir = "knowledge_dir"
+    }
+}
 
 @main
 struct AIWorkspaceApp: App {
-    @StateObject private var model = ServiceStatusModel(profile: defaultProfile)
+    @StateObject private var model = ServiceStatusModel()
 
     var body: some Scene {
         MenuBarExtra {
@@ -30,11 +70,12 @@ final class ServiceStatusModel: ObservableObject {
     @Published private(set) var lanIP: String?
     @Published private(set) var loginItemStatus: SMAppService.Status = .notRegistered
     @Published private(set) var isRefreshing = false
+    @Published private(set) var activeAction: String?
 
-    let profile: String
+    let profile: ProfileConfig
 
-    init(profile: String) {
+    init() {
-        self.profile = profile
+        self.profile = ProfileConfig.discoverDefault()
     }
 
     var menuBarSymbol: String {
@@ -52,7 +93,7 @@ final class ServiceStatusModel: ObservableObject {
         isRefreshing = true
         defer { isRefreshing = false }
         do {
-            let data = try await ServiceManager.run(["status", "--profile", profile, "--json"])
+            let data = try await ServiceManager.run(["status", "--profile", profile.id, "--json"])
             report = try JSONDecoder().decode(StatusReport.self, from: data)
             lanIP = await NetworkInfo.primaryLANIP()
             loginItemStatus = SMAppService.mainApp.status
@@ -92,25 +133,33 @@ final class ServiceStatusModel: ObservableObject {
     }
 
     func startProfile() {
-        runAction(["start", "--profile", profile])
+        runAction("Starting services…", ["start", "--profile", profile.id])
     }
 
     func stopProfile() {
-        runAction(["stop", "--profile", profile])
+        runAction("Stopping services…", ["stop", "--profile", profile.id])
+    }
+
+    func primaryServiceAction() {
+        if allManagedServicesRunning {
+            stopProfile()
+        } else {
+            startProfile()
+        }
     }
 
     func restartMCP() {
-        runAction(["restart", "aiw-context-mcp", "--profile", profile])
+        runAction("Restarting MCP…", ["restart", "aiw-context-mcp", "--profile", profile.id])
     }
 
     func runDoctor() {
-        runAction(["doctor", "--profile", profile])
+        runAction("Running doctor…", ["doctor", "--profile", profile.id])
     }
 
     func copyDoctorJSON() {
         Task {
             do {
-                let data = try await ServiceManager.run(["doctor", "--profile", profile, "--json"])
+                let data = try await ServiceManager.run(["doctor", "--profile", profile.id, "--json"])
                 copyToPasteboard(String(data: data, encoding: .utf8) ?? "")
             } catch {
                 lastError = String(describing: error)
@@ -128,7 +177,7 @@ final class ServiceStatusModel: ObservableObject {
             do {
                 var chunks: [String] = []
                 for service in report?.services ?? [] {
-                    let data = try await ServiceManager.run(["logs", service.name, "--profile", profile, "--lines", "30"])
+                    let data = try await ServiceManager.run(["logs", service.name, "--profile", profile.id, "--lines", "30"])
                     if let text = String(data: data, encoding: .utf8), !text.isEmpty {
                         chunks.append(text)
                     }
@@ -147,15 +196,33 @@ final class ServiceStatusModel: ObservableObject {
     }
 
     func openLogsFolder() {
-        NSWorkspace.shared.open(workspaceRoot.appendingPathComponent(".aiw/runtime/logs", isDirectory: true))
+        NSWorkspace.shared.open(workspaceRoot.appendingPathComponent(".aiw/runtime/logs/\(profile.id)", isDirectory: true))
     }
 
     func openProjectKnowledge() {
-        NSWorkspace.shared.open(workspaceRoot.appendingPathComponent("project-knowledge", isDirectory: true))
+        NSWorkspace.shared.open(workspaceRoot.appendingPathComponent(profile.knowledgeDir, isDirectory: true))
     }
 
     func openMattermost() {
-        runAction(["start", "mattermost-desktop", "--profile", profile])
+        runAction("Launching Mattermost…", ["start", "mattermost-desktop", "--profile", profile.id])
+    }
+
+    var allManagedServicesRunning: Bool {
+        guard let services = report?.services else { return false }
+        let managed = services.filter { $0.enabled && $0.kind != "app-launcher" }
+        return !managed.isEmpty && managed.allSatisfy { $0.status == "running" || $0.status == "externally running" }
+    }
+
+    var primaryActionTitle: String {
+        allManagedServicesRunning ? "Stop Services" : "Start Services"
+    }
+
+    var primaryActionSymbol: String {
+        allManagedServicesRunning ? "stop.fill" : "play.fill"
+    }
+
+    var isBusy: Bool {
+        isRefreshing || activeAction != nil
     }
 
     private func copyToPasteboard(_ value: String) {
@@ -163,8 +230,10 @@ final class ServiceStatusModel: ObservableObject {
         NSPasteboard.general.setString(value, forType: .string)
     }
 
-    private func runAction(_ arguments: [String]) {
+    private func runAction(_ label: String, _ arguments: [String]) {
         Task {
+            activeAction = label
+            defer { activeAction = nil }
             do {
                 _ = try await ServiceManager.run(arguments)
                 await refresh()
@@ -184,20 +253,31 @@ struct ServiceMenuView: View {
                 VStack(alignment: .leading, spacing: 3) {
                     Text("AI Workspace")
                         .font(.title3.bold())
-                    Text("Profile: \(model.profile)")
+                    Text("Profile: \(model.profile.displayName)")
                         .font(.caption)
                         .foregroundStyle(.secondary)
                 }
                 Spacer()
+                if model.isBusy {
+                    ProgressView()
+                        .controlSize(.small)
+                }
                 Button {
                     Task { await model.refresh() }
                 } label: {
                     Image(systemName: "arrow.clockwise")
                 }
                 .buttonStyle(.borderless)
+                .disabled(model.isBusy)
                 .help("Refresh")
             }
 
+            if let activeAction = model.activeAction {
+                Label(activeAction, systemImage: "hourglass")
+                    .font(.caption)
+                    .foregroundStyle(.secondary)
+            }
+
             Divider()
 
             if let report = model.report {
@@ -231,20 +311,26 @@ struct ServiceMenuView: View {
 
             Divider()
 
+            Button(role: model.allManagedServicesRunning ? .destructive : nil, action: model.primaryServiceAction) {
+                Label(model.primaryActionTitle, systemImage: model.primaryActionSymbol)
+                    .frame(maxWidth: .infinity)
+            }
+            .buttonStyle(.borderedProminent)
+            .controlSize(.large)
+            .disabled(model.isBusy)
+
             LazyVGrid(columns: [GridItem(.flexible()), GridItem(.flexible())], spacing: 8) {
-                ActionButton(title: "Start Fidelity", systemImage: "play.fill", action: model.startProfile)
+                ActionButton(title: "Restart MCP", systemImage: "arrow.triangle.2.circlepath", disabled: model.isBusy, action: model.restartMCP)
-                ActionButton(title: "Stop Fidelity", systemImage: "stop.fill", role: .destructive, action: model.stopProfile)
+                ActionButton(title: "Mattermost via Proxy", systemImage: "message.badge", disabled: model.isBusy, action: model.openMattermost)
-                ActionButton(title: "Restart MCP", systemImage: "arrow.triangle.2.circlepath", action: model.restartMCP)
-                ActionButton(title: "Mattermost via Proxy", systemImage: "message.badge", action: model.openMattermost)
             }
 
             Divider()
 
             LazyVGrid(columns: [GridItem(.flexible()), GridItem(.flexible())], spacing: 8) {
-                ActionButton(title: "Run Doctor", systemImage: "stethoscope", action: model.runDoctor)
+                ActionButton(title: "Run Doctor", systemImage: "stethoscope", disabled: model.isBusy, action: model.runDoctor)
-                ActionButton(title: "Copy Doctor JSON", systemImage: "doc.on.doc", action: model.copyDoctorJSON)
+                ActionButton(title: "Copy Doctor JSON", systemImage: "doc.on.doc", disabled: model.isBusy, action: model.copyDoctorJSON)
                 ActionButton(title: "Copy Photo URL", systemImage: "link", action: model.copyPhotoInboxURL)
-                ActionButton(title: "Copy Logs", systemImage: "doc.text", action: model.copyRecentLogs)
+                ActionButton(title: "Copy Logs", systemImage: "doc.text", disabled: model.isBusy, action: model.copyRecentLogs)
                 ActionButton(title: "MCP Health", systemImage: "heart.text.square", action: model.openMCPHealth)
                 ActionButton(title: "Logs Folder", systemImage: "folder", action: model.openLogsFolder)
             }
@@ -290,6 +376,7 @@ struct ActionButton: View {
     let title: String
     let systemImage: String
     var role: ButtonRole?
+    var disabled = false
     let action: () -> Void
 
     var body: some View {
@@ -299,6 +386,7 @@ struct ActionButton: View {
         }
         .buttonStyle(.bordered)
         .controlSize(.small)
+        .disabled(disabled)
     }
 }
 
@@ -369,6 +457,15 @@ enum ServiceManager {
             process.currentDirectoryURL = workspaceRoot
             process.executableURL = URL(fileURLWithPath: "/usr/bin/env")
             process.arguments = ["python3", "scripts/aiw/services.py"] + arguments
+            var environment = ProcessInfo.processInfo.environment
+            let guiSafePATH = "/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/local/sbin:/usr/bin:/bin:/usr/sbin:/sbin"
+            if let existingPATH = environment["PATH"], !existingPATH.isEmpty {
+                environment["PATH"] = "\(guiSafePATH):\(existingPATH)"
+            } else {
+                environment["PATH"] = guiSafePATH
+            }
+            environment["AIW_WORKSPACE_ROOT"] = workspaceRoot.path
+            process.environment = environment
 
             let output = Pipe()
             let error = Pipe()

core/README.md

@@ -51,7 +51,7 @@ See `core/memory/operational-memory.md` for the detailed rules.
 
 Integrations extract evidence. They do not decide what becomes memory.
 
-- live communication connectors write recent evidence to `ai/inbox/`
+- live communication connectors write recent evidence to `workspaces/<profile>/inbox/`
 - historical archive connectors write selected evidence to `scripts/<source>/generated/`
 - the agent promotes only high-confidence, project-relevant facts into memory
 

core/integrations/communication-model.md

@@ -18,7 +18,7 @@ Expected behavior:
 
 - fetch recent messages from configured channels or conversations
 - support a forced refresh for "latest message" prompts
-- write the latest evidence to `ai/inbox/`
+- write the latest evidence to `workspaces/<profile>/inbox/`
 - write status separately from project memory
 - fail safely without updating logs, state, or context
 

core/integrations/memory-vault-model.md

@@ -12,7 +12,7 @@ Obsidian is the current human-facing implementation, but the workspace should no
 
 ### Canonical Memory
 
-The source of truth is plain Markdown under `project-knowledge/`.
+The source of truth is plain Markdown under `workspaces/<profile>/project-knowledge/`.
 
 Agents should edit canonical notes directly when precision matters because direct edits produce auditable diffs.
 
@@ -31,16 +31,16 @@ Use `scripts/memory/memory.sh` for project-knowledge operations:
 
 The current adapter is Obsidian CLI through `scripts/obsidian/cli.sh`.
 
-If Obsidian CLI is unavailable or fails, `scripts/memory/memory.sh` falls back to direct Markdown operations unless `AIW_MEMORY_BACKEND=obsidian` is explicitly set.
+If Obsidian CLI is unavailable or fails, `scripts/memory/memory.sh` uses direct Markdown operations unless `AIW_MEMORY_BACKEND=obsidian` is explicitly set.
 
 ---
 
 ## Configuration
 
-- `AIW_PROJECT_KNOWLEDGE_DIR`: canonical project knowledge directory. Defaults to `<workspace-root>/project-knowledge`.
+- `AIW_PROJECT_PROFILE`: selected profile. Defaults to `fidelity` in this workspace.
-- `AIW_MEMORY_VAULT_DIR`: transition alias for the canonical project knowledge directory.
+- `profiles/<profile>/workspace.json`: canonical source for `knowledge_dir`, `inbox_dir`, and `index_dir`.
+- `AIW_PROJECT_KNOWLEDGE_DIR`: optional local override for the canonical project knowledge directory.
 - `AIW_MEMORY_BACKEND`: `auto`, `files`, or `obsidian`. Defaults to `auto`.
-- `AIW_OBSIDIAN_VAULT_DIR`: Obsidian-specific transition alias, still supported by the adapter.
 - `AIW_OBSIDIAN_VAULT_NAME`: Obsidian URI vault name override for URI wrappers.
 
 Backend meanings:
@@ -55,15 +55,15 @@ Backend meanings:
 
 The memory interface owns type-to-folder routing:
 
-- `daily` -> `project-knowledge/06-daily/`
+- `daily` -> `workspaces/<profile>/project-knowledge/06-daily/`
-- `work-item` -> `project-knowledge/02-work-items/`
+- `work-item` -> `workspaces/<profile>/project-knowledge/02-work-items/`
-- `person` -> `project-knowledge/04-people/`
+- `person` -> `workspaces/<profile>/project-knowledge/04-people/`
-- `decision` -> `project-knowledge/05-decisions/`
+- `decision` -> `workspaces/<profile>/project-knowledge/05-decisions/`
-- `system` -> `project-knowledge/03-context/systems/`
+- `system` -> `workspaces/<profile>/project-knowledge/03-context/systems/`
-- `workstream` -> `project-knowledge/03-context/workstreams/`
+- `workstream` -> `workspaces/<profile>/project-knowledge/03-context/workstreams/`
-- `meeting-note` -> `project-knowledge/06-daily/`
+- `meeting-note` -> `workspaces/<profile>/project-knowledge/06-daily/`
 
-Templates live in `project-knowledge/09-templates/`.
+Templates live in `workspaces/<profile>/project-knowledge/09-templates/`.
 
 This gives agents an automatic destination for new notes without coupling the rule to Obsidian.
 
@@ -77,7 +77,7 @@ This gives agents an automatic destination for new notes without coupling the ru
 - Edit Markdown directly for precise memory curation, corrections, and content updates.
 - Do not treat Obsidian CLI failure as project context.
 - Do not require Obsidian to be running for core workspace operation.
-- Keep raw evidence outside `project-knowledge/`; promote only curated memory.
+- Keep raw evidence outside `workspaces/<profile>/project-knowledge/`; promote only curated memory.
 
 ---
 

core/integrations/obsidian-model.md

@@ -10,10 +10,10 @@ Obsidian should not become a second memory store.
 
 ## Recommended Vault
 
-Open the `project-knowledge/` folder as the Obsidian vault:
+Open the `workspaces/<profile>/project-knowledge/` folder as the Obsidian vault:
 
 ```text
-<workspace-root>/project-knowledge/
+<workspace-root>/workspaces/<profile>/project-knowledge/
 ```
 
 This keeps one source of truth:
@@ -30,14 +30,14 @@ This keeps one source of truth:
 
 Canonical project knowledge lives in:
 
-- `project-knowledge/00-start/`
+- `workspaces/<profile>/project-knowledge/00-start/`
-- `project-knowledge/01-current/`
+- `workspaces/<profile>/project-knowledge/01-current/`
-- `project-knowledge/02-work-items/`
+- `workspaces/<profile>/project-knowledge/02-work-items/`
-- `project-knowledge/03-context/`
+- `workspaces/<profile>/project-knowledge/03-context/`
-- `project-knowledge/04-people/`
+- `workspaces/<profile>/project-knowledge/04-people/`
-- `project-knowledge/05-decisions/`
+- `workspaces/<profile>/project-knowledge/05-decisions/`
-- `project-knowledge/06-daily/`
+- `workspaces/<profile>/project-knowledge/06-daily/`
-- `project-knowledge/07-maps/`
+- `workspaces/<profile>/project-knowledge/07-maps/`
 
 Technical runtime remains outside the vault:
 
@@ -46,11 +46,11 @@ Technical runtime remains outside the vault:
 - `scripts/`
 - `core/`
 - `profiles/`
-- `ai/inbox/`
+- `workspaces/<profile>/inbox/`
 - `scripts/*/generated/`
 - archives and local virtual environments
 
-Communication evidence may exist under `ai/inbox/` or connector `generated/` folders, but promoted memory belongs in `project-knowledge/`.
+Communication evidence may exist under `workspaces/<profile>/inbox/` or connector `generated/` folders, but promoted memory belongs in the profile's project knowledge vault.
 
 ---
 
@@ -58,25 +58,25 @@ Communication evidence may exist under `ai/inbox/` or connector `generated/` fol
 
 Version portable Obsidian configuration only when it improves the workspace for every clone:
 
-- `project-knowledge/.obsidian/app.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/app.json`
-- `project-knowledge/.obsidian/core-plugins.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/core-plugins.json`
-- `project-knowledge/.obsidian/graph.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/graph.json`
-- `project-knowledge/.obsidian/appearance.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/appearance.json`
-- `project-knowledge/.obsidian/daily-notes.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/daily-notes.json`
-- `project-knowledge/.obsidian/templates.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/templates.json`
-- `project-knowledge/.obsidian/bookmarks.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/bookmarks.json`
 
 Do not version local runtime state:
 
-- `project-knowledge/.obsidian/workspace*.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/workspace*.json`
-- `project-knowledge/.obsidian/workspace-mobile*.json`
+- `workspaces/<profile>/project-knowledge/.obsidian/workspace-mobile*.json`
-- `project-knowledge/.obsidian/plugins/`
+- `workspaces/<profile>/project-knowledge/.obsidian/plugins/`
-- `project-knowledge/.obsidian/snippets/`
+- `workspaces/<profile>/project-knowledge/.obsidian/snippets/`
-- `project-knowledge/.obsidian/cache/`
+- `workspaces/<profile>/project-knowledge/.obsidian/cache/`
 
 Recommended graph and search exclusions:
 
-- `ai/inbox/`
+- `workspaces/<profile>/inbox/`
 - `archives/`
 - `scripts/**/generated/`
 - `scripts/**/.venv/`
@@ -107,7 +107,7 @@ The agent should not treat Obsidian runtime layout changes as project context.
 
 If Obsidian metadata or properties are added, use them selectively for high-value notes such as work items, decisions, and index pages. Do not mass-convert existing files just to add metadata.
 
-Use map notes under `project-knowledge/07-maps/` as graph hubs. This keeps the graph navigable without forcing every file into Obsidian-specific wiki-link syntax.
+Use map notes under `workspaces/<profile>/project-knowledge/07-maps/` as graph hubs. This keeps the graph navigable without forcing every file into Obsidian-specific wiki-link syntax.
 
 ---
 

core/memory/operational-memory.md

@@ -87,7 +87,7 @@ core/**/*.md
 scripts/**/*.md
 ```
 
-Raw evidence stays outside `project-knowledge/`; promoted memory is written to `project-knowledge/`.
+Raw evidence stays outside `workspaces/<profile>/project-knowledge/`; promoted memory is written to `workspaces/<profile>/project-knowledge/`.
 
 ---
 
@@ -178,7 +178,7 @@ The agent should also identify recurring quality gaps proactively. If an answer
 
 For technical topics, recurring gaps often belong in:
 
-- domain-specific guidance under `project-knowledge/03-context/`
+- domain-specific guidance under `workspaces/<profile>/project-knowledge/03-context/`
 - reusable skills under `.agents/skills/`
 - agent behavior rules under `.opencode/agents/`, `AGENTS.md`, or `agent-memory/`
 - source anchors for official/current documentation

core/profiles/create-project-profile.md

@@ -48,7 +48,7 @@ project-knowledge/09-templates/
 
 Keep project-specific facts out of `core/`.
 
-Treat `project-knowledge/` as canonical project memory. Keep connector inboxes and generated evidence outside the project knowledge vault.
+Treat `workspaces/<profile>/project-knowledge/` as canonical project memory. Keep connector inboxes and generated evidence outside the project knowledge vault.
 
 ---
 
@@ -102,15 +102,15 @@ Before using the workspace for real work:
 
 ## 6. Obsidian Vault
 
-Open `project-knowledge/` as the Obsidian vault.
+Open `workspaces/<profile>/project-knowledge/` as the Obsidian vault.
 
 Use `scripts/memory/` as the project-agnostic memory interface. Obsidian is the default visual and CLI-backed adapter, but profile logic should not depend on Obsidian.
 
 Recommended rules:
 
-- keep `project-knowledge/` as the clean canonical project knowledge
+- keep `workspaces/<profile>/project-knowledge/` as the clean canonical project knowledge
-- keep runtime evidence, scripts, profiles, and generated files outside `project-knowledge/`
+- keep runtime evidence, scripts, profiles, and generated files outside `workspaces/<profile>/project-knowledge/`
-- version only portable `project-knowledge/.obsidian` configuration
+- version only portable `workspaces/<profile>/project-knowledge/.obsidian` configuration
 - ignore local Obsidian workspace state and plugin runtime files
-- create or update map notes under `project-knowledge/07-maps/` for human navigation
+- create or update map notes under `workspaces/<profile>/project-knowledge/07-maps/` for human navigation
-- create Bases under `project-knowledge/08-bases/` using simple `type` properties
+- create Bases under `workspaces/<profile>/project-knowledge/08-bases/` using simple `type` properties

core/services/local-rag-index.md

@@ -12,7 +12,7 @@ tags:
 
 ## Goal
 
-Add retrieval over canonical workspace memory without replacing the human-readable `project-knowledge/` vault.
+Add retrieval over canonical workspace memory without replacing the human-readable profile project knowledge vault.
 
 The local index is derived and disposable. If the index disagrees with Markdown, the Markdown wins.
 
@@ -29,7 +29,7 @@ scripts/aiw/indexer.py
 It reads:
 
 ```text
-project-knowledge/**/*.md
+workspaces/<profile>/project-knowledge/**/*.md
 ```
 
 and writes:
@@ -42,7 +42,7 @@ and writes:
 It skips:
 
 ```text
-project-knowledge/09-templates/
+workspaces/<profile>/project-knowledge/09-templates/
 ```
 
 so Obsidian templates do not appear as real memory.

core/services/service-manager.md

@@ -7,7 +7,7 @@ The AI Workspace should unify local service lifecycle without collapsing service
 - Service manager: starts, stops, checks, and logs local services.
 - Context MCP: exposes bounded read-only context to AI clients.
 - Capture services: produce local evidence such as Mattermost mirror records or photo inbox files.
-- Canonical memory remains under `project-knowledge/` and is updated by the agent using memory rules.
+- Canonical memory remains under `workspaces/<profile>/project-knowledge/` and is updated by the agent using memory rules.
 
 ## Service Types
 

docs/README.md

@@ -0,0 +1,31 @@
+# AIWorkspace Documentation
+
+AIWorkspace is a local context platform for developers. It connects project evidence, canonical human-readable memory, local services, and AI clients without making any single AI tool the source of truth.
+
+This documentation describes the target production architecture: reusable AIWorkspace core separated from project-specific AI context packs.
+
+## Start Here
+
+- [Concepts: Overview](concepts/overview.md)
+- [Concepts: Workspace vs Context Pack](concepts/workspace-vs-context-pack.md)
+- [Architecture: Storage Model](architecture/storage-model.md)
+- [Guide: Quick Start](guides/quick-start.md)
+- [Reference: Project Manifest](reference/project-manifest.md)
+
+## Documentation Map
+
+```text
+docs/
+  concepts/       Product concepts and user-facing mental model
+  architecture/   System boundaries, storage, services, and security
+  guides/         Task-oriented setup and usage guides
+  reference/      File formats, CLI, manifests, and environment variables
+```
+
+## Core Principle
+
+```text
+AIWorkspace provides context. Project context packs own project memory.
+```
+
+The core product should remain reusable and shareable. Project-specific facts, connector settings, people, channels, raw evidence, and prompts belong in separate context packs.

docs/architecture.md

@@ -0,0 +1,68 @@
+# Architecture
+
+AI Workspace is organized around explicit boundaries: profile configuration, raw evidence, canonical memory, derived retrieval, local services, and AI client adapters.
+
+## System Flow
+
+```text
+Communication / screenshots / archives / manual notes
+        ↓
+Raw inbox evidence
+        ↓
+Agent or human curation
+        ↓
+Canonical Markdown project knowledge
+        ↓
+Derived local index
+        ↓
+Read-only MCP context server
+        ↓
+AI clients and agent workflows
+```
+
+## Responsibility Boundaries
+
+| Layer | Responsibility | Canonical? |
+|---|---|---|
+| `core/` | Reusable architecture and operating model | yes, for workspace design |
+| `profiles/<profile>/` | Project-specific configuration and assumptions | yes, for profile config |
+| `workspaces/<profile>/project-knowledge/` | Human-readable project memory for the active profile | yes, for project facts |
+| `workspaces/<profile>/inbox/` | Raw evidence captured from connectors | no |
+| `.aiw/indexes/` | Rebuildable search indexes | no |
+| `.aiw/runtime/` | PID files, logs, local service state | no |
+| `scripts/aiw/` | Profile-aware service/index utilities | code source |
+| `scripts/mcp/` | MCP servers exposing local context | code source |
+| `apps/` | Local UI surfaces such as the macOS menu bar app | code source |
+
+## Current Repository Shape
+
+Profile-owned data lives under `workspaces/<profile>/`. Reusable code must resolve paths from `profiles/<profile>/workspace.json` rather than hardcoding profile-specific locations.
+
+Current data layout:
+
+```text
+profiles/<profile>/workspace.json   # where profile data lives
+workspaces/<profile>/project-knowledge/
+workspaces/<profile>/inbox/
+.aiw/indexes/<profile>/
+```
+
+## Design Principles
+
+- Keep the smallest useful context loaded by default.
+- Prefer just-in-time retrieval over dumping the entire workspace into prompts.
+- Keep human-readable Markdown as the project source of truth.
+- Keep raw evidence outside canonical memory until explicitly promoted.
+- Keep profile-specific facts out of `core/` and generic scripts.
+- Make local services observable through a single service manager.
+- Treat cloud memory systems as optional, not authoritative.
+
+## Why This Shape
+
+Current AI workflow guidance emphasizes context engineering: the model should receive the smallest high-signal context needed for the task. This workspace supports that by combining:
+
+- structured Markdown memory for durable facts;
+- raw evidence stores for auditability;
+- local indexes for retrieval;
+- MCP tools/resources for AI clients;
+- profile-specific boundaries for reuse across projects.

docs/architecture/storage-model.md

@@ -0,0 +1,98 @@
+# Storage Model
+
+AIWorkspace uses different storage locations for different kinds of data. This keeps the product shareable, the project context auditable, and local runtime state disposable.
+
+## Storage Responsibilities
+
+| Data | Target Location | Git? | Notes |
+|---|---|---:|---|
+| Core product code | `~/Developer/ai-workspace` | yes | Shared reusable product. |
+| Project manifest | `<context-pack>/aiw.project.json` | yes | Project identity and relative paths. |
+| Canonical memory | `<context-pack>/knowledge/` | usually yes | Human-readable Markdown. |
+| Raw evidence | `<context-pack>/inbox/` | usually no/private | Captured messages, screenshots, exports. |
+| Connector config | `<context-pack>/connectors/` | depends | Safe config can be tracked; secrets must not be tracked. |
+| Project prompts/agents | `<context-pack>/prompts/`, `<context-pack>/agents/` | depends | Track if safe for the team. |
+| User registry | `~/Library/Application Support/AIWorkspace/` | no | Local project registration and preferences. |
+| Logs | `~/Library/Logs/AIWorkspace/` | no | Service and app logs. |
+| Caches/indexes | `~/Library/Caches/AIWorkspace/` | no | Rebuildable derived data. |
+| Runtime/PIDs | `~/Library/Application Support/AIWorkspace/runtime/` | no | Local service state. |
+
+## Canonical Memory
+
+Canonical memory is the durable project source of truth for humans and AI.
+
+Target structure:
+
+```text
+knowledge/
+  current/
+  work-items/
+  systems/
+  workstreams/
+  people/
+  decisions/
+  daily/
+  templates/
+```
+
+Canonical memory should be:
+
+- readable without AIWorkspace;
+- reviewable in Git when shared;
+- explicit about uncertainty;
+- updated by humans or agents using small auditable changes.
+
+## Raw Evidence
+
+Raw evidence is input, not truth.
+
+Examples:
+
+```text
+inbox/
+  mattermost/
+  slack/
+  photos/
+  documents/
+  screenshots/
+```
+
+Raw evidence should not be promoted automatically into durable memory unless a workflow explicitly classifies it as high-confidence and project-relevant.
+
+## Derived Indexes
+
+Indexes are rebuildable.
+
+They should live outside the context pack by default:
+
+```text
+~/Library/Caches/AIWorkspace/indexes/<project>/
+```
+
+This prevents large derived artifacts from polluting project memory repositories.
+
+## Runtime State
+
+Service logs, PID files, and health snapshots should be local machine state.
+
+Target locations:
+
+```text
+~/Library/Logs/AIWorkspace/
+~/Library/Application Support/AIWorkspace/runtime/
+```
+
+Runtime state should not be used as project memory.
+
+## Secrets
+
+Secrets should not be stored in context packs unless they are encrypted and explicitly supported.
+
+Preferred approaches:
+
+- macOS Keychain references;
+- ignored local `.env` files;
+- environment variables;
+- enterprise-approved credential stores.
+
+Documentation, manifests, and generated configs should refer to secret names, not secret values.

docs/concepts/overview.md

@@ -0,0 +1,65 @@
+# AIWorkspace Overview
+
+AIWorkspace helps developers give AI tools the right project context at the right time.
+
+It is designed for teams and individuals who use multiple AI clients—OpenCode, GitHub Copilot, Claude Code, Cursor, VS Code, or others—but do not want project knowledge scattered across chat histories, prompt files, and product repositories.
+
+## What AIWorkspace Does
+
+AIWorkspace provides a local platform to:
+
+- connect communication and evidence sources;
+- keep canonical project memory in human-readable Markdown;
+- index that memory for fast retrieval;
+- expose bounded context through MCP;
+- generate AI client configuration when needed;
+- run local services such as context servers, capture proxies, and inbox receivers;
+- keep raw evidence separate from curated project knowledge.
+
+## What AIWorkspace Is Not
+
+AIWorkspace is not:
+
+- a replacement for a product repository;
+- a replacement for project documentation;
+- a cloud memory system;
+- a single-agent framework that forces one AI workflow;
+- a place to store secrets in Git;
+- a dumping ground for raw chat exports.
+
+## Target User Flow
+
+```text
+Developer installs AIWorkspace
+        ↓
+Registers or creates a project context pack
+        ↓
+Connects evidence sources and local repos
+        ↓
+AIWorkspace captures evidence and maintains indexes
+        ↓
+AI clients ask AIWorkspace MCP for project context
+        ↓
+Humans and agents update canonical project memory
+```
+
+## Key Concepts
+
+| Concept | Meaning |
+|---|---|
+| AIWorkspace Core | The reusable app, CLI, scripts, MCP server, connectors, templates, and documentation. |
+| User Registry | Local app configuration that remembers registered projects, paths, preferences, and service state. |
+| Project Context Pack | A project-specific folder or repo containing canonical memory, connector config, prompts, and optional raw evidence. |
+| Canonical Memory | Human-readable Markdown that represents current durable project knowledge. |
+| Raw Evidence | Captured messages, screenshots, exports, logs, or documents before curation. |
+| AI Client | Any tool that consumes context: OpenCode, Copilot, Claude Code, Cursor, VS Code, etc. |
+
+## Design Goal
+
+AIWorkspace should be plug-and-play for a new developer:
+
+1. install the app and CLI;
+2. register an existing context pack or create a new one;
+3. connect sources such as Mattermost, Slack, tickets, email, calendar, or local folders;
+4. let AIWorkspace detect repositories and services;
+5. use any AI client with project-aware context through MCP.

docs/concepts/workspace-vs-context-pack.md

@@ -0,0 +1,127 @@
+# Workspace vs Context Pack
+
+AIWorkspace separates the installed product, user-local settings, and project memory.
+
+This distinction keeps the system simple, shareable, and safe for unrelated projects such as `client-mobile` and `it-support`.
+
+## Three-Layer Model
+
+```text
+AIWorkspace Core
+  reusable installed product
+
+User/App Registry
+  local machine settings and registered context packs
+
+Project Context Packs
+  one isolated context package per project, client, or workstream
+```
+
+## AIWorkspace Core
+
+The core is the reusable product. It can be shared with a team.
+
+Typical location during development:
+
+```text
+~/Developer/ai-workspace
+```
+
+It contains:
+
+```text
+apps/
+scripts/
+connectors/
+templates/
+docs/
+examples/
+```
+
+It should not contain real project memory, captured messages, customer names, ticket details, or private prompts.
+
+## User/App Registry
+
+The registry is local to one developer machine. It records which context packs are available and which project is active.
+
+On macOS, the target location is:
+
+```text
+~/Library/Application Support/AIWorkspace/
+```
+
+Example registry:
+
+```json
+{
+  "schema": "aiworkspace.projects.v1",
+  "default_project": "client-mobile",
+  "projects": [
+    {
+      "id": "client-mobile",
+      "context_path": "/Users/david/Developer/client-mobile-ai-context"
+    },
+    {
+      "id": "it-support",
+      "context_path": "/Users/david/Developer/it-support-ai-context"
+    }
+  ]
+}
+```
+
+The registry is not intended for Git.
+
+## Project Context Pack
+
+A context pack is the portable project-specific unit. It may be a private repo, a team-shared repo, or a local folder.
+
+Example:
+
+```text
+client-mobile-ai-context/
+  aiw.project.json
+  knowledge/
+  inbox/
+  connectors/
+  agents/
+  prompts/
+```
+
+Each context pack owns its own:
+
+- canonical memory;
+- raw evidence;
+- connector definitions;
+- people/channel/system maps;
+- prompts and agent instructions specific to that project.
+
+## Why Not Store Everything In One Workspace Repo?
+
+One developer can work on unrelated projects. A single monolithic workspace can accidentally mix:
+
+- channels from different organizations;
+- people maps from unrelated clients;
+- raw evidence with different privacy rules;
+- prompts that only make sense for one domain;
+- AI behavior learned from one project but harmful in another.
+
+Context packs prevent this by making project boundaries explicit.
+
+## Optional Product Repository Binding
+
+Product repositories should stay clean by default. If useful, a repo can contain a small optional binding file:
+
+```text
+.aiworkspace.json
+```
+
+Example:
+
+```json
+{
+  "project": "client-mobile",
+  "context_path": "/Users/david/Developer/client-mobile-ai-context"
+}
+```
+
+This file should point to context. It should not contain memory, secrets, or raw evidence.

docs/getting-started.md

@@ -0,0 +1,63 @@
+# Getting Started
+
+AI Workspace is a local, profile-based context system for AI-assisted work. It keeps project memory, raw evidence, local services, and AI client integrations organized without making any single AI tool the source of truth.
+
+## Core Idea
+
+Use the workspace as a companion repo beside your real project or client work:
+
+```text
+implementation repo / corporate tools / chat evidence
+        ↓
+AI Workspace inbox and memory curation
+        ↓
+human-readable project knowledge
+        ↓
+local index and MCP context server
+        ↓
+OpenCode / Claude Code / Copilot / other AI clients
+```
+
+## First Run
+
+From the repository root:
+
+```bash
+python3 scripts/aiw/services.py doctor --profile fidelity
+python3 scripts/aiw/services.py status --profile fidelity
+python3 scripts/aiw/indexer.py build --profile fidelity
+```
+
+The `fidelity` profile is the first real project profile in this repo. New projects should follow the same shape but keep their own profile configuration and project memory isolated.
+
+Create a new isolated profile with:
+
+```bash
+python3 scripts/aiw/profile.py create my-project --display-name "My Project"
+python3 scripts/aiw/profile.py doctor --profile my-project
+```
+
+## Daily Use
+
+1. Open the project knowledge vault in Obsidian or your Markdown editor.
+2. Start only the local services needed for the profile.
+3. Capture raw evidence into the profile inbox.
+4. Promote useful, verified facts into canonical Markdown.
+5. Let AI clients query context through MCP or direct file reads.
+
+## Key Rules
+
+- Canonical project memory is Markdown, not chat history or vector storage.
+- Inboxes contain evidence, not promoted memory.
+- Indexes are derived and rebuildable.
+- MCP is read-only by default.
+- Secrets belong in ignored local `.env` files.
+
+## Next Reading
+
+- [Architecture](architecture.md)
+- [Profiles](profiles.md)
+- [Memory Model](memory-model.md)
+- [MCP](mcp.md)
+- [Services](services.md)
+- [Security and Privacy](security-and-privacy.md)

docs/guides/quick-start.md

@@ -0,0 +1,121 @@
+# Quick Start
+
+This guide describes the target production flow for a new developer using AIWorkspace.
+
+The current repository still contains an active project-specific implementation. During refactor, these commands may be implemented incrementally.
+
+## 1. Install AIWorkspace
+
+Install the app, CLI, and local services from the reusable core repo:
+
+```bash
+git clone <team-ai-workspace-repo> ~/Developer/ai-workspace
+cd ~/Developer/ai-workspace
+```
+
+The target CLI entry point is:
+
+```bash
+aiw
+```
+
+During development, commands may still be run through Python scripts.
+
+## 2. Register Or Create A Project Context Pack
+
+Register an existing context pack:
+
+```bash
+aiw project register ~/Developer/client-mobile-ai-context
+```
+
+Or create a new one:
+
+```bash
+aiw project create it-support --display-name "IT Support" --path ~/Developer/it-support-ai-context
+```
+
+The context pack contains project memory and project-specific connector configuration.
+
+## 3. Connect Evidence Sources
+
+Add only the connectors this project needs:
+
+```bash
+aiw connector add mattermost --project client-mobile
+aiw connector add photos --project client-mobile
+```
+
+For another project, the connector set may be completely different:
+
+```bash
+aiw connector add tickets --project it-support
+aiw connector add calendar --project it-support
+```
+
+## 4. Detect Local Repositories
+
+AIWorkspace should help detect local repos and associate them with projects:
+
+```bash
+aiw repo scan ~/Developer --project it-support
+```
+
+For projects whose source code lives on another machine, the context pack should say so explicitly in `aiw.project.json`.
+
+## 5. Start Context Services
+
+Start services for the active project:
+
+```bash
+aiw services start --project client-mobile
+aiw services status --project client-mobile
+```
+
+The service manager should start only capabilities configured for that project.
+
+## 6. Configure AI Clients
+
+Generate AI client integration files on demand:
+
+```bash
+aiw agent configure opencode --project client-mobile
+aiw agent configure copilot --project client-mobile
+aiw mcp config --client vscode
+```
+
+The preferred integration path is MCP, so AI clients can request current context without copying memory into product repositories.
+
+## 7. Use AIWorkspace From Any AI Tool
+
+The AI client should call MCP with a project id:
+
+```json
+{
+  "project": "client-mobile"
+}
+```
+
+Example tool calls:
+
+```text
+project_current_context(project="client-mobile")
+project_search_memory(project="it-support", query="printer onboarding")
+communication_latest(project="client-mobile")
+```
+
+## 8. Keep Canonical Memory Clean
+
+Project memory lives in the context pack:
+
+```text
+<context-pack>/knowledge/
+```
+
+Raw evidence lives separately:
+
+```text
+<context-pack>/inbox/
+```
+
+Do not treat raw captures, indexes, logs, or AI chat history as canonical memory.

docs/local-rag-index.md

@@ -0,0 +1,67 @@
+# Local RAG Index
+
+The local RAG index is the first retrieval layer over canonical Markdown memory.
+
+## Purpose
+
+It helps AI clients quickly find relevant snippets without loading the whole project knowledge vault into context.
+
+```text
+project-knowledge/ Markdown
+        ↓
+scripts/aiw/indexer.py
+        ↓
+.aiw/indexes/<profile>/project-knowledge.jsonl
+        ↓
+MCP tool: memory_hybrid_search
+```
+
+## Current Implementation
+
+The current indexer is dependency-free and lexical. It is intentionally simple so it can run on a new machine without a vector database.
+
+Build:
+
+```bash
+python3 scripts/aiw/indexer.py build --profile fidelity
+```
+
+Status:
+
+```bash
+python3 scripts/aiw/indexer.py status --profile fidelity
+```
+
+Search:
+
+```bash
+python3 scripts/aiw/indexer.py search "dismissal lifecycle" --profile fidelity
+```
+
+## What It Stores
+
+- source path;
+- heading;
+- text chunk;
+- mtime;
+- content hash;
+- chunk id.
+
+## What It Does Not Do
+
+- It does not replace Markdown.
+- It does not write project facts.
+- It does not index templates as real notes.
+- It does not send data to a cloud service.
+
+## Future Options
+
+Future phases may add:
+
+- better full-text ranking;
+- semantic embeddings;
+- Qdrant or Chroma as optional local vector stores;
+- hybrid lexical + semantic search;
+- index status in the menu bar app.
+
+Keep this as a derived layer. The project knowledge vault remains canonical.

docs/mcp.md

@@ -0,0 +1,73 @@
+# MCP Integration
+
+The Model Context Protocol (MCP) is the workspace's standard interface for exposing local context to AI clients.
+
+## Role In AI Workspace
+
+`aiw-context-mcp` is a read-only context server. It exposes bounded profile context through MCP tools and resources.
+
+It should not:
+
+- capture communication traffic;
+- send messages;
+- write canonical memory;
+- promote facts automatically;
+- expose secrets or raw credentials.
+
+## MCP Concepts
+
+MCP uses a host/client/server model:
+
+- **Host**: the AI app, such as OpenCode, Claude Code, VS Code, Copilot, or another client.
+- **Client**: the connection the host opens to a server.
+- **Server**: a local or remote program that exposes context.
+
+Servers expose primitives such as:
+
+- **Tools**: callable functions.
+- **Resources**: readable context objects.
+- **Prompts**: reusable prompt templates.
+
+AI Workspace currently focuses on tools and resources.
+
+## Current Tools
+
+Examples:
+
+- `context_profiles`
+- `project_current_context`
+- `project_search_memory`
+- `memory_hybrid_search`
+- `communication_latest`
+- `communication_date_context`
+- `communication_standup_context`
+- `photos_latest`
+
+## Current Resources
+
+Examples:
+
+```text
+aiw://profiles/fidelity/current-work
+aiw://profiles/fidelity/work-items
+aiw://profiles/fidelity/mattermost/latest
+aiw://profiles/fidelity/photos/latest
+```
+
+## Security Posture
+
+MCP tools can be model-controlled in many clients, so this workspace defaults to read-only context tools. If write tools are added later, they should require clear user intent, narrow scope, and audit-friendly outputs.
+
+## Start The MCP Server
+
+HTTP transport:
+
+```bash
+python3 scripts/aiw/services.py start aiw-context-mcp --profile fidelity
+```
+
+stdio transport:
+
+```bash
+python3 scripts/mcp/aiw-context-mcp/server.py --transport stdio
+```

docs/memory-model.md

@@ -0,0 +1,69 @@
+# Memory Model
+
+AI Workspace separates memory by purpose so that human-readable knowledge, raw evidence, agent behavior, and derived indexes do not collapse into one opaque store.
+
+## Memory Layers
+
+| Layer | Purpose | Examples | Canonical? |
+|---|---|---|---|
+| Canonical project memory | Durable project facts for humans and AI | current work, work items, people, decisions, daily notes | yes |
+| Raw evidence | Captured data before curation | Mattermost mirror, photos, archives | no |
+| Agent operating memory | Rules for agent behavior and workflows | promotion rules, communication style, verification rules | yes for agent behavior |
+| Derived index | Fast retrieval over canonical memory | `.aiw/indexes/<profile>/` | no |
+| External agent memory | Optional cross-agent recall | mem9, tool auto-memory | no for project truth |
+
+## Canonical Markdown
+
+The project knowledge vault should be readable without any AI tool:
+
+```text
+project-knowledge/
+  00-start/
+  01-current/
+  02-work-items/
+  03-context/
+  04-people/
+  05-decisions/
+  06-daily/
+  07-maps/
+  08-bases/
+  09-templates/
+```
+
+For future multi-profile setups, this same structure should live under a profile-specific workspace path.
+
+## Evidence Promotion
+
+Connectors write evidence. They do not decide what becomes memory.
+
+Promotion flow:
+
+```text
+inbox evidence → verified fact → smallest correct Markdown file
+```
+
+Do not promote:
+
+- secrets;
+- sync status;
+- generic chatter;
+- unverified guesses;
+- raw transcripts without curation.
+
+## Local Index
+
+The local RAG index is derived from canonical Markdown. It helps AI clients find relevant snippets quickly, but it is not the source of truth.
+
+If index output conflicts with Markdown, Markdown wins.
+
+## mem9 And Similar Memory Systems
+
+mem9 can be useful as an optional cross-agent recall layer for preferences, reusable workflow habits, and non-sensitive operational memory. It should not replace the project knowledge vault.
+
+Recommended stance:
+
+```text
+project-knowledge/ wins over mem9, vector stores, and chat memory.
+```
+
+For sensitive or corporate projects, avoid cloud memory ingestion unless the data policy is explicit and approved.

docs/profiles.md

@@ -0,0 +1,99 @@
+# Profiles
+
+Profiles make the workspace reusable across projects, clients, or personal workflows.
+
+Each profile should describe what the project is, where its memory lives, which communication sources matter, which local services are enabled, and how AI clients should access context.
+
+## Current Profile Layout
+
+```text
+profiles/
+  fidelity/
+    profile.md
+    services.json
+    context-sources.json
+  example/
+    profile.md
+```
+
+## Recommended Future Layout
+
+```text
+profiles/<profile>/
+  profile.md              # human-readable project profile
+  workspace.json          # profile paths and defaults
+  services.json           # local services for this profile
+  context-sources.json    # communication/source filters
+
+workspaces/<profile>/
+  project-knowledge/      # canonical Markdown vault
+  inbox/                  # raw evidence for this profile
+```
+
+## Profile Files
+
+### `profile.md`
+
+Human-readable summary for agents and developers:
+
+- project name;
+- workspace role;
+- communication sources;
+- work-item system;
+- stakeholders or roles;
+- important domain themes;
+- enabled workflows or skills.
+
+### `workspace.json`
+
+Profile path configuration:
+
+```json
+{
+  "profile": "example",
+  "display_name": "Example Project",
+  "knowledge_dir": "workspaces/example/project-knowledge",
+  "inbox_dir": "workspaces/example/inbox",
+  "index_dir": ".aiw/indexes/example"
+}
+```
+
+Reusable scripts should resolve these paths through `scripts/aiw/profile.py`.
+
+### `services.json`
+
+Profile-specific local service manifest for `scripts/aiw/services.py`.
+
+Examples:
+
+- context MCP;
+- communication proxy/mirror;
+- photo inbox;
+- future indexer or dashboard services.
+
+### `context-sources.json`
+
+Source filters for profile-bounded reads. For example, a Mattermost profile can define which channels count as high-signal context.
+
+## Adding A New Project
+
+1. Create the isolated profile and workspace:
+
+   ```bash
+   python3 scripts/aiw/profile.py create my-project --display-name "My Project"
+   ```
+
+2. Define services only for integrations the project actually uses.
+3. Put connector secrets in ignored `.env` files.
+4. Validate the layout:
+
+   ```bash
+   python3 scripts/aiw/profile.py doctor --profile my-project
+   ```
+
+5. Build the local index.
+6. Connect AI clients through the MCP server.
+
+## Migration Rule
+
+Reusable code should accept a `--profile` argument and resolve paths through profile configuration. Avoid adding hardcoded references to Fidelity, channel names, ticket prefixes, or company-specific folders in generic scripts.

docs/reference/project-manifest.md

@@ -0,0 +1,125 @@
+# Project Manifest Reference
+
+Each project context pack is described by an `aiw.project.json` file at the root of the context pack.
+
+The manifest defines project identity, storage paths, connectors, code locations, and AI client preferences. Paths are relative to the context pack unless explicitly absolute.
+
+## Minimal Manifest
+
+```json
+{
+  "schema": "aiworkspace.project.v1",
+  "id": "my-project",
+  "display_name": "My Project",
+  "knowledge_dir": "knowledge",
+  "inbox_dir": "inbox"
+}
+```
+
+## Full Example
+
+```json
+{
+  "schema": "aiworkspace.project.v1",
+  "id": "client-mobile",
+  "display_name": "Client Mobile",
+  "description": "Project context pack for a mobile application team.",
+  "knowledge_dir": "knowledge",
+  "inbox_dir": "inbox",
+  "connectors_dir": "connectors",
+  "prompts_dir": "prompts",
+  "agents_dir": "agents",
+  "connectors": {
+    "mattermost": {
+      "enabled": true,
+      "config": "connectors/mattermost.json"
+    },
+    "photos": {
+      "enabled": true,
+      "config": "connectors/photos.json"
+    }
+  },
+  "code_locations": [
+    {
+      "name": "Development machine",
+      "availability": "remote-machine"
+    }
+  ],
+  "ai_clients": {
+    "opencode": {
+      "enabled": true
+    },
+    "copilot": {
+      "enabled": true
+    }
+  }
+}
+```
+
+## Fields
+
+| Field | Required | Description |
+|---|---:|---|
+| `schema` | yes | Manifest schema version. Current target: `aiworkspace.project.v1`. |
+| `id` | yes | Stable lowercase project id used by CLI and MCP. |
+| `display_name` | yes | Human-friendly project name. |
+| `description` | no | Short project description. |
+| `knowledge_dir` | yes | Canonical Markdown memory directory. |
+| `inbox_dir` | yes | Raw evidence directory. |
+| `connectors_dir` | no | Directory for connector configs. Defaults to `connectors`. |
+| `prompts_dir` | no | Directory for project prompts. Defaults to `prompts`. |
+| `agents_dir` | no | Directory for project agent config. Defaults to `agents`. |
+| `connectors` | no | Connector registry for this project. |
+| `code_locations` | no | Local or remote code locations associated with this project. |
+| `ai_clients` | no | AI client integration preferences. |
+
+## Code Locations
+
+Code may be local, remote, or unavailable on the current machine.
+
+```json
+{
+  "name": "iOS App",
+  "path": "/Users/dev/Developer/app-ios",
+  "role": "consumer-app",
+  "availability": "local"
+}
+```
+
+Supported target availability values:
+
+- `local`
+- `remote-machine`
+- `not-configured`
+- `unknown`
+
+## Connector Configs
+
+Connector definitions should describe source behavior without storing secrets.
+
+Example `connectors/mattermost.json`:
+
+```json
+{
+  "schema": "aiworkspace.connector.mattermost.v1",
+  "enabled": true,
+  "context_channels": [
+    "team-standup",
+    "team-code-review"
+  ],
+  "secret_refs": {
+    "session": "keychain:aiworkspace/mattermost/session"
+  }
+}
+```
+
+## Validation Rules
+
+A production-ready manifest validator should check:
+
+- required fields exist;
+- project id is stable and path-safe;
+- configured directories exist or can be created;
+- connector config files exist when enabled;
+- secrets are referenced, not embedded;
+- code locations are explicit about local vs remote availability.

docs/security-and-privacy.md

@@ -0,0 +1,63 @@
+# Security And Privacy
+
+AI Workspace is designed for local-first, auditable context management. Treat it as a companion workspace that may contain sensitive project metadata and communication evidence.
+
+## Rules
+
+- Do not commit secrets, tokens, cookies, API keys, headers, or session IDs.
+- Keep connector credentials in ignored `.env` files.
+- Keep raw evidence outside canonical project memory until curated.
+- Keep MCP read-only unless a write tool has explicit safety rules.
+- Treat generated indexes as local artifacts because they may contain snippets from project notes.
+- Prefer local services for corporate or confidential projects.
+
+## Ignored Local State
+
+Examples of local-only data:
+
+```text
+.aiw/runtime/
+.aiw/indexes/
+workspaces/*/inbox/mattermost-mirror/
+scripts/*/.env
+```
+
+## Cloud Memory Systems
+
+Tools such as mem9 or managed vector stores can be useful, but they introduce a data boundary.
+
+Before enabling them for a project, decide:
+
+- what data may be stored;
+- whether cloud storage is allowed;
+- whether self-hosting is required;
+- who can inspect/delete memories;
+- what happens when cloud memory conflicts with Markdown.
+
+Default recommendation:
+
+```text
+Use cloud memory only for non-sensitive preferences unless a project policy approves broader use.
+```
+
+## MCP Safety
+
+MCP clients may let models invoke tools automatically. For that reason, workspace MCP tools should stay read-only by default and return bounded, source-attributed context.
+
+If future MCP write tools are added, require:
+
+- explicit user intent;
+- narrow target paths;
+- clear diffs or summaries;
+- no secret exposure;
+- easy audit through git.
+
+## Sharing The Repo
+
+Before sharing or open-sourcing a reusable version:
+
+1. Remove or isolate project-specific profile data.
+2. Confirm ignored inbox/runtime files are not tracked.
+3. Replace real profile examples with sanitized examples.
+4. Keep reusable architecture docs in `docs/` and `core/`.
+5. Keep confidential project knowledge in private profile/workspace data.

docs/services.md

@@ -0,0 +1,61 @@
+# Services
+
+The AI Workspace Service Manager provides one profile-aware lifecycle surface for local services.
+
+## Responsibility
+
+The service manager starts, stops, checks, and tails logs. It does not merge service responsibilities.
+
+```text
+Service Manager → process lifecycle/status/logs
+MCP Server      → read-only context access
+Connectors      → raw evidence capture
+Agent/Human     → memory promotion
+```
+
+## Common Commands
+
+```bash
+python3 scripts/aiw/services.py status --profile fidelity
+python3 scripts/aiw/services.py status --profile fidelity --json
+python3 scripts/aiw/services.py doctor --profile fidelity
+python3 scripts/aiw/services.py start --profile fidelity
+python3 scripts/aiw/services.py stop --profile fidelity
+python3 scripts/aiw/services.py logs aiw-context-mcp --profile fidelity
+```
+
+## Service Manifest
+
+Services are declared per profile:
+
+```text
+profiles/<profile>/services.json
+```
+
+A service can define:
+
+- command;
+- kind;
+- groups;
+- dependencies;
+- restart policy;
+- doctor checks;
+- health checks.
+
+## Current Service Types
+
+- `process`: long-running command with PID/log tracking.
+- `app-launcher`: one-shot command that opens an app/helper.
+- `mcp`: process service exposing an MCP-compatible context server.
+
+## Runtime Files
+
+Runtime artifacts are local and ignored:
+
+```text
+.aiw/runtime/pids/
+.aiw/runtime/logs/
+.aiw/runtime/state/
+```
+
+These files are operational state, not project memory.

profiles/example/profile.md

@@ -38,9 +38,9 @@ Non-sensitive example profile showing how a new project can reuse the workspace
 
 ## Context
 
-Project-specific durable context should live under `project-knowledge/03-context/`.
+Project-specific durable context should live under `workspaces/example/project-knowledge/03-context/`.
 
-People, decisions, daily notes, maps, and templates should live under the corresponding `project-knowledge/` folders.
+People, decisions, daily notes, maps, and templates should live under the corresponding `workspaces/example/project-knowledge/` folders.
 
 Do not place company secrets, raw exports, credentials, or private communication transcripts in the profile.
 

profiles/example/workspace.json

@@ -0,0 +1,8 @@
+{
+  "profile": "example",
+  "display_name": "Example Project",
+  "description": "Sanitized example profile for adapting AI Workspace to a new project.",
+  "knowledge_dir": "workspaces/example/project-knowledge",
+  "inbox_dir": "workspaces/example/inbox",
+  "index_dir": ".aiw/indexes/example"
+}

profiles/fidelity/profile.md

@@ -20,19 +20,13 @@ It keeps Fidelity-specific context, integrations, commands, and skills separate
 ## Communication Sources
 
 - Live communication: Mattermost
-- Preferred local Mattermost evidence source: proxy mirror under `ai/inbox/mattermost-mirror/` when present; legacy `ai/inbox/mattermost-latest.md` and `scripts/mattermost/generated/` are fallback evidence.
+- Preferred local Mattermost evidence source: proxy mirror under `workspaces/fidelity/inbox/mattermost-mirror/` when present; legacy `workspaces/fidelity/inbox/mattermost-latest.md` and `scripts/mattermost/generated/` are fallback evidence.
 - Historical archive: Slack export
 - Preferred channel naming: readable channel names instead of raw IDs
 - Current high-signal channel: `fidelity-preguntas`
 - Focused Mattermost context for standups/latest project reads should come from configured profile/environment channels, not hardcoded connector defaults. For this profile, the useful context-channel set is currently `fidelity-preguntas`, `fidelity-standup`, `fidelity-code-review`, `fidelity-interface-meetings-on-calendar-outlook-team-etc`, and `dm-david--jeff`; keep that list in local `.env` as `AIW_MATTERMOST_CONTEXT_CHANNELS` or an equivalent profile setup when using the reusable Mattermost reader.
 
-Compatibility environment variables:
+Generic workspace variables:
-
-- `FIDELITY_MATTERMOST_SYNC_CMD`
-- `FIDELITY_MATTERMOST_SYNC_INTERVAL_MINUTES`
-- `FIDELITY_SLACK_EXPORT_PATH`
-
-Generic variables should be preferred for new setup:
 
 - `AIW_PROJECT_KNOWLEDGE_DIR`
 - `AIW_MATTERMOST_SYNC_CMD`
@@ -47,16 +41,16 @@ Generic variables should be preferred for new setup:
 ## Work System
 
 - Work items are Jira-linked when available
-- Active ticket memory lives in `project-knowledge/02-work-items/`
+- Active ticket memory lives in `workspaces/fidelity/project-knowledge/02-work-items/`
-- Compact active summary lives in `project-knowledge/01-current/work-items.md`
+- Compact active summary lives in `workspaces/fidelity/project-knowledge/01-current/work-items.md`
 - Jira IDs and approved titles should remain visible for standups and manager updates
 
 ---
 
 ## Stakeholders
 
-- Current manager mapping lives in `project-knowledge/04-people/manager.md`
+- Current manager mapping lives in `workspaces/fidelity/project-knowledge/04-people/manager.md`
-- Person-specific collaboration context lives in `project-knowledge/04-people/`
+- Person-specific collaboration context lives in `workspaces/fidelity/project-knowledge/04-people/`
 - Manager-facing messages should be concise, explicit, and natural professional US English
 
 ---
@@ -65,14 +59,14 @@ Generic variables should be preferred for new setup:
 
 Core Fidelity context remains in:
 
-- `project-knowledge/03-context/project.md`
+- `workspaces/fidelity/project-knowledge/03-context/project.md`
-- `project-knowledge/03-context/systems/`
+- `workspaces/fidelity/project-knowledge/03-context/systems/`
-- `project-knowledge/03-context/workstreams/`
+- `workspaces/fidelity/project-knowledge/03-context/workstreams/`
-- `project-knowledge/03-context/ios/`
+- `workspaces/fidelity/project-knowledge/03-context/ios/`
-- `project-knowledge/03-context/process/`
+- `workspaces/fidelity/project-knowledge/03-context/process/`
-- `project-knowledge/05-decisions/`
+- `workspaces/fidelity/project-knowledge/05-decisions/`
 
-Raw communication evidence remains outside the project knowledge vault under `ai/inbox/` and generated connector folders.
+Raw communication evidence remains outside the project knowledge vault under `workspaces/fidelity/inbox/` and generated connector folders.
 
 Memory access should go through the project-agnostic `scripts/memory/` interface for note creation, search, Base queries, and health checks. Obsidian is the current visual and CLI adapter, not a Fidelity-specific dependency.
 

profiles/fidelity/workspace.json

@@ -0,0 +1,8 @@
+{
+  "profile": "fidelity",
+  "display_name": "Fidelity",
+  "description": "Current Fidelity AI Workspace profile with isolated profile-owned data paths.",
+  "knowledge_dir": "workspaces/fidelity/project-knowledge",
+  "inbox_dir": "workspaces/fidelity/inbox",
+  "index_dir": ".aiw/indexes/fidelity"
+}

project-knowledge/01-current/work-items.md

@@ -1,55 +0,0 @@
----
-type: current-work-items
-project: fidelity
-status: active
-updated: 2026-05-14
-tags:
-  - current-work
-  - work-item
-  - fidelity
----
-# Active Work Items
-
-Use this file as the quick summary for active Jira-linked work.
-
-Detailed ticket memory now lives under `project-knowledge/02-work-items/`.
-
-Update the per-ticket files first when scope, status, sequencing, or communication framing changes materially.
-
-## Current
-
-- `PDIAP-15838` - Remove Apollo for iOS
-  Detail: `project-knowledge/02-work-items/pdiap-15838.md`
-  Current note: ticket moved to Done after external review feedback was addressed, but the draft PR stays unmerged. Keep the branch up to date with `main` until REST backend is live in production and REST toggles have been enabled for consumers for the required validation window; expected merge timing is at least 30 days out. May 13 follow-up validation succeeded on iOS after Raj enabled the production LaunchDarkly toggle for the specific production test user's MID.
-
-- `PDIAP-15836` - Modernize dismissal delegate lifecycle sequencing for pure SwiftUI environment
-  Detail: `project-knowledge/02-work-items/pdiap-15836.md`
-  Current note: moved to In Progress on May 7. David found a possible minimal dismissal fix path that would not require removing `UIHostingController`, but Jeff directed David to do the dismissal/lifecycle work and `PDIAP-12284` UIKit-removal work in the same branch because both changes require consumer testing. A May 11 simulator log review suggests the tested SwiftUI-host path fires delegate/session-clear callbacks only after host-disappearance confirmation, but broader branch and consumer validation are still needed.
-
-- `PDIAP-12284` - Remove UIKit wrapping from XFlow
-  Detail: `project-knowledge/02-work-items/pdiap-12284.md`
-  Current note: moved to In Progress on May 12 and should be handled with `PDIAP-15836` in the same branch. Quy confirmed both stories can remain In Progress together, so no immediate Jira restructuring is required. Current implementation direction is to avoid Fid4 per-flow host-mode mapping and instead evaluate XFlowViewMaker-owned global host-mode resolution, with SwiftUI as default and `UIHostingController` only as an explicit temporary fallback. May 12 implementation pass resolved earlier shape concerns with neutral enum names, `iOS-XflowUIKitHostEnabled`, SwiftUI default semantics, and `AnyView` removed from builder internals. Fid4 now compiles after manual dependency/build handling. May 13 AccountLink runtime validation looks good for both SwiftUI-default and forced UIKit-host paths. May 14 SampleApp work added explicit UIKit-host vs SwiftUI-host validation paths. May 20-21 status: sessions 004, 005, 008, and 009 confirmed full validation for HybridBloomAccountOpening (both hosts, full lifecycle/dismissal confirmed), HybridBrokerageAccountOpening (both hosts, full lifecycle confirmed), and HybridYouthAccountOpening (both hosts, full lifecycle/dismissal confirmed, resolving the dismissal gap). Remaining gaps are accountlink UIKit host, AODeeplinkLaunchView (both toggle branches and dismissal), and launch wrappers/common-launch flows. Draft PRs were opened for XFlowSDK and XFlowViewMaker on May 20 while validation continues.
-
-## Backlog / Future Reference
-
-- `PDIAP-11962` - Closure of secret scanning alerts
-  Detail: `project-knowledge/02-work-items/pdiap-11962.md`
-  Current note: prior closure was submitted on October 9, 2025 and Matthew closed earlier alerts/story on March 5, 2026. Two Google API Key alerts remain open and appear tied to old April 18, 2025 work, not the current REST story.
-
-- `PDIAP-11961` - Remediation of Exposed Secrets in XFlow iOS SDK - Request for Rotation/Invalidation
-  Detail: `project-knowledge/02-work-items/pdiap-11961.md`
-  Current note: related unassigned story for remaining Google API Key alerts; not a current priority but should be preserved for future planning.
-
-- `PDIAP-11562` - Investigate if XFlow is being built as debug
-  Detail: `project-knowledge/02-work-items/pdiap-11562.md`
-  Current note: likely tied to the `XFlowSDK_Debug` variable check in the XFlow podspec and Fid4 consumption, not Sparta-team work; historical Slack suggests Jenkins may build the xcframework path while local development consumes XFlow as a normal library, but this needs current validation.
-
-- `PDIAP-12226`, `PDIAP-12227`, `PDIAP-12228` - Sparta backlog items
-  Details: `project-knowledge/02-work-items/pdiap-12226.md`, `project-knowledge/02-work-items/pdiap-12227.md`, `project-knowledge/02-work-items/pdiap-12228.md`
-  Current note: Slack history ties these to the SpartaSDK follow-up split from initialization/JSON decoding, grid rendering/core components, and interactive/lifecycle behavior. Decoding and rendering are partially complete; interactive components remain blocked by unresolved mobile JavaScript execution.
-
-## Recently Completed
-
-- `PDIAP-16167` - AccountLink - XFlow causing web view rewrites investigation
-  Detail: `project-knowledge/02-work-items/pdiap-16167.md`
-  Current note: moved to Done after publishing the Confluence report and sending the findings to Zachary / Jira / Discourse. Future references should frame this as a consumer-side SwiftUI presentation-topology issue, not an XFlow/XFlowViewMaker regression.

prompts/manager-update.md

@@ -1,6 +1,6 @@
 # Manager Update Prompt
 
-Use the current state, today's daily note, `project-knowledge/01-current/work-items.md`, the relevant files under `project-knowledge/02-work-items/`, `project-knowledge/03-context/project.md`, `project-knowledge/03-context/process/communication.md`, `project-knowledge/04-people/manager.md`, and `project-knowledge/04-people/index.md`.
+Use the current state, today's daily note, `workspaces/fidelity/project-knowledge/01-current/work-items.md`, the relevant files under `workspaces/fidelity/project-knowledge/02-work-items/`, `workspaces/fidelity/project-knowledge/03-context/project.md`, `workspaces/fidelity/project-knowledge/03-context/process/communication.md`, `workspaces/fidelity/project-knowledge/04-people/manager.md`, and `workspaces/fidelity/project-knowledge/04-people/index.md`.
 
 Draft a Mattermost update for the current manager or stakeholder in concise, natural, professional US English.
 

prompts/standup.md

@@ -2,13 +2,13 @@
 
 > **Format note (2026-05-13):** Mattermost requires a visible blank line before section headers like `Today:` and `Blockers:` for proper rendering. Always emit two newline characters between the previous bullet/list item and the next section header; never place `Today:` immediately after a list item.
 
-Use `project-knowledge/01-current/current-work.md`, `project-knowledge/01-current/work-items.md`, the detailed files referenced from that active-work summary, `project-knowledge/03-context/project.md`, `project-knowledge/03-context/workstreams/index.md`, `project-knowledge/03-context/process/communication.md`, `project-knowledge/04-people/manager.md`, the previous workday communication context, today's daily note if present, and the latest available communication context.
+Use `workspaces/fidelity/project-knowledge/01-current/current-work.md`, `workspaces/fidelity/project-knowledge/01-current/work-items.md`, the detailed files referenced from that active-work summary, `workspaces/fidelity/project-knowledge/03-context/project.md`, `workspaces/fidelity/project-knowledge/03-context/workstreams/index.md`, `workspaces/fidelity/project-knowledge/03-context/process/communication.md`, `workspaces/fidelity/project-knowledge/04-people/manager.md`, the previous workday communication context, today's daily note if present, and the latest available communication context.
 
 Generate a standup update for the active project profile.
 
 ## Required refresh
 
-- At the start of the day, fetch or read refreshed Mattermost evidence before drafting. Prefer the local proxy mirror through `scripts/mattermost-proxy/read-context.py` when it exists; legacy sync output is fallback evidence.
+- At the start of the day, fetch or read refreshed Mattermost evidence before drafting. Prefer the local proxy mirror through `scripts/mattermost-proxy/read-context.py` when it exists; use configured sync output only when a fresh API pull is required.
 - Fetch focused standup evidence with `python3 scripts/mattermost-proxy/read-context.py --mode standup --today YYYY-MM-DD`; this reads previous-workday and today records from date-bucketed mirror files and should filter through the active profile's configured `AIW_MATTERMOST_CONTEXT_CHANNELS` when available. Do not read broad `latest.md` for standups unless the focused date-bucketed view is unavailable and you explicitly label the fallback as broad/noisy.
 - If Mattermost refresh fails, say so internally and use only saved workspace memory with clear caution; do not invent fresher context.
 - Do not skip communication refresh for standup just to reduce latency, because stale standups cost more time to correct later.

scripts/README.md

@@ -41,7 +41,7 @@ bash scripts/memory/memory.sh search "PDIAP-15765"
 bash scripts/memory/memory.sh create work-item pdiap-15999 "Example title"
 ```
 
-This interface defaults to Markdown files under `project-knowledge/`, uses Obsidian CLI when useful and available, and falls back to direct file operations.
+This interface resolves the canonical Markdown directory from `profiles/<profile>/workspace.json`, uses Obsidian CLI when useful and available, and falls back to direct file operations.
 
 The default workspace Mattermost extractor now lives in:
 
@@ -62,10 +62,9 @@ bash scripts/mattermost/bootstrap.sh
 The current Mattermost extractor is stdlib-only and does not require installing `requests`.
 It also supports readable channel names in `.env`, not only channel IDs.
 
-If you still want to override it with another script, expose that to OpenCode with:
+If you want to override it with another script, expose that to OpenCode with:
 
 - `AIW_MATTERMOST_SYNC_CMD`
-- `FIDELITY_MATTERMOST_SYNC_CMD`
 
 Example:
 
@@ -79,7 +78,7 @@ Expected behavior:
 - avoid interactive prompts
 - return a non-zero exit code on failure
 
-OpenCode can then use that output to refresh `ai/inbox/mattermost-latest.md` proactively. When the local Mattermost proxy mirror is running, commands should prefer `ai/inbox/mattermost-mirror/` through `scripts/mattermost-proxy/read-context.py` and use legacy sync output as fallback evidence.
+OpenCode can then use that output to refresh the active profile inbox proactively. When the local Mattermost proxy mirror is running, commands should prefer `<profile inbox>/mattermost-mirror/` through `scripts/mattermost-proxy/read-context.py --profile <profile>`.
 
 Historical Slack exports can also be imported through:
 

scripts/aiw/README.md

@@ -34,7 +34,7 @@ The service manager unifies startup and status. It does not move capture behavio
 
 ## Local project-knowledge index
 
-The workspace includes a dependency-free local indexer for canonical Markdown memory. The index is derived from `project-knowledge/` and written under `.aiw/indexes/<profile>/`; it is safe to delete and rebuild.
+The workspace includes a dependency-free local indexer for canonical Markdown memory. The index is derived from the profile's configured `knowledge_dir` and written under the profile's configured `index_dir`; it is safe to delete and rebuild.
 
 ```bash
 python3 scripts/aiw/indexer.py build --profile fidelity
@@ -44,6 +44,33 @@ python3 scripts/aiw/indexer.py search "dismissal lifecycle" --profile fidelity
 
 `aiw-context-mcp` exposes the same derived search through the read-only `memory_hybrid_search` tool and falls back to live Markdown search if the index has not been built yet.
 
+## Profile path configuration
+
+Reusable scripts resolve profile-specific paths through:
+
+```text
+profiles/<profile>/workspace.json
+```
+
+Current fields:
+
+```json
+{
+  "knowledge_dir": "workspaces/fidelity/project-knowledge",
+  "inbox_dir": "workspaces/fidelity/inbox",
+  "index_dir": ".aiw/indexes/fidelity"
+}
+```
+
+Use `scripts/aiw/profile.py` from new scripts instead of hardcoding project memory or inbox paths.
+
+Create and validate an isolated profile:
+
+```bash
+python3 scripts/aiw/profile.py create my-project --display-name "My Project"
+python3 scripts/aiw/profile.py doctor --profile my-project
+```
+
 ## Robustness features
 
 - Manifest validation before lifecycle actions.
@@ -59,5 +86,6 @@ python3 scripts/aiw/indexer.py search "dismissal lifecycle" --profile fidelity
 
 ```bash
 python3 scripts/aiw/test_services.py
+python3 scripts/aiw/test_profile.py
 python3 scripts/aiw/test_indexer.py
 ```

scripts/aiw/indexer.py

@@ -12,6 +12,7 @@ import argparse
 import hashlib
 import json
 import re
+import sys
 import time
 from dataclasses import dataclass
 from datetime import datetime, timezone
@@ -20,11 +21,13 @@ from typing import Any
 
 
 ROOT = Path(__file__).resolve().parents[2]
-INDEX_ROOT = ROOT / ".aiw" / "indexes"
 DEFAULT_PROFILE = "fidelity"
 MAX_CHARS = 1800
 OVERLAP_CHARS = 180
 
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import profile as aiw_profile  # noqa: E402
+
 
 @dataclass(frozen=True)
 class Chunk:
@@ -37,15 +40,15 @@ class Chunk:
 
 
 def project_knowledge_dir(profile: str) -> Path:
-    profile_base = ROOT / "profiles" / profile
+    return aiw_profile.knowledge_dir(profile, root=ROOT)
-    candidate = profile_base / "project-knowledge"
-    if candidate.exists():
-        return candidate
-    return ROOT / "project-knowledge"
 
 
 def index_dir(profile: str) -> Path:
-    return INDEX_ROOT / profile
+    return aiw_profile.index_dir(profile, root=ROOT)
+
+
+def rel(path: Path) -> str:
+    return aiw_profile.relative_to_root(path, root=ROOT)
 
 
 def index_path(profile: str) -> Path:
@@ -120,13 +123,13 @@ def build_chunks(profile: str) -> list[Chunk]:
     chunks: list[Chunk] = []
     for path in iter_markdown_files(base):
         raw = path.read_text(encoding="utf-8", errors="replace")
-        rel = str(path.relative_to(ROOT))
+        rel_path = rel(path)
         digest = hashlib.sha256(raw.encode("utf-8", errors="replace")).hexdigest()
         mtime = path.stat().st_mtime
         for section_index, (heading, section) in enumerate(split_sections(raw)):
             for chunk_index, chunk in enumerate(chunk_text(section)):
-                chunk_digest = hashlib.sha256(f"{rel}\n{section_index}\n{chunk_index}\n{chunk}".encode("utf-8")).hexdigest()[:16]
+                chunk_digest = hashlib.sha256(f"{rel_path}\n{section_index}\n{chunk_index}\n{chunk}".encode("utf-8")).hexdigest()[:16]
-                chunks.append(Chunk(chunk_id=chunk_digest, path=rel, heading=heading, text=chunk, mtime=mtime, sha256=digest))
+                chunks.append(Chunk(chunk_id=chunk_digest, path=rel_path, heading=heading, text=chunk, mtime=mtime, sha256=digest))
     return chunks
 
 
@@ -140,14 +143,14 @@ def write_index(profile: str) -> dict[str, Any]:
     files = sorted({chunk.path for chunk in chunks})
     manifest = {
         "profile": profile,
-        "source": str(project_knowledge_dir(profile).relative_to(ROOT)),
+        "source": rel(project_knowledge_dir(profile)),
         "canonical": False,
         "derived_from": "project-knowledge",
         "index_type": "lexical-markdown-chunks",
         "created_at": datetime.now(timezone.utc).isoformat(),
         "file_count": len(files),
         "chunk_count": len(chunks),
-        "index_path": str(index_path(profile).relative_to(ROOT)),
+        "index_path": rel(index_path(profile)),
     }
     manifest_path(profile).write_text(json.dumps(manifest, ensure_ascii=False, indent=2, sort_keys=True) + "\n", encoding="utf-8")
     return manifest
@@ -225,7 +228,7 @@ def search_index(profile: str, query: str, limit: int = 10) -> dict[str, Any]:
 def status(profile: str) -> dict[str, Any]:
     manifest_file = manifest_path(profile)
     if not manifest_file.is_file():
-        return {"profile": profile, "indexed": False, "index_path": str(index_path(profile).relative_to(ROOT))}
+        return {"profile": profile, "indexed": False, "index_path": rel(index_path(profile))}
     manifest = json.loads(manifest_file.read_text(encoding="utf-8"))
     path = index_path(profile)
     manifest["indexed"] = path.is_file()

scripts/aiw/profile.py

@@ -0,0 +1,209 @@
+#!/usr/bin/env python3
+"""Profile path resolution for AI Workspace scripts.
+
+Profiles own their configuration. Reusable scripts should call this module
+instead of hardcoding project paths.
+"""
+
+from __future__ import annotations
+
+import json
+import argparse
+import re
+from pathlib import Path
+from typing import Any
+
+
+ROOT = Path(__file__).resolve().parents[2]
+
+
+DEFAULT_WORKSPACE = {
+    "knowledge_dir": "workspaces/{profile}/project-knowledge",
+    "inbox_dir": "workspaces/{profile}/inbox",
+    "index_dir": ".aiw/indexes/{profile}",
+}
+
+PROFILE_RE = re.compile(r"^[a-z0-9][a-z0-9_-]*$")
+KNOWLEDGE_DIRS = [
+    "00-start",
+    "01-current",
+    "02-work-items",
+    "03-context/process",
+    "03-context/systems",
+    "03-context/workstreams",
+    "04-people",
+    "05-decisions",
+    "06-daily",
+    "07-maps",
+    "08-bases",
+    "09-templates",
+    "attachments",
+]
+
+
+def workspace_config_path(profile: str, root: Path | None = None) -> Path:
+    base = root or ROOT
+    return base / "profiles" / profile / "workspace.json"
+
+
+def load_workspace_config(profile: str, root: Path | None = None) -> dict[str, Any]:
+    base = root or ROOT
+    config = dict(DEFAULT_WORKSPACE)
+    config["profile"] = profile
+    path = workspace_config_path(profile, root=base)
+    if path.is_file():
+        try:
+            loaded = json.loads(path.read_text(encoding="utf-8"))
+            if isinstance(loaded, dict):
+                config.update(loaded)
+        except json.JSONDecodeError:
+            pass
+    return config
+
+
+def resolve_path(raw: str | None, *, profile: str, root: Path | None = None, fallback: str) -> Path:
+    base = root or ROOT
+    value = (raw or fallback).format(profile=profile)
+    path = Path(value).expanduser()
+    return path if path.is_absolute() else base / path
+
+
+def knowledge_dir(profile: str, root: Path | None = None) -> Path:
+    config = load_workspace_config(profile, root=root)
+    return resolve_path(config.get("knowledge_dir"), profile=profile, root=root, fallback="workspaces/{profile}/project-knowledge")
+
+
+def inbox_dir(profile: str, root: Path | None = None) -> Path:
+    config = load_workspace_config(profile, root=root)
+    return resolve_path(config.get("inbox_dir"), profile=profile, root=root, fallback="workspaces/{profile}/inbox")
+
+
+def index_dir(profile: str, root: Path | None = None) -> Path:
+    config = load_workspace_config(profile, root=root)
+    return resolve_path(config.get("index_dir"), profile=profile, root=root, fallback=".aiw/indexes/{profile}")
+
+
+def relative_to_root(path: Path, root: Path | None = None) -> str:
+    base = root or ROOT
+    try:
+        return str(path.relative_to(base))
+    except ValueError:
+        return str(path)
+
+
+def validate_profile_name(profile: str) -> None:
+    if not PROFILE_RE.match(profile):
+        raise SystemExit("profile must be lowercase letters, numbers, dashes, or underscores")
+
+
+def write_file_once(path: Path, text: str) -> None:
+    if path.exists():
+        return
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(text, encoding="utf-8")
+
+
+def create_profile(profile: str, display_name: str | None = None, root: Path | None = None) -> dict[str, Any]:
+    validate_profile_name(profile)
+    base = root or ROOT
+    display = display_name or profile.replace("-", " ").replace("_", " ").title()
+    profile_dir = base / "profiles" / profile
+    knowledge = knowledge_dir(profile, root=base)
+    inbox = inbox_dir(profile, root=base)
+    index = index_dir(profile, root=base)
+
+    if profile_dir.exists() or knowledge.exists() or inbox.exists():
+        raise SystemExit(f"profile already exists or has data directories: {profile}")
+
+    profile_dir.mkdir(parents=True)
+    write_file_once(profile_dir / "profile.md", f"# {display} Profile\n\n## Purpose\n\nDescribe how this project uses AI Workspace.\n\n## Project\n\n- Name: {display}\n- Workspace role: companion AI workspace\n\n## Communication Sources\n\n- Live communication: configure if needed\n- Historical archive: optional\n\n## Work System\n\n- Use the profile project knowledge vault for work items and current state.\n")
+    write_file_once(profile_dir / "workspace.json", json.dumps({
+        "profile": profile,
+        "display_name": display,
+        "description": f"AI Workspace profile for {display}.",
+        "knowledge_dir": relative_to_root(knowledge, root=base),
+        "inbox_dir": relative_to_root(inbox, root=base),
+        "index_dir": relative_to_root(index, root=base),
+    }, ensure_ascii=False, indent=2, sort_keys=True) + "\n")
+    write_file_once(profile_dir / "services.json", json.dumps({"profile": profile, "description": f"Local services for {display}.", "services": {}}, ensure_ascii=False, indent=2, sort_keys=True) + "\n")
+    write_file_once(profile_dir / "context-sources.json", json.dumps({"communication_sources": {}}, ensure_ascii=False, indent=2, sort_keys=True) + "\n")
+
+    for folder in KNOWLEDGE_DIRS:
+        (knowledge / folder).mkdir(parents=True, exist_ok=True)
+    inbox.mkdir(parents=True, exist_ok=True)
+    write_file_once(knowledge / "00-start" / "start-here.md", f"# {display} Start Here\n\nUse this note as the entry point for the {display} project knowledge vault.\n")
+    write_file_once(knowledge / "01-current" / "current-work.md", "# Current Work\n\n## Focus\n\n- TBD\n")
+    write_file_once(knowledge / "01-current" / "work-items.md", "# Work Items\n\nNo active work items recorded yet.\n")
+    write_file_once(knowledge / "03-context" / "project.md", f"# {display} Project Context\n\nDurable project context goes here.\n")
+    write_file_once(knowledge / "04-people" / "index.md", "# People\n\nProject people and role mappings go here.\n")
+    write_file_once(knowledge / "07-maps" / "index.md", "# Maps\n\nNavigation maps go here.\n")
+    write_file_once(knowledge / "09-templates" / "work-item.md", "---\ntype: work-item\ntitle: {{title}}\nupdated: {{date}}\n---\n\n# {{title}}\n")
+    write_file_once(knowledge / "09-templates" / "daily.md", "---\ntype: daily\ndate: {{date}}\nupdated: {{date}}\n---\n\n# {{date}}\n")
+    write_file_once(inbox / "README.md", f"# {display} Inbox\n\nRaw evidence for this profile. Promote durable facts into the project knowledge vault.\n")
+    return {"profile": profile, "profile_dir": relative_to_root(profile_dir, root=base), "knowledge_dir": relative_to_root(knowledge, root=base), "inbox_dir": relative_to_root(inbox, root=base)}
+
+
+def doctor(profile: str, root: Path | None = None) -> dict[str, Any]:
+    base = root or ROOT
+    config_path = workspace_config_path(profile, root=base)
+    knowledge = knowledge_dir(profile, root=base)
+    inbox = inbox_dir(profile, root=base)
+    checks = {
+        "profile_config_exists": config_path.is_file(),
+        "knowledge_dir_exists": knowledge.is_dir(),
+        "inbox_dir_exists": inbox.is_dir(),
+        "start_here_exists": (knowledge / "00-start" / "start-here.md").is_file(),
+        "current_work_exists": (knowledge / "01-current" / "current-work.md").is_file(),
+        "work_items_exists": (knowledge / "01-current" / "work-items.md").is_file(),
+    }
+    return {"profile": profile, "ok": all(checks.values()), "checks": checks, "paths": {"knowledge_dir": relative_to_root(knowledge, root=base), "inbox_dir": relative_to_root(inbox, root=base), "index_dir": relative_to_root(index_dir(profile, root=base), root=base)}}
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    path_parser = subparsers.add_parser("path", help="Print a resolved profile path.")
+    path_parser.add_argument("kind", choices=["knowledge", "inbox", "index"])
+    path_parser.add_argument("--profile", default="fidelity")
+
+    config_parser = subparsers.add_parser("config", help="Print resolved workspace configuration as JSON.")
+    config_parser.add_argument("--profile", default="fidelity")
+
+    create_parser = subparsers.add_parser("create", help="Create a new isolated project profile.")
+    create_parser.add_argument("profile")
+    create_parser.add_argument("--display-name", default="")
+
+    doctor_parser = subparsers.add_parser("doctor", help="Validate profile workspace layout.")
+    doctor_parser.add_argument("--profile", default="fidelity")
+
+    args = parser.parse_args()
+    if args.command == "path":
+        if args.kind == "knowledge":
+            print(knowledge_dir(args.profile))
+        elif args.kind == "inbox":
+            print(inbox_dir(args.profile))
+        else:
+            print(index_dir(args.profile))
+        return
+
+    if args.command == "create":
+        print(json.dumps(create_profile(args.profile, args.display_name or None), ensure_ascii=False, indent=2, sort_keys=True))
+        return
+
+    if args.command == "doctor":
+        payload = doctor(args.profile)
+        print(json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True))
+        raise SystemExit(0 if payload["ok"] else 1)
+
+    config = load_workspace_config(args.profile)
+    config["resolved"] = {
+        "knowledge_dir": str(knowledge_dir(args.profile)),
+        "inbox_dir": str(inbox_dir(args.profile)),
+        "index_dir": str(index_dir(args.profile)),
+    }
+    print(json.dumps(config, ensure_ascii=False, indent=2, sort_keys=True))
+
+
+if __name__ == "__main__":
+    main()

scripts/aiw/services.py

@@ -31,6 +31,16 @@ STATE_DIR = RUNTIME_DIR / "state"
 DEFAULT_LOG_MAX_BYTES = 5 * 1024 * 1024
 DEFAULT_LOG_BACKUPS = 3
 DEFAULT_STOP_TIMEOUT_SECONDS = 5.0
+DEFAULT_SERVICE_PATHS = [
+    "/opt/homebrew/bin",
+    "/opt/homebrew/sbin",
+    "/usr/local/bin",
+    "/usr/local/sbin",
+    "/usr/bin",
+    "/bin",
+    "/usr/sbin",
+    "/sbin",
+]
 
 
 @dataclass(frozen=True)
@@ -126,14 +136,35 @@ def resolve_workspace_path(raw: str) -> Path:
     return path if path.is_absolute() else ROOT / path
 
 
-def command_exists(command: str) -> bool:
+def service_env(profile: str | None = None) -> dict[str, str]:
+    """Return a robust environment for services launched from shells or GUI apps.
+
+    macOS login items do not reliably inherit the user's interactive shell PATH.
+    Homebrew-installed tools such as mitmdump commonly live under /opt/homebrew/bin
+    or /usr/local/bin, so make those paths available to both direct service
+    commands and nested scripts.
+    """
+    env = os.environ.copy()
+    existing = [part for part in env.get("PATH", "").split(os.pathsep) if part]
+    merged: list[str] = []
+    for part in [*existing, *DEFAULT_SERVICE_PATHS]:
+        if part not in merged:
+            merged.append(part)
+    env["PATH"] = os.pathsep.join(merged)
+    env.setdefault("AIW_WORKSPACE_ROOT", str(ROOT))
+    if profile:
+        env.setdefault("AIW_PROJECT_PROFILE", profile)
+    return env
+
+
+def command_exists(command: str, env: dict[str, str] | None = None) -> bool:
     if not command:
         return False
     path = Path(command)
     if path.is_absolute() or "/" in command:
         resolved = resolve_workspace_path(command)
         return resolved.exists() and os.access(resolved, os.X_OK)
-    return shutil_which(command) is not None
+    return shutil_which(command, env=env) is not None
 
 
 def rotate_log_if_needed(path: Path, max_bytes: int = DEFAULT_LOG_MAX_BYTES, backups: int = DEFAULT_LOG_BACKUPS) -> None:
@@ -273,9 +304,10 @@ def start_service(profile: str, ref: ServiceRef, manifest: dict[str, Any], start
 
     kind = ref.config.get("kind", "process")
     command = ref.config.get("command") or []
+    env = service_env(profile)
     if not command:
         raise SystemExit(f"{ref.name} has no command")
-    if not command_exists(str(command[0])):
+    if not command_exists(str(command[0]), env=env):
         raise SystemExit(f"{ref.name} command is not executable or not found: {command[0]}")
 
     if kind != "app-launcher":
@@ -298,11 +330,11 @@ def start_service(profile: str, ref: ServiceRef, manifest: dict[str, Any], start
     with path.open("ab") as log_file:
         log_file.write(f"\n--- start {time.strftime('%Y-%m-%d %H:%M:%S')} ---\n".encode("utf-8"))
         if kind == "app-launcher":
-            result = subprocess.run(command, cwd=ROOT, stdout=log_file, stderr=subprocess.STDOUT, check=False)
+            result = subprocess.run(command, cwd=ROOT, env=env, stdout=log_file, stderr=subprocess.STDOUT, check=False)
             write_state(profile, ref.name, {"last_launch_exit": result.returncode, "launched_at": time.time()})
             print(f"{ref.name}: launched (exit {result.returncode})")
         else:
-            process = subprocess.Popen(command, cwd=ROOT, stdout=log_file, stderr=subprocess.STDOUT, start_new_session=True)
+            process = subprocess.Popen(command, cwd=ROOT, env=env, stdout=log_file, stderr=subprocess.STDOUT, start_new_session=True)
             pid_file = pid_path(profile, ref.name)
             pid_file.parent.mkdir(parents=True, exist_ok=True)
             pid_file.write_text(str(process.pid) + "\n", encoding="utf-8")
@@ -385,6 +417,7 @@ def tail_log(profile: str, service: str, lines: int) -> None:
 
 def doctor_report(profile: str, manifest: dict[str, Any]) -> dict[str, Any]:
     errors = validate_manifest(manifest)
+    env = service_env(profile)
     service_reports = []
     for ref in service_items(manifest, include_disabled=True):
         command = ref.config.get("command") or []
@@ -392,15 +425,15 @@ def doctor_report(profile: str, manifest: dict[str, Any]) -> dict[str, Any]:
         doctor = ref.config.get("doctor") or {}
         checks = []
         for command_name in doctor.get("required_commands") or []:
-            checks.append({"type": "required_command", "name": command_name, "ok": command_exists(command_name)})
+            checks.append({"type": "required_command", "name": command_name, "ok": command_exists(command_name, env=env)})
         for command_name in doctor.get("optional_commands") or []:
-            checks.append({"type": "optional_command", "name": command_name, "ok": command_exists(command_name)})
+            checks.append({"type": "optional_command", "name": command_name, "ok": command_exists(command_name, env=env)})
         for raw_path in doctor.get("required_paths") or []:
             checks.append({"type": "required_path", "name": str(raw_path), "ok": resolve_workspace_path(str(raw_path)).exists()})
         for raw_path in doctor.get("optional_paths") or []:
             checks.append({"type": "optional_path", "name": str(raw_path), "ok": resolve_workspace_path(str(raw_path)).exists()})
         status = service_status(profile, ref)
-        status["command_ok"] = command_exists(first) if first else False
+        status["command_ok"] = command_exists(first, env=env) if first else False
         status["checks"] = checks
         service_reports.append(status)
     return {
@@ -443,8 +476,8 @@ def run_doctor(profile: str, manifest: dict[str, Any], json_output: bool = False
             print(f"    {label} {check['name']}: {'ok' if check['ok'] else 'missing'}")
 
 
-def shutil_which(command: str) -> str | None:
+def shutil_which(command: str, env: dict[str, str] | None = None) -> str | None:
-    paths = os.environ.get("PATH", "").split(os.pathsep)
+    paths = (env or os.environ).get("PATH", "").split(os.pathsep)
     for directory in paths:
         candidate = Path(directory) / command
         if candidate.exists() and os.access(candidate, os.X_OK):

scripts/aiw/test_indexer.py

@@ -23,14 +23,14 @@ class IndexerTests(unittest.TestCase):
     def test_build_skips_templates_and_searches_canonical_files(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
-            real = root / "project-knowledge" / "03-context" / "project.md"
+            real = root / "workspaces" / "fidelity" / "project-knowledge" / "03-context" / "project.md"
-            template = root / "project-knowledge" / "09-templates" / "daily.md"
+            template = root / "workspaces" / "fidelity" / "project-knowledge" / "09-templates" / "daily.md"
             real.parent.mkdir(parents=True)
             template.parent.mkdir(parents=True)
             real.write_text("# XFlow\nDismissal lifecycle context", encoding="utf-8")
             template.write_text("# XFlow\nTemplate-only text", encoding="utf-8")
 
-            with patch.object(indexer, "ROOT", root), patch.object(indexer, "INDEX_ROOT", root / ".aiw" / "indexes"):
+            with patch.object(indexer, "ROOT", root):
                 manifest = indexer.write_index("fidelity")
                 result = indexer.search_index("fidelity", "dismissal lifecycle", limit=5)
 
@@ -41,16 +41,36 @@ class IndexerTests(unittest.TestCase):
     def test_status_reports_unindexed_profile(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
-            with patch.object(indexer, "ROOT", root), patch.object(indexer, "INDEX_ROOT", root / ".aiw" / "indexes"):
+            with patch.object(indexer, "ROOT", root):
                 result = indexer.status("fidelity")
 
         self.assertFalse(result["indexed"])
         self.assertIn(".aiw/indexes/fidelity/project-knowledge.jsonl", result["index_path"])
 
     def test_cli_search_payload_is_json_serializable(self) -> None:
-        payload = {"matches": [{"path": "project-knowledge/01-current/current-work.md", "score": 1.0}]}
+        payload = {"matches": [{"path": "workspaces/fidelity/project-knowledge/01-current/current-work.md", "score": 1.0}]}
         self.assertIsInstance(json.dumps(payload), str)
 
+    def test_build_uses_workspace_json_paths(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp)
+            config = root / "profiles" / "demo" / "workspace.json"
+            real = root / "workspaces" / "demo" / "project-knowledge" / "03-context" / "project.md"
+            config.parent.mkdir(parents=True)
+            real.parent.mkdir(parents=True)
+            config.write_text(json.dumps({
+                "knowledge_dir": "workspaces/demo/project-knowledge",
+                "index_dir": ".aiw/indexes/demo",
+            }), encoding="utf-8")
+            real.write_text("# Demo\nReusable profile memory", encoding="utf-8")
+
+            with patch.object(indexer, "ROOT", root):
+                manifest = indexer.write_index("demo")
+                result = indexer.search_index("demo", "profile memory", limit=5)
+
+        self.assertEqual(manifest["source"], "workspaces/demo/project-knowledge")
+        self.assertEqual(result["matches"][0]["path"], "workspaces/demo/project-knowledge/03-context/project.md")
+
 
 if __name__ == "__main__":
     unittest.main()

scripts/aiw/test_profile.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+
+import importlib.util
+import json
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+
+PROFILE_PATH = Path(__file__).with_name("profile.py")
+SPEC = importlib.util.spec_from_file_location("aiw_profile", PROFILE_PATH)
+profile = importlib.util.module_from_spec(SPEC)
+assert SPEC.loader is not None
+sys.modules[SPEC.name] = profile
+SPEC.loader.exec_module(profile)
+
+
+class ProfileTests(unittest.TestCase):
+    def test_workspace_config_resolves_profile_paths(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp)
+            config = root / "profiles" / "demo" / "workspace.json"
+            config.parent.mkdir(parents=True)
+            config.write_text(json.dumps({
+                "knowledge_dir": "workspaces/demo/project-knowledge",
+                "inbox_dir": "workspaces/demo/inbox",
+                "index_dir": ".aiw/indexes/demo",
+            }), encoding="utf-8")
+
+            self.assertEqual(profile.knowledge_dir("demo", root=root), root / "workspaces" / "demo" / "project-knowledge")
+            self.assertEqual(profile.inbox_dir("demo", root=root), root / "workspaces" / "demo" / "inbox")
+            self.assertEqual(profile.index_dir("demo", root=root), root / ".aiw" / "indexes" / "demo")
+
+    def test_defaults_use_isolated_workspace_paths(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp)
+
+            self.assertEqual(profile.knowledge_dir("missing", root=root), root / "workspaces" / "missing" / "project-knowledge")
+            self.assertEqual(profile.inbox_dir("missing", root=root), root / "workspaces" / "missing" / "inbox")
+            self.assertEqual(profile.index_dir("missing", root=root), root / ".aiw" / "indexes" / "missing")
+
+    def test_relative_to_root_handles_external_paths(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp)
+            self.assertEqual(profile.relative_to_root(root / "a" / "b", root=root), "a/b")
+            self.assertEqual(profile.relative_to_root(Path("/external/path"), root=root), "/external/path")
+
+    def test_create_profile_writes_isolated_layout(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp)
+            result = profile.create_profile("demo-project", "Demo Project", root=root)
+
+            self.assertEqual(result["knowledge_dir"], "workspaces/demo-project/project-knowledge")
+            self.assertTrue((root / "profiles" / "demo-project" / "workspace.json").is_file())
+            self.assertTrue((root / "workspaces" / "demo-project" / "project-knowledge" / "00-start" / "start-here.md").is_file())
+            self.assertTrue((root / "workspaces" / "demo-project" / "inbox" / "README.md").is_file())
+
+    def test_doctor_reports_clean_layout(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp)
+            profile.create_profile("demo", root=root)
+            result = profile.doctor("demo", root=root)
+
+            self.assertTrue(result["ok"])
+            self.assertEqual(result["paths"]["knowledge_dir"], "workspaces/demo/project-knowledge")
+
+
+if __name__ == "__main__":
+    unittest.main()

scripts/iphone-photo-inbox/README.md

@@ -152,17 +152,18 @@ Keep this utility as an isolated image mailbox. If a project wants easy access,
 link the project inbox to the mailbox instead of making this utility know about
 the project.
 
-Example:
+Example using the active profile inbox:
 
 ```bash
-mkdir -p ai/inbox
+PROFILE_INBOX="$(python3 scripts/aiw/profile.py path inbox --profile fidelity)"
-ln -s "$HOME/Pictures/Photo Inbox" ai/inbox/photos
+mkdir -p "$PROFILE_INBOX"
+ln -s "$HOME/Pictures/Photo Inbox" "$PROFILE_INBOX/photos"
 ```
 
 Or point the receiver at a project-owned folder from `.env`:
 
 ```bash
-PHOTO_INBOX_DIR=/absolute/path/to/project/ai/inbox/photos
+PHOTO_INBOX_DIR=/absolute/path/to/profile/inbox/photos
 ```
 
 The symlink approach keeps this utility reusable across projects and devices.

scripts/mattermost-proxy/.env.example

@@ -7,7 +7,9 @@
 MATTERMOST_MIRROR_HOST_ALLOW=
 
 # Output directory for raw evidence and normalized AI-readable context.
-MATTERMOST_MIRROR_DIR=ai/inbox/mattermost-mirror
+# Optional. If omitted, run-mirror.sh writes to the active profile inbox:
+# <inbox_dir from profiles/<profile>/workspace.json>/mattermost-mirror
+# MATTERMOST_MIRROR_DIR=/absolute/path/to/mattermost-mirror
 
 # mitmproxy listener used by launch-mattermost.sh.
 MATTERMOST_MIRROR_LISTEN_HOST=127.0.0.1

scripts/mattermost-proxy/README.md

@@ -2,7 +2,7 @@
 
 Local read-only Mattermost Desktop mirror for AI workspace context.
 
-This is for **raw evidence only**. It writes under `ai/inbox/mattermost-mirror/`; durable project memory still belongs in `project-knowledge/` after normal promotion rules.
+This is for **raw evidence only**. By default it writes under the active profile inbox at `<inbox_dir>/mattermost-mirror/`; durable project memory still belongs in the profile's canonical project knowledge vault after normal promotion rules.
 
 ## Why this exists
 
@@ -48,7 +48,7 @@ missing.
 ## Output layout
 
 ```text
-ai/inbox/mattermost-mirror/
+<profile inbox>/mattermost-mirror/
   latest.jsonl              # bounded AI-readable window
   latest.md                 # bounded Markdown view
   state.json                # last seen by channel and user cache
@@ -138,7 +138,7 @@ Each line in the normalized JSONL contains:
 ## Useful environment variables
 
 - `MATTERMOST_MIRROR_HOST_ALLOW`: exact host or parent domain to capture.
-- `MATTERMOST_MIRROR_DIR`: output directory, default `ai/inbox/mattermost-mirror`.
+- `MATTERMOST_MIRROR_DIR`: optional output directory. If omitted, `run-mirror.sh` uses `<inbox_dir from profiles/<profile>/workspace.json>/mattermost-mirror`.
 - `MATTERMOST_MIRROR_LATEST_LIMIT`: number of messages in `latest.*`, default `200`.
 - `MATTERMOST_MIRROR_CHANNEL_IDS`: optional comma-separated channel ID allowlist.
 - `MATTERMOST_MIRROR_WRITE_RAW`: set to `1` to save compact raw REST/WebSocket evidence.
@@ -170,7 +170,7 @@ do not create message files. Open a channel, open a thread, scroll slightly in
 history, or wait for/send a new message. Then check:
 
 ```text
-ai/inbox/mattermost-mirror/latest.md
+<profile inbox>/mattermost-mirror/latest.md
-ai/inbox/mattermost-mirror/channels/<channel-name>/YYYY/MM/YYYY-MM-DD.jsonl
+<profile inbox>/mattermost-mirror/channels/<channel-name>/YYYY/MM/YYYY-MM-DD.jsonl
-ai/inbox/mattermost-mirror/by-date/YYYY/MM/YYYY-MM-DD.jsonl
+<profile inbox>/mattermost-mirror/by-date/YYYY/MM/YYYY-MM-DD.jsonl
 ```

scripts/mattermost-proxy/mattermost_mirror.py

@@ -6,7 +6,7 @@ This addon is intentionally narrow:
 - redact secrets
 - normalize posts into date-rotated JSONL files for AI context
 
-The output under ai/inbox/ is raw evidence, not canonical project memory.
+The output under the profile inbox is raw evidence, not canonical project memory.
 """
 
 from __future__ import annotations
@@ -23,7 +23,7 @@ from urllib.parse import urlparse
 from mitmproxy import http
 
 
-DEFAULT_OUT_DIR = "ai/inbox/mattermost-mirror"
+DEFAULT_OUT_DIR = "mattermost-mirror"
 POST_ID_RE = re.compile(r"^[a-z0-9]{26}$")
 SAFE_NAME_RE = re.compile(r"[^a-zA-Z0-9._-]+")
 

scripts/mattermost-proxy/read-context.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """Read local Mattermost mirror evidence for agent prompts.
 
-The proxy mirror under ai/inbox/mattermost-mirror is the preferred Mattermost
+The proxy mirror under the active profile inbox is the preferred Mattermost
 evidence source when present. This reader gives commands a stable way to load a
 small focused view and fall back to the older sync artifacts when the mirror is
 not available.
@@ -13,17 +13,29 @@ import argparse
 import json
 import os
 import shlex
+import sys
 from datetime import date, datetime, timedelta
 from pathlib import Path
 
 
 ROOT = Path(__file__).resolve().parents[2]
-MIRROR_DIR = ROOT / "ai" / "inbox" / "mattermost-mirror"
+sys.path.insert(0, str(ROOT / "scripts" / "aiw"))
-LEGACY_LATEST = ROOT / "ai" / "inbox" / "mattermost-latest.md"
+import profile as aiw_profile  # noqa: E402
+
+DEFAULT_PROFILE = os.getenv("AIW_PROJECT_PROFILE", "fidelity")
+MIRROR_DIR = aiw_profile.inbox_dir(DEFAULT_PROFILE, root=ROOT) / "mattermost-mirror"
+LEGACY_LATEST = aiw_profile.inbox_dir(DEFAULT_PROFILE, root=ROOT) / "mattermost-latest.md"
 LEGACY_GENERATED = ROOT / "scripts" / "mattermost" / "generated" / "mattermost_context.jsonl"
 LOCAL_ENV = Path(__file__).resolve().parent / ".env"
 
 
+def configure_profile_paths(profile: str) -> None:
+    global MIRROR_DIR, LEGACY_LATEST
+    inbox = aiw_profile.inbox_dir(profile, root=ROOT)
+    MIRROR_DIR = inbox / "mattermost-mirror"
+    LEGACY_LATEST = inbox / "mattermost-latest.md"
+
+
 def load_local_env(path: Path = LOCAL_ENV) -> None:
     """Load simple KEY=VALUE pairs from the connector-local .env.
 
@@ -137,7 +149,7 @@ def mode_latest() -> None:
     records = read_jsonl(MIRROR_DIR / "latest.jsonl")
     if print_jsonl(records):
         return
-    print("No proxy mirror latest context available; falling back to legacy sync artifacts.")
+    print("No proxy mirror latest context available; checking configured sync artifacts.")
     fallback()
 
 
@@ -201,6 +213,7 @@ def main() -> None:
     load_local_env()
 
     parser = argparse.ArgumentParser()
+    parser.add_argument("--profile", default=DEFAULT_PROFILE)
     parser.add_argument("--mode", choices=["latest", "previous-workday", "standup", "focused"], default="latest")
     parser.add_argument("--today", default="")
     parser.add_argument(
@@ -210,6 +223,7 @@ def main() -> None:
     )
     parser.add_argument("--limit", type=int, default=80, help="Max records per section; use 0 for no limit.")
     args = parser.parse_args()
+    configure_profile_paths(args.profile)
     channels = parse_channels(args.channels or None)
     limit = args.limit if args.limit > 0 else None
 

scripts/mattermost-proxy/run-mirror.sh

@@ -11,7 +11,9 @@ if [ -f "$SCRIPT_DIR/.env" ]; then
   set +a
 fi
 
-export MATTERMOST_MIRROR_DIR="${MATTERMOST_MIRROR_DIR:-$WORKSPACE_ROOT/ai/inbox/mattermost-mirror}"
+PROFILE="${AIW_PROJECT_PROFILE:-fidelity}"
+PROFILE_INBOX_DIR="$(python3 "$WORKSPACE_ROOT/scripts/aiw/profile.py" path inbox --profile "$PROFILE")"
+export MATTERMOST_MIRROR_DIR="${MATTERMOST_MIRROR_DIR:-$PROFILE_INBOX_DIR/mattermost-mirror}"
 export MATTERMOST_MIRROR_LISTEN_HOST="${MATTERMOST_MIRROR_LISTEN_HOST:-127.0.0.1}"
 export MATTERMOST_MIRROR_LISTEN_PORT="${MATTERMOST_MIRROR_LISTEN_PORT:-8080}"
 

scripts/mattermost/.env.example

@@ -11,9 +11,9 @@ AIW_CHANNEL_PREFIX=fidelity
 # MATTERMOST_TEAM_NAME=fidelity
 # MATTERMOST_TEAM_ID=team_id_here
 # Legacy Fidelity-specific options still supported by workspace plugins:
-# FIDELITY_MATTERMOST_SYNC_CMD=bash scripts/mattermost/sync.sh
+# AIW_MATTERMOST_SYNC_CMD=bash scripts/mattermost/sync.sh
-# FIDELITY_MATTERMOST_SYNC_INTERVAL_MINUTES=15
+# AIW_MATTERMOST_SYNC_INTERVAL_MINUTES=15
-# FIDELITY_MANAGER_NAME=jeff
+# AIW_MANAGER_NAME=jeff
 # Legacy options still supported:
 # CHANNEL_NAMES=fidelity-preguntas,otro-canal
 # CHANNEL_IDS=canal_id_1,canal_id_2

scripts/mattermost/README.md

@@ -2,10 +2,7 @@
 
 This directory contains the workspace-local Mattermost extractor used by OpenCode to refresh communication context.
 
-The preferred live Mattermost evidence source is now the proxy mirror under
+The preferred live Mattermost evidence source is the proxy mirror under the active profile inbox, `<profile inbox>/mattermost-mirror/`. This extractor is an explicit API refresh path for commands that need a fresh pull from the Mattermost API.
-`ai/inbox/mattermost-mirror/` when it is running. This legacy extractor remains
-the fallback and explicit refresh path for commands that need a fresh pull from
-the Mattermost API.
 
 ## Files
 
@@ -63,7 +60,7 @@ Manual run:
 bash scripts/mattermost/sync.sh
 ```
 
-OpenCode can use this script directly. If `AIW_MATTERMOST_SYNC_CMD` is not set, the workspace plugins will fall back to `FIDELITY_MATTERMOST_SYNC_CMD`, then to this wrapper automatically.
+OpenCode can use this script directly. If `AIW_MATTERMOST_SYNC_CMD` is not set, the workspace plugin uses this wrapper automatically.
 
 Generic workspace variables are preferred for reusable projects:
 
@@ -72,7 +69,7 @@ Generic workspace variables are preferred for reusable projects:
 - `AIW_MATTERMOST_SYNC_CMD`
 - `AIW_MATTERMOST_SYNC_INTERVAL_MINUTES`
 
-The older `FIDELITY_*` variables remain supported for this project profile.
+Reusable workflows should prefer the generic `AIW_*` variables.
 
 Previous workday mode for standups:
 

scripts/mcp/aiw-context-mcp/README.md

@@ -45,7 +45,7 @@ python3 scripts/mcp/aiw-context-mcp/server.py --transport stdio
 - `memory_hybrid_search`
 - `photos_latest`
 
-All tools are read-only. Mattermost tools read `ai/inbox/mattermost-mirror/`; photo tools list local Photo Inbox files without embedding image data; project tools read canonical Markdown under `project-knowledge/`.
+All tools are read-only. Mattermost tools read the active profile's `mattermost-mirror/` inbox; photo tools list local Photo Inbox files without embedding image data; project tools read canonical Markdown from the profile's configured `knowledge_dir`.
 
 `memory_hybrid_search` reads the derived local index built by:
 
@@ -53,7 +53,7 @@ All tools are read-only. Mattermost tools read `ai/inbox/mattermost-mirror/`; ph
 python3 scripts/aiw/indexer.py build --profile fidelity
 ```
 
-If the index is missing, it falls back to bounded live Markdown search over `project-knowledge/`. The index is not canonical memory; `project-knowledge/` remains the source of truth.
+If the index is missing, it falls back to bounded live Markdown search over the profile's configured knowledge directory. The index is not canonical memory; Markdown remains the source of truth.
 
 Mattermost latest/date/standup tools filter to the active profile's context channels by default. For Fidelity, that list lives in `profiles/fidelity/context-sources.json`. Pass explicit `channels` to override the profile list, or `include_all_channels: true` when broad unfiltered mirror evidence is intentionally needed.
 

scripts/mcp/aiw-context-mcp/server.py

@@ -27,7 +27,9 @@ PROTOCOL_VERSION = "2025-06-18"
 SERVER_NAME = "aiw-context-mcp"
 SERVER_VERSION = "0.1.0"
 LOCAL_ENV = ROOT / "scripts" / "mattermost-proxy" / ".env"
-INDEX_ROOT = ROOT / ".aiw" / "indexes"
+AIW_SCRIPT_DIR = ROOT / "scripts" / "aiw"
+sys.path.insert(0, str(AIW_SCRIPT_DIR))
+import profile as aiw_profile  # noqa: E402
 
 
 def load_local_env(path: Path = LOCAL_ENV) -> None:
@@ -47,22 +49,20 @@ def load_local_env(path: Path = LOCAL_ENV) -> None:
 
 
 def profile_dir(profile: str) -> Path:
-    if profile == "fidelity":
-        return ROOT
     candidate = ROOT / "profiles" / profile
     return candidate if candidate.exists() else ROOT
 
 
 def knowledge_dir(profile: str) -> Path:
-    base = profile_dir(profile)
+    return aiw_profile.knowledge_dir(profile, root=ROOT)
-    candidate = base / "project-knowledge"
-    return candidate if candidate.exists() else ROOT / "project-knowledge"
 
 
 def inbox_dir(profile: str) -> Path:
-    base = profile_dir(profile)
+    return aiw_profile.inbox_dir(profile, root=ROOT)
-    candidate = base / "ai" / "inbox"
+
-    return candidate if candidate.exists() else ROOT / "ai" / "inbox"
+
+def rel(path: Path) -> str:
+    return aiw_profile.relative_to_root(path, root=ROOT)
 
 
 def mattermost_mirror_dir(profile: str) -> Path:
@@ -257,7 +257,7 @@ def project_current_context(args: dict[str, Any]) -> dict[str, Any]:
     result = []
     for path in files:
         if path.is_file():
-            result.append({"path": str(path.relative_to(ROOT)), "text": path.read_text(encoding="utf-8", errors="replace")})
+            result.append({"path": rel(path), "text": path.read_text(encoding="utf-8", errors="replace")})
     return tool_result({"profile": profile, "canonical": True, "files": result})
 
 
@@ -270,8 +270,8 @@ def project_search_memory(args: dict[str, Any]) -> dict[str, Any]:
     base = knowledge_dir(profile)
     matches: list[dict[str, Any]] = []
     for path in sorted(base.rglob("*.md")):
-        rel = path.relative_to(base)
+        relative_to_base = path.relative_to(base)
-        if str(rel).startswith("09-templates/"):
+        if str(relative_to_base).startswith("09-templates/"):
             continue
         text = path.read_text(encoding="utf-8", errors="replace")
         lowered = text.lower()
@@ -280,18 +280,18 @@ def project_search_memory(args: dict[str, Any]) -> dict[str, Any]:
             continue
         start = max(0, index - 220)
         end = min(len(text), index + len(query) + 220)
-        matches.append({"path": str(path.relative_to(ROOT)), "snippet": text[start:end].strip()})
+        matches.append({"path": rel(path), "snippet": text[start:end].strip()})
         if len(matches) >= limit:
             break
     return tool_result({"profile": profile, "canonical": True, "query": query, "matches": matches})
 
 
 def index_path(profile: str) -> Path:
-    return INDEX_ROOT / profile / "project-knowledge.jsonl"
+    return aiw_profile.index_dir(profile, root=ROOT) / "project-knowledge.jsonl"
 
 
 def index_manifest_path(profile: str) -> Path:
-    return INDEX_ROOT / profile / "manifest.json"
+    return aiw_profile.index_dir(profile, root=ROOT) / "manifest.json"
 
 
 def search_tokens(text: str) -> set[str]:

scripts/mcp/aiw-context-mcp/test_server.py

@@ -56,7 +56,7 @@ class ContextMCPTests(unittest.TestCase):
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
             profile = root / "profiles" / "fidelity" / "profile.md"
-            current = root / "project-knowledge" / "01-current" / "current-work.md"
+            current = root / "workspaces" / "fidelity" / "project-knowledge" / "01-current" / "current-work.md"
             profile.parent.mkdir(parents=True)
             current.parent.mkdir(parents=True)
             profile.write_text("# Fidelity", encoding="utf-8")
@@ -79,7 +79,7 @@ class ContextMCPTests(unittest.TestCase):
     def test_communication_latest_reads_bounded_records(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
-            latest = root / "ai" / "inbox" / "mattermost-mirror" / "latest.jsonl"
+            latest = root / "workspaces" / "fidelity" / "inbox" / "mattermost-mirror" / "latest.jsonl"
             latest.parent.mkdir(parents=True)
             for index in range(3):
                 latest.write_text("", encoding="utf-8") if index == 0 else None
@@ -96,7 +96,7 @@ class ContextMCPTests(unittest.TestCase):
     def test_communication_latest_filters_to_profile_channels_by_default(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
-            latest = root / "ai" / "inbox" / "mattermost-mirror" / "latest.jsonl"
+            latest = root / "workspaces" / "fidelity" / "inbox" / "mattermost-mirror" / "latest.jsonl"
             profile_config = root / "profiles" / "fidelity" / "context-sources.json"
             latest.parent.mkdir(parents=True)
             profile_config.parent.mkdir(parents=True)
@@ -122,7 +122,7 @@ class ContextMCPTests(unittest.TestCase):
     def test_communication_latest_can_include_all_channels(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
-            latest = root / "ai" / "inbox" / "mattermost-mirror" / "latest.jsonl"
+            latest = root / "workspaces" / "fidelity" / "inbox" / "mattermost-mirror" / "latest.jsonl"
             profile_config = root / "profiles" / "fidelity" / "context-sources.json"
             latest.parent.mkdir(parents=True)
             profile_config.parent.mkdir(parents=True)
@@ -146,8 +146,8 @@ class ContextMCPTests(unittest.TestCase):
     def test_project_search_skips_templates(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
-            real = root / "project-knowledge" / "03-context" / "project.md"
+            real = root / "workspaces" / "fidelity" / "project-knowledge" / "03-context" / "project.md"
-            template = root / "project-knowledge" / "09-templates" / "daily.md"
+            template = root / "workspaces" / "fidelity" / "project-knowledge" / "09-templates" / "daily.md"
             real.parent.mkdir(parents=True)
             template.parent.mkdir(parents=True)
             real.write_text("Important XFlow context", encoding="utf-8")
@@ -167,7 +167,7 @@ class ContextMCPTests(unittest.TestCase):
             index.parent.mkdir(parents=True)
             index.write_text(json.dumps({
                 "chunk_id": "abc",
-                "path": "project-knowledge/03-context/project.md",
+                "path": "workspaces/fidelity/project-knowledge/03-context/project.md",
                 "heading": "XFlow",
                 "text": "Dismissal lifecycle sequencing for XFlow",
                 "mtime": 1.0,
@@ -175,7 +175,7 @@ class ContextMCPTests(unittest.TestCase):
             }) + "\n", encoding="utf-8")
             manifest.write_text(json.dumps({"chunk_count": 1}), encoding="utf-8")
 
-            with patch.object(server, "ROOT", root), patch.object(server, "INDEX_ROOT", root / ".aiw" / "indexes"):
+            with patch.object(server, "ROOT", root):
                 result = server.memory_hybrid_search({"profile": "fidelity", "query": "dismissal lifecycle"})["structuredContent"]
 
         self.assertTrue(result["index_available"])
@@ -185,17 +185,35 @@ class ContextMCPTests(unittest.TestCase):
     def test_memory_hybrid_search_falls_back_without_index(self) -> None:
         with tempfile.TemporaryDirectory() as tmp:
             root = Path(tmp)
-            real = root / "project-knowledge" / "03-context" / "project.md"
+            real = root / "workspaces" / "fidelity" / "project-knowledge" / "03-context" / "project.md"
             real.parent.mkdir(parents=True)
             real.write_text("Important XFlow context", encoding="utf-8")
 
-            with patch.object(server, "ROOT", root), patch.object(server, "INDEX_ROOT", root / ".aiw" / "indexes"):
+            with patch.object(server, "ROOT", root):
                 result = server.memory_hybrid_search({"profile": "fidelity", "query": "XFlow"})["structuredContent"]
 
         self.assertFalse(result["index_available"])
         self.assertEqual(result["source"], "live-project-knowledge-fallback")
         self.assertEqual(len(result["matches"]), 1)
 
+    def test_project_context_uses_workspace_json_paths(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp)
+            config = root / "profiles" / "demo" / "workspace.json"
+            current = root / "workspaces" / "demo" / "project-knowledge" / "01-current" / "current-work.md"
+            work_items = root / "workspaces" / "demo" / "project-knowledge" / "01-current" / "work-items.md"
+            config.parent.mkdir(parents=True)
+            current.parent.mkdir(parents=True)
+            config.write_text(json.dumps({"knowledge_dir": "workspaces/demo/project-knowledge"}), encoding="utf-8")
+            current.write_text("# Current\nDemo current work", encoding="utf-8")
+            work_items.write_text("# Work Items", encoding="utf-8")
+
+            with patch.object(server, "ROOT", root):
+                result = server.project_current_context({"profile": "demo"})["structuredContent"]
+
+        self.assertEqual(result["files"][0]["path"], "workspaces/demo/project-knowledge/01-current/current-work.md")
+        self.assertIn("Demo current work", result["files"][0]["text"])
+
     def test_previous_workday_skips_weekend(self) -> None:
         monday = date(2026, 5, 18)
 

scripts/memory/README.md

@@ -2,12 +2,13 @@
 
 This directory exposes a project-agnostic interface for canonical project knowledge.
 
-The current implementation uses Markdown files under `project-knowledge/` and can optionally delegate to the Obsidian CLI when it is available. The agent should depend on this memory interface, not on Obsidian-specific behavior, so the backing tool can be replaced later.
+The current implementation resolves the canonical Markdown directory from `profiles/<profile>/workspace.json` and can optionally delegate to the Obsidian CLI when it is available. The agent should depend on this memory interface, not on Obsidian-specific behavior, so the backing tool can be replaced later.
 
 ## Backend Model
 
-- `AIW_PROJECT_KNOWLEDGE_DIR` points to the canonical Markdown project knowledge directory.
+- `AIW_PROJECT_PROFILE` selects the profile, defaulting to `fidelity` in this repository.
-- `AIW_MEMORY_VAULT_DIR` and `AIW_OBSIDIAN_VAULT_DIR` are transition aliases.
+- `profiles/<profile>/workspace.json` defines the canonical Markdown project knowledge directory.
+- `AIW_PROJECT_KNOWLEDGE_DIR` can override the resolved directory for local experiments.
 - `AIW_MEMORY_BACKEND` defaults to `auto`.
 - `auto` uses Obsidian CLI when it is useful and available, then falls back to direct Markdown operations.
 - `files` forces direct Markdown operations.

scripts/memory/memory.sh

@@ -4,7 +4,8 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 WORKSPACE_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-PROJECT_KNOWLEDGE_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-${AIW_MEMORY_VAULT_DIR:-${AIW_OBSIDIAN_VAULT_DIR:-$WORKSPACE_ROOT/project-knowledge}}}"
+PROFILE="${AIW_PROJECT_PROFILE:-fidelity}"
+PROJECT_KNOWLEDGE_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-$(python3 "$WORKSPACE_ROOT/scripts/aiw/profile.py" path knowledge --profile "$PROFILE")}"
 VAULT_DIR="$PROJECT_KNOWLEDGE_DIR"
 BACKEND="${AIW_MEMORY_BACKEND:-auto}"
 OBSIDIAN_CLI="$WORKSPACE_ROOT/scripts/obsidian/cli.sh"

scripts/obsidian/cli.sh

@@ -4,7 +4,8 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 WORKSPACE_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-VAULT_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-${AIW_MEMORY_VAULT_DIR:-${AIW_OBSIDIAN_VAULT_DIR:-$WORKSPACE_ROOT/project-knowledge}}}"
+PROFILE="${AIW_PROJECT_PROFILE:-fidelity}"
+VAULT_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-$(python3 "$WORKSPACE_ROOT/scripts/aiw/profile.py" path knowledge --profile "$PROFILE")}"
 
 if ! command -v obsidian >/dev/null 2>&1; then
   echo "obsidian CLI is not installed or not in PATH" >&2

scripts/obsidian/daily.sh

@@ -4,7 +4,8 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 WORKSPACE_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-VAULT_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-${AIW_MEMORY_VAULT_DIR:-${AIW_OBSIDIAN_VAULT_DIR:-$WORKSPACE_ROOT/project-knowledge}}}"
+PROFILE="${AIW_PROJECT_PROFILE:-fidelity}"
+VAULT_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-$(python3 "$WORKSPACE_ROOT/scripts/aiw/profile.py" path knowledge --profile "$PROFILE")}"
 VAULT_NAME="${AIW_OBSIDIAN_VAULT_NAME:-$(basename "$VAULT_DIR")}"
 
 URI="$("$SCRIPT_DIR/uri.sh" daily "vault=$VAULT_NAME")"

scripts/obsidian/open.sh

@@ -4,7 +4,8 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 WORKSPACE_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-VAULT_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-${AIW_MEMORY_VAULT_DIR:-${AIW_OBSIDIAN_VAULT_DIR:-$WORKSPACE_ROOT/project-knowledge}}}"
+PROFILE="${AIW_PROJECT_PROFILE:-fidelity}"
+VAULT_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-$(python3 "$WORKSPACE_ROOT/scripts/aiw/profile.py" path knowledge --profile "$PROFILE")}"
 VAULT_NAME="${AIW_OBSIDIAN_VAULT_NAME:-$(basename "$VAULT_DIR")}"
 
 if [[ $# -lt 1 ]]; then

scripts/obsidian/search.sh

@@ -4,7 +4,8 @@ set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 WORKSPACE_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-VAULT_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-${AIW_MEMORY_VAULT_DIR:-${AIW_OBSIDIAN_VAULT_DIR:-$WORKSPACE_ROOT/project-knowledge}}}"
+PROFILE="${AIW_PROJECT_PROFILE:-fidelity}"
+VAULT_DIR="${AIW_PROJECT_KNOWLEDGE_DIR:-$(python3 "$WORKSPACE_ROOT/scripts/aiw/profile.py" path knowledge --profile "$PROFILE")}"
 VAULT_NAME="${AIW_OBSIDIAN_VAULT_NAME:-$(basename "$VAULT_DIR")}"
 
 if [[ $# -lt 1 ]]; then

workflows/opencode-entry.md

@@ -34,7 +34,7 @@ Use OpenCode as the daily AI entry point for this workspace without losing proje
 - Shared workflow/rule content can stay centralized in `.agents/` while OpenCode keeps using `.opencode/`.
 - The main context command reads the reusable `core/`, active profile, stable workspace files, and today's log.
 - Stable context is split by systems, workstreams, process, people, and decisions so the agent can pull the right layer instead of overloading one project file.
-- Live communication context can be refreshed into `ai/inbox/` using the configured connector.
+- Live communication context can be refreshed into the active profile inbox using the configured connector.
 - Direct prompts are also treated as memory opportunities, so the agent can update workspace context during normal conversation.
 - Daily updates go back into the workspace, so later prompts inherit better context.
 - The local compaction plugin helps preserve the most important workspace context during long sessions.