List, Map and Stats Output
Detail for the read-only subcommands. None of them creates or edits a file.
List (/bridge list [project])
- Glob every YAML file in the bridges directory.
- Read each file and parse the YAML.
- With a project filter, match against config aliases and
namefields, case-insensitively, on either side of the bridge. - Sort by
datedescending, using filename sequence to break ties, and keep the last 10. - Print one line each. Use
→for one-way and↔for bidirectional, and always show the strength:
🔗 Bridges (last 10)
1. 2026-04-08 📖 HP → BR: philosopher encounters reframe positioning (potential)
2. 2026-04-08 🧠 BNP → HP: observability patterns = atelier content (active)
3. 2026-04-07 👤 HP ↔ SL: Matthieu carries context both ways (active)
Empty or missing directory: 🔗 No bridges captured yet. Use /bridge <source> → <target>: <description>. Do not return nothing.
Map (/bridge map)
- Read the config for project names, which become the node labels.
- Read every bridge file.
- Colour nodes by strength: active green, potential orange, theoretical pink.
- Print the mermaid block and nothing else:
graph LR
classDef active fill:#90EE90,stroke:#333,color:#000
classDef potential fill:#FFE4B5,stroke:#333,color:#000
classDef theoretical fill:#FFB6C1,stroke:#333,color:#000
HP["Homo Promptus"] -->|"📖 narrative"| BR["Personal Brand"]:::active
DS["Digital Stoic"] -->|"🧠 patterns"| HP:::potential
HP <-->|"👤 Matthieu"| SL["Slasheo"]:::active
Stats (/bridge stats)
- Read every bridge file and the config tier information.
- Count by project (as source and as target), archetype, strength and tier, for this week and all time.
- Print:
📊 Bridge Stats
This week: 5 bridges
All time: 23 bridges
By project (top 5):
HP: 12 (6→, 6←) [tier 1]
BR: 8 (2→, 6←) [tier 1]
By archetype:
🧠 knowledge: 8
📖 narrative: 6
By strength:
🟢 active: 9
🟡 potential: 11
🔴 theoretical: 3
Report counts exactly as read. Do not interpret them or recommend actions.