feat: Add comprehensive documentation for internal Fidelity apps and tools, enhancing navigation and context within the workspace

This commit is contained in:
2026-04-17 14:59:27 -06:00
parent cfa047b6be
commit 11fdb17fcb
23 changed files with 799 additions and 5 deletions

7
vault/.obsidian/types.json vendored Normal file
View File

@@ -0,0 +1,7 @@
{
"types": {
"aliases": "multitext",
"cssclasses": "multitext",
"tags": "tags"
}
}

View File

@@ -28,6 +28,8 @@ Stable context about core product components and how they relate:
- [systems/xflowsdk.md](./systems/xflowsdk.md) - [systems/xflowsdk.md](./systems/xflowsdk.md)
- [systems/xflowviewmaker.md](./systems/xflowviewmaker.md) - [systems/xflowviewmaker.md](./systems/xflowviewmaker.md)
- [systems/ftframeworks.md](./systems/ftframeworks.md) - [systems/ftframeworks.md](./systems/ftframeworks.md)
- [systems/index.md](./systems/index.md)
- [../07-maps/fidelity-apps.md](../07-maps/fidelity-apps.md) for internal Fidelity app/tool navigation
### `ios/` ### `ios/`

View File

@@ -0,0 +1,40 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- ALMx Toolbox
- ALMx - Toolbox
---
# ALMx Toolbox
## Role
- Internal tool from the Fidelity app/bookmark set, likely tied to ALM/process workflows.
---
## Stable Patterns
- Base note only; add confirmed responsibilities and common tasks gradually.
---
## Risks
- The name suggests process tooling, but exact ownership and usage are still unknown.
---
## Related Context
- `trackit.md`

View File

@@ -0,0 +1,54 @@
---
type: system
project: fidelity
status: active
systems:
- xflowsdk
- xflowviewmaker
- fid4
workstreams:
- consumer-integration
people: []
related:
- consumer-integration
- xflowsdk
- xflowviewmaker
- fid4
- iosinstaller
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- artifactory.fmr.com
---
# Artifactory
## Role
- Internal artifact distribution system used in the Fidelity release path.
- Known to be part of XFlowSDK/XFlowViewMaker publication and consumer-build inspection workflows.
---
## Stable Patterns
- Stores or exposes build artifacts that help verify what was published or shipped.
- This is a base note; add repository names, navigation tips, and common artifact paths gradually.
---
## Risks
- Artifact presence alone does not prove downstream consumer adoption.
---
## Related Context
- `xflowsdk.md`
- `xflowviewmaker.md`
- `fid4.md`
- `iosinstaller.md`
- `../workstreams/consumer-integration.md`

View File

@@ -2,14 +2,22 @@
type: system type: system
project: fidelity project: fidelity
status: active status: active
workstreams: [ao-discourse, xflow-debugging] workstreams:
related: [xflowsdk, fid4, pdiap-15765] - ao-discourse
- xflow-debugging
related:
- xflowsdk
- fid4
- pdiap-15765
updated: 2026-04-16 updated: 2026-04-16
tags: tags:
- system - system
- fidelity - fidelity
aliases:
- CogStore
- XFlow Home CCP CogStore
--- ---
# Cogstore # CogStore
## Role ## Role

View File

@@ -0,0 +1,38 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
---
# Confluence
## Role
- Internal documentation/wiki surface used across Fidelity workflows.
---
## Stable Patterns
- Likely useful for process docs, onboarding docs, and cross-team references.
- Base note only; add important spaces/pages gradually.
---
## Risks
- Documentation can drift from current implementation reality.
---
## Related Context
- `../workstreams/consumer-integration.md`

View File

@@ -0,0 +1,39 @@
---
type: system
project: fidelity
status: active
systems: [fid4, xflowsdk]
workstreams: [ao-discourse]
people: []
related: [ao-discourse, fid4, xflowsdk]
tags:
- system
- fidelity
updated: 2026-04-17
---
# Discourse
## Role
- External issue/reporting surface that appears in Fidelity debugging and communication workflows.
---
## Stable Patterns
- Often paired with Jira comments and follow-up communication when clarifying issue scope.
- Base note only; add exact ownership boundaries and triage patterns gradually.
---
## Risks
- External reports can be incomplete, non-reproducible, or not true regressions.
---
## Related Context
- `../workstreams/ao-discourse.md`
- `fid4.md`

