Skip to content

docs(pm2): B-0271 — PM-2 first research pass, 6 Zeta feature gaps predicted#3033

Merged
AceHack merged 3 commits into
mainfrom
feat/b-0271-pm2-first-research-pass-2026-05-13
May 13, 2026
Merged

docs(pm2): B-0271 — PM-2 first research pass, 6 Zeta feature gaps predicted#3033
AceHack merged 3 commits into
mainfrom
feat/b-0271-pm2-first-research-pass-2026-05-13

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented May 13, 2026

Summary

  • Runs the PM-2 skill on Zeta's product surface (544 backlog rows, README, TECH-RADAR, public API, NuGet config, proofs/) to predict feature gaps before consumer friction
  • Produces docs/research/2026-05-13-pm2-zeta-feature-gap-prediction-first-pass.md with 6 gaps
  • Files 4 new backlog rows; 2 gaps point to existing rows (no backlog inflation)
  • Closes B-0271 (PM-2 first research pass)

6 predicted gaps

# Gap Row Priority
1 No getting-started guide — consumers land on dense Budiu et al. math B-0444 (new P1) P1
2 Core.CSharp covers only variance shims — operators need C# fluent API B-0445 (new P1) P1
3 ChainRule.lean is a stub — no formal proof of DBSP identities B-0446 (new P2) P2
4 NuGet metadata sparse — no Description, Tags, SourceLink, semantic version B-0447 (new P2) P2
5 Shadow CLI slices 3–5 individually deferrable → should be sprint unit B-0431/0432/0433 (existing P0) P0
6 DBpedia/MDM canonical demo does not exist B-0428 (existing P1) P1

Test plan

  • dotnet build -c Release 0 warnings (no source changes — doc only)
  • Research doc accessible at docs/research/2026-05-13-pm2-zeta-feature-gap-prediction-first-pass.md
  • B-0271 row updated with completion note
  • B-0444, B-0445, B-0446, B-0447 rows present in their priority directories

🤖 Generated with Claude Code

Runs the PM-2 skill on Zeta's product surface (544 backlog rows, README,
TECH-RADAR, API surface, NuGet config, proofs/). Identifies 6 gaps before
consumer friction:

1. Getting-started guide missing (B-0444, new P1)
2. C# fluent operator surface: Core.CSharp covers only variance shims (B-0445, new P1)
3. Lean 4 ChainRule.lean is a stub; core identities not formally proved (B-0446, new P2)
4. NuGet metadata sparse: no Description/Tags/SourceLink/Version (B-0447, new P2)
5. Shadow CLI slices 3–5 are P0 but deferrable individually → treat as sprint unit (B-0431/0432/0433)
6. DBpedia/MDM canonical demo does not exist → B-0428 unblocked

Closes B-0271.

Co-Authored-By: Claude <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 13, 2026 21:24
@AceHack AceHack enabled auto-merge (squash) May 13, 2026 21:24
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

Doc-only PR delivering the PM-2 first research pass (B-0271). Adds a research document predicting six feature gaps in Zeta's consumer-facing surface, files four new backlog rows for net-new gaps, and updates B-0271 with a completion note pointing at existing rows for the remaining two gaps.

