Skip to content

[JM-10] Add a standalone pomodoro web app #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
jiamingz42 wants to merge 2 commits into from
+659 −5
Closed

[JM-10] Add a standalone pomodoro web app #21

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3603dcc
feat(http-server): add a standalone pomodoro page
jiamingz42 Mar 3, 2026
db97488
docs(http-server): document the pomodoro route
jiamingz42 Mar 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions SPEC.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1359,8 +1359,11 @@ If implemented:

- The HTTP server is an extension and is not required for conformance.
- The implementation may serve server-rendered HTML or a client-side application for the dashboard.
- The dashboard/API must be observability/control surfaces only and must not become required for
orchestrator correctness.
- The dashboard and `/api/v1/*` contract must remain observability/control surfaces only and must
not become required for orchestrator correctness.
- Implementations may expose additional explicitly optional routes (for example a self-contained
local demo at `/pomodoro`) as long as those routes stay separate from the dashboard/API contract
and are never required for orchestration.

Enablement (extension):

Expand All @@ -1383,6 +1386,8 @@ Enablement (extension):
retry delays, token consumption, runtime totals, recent events, and health/error indicators).
- It is up to the implementation whether this is server-generated HTML or a client-side app that
consumes the JSON API below.
- Additional implementation-specific HTML pages may exist at other routes, but they are optional
and outside the conformance surface defined in this section.

#### 13.7.2 JSON REST API (`/api/v1/*`)

Expand Down
5 changes: 3 additions & 2 deletions elixir/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,8 +125,9 @@ codex:
```

- If `WORKFLOW.md` is missing or has invalid YAML, startup and scheduling are halted until fixed.
- `server.port` or CLI `--port` enables the optional HTTP dashboard and JSON API at `/`,
`/api/v1/state`, `/api/v1/<issue_identifier>`, and `/api/v1/refresh`.
- `server.port` or CLI `--port` enables the optional HTTP dashboard plus pomodoro demo at `/`
and `/pomodoro`, alongside the JSON API at `/api/v1/state`, `/api/v1/<issue_identifier>`,
and `/api/v1/refresh`.

## Project Layout

Expand Down
Loading