View File

@@ -0,0 +1,38 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
---
# Fidelity Central
## Role
- Internal Fidelity portal or central navigation surface.
---
## Stable Patterns
- Likely acts as an entry point to other internal systems or reference material.
- Base note only; add high-value navigation paths gradually.
---
## Risks
- Portal names can hide multiple unrelated functions behind one entry point.
---
## Related Context
- `myaccess.md`

View File

@@ -23,14 +23,67 @@ tags:
- [ftframeworks.md](./ftframeworks.md) - [ftframeworks.md](./ftframeworks.md)
Consumer-side feature modules that often mediate whether XFlow changes can be validated in Fid4. Consumer-side feature modules that often mediate whether XFlow changes can be validated in Fid4.
- [cogstore.md](./cogstore.md) - [CogStore](./cogstore.md)
Flow-configuration publishing and version-comparison platform used to verify what is live in QA/Production. Flow-configuration publishing and version-comparison platform used to verify what is live in QA/Production.
--- ---
## Internal Apps And Tools
- [iosinstaller.md](./iosinstaller.md)
Internal build-inspection app that can expose App Store/internal builds and their `Podfile.lock`.
- [artifactory.md](./artifactory.md)
Artifact distribution surface used in release and build-validation workflows.
- [splunk.md](./splunk.md)
Internal logging/observability tool for debugging distributed behavior.
- [discourse.md](./discourse.md)
External issue/reporting surface that often feeds Fidelity triage and communication.
- [confluence.md](./confluence.md)
Internal documentation/wiki surface.
- [miro.md](./miro.md)
Shared whiteboarding/collaboration tool.
- [myaccess.md](./myaccess.md)
Internal access/authentication-related tool.
- [trackit.md](./trackit.md)
Internal tracking tool from the Fidelity toolset.
- [fidelity-central.md](./fidelity-central.md)
Internal portal/entry-point app.
- [wukong.md](./wukong.md)
Internal test-data-related tool.
- [xq1-portfolio-summary.md](./xq1-portfolio-summary.md)
Internal XQ1 environment summary page/tool.
- [vault.md](./vault.md)
Internal Fidelity tool named Vault.
- [vault-preprod.md](./vault-preprod.md)
Pre-production variant of the internal Vault tool.
- [slate.md](./slate.md)
Internal tool from the current Fidelity bookmark/tool set.
- [almx-toolbox.md](./almx-toolbox.md)
Internal ALM/process-related tool.
- [nexus-fidelity.md](./nexus-fidelity.md)
Internal Fidelity tool identified from the current bookmark/tool set.
---
## Guidance ## Guidance
- Start with `xflowsdk.md` for backend-driven behavior questions. - Start with `xflowsdk.md` for backend-driven behavior questions.
- Start with `fid4.md` or `ftframeworks.md` for consumer validation and release flow questions. - Start with `fid4.md` or `ftframeworks.md` for consumer validation and release flow questions.
- Open `xflowviewmaker.md` when the question involves version bumps, transitional architecture, or pipeline friction. - Open `xflowviewmaker.md` when the question involves version bumps, transitional architecture, or pipeline friction.
- Open `cogstore.md` when the question involves published flow-definition versions, config diffs, or whether a service/config change is live in QA vs Production. - Open `cogstore.md` when the question involves published flow-definition versions, config diffs, or whether a service/config change is live in QA vs Production.
- Open `iosinstaller.md`, `artifactory.md`, or the [Fidelity Apps Map](../../07-maps/fidelity-apps.md) when the question is about internal tools, build inspection, or where to look next.

View File

@@ -0,0 +1,50 @@
---
type: system
project: fidelity
status: active
systems:
- fid4
- artifactory
workstreams:
- consumer-integration
people: []
related:
- consumer-integration
- fid4
- artifactory
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- Artifactory IOS Build Installer
---
# iOSInstaller
## Role
- Internal Fidelity app used to inspect distributed mobile builds.
- Current known use: download App Store/internal builds and inspect the build's `Podfile.lock`.
---
## Stable Patterns
- Useful when the repo does not keep `Podfile.lock` in Git but you still need to inspect what dependencies a shipped build used.
- Can support version-validation and reproduction work for Fid4 / flagship investigations.
- This is a base note; capture exact access patterns, URLs, and screenshots gradually as they become important.
---
## Risks
- Build snapshots alone may still be insufficient for exact reproduction if the private podspec repo changed after the build was produced.
---
## Related Context
- `fid4.md`
- `artifactory.md`
- `../workstreams/consumer-integration.md`