Changes:

  • Adds docs/research/2026-05-13-pm2-zeta-feature-gap-prediction-first-pass.md describing six predicted gaps with product-bet structure.
  • Adds four new per-row backlog files: B-0444 (getting-started guide, P1), B-0445 (C# fluent operator surface, P1), B-0446 (Lean 4 proof completion, P2), B-0447 (NuGet package metadata, P2).
  • Updates B-0271 with last_updated, classification → ready-for-close, and a completion note linking to the research doc and the six gaps.

Reviewed changes

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

Show a summary per file
File Description
docs/research/2026-05-13-pm2-zeta-feature-gap-prediction-first-pass.md New research doc enumerating six predicted feature gaps.
docs/backlog/P1/B-0444-getting-started-guide-for-library-consumers-pm2-2026-05-13.md New P1 row for quickstart guide + sample.
docs/backlog/P1/B-0445-csharp-fluent-operator-surface-pm2-2026-05-13.md New P1 row for C# fluent operator API.
docs/backlog/P2/B-0446-lean4-formal-proof-completion-dbsp-core-identities-pm2-2026-05-13.md New P2 row for Lean 4 proof completion.
docs/backlog/P2/B-0447-nuget-package-metadata-completeness-pm2-2026-05-13.md New P2 row for NuGet package metadata.
docs/backlog/P1/B-0271-pm2-first-research-pass-2026-05-08.md Updates B-0271 with completion note + ready-for-close classification.

Copy link
Copy Markdown

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

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: b6e419d062

ℹ️ 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/backlog/P1/B-0271-pm2-first-research-pass-2026-05-08.md Outdated
AceHack and others added 2 commits May 13, 2026 17:30
…g rows

B-0271.md line 31: added blank line between "6 gaps identified:" prose and
the list beneath it (markdownlint MD032).

B-0447.md line 47: replaced prose `+` connector (parsed as list marker) with
`and` so the SourceLink sentence reads as a single paragraph instead of
triggering MD032.

Co-Authored-By: Claude <noreply@anthropic.com>
B-0271 had a completion note landing in this PR but status remained
open. Set status to closed to match the declared-complete state.

Ran BACKLOG_WRITE_FORCE=1 bun tools/backlog/generate-index.ts to
include B-0444, B-0445, B-0446, B-0447 in docs/BACKLOG.md so the
new rows are visible in the canonical queue. Addresses the non-required
CI check for generated-index drift.

Co-Authored-By: Claude <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 13, 2026 21:32
@AceHack AceHack merged commit c35b227 into main May 13, 2026
24 checks passed
@AceHack AceHack deleted the feat/b-0271-pm2-first-research-pass-2026-05-13 branch May 13, 2026 21:34
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 7 out of 7 changed files in this pull request and generated no new comments.

Copy link
Copy Markdown

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

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: 5dfdef24a5

ℹ️ 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".

## PM-2 signal

Academic reviewers and enterprise adopters want to cite Zeta as a
verified DBSP implementation. `proofs/lean/ChainRule.lean` is a stub
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 Point Lean proof task at the maintained file path

This row’s signal is built on an invalid file location: proofs/lean/ChainRule.lean is described as a live stub, but the maintained proof was migrated to tools/lean4/Lean4/DbspChainRule.lean and the old path was removed (already documented in backlog history). As written, the acceptance criteria/send-you-there steps direct contributors to a nonexistent proofs/lean/ target and can cause duplicate or mis-scoped work instead of extending the active Lean project.

Useful? React with 👍 / 👎.

AceHack added a commit that referenced this pull request May 13, 2026
…→ B-0450 (#3053)

* fix(backlog): resolve B-0444 ID collision — renumber getting-started → B-0450; close shipped bus-envelope row

Two rows on main both claimed `id: B-0444`:

1. `docs/backlog/P1/B-0444-getting-started-guide-...md` — filed first
   (commit b6e419d 17:23 via PR #3033, B-0271 PM-2 gap-prediction pass)
2. `docs/backlog/P2/B-0444-bus-claim-envelope-...md` — filed 25 min
   later (commit bbb984d 17:48 via PR #3038, Otto-Desktop's identified
   follow-up gap) AND already shipped via PR #3043

Per "first-merged-wins" the getting-started row had the ID first
(PR #3033 merged at 17:34, before the bus-envelope row was even
committed). But: the bus-envelope row was shipped (PR #3043), so
moving its ID would break the link from PR #3043 → backlog row + the
ID is already referenced by B-0445 and B-0448's `composes_with`.

Resolution: keep B-0444 on the shipped+referenced bus-envelope row;
renumber the getting-started row to the next available ID (B-0450 —
B-0449 was taken by Otto-Desktop's bg-services slice 5).

Changes:

- `docs/backlog/P1/B-0444-getting-started-guide-...md`
  → `docs/backlog/P1/B-0450-getting-started-guide-...md`
  (file rename via `git mv` preserves history); `id` field updated;
  body title updated; `renumbered_from: B-0444` + reason recorded
  for substrate-honest provenance.
- `docs/backlog/P1/B-0271-pm2-first-research-pass-...md`: updated
  Gap-1 reference from B-0444 to B-0450 with renumber note.
- `docs/backlog/P2/B-0444-bus-claim-envelope-...md`: status open
  → closed; `closed_at: 2026-05-13` + `closed_by_pr: 3043` recorded
  (this row's substrate work shipped already; the row was just
  never marked closed).
- `docs/BACKLOG.md`: regenerated via `BACKLOG_WRITE_FORCE=1
  bun tools/backlog/generate-index.ts` to reflect the renumber +
  status change.

Verified post-fix:

- `bun tools/bg/backlog-ready-notifier.ts --once` still reports 0
  dangling-dep refs (no warning suffix).
- No grep for `B-0444` in `docs/backlog/` returns the now-renumbered
  row's old ID; the bus-envelope row's references survive intact.

Co-Authored-By: Claude <noreply@anthropic.com>

* shard(tick): 2306Z — B-0444 ID collision resolved + shipped bus-envelope row closed

Records: PR #3050 merged; audit of in-flight rows surfaced TWO rows
both with `id: B-0444` (one shipped via PR #3043 still open;
one duplicate from PM-2 gap-prediction). PR #3053 keeps B-0444 on
the shipped+referenced row, renumbers the duplicate to B-0450,
closes the shipped row.

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
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