Skip to content

docs: freshness sweep — 106 entries (upstream@f71de1eb) - #2220

Merged
peterdrier merged 2 commits into
mainfrom
freshness-sweep/2026-10-30T150928Z
Oct 30, 2026
Merged

peterdrier merged 2 commits into
mainfrom
freshness-sweep/2026-10-30T150928Z

Conversation

@peterdrier

Copy link
Copy Markdown
Owner

Summary

  • Diff window cb3d8b37..f71de1eb (125 commits). All 161 marked editorial docs and every mechanical entry were dirty. 76 editorial docs edited.
  • Main drift: Board reads section admin pages read-only (pages on *Policies.Read, writes on Manage), section-owned and renamed roles, authenticated-by-default plus [AllowBeforeActiveMembership], Section<Seam>.cs folded into Section.cs, per-section audit actions and notification sources, and event scoping (seasons, rideshare, grants).
  • Mechanical: dependency graph (+6 nodes, stale edges removed), data-access maps for 5 sections, authorization maps for 18 sections plus the global inventory, About page package versions, README index (Grants, LowIncome).
  • 4 dead freshness:triggers paths repaired.
  • Pruned docs/superpowers/plans/2026-09-25-workgroup-budget.md (2,031 lines; its durable rules are already in workgroup-budget.md and Workgroups.md).
  • dev-stats skipped: cloc is unavailable in the cloud container.
  • 7 open questions for Peter, listed in the report.

Report

See docs/freshness/last-report.md (committed in this PR).

