From 0b4d7238afd49f81e4d420a692e43310a3ad1542 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Sun, 26 Apr 2026 20:50:52 +0300
Subject: [PATCH 01/34] add today page cypress spec

---
 cypress/e2e/today.cy.js | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 cypress/e2e/today.cy.js

diff --git a/cypress/e2e/today.cy.js b/cypress/e2e/today.cy.js
new file mode 100644
index 0000000..7332662
--- /dev/null
+++ b/cypress/e2e/today.cy.js
@@ -0,0 +1,32 @@
+describe('The today page', () => {
+    beforeEach(() => {
+        cy.exec('npm run db:seed')
+    })
+
+    afterEach(() => {
+        cy.exec('npm run db:wipe')
+    })
+
+    it('redirects to login when not authenticated', () => {
+        cy.visit('/today')
+        cy.url().should('include', '/login')
+    })
+
+    it('displays a Today heading when authenticated', () => {
+        cy.loginAsUser()
+        cy.visit('/today')
+        cy.get('h1').should('contain', 'Today')
+    })
+
+    it('has a list element for scheduled nodes', () => {
+        cy.loginAsUser()
+        cy.visit('/today')
+        cy.get('#scheduled-nodes-list').should('exist')
+    })
+
+    it('home page links to the today page', () => {
+        cy.loginAsUser()
+        cy.visit('/home')
+        cy.get('a[href="/today"]').should('be.visible')
+    })
+})

From bfacb5b62c6e9903aa36058a0234acd3619a921a Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Sun, 26 Apr 2026 21:24:35 +0300
Subject: [PATCH 02/34] add today view route and template

---
 .gitignore                  |  4 +++-
 app/View/ViewController.php | 10 ++++++++++
 bootstrap/app.php           |  1 +
 public/js/today.js          | 33 +++++++++++++++++++++++++++++++++
 views/templates/today.php   | 13 +++++++++++++
 5 files changed, 60 insertions(+), 1 deletion(-)
 create mode 100644 public/js/today.js
 create mode 100644 views/templates/today.php

