Skip to content

docs(effort-graph): add Effort Graph glossary and ADRs 0001-0007#205

Merged
tonyketcham merged 2 commits into
mainfrom
stack/tonyketcham/feat/unified-watch-effort-graph/add-effort-graph-glossary-adrs-0001-0007--6cb5cefc
Jul 18, 2026
Merged

docs(effort-graph): add Effort Graph glossary and ADRs 0001-0007#205
tonyketcham merged 2 commits into
mainfrom
stack/tonyketcham/feat/unified-watch-effort-graph/add-effort-graph-glossary-adrs-0001-0007--6cb5cefc

Conversation

@tonyketcham

Copy link
Copy Markdown
Collaborator

Capture the accepted design for the Effort Graph — a persistent, queryable
memory layer over long-horizon reasoning built on Flatbread collections.

  • CONTEXT.md: epistemic primitives (Effort, Issue, Finding, Decision,
    Constraint, Risk) and the cross-cutting edge vocabulary
  • ADR-0001: memory location (in-repo .flatbread-efforts/ default, sibling
    repo via config)
  • ADR-0002: semantic-mutation write surface
  • ADR-0003: standalone writer + read-after-write consistency (incremental
    reindex, generation tokens)
  • ADR-0004: multi-file honesty (forward-canonical edges, journaled
    save-or-undo atomicity)
  • ADR-0005: the thirteen v1 semantic mutations
  • ADR-0006: ID and slug strategy (kind prefix + kebab slug + base32 suffix)
  • ADR-0007: agent read shim (bounded envelopes + rendered digests)

Also adds the orchestrator-executor skill used to run this work.

Co-authored-by: Cursor [email protected]

Capture the accepted design for the Effort Graph — a persistent, queryable
memory layer over long-horizon reasoning built on Flatbread collections.

- CONTEXT.md: epistemic primitives (Effort, Issue, Finding, Decision,
  Constraint, Risk) and the cross-cutting edge vocabulary
- ADR-0001: memory location (in-repo `.flatbread-efforts/` default, sibling
  repo via config)
- ADR-0002: semantic-mutation write surface
- ADR-0003: standalone writer + read-after-write consistency (incremental
  reindex, generation tokens)
- ADR-0004: multi-file honesty (forward-canonical edges, journaled
  save-or-undo atomicity)
- ADR-0005: the thirteen v1 semantic mutations
- ADR-0006: ID and slug strategy (kind prefix + kebab slug + base32 suffix)
- ADR-0007: agent read shim (bounded envelopes + rendered digests)

Also adds the orchestrator-executor skill used to run this work.

Co-authored-by: Cursor <[email protected]>
Change-Id: I6cb5cefcea8cbc8a3363e3b86d4a0ffe66b44da4
@tonyketcham

tonyketcham commented Jul 17, 2026

Copy link
Copy Markdown
Collaborator Author

This pull request is part of a Mergify stack:

# Pull Request Link
1 docs(effort-graph): add Effort Graph glossary and ADRs 0001-0007 #205 👈
2 feat(core,cli): unified watch with incremental reindex and live schema swap #206
3 feat(effort-graph): journaled semantic writer for the Effort Graph #207
4 refactor(config): loadConfig returns an initialized LoadedFlatbreadConfig #208
5 refactor(core): single Record-production module owns file→Record and path classification #209
6 refactor(effort-graph): per-mutate snapshot + Decision lifecycle module #210
7 refactor(core): collection query executor owns filter/sort/paging with copy-on-output #211
8 refactor(core,cli): unified watch coordinator behind one seam, two adapters #212
9 refactor(core): per-build schema composer; delete the config-keyed schema cache #213
10 feat(effort-graph,flatbread): committed-generation bridge completes the ADR-0003/0004 contract #214
11 chore(core): drop unused graphql-compose-json and lru-cache dependencies #215
12 test: raise AVA concurrency now that the global-composer pin is obsolete #216
13 docs(agents): define orchestrator-executor operating model #217

@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio queue

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

  • 🟠 Waiting for queue conditions
  • ⏳ Enter queue
  • ⏳ Run checks
  • ⏳ Merge
