Skip to content

Add root-level retail delivery agent template - #106

Closed
somacdivad wants to merge 5 commits into
mainfrom
docs/retail-delivery-agent
Closed

somacdivad wants to merge 5 commits into
mainfrom
docs/retail-delivery-agent

Conversation

@somacdivad

@somacdivad somacdivad commented Oct 1, 2026 •

Copy link
Copy Markdown
Collaborator

Source and scope

This is the upstream half of the approved two-PR delivery-agent plan. After the initial draft, the user explicitly changed the placement decision to root-level retail-delivery-agent/, matching upstream CONTRIBUTING.md and the flattened docs source sync. The docs gallery and ZIP retain their v1 public version/URLs. The final PR diff has no nested v1/retail-delivery-agent/ source; the earlier nested commit remains in history, not the resulting tree. The companion docs PR is owned separately. Keep this PR draft; do not publish the template as runnable or merge until the live gates are cleared.

What changed

  • Model and configuration: pinned PyRel 1.33.0, importable directory package, directed weighted reachability, stock/deadline eligibility, binary whole-order maximum-count problem, and solver-gated revision-bearing decisions. The separate source module binds Snowflake tables declaratively without loading fixtures on import.
  • Fixture, scripts and tests: five synthetic CSVs; guarded new-schema loader, transactional North closure/reopen and ownership-checked source teardown; independent bounded Dijkstra/brute-force oracle; fail-closed snapshot checker; offline regression cases and an opt-in live-evidence test. Oracle expectations are open: zero unreachable stores/three complete orders; closed: one unreachable/two complete orders. They are not observed PyRel/Snowflake results.
  • README, runbook, strict template-docs.yaml sidecar, paired prompts, bounded three-arm blank scorecard, and explicitly non-runnable account-gated semantic-view/agent/grant/teardown SQL drafts. Regenerated the root index and updated its root-template test.

Why

A source model and independently checkable answer key must precede domain review and a governed agent handoff. A deployed model alone does not create a Snowflake semantic view or Cortex Agent. Root-level source is necessary for current upstream policy and docs sync; public gallery versioning remains v1.

Risks and publication blockers

  • No approved live account or prescriptive entitlement was available. Combined graph→configured solver→public-table deployment, Snowflake source DDL, output names/columns/keys, solver failure, repeated NEW refresh and matching revisions, semantic view/Agent/grants, CoWork access, and three-arm accuracy were not tested live. The live-evidence test skips without approved evidence.
  • sql/10_semantic_view.sql, 20_create_agent.sql, 30_grants.sql, 90_teardown.sql, and evaluation/arms.sql remain deliberately non-runnable until a verified account API/schema/grant review. scripts/check_results.py needs a real account-exported snapshot and verified mapping. Keep credentials outside the repository and ZIP; do not present this draft as a working browser agent.

How to verify

Completed: Ruff (retail-delivery-agent sample-template scripts tests) and Python compilation passed; template tests 11 pass, one live skipped; upstream tests 13 pass; changed-template policy and root index checks passed; oracle open 3/0 and closed 2/1; pinned PyRel import and standalone directory CLI loader passed; strict docs sidecar/source-symbol/CSV/public-guide-link validation passed read-only with normalized ID v1/retail-delivery-agent. No generated docs files were changed. Connected Snowflake/Agent/CoWork and end-to-end refresh checks were not run.

Companion docs draft

The dependent RelationalAI/relationalai-docs#931 is also a draft. Its preview syncs this branch at revision 966d3dd, including the root-level template while retaining v1 gallery/ZIP URLs. The docs PR depends on this templates PR: after this PR's live gates are satisfied and it merges, the docs branch must resync from templates main, remove its temporary PR-specific preview override, rerun validation, and verify the deployed preview before its own merge. Do not merge either PR on offline evidence alone.

somacdivad and others added 3 commits October 1, 2026 15:06
What changed:
- Define a pinned PyRel graph-to-prescriptive delivery package and synthetic sources.
- Add safe source scripts, independent oracle, offline tests, evaluation materials, and gated agent handoff artifacts.

Why:
- Give reviewers a verifiable upstream foundation without inventing live Snowflake outputs or access.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
What changed:
- Require a third observed snapshot and distinct later successful refresh run on unchanged source revision.
- Document the evidence needed to run the account-gated test.

Why:
- A previous successful run cannot prove that a repeated NEW refresh and its public rows are current.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
What changed:
- Relocate the complete delivery template to the root-level source layout.
- Regenerate the template index and assert the root link in policy tests.

Why:
- Match the current upstream contribution contract and flattened docs sync while preserving v1 public URLs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@somacdivad somacdivad changed the title Add draft retail delivery agent template Add root-level retail delivery agent template Oct 1, 2026
somacdivad and others added 2 commits October 1, 2026 15:19
What changed:
- Remove two redundant Road-to-Node diagram edges while retaining the directed source-to-destination explanation in the Road concept.

Why:
- Avoid a wide-layout relationship-label collision that blocks generated template page rendering.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
What changed:
- Introduce EligiblePair, Assignment, and problem in source order in the planning step explanation.

Why:
- Allow the generated walkthrough to pass build-time reference-order validation without changing the model or lesson.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown

The templates docs preview for this pull request has been deployed to Vercel!

✅ Preview: https://relationalai-docs-3eq59k20d-relationalai.vercel.app/build/templates
🔍 Inspect: https://vercel.com/relationalai/relationalai-docs/26FjFa7RKe3mQdSyCtLwdocqVRxe

@somacdivad

Copy link
Copy Markdown
Collaborator Author

Closing this. It sounds like this approach is not one we want to support.

@somacdivad somacdivad closed this Oct 13, 2026
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