diff --git a/.gitignore b/.gitignore
index 68bd285..f8b367e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,6 @@
 vendor/
 node_modules/
 data/*.json
-.direnv/
\ No newline at end of file
+.direnv/
+cypress/screenshots/
+cypress/videos/
\ No newline at end of file
diff --git a/app/View/ViewController.php b/app/View/ViewController.php
index 4fd8d84..efe322b 100644
--- a/app/View/ViewController.php
+++ b/app/View/ViewController.php
@@ -38,6 +38,16 @@ class ViewController
         return $response;
     }
 
+    public function today(Response $response): Response
+    {
+        $html = file_get_contents(
+            __DIR__ . '/../../views/templates/today.php'
+        );
+        $response->getBody()->write($html);
+
+        return $response;
+    }
+
     public function login(Response $response): Response
     {
         $html = file_get_contents(
diff --git a/bootstrap/app.php b/bootstrap/app.php
index c05dc0f..c2150e0 100644
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -27,6 +27,7 @@ $app->post('/api/auth/register', [AuthController::class, 'register']);
 // Authenticated routes (any logged-in user)
 $app->group('', function (RouteCollectorProxy $group) {
     $group->get('/home', [ViewController::class, 'home']);
+    $group->get('/today', [ViewController::class, 'today']);
 
     $group->post('/api/auth/logout', [AuthController::class, 'logout']);
     $group->get('/api/auth/me', [AuthController::class, 'me']);
diff --git a/public/js/today.js b/public/js/today.js
new file mode 100644
index 0000000..6f14627
--- /dev/null
+++ b/public/js/today.js
@@ -0,0 +1,33 @@
+document.addEventListener('DOMContentLoaded', () => {
+    const scheduledNodesList = document.getElementById(
+        'scheduled-nodes-list'
+    );
+
+    function todayDateString() {
+        const today = new Date();
+        const year = today.getFullYear();
+        const month = String(today.getMonth() + 1).padStart(2, '0');
+        const day = String(today.getDate()).padStart(2, '0');
+        return year + '-' + month + '-' + day;
+    }
+
+    async function loadScheduledNodes() {
+        const date = todayDateString();
+        const response = await fetch(
+            '/api/scheduled-nodes?date=' + date,
+            { credentials: 'same-origin' }
+        );
+        if (!response.ok) {
+            return;
+        }
+        const scheduledNodes = await response.json();
+        scheduledNodesList.innerHTML = scheduledNodes
+            .map((scheduledNode) =>
+                '<li>' + scheduledNode.planName + ': ' +
+                scheduledNode.nodeTitle + '</li>'
+            )
+            .join('');
+    }
+
+    loadScheduledNodes();
+});
diff --git a/views/templates/today.php b/views/templates/today.php
new file mode 100644
index 0000000..6edba97
--- /dev/null
+++ b/views/templates/today.php
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Daily Goals - Today</title>
+</head>
+<body>
+    <h1>Today</h1>
+    <ul id="scheduled-nodes-list">
+    </ul>
+    <script src="/js/auth.js"></script>
+    <script src="/js/today.js"></script>
+</body>
+</html>

From 6314f1c38c5bc8cbe77dba01c75a778781f775e9 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Sun, 26 Apr 2026 20:53:08 +0300
Subject: [PATCH 03/34] add link to today page on home

---
 views/templates/home.php | 1 +
 1 file changed, 1 insertion(+)

diff --git a/views/templates/home.php b/views/templates/home.php
index 4f7a096..258a404 100644
--- a/views/templates/home.php
+++ b/views/templates/home.php
@@ -6,6 +6,7 @@
 <body>
     <h1>Home</h1>
     <button id="logout">Logout</button>
+    <a href="/today">Today's schedule</a>
     <ul id="texts-list">
     </ul>
     <div id="create-plan-modal" hidden>

From 46d01aa81334c7db394ee9aef380aef4cc11340b Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Sun, 26 Apr 2026 20:53:28 +0300
Subject: [PATCH 04/34] test today page lists scheduled nodes

---
 cypress/e2e/today.cy.js | 43 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/cypress/e2e/today.cy.js b/cypress/e2e/today.cy.js
index 7332662..1f24450 100644
--- a/cypress/e2e/today.cy.js
+++ b/cypress/e2e/today.cy.js
@@ -29,4 +29,47 @@ describe('The today page', () => {
         cy.visit('/home')
         cy.get('a[href="/today"]').should('be.visible')
     })
+
+    it('lists scheduled nodes for today', () => {
+        const today = new Date()
+        const year = today.getFullYear()
+        const month = String(today.getMonth() + 1).padStart(2, '0')
+        const day = String(today.getDate()).padStart(2, '0')
+        const todayString = year + '-' + month + '-' + day
+
+        cy.loginAsUser()
+        cy.request({
+            method: 'POST',
+            url: '/api/plans',
+            body: {
+                textId: 0,
+                name: 'My reading plan',
+                dateStart: todayString,
+                dateEnd: todayString,
+            },
+        })
+
+        cy.intercept('GET', '/api/scheduled-nodes*')
+            .as('getScheduledNodes')
+        cy.visit('/today')
+        cy.wait('@getScheduledNodes').then((interception) => {
+            expect(interception.request.url).to.include(
+                'date=' + todayString
+            )
+        })
+        cy.get('#scheduled-nodes-list').should(
+            'contain',
+            'My reading plan'
+        )
+        cy.get('#scheduled-nodes-list').should('contain', 'Bereishis')
+    })
+
+    it('shows an empty list when no nodes are scheduled today', () => {
+        cy.loginAsUser()
+        cy.intercept('GET', '/api/scheduled-nodes*')
+            .as('getScheduledNodes')
+        cy.visit('/today')
+        cy.wait('@getScheduledNodes')
+        cy.get('#scheduled-nodes-list li').should('have.length', 0)
+    })
 })

From d47a0235d2491fa81b0a534a6bff7c48df91d2c0 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Sun, 26 Apr 2026 20:54:33 +0300
Subject: [PATCH 05/34] add node to scheduled node entity and dto

---
 DailyGoals.drawio                            | 13 ++++++++-----
 app/ScheduledNode/CreateScheduledNodeDto.php |  2 ++
 app/ScheduledNode/ScheduledNode.php          |  7 +++++++
 3 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/DailyGoals.drawio b/DailyGoals.drawio
index b0937cb..aa76945 100644
--- a/DailyGoals.drawio
+++ b/DailyGoals.drawio
@@ -16,11 +16,14 @@
         <mxCell id="UlVOh7WOaItsqOB8hf6W-7" edge="1" parent="1" source="UlVOh7WOaItsqOB8hf6W-5" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;" target="UlVOh7WOaItsqOB8hf6W-2">
           <mxGeometry relative="1" as="geometry" />
         </mxCell>
+        <mxCell id="UlVOh7WOaItsqOB8hf6W-21" edge="1" parent="1" source="UlVOh7WOaItsqOB8hf6W-5" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.5;entryY=1;entryDx=0;entryDy=0;" target="UlVOh7WOaItsqOB8hf6W-9">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
         <mxCell id="UlVOh7WOaItsqOB8hf6W-5" parent="1" style="whiteSpace=wrap;html=1;aspect=fixed;" value="Scheduled Node" vertex="1">
           <mxGeometry height="80" width="80" x="610" y="290" as="geometry" />
         </mxCell>
         <mxCell id="UlVOh7WOaItsqOB8hf6W-8" parent="1" style="whiteSpace=wrap;html=1;aspect=fixed;" value="Text" vertex="1">
-          <mxGeometry height="80" width="80" x="240" y="60" as="geometry" />
+          <mxGeometry height="80" width="80" x="450" y="90" as="geometry" />
         </mxCell>
         <mxCell id="UlVOh7WOaItsqOB8hf6W-12" edge="1" parent="1" source="UlVOh7WOaItsqOB8hf6W-9" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;" target="UlVOh7WOaItsqOB8hf6W-8">
           <mxGeometry relative="1" as="geometry" />
@@ -28,14 +31,14 @@
         <mxCell id="UlVOh7WOaItsqOB8hf6W-14" edge="1" parent="1" source="UlVOh7WOaItsqOB8hf6W-9" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;exitX=1;exitY=0.25;exitDx=0;exitDy=0;entryX=1;entryY=0.75;entryDx=0;entryDy=0;" target="UlVOh7WOaItsqOB8hf6W-9" value="">
           <mxGeometry relative="1" as="geometry">
             <Array as="points">
-              <mxPoint x="590" y="80" />
-              <mxPoint x="590" y="120" />
+              <mxPoint x="800" y="110" />
+              <mxPoint x="800" y="150" />
             </Array>
-            <mxPoint x="590" y="120" as="targetPoint" />
+            <mxPoint x="800" y="150" as="targetPoint" />
           </mxGeometry>
         </mxCell>
         <mxCell id="UlVOh7WOaItsqOB8hf6W-9" parent="1" style="whiteSpace=wrap;html=1;aspect=fixed;" value="Node" vertex="1">
-          <mxGeometry height="80" width="80" x="400" y="60" as="geometry" />
+          <mxGeometry height="80" width="80" x="610" y="90" as="geometry" />
         </mxCell>
         <mxCell id="UlVOh7WOaItsqOB8hf6W-19" edge="1" parent="1" source="UlVOh7WOaItsqOB8hf6W-17" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" target="UlVOh7WOaItsqOB8hf6W-1">
           <mxGeometry relative="1" as="geometry" />
diff --git a/app/ScheduledNode/CreateScheduledNodeDto.php b/app/ScheduledNode/CreateScheduledNodeDto.php
index 5e7a695..086c975 100644
--- a/app/ScheduledNode/CreateScheduledNodeDto.php
+++ b/app/ScheduledNode/CreateScheduledNodeDto.php
@@ -2,6 +2,7 @@
 
 namespace App\ScheduledNode;
 
+use App\Node\Node;
 use App\Plan\Plan;
 use DateTimeImmutable;
 
@@ -10,5 +11,6 @@ class CreateScheduledNodeDto
     public function __construct(
         public DateTimeImmutable $date,
         public Plan $plan,
+        public Node $node,
     ) {}
 }
diff --git a/app/ScheduledNode/ScheduledNode.php b/app/ScheduledNode/ScheduledNode.php
index 7d479db..a2d2386 100644
--- a/app/ScheduledNode/ScheduledNode.php
+++ b/app/ScheduledNode/ScheduledNode.php
@@ -2,6 +2,7 @@
 
 namespace App\ScheduledNode;
 
+use App\Node\Node;
 use App\Plan\Plan;
 use DateTimeImmutable;
 
@@ -11,6 +12,7 @@ class ScheduledNode
         private int $id,
         private DateTimeImmutable $date,
         private Plan $plan,
+        private Node $node,
     ) {}
 
     public function getId(): int
@@ -27,4 +29,9 @@ class ScheduledNode
     {
         return $this->date;
     }
+
+    public function getNode(): Node
+    {
+        return $this->node;
+    }
 }

From a9265abeaeb05d74290c1293e0d1ce4d3cd90658 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Mon, 27 Apr 2026 09:28:43 +0300
Subject: [PATCH 06/34] add node to scheduled node

---
 app/Plan/UseCases/CreatePlan.php              |  1 +
 .../JsonScheduledNodeRepository.php           |  2 +
 .../UseCases/CreateScheduledNode.php          | 30 ++++++++--
 .../UseCases/CreateScheduledNodeRequest.php   |  1 +
 tests/Fakes/FakeScheduledNodeRepository.php   |  1 +
 tests/Unit/Plan/UseCases/CreatePlanTest.php   |  1 +
 .../UseCases/CreateScheduledNodeTest.php      | 57 +++++++++++++++++++
 tests/e2e/Controllers/PlanControllerTest.php  |  1 +
 8 files changed, 88 insertions(+), 6 deletions(-)

diff --git a/app/Plan/UseCases/CreatePlan.php b/app/Plan/UseCases/CreatePlan.php
index b12fc50..8a3cc91 100644
--- a/app/Plan/UseCases/CreatePlan.php
+++ b/app/Plan/UseCases/CreatePlan.php
@@ -64,6 +64,7 @@ class CreatePlan
                 new CreateScheduledNodeRequest(
                     date: $scheduledDate->format('Y-m-d'),
                     planId: $plan->getId(),
+                    nodeId: $node->getId(),
                 )
             );
         }
diff --git a/app/ScheduledNode/JsonScheduledNodeRepository.php b/app/ScheduledNode/JsonScheduledNodeRepository.php
index bee31ea..866584f 100644
--- a/app/ScheduledNode/JsonScheduledNodeRepository.php
+++ b/app/ScheduledNode/JsonScheduledNodeRepository.php
@@ -20,6 +20,7 @@ class JsonScheduledNodeRepository implements ScheduledNodeRepository
             'id' => $id,
             'date' => $dto->date->format('Y-m-d'),
             'planId' => $dto->plan->getId(),
+            'nodeId' => $dto->node->getId(),
         ];
         $this->writeScheduledNodes($scheduledNodes);
 
@@ -27,6 +28,7 @@ class JsonScheduledNodeRepository implements ScheduledNodeRepository
             id: $id,
             date: $dto->date,
             plan: $dto->plan,
+            node: $dto->node,
         );
     }
 
diff --git a/app/ScheduledNode/UseCases/CreateScheduledNode.php b/app/ScheduledNode/UseCases/CreateScheduledNode.php
index 752b658..444f4d0 100644
--- a/app/ScheduledNode/UseCases/CreateScheduledNode.php
+++ b/app/ScheduledNode/UseCases/CreateScheduledNode.php
@@ -3,6 +3,7 @@
 namespace App\ScheduledNode\UseCases;
 
 use App\Exceptions\BadRequestException;
+use App\Node\NodeRepository;
 use App\Plan\PlanRepository;
 use App\ScheduledNode\ScheduledNode;
 use App\ScheduledNode\CreateScheduledNodeDto;
@@ -15,6 +16,7 @@ class CreateScheduledNode
     public function __construct(
         private ScheduledNodeRepository $scheduledNodeRepo,
         private PlanRepository $planRepo,
+        private NodeRepository $nodeRepo,
     ) {}
 
     /**
@@ -24,24 +26,40 @@ class CreateScheduledNode
     public function execute(
         CreateScheduledNodeRequest $request
     ): ScheduledNode {
-        if ($request->date === null) {
+        $nodeId = $request->nodeId;
+        $planId = $request->planId;
+        $date = $request->date;
+        if ($date === null) {
             throw new BadRequestException('date is required');
         }
 
-        if ($request->planId === null) {
+        if ($planId === null) {
             throw new BadRequestException('planId is required');
         }
 
-        $id = $request->planId;
-        $plan = $this->planRepo->find($id);
+        if ($nodeId === null) {
+            throw new BadRequestException('nodeId is required');
+        }
+
+        $plan = $this->planRepo->find($planId);
         if ($plan === null) {
-            throw new DomainException("Plan with id: $id doesnt exist");
+            throw new DomainException(
+                "Plan with id: $planId doesnt exist"
+            );
+        }
+
+        $node = $this->nodeRepo->find($nodeId);
+        if ($node === null) {
+            throw new DomainException(
+                "Node with id: $nodeId doesnt exist"
+            );
         }
 
         return $this->scheduledNodeRepo->create(
             new CreateScheduledNodeDto(
-                date: new DateTimeImmutable($request->date),
+                date: new DateTimeImmutable($date),
                 plan: $plan,
+                node: $node,
             )
         );
     }
diff --git a/app/ScheduledNode/UseCases/CreateScheduledNodeRequest.php b/app/ScheduledNode/UseCases/CreateScheduledNodeRequest.php
index 5931cb3..4c0a2fd 100644
--- a/app/ScheduledNode/UseCases/CreateScheduledNodeRequest.php
+++ b/app/ScheduledNode/UseCases/CreateScheduledNodeRequest.php
@@ -7,5 +7,6 @@ class CreateScheduledNodeRequest
     public function __construct(
         public ?string $date,
         public ?int $planId,
+        public ?int $nodeId,
     ) {}
 }
diff --git a/tests/Fakes/FakeScheduledNodeRepository.php b/tests/Fakes/FakeScheduledNodeRepository.php
index 4241813..8bf5419 100644
--- a/tests/Fakes/FakeScheduledNodeRepository.php
+++ b/tests/Fakes/FakeScheduledNodeRepository.php
@@ -20,6 +20,7 @@ class FakeScheduledNodeRepository implements ScheduledNodeRepository
             id: $id,
             date: $dto->date,
             plan: $dto->plan,
+            node: $dto->node,
         );
         $this->existingScheduledNodes[$id] = $scheduledNode;
 
diff --git a/tests/Unit/Plan/UseCases/CreatePlanTest.php b/tests/Unit/Plan/UseCases/CreatePlanTest.php
index 94412b7..fbdfc60 100644
--- a/tests/Unit/Plan/UseCases/CreatePlanTest.php
+++ b/tests/Unit/Plan/UseCases/CreatePlanTest.php
@@ -45,6 +45,7 @@ class CreatePlanTest extends TestCase
         $this->createScheduledNode = new CreateScheduledNode(
             scheduledNodeRepo: $this->scheduledNodeRepo,
             planRepo: $this->planRepo,
+            nodeRepo: $this->nodeRepo,
         );
         $this->textRepo->create(new CreateTextDto('testname'));
         $this->useCase = new CreatePlan(
diff --git a/tests/Unit/ScheduledNode/UseCases/CreateScheduledNodeTest.php b/tests/Unit/ScheduledNode/UseCases/CreateScheduledNodeTest.php
index 477a07a..8c866fe 100644
--- a/tests/Unit/ScheduledNode/UseCases/CreateScheduledNodeTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/CreateScheduledNodeTest.php
@@ -3,15 +3,19 @@
 namespace Tests\Unit\ScheduledNode\UseCases;
 
 use App\Exceptions\BadRequestException;
+use App\Node\CreateNodeDto;
+use App\Node\Node;
 use App\Plan\CreatePlanDto;
 use App\Plan\Plan;
 use App\ScheduledNode\ScheduledNode;
 use App\ScheduledNode\ScheduledNodeRepository;
 use App\ScheduledNode\UseCases\CreateScheduledNode;
 use App\ScheduledNode\UseCases\CreateScheduledNodeRequest;
+use App\Text\Text;
 use App\User\User;
 use App\ValueObjects\EmailAddress;
 use DomainException;
+use Tests\Fakes\FakeNodeRepository;
 use Tests\Fakes\FakePlanRepository;
 use Tests\Fakes\FakeScheduledNodeRepository;
 use PHPUnit\Framework\TestCase;
@@ -22,12 +26,20 @@ class CreateScheduledNodeTest extends TestCase
 
     private FakePlanRepository $planRepo;
 
+    private FakeNodeRepository $nodeRepo;
+
     private CreateScheduledNode $useCase;
 
     public function setUp(): void
     {
         $this->scheduledNodeRepo = new FakeScheduledNodeRepository();
         $this->planRepo = new FakePlanRepository();
+        $this->nodeRepo = new FakeNodeRepository();
+        $this->nodeRepo->create(new CreateNodeDto(
+            text: new Text(0, 'text name'),
+            title: 'test node',
+            parentNode: null,
+        ));
         $this->planRepo->create(new CreatePlanDto(
             name: 'testplan',
             user: new User(
@@ -40,6 +52,7 @@ class CreateScheduledNodeTest extends TestCase
         $this->useCase = new CreateScheduledNode(
             $this->scheduledNodeRepo,
             $this->planRepo,
+            $this->nodeRepo,
         );
     }
 
@@ -49,6 +62,7 @@ class CreateScheduledNodeTest extends TestCase
             new CreateScheduledNodeRequest(
                 date: '2025-01-01',
                 planId: 0,
+                nodeId: 0,
             )
         );
         $this->assertInstanceOf(ScheduledNode::class, $scheduledNode);
@@ -64,11 +78,24 @@ class CreateScheduledNodeTest extends TestCase
             new CreateScheduledNodeRequest(
                 date: '2025-01-01',
                 planId: 0,
+                nodeId: 0
             )
         );
         $this->assertInstanceOf(Plan::class, $scheduledNode->getPlan());
     }
 
+    public function test_scheduled_node_belongs_to_node(): void
+    {
+        $scheduledNode = $this->useCase->execute(
+            new CreateScheduledNodeRequest(
+                date: '2025-01-01',
+                planId: 0,
+                nodeId: 0
+            )
+        );
+        $this->assertInstanceOf(Node::class, $scheduledNode->getNode());
+    }
+
     public function test_nonexistant_plan_throws(): void
     {
         $this->expectException(DomainException::class);
@@ -77,6 +104,20 @@ class CreateScheduledNodeTest extends TestCase
             new CreateScheduledNodeRequest(
                 date: '2025-01-01',
                 planId: 1,
+                nodeId: 0,
+            )
+        );
+    }
+
+    public function test_nonexistant_node_throws(): void
+    {
+        $this->expectException(DomainException::class);
+        $this->expectExceptionMessage('Node with id: 1 doesnt exist');
+        $this->useCase->execute(
+            new CreateScheduledNodeRequest(
+                date: '2025-01-01',
+                planId: 0,
+                nodeId: 1,
             )
         );
     }
@@ -90,6 +131,7 @@ class CreateScheduledNodeTest extends TestCase
             new CreateScheduledNodeRequest(
                 date: null,
                 planId: 0,
+                nodeId: 0
             )
         );
     }
@@ -103,6 +145,21 @@ class CreateScheduledNodeTest extends TestCase
             new CreateScheduledNodeRequest(
                 date: '2025-01-01',
                 planId: null,
+                nodeId: 0,
+            )
+        );
+    }
+
+    public function test_throws_if_node_id_is_null(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage('nodeId is required');
+
+        $this->useCase->execute(
+            new CreateScheduledNodeRequest(
+                date: '2025-01-01',
+                planId: 0,
+                nodeId: null,
             )
         );
     }
diff --git a/tests/e2e/Controllers/PlanControllerTest.php b/tests/e2e/Controllers/PlanControllerTest.php
index eb34ecd..818651c 100644
--- a/tests/e2e/Controllers/PlanControllerTest.php
+++ b/tests/e2e/Controllers/PlanControllerTest.php
@@ -55,6 +55,7 @@ class PlanControllerTest extends TestCase
         $createScheduledNode = new CreateScheduledNode(
             scheduledNodeRepo: $this->scheduledNodeRepo,
             planRepo: $this->planRepo,
+            nodeRepo: $this->nodeRepo,
         );
         $this->createPlan = new CreatePlan(
             $this->planRepo,

From 0ea300f4d24f237bb56fc890509bdbd917b5ba02 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Tue, 28 Apr 2026 22:37:28 +0300
Subject: [PATCH 07/34] add find by user method for scheduled nodes

---
 app/ScheduledNode/ScheduledNodeRepository.php |  6 +++++
 tests/Fakes/FakeScheduledNodeRepository.php   | 23 +++++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/app/ScheduledNode/ScheduledNodeRepository.php b/app/ScheduledNode/ScheduledNodeRepository.php
index b13b7c5..055a939 100644
--- a/app/ScheduledNode/ScheduledNodeRepository.php
+++ b/app/ScheduledNode/ScheduledNodeRepository.php
@@ -2,7 +2,13 @@
 
 namespace App\ScheduledNode;
 
+use App\User\User;
+
 interface ScheduledNodeRepository
 {
     public function create(CreateScheduledNodeDto $dto): ScheduledNode;
+    /**
+     * @return ScheduledNode[]
+     */
+    public function findByUser(User $user): array;
 }
