Skip to content

[codex] Port demo contracts page into console#219

Draft
11me wants to merge 2 commits into
mainfrom
codex/port-demo-contracts-page
Draft

[codex] Port demo contracts page into console#219
11me wants to merge 2 commits into
mainfrom
codex/port-demo-contracts-page

Conversation

@11me
Copy link
Copy Markdown
Contributor

@11me 11me commented May 9, 2026

Summary

  • Ports the RU demo contracts page from apps/web/demo-change-packet-ru into apps/web/console.
  • Shows the imported demo UI as the authenticated Contracts entry while preserving the existing login flow.
  • Keeps the copied demo CSS identical and isolates it in a shadow root for the console shell.
  • Updates console README and ops status/component docs to state this is a local demo visual surface, not a backend-backed workflow claim.

Type

  • docs
  • repo hygiene / governance
  • tooling / scripts
  • prototype / demo surface
  • implementation slice
  • architecture
  • ops/status
  • product/public narrative
  • fix
  • refactor
  • other

Goal / intent

Integrate the existing demo Contracts page into the canonical console app so an authenticated reviewer can log in locally and see the same Contracts demo UI inside apps/web/console.

No-code alternative

No. The requested outcome is a runnable UI integration in the console app, not a docs-only or configuration change.

Why code is needed

The console route needs to render the imported demo page after authentication. This requires adding the copied demo source and wiring it into the existing console screen.

Scope

In:

  • Import the RU demo contracts UI into apps/web/console.
  • Render it for the authenticated Contracts entry.
  • Keep backend-bound contract clients in source for follow-up work.
  • Update ops docs and README so status matches reality.

Out:

  • Redesigning or rewriting the demo page.
  • Adding new backend contract behavior, runner, gate, proof, provider auth, checkout, analytics, or product-loop claims.
  • Merging without user approval.

Linked issue

Closes #

ComponentImpact

Which documented components are affected?

  • no documented component impact
  • docs/ops/COMPONENTS.yaml reviewed
  • component status should change
  • follow-up component work is needed

Affected components:

  • web_surface

Implementation paths:

  • apps/web/console/src/App.tsx
  • apps/web/console/src/App.css
  • apps/web/console/src/DemoContractsPage.tsx
  • apps/web/console/src/DemoContractsPage.css

Component status changes:

  • None.

Public surfaces added or changed:

  • Authenticated console Contracts entry now displays the imported local RU demo contracts page.

DocImpact

Docs updated:

  • apps/web/console/README.md

  • docs/ops/COMPONENTS.yaml

  • docs/ops/NEXT.md

  • docs/ops/STATUS.md

  • no doc updates needed

  • product docs updated

  • ops docs updated

  • README / contributor docs updated

  • follow-up docs work is needed

Docs checked:

  • docs/INDEX.md
  • docs/product/GOALRAIL_RULE_STACK.md
  • docs/product/GOALRAIL_PRODUCT_CONCEPT.md
  • docs/product/GOALRAIL_OPERATING_MODEL.md
  • docs/product/GOALRAIL_MVP_BLUEPRINT.md
  • docs/PROJECT_SPINE_SCHEMA.md
  • docs/ops/COMPONENTS.yaml
  • AGENTS.md

Docs not updated reason:

  • Product canon and spine schema are unchanged.

Rule Stack checklist

  • I read the relevant docs in docs/INDEX.md
  • I checked docs/product/GOALRAIL_RULE_STACK.md
  • Lower-level changes do not override higher-level canon
  • This PR does not expand MVP scope silently
  • This PR does not claim unimplemented surfaces exist
  • This PR does not introduce undocumented public surface
  • Implementation paths map to docs/ops/COMPONENTS.yaml when applicable
  • For Go changes, I followed docs/ops/GO_CODE_GUIDE.md
  • Status follows reality

Validation / proof

Commands run / walkthrough:

  • npm run console:typecheck
  • npm run console:test
  • npm run console:build
  • git diff --check
  • python3 tools/docs-check/docs_check.py --root . --mode changed-files --changed-files-file /tmp/goalrail-changed-doc-files.txt --report-json /tmp/goalrail-docs-changed-report.json --report-md /tmp/goalrail-docs-changed-report.md
  • Fresh local Docker Postgres, server migrations, dev seed, owner bootstrap, password change, API server, console dev server, browser login smoke.

Evidence / proof:

  • Typecheck passed.
  • Tests passed: 11 files, 131 tests.
  • Build passed with the expected non-fatal Vite chunk-size warning from direct demo import.
  • Docs-check passed with hard=0 warning=0 info=0 fixture_fail=0.
  • Browser smoke showed the imported Contracts demo UI after login and browser console warn/error logs were empty.

DCO / authorship

  • Every commit in this PR is signed off (git commit -s) and complies with DCO.md

Reviewer notes

  • No Go files changed.
  • This is intentionally a visual demo port. Backend-bound contract clients remain in source but are not the currently rendered Contracts entry.
  • The PR is draft and must not be merged until explicit user approval.

@github-actions github-actions Bot added the intake/pass PR intake passed label May 9, 2026
Signed-off-by: limerc <limerc@proton.me>
@11me 11me force-pushed the codex/port-demo-contracts-page branch from 6777970 to 5320ca7 Compare May 9, 2026 12:25
Signed-off-by: limerc <limerc@proton.me>
@11me
Copy link
Copy Markdown
Contributor Author

11me commented May 9, 2026

Update: wired the imported Console Contracts page shell to the existing read-only backend endpoints.\n\nIncluded:\n- backend-backed list/detail/current-draft/repository-context data inside the demo-derived Contracts UI\n- state and repo-binding filters plus manual refresh through existing Console state\n- honest empty/error states instead of local demo Contract fixtures\n- mobile/narrow viewport path fixed so it no longer shows C-0147 demo records in live mode\n- docs/status/component updates\n\nVerification:\n- npm run console:typecheck\n- npm run console:test (132 tests)\n- npm run console:build\n- docs-check changed-files\n- git diff --check\n- in-app browser smoke at http://127.0.0.1:5173/console?lng=ru with demo@example.com / demo1234\n\nNo Contract workflow mutation controls were added; PR remains draft and unmerged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

intake/pass PR intake passed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant