-
Coverage
-
- News is now available alongside the repo’s existing live feeds, with shared symbol resolution and storage that
- make the data retrievable through API history endpoints.
-
+
+
Operators
+
Native deployment and rollback procedures now have first-class scripted and documented paths.
-
-
Current Boundary
-
- The UI copy in the news pane explicitly marks news as live-only in v1, so replay users should not expect the
- same behavior there yet.
-
+
+
Team reporting
+
This standup report now matches merged repository history instead of pre-merge branch-local history.
@@ -529,36 +454,27 @@ export function NewsRoute() {
Validation
- - Reviewed local git history with
git log --since='2026-05-18 00:00' --until='2026-05-19 00:00'.
- - Used
git log --stat, git show, and file-level history to anchor each summary item to specific commits and files.
- - No builds or tests were run for this reporting task because the work product is a git summary document, not a behavior change.
+ - Used
git fetch --all --prune before recomputing history.
+ - Used
git log --all over the May 18 ET window to include merged commits.
+ - Used
git log --stat --summary and --numstat to ground file and line-count statements.
+ - No build/test commands were run because this task only regenerates reporting documentation.
Issues, Limitations, and Mitigations
- -
- This report is grounded in local commit metadata only. No pull request identifiers were present in the inspected
- git history, so the summary references commits and files instead of PR numbers.
-
- -
- The
update beads commit touched only deployment/docker/workspace-root/package.json in
- visible git output, so this report does not infer intent beyond that recorded file change.
-
- -
- Counts here describe May 18 commits only and exclude any uncommitted work present after that date.
-
+ - This report describes commit history only and does not infer intent beyond commit messages and touched files.
+ - Commit
8f0794dd is timestamped in UTC; it still falls on May 18 in US/Eastern, so it is included.
+ - Metrics are based on local git history at regeneration time and can change if additional backdated commits appear.
Follow-up Work
- -
- No new product follow-up items were derived from this reporting pass. The only beads item created for this task
- is
islandflow-2df, which tracks publication of this summary document.
-
+ - This regeneration is tracked by beads issue
islandflow-0ty.
+ - No additional follow-up work was identified during this documentation-only task.
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..211c5ac
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,638 @@
+
+
+
+
+
+
Islandflow Docs
+
+
+
+
+
+
+
+
+
+
+ turns 28
+
+
+ -
+ turns/2026-05-19-publish-docs-pages-index.html
+
+ html
+ 6.7 KB
+ May 19, 2026, 2:59 PM
+
+
+
+
+ -
+ turns/2026-05-18-native-public-edge-cutover.html
+
+ html
+ 19 KB
+ May 19, 2026, 2:48 PM
+
+
+
+
+ -
+ turns/2026-05-19-reconcile-pr-conflicts.html
+
+ html
+ 9.8 KB
+ May 19, 2026, 2:48 PM
+
+
+
+
+ -
+ turns/2026-05-18-native-fast-iterative-deploy.html
+
+ html
+ 9.0 KB
+ May 19, 2026, 2:48 PM
+
+
+
+
+ -
+ turns/2026-05-19-0805-clarify-repo-turn-doc-rules.html
+
+ html
+ 6.4 KB
+ May 19, 2026, 8:05 AM
+
+
+
+
+ -
+ turns/2026-05-19-0739-update-readme-current-state.html
+
+ html
+ 9.8 KB
+ May 19, 2026, 7:39 AM
+
+
+
+
+ -
+ turns/2026-05-19-upgrade-nextjs-16.html
+
+ html
+ 9.0 KB
+ May 19, 2026, 7:31 AM
+
+
+
+
+ -
+ turns/2026-05-18-news-wire-view.html
+
+ html
+ 7.0 KB
+ May 18, 2026, 4:54 PM
+
+
+
+
+ -
+ turns/2026-05-17-forgejo-deploy-remote-resolution.html
+
+ html
+ 5.3 KB
+ May 17, 2026, 11:22 PM
+
+
+
+
+ -
+ turns/2026-05-17-add-fast-deploy-mode.html
+
+ html
+ 5.5 KB
+ May 17, 2026, 10:53 PM
+
+
+
+
+ -
+ turns/2026-05-17-1101-clickhouse-alert-context.html
+
+ html
+ 6.4 KB
+ May 17, 2026, 10:21 PM
+
+
+
+
+ -
+ turns/2026-05-17-clickhouse-alert-context.html
+
+ html
+ 11 KB
+ May 17, 2026, 10:21 PM
+
+
+
+
+ -
+ turns/2026-05-17-deploy-allowlist-pr-packaging.html
+
+ html
+ 5.2 KB
+ May 17, 2026, 10:21 PM
+
+
+
+
+ -
+ turns/2026-05-17-configure-beads-dolt-remote.html
+
+ html
+ 7.7 KB
+ May 17, 2026, 10:07 AM
+
+
+
+
+ -
+ turns/2026-05-16-live-tape-scroll-hold-history.html
+
+ html
+ 6.3 KB
+ May 17, 2026, 5:06 AM
+
+
+
+
+ -
+ turns/2026-05-17-0331-fix-live-tape-scroll-stability.html
+
+ html
+ 5.6 KB
+ May 17, 2026, 5:06 AM
+
+
+
+
+ -
+ turns/2026-05-16-1725-durable-options-tape-history.html
+
+ html
+ 7.5 KB
+ May 17, 2026, 5:06 AM
+
+
+
+
+ -
+ turns/2026-05-16-1752-speed-up-docker-deploys.html
+
+ html
+ 7.9 KB
+ May 17, 2026, 5:06 AM
+
+
+
+
+ -
+ turns/2026-05-16-2159-fix-durable-options-history-routing.html
+
+ html
+ 6.4 KB
+ May 17, 2026, 5:06 AM
+
+
+
+
+ -
+ turns/2026-05-15-add-duplicate-vps-compose-warning.html
+
+ html
+ 7.2 KB
+ May 15, 2026, 9:28 PM
+
+
+
+
+ -
+ turns/2026-05-15-clarify-docker-first-deploy-workflow.html
+
+ html
+ 6.5 KB
+ May 15, 2026, 9:12 PM
+
+
+
+
+ -
+ turns/2026-05-15-dual-runtime-deploy-workflow.html
+
+ html
+ 7.9 KB
+ May 15, 2026, 8:52 PM
+
+
+
+
+ -
+ turns/2026-05-15-deploy-preflight-docker-workspace-check.html
+
+ html
+ 3.6 KB
+ May 15, 2026, 7:03 PM
+
+
+
+
+ -
+ turns/2026-05-15-fix-docker-workspace-lockfile-sync.html
+
+ html
+ 3.6 KB
+ May 15, 2026, 6:56 PM
+
+
+
+
+ -
+ turns/2026-05-15-quiet-terminal-view.html
+
+ html
+ 5.3 KB
+ May 15, 2026, 6:55 PM
+
+
+
+
+ -
+ turns/2026-05-14-1824-adapt-terminal-view.html
+
+ html
+ 6.6 KB
+ May 15, 2026, 6:55 PM
+
+
+
+
+ -
+ turns/2026-05-14-1833-reconcile-pr-conflicts.html
+
+ html
+ 5.6 KB
+ May 15, 2026, 6:55 PM
+
+
+
+
+ -
+ turns/2026-05-14-harden-terminal-view.html
+
+ html
+ 9.2 KB
+ May 15, 2026, 6:55 PM
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ No files match that filter.
+
+
+
+
+
diff --git a/docs/turns/2026-05-19-harden-native-ssh-deploy-checks.html b/docs/turns/2026-05-19-harden-native-ssh-deploy-checks.html
new file mode 100644
index 0000000..7cee829
--- /dev/null
+++ b/docs/turns/2026-05-19-harden-native-ssh-deploy-checks.html
@@ -0,0 +1,191 @@
+
+
+
+
+
+
2026-05-19 Harden Native SSH Deploy Checks
+
+
+
+
+
+ Harden Native SSH Deploy Checks
+
+ Native deploys over SSH were failing for avoidable operator reasons: the remote shell did not inherit Bun's install path, and native verification assumed it was already running from the repository root before it called checked-in health scripts. This patch makes the SSH path more forgiving and fixes the verification working directory.
+
+ Generated 2026-05-19 19:38 EDT
+
+
+
+ Summary
+
+ Updated scripts/deploy.ts so native SSH deploys prepend $HOME/.bun/bin when it exists, and native verification now explicitly cds into the remote repo before running the checked-in health helpers.
+
+
+
+
+ Changes Made
+
+ - Prepended
$HOME/.bun/bin during native remote precheck when available.
+ - Prepended
$HOME/.bun/bin during native remote rollout when available.
+ - Changed native remote verification to run from
/home/delta/islandflow before calling deployment/native/check-native-infra.sh.
+
+
+
+
+ Context
+
+ During a live native rollout, the deploy helper failed first because the non-login SSH shell could not find bun even though it was installed under the deploy user's home directory. After that was corrected on the host, worker rollout still reported failure because remote verification executed from the home directory and could not resolve the relative path to the checked-in infra check script.
+
+
+
+
+ Important Implementation Details
+
+ - The fallback only adjusts
PATH when $HOME/.bun/bin/bun exists, so it stays harmless on hosts that already expose Bun globally.
+ - The repo-root
cd keeps the existing relative helper calls intact instead of hardcoding every individual script path in multiple places.
+ - This change improves SSH-based deploys without changing local-server deploy behavior.
+
+
+
+
+ Relevant Diff Snippets
+ Unified diff blocks below are formatted for diffs-compatible rendering.
+ diff --git a/scripts/deploy.ts b/scripts/deploy.ts
+@@ -754,6 +754,10 @@ set -euo pipefail
+
+ cd ${shellEscape(REMOTE_REPO)}
+
++if [[ -x "$HOME/.bun/bin/bun" ]]; then
++ export PATH="$HOME/.bun/bin:$PATH"
++fi
++
+ if ! command -v bun >/dev/null 2>&1; then
+
+@@ -855,6 +859,10 @@ set -euo pipefail
+
++if [[ -x "$HOME/.bun/bin/bun" ]]; then
++ export PATH="$HOME/.bun/bin:$PATH"
++fi
++
+ ${remoteGitUpdateScript(mode, remote, branch)}
+
+@@ -943,6 +951,12 @@ set -euo pipefail
+
++cd ${shellEscape(REMOTE_REPO)}
++
++if [[ -x "$HOME/.bun/bin/bun" ]]; then
++ export PATH="$HOME/.bun/bin:$PATH"
++fi
++
+ declare -a units=(${units})
+
+
+
+ Expected Impact for End-Users
+
+ End users should see fewer failed native deploy attempts and fewer partial restarts caused by tooling assumptions rather than application health. This lowers the odds of avoidable downtime during native rollouts.
+
+
+
+
+ Validation
+
+ - Observed the original failures during live rollout: missing
bun in SSH PATH and missing deployment/native/check-native-infra.sh during remote verification.
+ - Used the patched operational path to complete native worker, API, and web rollouts successfully on the VPS.
+ - Verified API health at
http://127.0.0.1:4000/health and web health at both http://127.0.0.1:3000/ and https://flow.deltaisland.io.
+
+
+
+
+ Issues, Limitations, and Mitigations
+
+ - This patch does not solve the separate
ingest-news credential problem. Full native deploys still need that unit and provider path to be made healthy before they are completely clean.
+ - The VPS also needed a host-level Bun symlink during this recovery. The repo patch reduces dependence on that fix for future SSH deploys but does not remove it retroactively.
+
+
+
+
+ Follow-up Work
+
+ islandflow-fmg: Keep the deploy helper aligned with the actual VPS runtime assumptions and add regression checks around native verification paths.islandflow-wf5: Decide whether ingest-news and live options should stay provider-backed or remain intentionally synthetic until auth is hardened.
+
+
+
+
diff --git a/docs/turns/2026-05-19-native-options-recovery-guardrails.html b/docs/turns/2026-05-19-native-options-recovery-guardrails.html
new file mode 100644
index 0000000..441ade2
--- /dev/null
+++ b/docs/turns/2026-05-19-native-options-recovery-guardrails.html
@@ -0,0 +1,183 @@
+
+
+
+
+
+
2026-05-19 Native Options Recovery Guardrails
+
+
+
+
+
+ Native Options Recovery Guardrails
+
+ The production outage turned out to be a native deployment config mismatch, not a data-pipeline code failure. I restored the VPS to the last known-good synthetic options adapter, then tightened the checked-in native deployment assets so they no longer imply a systemd override will beat the repo .env.
+
+ Generated 2026-05-19 19:24 EDT
+
+
+
+ Summary
+
+ The repo-side change is small and targeted: remove the misleading Environment=OPTIONS_INGEST_ADAPTER=synthetic line from the checked-in native ingest-options unit, and document that Bun-launched services effectively take adapter selection from /home/delta/islandflow/.env.
+
+
+
+
+ Changes Made
+
+ - Removed the checked-in systemd override from
deployment/native/systemd/user/islandflow-ingest-options.service.
+ - Added an explicit env-precedence warning to
deployment/native/README.md.
+ - Captured the live diagnosis that the native server had drifted to
OPTIONS_INGEST_ADAPTER=alpaca while the prior Docker deployment was running synthetic options.
+
+
+
+
+ Context
+
+ On the VPS, islandflow-ingest-options.service was crash-looping with repeated 401 Unauthorized responses from Alpaca while the rest of the native stack stayed healthy. The previous Docker-owned islandflow-vps-ingest-options-1 container showed OPTIONS_INGEST_ADAPTER=synthetic, which explains why the UI had been healthy before the runtime transition.
+
+
+
+
+ Important Implementation Details
+
+ - The checked-in unit already referenced
/home/delta/islandflow/.env, and Bun's runtime env loading meant a conflicting adapter value there still won in practice.
+ - The static key currently stored as
ALPACA_API_KEY does not authenticate the failing market-data snapshot request as a Bearer token.
+ - Because the real outage fix required a server-side
.env correction, this repo patch focuses on preventing operator confusion during the next native cutover.
+
+
+
+
+ Relevant Diff Snippets
+ Unified diff blocks below are formatted for diffs-compatible rendering.
+ diff --git a/deployment/native/README.md b/deployment/native/README.md
+@@ -98,6 +98,8 @@ These are written for the current VPS layout:
+ - Bun binary: `/home/delta/.bun/bin/bun`
+ - env file: `/home/delta/islandflow/.env`
+
++Important: treat `/home/delta/islandflow/.env` as the effective source of truth for adapter selection. The Bun-launched services read that file directly at runtime, so a conflicting `OPTIONS_INGEST_ADAPTER` value in `.env` can still win over a systemd-only override and push `ingest-options` onto the wrong provider path.
++
+ ### Install the units
+
+diff --git a/deployment/native/systemd/user/islandflow-ingest-options.service b/deployment/native/systemd/user/islandflow-ingest-options.service
+@@ -7,7 +7,6 @@ Wants=network-online.target
+ Type=simple
+ WorkingDirectory=/home/delta/islandflow
+ EnvironmentFile=/home/delta/islandflow/.env
+-Environment=OPTIONS_INGEST_ADAPTER=synthetic
+ ExecStart=/home/delta/.bun/bin/bun services/ingest-options/src/index.ts
+
+
+
+ Expected Impact for End-Users
+
+ End users should not see the options tape stall the next time native units are installed or audited by following the checked-in assets. Operators now have a clearer paper trail that the actual runtime adapter comes from the deployment env file.
+
+
+
+
+ Validation
+
+ - Verified the native outage mode on the VPS:
islandflow-ingest-options.service crash-looped on Alpaca 401 responses.
+ - Confirmed the previous Docker container had been running
OPTIONS_INGEST_ADAPTER=synthetic.
+ - After the server-side env fix, confirmed fresh rows in
default.option_prints and new compute emissions in the native logs.
+ - Ran
git diff to verify the repo change stayed scoped to the deployment README and the checked-in user unit.
+
+
+
+
+ Issues, Limitations, and Mitigations
+
+ - The repo patch does not add new credential support for Alpaca. It only documents the current env-precedence behavior and removes a misleading override.
+ - The live server is restored with synthetic options, which matches the last known-good Docker behavior, but it is not a true live Alpaca ingest path.
+
+
+
+
+ Follow-up Work
+
+ islandflow-wf5: Decide whether production options should remain synthetic or move to a fully supported live provider configuration.islandflow-wf5: If Alpaca live data is still desired, add a validated auth flow and a deploy-time smoke test that catches provider auth failures before cutover.
+
+
+
+
diff --git a/docs/turns/2026-05-19-publish-docs-pages-index.html b/docs/turns/2026-05-19-publish-docs-pages-index.html
new file mode 100644
index 0000000..9946b33
--- /dev/null
+++ b/docs/turns/2026-05-19-publish-docs-pages-index.html
@@ -0,0 +1,195 @@
+
+
+
+
+
+
Turn Report - Publish Docs to GitHub Pages
+
+
+
+
+ Publish docs/ to GitHub Pages with navigable index
+ Completed on May 19, 2026 at 9:38 AM ET.
+
+
+ Summary
+
+ Added an automated docs publishing flow to GitHub Pages and generated a new
+ docs/index.html browsing experience so docs are easy to navigate at
+ /islandflow/docs/.
+
+
+
+
+ Changes Made
+
+ - Added
scripts/generate-docs-index.mjs to build a browsable index of files under docs/.
+ - Added
.github/workflows/docs-pages.yml to publish docs to GitHub Pages on pushes to main.
+ - Generated
docs/index.html from current docs content.
+ - Configured deployment artifact layout so docs are available at
/docs/ under the project Pages site.
+
+
+
+
+ Context
+
+ The repository already stores operational and implementation documentation under
+ docs/, but there was no dedicated GitHub Pages pipeline and no curated
+ index page for discovery. This task focused on syncing that folder to Pages and
+ making it easy to browse by category and filename.
+
+
+
+
+ Important Implementation Details
+
+ - The index generator excludes hidden files and avoids self-including
docs/index.html.
+ - Files are grouped by first path segment (
turns, general, plans, and others) with quick category chips.
+ - The index includes client-side filtering so users can search docs by path text in-browser.
+ - Pages deployment packages a
site/ payload where docs are copied into site/docs and root redirects to ./docs/.
+
+
+
+
+ Relevant Diff Snippets
+
+ Snippets are shown in a compact style aligned with diffs.com presentation patterns.
+
+ +++ .github/workflows/docs-pages.yml
+name: Publish Docs
+on:
+ push:
+ branches: [main]
+ paths:
+ - "docs/**"
+ - "scripts/generate-docs-index.mjs"
+ - ".github/workflows/docs-pages.yml"
+ workflow_dispatch:
+
+jobs:
+ build:
+ steps:
+ - uses: actions/checkout@v4
+ - uses: actions/configure-pages@v5
+ - run: node scripts/generate-docs-index.mjs
+ - run: cp -R docs/. site/docs/
+ - uses: actions/upload-pages-artifact@v3
+ deploy:
+ needs: build
+ steps:
+ - uses: actions/deploy-pages@v4
+ +++ scripts/generate-docs-index.mjs
+const files = await collectDocsFiles(docsDir);
+const html = renderDocument(files);
+await fs.writeFile(outputFile, html, "utf8");
+
+// Generated index features:
+// - grouped sections
+// - search filter
+// - file size and modified time metadata
+// - links preserving docs folder structure
+
+
+
+ Expected Impact for End-Users
+
+ - Docs are reachable via a stable Pages URL path:
dirtydishes.github.io/islandflow/docs/.
+ - Readers can quickly scan categories and search by filename instead of relying on raw directory browsing.
+ - New docs added to the repository are published automatically on
main pushes.
+
+
+
+
+ Validation
+
+ - Ran
node scripts/generate-docs-index.mjs successfully.
+ - Ran
node --check scripts/generate-docs-index.mjs for syntax validation.
+ - Confirmed generated index contains expected navigation/search markers and category anchors.
+
+
+
+
+ Issues, Limitations, and Mitigations
+
+ - GitHub Pages must be enabled for this repository and set to GitHub Actions deployment.
+ - The index reflects files present at build time and does not include full-text search inside documents.
+ - Markdown files are linked as-is; rendering behavior depends on GitHub Pages static hosting behavior.
+
+
+
+
+ Follow-up Work
+
+ - Add a docs landing page summary for key collections (turn docs, runbooks, daily notes).
+ - Optionally add link-checking in CI for docs URLs and local references.
+ - Consider tagging docs with metadata for richer filtering by date, topic, and type.
+
+
+
+
+
diff --git a/scripts/deploy.ts b/scripts/deploy.ts
index e703c49..169f7a9 100644
--- a/scripts/deploy.ts
+++ b/scripts/deploy.ts
@@ -754,6 +754,10 @@ set -euo pipefail
cd ${shellEscape(REMOTE_REPO)}
+if [[ -x "$HOME/.bun/bin/bun" ]]; then
+ export PATH="$HOME/.bun/bin:$PATH"
+fi
+
if ! command -v bun >/dev/null 2>&1; then
echo "Refusing native rollout: bun is not installed on the server." >&2
echo "The current supported VPS path remains --runtime docker." >&2
@@ -855,6 +859,10 @@ function remoteNativeRollout(
`#!/usr/bin/env bash
set -euo pipefail
+if [[ -x "$HOME/.bun/bin/bun" ]]; then
+ export PATH="$HOME/.bun/bin:$PATH"
+fi
+
${remoteGitUpdateScript(mode, remote, branch)}
cd ${shellEscape(REMOTE_REPO)}
@@ -943,6 +951,12 @@ function remoteNativeVerification(scope: DeployScope, fast: boolean): void {
`#!/usr/bin/env bash
set -euo pipefail
+cd ${shellEscape(REMOTE_REPO)}
+
+if [[ -x "$HOME/.bun/bin/bun" ]]; then
+ export PATH="$HOME/.bun/bin:$PATH"
+fi
+
declare -a units=(${units})
for unit in "\${units[@]}"; do
${NATIVE_SYSTEMCTL_PREFIX} is-active --quiet "$unit"
diff --git a/scripts/generate-docs-index.mjs b/scripts/generate-docs-index.mjs
new file mode 100644
index 0000000..cf64a9d
--- /dev/null
+++ b/scripts/generate-docs-index.mjs
@@ -0,0 +1,421 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+
+const docsDir = path.resolve(process.cwd(), "docs");
+const outputFile = path.join(docsDir, "index.html");
+
+const dateFormatter = new Intl.DateTimeFormat("en-US", {
+ dateStyle: "medium",
+ timeStyle: "short",
+});
+
+function escapeHtml(value) {
+ return value
+ .replaceAll("&", "&")
+ .replaceAll("<", "<")
+ .replaceAll(">", ">")
+ .replaceAll('"', """)
+ .replaceAll("'", "'");
+}
+
+function formatBytes(bytes) {
+ if (bytes < 1024) {
+ return `${bytes} B`;
+ }
+
+ const units = ["KB", "MB", "GB"];
+ let size = bytes / 1024;
+ let unitIndex = 0;
+
+ while (size >= 1024 && unitIndex < units.length - 1) {
+ size /= 1024;
+ unitIndex += 1;
+ }
+
+ return `${size.toFixed(size >= 10 ? 0 : 1)} ${units[unitIndex]}`;
+}
+
+function docsHref(relativePath) {
+ const encoded = relativePath
+ .split("/")
+ .map((part) => encodeURIComponent(part))
+ .join("/");
+ return `./${encoded}`;
+}
+
+async function collectDocsFiles(rootDir, currentDir = rootDir, acc = []) {
+ const entries = await fs.readdir(currentDir, { withFileTypes: true });
+ const sortedEntries = entries.sort((a, b) => a.name.localeCompare(b.name));
+
+ for (const entry of sortedEntries) {
+ if (entry.name.startsWith(".")) {
+ continue;
+ }
+
+ const absolutePath = path.join(currentDir, entry.name);
+ const relativePath = path.relative(rootDir, absolutePath).replaceAll(path.sep, "/");
+
+ if (relativePath === "index.html") {
+ continue;
+ }
+
+ if (entry.isDirectory()) {
+ await collectDocsFiles(rootDir, absolutePath, acc);
+ continue;
+ }
+
+ if (entry.isFile()) {
+ const stats = await fs.stat(absolutePath);
+
+ acc.push({
+ relativePath,
+ category: relativePath.includes("/") ? relativePath.split("/")[0] : "root",
+ sizeBytes: stats.size,
+ modifiedAt: stats.mtime,
+ });
+ }
+ }
+
+ return acc;
+}
+
+function groupByCategory(items) {
+ const groups = new Map();
+ for (const item of items) {
+ if (!groups.has(item.category)) {
+ groups.set(item.category, []);
+ }
+ groups.get(item.category).push(item);
+ }
+ return groups;
+}
+
+function sortedCategories(groups) {
+ const preferredOrder = ["turns", "daily-git", "general", "plans", "root"];
+ const groupNames = [...groups.keys()];
+ return groupNames.sort((a, b) => {
+ const aIndex = preferredOrder.indexOf(a);
+ const bIndex = preferredOrder.indexOf(b);
+
+ if (aIndex !== -1 || bIndex !== -1) {
+ if (aIndex === -1) return 1;
+ if (bIndex === -1) return -1;
+ return aIndex - bIndex;
+ }
+
+ return a.localeCompare(b);
+ });
+}
+
+function renderDocument(items) {
+ const sortedItems = [...items].sort((a, b) => b.modifiedAt.getTime() - a.modifiedAt.getTime());
+ const groups = groupByCategory(sortedItems);
+ const categories = sortedCategories(groups);
+ const totalCount = sortedItems.length;
+
+ const categoryChips = categories
+ .map((category) => {
+ const count = groups.get(category).length;
+ return `
${escapeHtml(
+ category
+ )} ${count}`;
+ })
+ .join("\n");
+
+ const groupsMarkup = categories
+ .map((category) => {
+ const entries = groups.get(category);
+ const entryMarkup = entries
+ .map((entry) => {
+ const extension = path.extname(entry.relativePath).replace(".", "") || "file";
+ const searchable = `${entry.relativePath} ${category}`.toLowerCase();
+ return `
+
+ ${escapeHtml(
+ entry.relativePath
+ )}
+
+ ${escapeHtml(extension)}
+ ${escapeHtml(formatBytes(entry.sizeBytes))}
+ ${escapeHtml(dateFormatter.format(entry.modifiedAt))}
+
+
+ `;
+ })
+ .join("\n");
+
+ return `
+
+ ${escapeHtml(category)} ${entries.length}
+
+
+ `;
+ })
+ .join("\n");
+
+ return `
+
+
+
+
+
Islandflow Docs
+
+
+
+
+
+
+
+
+
+ No files match that filter.
+
+
+
+
+
+`;
+}
+
+async function main() {
+ const files = await collectDocsFiles(docsDir);
+ const html = renderDocument(files);
+ await fs.writeFile(outputFile, html, "utf8");
+ console.log(`Generated ${outputFile} with ${files.length} entries.`);
+}
+
+main().catch((error) => {
+ console.error(error);
+ process.exitCode = 1;
+});