diff --git a/tests/Fakes/FakeScheduledNodeRepository.php b/tests/Fakes/FakeScheduledNodeRepository.php
index 8bf5419..293fe72 100644
--- a/tests/Fakes/FakeScheduledNodeRepository.php
+++ b/tests/Fakes/FakeScheduledNodeRepository.php
@@ -5,6 +5,7 @@ namespace Tests\Fakes;
 use App\ScheduledNode\CreateScheduledNodeDto;
 use App\ScheduledNode\ScheduledNode;
 use App\ScheduledNode\ScheduledNodeRepository;
+use App\User\User;
 
 class FakeScheduledNodeRepository implements ScheduledNodeRepository
 {
@@ -46,4 +47,26 @@ class FakeScheduledNodeRepository implements ScheduledNodeRepository
     {
         return count($this->existingScheduledNodes);
     }
+
+    public function findByUser(User $user): array
+    {
+        $scheduledNodes = array_filter(
+            $this->existingScheduledNodes,
+            function (ScheduledNode $node) use ($user) {
+                return $node->getPlan()->getUser()->getId() === $user->getId();
+            }
+        );
+
+        return array_map(
+            function (ScheduledNode $node) {
+                return new ScheduledNode(
+                    id: $node->getId(),
+                    date: $node->getDate(),
+                    plan: $node->getPlan(),
+                    node: $node->getNode(),
+                );
+            },
+            $scheduledNodes,
+        );
+    }
 }

From 2047cd72e75611266a2b200017695d3e075979d8 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Tue, 28 Apr 2026 22:38:43 +0300
Subject: [PATCH 08/34] test get todays schedule and use case with request

---
 .../UseCases/GetTodaysSchedule.php            | 35 +++++++++
 .../UseCases/GetTodaysScheduleRequest.php     | 11 +++
 .../UseCases/GetTodaysScheduleTest.php        | 71 +++++++++++++++++++
 3 files changed, 117 insertions(+)
 create mode 100644 app/ScheduledNode/UseCases/GetTodaysSchedule.php
 create mode 100644 app/ScheduledNode/UseCases/GetTodaysScheduleRequest.php
 create mode 100644 tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php

diff --git a/app/ScheduledNode/UseCases/GetTodaysSchedule.php b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
new file mode 100644
index 0000000..1745fd3
--- /dev/null
+++ b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
@@ -0,0 +1,35 @@
+<?php
+
+namespace App\ScheduledNode\UseCases;
+
+use App\ScheduledNode\ScheduledNode;
+use App\ScheduledNode\ScheduledNodeRepository;
+use App\User\UserRepository;
+use DateTimeImmutable;
+
+class GetTodaysSchedule
+{
+    public function __construct(
+        private UserRepository $userRepo,
+        private ScheduledNodeRepository $scheduledNodeRepo,
+    ) {}
+
+    /**
+     * @return ScheduledNode[]
+     */
+    public function execute(GetTodaysScheduleRequest $request): array
+    {
+        $date = new DateTimeImmutable($request->date);
+        $userId = $request->userId;
+        $user = $this->userRepo->find($userId);
+        $scheduledNodes = $this->scheduledNodeRepo->findByUser($user);
+
+        return array_filter(
+            $scheduledNodes,
+            function (ScheduledNode $node) use ($date) {
+                return $node->getDate()->format('Y-m-d')
+                    === $date->format('Y-m-d');
+            }
+        );
+    }
+}
diff --git a/app/ScheduledNode/UseCases/GetTodaysScheduleRequest.php b/app/ScheduledNode/UseCases/GetTodaysScheduleRequest.php
new file mode 100644
index 0000000..ccb38b8
--- /dev/null
+++ b/app/ScheduledNode/UseCases/GetTodaysScheduleRequest.php
@@ -0,0 +1,11 @@
+<?php
+
+namespace App\ScheduledNode\UseCases;
+
+class GetTodaysScheduleRequest
+{
+    public function __construct(
+        public ?string $date,
+        public ?int $userId,
+    ) {}
+}
diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
new file mode 100644
index 0000000..f6b7053
--- /dev/null
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace Tests\Unit\ScheduledNode\UseCases;
+
+use App\Node\Node;
+use App\Plan\CreatePlanDto;
+use App\ScheduledNode\CreateScheduledNodeDto;
+use App\ScheduledNode\ScheduledNode;
+use App\ScheduledNode\UseCases\GetTodaysSchedule;
+use App\ScheduledNode\UseCases\GetTodaysScheduleRequest;
+use App\Text\Text;
+use App\User\UseCases\CreateUserDto;
+use App\ValueObjects\EmailAddress;
+use DateTimeImmutable;
+use PHPUnit\Framework\TestCase;
+use Tests\Fakes\FakePlanRepository;
+use Tests\Fakes\FakeScheduledNodeRepository;
+use Tests\Fakes\FakeUserRepository;
+
+class GetTodaysScheduleTest extends TestCase
+{
+    private FakeUserRepository $userRepo;
+
+    private FakePlanRepository $planRepo;
+
+    private FakeScheduledNodeRepository $scheduledNodeRepo;
+
+    private GetTodaysSchedule $useCase;
+
+    protected function setUp(): void
+    {
+        $this->userRepo = new FakeUserRepository;
+        $this->scheduledNodeRepo = new FakeScheduledNodeRepository;
+        $this->planRepo = new FakePlanRepository;
+        $user = $this->userRepo->create(new CreateUserDto(
+            email: new EmailAddress('email@email.com'),
+            passwordHash: 'hash',
+            isAdmin: false,
+        ));
+        $plan = $this->planRepo->create(new CreatePlanDto(
+            name: 'test plan',
+            user: $user,
+        ));
+        $this->scheduledNodeRepo->create(new CreateScheduledNodeDto(
+            date: new DateTimeImmutable('2025-01-01'),
+            plan: $plan,
+            node: new Node(
+                id: 0,
+                title: 'test node',
+                text: new Text(id: 0, name: 'test text'),
+                parentNode: null,
+            ),
+        ));
+
+        $this->useCase = new GetTodaysSchedule(
+            userRepo: $this->userRepo,
+            scheduledNodeRepo: $this->scheduledNodeRepo,
+        );
+    }
+
+    public function test_returns_array_of_scheduled_nodes(): void
+    {
+        $result = $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: '2025-01-01',
+            userId: 0,
+        ));
+
+        $this->assertIsArray($result);
+        $this->assertInstanceOf(ScheduledNode::class, $result[0]);
+    }
+}

From ec4dca87a6e2c2fcd207fecb04285171213f55e9 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Tue, 28 Apr 2026 22:48:25 +0300
Subject: [PATCH 09/34] test that all nodes up until given date are returned

---
 .../UseCases/GetTodaysSchedule.php            |  3 +--
 .../UseCases/GetTodaysScheduleTest.php        | 23 +++++++++++++++++--
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/app/ScheduledNode/UseCases/GetTodaysSchedule.php b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
index 1745fd3..973d2f4 100644
--- a/app/ScheduledNode/UseCases/GetTodaysSchedule.php
+++ b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
@@ -27,8 +27,7 @@ class GetTodaysSchedule
         return array_filter(
             $scheduledNodes,
             function (ScheduledNode $node) use ($date) {
-                return $node->getDate()->format('Y-m-d')
-                    === $date->format('Y-m-d');
+                return $node->getDate() <= $date;
             }
         );
     }
diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index f6b7053..ddc131c 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -42,7 +42,7 @@ class GetTodaysScheduleTest extends TestCase
             user: $user,
         ));
         $this->scheduledNodeRepo->create(new CreateScheduledNodeDto(
-            date: new DateTimeImmutable('2025-01-01'),
+            date: new DateTimeImmutable('2025-01-02'),
             plan: $plan,
             node: new Node(
                 id: 0,
@@ -61,11 +61,30 @@ class GetTodaysScheduleTest extends TestCase
     public function test_returns_array_of_scheduled_nodes(): void
     {
         $result = $this->useCase->execute(new GetTodaysScheduleRequest(
-            date: '2025-01-01',
+            date: '2025-01-02',
             userId: 0,
         ));
 
         $this->assertIsArray($result);
         $this->assertInstanceOf(ScheduledNode::class, $result[0]);
     }
+
+    public function test_returns_all_unfinished_scheduled_nodes_up_until_today(): void
+    {
+        $this->scheduledNodeRepo->create(new CreateScheduledNodeDto(
+            date: new DateTimeImmutable('2025-01-01'),
+            plan: $this->planRepo->find(0),
+            node: new Node(
+                id: 0,
+                title: 'test node',
+                text: new Text(id: 0, name: 'test text'),
+                parentNode: null,
+            ),
+        ));
+        $result = $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: '2025-01-02',
+            userId: 0,
+        ));
+        $this->assertEquals(2, count($result));
+    }
 }

