dirtydishes/islandflow
1
0
Fork 0
Code Issues 2 Pull requests 4 Projects Releases Packages Wiki Activity Actions 1

update docs pages redirect target url
Some checks are pending
Discord notifications / Push -> Discord (main) (push) Waiting to run
Details
Discord notifications / CI result -> Discord (red on failure) (push) Waiting to run
Details
Discord notifications / Release -> Discord (lavender) (push) Waiting to run
Details
Publish Docs / build (push) Waiting to run
Details
Publish Docs / deploy (push) Blocked by required conditions
Details

Browse source
This commit is contained in:
dirtydishes 2026-05-23 17:19:01 -04:00
parent 8464287c0c
commit 3d31469867
3 changed files with 136 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

2
.beads/issues.jsonl
View file

@ -21,6 +21,8 @@
{"_type":"issue","id":"islandflow-ayo","title":"Drop stale backlog events from live fanout","description":"Follow-up to live freshness rollout: /ws/live was still fanning out stale backlog events for freshness-gated channels, which kept tape panes in Live feed behind despite active synthetic ingest. Gate fanout and cache ingest by freshness for options/nbbo/equities/flow.","status":"closed","priority":1,"issue_type":"bug","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-04-28T21:26:39Z","created_by":"dirtydishes","updated_at":"2026-04-28T21:26:44Z","started_at":"2026-04-28T21:26:44Z","closed_at":"2026-04-28T21:26:44Z","close_reason":"Completed","dependency_count":0,"dependent_count":0,"comment_count":0}
{"_type":"issue","id":"islandflow-0v6","title":"Fix tape freshness, NBBO coverage, pause controls, and filter popup","description":"Implement the tape fixes requested for synthetic options notional sizing, strict live freshness, live-mode pause/resume behavior, stronger NBBO snapshot coverage, and moving flow filters behind a popup. Includes server-side live cache changes, web terminal state/UI changes, and tests for synthetic pricing, live snapshot freshness/NBBO retention, and live pause/filter interactions.","status":"closed","priority":1,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-04-28T21:02:52Z","created_by":"dirtydishes","updated_at":"2026-04-28T21:13:38Z","started_at":"2026-04-28T21:02:57Z","closed_at":"2026-04-28T21:13:38Z","close_reason":"Completed","dependency_count":0,"dependent_count":0,"comment_count":0}
{"_type":"issue","id":"islandflow-e4r","title":"Implement smart-money flow filtering and synthetic firehose modes","description":"Implement the approved multi-surface plan for named synthetic market profiles, options raw-vs-signal filtering, live/API filter contracts, Tape page client-side flow filters, firehose-readiness improvements, tests, and README updates.","status":"closed","priority":1,"issue_type":"feature","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-04-28T20:10:49Z","created_by":"dirtydishes","updated_at":"2026-04-28T20:29:29Z","started_at":"2026-04-28T20:10:53Z","closed_at":"2026-04-28T20:29:29Z","close_reason":"Implemented synthetic market profiles, options signal-path filtering, signal-aware API/replay contracts, Tape page filters, tests, and README updates. Follow-up tracked in islandflow-biq.","dependency_count":0,"dependent_count":0,"comment_count":0}
{"_type":"issue","id":"islandflow-t8b","title":"Update GitHub Pages docs URL target","description":"Adjust the docs Pages publish workflow so the deployed landing behavior explicitly targets dirtydishes.github.io/islandflow/docs and keeps the docs payload path consistent.","status":"closed","priority":2,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-05-23T21:18:04Z","created_by":"dirtydishes","updated_at":"2026-05-23T21:18:59Z","started_at":"2026-05-23T21:18:06Z","closed_at":"2026-05-23T21:18:59Z","close_reason":"Closed","dependency_count":0,"dependent_count":0,"comment_count":0}
{"_type":"issue","id":"islandflow-kgu","title":"Reconcile PR #8 branch with current main","description":"Why this issue exists and what needs to be done: user requested reconciliation for PR #8. Identify the PR #8 branch, merge/rebase with current main, resolve conflicts, validate, and push the updated branch so the PR can merge cleanly.","status":"closed","priority":2,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-05-23T20:14:36Z","created_by":"dirtydishes","updated_at":"2026-05-23T20:24:29Z","started_at":"2026-05-23T20:14:39Z","closed_at":"2026-05-23T20:24:29Z","close_reason":"Closed","dependency_count":0,"dependent_count":0,"comment_count":0}
{"_type":"issue","id":"islandflow-l9h","title":"stop persisting non-signal option prints in clickhouse","description":"Why: non-signal option prints are storage noise and should not be persisted by default.\\n\\nWhat: add OPTIONS_PERSIST_SIGNAL_ONLY env flag (default true), gate option_print inserts in ingest-options, add tests for persistence behavior, update env examples, and document one-off cleanup SQL for existing non-signal rows.","status":"closed","priority":2,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-05-23T03:02:32Z","created_by":"dirtydishes","updated_at":"2026-05-23T03:06:34Z","started_at":"2026-05-23T03:02:35Z","closed_at":"2026-05-23T03:06:34Z","close_reason":"Closed","dependency_count":0,"dependent_count":0,"comment_count":0}
{"_type":"issue","id":"islandflow-2cj","title":"Add Forgejo-first agent workflow guidance to AGENTS.md","description":"Why this issue exists and what needs to be done:\\n- The repository’s canonical home is Forgejo at git.deltaisland.io, but AGENTS.md does not currently direct agents to prefer Forgejo-specific workflows.\\n- Update AGENTS.md so agents treat Forgejo as primary and use the fj CLI for pull request workflows.\\n- Keep existing Beads and completion instructions intact while clarifying remote preference and command usage.","status":"closed","priority":2,"issue_type":"task","owner":"dishes@dpdrm.com","created_at":"2026-05-23T02:51:31Z","created_by":"dirtydishes","updated_at":"2026-05-23T02:55:42Z","closed_at":"2026-05-23T02:55:42Z","close_reason":"Closed","dependency_count":0,"dependent_count":0,"comment_count":0}
{"_type":"issue","id":"islandflow-xc5","title":"One-time bidirectional git remote backfill between github and forgejo","description":"Perform a one-time sync so github and forgejo contain the same branch/tag refs and historical commits, including pre-transition github history and newer forgejo commits. Document exact commands and validation results.","status":"closed","priority":2,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-05-21T01:25:05Z","created_by":"dirtydishes","updated_at":"2026-05-21T01:26:19Z","started_at":"2026-05-21T01:25:16Z","closed_at":"2026-05-21T01:26:19Z","close_reason":"Closed","dependency_count":0,"dependent_count":0,"comment_count":0}

2
.github/workflows/docs-pages.yml vendored
View file

@ -36,7 +36,7 @@ jobs:
run: |
mkdir -p site/docs
cp -R docs/. site/docs/
printf '%s\n' '<!doctype html><meta charset="utf-8"><meta http-equiv="refresh" content="0; url=./docs/"><title>Islandflow Docs</title><a href="./docs/">Continue to docs</a>' > site/index.html
printf '%s\n' '<!doctype html><meta charset="utf-8"><meta http-equiv="refresh" content="0; url=https://dirtydishes.github.io/islandflow/docs/"><title>Islandflow Docs</title><a href="https://dirtydishes.github.io/islandflow/docs/">Continue to docs</a>' > site/index.html
touch site/.nojekyll
- name: Upload Pages artifact

133
docs/turns/2026-05-23-update-github-pages-docs-target.html Normal file
View file

@ -0,0 +1,133 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Turn Report - Update GitHub Pages Docs Target</title>
<style>
:root {
--bg: #f7f8fc;
--card: #ffffff;
--text: #1c2434;
--muted: #5b667d;
--line: #d8dfeb;
--accent: #0f766e;
}
* { box-sizing: border-box; }
body {
margin: 0;
font-family: "Inter", "Segoe UI", sans-serif;
color: var(--text);
background: var(--bg);
line-height: 1.55;
}
main {
max-width: 920px;
margin: 0 auto;
padding: 28px 16px 40px;
}
h1 { margin: 0 0 8px; font-size: clamp(1.5rem, 2.2vw, 2rem); }
h2 { margin: 0 0 10px; font-size: 1.15rem; }
.meta { margin: 0 0 18px; color: var(--muted); }
section {
background: var(--card);
border: 1px solid var(--line);
border-radius: 10px;
padding: 14px 16px;
margin: 0 0 12px;
}
ul { margin: 0; padding-left: 20px; }
li + li { margin-top: 6px; }
p { margin: 0; }
p + p { margin-top: 8px; }
code {
font-family: "IBM Plex Mono", "SFMono-Regular", Consolas, monospace;
font-size: 0.92em;
}
pre {
margin: 8px 0 0;
background: #0f172a;
color: #e2e8f0;
border: 1px solid #1e293b;
border-radius: 8px;
padding: 12px;
overflow-x: auto;
}
a { color: var(--accent); }
</style>
</head>
<body>
<main>
<h1>Update GitHub Pages docs target URL</h1>
<p class="meta">Completed on May 23, 2026.</p>
<section>
<h2>Summary</h2>
<p>Updated the GitHub Pages workflow so the generated root landing page now redirects explicitly to <code>https://dirtydishes.github.io/islandflow/docs/</code>.</p>
</section>
<section>
<h2>Changes Made</h2>
<ul>
<li>Edited <code>.github/workflows/docs-pages.yml</code>.</li>
<li>Changed the root <code>site/index.html</code> meta-refresh and fallback link from a relative <code>./docs/</code> target to an absolute Pages URL target.</li>
</ul>
</section>
<section>
<h2>Context</h2>
<p>The existing docs Pages workflow already copied repository docs into <code>site/docs/</code>. The requested update was to ensure the published root route consistently forwards to the canonical project URL <code>dirtydishes.github.io/islandflow/docs</code>.</p>
</section>
<section>
<h2>Important Implementation Details</h2>
<ul>
<li>Deployment artifact structure remains unchanged: docs are still published under <code>site/docs/</code>.</li>
<li>Only the redirect target changed, minimizing risk of deployment regressions.</li>
<li>Fallback anchor text now points to the same absolute URL as the redirect destination.</li>
</ul>
</section>
<section>
<h2>Relevant Diff Snippets</h2>
<p>Snippet style follows <a href="https://diffs.com/docs">diffs.com</a> formatting conventions.</p>
<pre><code class="language-diff">--- .github/workflows/docs-pages.yml
+++ .github/workflows/docs-pages.yml
@@
-printf '%s\n' '&lt;!doctype html&gt;... url=./docs/...&lt;a href="./docs/"&gt;Continue to docs&lt;/a&gt;' &gt; site/index.html
+printf '%s\n' '&lt;!doctype html&gt;... url=https://dirtydishes.github.io/islandflow/docs/...&lt;a href="https://dirtydishes.github.io/islandflow/docs/"&gt;Continue to docs&lt;/a&gt;' &gt; site/index.html</code></pre>
</section>
<section>
<h2>Expected Impact for End-Users</h2>
<ul>
<li>Visiting the Pages root now consistently routes users to <code>/islandflow/docs/</code> on the canonical host.</li>
<li>Users get a stable docs destination regardless of relative path behavior.</li>
</ul>
</section>
<section>
<h2>Validation</h2>
<ul>
<li>Reviewed workflow diff to confirm only redirect target changed.</li>
<li>Attempted to run <code>bunx actionlint .github/workflows/docs-pages.yml</code>, but the package executable could not be resolved in this environment.</li>
</ul>
</section>
<section>
<h2>Issues, Limitations, and Mitigations</h2>
<ul>
<li>Absolute URL redirect is now tied to the current canonical host/path; if Pages host naming changes, this line must be updated.</li>
<li>No runtime workflow execution was performed locally; final validation occurs on next GitHub Actions run.</li>
</ul>
</section>
<section>
<h2>Follow-up Work</h2>
<ul>
<li>Add <code>actionlint</code> as a repo-managed dev tool or CI check so workflow linting is repeatable in local and CI environments.</li>
</ul>
</section>
</main>
</body>
</html>