Skip to content

docs(roadmap): add dependency matrix and critical path for Phase 2.6 …#72

Merged
cemililik merged 2 commits into
mainfrom
development
Jul 8, 2026
Merged

docs(roadmap): add dependency matrix and critical path for Phase 2.6 …#72
cemililik merged 2 commits into
mainfrom
development

Conversation

@cemililik

@cemililik cemililik commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

…workstreams

Summary by Sourcery

Document the sequencing, dependencies, and parallelization plan for Phase 2.6 conversational authoring, and record out-of-scope items as carry-forward tasks.

Documentation:

  • Add a dependency matrix, critical path, and parallelization tracks to the Phase 2.6 roadmap to clarify workstream ordering and bottlenecks.
  • Update the Phase 2.6 mermaid diagram to reflect day-one independents, post-foundation work, and final integration stages.
  • Document Phase 2.6 out-of-scope items in deferred-tasks.md, linking each to a later phase or decision gate so they remain tracked.

Chores:

  • Capture previously untracked Phase 2.6 deferrals (file-snapshot undo, workflow egress/os arms, multi-pane dashboard, plugin ToolSource loader) as explicit follow-ups.

Summary by CodeRabbit

  • Documentation
    • Added a new carry-forward checklist for Phase 2.6 deferred items.
    • Expanded the Phase 2.6 conversational authoring roadmap with a detailed dependency matrix and clearer critical-path narrative.
    • Reworked sequencing guidance with updated parallelization tracks and a revised dependency visualization for day-by-day progression.

@sourcery-ai

sourcery-ai Bot commented Jul 8, 2026

Copy link
Copy Markdown

Reviewer's Guide

This PR restructures the Phase 2.6 roadmap docs to introduce an explicit dependency matrix, critical path, and parallelization tracks, and adds a new section to deferred tasks documenting Phase 2.6 out-of-scope items and their future ownership.

Flow diagram for Phase 2.6 critical paths and bottleneck

flowchart LR
    F[2.6.F full_screen_foundation]
    G[2.6.G browsers]
    M[2.6.M render_v2]
    A[2.6.A authoring_package]
    B[2.6.B conversational_authoring]
    N[2.6.N orchestration]
    H[2.6.H run_detail_data]
    L[2.6.L theme_i18n]
    E[2.6.E chat_UX]

    F --> G
    G --> M
    M --> phase_close_1[phase_close]

    F --> L
    L --> E

    A --> B
    B --> N
    N --> phase_close_2[phase_close]

    H --> N
Loading

File-Level Changes

Change Details Files
Introduce explicit dependency matrix, critical path, and parallelization tracks for Phase 2.6 workstreams.
  • Add a tabular dependency matrix mapping each 2.6.* workstream to its prerequisites and the work it blocks.
  • Define textual critical path sequences highlighting bottleneck workstreams and parallel spines.
  • Refactor and expand sequencing narrative into structured parallelization track tables keyed by start conditions and outputs.
  • Replace the previous Mermaid flowchart with a more detailed graph grouped into Day 1, After F/A, and Final integration subgraphs.
docs/roadmap/phases/phase-2.6-conversational-authoring.md
Document out-of-scope Phase 2.6 items and explicitly carry them forward into later phases/ADRs.
  • Add a new section listing Phase 2.6 out-of-scope items that lacked prior tracking entries.
  • For each item, describe scope boundaries, rationale for deferral, and map it to future phases or ADRs.
  • Cover undo file-snapshot behavior, workflow-run egress/os arms, multi-pane dashboard, and plugin ToolSource loader as deferred work.
docs/roadmap/deferred-tasks.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@coderabbitai

coderabbitai Bot commented Jul 8, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8f594cdb-4ad4-45e2-aa9b-4a34fc5c25a5

📥 Commits

Reviewing files that changed from the base of the PR and between 3080d42 and cd24c8b.

📒 Files selected for processing (2)
  • docs/roadmap/deferred-tasks.md
  • docs/roadmap/phases/phase-2.6-conversational-authoring.md

📝 Walkthrough

Walkthrough

Documentation-only updates to roadmap files: deferred-tasks.md adds a Phase-2.6 out-of-scope carry-forward section, and phase-2.6-conversational-authoring.md adds a dependency matrix, critical-path notes, parallelization tables, and a reworked dependency diagram.

Changes

Roadmap Documentation Updates

