Skip to content

feat: add markdown tracker with Lago journaling#4

Merged
github-actions[bot] merged 6 commits intomasterfrom
codex/enhance-conversation-history-bridge
Mar 19, 2026
Merged

feat: add markdown tracker with Lago journaling#4
github-actions[bot] merged 6 commits intomasterfrom
codex/enhance-conversation-history-bridge

Conversation

@broomva
Copy link
Owner

@broomva broomva commented Mar 19, 2026

Summary

  • Add tracker.kind: markdown — reads .md files from a local directory as issues, no external APIs or credentials required
  • Add Lago-compatible JSONL audit journal ({issues_dir}/.journal.jsonl) for state transition tracking
  • Optional Lago HTTP endpoint integration: creates a session on startup when Lago daemon is reachable
  • Add symphony init --tracker markdown CLI scaffolding with full WORKFLOW.md template

Changes

New files

  • crates/symphony-tracker/src/markdown.rsMarkdownClient + Journal implementation (26 tests)
  • examples/markdown-claude.md — example WORKFLOW.md for markdown tracker

Modified files

  • crates/symphony-tracker/src/lib.rs — register markdown kind in factory, add error variants
  • crates/symphony-config/src/loader.rs — accept markdown in validator, skip api_key for local trackers
  • src/cli/init.rs — markdown template, env hints, next-steps output
  • EXTENDING.md — document markdown tracker format, Lago journaling, journal entry schema
  • README.md — update architecture references from Linear-only to multi-tracker
  • docs/operations/Configuration Reference.md — add markdown kind to config tables
  • docs/crates/symphony-tracker.md — full rewrite reflecting 3 tracker implementations

Skill updates (outside repo)

  • Updated Symphony SKILL.md with markdown tracker + Lago triggers
  • Updated references/workflow-config.md with Markdown Files section

Test plan

  • cargo clippy --workspace -- -D warnings — zero warnings
  • cargo test --workspace — 285 tests pass (68 in tracker, 26 new)
  • CLI integration tests pass (18/18 including init/validate round-trips)
  • Existing Linear/GitHub tracker tests unaffected

🤖 Generated with Claude Code

broomva and others added 5 commits March 18, 2026 13:20
Improve conversation-history.py with enhanced parsing, metadata
extraction, and session documentation. Add 13 new conversation
session docs from March 6-18 and update the Conversations index.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
README listed 7 crates but workspace has 8 (symphony-arcan was missing).
Also documented the dashboard/ TypeScript/React Turborepo.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…out external APIs

Add a new `tracker.kind: markdown` that reads `.md` files from a local directory
as issues, with YAML front matter for metadata (id, title, state, priority,
labels, blocked_by). State transitions rewrite the front matter in-place.
No API keys or external services required.

Lago integration: every state transition and poll scan is journaled to
`{issues_dir}/.journal.jsonl` using Lago's `EventPayload::Custom` schema.
When `endpoint` points to a running Lago daemon, a session is created on
startup. Falls back to local-only journal when Lago isn't reachable.

- New: `crates/symphony-tracker/src/markdown.rs` (MarkdownClient + Journal)
- New: `examples/markdown-claude.md` WORKFLOW.md example
- Updated: tracker factory, config validator, CLI init scaffold
- Updated: EXTENDING.md, README, Configuration Reference, crate docs
- 26 new tests (68 total in symphony-tracker), all 285 workspace tests pass

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@railway-app railway-app bot temporarily deployed to symphony / symphony-pr-4 March 19, 2026 13:42 Destroyed
@railway-app
Copy link

railway-app bot commented Mar 19, 2026

🚅 Deployed to the symphony-pr-4 environment in symphony

Service Status Web Updated (UTC)
symphony 🕒 Building (View Logs) Web Mar 19, 2026 at 1:46 pm
2 services not affected by this PR
  • postgres
  • dashboard

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@railway-app railway-app bot temporarily deployed to symphony / symphony-pr-4 March 19, 2026 13:46 Destroyed
@github-actions github-actions bot merged commit 712d083 into master Mar 19, 2026
9 of 10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant