From 36d1b12e725fa9c502306efa8e9d82548dcb53e1 Mon Sep 17 00:00:00 2001 From: dirtydishes Date: Mon, 1 Jun 2026 09:04:50 -0400 Subject: [PATCH] docs(general): add May 31 standup summary --- .beads/issues.jsonl | 1 + ...2026-06-01-standup-summary-2026-05-31.html | 519 ++++++++++++++++++ docs/index.html | 16 +- 3 files changed, 532 insertions(+), 4 deletions(-) create mode 100644 docs/general/2026-06-01-standup-summary-2026-05-31.html diff --git a/.beads/issues.jsonl b/.beads/issues.jsonl index 19d9115..b896909 100644 --- a/.beads/issues.jsonl +++ b/.beads/issues.jsonl @@ -99,6 +99,7 @@ {"_type":"issue","id":"islandflow-zs0","title":"Migrate terminal UI to smart-money profiles","description":"Migrate apps/web terminal rendering to consume SmartMoneyEvent directly: primary profile, probability ladder, reason codes, and suppression/abstention state, while preserving legacy alert/classifier displays during the bridge.","status":"closed","priority":2,"issue_type":"task","owner":"dishes@dpdrm.com","created_at":"2026-05-04T21:35:23Z","created_by":"dirtydishes","updated_at":"2026-05-05T05:39:58Z","closed_at":"2026-05-05T05:39:58Z","close_reason":"Completed terminal smart-money profile migration","dependency_count":0,"dependent_count":0,"comment_count":0} {"_type":"issue","id":"islandflow-igk","title":"Add plan mode","description":"Implement a user-facing plan mode in the application so users can switch into planning before taking action. Scope to be clarified from existing app patterns.","status":"closed","priority":2,"issue_type":"feature","owner":"dishes@dpdrm.com","created_at":"2026-05-04T04:22:37Z","created_by":"dirtydishes","updated_at":"2026-05-04T04:26:18Z","started_at":"2026-05-04T04:22:40Z","closed_at":"2026-05-04T04:26:18Z","close_reason":"Implemented as a global pi extension toggled with Shift+P","dependency_count":0,"dependent_count":0,"comment_count":0} {"_type":"issue","id":"islandflow-biq","title":"Finish raw live options delivery and filter/backpressure observability","description":"The smart-money signal path and Tape filters are in place, but the next firehose pass should finish server-side selective raw live delivery for options subscriptions and add explicit filtered-out/backpressure observability for API/web counters. This was discovered while landing islandflow-e4r.\n","status":"in_progress","priority":2,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-04-28T20:28:58Z","created_by":"dirtydishes","updated_at":"2026-04-29T03:54:12Z","started_at":"2026-04-29T03:54:12Z","dependencies":[{"issue_id":"islandflow-biq","depends_on_id":"islandflow-e4r","type":"discovered-from","created_at":"2026-04-28T16:28:58Z","created_by":"auto-import","metadata":"{}"}],"dependency_count":0,"dependent_count":0,"comment_count":0} +{"_type":"issue","id":"islandflow-3f4","title":"Publish May 31 standup git summary","description":"## Summary\nCreate the daily standup HTML summary for 2026-05-31 git activity in docs/general and regenerate any supporting docs index entries.\n\n## Why this matters\nThe team needs a grounded, commit-anchored standup artifact for May 31 repository activity.\n\n## Scope\nInspect May 31 git history, write the summary document in docs/general, update related generated docs metadata if needed, and close out the task.","status":"closed","priority":3,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-06-01T13:02:21Z","created_by":"dirtydishes","updated_at":"2026-06-01T13:04:45Z","started_at":"2026-06-01T13:02:29Z","closed_at":"2026-06-01T13:04:45Z","close_reason":"Added docs/general standup summary for 2026-05-31 and verified docs index discovery.","dependency_count":0,"dependent_count":0,"comment_count":0} {"_type":"issue","id":"islandflow-6ak","title":"Clarify turn doc diff rendering instructions","description":"Make AGENTS.md explicit that turn documents should render diffs with the @pierre/diffs/ssr library import instead of attempting to run @pierre/diffs through bunx.","status":"closed","priority":3,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-05-30T02:01:59Z","created_by":"dirtydishes","updated_at":"2026-05-30T02:02:27Z","started_at":"2026-05-30T02:02:00Z","closed_at":"2026-05-30T02:02:27Z","close_reason":"Updated AGENTS.md to require @pierre/diffs/ssr rendering, forbid bunx @pierre/diffs attempts, and include a known-good preloadPatchDiff recipe.","dependency_count":0,"dependent_count":0,"comment_count":0} {"_type":"issue","id":"islandflow-3kn","title":"Summarize 2026-05-28 git activity","description":"Prepare the standup-ready summary of yesterday's git activity, grounded in commits, PRs, and touched files, and store the HTML report in docs/general.","status":"closed","priority":3,"issue_type":"task","assignee":"dirtydishes","owner":"dishes@dpdrm.com","created_at":"2026-05-29T13:02:25Z","created_by":"dirtydishes","updated_at":"2026-05-29T13:04:23Z","started_at":"2026-05-29T13:02:33Z","closed_at":"2026-05-29T13:04:23Z","close_reason":"Closed","dependency_count":0,"dependent_count":0,"comment_count":0} {"_type":"issue","id":"islandflow-3ys","title":"Expand Forgejo CI beyond the fast validate path","description":"Add follow-on Forgejo CI jobs after the initial baseline is stable. This should cover deferred work such as Docker image builds for deployment/docker, service-container integration tests for NATS/Redis/ClickHouse paths, and any later deploy or release automation that should not block the first fast PR gate.","status":"open","priority":3,"issue_type":"task","owner":"dishes@dpdrm.com","created_at":"2026-05-24T00:34:09Z","created_by":"dirtydishes","updated_at":"2026-05-24T00:34:09Z","dependency_count":0,"dependent_count":0,"comment_count":0} diff --git a/docs/general/2026-06-01-standup-summary-2026-05-31.html b/docs/general/2026-06-01-standup-summary-2026-05-31.html new file mode 100644 index 0000000..dda5cc6 --- /dev/null +++ b/docs/general/2026-06-01-standup-summary-2026-05-31.html @@ -0,0 +1,519 @@ + + + + + + Standup Summary for 2026-05-31 + + + + + + +
+
+ Daily Git Summary +

Standup Summary for 2026-05-31

+

+ Three commits landed on Sunday, May 31, 2026. The day’s git-visible work centered on + documentation operations: repo guidance was trimmed in AGENTS.md, a new + standalone docs/anatomy.html reference page was added, and the GitHub Pages + mirror workflow was retargeted to publish into dirtydishes.github.io/islandflow. +

+
+
+ Commits inspected + 3 on 2026-05-31 +
+
+ Files touched + 6 unique files +
+
+ Tracked issues + islandflow-5jt, islandflow-m3d +
+
+ Open follow-up + islandflow-8a6 +
+
+
+ +
+

Summary

+
+
+

Repo turn-document rules were tightened and shortened.

+

+ Commit ab35533289b4 removed most duplicated repository-specific turn-doc + prose from AGENTS.md and replaced it with references back to the global + Codex instructions plus a smaller repo override block. +

+
+
+

An anatomy explainer page was added to the docs set.

+

+ Commit 5074b7eeaa9e created docs/anatomy.html, updated the + generated docs index, and closed Beads task islandflow-5jt. +

+
+
+

The docs mirror workflow was pointed at the actual Pages target.

+

+ Commit 8933e29ae83d rewired .github/workflows/docs-pages.yml + to check out dirtydishes/dirtydishes.github.io, mirror + site/docs under islandflow, and push to that repository’s + master branch. The same commit closed islandflow-m3d and + left islandflow-8a6 open for token verification. +

+
+
+
+ +
+

Changes Made

+
+
+
+ ab35533289b4 + 2026-05-31 09:29 EDT + docs policy trim +
+

+ trim repo turn doc guidance reduced AGENTS.md by + removing duplicated turn-document instructions and keeping only the repo-specific + overrides: docs/turns location, impeccable usage, + @pierre/diffs/ssr for diff rendering, the minor/trivial exemption list, + and the completion checklist. +

+
+ AGENTS.md +
+
+ +
+
+ 5074b7eeaa9e + 2026-05-31 17:26 EDT + new docs surface +
+

+ add anatomy reference page added a new standalone docs page and + updated the generated docs landing page so anatomy.html appears in the + root document listing. The Beads state added and closed + islandflow-5jt with the note that the page had been linked from the docs + index. +

+
+ docs/anatomy.html + docs/index.html + .beads/issues.jsonl +
+
+ +
+
+ 8933e29ae83d + 2026-05-31 18:13 EDT + docs deploy fix +
+

+ fix docs pages mirror target changed the GitHub Actions workflow + from pushing a local gh-pages branch to checking out + dirtydishes/dirtydishes.github.io, copying the generated docs into + pages/islandflow, and pushing back to the Pages repo’s + master branch. It also tightened the generated HTML formatting in + scripts/generate-docs-index.mjs, regenerated docs/index.html, + and added turn doc + docs/turns/2026-05-31-fix-docs-pages-mirror.html. +

+
+ .github/workflows/docs-pages.yml + scripts/generate-docs-index.mjs + docs/index.html + docs/turns/2026-05-31-fix-docs-pages-mirror.html + .beads/issues.jsonl +
+
+
+
+ +
+

Context

+

+ This report is anchored to local git history whose commit dates fall between + 2026-05-31 00:00:00 -0400 and 2026-06-01 00:00:00 -0400. No PR + merges appear in that window, so the summary is commit-first and file-first. Beads issue + references are only included where they were visible in the inspected commit diffs. +

+
+ +
+

Important Implementation Details

+
    +
  • + AGENTS.md kept the repo-specific overrides but stopped restating the global + turn-document policy in full, which should reduce drift between the repo file and + ~/.codex/AGENTS.md. +
    • +
  • + The anatomy page landed as a standalone HTML asset at the docs root rather than under + docs/turns or docs/general, and the generated docs index was + updated so it appears under the root category. +
    • +
  • + The docs mirror workflow now uses these environment values inside the workflow job: + PAGES_REPOSITORY=dirtydishes/dirtydishes.github.io, + PAGES_BRANCH=master, and PAGES_PREFIX=islandflow. +
    • +
  • + The mirror job now depends on DOCS_PAGES_TOKEN rather than the default + GITHUB_TOKEN, because it pushes to a different repository. +
    • +
  • + The docs index generator change was mostly structural formatting: the rendered HTML for + list items and sections became tighter without changing the index’s overall categories or + sorting behavior. +
    • +
+ 
Docs Pages mirror target after 8933e29ae83d:
+
+PAGES_REPOSITORY=dirtydishes/dirtydishes.github.io
+PAGES_BRANCH=master
+PAGES_PREFIX=islandflow
+
+ +
+

Expected Impact for End-Users

+
    +
  • + Contributors working with Codex repo instructions should see less duplicated policy in + AGENTS.md and clearer repo-only overrides. +
    • +
  • + Readers browsing project docs now have a dedicated anatomy reference page linked from the + docs index. +
    • +
  • + Once the external token is configured, GitHub Pages visitors should get the current docs + from dirtydishes.github.io/islandflow/docs/ instead of relying on a + mismatched branch target. +
    • +
+
+ +
+

Validation

+
    +
  • + Used git log scoped to May 31, 2026 to enumerate the three commits included + in this standup window. +
    • +
  • + Used git show --stat and targeted git show diffs to anchor the + changed files, workflow behavior, and visible Beads issue IDs for each commit. +
    • +
  • + For the docs mirror fix, reused validation already recorded in committed turn doc + docs/turns/2026-05-31-fix-docs-pages-mirror.html: local + node scripts/generate-docs-index.mjs, node --check on the + generator, YAML parsing for .github/workflows/docs-pages.yml, and + git diff --check. +
    • +
  • + No separate automated validation was visible in the inspected May 31 commits for the + AGENTS.md trim or the anatomy page beyond the committed file additions and + docs index linkage. +
    • +
+
+ +
+

Issues, Limitations, and Mitigations

+
+ commit-history only + token still required +
+
    +
  • + This summary only reflects landed git history for May 31 and does not include uncommitted + work, discussion, or operational checks performed outside the repository. +
    • +
  • + The anatomy page commit did not include a companion turn document, so its validation + notes here are limited to what the commit itself showed: file creation, docs index update, + and Beads closure text. +
    • +
  • + The docs mirror workflow fix is not fully effective until the GitHub mirror repository + secret DOCS_PAGES_TOKEN is present and valid. That gap is already tracked in + islandflow-8a6. +
    • +
+
+ +
+

Follow-up Work

+
    +
  • + islandflow-8a6: verify the GitHub Pages token for the docs mirror so the + updated workflow can push to dirtydishes/dirtydishes.github.io. +
    • +
  • + No additional Beads follow-up was visible for the trimmed repo guidance commit + ab35533289b4 in the inspected history. +
    • +
+
+
+ + diff --git a/docs/index.html b/docs/index.html index 8e297ae..b511833 100644 --- a/docs/index.html +++ b/docs/index.html @@ -207,11 +207,11 @@
-
64 of 64 files shown
+
65 of 65 files shown
@@ -651,9 +651,17 @@
-

general 6

+

general 7