Layer / File(s) Summary
Deferred-tasks carry-forward tracking
docs/roadmap/deferred-tasks.md
Adds a "Phase-2.6 out-of-scope carry-forward" subsection with four deferred checklist items covering undo/revert, workflow-run tool wiring, dashboard layout, and plugin ToolSource loading.
Phase-2.6 dependency matrix and sequencing diagram
docs/roadmap/phases/phase-2.6-conversational-authoring.md
Adds a dependency matrix, critical-path notes, parallelization-track tables, and a restructured Mermaid dependency flow for Phase 2.6.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

  • HodeTech/Relavium#39: Both PRs modify deferred-task checklist items in docs/roadmap/deferred-tasks.md.
  • HodeTech/Relavium#59: Both PRs update Phase 2.6 roadmap planning content in the same document set.
  • HodeTech/Relavium#70: Both PRs modify the same Phase 2.6 roadmap and deferred-tasks documents as part of related re-scope work.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly matches the PR’s Phase 2.6 roadmap docs update, highlighting the new dependency matrix and sequencing focus.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch development

Comment @coderabbitai help to get the list of available commands.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the roadmap documentation by adding a list of deferred out-of-scope tasks for Phase 2.6 in deferred-tasks.md and detailing the sequencing, dependency matrix, parallelization tracks, and flowcharts in phase-2.6-conversational-authoring.md. The review feedback correctly identifies discrepancies in the critical path ASCII diagram relative to the dependency matrix and provides an improved diagram to ensure consistency.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment on lines +920 to +923
2.6.F → 2.6.G → 2.6.M (render-v2) → phase close
↘ 2.6.L → 2.6.E
2.6.A → 2.6.B → 2.6.N → phase close
D → B ↗ ↗ H ↗

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The critical path ASCII diagram contains two discrepancies when compared to the dependency matrix and parallelization tracks:

  1. Incorrect sequence for 2.6.M (render-v2): The diagram shows 2.6.F → 2.6.G → 2.6.M (render-v2), implying that 2.6.M (render-v2) depends on 2.6.G. However, the dependency matrix and tracks state that 2.6.M (render-v2) only depends on 2.6.F and can run in parallel with 2.6.G.
  2. Missing block on 2.6.M (final): The diagram shows 2.6.N → phase close directly, but 2.6.N actually blocks 2.6.M (specifically invoke_agent acceptance), making 2.6.M the final integration step on that track before the phase can close.

Consider updating the ASCII diagram to accurately reflect these relationships.

Suggested change
2.6.F → 2.6.G → 2.6.M (render-v2) → phase close
↘ 2.6.L → 2.6.E
2.6.A → 2.6.B → 2.6.N → phase close
D → B ↗ ↗ H ↗
2.6.F ──→ 2.6.G ───────────────────────────┐
├──→ 2.6.L ──→ 2.6.E ─────────────────┼─→ phase close
└──→ 2.6.M (render-v2) ──┐ │
▼ │
2.6.A ──→ 2.6.B ──→ 2.6.N ──→ 2.6.M (final)┘
D ──→ B ↗ ↗ H ↗

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/roadmap/deferred-tasks.md`:
- Around line 901-924: Update the carry-forward references in these
deferred-task bullets so they use relative markdown links instead of plain-text
filenames or phase labels. In the roadmap entries mentioning Phase 3 desktop and
Phase 4/vscode, replace the bare references with links to the canonical
roadmap/ADR pages, keeping the existing symbols like phase-3-desktop.md,
phase-4-vscode.md, ADR-0055/0057, and ADR-0007 easy to navigate from this
ledger.

In `@docs/roadmap/phases/phase-2.6-conversational-authoring.md`:
- Around line 896-964: The markdownlint failures come from the unlabeled ASCII
critical-path fence and missing spacing around the tables in the
dependency-matrix section. Update the fenced block so it is explicitly labeled
in a way markdownlint accepts, or replace it with a valid Mermaid block, and add
the required blank lines before and after each table. Use the nearby “Dependency
matrix,” “Critical path,” and “Parallelization tracks” sections to locate the
affected block.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 09bcce5f-61fa-40ab-9d2b-4fe6a377db8b

📥 Commits

Reviewing files that changed from the base of the PR and between 05e919a and 3080d42.

📒 Files selected for processing (2)
  • docs/roadmap/deferred-tasks.md
  • docs/roadmap/phases/phase-2.6-conversational-authoring.md

Comment thread docs/roadmap/deferred-tasks.md Outdated
Comment thread docs/roadmap/phases/phase-2.6-conversational-authoring.md
@cemililik
cemililik merged commit 88f8fff into main Jul 8, 2026
9 of 10 checks passed
@sonarqubecloud

sonarqubecloud Bot commented Jul 8, 2026

Copy link
Copy Markdown

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