Skip to content

docs(OMN-10372): add contract YAML and dod receipts for symbol extractor - #573

Merged
jonahgabriel merged 2 commits into
mainfrom
jonah/omn-10372-contract
May 1, 2026
Merged

jonahgabriel merged 2 commits into
mainfrom
jonah/omn-10372-contract

Conversation

@jonahgabriel

@jonahgabriel jonahgabriel commented Apr 30, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Adds contracts/OMN-10372.yaml with 3 dod_evidence items
  • Adds 3 PASS receipts under drift/dod_receipts/OMN-10372/ with verified probe_stdout

Ticket

OMN-10372 — Task 20: [Wave 5 AST Diff] tree-sitter Python parser + symbol extraction

Evidence

Summary by CodeRabbit

  • Chores
    • Added formalized verification requirements and test evidence documentation to ensure code quality standards.

@coderabbitai

coderabbitai Bot commented Apr 30, 2026 •

Copy link
Copy Markdown

Warning

Rate limit exceeded

@jonahgabriel has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 11 minutes and 57 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 38724107-c4fe-40ff-8b7d-c971fbdfb181

📥 Commits

Reviewing files that changed from the base of the PR and between d82d700 and a41852e.

📒 Files selected for processing (4)
  • contracts/OMN-10372.yaml
  • drift/dod_receipts/OMN-10372/dod-001/command.yaml
  • drift/dod_receipts/OMN-10372/dod-002/command.yaml
  • drift/dod_receipts/OMN-10372/dod-003/command.yaml
📝 Walkthrough

Walkthrough

A new contract document (OMN-10372.yaml) is introduced alongside three supporting evidence receipt files that document CI validations for a symbol extraction feature, including checks for file presence, function signatures, and unit test passage confirmation.

Changes

Cohort / File(s) Summary
Contract Definition
contracts/OMN-10372.yaml
Defines a new contract with schema version, ticket metadata, and structured evidence requirements specifying three CI checks: symbol_extractor.py file presence, extract_symbols function signature validation, and 14 unit test passage confirmation.
Evidence Receipts
drift/dod_receipts/OMN-10372/dod-001/command.yaml, drift/dod_receipts/OMN-10372/dod-002/command.yaml, drift/dod_receipts/OMN-10372/dod-003/command.yaml
Three YAML receipt files documenting verification results for PR #998: dod-001 confirms symbol_extractor referenced 5 times in PR diff, dod-002 confirms extract_symbols function signature detected, and dod-003 confirms 14 unit tests passed via pytest execution.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 A contract takes shape with evidence in place,
Symbol extractors spring forth, tests embrace,
Receipts of success, fourteen pass with cheer,
With CI's blessing, the path becomes clear! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding a contract YAML file and definition of duty (DoD) receipts for the OMN-10372 ticket related to symbol extraction functionality.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch jonah/omn-10372-contract

Review rate limit: 0/5 reviews remaining, refill in 11 minutes and 57 seconds.

Comment @coderabbitai help to get the list of available commands and usage tips.

@jonahgabriel
jonahgabriel enabled auto-merge April 30, 2026 15:37
@jonahgabriel
jonahgabriel added this pull request to the merge queue Apr 30, 2026
@jonahgabriel
jonahgabriel removed this pull request from the merge queue due to a manual request Apr 30, 2026
@github-actions
github-actions Bot enabled auto-merge April 30, 2026 16:39
@jonahgabriel
jonahgabriel added this pull request to the merge queue Apr 30, 2026
@jonahgabriel
jonahgabriel removed this pull request from the merge queue due to a manual request Apr 30, 2026

@coderabbitai coderabbitai 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.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (3)
drift/dod_receipts/OMN-10372/dod-001/command.yaml (1)

1-18: ⚠️ Potential issue | 🟠 Major

Update commit_sha to match the actual head of omnibase_core PR #998.