From 07e34ffd46995ff8522ad3f000e418b4453703a7 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:02:34 +0300
Subject: [PATCH 10/34] add find by user method in plan repo

---
 app/Plan/JsonPlanRepository.php    | 25 +++++++++++++++++++++++++
 app/Plan/PlanRepository.php        |  6 ++++++
 tests/Fakes/FakePlanRepository.php | 24 ++++++++++++++++++++++++
 3 files changed, 55 insertions(+)

diff --git a/app/Plan/JsonPlanRepository.php b/app/Plan/JsonPlanRepository.php
index 8a88838..8c73d8a 100644
--- a/app/Plan/JsonPlanRepository.php
+++ b/app/Plan/JsonPlanRepository.php
@@ -90,4 +90,29 @@ class JsonPlanRepository implements PlanRepository
 
         return $maxId + 1;
     }
+
+    public function findByUser(User $user): array
+    {
+        $plans = array_filter(
+            $this->readPlans(),
+            function ($data) use ($user) {
+                return $data['userId'] === $user->getId();
+            }
+        );
+
+        return array_map(
+            function ($data) {
+                $user = $this->userRepository->find($data['userId']);
+                if ($user === null) {
+                    return null;
+                }
+                return new Plan(
+                    id: $data['id'],
+                    name: $data['name'],
+                    user: $user,
+                );
+            },
+            $plans
+        );
+    }
 }
diff --git a/app/Plan/PlanRepository.php b/app/Plan/PlanRepository.php
index a962c0f..0585edc 100644
--- a/app/Plan/PlanRepository.php
+++ b/app/Plan/PlanRepository.php
@@ -2,8 +2,14 @@
 
 namespace App\Plan;
 
+use App\User\User;
+
 interface PlanRepository
 {
     public function create(CreatePlanDto $dto): Plan;
     public function find(int $id): ?Plan;
+    /**
+     * @return Plan[]
+     */
+    public function findByUser(User $user): array;
 }
diff --git a/tests/Fakes/FakePlanRepository.php b/tests/Fakes/FakePlanRepository.php
index 45e2e85..8c18b00 100644
--- a/tests/Fakes/FakePlanRepository.php
+++ b/tests/Fakes/FakePlanRepository.php
@@ -5,9 +5,13 @@ namespace Tests\Fakes;
 use App\Plan\CreatePlanDto;
 use App\Plan\Plan;
 use App\Plan\PlanRepository;
+use App\User\User;
 
 class FakePlanRepository implements PlanRepository
 {
+    /**
+     * @var Plan[]
+     */
     private array $existingPlans = [];
 
     public function create(CreatePlanDto $dto): Plan
@@ -37,4 +41,24 @@ class FakePlanRepository implements PlanRepository
             }
         );
     }
+
+    public function findByUser(User $user): array
+    {
+        $plans = array_filter(
+            $this->existingPlans,
+            function (Plan $plan) use ($user) {
+                return $plan->getUser()->getId() === $user->getId();
+            }
+        );
+        return array_map(
+            function (Plan $plan) {
+                return new Plan(
+                    id: $plan->getId(),
+                    name: $plan->getName(),
+                    user: $plan->getUser(),
+                );
+            },
+            $plans
+        );
+    }
 }

From f2840a3eb11a65d8df4465e7c7313023397ae9ad Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:03:31 +0300
Subject: [PATCH 11/34] add find by user method in json scheduled node repo

---
 .../JsonScheduledNodeRepository.php           | 41 ++++++++++++++++++-
 1 file changed, 39 insertions(+), 2 deletions(-)

diff --git a/app/ScheduledNode/JsonScheduledNodeRepository.php b/app/ScheduledNode/JsonScheduledNodeRepository.php
index 866584f..a97e8b7 100644
--- a/app/ScheduledNode/JsonScheduledNodeRepository.php
+++ b/app/ScheduledNode/JsonScheduledNodeRepository.php
@@ -2,12 +2,19 @@
 
 namespace App\ScheduledNode;
 
+use App\Node\NodeRepository;
+use App\Plan\PlanRepository;
+use App\User\User;
+use DateTimeImmutable;
+
 class JsonScheduledNodeRepository implements ScheduledNodeRepository
 {
     private string $filePath;
 
-    public function __construct()
-    {
+    public function __construct(
+        private PlanRepository $planRepo,
+        private NodeRepository $nodeRepo,
+    ) {
         $this->filePath = __DIR__ . '/../../data/scheduledNodes.json';
     }
 
@@ -66,4 +73,34 @@ class JsonScheduledNodeRepository implements ScheduledNodeRepository
 
         return $maxId + 1;
     }
+
+    public function findByUser(User $user): array
+    {
+        $allScheduledNodes = $this->readScheduledNodes();
+        $planIds = array_map(
+            function ($plan) {
+                return $plan->getId();
+            },
+            $this->planRepo->findByUser($user)
+        );
+        $usersScheduledNodes = array_filter(
+            $allScheduledNodes,
+            function ($node) use ($planIds) {
+                return in_array($node['planId'], $planIds);
+            }
+        );
+
+        return array_map(
+            function ($data) {
+                return new ScheduledNode(
+                    id: $data['id'],
+                    date: new DateTimeImmutable($data['date']),
+                    plan: $this->planRepo->find($data['planId']),
+                    node: $this->nodeRepo->find($data['nodeId']),
+                    completed: $data['completed']
+                );
+            },
+            $usersScheduledNodes
+        );
+    }
 }

From 1b2e44389c047f067a4258df58b25a51564a0717 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:04:18 +0300
Subject: [PATCH 12/34] add completed bool to scheduled node

---
 app/ScheduledNode/JsonScheduledNodeRepository.php |  2 ++
 app/ScheduledNode/ScheduledNode.php               | 11 +++++++++++
 tests/Fakes/FakeScheduledNodeRepository.php       |  2 ++
 3 files changed, 15 insertions(+)

diff --git a/app/ScheduledNode/JsonScheduledNodeRepository.php b/app/ScheduledNode/JsonScheduledNodeRepository.php
index a97e8b7..1870844 100644
--- a/app/ScheduledNode/JsonScheduledNodeRepository.php
+++ b/app/ScheduledNode/JsonScheduledNodeRepository.php
@@ -28,6 +28,7 @@ class JsonScheduledNodeRepository implements ScheduledNodeRepository
             'date' => $dto->date->format('Y-m-d'),
             'planId' => $dto->plan->getId(),
             'nodeId' => $dto->node->getId(),
+            'completed' => false,
         ];
         $this->writeScheduledNodes($scheduledNodes);
 
@@ -36,6 +37,7 @@ class JsonScheduledNodeRepository implements ScheduledNodeRepository
             date: $dto->date,
             plan: $dto->plan,
             node: $dto->node,
+            completed: false,
         );
     }
 
diff --git a/app/ScheduledNode/ScheduledNode.php b/app/ScheduledNode/ScheduledNode.php
index a2d2386..83f29ef 100644
--- a/app/ScheduledNode/ScheduledNode.php
+++ b/app/ScheduledNode/ScheduledNode.php
@@ -13,6 +13,7 @@ class ScheduledNode
         private DateTimeImmutable $date,
         private Plan $plan,
         private Node $node,
+        private bool $completed,
     ) {}
 
     public function getId(): int
@@ -34,4 +35,14 @@ class ScheduledNode
     {
         return $this->node;
     }
+
+    public function getCompleted(): bool
+    {
+        return $this->completed;
+    }
+
+    public function setCompleted(bool $complete): void
+    {
+        $this->completed = $complete;
+    }
 }
diff --git a/tests/Fakes/FakeScheduledNodeRepository.php b/tests/Fakes/FakeScheduledNodeRepository.php
index 293fe72..82bb522 100644
--- a/tests/Fakes/FakeScheduledNodeRepository.php
+++ b/tests/Fakes/FakeScheduledNodeRepository.php
@@ -22,6 +22,7 @@ class FakeScheduledNodeRepository implements ScheduledNodeRepository
             date: $dto->date,
             plan: $dto->plan,
             node: $dto->node,
+            completed: false,
         );
         $this->existingScheduledNodes[$id] = $scheduledNode;
 
@@ -64,6 +65,7 @@ class FakeScheduledNodeRepository implements ScheduledNodeRepository
                     date: $node->getDate(),
                     plan: $node->getPlan(),
                     node: $node->getNode(),
+                    completed: $node->getCompleted(),
                 );
             },
             $scheduledNodes,

From 8eeff2c4fef6fa646f31e66d44dcb2b44e5fd836 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:05:55 +0300
Subject: [PATCH 13/34] add update method to fake scheduled node repo

---
 tests/Fakes/FakeScheduledNodeRepository.php | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/tests/Fakes/FakeScheduledNodeRepository.php b/tests/Fakes/FakeScheduledNodeRepository.php
index 82bb522..1125b51 100644
--- a/tests/Fakes/FakeScheduledNodeRepository.php
+++ b/tests/Fakes/FakeScheduledNodeRepository.php
@@ -29,6 +29,19 @@ class FakeScheduledNodeRepository implements ScheduledNodeRepository
         return $scheduledNode;
     }
 
+    public function update(ScheduledNode $node): ScheduledNode
+    {
+        $this->existingScheduledNodes[$node->getId()] = $node;
+
+        return new ScheduledNode(
+            id: $node->getId(),
+            date: $node->getDate(),
+            plan: $node->getPlan(),
+            node: $node->getNode(),
+            completed: $node->getCompleted()
+        );
+    }
+
     public function find(int $id): ?ScheduledNode
     {
         return array_find(

From e04931ac08f81822d50dc11616d42b5e1d6ce67f Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:06:13 +0300
Subject: [PATCH 14/34] test that todays schedule only returns uncompleted
 nodes

---
 .../UseCases/GetTodaysSchedule.php            |  3 ++-
 .../UseCases/GetTodaysScheduleTest.php        | 23 +++++++++++++++++++
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/app/ScheduledNode/UseCases/GetTodaysSchedule.php b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
index 973d2f4..12ff902 100644
--- a/app/ScheduledNode/UseCases/GetTodaysSchedule.php
+++ b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
@@ -27,7 +27,8 @@ class GetTodaysSchedule
         return array_filter(
             $scheduledNodes,
             function (ScheduledNode $node) use ($date) {
-                return $node->getDate() <= $date;
+                return $node->getDate() <= $date
+                    && $node->getCompleted() === false;
             }
         );
     }
diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index ddc131c..58a77b2 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -87,4 +87,27 @@ class GetTodaysScheduleTest extends TestCase
         ));
         $this->assertEquals(2, count($result));
     }
+
+    public function test_only_returns_uncompleted_nodes(): void
+    {
+        $node = $this->scheduledNodeRepo->create(
+            new CreateScheduledNodeDto(
+                date: new DateTimeImmutable('2025-01-01'),
+                plan: $this->planRepo->find(0),
+                node: new Node(
+                    id: 0,
+                    title: 'test node',
+                    text: new Text(id: 0, name: 'test text'),
+                    parentNode: null,
+                ),
+            ));
+        $node->setCompleted(true);
+        $this->scheduledNodeRepo->update($node);
+
+        $result = $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: '2025-01-02',
+            userId: 0,
+        ));
+        $this->assertEquals(1, count($result));
+    }
 }