Waiting for
All conditions
  • any of [🔀 queue conditions]:
    • all of [📌 queue conditions of queue rule default]:
      • github-review-approved [🛡 GitHub branch protection] (documentation)
      • any of [🛡 GitHub branch protection]:
        • check-success = build (20.x, ubuntu-latest)
        • check-neutral = build (20.x, ubuntu-latest)
        • check-skipped = build (20.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = build (22.x, ubuntu-latest)
        • check-neutral = build (22.x, ubuntu-latest)
        • check-skipped = build (22.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-nextjs (20.x, macos-latest)
        • check-neutral = integration-nextjs (20.x, macos-latest)
        • check-skipped = integration-nextjs (20.x, macos-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-nextjs (20.x, ubuntu-latest)
        • check-neutral = integration-nextjs (20.x, ubuntu-latest)
        • check-skipped = integration-nextjs (20.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-nextjs (20.x, windows-latest)
        • check-neutral = integration-nextjs (20.x, windows-latest)
        • check-skipped = integration-nextjs (20.x, windows-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-nextjs (22.x, macos-latest)
        • check-neutral = integration-nextjs (22.x, macos-latest)
        • check-skipped = integration-nextjs (22.x, macos-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-nextjs (22.x, ubuntu-latest)
        • check-neutral = integration-nextjs (22.x, ubuntu-latest)
        • check-skipped = integration-nextjs (22.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-nextjs (22.x, windows-latest)
        • check-neutral = integration-nextjs (22.x, windows-latest)
        • check-skipped = integration-nextjs (22.x, windows-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-sveltekit (20.x, macos-latest)
        • check-neutral = integration-sveltekit (20.x, macos-latest)
        • check-skipped = integration-sveltekit (20.x, macos-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-sveltekit (20.x, ubuntu-latest)
        • check-neutral = integration-sveltekit (20.x, ubuntu-latest)
        • check-skipped = integration-sveltekit (20.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-sveltekit (20.x, windows-latest)
        • check-neutral = integration-sveltekit (20.x, windows-latest)
        • check-skipped = integration-sveltekit (20.x, windows-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-sveltekit (22.x, macos-latest)
        • check-neutral = integration-sveltekit (22.x, macos-latest)
        • check-skipped = integration-sveltekit (22.x, macos-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-sveltekit (22.x, ubuntu-latest)
        • check-neutral = integration-sveltekit (22.x, ubuntu-latest)
        • check-skipped = integration-sveltekit (22.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = integration-sveltekit (22.x, windows-latest)
        • check-neutral = integration-sveltekit (22.x, windows-latest)
        • check-skipped = integration-sveltekit (22.x, windows-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = lint (20.x, ubuntu-latest)
        • check-neutral = lint (20.x, ubuntu-latest)
        • check-skipped = lint (20.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = lint (22.x, ubuntu-latest)
        • check-neutral = lint (22.x, ubuntu-latest)
        • check-skipped = lint (22.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = test (20.x, ubuntu-latest)
        • check-neutral = test (20.x, ubuntu-latest)
        • check-skipped = test (20.x, ubuntu-latest)
      • any of [🛡 GitHub branch protection]:
        • check-success = test (22.x, ubuntu-latest)
        • check-neutral = test (22.x, ubuntu-latest)
        • check-skipped = test (22.x, ubuntu-latest)
  • -closed [📌 queue requirement]
  • -conflict [📌 queue requirement]
  • -draft [📌 queue requirement]
  • any of [📌 queue -> configuration change requirements]:
    • -mergify-configuration-changed
    • check-success = Configuration changed

@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio queue

@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio refresh

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

queue

☑️ Command queue ignored because it is already running from a previous command.

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

queue

⚠️ There are no merge_bot_account being used

Details

Cannot use branch_protection_injection_mode set to none without using a merge_bot_account with the queue action

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

refresh

✅ Pull request refreshed

@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio refresh

@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio queue

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

refresh

✅ Pull request refreshed

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

queue

⚠️ Configuration not compatible with a branch protection setting

Details

The branch protection setting Require branches to be up to date before merging is not compatible with draft PR checks. To keep this branch protection enabled, update your Mergify configuration to enable in-place checks: set merge_queue.max_parallel_checks: 1, set every queue rule batch_size: 1, and avoid two-step CI (make merge_conditions identical to queue_conditions). Otherwise, disable this branch protection.

@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio refresh

@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio queue

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

refresh

✅ Pull request refreshed

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

  • Entered queue2026-07-18 08:30 UTC · Rule: owner-bypass · triggered by @tonyketcham with the @mergifyio queue command
  • Checks passed · in-place
  • Merged2026-07-18 08:34 UTC · at 96c7c24e2d54464f499b5340fe731161b4dff799

This pull request spent 4 minutes 4 seconds in the queue, including 3 minutes 22 seconds running CI.

Required conditions to merge
  • author = tonyketcham
  • check-success = build (20.x, ubuntu-latest)
  • check-success = build (22.x, ubuntu-latest)
  • check-success = integration-nextjs (20.x, macos-latest)
  • check-success = integration-nextjs (20.x, ubuntu-latest)
  • check-success = integration-nextjs (20.x, windows-latest)
  • check-success = integration-nextjs (22.x, macos-latest)
  • check-success = integration-nextjs (22.x, ubuntu-latest)
  • check-success = integration-nextjs (22.x, windows-latest)
  • check-success = integration-sveltekit (20.x, macos-latest)
  • check-success = integration-sveltekit (20.x, ubuntu-latest)
  • check-success = integration-sveltekit (20.x, windows-latest)
  • check-success = integration-sveltekit (22.x, macos-latest)
  • check-success = integration-sveltekit (22.x, ubuntu-latest)
  • check-success = integration-sveltekit (22.x, windows-latest)
  • check-success = lint (20.x, ubuntu-latest)
  • check-success = lint (22.x, ubuntu-latest)
  • check-success = test (20.x, ubuntu-latest)
  • check-success = test (22.x, ubuntu-latest)

@mergify mergify Bot added the queued label Jul 18, 2026
@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio update

@mergify

mergify Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

update

⚠️ Cannot use the command update

Details

⚠ The product Workflow Automation needs to be activated to enable this feature.

…graph/add-effort-graph-glossary-adrs-0001-0007--6cb5cefc
@tonyketcham
tonyketcham merged commit df3d6c5 into main Jul 18, 2026
19 checks passed
@tonyketcham
tonyketcham deleted the stack/tonyketcham/feat/unified-watch-effort-graph/add-effort-graph-glossary-adrs-0001-0007--6cb5cefc branch July 18, 2026 08:34
@mergify mergify Bot removed the queued label Jul 18, 2026
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