The commit_sha: b4c21ded in this receipt does not match the head commit of the target PR. The correct head commit SHA for OmniNode-ai/omnibase_core PR #998 is d0ad179a7ed6e8af00efc68a2a116ca570552506. Update the commit_sha field to the correct value.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@drift/dod_receipts/OMN-10372/dod-001/command.yaml` around lines 1 - 18, The
commit_sha in the receipt is incorrect; update the YAML field commit_sha from
b4c21ded to the correct head SHA d0ad179a7ed6e8af00efc68a2a116ca570552506 in the
command.yaml so the receipt matches PR `#998`; ensure you only replace the value
of the commit_sha key and keep surrounding fields (schema_version, ticket_id,
probe_command, etc.) intact.
drift/dod_receipts/OMN-10372/dod-002/command.yaml (1)

1-17: ⚠️ Potential issue | 🟠 Major

Correct commit_sha to match the actual head of omnibase_core PR #998.

The receipt has commit_sha: b4c21ded, but the actual head commit of PR #998 in OmniNode-ai/omnibase_core is d0ad179a7ed6e8af00efc68a2a116ca570552506. Update the receipt to use the correct full or unambiguous short SHA of the PR head, not an unrelated commit.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@drift/dod_receipts/OMN-10372/dod-002/command.yaml` around lines 1 - 17,
Update the receipt's commit_sha field to the actual head of PR `#998` by replacing
the current value "b4c21ded" with the correct SHA
"d0ad179a7ed6e8af00efc68a2a116ca570552506" in the command.yaml; ensure you only
change the commit_sha entry (leave schema_version, ticket_id, evidence_item_id,
probe_command, probe_stdout and other metadata intact) so the receipt accurately
references the omnibus_core PR `#998` head used to verify the extract_symbols
signature check.
drift/dod_receipts/OMN-10372/dod-003/command.yaml (1)

1-22: ⚠️ Potential issue | 🟠 Major

Fix receipt commit_sha to match omnibase_core PR #998 head commit.

The commit_sha: b4c21ded does not match the headRefOid of OmniNode-ai/omnibase_core PR #998 (d0ad179a7ed6e8af00efc68a2a116ca570552506). Update to the correct head commit SHA to ensure receipt validity for the deploy-gate/receipt registry.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@drift/dod_receipts/OMN-10372/dod-003/command.yaml` around lines 1 - 22,
Update the receipt's commit_sha field to match the actual head commit of
omnibase_core PR `#998` by replacing the current commit_sha value (b4c21ded) with
the PR headRefOid d0ad179a7ed6e8af00efc68a2a116ca570552506 so the receipt
correctly reflects the PR `#998` head commit for the deploy-gate/receipt registry.
🧹 Nitpick comments (1)
contracts/OMN-10372.yaml (1)

19-20: ⚡ Quick win

Avoid embedded newlines in dod-003 contract command strings.

The dod-003 evidence_requirements.command and dod_evidence check_value are double-quoted strings that include a YAML line break between grep -q '^status: PASS$' and the file path. Most shells treat newline as whitespace, but some runners/templaters or execution contexts can preserve newlines in ways that lead to brittle parsing.

I recommend collapsing both commands to a single line (same semantics, more deterministic).

♻️ Proposed change (collapse dod-003 commands to one line)
-    description: 14 unit tests pass locally, recorded in canonical DoD receipt
-    command: "test -f drift/dod_receipts/OMN-10372/dod-003/command.yaml && grep -q '^status: PASS$' drift/dod_receipts/OMN-10372/dod-003/command.yaml
-      && grep -q '14 passed' drift/dod_receipts/OMN-10372/dod-003/command.yaml"
+    description: 14 unit tests pass locally, recorded in canonical DoD receipt
+    command: "test -f drift/dod_receipts/OMN-10372/dod-003/command.yaml && grep -q '^status: PASS$' drift/dod_receipts/OMN-10372/dod-003/command.yaml && grep -q '14 passed' drift/dod_receipts/OMN-10372/dod-003/command.yaml"
@@
   - id: dod-003
     description: 14 unit tests for symbol_extractor pass
     source: generated
     checks:
       - check_type: command
-        check_value: "test -f drift/dod_receipts/OMN-10372/dod-003/command.yaml && grep -q '^status: PASS$'
-          drift/dod_receipts/OMN-10372/dod-003/command.yaml && grep -q '14 passed' drift/dod_receipts/OMN-10372/dod-003/command.yaml"
+        check_value: "test -f drift/dod_receipts/OMN-10372/dod-003/command.yaml && grep -q '^status: PASS$' drift/dod_receipts/OMN-10372/dod-003/command.yaml && grep -q '14 passed' drift/dod_receipts/OMN-10372/dod-003/command.yaml"

