Skip to content

fix(README): Dbsp.Core → Zeta.Core (Amara P2 — broken quick-tour snippets)#218

Merged
AceHack merged 2 commits intomainfrom
fix/readme-namespace-dbsp-to-zeta-amara-p2
Apr 24, 2026
Merged

fix(README): Dbsp.Core → Zeta.Core (Amara P2 — broken quick-tour snippets)#218
AceHack merged 2 commits intomainfrom
fix/readme-namespace-dbsp-to-zeta-amara-p2

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 23, 2026

Summary

Amara's 2026-04-23 Zeta-semantics report (PR #211) flagged a P2 finding: README quick-tour snippets use Dbsp.Core but actual source files declare namespace Zeta.Core. Code-as-shown won't compile.

What landed

README.md — 2 snippet lines (F# open + C# using).

Verification

No other live Dbsp.Core references in tracked docs. Remaining mentions all in history-exempt surfaces (GOVERNANCE.md rename-history lesson, persona notebooks, ROUND-HISTORY).

Test plan

  • No other live references grep'd
  • dotnet fsi on the F# snippet would now succeed (snippet-level verification; not part of CI)

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings April 23, 2026 23:30
@AceHack AceHack enabled auto-merge (squash) April 23, 2026 23:30
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the README quick-tour snippets to use the correct public namespace (Zeta.Core) so the shown F# and C# examples match the actual source declarations.

Changes:

  • README F# snippet: open Dbsp.Coreopen Zeta.Core
  • README C# snippet: using Dbsp.Core;using Zeta.Core;

Comment thread README.md
Comment thread README.md
Copilot AI review requested due to automatic review settings April 23, 2026 23:52
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

AceHack and others added 2 commits April 24, 2026 10:26
Amara 2026-04-23 Zeta-semantics report (PR #211) P2 finding: README
quick-tour uses `open Dbsp.Core` + `using Dbsp.Core;` but actual source
files declare `namespace Zeta.Core` (per `src/Core/Circuit.fs:86` and
others). Code-as-shown won't compile for any reader copying the snippet.

Fixed both F# and C# snippets (lines 93, 116) to use `Zeta.Core`.

Verified: no other live `Dbsp.Core` references in tracked docs — the
remaining mentions are (a) GOVERNANCE.md:648 historical lesson about
the rename, (b) persona notebooks under `memory/persona/**` (historical),
(c) `docs/ROUND-HISTORY.md:757` historical. All exempt per the
history-file exemption landed in PR #210.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…ync snippet

Address two review threads on PR #218:

1. PRRT_kwDOSF9kNM59QS9U: sweep stragglers. `openspec/README.md`,
   `openspec/specs/durability-modes/profiles/fsharp.md`, and
   `openspec/specs/retraction-safe-recursion/profiles/fsharp.md` still
   named the old `Dbsp.Core` namespace; rename to `Zeta.Core` to match
   the F# source (src/Core/*.fs `namespace Zeta.Core`).

2. PRRT_kwDOSF9kNM59QS9g: quick-tour F# snippet used `do!` at top level,
   which is only valid inside a computation expression. Wrap the
   `orders.Send` + `StepAsync` + print block in `async { ... }` with
   `circuit.StepAsync () |> Async.AwaitTask` (StepAsync returns Task)
   and terminate with `|> Async.RunSynchronously`, so the snippet
   reads as valid F# and is copy-pasteable for onboarding.

docs/copilot-wins.md, docs/aurora/2026-04-23-amara-zset-semantics-operator-algebra.md,
docs/ROUND-HISTORY.md, and memory/ notebooks retain `Dbsp.Core` as
historical references (history-exempt per docs-as-current-state rule).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 24, 2026 14:27
@AceHack AceHack force-pushed the fix/readme-namespace-dbsp-to-zeta-amara-p2 branch from 4f14e73 to 9209677 Compare April 24, 2026 14:27
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@AceHack AceHack merged commit 2508fe1 into main Apr 24, 2026
12 checks passed
@AceHack AceHack deleted the fix/readme-namespace-dbsp-to-zeta-amara-p2 branch April 24, 2026 14:29
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

Comment thread README.md
Comment on lines 92 to +113
@@ -103,17 +103,20 @@ let totals =

let view = circuit.Output(circuit.IntegrateZSet totals)

orders.Send(ZSet.ofKeys [ "alice", 100L ; "bob", 50L ])
do! circuit.StepAsync ()
async {
orders.Send(ZSet.ofKeys [ "alice", 100L ; "bob", 50L ])
do! circuit.StepAsync () |> Async.AwaitTask

for e in view.Current do
printfn "%A -> weight %d" e.Key e.Weight
for e in view.Current do
printfn "%A -> weight %d" e.Key e.Weight
}
|> Async.RunSynchronously
Copy link

Copilot AI Apr 24, 2026

Choose a reason for hiding this comment

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

P1: The PR title/description claims the change is just 2 snippet lines in README.md, but this hunk also restructures the F# snippet to wrap it in an async { ... } block and the PR also edits multiple openspec/** files. Please update the PR title/description (and/or verification section) to reflect the full set of touched docs so reviewers don’t miss scope.

Copilot uses AI. Check for mistakes.
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