timeline serve defaults to port 8893, which Parts Search's dock app uses

Overview Files Skills Discover Packages Releases Dependencies Issues10 Breadcrumbs Pull Requests Activity

Closed PR #94 released in 0.2.75 on 11 Nov 2026 bug report

Glenn Jones · 3d ago ·closed by Colby Knox

What happens

adom-aiflow timeline serve defaults to port 8893, the port Adom Parts Search's dock app uses (adom-parts-search app --port 8893). When an AI Flow timeline is already running, clicking the Parts Search card in the Hydrogen Dock Bar can't get its port, so Parts Search won't open.

It has happened often since I started using Hydrogen: whenever an AI Flow run is open, Parts Search is unavailable until I find and move the timeline server.

Seen today (2026-11-11)

adom-aiflow timeline serve --run .../aiflow/run --port 8893, running since 09:10, holds 8893.
~/.adom/parts-search-server.json records Parts Search 2.1.2 on http://127.0.0.1:8893/. That process is gone, and the dock card can't restart it on 8893.
adom-aiflow timeline serve --help shows --port <PORT> [default: 8893].

I first hit this on 2026-10-31 on the 772 power module (LM251772) project and moved that run's timeline to 8895 by hand. It came back on a second project's run.

Suggested fix

Change the timeline's default to a port no Adom dock app uses, or pick a free port when none is given, and print or record the URL it chose.
At the least, check whether the port is already taken before binding, and refuse with a hint that names who holds it and suggests --port.
A shared registry of the ports Adom apps reserve would stop the next app from colliding too.

1 Reply

Colby Knox marked this in progress · 3d ago

Colby Knox linked pull request #94, which closes this when it merges · 3d ago

Colby Knox closed this in pull request #94 · 3d ago

Colby Knox · 3d ago

Thanks Glenn, and sorry it kept getting in your way. Fixed in AI Flow 0.2.75:

New ports. The run's timeline now uses 18893 to 18993, clear of the 88xx ports Adom's dock apps use, so it no longer takes Parts Search's 8893. timeline serve defaults to 18893.
Runs that already had 8893. A run that saved 8893 (or another port in the old range) doesn't take it again. If its own timeline server is still running there, AI Flow checks that it really is this run's, stops it, starts it again in the new range, and points the run's tab at the new address. No hunting needed: the next AI Flow command on that run moves it.
When a port is taken. If you pass a --port that's taken, the error now names the program holding it and suggests another port.

Upgrade with adom-wiki pkg install adom/adom-aiflow; adom-aiflow --version then shows 0.2.75. If Parts Search is still blocked right after upgrading, run any AI Flow command on the open run (or adom-aiflow timeline close) to move the old server, then click the Parts Search card again.