From 669bcf8d5ecac2b376ae623145319b93dda72205 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:56:14 +0300
Subject: [PATCH 15/34] style

---
 bootstrap/container.php                                  | 8 ++++----
 .../ScheduledNode/UseCases/GetTodaysScheduleTest.php     | 9 +++++----
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/bootstrap/container.php b/bootstrap/container.php
index 2ae6e4c..02666ed 100644
--- a/bootstrap/container.php
+++ b/bootstrap/container.php
@@ -26,10 +26,10 @@ $container = new Container([
     NodeRepository::class => DI\autowire(JsonNodeRepository::class),
     PlanRepository::class => DI\autowire(JsonPlanRepository::class),
     UserRepository::class => DI\autowire(JsonUserRepository::class),
-    ScheduledNodeRepository::class =>
-        DI\autowire(JsonScheduledNodeRepository::class),
-    SessionRepository::class =>
-        DI\autowire(JsonSessionRepository::class),
+    ScheduledNodeRepository::class
+        => DI\autowire(JsonScheduledNodeRepository::class),
+    SessionRepository::class
+        => DI\autowire(JsonSessionRepository::class),
     TokenGenerator::class => DI\autowire(RandomTokenGenerator::class),
     Clock::class => DI\autowire(SystemClock::class),
     PasswordHasher::class => DI\autowire(BcryptPasswordHasher::class),
diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index 58a77b2..013bc64 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -29,9 +29,9 @@ class GetTodaysScheduleTest extends TestCase
 
     protected function setUp(): void
     {
-        $this->userRepo = new FakeUserRepository;
-        $this->scheduledNodeRepo = new FakeScheduledNodeRepository;
-        $this->planRepo = new FakePlanRepository;
+        $this->userRepo = new FakeUserRepository();
+        $this->scheduledNodeRepo = new FakeScheduledNodeRepository();
+        $this->planRepo = new FakePlanRepository();
         $user = $this->userRepo->create(new CreateUserDto(
             email: new EmailAddress('email@email.com'),
             passwordHash: 'hash',
@@ -100,7 +100,8 @@ class GetTodaysScheduleTest extends TestCase
                     text: new Text(id: 0, name: 'test text'),
                     parentNode: null,
                 ),
-            ));
+            )
+        );
         $node->setCompleted(true);
         $this->scheduledNodeRepo->update($node);
 

From 7ec91e3869f64167acba73a66fd8d3af8146cbba Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:56:25 +0300
Subject: [PATCH 16/34] reformat ai files

---
 AGENTS.md                      |  7 ++++
 ai/backend-context.md          | 45 ++++++++++++++++++++++
 ai/backend_prompt_template.md  | 68 ---------------------------------
 ai/frontend-context.md         | 33 ++++++++++++++++
 ai/frontend_prompt_template.md | 52 -------------------------
 ai/shared.md                   | 69 ++++++++++++++++++++++++++++++++++
 6 files changed, 154 insertions(+), 120 deletions(-)
 create mode 100644 AGENTS.md
 create mode 100644 ai/backend-context.md
 delete mode 100644 ai/backend_prompt_template.md
 create mode 100644 ai/frontend-context.md
 delete mode 100644 ai/frontend_prompt_template.md
 create mode 100644 ai/shared.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..5dea88b
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,7 @@
+# Project context
+
+Read these on every session. Rules in them override defaults.
+
+@ai/shared.md
+@ai/backend-context.md
+@ai/frontend-context.md
diff --git a/ai/backend-context.md b/ai/backend-context.md
new file mode 100644
index 0000000..fca41f0
--- /dev/null
+++ b/ai/backend-context.md
@@ -0,0 +1,45 @@
+# Backend context
+
+> Read `ai/shared.md` first. This file only covers backend-specific rules.
+
+## Project Context
+
+**Stack:** PHP 8.5, Slim 4, PHP-DI/Slim-Bridge, PHPUnit 13, Composer.
+Persistence is JSON-file based (see `Json*Repository` classes); no ORM.
+**Architecture:** Domain-Driven Design. Code is organized by domain entity
+under `app/` (Auth, Node, Plan, ScheduledNode, Text, User, View,
+ValueObjects) into Entities, DTOs, Repositories, Use Cases, and Fakes
+(in-memory repos for tests).
+
+## Code patterns
+
+- Look at similar entities (e.g. `Node`, `Text`) for reference
+- Entities: constructor with properties, getters
+- DTOs: simple data containers for creation (e.g. `CreateTextDto`)
+- Repositories: interfaces that define data access
+  - Do not write unit tests for concrete repository implementations
+    (e.g. `JsonNodeRepository`). They are exercised by e2e tests. Use
+    cases are tested with fake repositories.
+- Use cases: business logic with Request objects
+  - When throwing exceptions, add `@throws` docblock
+- Fakes: in-memory implementations for testing
+  - Look at `tests/Fakes/` for examples
+  - Find/lookup methods must return a new instance of the entity, not the
+    stored reference
+- Tests: follow existing patterns in `tests/Unit/[Entity]/UseCases/`
+  - In `setUp`, only use fake repositories for entities under test - construct
+    dependency objects directly with `new` (e.g.
+    `new Text(...)`) instead of creating them through their fake
+    repositories
+
+## PHP rules
+
+- Imports: always put `use` statements at the top of the file, never use inline
+  imports (e.g. `\App\Foo\Bar::class`)
+- Closures: never use arrow functions (`fn () =>`) - always use regular
+  anonymous functions (`function () { return ...; }`)
+
+## Pre-commit
+
+Run `php-cs-fixer fix` on worked-on directories before committing (uses the
+existing `.php-cs-fixer.dist.php` config).
diff --git a/ai/backend_prompt_template.md b/ai/backend_prompt_template.md
deleted file mode 100644
index c16ef26..0000000
--- a/ai/backend_prompt_template.md
+++ /dev/null
@@ -1,68 +0,0 @@
-# Entity Creation Prompt Template
-
-Follow the existing patterns in this codebase to:
-- create a new entity called [EntityName].
-
-Requirements:
-- The entity encapsulates [one or more Entities]
-- Include [any other fields]
-
-Process (TDD - Test Driven Development):
-1. Write a test first
-2. Run the test to confirm it fails
-3. Implement the code to make the test pass
-4. Run the test to confirm it passes
-5. Repeat for each new behavior
-
-Code patterns to follow:
-- First, explore the codebase to understand existing entity patterns
-- Look at similar entities (e.g. Node, Text, etc.) for reference
-- Entities: constructor with properties, getters
-- DTOs: simple data containers for creation
-- Repositories: interfaces that define data access
-  - Do not write unit tests for concrete repository implementations
-    (e.g., Doctrine/persistence-backed). They are exercised by e2e
-    tests. Use cases are tested with fake repositories.
-- Use cases: business logic with Request objects
-  - When throwing exceptions, add @throws docblock
-- Fakes: in-memory implementations for testing
-  - Look at tests/Fakes/ for examples
-  - Find/lookup methods must return a new instance of the entity, not the stored reference
-- Tests: follow existing patterns in tests/Unit/[Entity]/UseCases/
-  - In setUp, only use fake repositories for entities under test - construct dependency objects directly with `new` (e.g., `new Text(....)`) instead of creating them through their fake repositories
-- Lines should not exceed 80 columns, but should use up to 80 columns when possible - do not split lines unnecessarily
-- Imports: always put use statements at the top of the file, never use inline imports (e.g., \App\Foo\Bar::class)
-- Variable names: use explicit, descriptive names - never single-letter or abbreviated variables (e.g., use $sponsorship not $s, $event not $e)
-- Never use em-dashes (—) in code, comments, commit messages, or any
-  written output. Use a regular hyphen (-), a colon, or rephrase
-  with parentheses instead.
-
-Git commit style:
-- Subject: present tense, imperative mood (add, create, test, fix)
-- Subject: lowercase, short (3-6 words)
-- Match subject patterns found in git history
-- Add a body when the change needs explanation beyond the subject -
-  e.g., why the change was made, non-obvious tradeoffs, or notable
-  implementation details. Skip the body for trivial/self-evident commits.
-- Separate subject and body with a blank line; wrap body at ~72 columns
-
-Git commits:
-- Tests should be committed first, before implementation
-- Group related changes together in a single commit (e.g., a new class
-  plus its registration, or a getter plus the property it exposes).
-  Avoid mixing unrelated concerns in one commit.
-- Keep commits small and focused - prefer many small commits over few
-  large ones, but don't artificially split a single logical change
-  across multiple commits
-- Commits are for reviewing and documenting the development of code
-- Don't wait to commit - commit as you go
-- Run `php-cs-fixer fix` on worked on directories before committing
-
-Branch naming:
-- Use kebab-case (e.g., presenting-track, agenda-slots)
-- Use descriptive feature names
-- Examples: "presenting-track", "agenda-slots", "confirm-application"
-- Or use type/description: "feature/presenting-track", "fix/bug-name"
-- NEVER work directly on master/main - always create and work on a branch
-
-Do not push anything. Make commits as you go.
diff --git a/ai/frontend-context.md b/ai/frontend-context.md
new file mode 100644
index 0000000..8757e1f
--- /dev/null
+++ b/ai/frontend-context.md
@@ -0,0 +1,33 @@
+# Frontend context
+
+> Read `ai/shared.md` first. This file only covers frontend-specific rules.
+
+## Project Context
+
+**Stack:** vanilla PHP templates in `views/templates/`, plain ES JavaScript in
+`public/js/`, no framework, no build step. Cypress 15 for E2E.
+**Entry point:** `public/index.php` (Slim app); page templates are rendered
+via the existing templating layer.
+
+## Code patterns
+
+- Look at existing pages (`home.php`/`home.js`, `text.php`/`text.js`,
+  `today.php`/`today.js`) for reference before writing anything
+- **Templates:** `views/templates/<page>.php`, one file per page
+- **Page JS:** `public/js/<page>.js`, one file per page, paired with the
+  matching template
+- **Testing:** Cypress E2E only, mirror existing `cypress/e2e/*.cy.js` style
+  (note: this project uses `.cy.js`, not `.cy.ts`)
+- **Imports / script tags:** keep at the top of the file
+- **Variable names:** explicit, descriptive (e.g. `text` not `t`)
+
+## Pre-commit
+
+No JS formatter or linter is configured yet; format manually for consistency
+with surrounding files. (TODO: wire up format/lint when added.)
+
+## Note on commit granularity
+
+Frontend changes are often a template plus its page-level JS counterpart -
+commit them together as a single logical unit, per the "one logical change
+per commit" rule in `shared.md`.
diff --git a/ai/frontend_prompt_template.md b/ai/frontend_prompt_template.md
deleted file mode 100644
index a865577..0000000
--- a/ai/frontend_prompt_template.md
+++ /dev/null
@@ -1,52 +0,0 @@
-# Frontend Prompt Template
-
-Follow the existing patterns in this codebase to:
-- xxxxxxxx
-
-Requirements:
-- xxxxx
-
-Process (TDD - Test Driven Development):
-1. Write a test first
-2. Run the test to confirm it fails
-3. Implement the code to make the test pass
-4. Run the test to confirm it passes
-5. Repeat for each new behavior
-
-Code patterns to follow:
-- First, explore the codebase to understand existing entity patterns
-- Look at similar pages for reference
-- Tests: follow existing patterns in cypress/e2e/
-- Lines should not exceed 80 columns, but should use up to 80 columns when possible - do not split lines unnecessarily
-- Imports: always put imports at the top of the file
-- Variable names: use explicit, descriptive names - never single-letter or abbreviated variables (e.g., use sponsorship not s, event not e)
-- Never use em-dashes (—) in code, comments, commit messages, or any
-  written output. Use a regular hyphen (-), a colon, or rephrase
-  with parentheses instead.
-
-Git commit style:
-- Subject: present tense, imperative mood (add, create, test, fix)
-- Subject: lowercase, short (3-6 words)
-- Match subject patterns found in git history
-- Add a body when the change needs explanation beyond the subject -
-  e.g., why the change was made, non-obvious tradeoffs, or notable
-  implementation details. Skip the body for trivial/self-evident commits.
-- Separate subject and body with a blank line; wrap body at ~72 columns
-
-Git commits:
-- Tests should be committed first, before implementation
-- Group related changes together in a single commit (e.g., a new class
-  plus its registration, or a getter plus the property it exposes).
-  Avoid mixing unrelated concerns in one commit.
-- Keep commits small and focused - prefer many small commits over few
-  large ones, but don't artificially split a single logical change
-  across multiple commits
-- Commits are for reviewing and documenting the development of code
-- Don't wait to commit - commit as you go
-
-Branch naming:
-- Use kebab-case (e.g., node-page text-page)
-- Use descriptive feature names
-- NEVER work directly on master - always create and work on a branch
-
-Do not push anything. Make commits as you go.
diff --git a/ai/shared.md b/ai/shared.md
new file mode 100644
index 0000000..71256ea
--- /dev/null
+++ b/ai/shared.md
@@ -0,0 +1,69 @@
+# Shared rules
+
+Rules that apply to both backend and frontend work in this repo. Stack-specific
+guides (`backend-context.md`, `frontend-context.md`) extend these.
+
+## Process (TDD)
+
+0. Before editing any file, ensure you are on a feature branch
+   (`git status` to confirm). If on master/main, create a branch
+   first.
+1. Write the test first
+2. Run the test to confirm it fails
+3. Commit the failing test (the "tests committed first" rule in
+   action - the test commit precedes the implementation commit, not
+   merely the implementation lines)
+4. Implement the code to make the test pass
+5. Run the test to confirm it passes
+6. Commit the implementation
+7. Repeat for each new behavior
+
+## Code style
+
+- Lines should not exceed 80 columns, but should use up to 80 columns when
+  possible - do not split lines unnecessarily
+- Variable names: use explicit, descriptive names - never single-letter or
+  abbreviated variables (e.g. `$text` not `$t`, `$node` not `$n`)
+- First, explore the codebase to understand existing patterns - look at similar
+  files for reference before writing anything
+- Never use em dashes (—) in code, comments, or docblocks - use hyphens (-)
+  instead
+
+## Git commit style
+
+- Present tense, imperative mood (add, create, wire, fix, test)
+- Lowercase
+- Short (3-6 words)
+- Match patterns found in git history
+- Do not add any section mentioning claude as a coauthor
+- Add a commit body when the subject alone cannot convey the change - e.g.
+  non-obvious motivation, multi-file coordination, or notable complexity
+- Body: wrap at ~72 columns, separated from subject by a blank line, explain
+  the why and any non-obvious what
+- Skip the body for trivial or self-explanatory commits
+
+## Git commits
+
+- Tests should be committed first, before implementation
+- One logical change per commit - a commit may span multiple files when they
+  form a single logical unit (e.g. a use case with its request and exception,
+  or a template with its page-level JS)
+- Keep commits focused: not one file per commit, not unrelated work batched
+- Make commits frequent - commit each meaningful logical step as you go
+- Commits are for reviewing and documenting the development of code
+- When the formatter or linter modifies files outside your intended
+  change, either `git restore` them or land them as a separate
+  `format <area>` / `lint <area>` commit - never bundle drive-by
+  formatter churn into a feature commit
+- If pre-commit lint fails on code you did not touch, do not bundle
+  the fix - either land the unrelated fix as its own commit first, or
+  note the pre-existing failure and proceed
+
+## Branching
+
+- Use kebab-case (e.g. `text-page`, `scheduled-node`, `auth-flow`)
+- Use descriptive feature names
+- Or use type/description: `feature/text-page`, `fix/bug-name`
+- NEVER work directly on master/main - always create and work on a branch
+
+Do not push anything. Make commits as you go.