Test plan

  • run-all.sh 8/9 (dev-stats fails only because it reads the container's stale local main), diff-mode.sh 17/17, verify-triggers.sh --check clean
  • Skim diff, read report, answer questions, merge if happy

Generated by Claude Code

Updated:
- dependency-graph, service-data-access-map, authorization-inventory
- about-page-packages, docs-readme-index
- 76 editorial docs (Board read-only access, section-owned roles,
  authenticated-by-default, folded section seams, event scoping)

Pruned: docs/superpowers/plans/2026-09-25-workgroup-budget.md

Flagged for review (see docs/freshness/last-report.md):
- 7 questions

Mode: diff
Previous anchor: cb3d8b3

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0186neA5iJNYcyZq3Yfh7pjv
@peterdrier

Copy link
Copy Markdown
Owner Author

Freshness sweep cost (pd:spend)

Agent Tier Model Turns Reqs In Out Cache W Cache R Est $ First-Last (dur)
main (orchestrator) - claude-opus-5-5 1 83 192 32,619 180,509 10,981,784 $3.75 15:09:17-15:43:05 (33m48s)
6bbabf8db75b5cdf untagged claude-opus-5-5 1 66 132 39,312 151,428 6,825,639 $2.91 15:12:21-15:19:38 (7m16s)
e00bfce11b5a4b86 untagged claude-opus-5-5 1 35 70 14,005 128,058 3,265,073 $1.57 15:12:22-15:14:57 (2m35s)
6625ae1e9747eaf5 untagged claude-sonnet-5-5 1 71 142 24,365 227,715 9,975,079 $1.81 15:12:23-15:17:58 (5m35s)
7527915a0ff525d5 untagged claude-sonnet-5-5 1 82 164 29,180 267,513 14,193,564 $2.38 15:15:12-15:22:22 (7m10s)
04b14df6eeeef78c untagged claude-sonnet-5-5 1 64 128 22,327 185,667 8,056,695 $1.49 15:18:12-15:23:41 (5m29s)
f9876252a746691b untagged claude-sonnet-5-5 1 64 128 37,159 227,461 9,197,142 $1.86 15:19:55-15:27:11 (7m15s)
b0638c783ea30ec8 untagged claude-sonnet-5-5 1 39 78 14,400 173,964 4,544,629 $1.03 15:22:37-15:25:53 (3m16s)
6c5cf42f63155746 untagged claude-sonnet-5-5 1 63 126 23,509 200,640 8,694,471 $1.61 15:23:51-15:29:26 (5m35s)
636f4da1d401219d untagged claude-sonnet-5-5 1 78 156 31,154 159,796 9,228,400 $1.63 15:26:11-15:33:47 (7m36s)
57fb58265d72ae4f untagged claude-sonnet-5-5 1 50 100 17,568 187,637 6,225,511 $1.27 15:27:27-15:32:13 (4m46s)
515485d7702861ea untagged claude-sonnet-5-5 2 96 192 33,588 320,360 14,892,853 $2.63 15:29:39-15:38:21 (8m41s)
e725e09d4c94d22f untagged claude-sonnet-5-5 2 90 180 40,626 294,575 15,412,843 $2.68 15:32:31-15:41:30 (8m59s)
989d0c8e17ae2579 untagged claude-sonnet-5-5 1 12 24 3,617 47,112 611,500 $0.22 15:34:09-15:34:57 (48s)
TOTAL 16 893 1,812 363,429 2,752,435 122,105,183 $26.85

estimated, API list prices as of 2026-10-07

By model:

  • claude-sonnet-5-5: 709 reqs, $18.61
  • claude-opus-5-5: 184 reqs, $8.23

orchestrator share: 14% of est. cost

  • Orchestrator share 14%; 13 subagents (2 opus-medium, 11 sonnet) carried the 161-doc review.
  • Priciest agent: opus dependency-graph + data-access map ($2.91), consistent with its tier.
  • All agents show untagged: pd:orch worker tiers did not carry a tier suffix into the transcript.

Generated by Claude Code

@github-actions

Copy link
Copy Markdown

Reviewed commit 50996f8 — no issues found.

@github-actions

github-actions Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

PR Surface Report

Compared f71de1eb...af07cf21. Scored with reforge 0.29.0.

Summary: 108 changed file(s) | EF migrations: 0 added file(s), max 0/1 per context

Reforge Surface Score

metric base head delta
total 17728 17728 0
surface 13954 13954 0
internal complexity 3774 3774 0

Section Deltas

No section score changes.

Section Size & Complexity Deltas

No section size/complexity changes.

Rule Deltas

No rule score changes.

Published Write Surface

6 of 51 sections publish write capability, 7 interfaces (0).

Interface Surface

No new interfaces or interface members.

Diff Size

bucket added deleted
code 5 5
docs 580 2515

@peterdrier

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-30T18:30:09.968725Z 50996f8 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 50996f8fa3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/architecture/dependency-graph.md Outdated

%% ── Edge styling ──
%% Eager edges come first, then the lazy block; linkStyle indexes the lazy block by position.
%% 395 eager edges (indices 0-394) come first, then the 20 lazy edges (395-414); linkStyle indexes the lazy block by position.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Remove hand-maintained counts from the freshness docs

This new comment duplicates totals already derivable from the Mermaid edge list, so the next edge change can silently make the documentation false. The same diff adds further derived counts in docs/freshness/last-report.md (161 docs, 6 nodes, and the repeated edge totals), AuditLog.md (four members), and CityPlanning.md (Three entities); the repository's triggered no-derived-aggregates-in-docs rule requires deleting rather than refreshing these counts, so please sweep all added documentation for this class.

AGENTS.md reference: AGENTS.md:L46-L48

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in af07cf2. I removed the linkStyle comment counts and the report counts, plus the other derived counts in this diff: AuditLog.md, both CityPlanning docs, admin-shell.md, workload-dashboard.md, and a pre-existing "one of two ways" in the Tickets guide. The dependency-graph prompt in the catalog asked for those counts, so it now says the comment states no counts.


Generated by Claude Code

@peterdrier
peterdrier merged commit 59dccca into main Oct 30, 2026
6 checks passed
@peterdrier
peterdrier deleted the freshness-sweep/2026-10-30T150928Z branch October 30, 2026 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants