No description
Find a file
Randall Stillwell 56b697b81c feat(markdown-backlog): close the sync loop with DB → frontmatter export
Until now the markdown importer was one-way (plans/*.md → DB). Any
agent-driven status flip via claim_task / complete_task would be
clobbered on the next importer sweep. This change closes the loop: the
DB now projects status, priority, agent_prompt, and updated_at back
into the file's frontmatter, preserving body bytes, key order, and
every other frontmatter key.

New: packages/database/src/markdown-backlog/export.ts
  - `rewriteFrontmatter()` — pure function, covered by 10 Vitest cases
    (round-trip identity, status flip, priority flip, agent_prompt
    null/block-scalar/single-line variants, body preservation,
    trailing-newline preservation, idempotent re-application).
  - `exportBacklogItemToMarkdown()` — DB-loading wrapper with atomic
    write (tmp + rename) and tenant fencing. Returns a structured
    result so callers can surface what happened in their response.

Wired into:
  - `claim_task` MCP tool — exports on the ready → in_progress flip.
  - `complete_task` MCP tool — exports on any finalStatus transition.
  - `backlog.updateWorkflowPrompt` tRPC mutation — exports on prompt
    edits made through the app UI.

Robust repo-root resolution (`apps/{mcp-server,web}/src/lib/repo-root.ts`,
plus a copy in `import-markdown-backlog.ts`): walk up from the source
file looking for `pnpm-workspace.yaml`, falling back to env var or cwd.
This fixes a class of bug where `pnpm --filter <pkg>` cd's into the
package directory and breaks naive cwd-based path resolution — the
importer was deleting all 44 rows during smoke testing before this fix
because it found zero files in `packages/database/plans/`.

`config/CursorSync.md`: documents the new two-way contract, the
DB-wins-on-allow-list conflict policy, and the
MARKDOWN_BACKLOG_REPO_ROOT=off escape hatch for production deployments
where `plans/` isn't checked out.

Smoke verified end-to-end against the homelab DB: claim flips file
status to in_progress, complete flips it back to ready, importer
round-trips with stable content_hash (true no-op), agent identity
preserved throughout.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-03 10:21:22 -05:00
.cursor chore(agent-coordination): wire Cursor MCP + one-shot importer for dogfooding 2026-06-03 08:57:21 -05:00
.github/workflows test(ci): bootstrap vitest + GitHub Actions and lock in 3-gate quality bar 2026-06-02 09:23:55 -05:00
apps feat(markdown-backlog): close the sync loop with DB → frontmatter export 2026-06-03 10:21:22 -05:00
config feat(markdown-backlog): close the sync loop with DB → frontmatter export 2026-06-03 10:21:22 -05:00
docker docker: raise web build V8 heap to 5 GB to match 8 GB host 2026-04-28 13:33:46 -05:00
docs feat(backlog): workflow_prompt with task → epic → plan inheritance 2026-06-02 22:18:18 -05:00
packages feat(markdown-backlog): close the sync loop with DB → frontmatter export 2026-06-03 10:21:22 -05:00
plans feat(markdown-backlog): close the sync loop with DB → frontmatter export 2026-06-03 10:21:22 -05:00
.env.example feat: ECHODO app shell, Coolify deploy, Authentik + Umami 2026-04-26 14:34:34 -05:00
.gitignore feat: ECHODO app shell, Coolify deploy, Authentik + Umami 2026-04-26 14:34:34 -05:00
AGENTS.md test(ci): bootstrap vitest + GitHub Actions and lock in 3-gate quality bar 2026-06-02 09:23:55 -05:00
package.json test(ci): bootstrap vitest + GitHub Actions and lock in 3-gate quality bar 2026-06-02 09:23:55 -05:00
pnpm-lock.yaml test(ci): bootstrap vitest + GitHub Actions and lock in 3-gate quality bar 2026-06-02 09:23:55 -05:00
pnpm-workspace.yaml feat: Full project management application scaffold 2026-03-26 22:39:16 -05:00
tsconfig.json feat: Full project management application scaffold 2026-03-26 22:39:16 -05:00
turbo.json test(ci): bootstrap vitest + GitHub Actions and lock in 3-gate quality bar 2026-06-02 09:23:55 -05:00