From 0c76773ef0c1e3a9910f3ec6f440183a63efab09 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:57:20 +0300
Subject: [PATCH 17/34] opencode config

---
 .opencode/opencode.json | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 .opencode/opencode.json

diff --git a/.opencode/opencode.json b/.opencode/opencode.json
new file mode 100644
index 0000000..e2342fc
--- /dev/null
+++ b/.opencode/opencode.json
@@ -0,0 +1,7 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "caveman",
+    "caveman-opencode-plugin@latest"
+  ]
+}
\ No newline at end of file

From 636d2dc517dbc45642efbaf94ef576e293ecb2b3 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:58:28 +0300
Subject: [PATCH 18/34] test get scheduled nodes endpoint

---
 .../ScheduledNodeControllerTest.php           | 198 ++++++++++++++++++
 1 file changed, 198 insertions(+)
 create mode 100644 tests/e2e/Controllers/ScheduledNodeControllerTest.php

diff --git a/tests/e2e/Controllers/ScheduledNodeControllerTest.php b/tests/e2e/Controllers/ScheduledNodeControllerTest.php
new file mode 100644
index 0000000..c5f7b1c
--- /dev/null
+++ b/tests/e2e/Controllers/ScheduledNodeControllerTest.php
@@ -0,0 +1,198 @@
+<?php
+
+namespace Tests\e2e\Controllers;
+
+use App\Node\Node;
+use App\Plan\CreatePlanDto;
+use App\ScheduledNode\CreateScheduledNodeDto;
+use App\ScheduledNode\ScheduledNodeController;
+use App\ScheduledNode\UseCases\GetTodaysSchedule;
+use App\Text\Text;
+use App\User\UseCases\CreateUserDto;
+use App\User\User;
+use App\ValueObjects\EmailAddress;
+use DateTimeImmutable;
+use PHPUnit\Framework\TestCase;
+use Psr\Http\Message\ServerRequestInterface;
+use Slim\Psr7\Factory\ServerRequestFactory;
+use Slim\Psr7\Response;
+use Tests\Fakes\FakePlanRepository;
+use Tests\Fakes\FakeScheduledNodeRepository;
+use Tests\Fakes\FakeUserRepository;
+
+class ScheduledNodeControllerTest extends TestCase
+{
+    private FakeUserRepository $userRepo;
+    private FakePlanRepository $planRepo;
+    private FakeScheduledNodeRepository $scheduledNodeRepo;
+    private GetTodaysSchedule $getTodaysSchedule;
+    private ScheduledNodeController $controller;
+    private User $user;
+
+    public function setUp(): void
+    {
+        $this->userRepo = new FakeUserRepository();
+        $this->planRepo = new FakePlanRepository();
+        $this->scheduledNodeRepo = new FakeScheduledNodeRepository();
+
+        $this->user = $this->userRepo->create(new CreateUserDto(
+            email: new EmailAddress('test@test.com'),
+            passwordHash: '',
+            isAdmin: false,
+        ));
+
+        $this->getTodaysSchedule = new GetTodaysSchedule(
+            userRepo: $this->userRepo,
+            scheduledNodeRepo: $this->scheduledNodeRepo,
+        );
+        $this->controller = new ScheduledNodeController();
+    }
+
+    private function makeRequest(
+        ?string $date,
+        ?User $user = null,
+    ): ServerRequestInterface {
+        $request = new ServerRequestFactory()
+            ->createServerRequest(
+                'GET',
+                'http://localhost/api/scheduled-nodes'
+            );
+        if ($user !== null) {
+            $request = $request->withAttribute('user', $user);
+        }
+        if ($date !== null) {
+            $request = $request->withQueryParams(['date' => $date]);
+        }
+        return $request;
+    }
+
+    private function seedScheduledNode(
+        User $user,
+        string $date,
+        string $planName = 'My reading plan',
+        string $nodeTitle = 'Bereishis',
+    ): void {
+        $plan = $this->planRepo->create(new CreatePlanDto(
+            name: $planName,
+            user: $user,
+        ));
+        $this->scheduledNodeRepo->create(new CreateScheduledNodeDto(
+            date: new DateTimeImmutable($date),
+            plan: $plan,
+            node: new Node(
+                id: 0,
+                title: $nodeTitle,
+                text: new Text(id: 0, name: 'test text'),
+                parentNode: null,
+            ),
+        ));
+    }
+
+    public function test_returns_200_with_scheduled_nodes_for_user(): void
+    {
+        $this->seedScheduledNode($this->user, '2025-01-02');
+
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest('2025-01-02', $this->user),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $this->assertEquals(200, $response->getStatusCode());
+        $body = json_decode((string) $response->getBody(), true);
+        $this->assertIsArray($body);
+        $this->assertCount(1, $body);
+    }
+
+    public function test_response_has_expected_fields(): void
+    {
+        $this->seedScheduledNode(
+            $this->user,
+            '2025-01-02',
+            'My reading plan',
+            'Bereishis',
+        );
+
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest('2025-01-02', $this->user),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $body = json_decode((string) $response->getBody(), true);
+        $this->assertArrayHasKey('id', $body[0]);
+        $this->assertArrayHasKey('date', $body[0]);
+        $this->assertEquals('2025-01-02', $body[0]['date']);
+        $this->assertEquals('My reading plan', $body[0]['planName']);
+        $this->assertEquals('Bereishis', $body[0]['nodeTitle']);
+        $this->assertEquals(false, $body[0]['completed']);
+    }
+
+    public function test_returns_401_when_no_user_attribute(): void
+    {
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest('2025-01-02'),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $this->assertEquals(401, $response->getStatusCode());
+    }
+
+    public function test_returns_400_when_date_query_param_missing(): void
+    {
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest(null, $this->user),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $this->assertEquals(400, $response->getStatusCode());
+        $body = json_decode((string) $response->getBody(), true);
+        $this->assertArrayHasKey('error', $body);
+    }
+
+    public function test_excludes_future_scheduled_nodes(): void
+    {
+        $this->seedScheduledNode($this->user, '2025-01-10');
+
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest('2025-01-02', $this->user),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $body = json_decode((string) $response->getBody(), true);
+        $this->assertCount(0, $body);
+    }
+
+    public function test_excludes_completed_scheduled_nodes(): void
+    {
+        $this->seedScheduledNode($this->user, '2025-01-02');
+        $stored = $this->scheduledNodeRepo->find(0);
+        $stored->setCompleted(true);
+        $this->scheduledNodeRepo->update($stored);
+
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest('2025-01-02', $this->user),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $body = json_decode((string) $response->getBody(), true);
+        $this->assertCount(0, $body);
+    }
+
+    public function test_returns_empty_array_when_user_has_no_nodes(): void
+    {
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest('2025-01-02', $this->user),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $this->assertEquals(200, $response->getStatusCode());
+        $body = json_decode((string) $response->getBody(), true);
+        $this->assertEquals([], $body);
+    }
+}

From 4294521dfc13cde6ac48627c57655f6e12a17a29 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 09:59:18 +0300
Subject: [PATCH 19/34] add scheduled nodes endpoint