View File

@@ -0,0 +1,38 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
---
# Miro
## Role
- Shared whiteboarding/collaboration tool.
---
## Stable Patterns
- Useful for diagrams, architecture sketches, or discussion artifacts when they matter to project context.
- Base note only; add recurring boards or workflows gradually.
---
## Risks
- Whiteboards can become stale quickly if not linked back to canonical notes.
---
## Related Context
- `confluence.md`

View File

@@ -0,0 +1,40 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- My Access
---
# MyAccess
## Role
- Internal access/authentication-related tool.
---
## Stable Patterns
- Likely relevant when environment access or role-based permissions affect day-to-day work.
- Base note only; add common use cases gradually.
---
## Risks
- Access assumptions can become stale as roles/projects change.
---
## Related Context
- `../process/communication.md`

View File

@@ -0,0 +1,40 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- "Nexus : Fidelity"
- Nexus
---
# Nexus Fidelity
## Role
- Internal Fidelity app/tool identified from the current bookmark set.
---
## Stable Patterns
- Base note only; add confirmed purpose and relation to release/build flows gradually.
---
## Risks
- Do not assume this is the same as other artifact or repository tools without confirmation.
---
## Related Context
- `artifactory.md`

View File

@@ -0,0 +1,39 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- "Slate : Cognitive Mini App Designer"
---
# Slate
## Role
- Internal tool currently identified from the Fidelity app/bookmark set.
---
## Stable Patterns
- Base note only; add confirmed purpose, ownership, and recurring workflows gradually.
---
## Risks
- Do not infer too much from name alone.
---
## Related Context
- `miro.md`

View File

@@ -0,0 +1,39 @@
---
type: system
project: fidelity
status: active
systems: [fid4, xflowsdk]
workstreams: [xflow-debugging]
people: []
related: [xflow-debugging, fid4, xflowsdk]
tags:
- system
- fidelity
updated: 2026-04-17
---
# Splunk
## Role
- Internal observability/logging tool used for debugging production-like or distributed behavior.
---
## Stable Patterns
- Likely useful for validation and issue triage when app behavior differs from local expectations.
- Base note only; add saved searches, index names, and practical debugging patterns later.
---
## Risks
- Logs can be misleading without auth-state, environment, and version context.
---
## Related Context
- `../workstreams/xflow-debugging.md`
- `fid4.md`

View File

@@ -0,0 +1,39 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- Track It
---
# TrackIT
## Role
- Internal tracking tool referenced from the Fidelity app/tool set.
---
## Stable Patterns
- Base note only; capture exact purpose and recurring workflows gradually.
---
## Risks
- Name alone is not enough to infer ownership or authoritative data.
---
## Related Context
- `confluence.md`

View File

@@ -0,0 +1,41 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related:
- vault
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- Vault preprod
---
# Vault Preprod
## Role
- Pre-production variant of the internal Fidelity Vault app/tool.
---
## Stable Patterns
- Keep this separate from production Vault context when documenting behavior.
- Base note only; add environment-specific usage gradually.
---
## Risks
- Easy to mix up with production Vault or with this workspace's own `vault/` directory.
---
## Related Context
- `vault.md`

View File

@@ -0,0 +1,38 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
---
# Vault
## Role
- Internal Fidelity app/tool named Vault.
---
## Stable Patterns
- Base note only; keep it separate from this workspace's own `vault/` directory because the names collide.
- Add real purpose and usage patterns gradually as they become clear.
---
## Risks
- Name collision with the workspace's canonical memory vault can cause confusion in notes and communication.
---
## Related Context
- `vault-preprod.md`

View File