Based on learnings: “...treat the contents as deploy-gate artifacts ... only flag issues that clearly violate the contract schema/format or internal consistency of the YAML itself.” (This refactor keeps schema/semantics; it just removes newline brittleness.) citeturn0search0

Also applies to: 43-44

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@contracts/OMN-10372.yaml` around lines 19 - 20, The dod-003 contract contains
multi-line double-quoted shell command strings (the
evidence_requirements.command and dod_evidence.check_value entries) that embed a
YAML newline between "grep -q '^status: PASS$'" and the file path; collapse each
of those into a single-line string (no embedded newline) preserving the same
grep sequence and file path so the semantics are identical but the command is
deterministic across shells/runners (also apply the same single-line collapse to
the other occurrence mentioned around lines 43-44).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@drift/dod_receipts/OMN-10372/dod-001/command.yaml`:
- Around line 1-18: The commit_sha in the receipt is incorrect; update the YAML
field commit_sha from b4c21ded to the correct head SHA
d0ad179a7ed6e8af00efc68a2a116ca570552506 in the command.yaml so the receipt
matches PR `#998`; ensure you only replace the value of the commit_sha key and
keep surrounding fields (schema_version, ticket_id, probe_command, etc.) intact.

In `@drift/dod_receipts/OMN-10372/dod-002/command.yaml`:
- Around line 1-17: Update the receipt's commit_sha field to the actual head of
PR `#998` by replacing the current value "b4c21ded" with the correct SHA
"d0ad179a7ed6e8af00efc68a2a116ca570552506" in the command.yaml; ensure you only
change the commit_sha entry (leave schema_version, ticket_id, evidence_item_id,
probe_command, probe_stdout and other metadata intact) so the receipt accurately
references the omnibus_core PR `#998` head used to verify the extract_symbols
signature check.

In `@drift/dod_receipts/OMN-10372/dod-003/command.yaml`:
- Around line 1-22: Update the receipt's commit_sha field to match the actual
head commit of omnibase_core PR `#998` by replacing the current commit_sha value
(b4c21ded) with the PR headRefOid d0ad179a7ed6e8af00efc68a2a116ca570552506 so
the receipt correctly reflects the PR `#998` head commit for the
deploy-gate/receipt registry.

---

Nitpick comments:
In `@contracts/OMN-10372.yaml`:
- Around line 19-20: The dod-003 contract contains multi-line double-quoted
shell command strings (the evidence_requirements.command and
dod_evidence.check_value entries) that embed a YAML newline between "grep -q
'^status: PASS$'" and the file path; collapse each of those into a single-line
string (no embedded newline) preserving the same grep sequence and file path so
the semantics are identical but the command is deterministic across
shells/runners (also apply the same single-line collapse to the other occurrence
mentioned around lines 43-44).

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f5f05a33-eee5-4498-a035-c8ba6e34f7d9

📥 Commits

Reviewing files that changed from the base of the PR and between 6889212 and d82d700.

📒 Files selected for processing (4)
  • contracts/OMN-10372.yaml
  • drift/dod_receipts/OMN-10372/dod-001/command.yaml
  • drift/dod_receipts/OMN-10372/dod-002/command.yaml
  • drift/dod_receipts/OMN-10372/dod-003/command.yaml

@github-actions
github-actions Bot enabled auto-merge April 30, 2026 19:43
@jonahgabriel
jonahgabriel added this pull request to the merge queue Apr 30, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to no response for status checks May 1, 2026
Contract and 3 PASS receipts for OMN-10372 tree-sitter symbol extraction.
Evidence: PR #998 in omnibase_core, 14 unit tests passing.
@jonahgabriel
jonahgabriel force-pushed the jonah/omn-10372-contract branch from d82d700 to a41852e Compare May 1, 2026 02:26
@github-actions
github-actions Bot enabled auto-merge May 1, 2026 03:08
@jonahgabriel
jonahgabriel added this pull request to the merge queue May 1, 2026
Merged via the queue into main with commit 6a4f254 May 1, 2026
25 checks passed
@jonahgabriel
jonahgabriel deleted the jonah/omn-10372-contract branch May 1, 2026 04:28
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.

1 participant