---
 app/ScheduledNode/ScheduledNodeController.php | 61 +++++++++++++++++++
 bootstrap/app.php                             |  6 ++
 2 files changed, 67 insertions(+)
 create mode 100644 app/ScheduledNode/ScheduledNodeController.php

diff --git a/app/ScheduledNode/ScheduledNodeController.php b/app/ScheduledNode/ScheduledNodeController.php
new file mode 100644
index 0000000..282f381
--- /dev/null
+++ b/app/ScheduledNode/ScheduledNodeController.php
@@ -0,0 +1,61 @@
+<?php
+
+namespace App\ScheduledNode;
+
+use App\ScheduledNode\UseCases\GetTodaysSchedule;
+use App\ScheduledNode\UseCases\GetTodaysScheduleRequest;
+use App\User\User;
+use Psr\Http\Message\ResponseInterface as Response;
+use Psr\Http\Message\ServerRequestInterface as Request;
+
+class ScheduledNodeController
+{
+    public function getScheduledNodes(
+        Request $request,
+        Response $response,
+        GetTodaysSchedule $getTodaysSchedule,
+    ): Response {
+        $user = $request->getAttribute('user');
+        if (!$user instanceof User) {
+            $response->getBody()->write(
+                json_encode(['error' => 'unauthenticated'])
+            );
+            return $response->withStatus(401)
+                ->withHeader('Content-Type', 'application/json');
+        }
+
+        $queryParams = $request->getQueryParams();
+        $date = $queryParams['date'] ?? null;
+        if ($date === null || $date === '') {
+            $response->getBody()->write(
+                json_encode(['error' => 'date is required'])
+            );
+            return $response->withStatus(400)
+                ->withHeader('Content-Type', 'application/json');
+        }
+
+        $scheduledNodes = $getTodaysSchedule->execute(
+            new GetTodaysScheduleRequest(
+                date: $date,
+                userId: $user->getId(),
+            )
+        );
+
+        $data = array_values(array_map(
+            function (ScheduledNode $scheduledNode) {
+                return [
+                    'id' => $scheduledNode->getId(),
+                    'date' => $scheduledNode->getDate()->format('Y-m-d'),
+                    'planName' => $scheduledNode->getPlan()->getName(),
+                    'nodeTitle' => $scheduledNode->getNode()->getTitle(),
+                    'completed' => $scheduledNode->getCompleted(),
+                ];
+            },
+            $scheduledNodes,
+        ));
+
+        $response->getBody()->write(json_encode($data));
+        return $response->withStatus(200)
+            ->withHeader('Content-Type', 'application/json');
+    }
+}
diff --git a/bootstrap/app.php b/bootstrap/app.php
index c2150e0..b4e9907 100644
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -11,6 +11,7 @@ use App\View\ViewController;
 use App\Text\TextController;
 use App\Node\NodeController;
 use App\Plan\PlanController;
+use App\ScheduledNode\ScheduledNodeController;
 
 $container = require __DIR__ . '/container.php';
 $app = Bridge::create($container);
@@ -44,6 +45,11 @@ $app->group('', function (RouteCollectorProxy $group) {
     );
 
     $group->post('/api/plans', [PlanController::class, 'createPlan']);
+
+    $group->get(
+        '/api/scheduled-nodes',
+        [ScheduledNodeController::class, 'getScheduledNodes']
+    );
 })->add(AuthMiddleware::class);
 
 // Admin-only routes

From 8b5767e6f409d9ee6978c11103f2449d0ab15b76 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:04:32 +0300
Subject: [PATCH 20/34] add no default parameters rule

Forcing every call site to be explicit eliminates a class of bugs where an unintended default silently slips through. Codifies the convention already established by prior commits (cd40483, b41652a, 8eb0f23).
---
 ai/shared.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/ai/shared.md b/ai/shared.md
index 71256ea..cc85dd1 100644
--- a/ai/shared.md
+++ b/ai/shared.md
@@ -24,6 +24,11 @@ guides (`backend-context.md`, `frontend-context.md`) extend these.
   possible - do not split lines unnecessarily
 - Variable names: use explicit, descriptive names - never single-letter or
   abbreviated variables (e.g. `$text` not `$t`, `$node` not `$n`)
+- Method/function/constructor parameters: do not use default values - every
+  call site must pass every argument explicitly. This eliminates a class of
+  bugs where an unintended default silently slips through (e.g. an
+  `isAdmin=false` or an empty `passwordHash`). Apply the same rule in tests
+  and fakes - if a helper accepts a value, every caller must supply it.
 - First, explore the codebase to understand existing patterns - look at similar
   files for reference before writing anything
 - Never use em dashes (—) in code, comments, or docblocks - use hyphens (-)

From c9f13794966e4d4b90fb5841232f6a2de1d3c0d0 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:05:07 +0300
Subject: [PATCH 21/34] remove default values from test helpers

---
 .../ScheduledNodeControllerTest.php           | 29 ++++++++++++++-----
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/tests/e2e/Controllers/ScheduledNodeControllerTest.php b/tests/e2e/Controllers/ScheduledNodeControllerTest.php
index c5f7b1c..0ff0766 100644
--- a/tests/e2e/Controllers/ScheduledNodeControllerTest.php
+++ b/tests/e2e/Controllers/ScheduledNodeControllerTest.php
@@ -50,7 +50,7 @@ class ScheduledNodeControllerTest extends TestCase
 
     private function makeRequest(
         ?string $date,
-        ?User $user = null,
+        ?User $user,
     ): ServerRequestInterface {
         $request = new ServerRequestFactory()
             ->createServerRequest(
@@ -69,8 +69,8 @@ class ScheduledNodeControllerTest extends TestCase
     private function seedScheduledNode(
         User $user,
         string $date,
-        string $planName = 'My reading plan',
-        string $nodeTitle = 'Bereishis',
+        string $planName,
+        string $nodeTitle,
     ): void {
         $plan = $this->planRepo->create(new CreatePlanDto(
             name: $planName,
@@ -90,7 +90,12 @@ class ScheduledNodeControllerTest extends TestCase
 
     public function test_returns_200_with_scheduled_nodes_for_user(): void
     {
-        $this->seedScheduledNode($this->user, '2025-01-02');
+        $this->seedScheduledNode(
+            $this->user,
+            '2025-01-02',
+            'My reading plan',
+            'Bereishis',
+        );
 
         $response = $this->controller->getScheduledNodes(
             $this->makeRequest('2025-01-02', $this->user),
@@ -131,7 +136,7 @@ class ScheduledNodeControllerTest extends TestCase
     public function test_returns_401_when_no_user_attribute(): void
     {
         $response = $this->controller->getScheduledNodes(
-            $this->makeRequest('2025-01-02'),
+            $this->makeRequest('2025-01-02', null),
             new Response(),
             $this->getTodaysSchedule,
         );
@@ -154,7 +159,12 @@ class ScheduledNodeControllerTest extends TestCase
 
     public function test_excludes_future_scheduled_nodes(): void
     {
-        $this->seedScheduledNode($this->user, '2025-01-10');
+        $this->seedScheduledNode(
+            $this->user,
+            '2025-01-10',
+            'My reading plan',
+            'Bereishis',
+        );
 
         $response = $this->controller->getScheduledNodes(
             $this->makeRequest('2025-01-02', $this->user),
@@ -168,7 +178,12 @@ class ScheduledNodeControllerTest extends TestCase
 
     public function test_excludes_completed_scheduled_nodes(): void
     {
-        $this->seedScheduledNode($this->user, '2025-01-02');
+        $this->seedScheduledNode(
+            $this->user,
+            '2025-01-02',
+            'My reading plan',
+            'Bereishis',
+        );
         $stored = $this->scheduledNodeRepo->find(0);
         $stored->setCompleted(true);
         $this->scheduledNodeRepo->update($stored);

From 4e2904a2b4ecb6d4c9b32f55849a386c484eb0a6 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:17:10 +0300
Subject: [PATCH 22/34] test get todays schedule null date

---
 .../UseCases/GetTodaysScheduleTest.php              | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index 013bc64..0878867 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -2,6 +2,7 @@
 
 namespace Tests\Unit\ScheduledNode\UseCases;
 
+use App\Exceptions\BadRequestException;
 use App\Node\Node;
 use App\Plan\CreatePlanDto;
 use App\ScheduledNode\CreateScheduledNodeDto;
@@ -12,6 +13,7 @@ use App\Text\Text;
 use App\User\UseCases\CreateUserDto;
 use App\ValueObjects\EmailAddress;
 use DateTimeImmutable;
+use DomainException;
 use PHPUnit\Framework\TestCase;
 use Tests\Fakes\FakePlanRepository;
 use Tests\Fakes\FakeScheduledNodeRepository;
@@ -111,4 +113,15 @@ class GetTodaysScheduleTest extends TestCase
         ));
         $this->assertEquals(1, count($result));
     }
+
+    public function test_throws_if_date_is_null(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage('date is required');
+
+        $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: null,
+            userId: 0,
+        ));
+    }
 }

From f0fd076fb93d1c153092566928ec05ba2a86eebe Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:17:24 +0300
Subject: [PATCH 23/34] validate get todays schedule date

---
 app/ScheduledNode/UseCases/GetTodaysSchedule.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/app/ScheduledNode/UseCases/GetTodaysSchedule.php b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
index 12ff902..a2835d1 100644
--- a/app/ScheduledNode/UseCases/GetTodaysSchedule.php
+++ b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
@@ -2,6 +2,7 @@
 
 namespace App\ScheduledNode\UseCases;
 
+use App\Exceptions\BadRequestException;
 use App\ScheduledNode\ScheduledNode;
 use App\ScheduledNode\ScheduledNodeRepository;
 use App\User\UserRepository;
@@ -16,9 +17,14 @@ class GetTodaysSchedule
 
     /**
      * @return ScheduledNode[]
+     *
+     * @throws BadRequestException
      */
     public function execute(GetTodaysScheduleRequest $request): array
     {
+        if ($request->date === null) {
+            throw new BadRequestException('date is required');
+        }
         $date = new DateTimeImmutable($request->date);
         $userId = $request->userId;
         $user = $this->userRepo->find($userId);

From 6d0b5d61e1f1876bba51f4ae2184fc8a6bad797e Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:17:38 +0300
Subject: [PATCH 24/34] test get todays schedule null user id

---
 .../ScheduledNode/UseCases/GetTodaysScheduleTest.php  | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index 0878867..207a33c 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -124,4 +124,15 @@ class GetTodaysScheduleTest extends TestCase
             userId: 0,
         ));
     }
+
+    public function test_throws_if_user_id_is_null(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage('userId is required');
+
+        $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: '2025-01-02',
+            userId: null,
+        ));
+    }
 }

From 120e5ee9a10a2d5afc1052fb6fe073132be8420c Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:17:49 +0300
Subject: [PATCH 25/34] validate get todays schedule user id

---
 app/ScheduledNode/UseCases/GetTodaysSchedule.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/app/ScheduledNode/UseCases/GetTodaysSchedule.php b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
index a2835d1..9645c72 100644
--- a/app/ScheduledNode/UseCases/GetTodaysSchedule.php
+++ b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
@@ -25,6 +25,9 @@ class GetTodaysSchedule
         if ($request->date === null) {
             throw new BadRequestException('date is required');
         }
+        if ($request->userId === null) {
+            throw new BadRequestException('userId is required');
+        }
         $date = new DateTimeImmutable($request->date);
         $userId = $request->userId;
         $user = $this->userRepo->find($userId);