@@ -0,0 +1,41 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- Wukong3.0
- Find test data easier
---
# Wukong
## Role
- Internal tool associated with test-data workflows.
---
## Stable Patterns
- Recent bookmark evidence suggests it helps find or generate test data more easily.
- Base note only; add exact supported workflows gradually.
---
## Risks
- Test-data tooling often has environment-specific constraints and policy caveats.
---
## Related Context
- `fid4.md`

View File

@@ -0,0 +1,40 @@
---
type: system
project: fidelity
status: active
systems: []
workstreams: []
people: []
related: []
tags:
- system
- fidelity
updated: 2026-04-17
aliases:
- XQ1
---
# XQ1 Portfolio Summary
## Role
- Internal Fidelity app/page related to the XQ1 environment.
---
## Stable Patterns
- Likely useful for environment-level validation or summary checks.
- Base note only; add exact role in debugging/release validation gradually.
---
## Risks
- Environment pages can be read as status signals without proving app-level behavior.
---
## Related Context
- `fid4.md`

View File

@@ -0,0 +1,68 @@
---
type: map
domain: fidelity-apps
tags:
- map
- fidelity
- apps
---
# Fidelity Apps Map
Independent notes for internal Fidelity apps and tools that appear repeatedly in day-to-day engineering work.
---
## Build And Release
- [Artifactory](../03-context/systems/artifactory.md)
- [iOSInstaller](../03-context/systems/iosinstaller.md)
- [Nexus Fidelity](../03-context/systems/nexus-fidelity.md)
---
## Debugging And Validation
- [Splunk](../03-context/systems/splunk.md)
- [Cogstore](../03-context/systems/cogstore.md)
- [XQ1 Portfolio Summary](../03-context/systems/xq1-portfolio-summary.md)
- [Vault](../03-context/systems/vault.md)
- [Vault Preprod](../03-context/systems/vault-preprod.md)
---
## Collaboration And Documentation
- [Confluence](../03-context/systems/confluence.md)
- [Miro](../03-context/systems/miro.md)
- [Discourse](../03-context/systems/discourse.md)
- [Slate](../03-context/systems/slate.md)
---
## Access And Internal Portals
- [MyAccess](../03-context/systems/myaccess.md)
- [Fidelity Central](../03-context/systems/fidelity-central.md)
---
## Tracking And Support Tools
- [TrackIT](../03-context/systems/trackit.md)
- [ALMx Toolbox](../03-context/systems/almx-toolbox.md)
---
## Test Data And Other Utilities
- [Wukong](../03-context/systems/wukong.md)
---
## Related Context
- [Systems Index](../03-context/systems/index.md)
- [Fidelity Domain Map](fidelity-domain.md)
- [Consumer Integration](../03-context/workstreams/consumer-integration.md)
- [Fid4](../03-context/systems/fid4.md)

View File

@@ -24,11 +24,12 @@ Stable Fidelity-specific systems, workstreams, and domain rules.
## Systems ## Systems
- [Systems Index](../03-context/systems/index.md) - [Systems Index](../03-context/systems/index.md)
- [Fidelity Apps Map](./fidelity-apps.md)
- [Fid4](../03-context/systems/fid4.md) - [Fid4](../03-context/systems/fid4.md)
- [XFlowSDK](../03-context/systems/xflowsdk.md) - [XFlowSDK](../03-context/systems/xflowsdk.md)
- [XFlowViewMaker](../03-context/systems/xflowviewmaker.md) - [XFlowViewMaker](../03-context/systems/xflowviewmaker.md)
- [FTFrameworks](../03-context/systems/ftframeworks.md) - [FTFrameworks](../03-context/systems/ftframeworks.md)
- [Cogstore](../03-context/systems/cogstore.md) - [CogStore](../03-context/systems/cogstore.md)
--- ---

View File

@@ -18,6 +18,7 @@ Use these maps to navigate the workspace by meaning instead of by raw folder str
- [AI Workspace Core](ai-workspace-core.md) - [AI Workspace Core](ai-workspace-core.md)
- [Current Work](current-work.md) - [Current Work](current-work.md)
- [Fidelity Domain](fidelity-domain.md) - [Fidelity Domain](fidelity-domain.md)
- [Fidelity Apps](fidelity-apps.md)
- [Work Items](work-items.md) - [Work Items](work-items.md)
- [People](people.md) - [People](people.md)
- [Tooling](tooling.md) - [Tooling](tooling.md)