From dd217e41425c1c6f564833c73417dbe5d827dbfb Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:18:02 +0300
Subject: [PATCH 26/34] test get todays schedule missing user

---
 .../ScheduledNode/UseCases/GetTodaysScheduleTest.php  | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index 207a33c..df88ba3 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -135,4 +135,15 @@ class GetTodaysScheduleTest extends TestCase
             userId: null,
         ));
     }
+
+    public function test_nonexistant_user_throws(): void
+    {
+        $this->expectException(DomainException::class);
+        $this->expectExceptionMessage('User with id: 99 doesnt exist');
+
+        $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: '2025-01-02',
+            userId: 99,
+        ));
+    }
 }

From c0f35c88b7061d762b9b42ebd01854b3836a6a6b Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:18:19 +0300
Subject: [PATCH 27/34] throw on missing user in get todays schedule

---
 app/ScheduledNode/UseCases/GetTodaysSchedule.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/app/ScheduledNode/UseCases/GetTodaysSchedule.php b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
index 9645c72..3301549 100644
--- a/app/ScheduledNode/UseCases/GetTodaysSchedule.php
+++ b/app/ScheduledNode/UseCases/GetTodaysSchedule.php
@@ -7,6 +7,7 @@ use App\ScheduledNode\ScheduledNode;
 use App\ScheduledNode\ScheduledNodeRepository;
 use App\User\UserRepository;
 use DateTimeImmutable;
+use DomainException;
 
 class GetTodaysSchedule
 {
@@ -19,6 +20,7 @@ class GetTodaysSchedule
      * @return ScheduledNode[]
      *
      * @throws BadRequestException
+     * @throws DomainException
      */
     public function execute(GetTodaysScheduleRequest $request): array
     {
@@ -31,6 +33,11 @@ class GetTodaysSchedule
         $date = new DateTimeImmutable($request->date);
         $userId = $request->userId;
         $user = $this->userRepo->find($userId);
+        if ($user === null) {
+            throw new DomainException(
+                "User with id: $userId doesnt exist"
+            );
+        }
         $scheduledNodes = $this->scheduledNodeRepo->findByUser($user);
 
         return array_filter(

From 54e33f9b03d4c7650d0166b08ad2a24d0d9cf827 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:18:32 +0300
Subject: [PATCH 28/34] test empty schedule returns empty array

---
 .../UseCases/GetTodaysScheduleTest.php          | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index df88ba3..0f60804 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -146,4 +146,21 @@ class GetTodaysScheduleTest extends TestCase
             userId: 99,
         ));
     }
+
+    public function test_returns_empty_array_when_user_has_no_scheduled_nodes(): void
+    {
+        $otherUser = $this->userRepo->create(new CreateUserDto(
+            email: new EmailAddress('other@email.com'),
+            passwordHash: 'hash',
+            isAdmin: false,
+        ));
+
+        $result = $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: '2025-01-02',
+            userId: $otherUser->getId(),
+        ));
+
+        $this->assertIsArray($result);
+        $this->assertEquals(0, count($result));
+    }
 }

From 3711840669bb97b4bd696a37d99c9c47898adc4a Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:18:47 +0300
Subject: [PATCH 29/34] test exclude future scheduled nodes

---
 .../UseCases/GetTodaysScheduleTest.php        | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index 0f60804..f8a64b3 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -163,4 +163,25 @@ class GetTodaysScheduleTest extends TestCase
         $this->assertIsArray($result);
         $this->assertEquals(0, count($result));
     }
+
+    public function test_excludes_scheduled_nodes_dated_after_today(): void
+    {
+        $this->scheduledNodeRepo->create(new CreateScheduledNodeDto(
+            date: new DateTimeImmutable('2025-01-05'),
+            plan: $this->planRepo->find(0),
+            node: new Node(
+                id: 0,
+                title: 'future node',
+                text: new Text(id: 0, name: 'test text'),
+                parentNode: null,
+            ),
+        ));
+
+        $result = $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: '2025-01-02',
+            userId: 0,
+        ));
+
+        $this->assertEquals(1, count($result));
+    }
 }

From 2eafe67f31eb23bbe893a3e3e0b2f762fa20e4b7 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:19:03 +0300
Subject: [PATCH 30/34] test scope schedule to requesting user

---
 .../UseCases/GetTodaysScheduleTest.php        | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
index f8a64b3..359b632 100644
--- a/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
+++ b/tests/Unit/ScheduledNode/UseCases/GetTodaysScheduleTest.php
@@ -184,4 +184,39 @@ class GetTodaysScheduleTest extends TestCase
 
         $this->assertEquals(1, count($result));
     }
+
+    public function test_does_not_return_other_users_scheduled_nodes(): void
+    {
+        $otherUser = $this->userRepo->create(new CreateUserDto(
+            email: new EmailAddress('other@email.com'),
+            passwordHash: 'hash',
+            isAdmin: false,
+        ));
+        $otherPlan = $this->planRepo->create(new CreatePlanDto(
+            name: 'other plan',
+            user: $otherUser,
+        ));
+        $this->scheduledNodeRepo->create(new CreateScheduledNodeDto(
+            date: new DateTimeImmutable('2025-01-02'),
+            plan: $otherPlan,
+            node: new Node(
+                id: 0,
+                title: 'other node',
+                text: new Text(id: 0, name: 'test text'),
+                parentNode: null,
+            ),
+        ));
+
+        $result = $this->useCase->execute(new GetTodaysScheduleRequest(
+            date: '2025-01-02',
+            userId: 0,
+        ));
+
+        $this->assertEquals(1, count($result));
+        $resultNode = array_values($result)[0];
+        $this->assertEquals(
+            0,
+            $resultNode->getPlan()->getUser()->getId()
+        );
+    }
 }

From 659f9b88f190affe8dbe220ce58ac422e7b4053a Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:24:43 +0300
Subject: [PATCH 31/34] test scheduled node controller surfaces date error from
 use case

---
 .../Controllers/ScheduledNodeControllerTest.php   | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/tests/e2e/Controllers/ScheduledNodeControllerTest.php b/tests/e2e/Controllers/ScheduledNodeControllerTest.php
index 0ff0766..085a6d8 100644
--- a/tests/e2e/Controllers/ScheduledNodeControllerTest.php
+++ b/tests/e2e/Controllers/ScheduledNodeControllerTest.php
@@ -155,6 +155,21 @@ class ScheduledNodeControllerTest extends TestCase
         $this->assertEquals(400, $response->getStatusCode());
         $body = json_decode((string) $response->getBody(), true);
         $this->assertArrayHasKey('error', $body);
+        $this->assertEquals('date is required', $body['error']);
+    }
+
+    public function test_returns_400_when_date_query_param_empty_string(): void
+    {
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest('', $this->user),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $this->assertEquals(400, $response->getStatusCode());
+        $body = json_decode((string) $response->getBody(), true);
+        $this->assertArrayHasKey('error', $body);
+        $this->assertEquals('date is required', $body['error']);
     }
 
     public function test_excludes_future_scheduled_nodes(): void

From f315db6d00c230e044a16e96c88fffb0016284bb Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:25:00 +0300
Subject: [PATCH 32/34] wrap get todays schedule in try catch

---
 app/ScheduledNode/ScheduledNodeController.php | 30 +++++++++++++------
 1 file changed, 21 insertions(+), 9 deletions(-)

diff --git a/app/ScheduledNode/ScheduledNodeController.php b/app/ScheduledNode/ScheduledNodeController.php
index 282f381..3a71ccb 100644
--- a/app/ScheduledNode/ScheduledNodeController.php
+++ b/app/ScheduledNode/ScheduledNodeController.php
@@ -2,9 +2,11 @@
 
 namespace App\ScheduledNode;
 
+use App\Exceptions\BadRequestException;
 use App\ScheduledNode\UseCases\GetTodaysSchedule;
 use App\ScheduledNode\UseCases\GetTodaysScheduleRequest;
 use App\User\User;
+use DomainException;
 use Psr\Http\Message\ResponseInterface as Response;
 use Psr\Http\Message\ServerRequestInterface as Request;
 
@@ -26,21 +28,31 @@ class ScheduledNodeController
 
         $queryParams = $request->getQueryParams();
         $date = $queryParams['date'] ?? null;
-        if ($date === null || $date === '') {
+        if ($date === '') {
+            $date = null;
+        }
+
+        try {
+            $scheduledNodes = $getTodaysSchedule->execute(
+                new GetTodaysScheduleRequest(
+                    date: $date,
+                    userId: $user->getId(),
+                )
+            );
+        } catch (BadRequestException $exception) {
             $response->getBody()->write(
-                json_encode(['error' => 'date is required'])
+                json_encode(['error' => $exception->getMessage()])
             );
             return $response->withStatus(400)
                 ->withHeader('Content-Type', 'application/json');
+        } catch (DomainException $exception) {
+            $response->getBody()->write(
+                json_encode(['error' => $exception->getMessage()])
+            );
+            return $response->withStatus(404)
+                ->withHeader('Content-Type', 'application/json');
         }
 
-        $scheduledNodes = $getTodaysSchedule->execute(
-            new GetTodaysScheduleRequest(
-                date: $date,
-                userId: $user->getId(),
-            )
-        );
-
         $data = array_values(array_map(
             function (ScheduledNode $scheduledNode) {
                 return [

From ed4440eec2e573271d60c2fb929b5ad8970efaf8 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:25:24 +0300
Subject: [PATCH 33/34] test scheduled node controller returns 404 when user
 missing

---
 .../ScheduledNodeControllerTest.php           | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/tests/e2e/Controllers/ScheduledNodeControllerTest.php b/tests/e2e/Controllers/ScheduledNodeControllerTest.php
index 085a6d8..0a7c57e 100644
--- a/tests/e2e/Controllers/ScheduledNodeControllerTest.php
+++ b/tests/e2e/Controllers/ScheduledNodeControllerTest.php
@@ -225,4 +225,28 @@ class ScheduledNodeControllerTest extends TestCase
         $body = json_decode((string) $response->getBody(), true);
         $this->assertEquals([], $body);
     }
+
+    public function test_returns_404_when_use_case_throws_domain_exception(): void
+    {
+        $unknownUser = new User(
+            id: 999,
+            email: new EmailAddress('ghost@test.com'),
+            passwordHash: '',
+            isAdmin: false,
+        );
+
+        $response = $this->controller->getScheduledNodes(
+            $this->makeRequest('2025-01-02', $unknownUser),
+            new Response(),
+            $this->getTodaysSchedule,
+        );
+
+        $this->assertEquals(404, $response->getStatusCode());
+        $body = json_decode((string) $response->getBody(), true);
+        $this->assertArrayHasKey('error', $body);
+        $this->assertEquals(
+            'User with id: 999 doesnt exist',
+            $body['error']
+        );
+    }
 }

From 7091eefd4a84fed5eb6e25076bf858a3e3534016 Mon Sep 17 00:00:00 2001
From: Yisroel Baum <yisroel.d.baum@gmail.com>
Date: Fri, 1 May 2026 10:52:56 +0300
Subject: [PATCH 34/34] add caveman ai plugin config

---
 caveman.json | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 caveman.json

diff --git a/caveman.json b/caveman.json
new file mode 100644
index 0000000..fb19545
--- /dev/null
+++ b/caveman.json
@@ -0,0 +1,9 @@
+{
+  "enabled": true,
+  "defaultMode": "full",
+  "features": {
+    "caveman": true,
+    "commit": ,
+    "review": true
+  }
+}