Skip to content

feat: add engraphis-demo seeded first-run - #326

Merged
Coding-Dev-Tools merged 6 commits into
mainfrom
feat/demo-seed
Nov 9, 2026
Merged

Coding-Dev-Tools merged 6 commits into
mainfrom
feat/demo-seed

Conversation

@Coding-Dev-Tools

Copy link
Copy Markdown
Owner

Summary

  • Add engraphis-demo, a new console command that seeds a disposable SQLite workspace and launches the existing dashboard against it.
  • The seed creates 13 memories across acme-api (checkout, billing) and acme-web (dashboard), including a JWT to PASETO supersession and a cited recall.
  • The demo stays fully local: no extractor, no retention LLM call, and no access to the operator's real database. ENGRAPHIS_DEMO=1 suppresses the unrelated empty-database diagnostic.
  • Add a pytest that asserts the supersession and that recall returns the new PASETO fact.

Why

The README now sends new users to a three-command install, but the dashboard still opens empty. This gives them a one-command way to see scoped memory, temporal history, and cited recall before they seed their own workspace.

Test plan

  • pytest tests/test_demo_seed.py -q pass.
  • ruff check and ruff format --check pass on the new files.
  • Started python -m scripts.demo --no-open --port 8799; /api/ready returned ready, and /api/workspaces returned acme-api with 9 memories and acme-web with 3.
  • CI checks on the PR.

New users currently land on an empty dashboard. Add an engraphis-demo
command that seeds a disposable SQLite workspace with scoped decisions,
a superseded auth fact, and a cited recall, then launches the existing
dashboard against it. The demo stays fully local: no extractor, no
retention LLM call, and no access to the operator's real database.

Cover the seed with a pytest that asserts the supersession and recall.
@chatgpt-codex-connector

Copy link
Copy Markdown
Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ❌ Failed 2026-11-09T04:10:59.703242Z
We couldn’t complete this review. Comment @codex review to try again.
a6c9cae PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

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

The entry-point manifest must match pyproject.toml. Add the new demo
command so the release smoke test covers it.
The initial demo allowed --force to delete any path, could reuse an
existing dashboard, and mutated the process environment permanently.
Use a disposable temp database, refuse existing files, require a free
port, bind the dashboard settings to the demo database, and force the
offline embedder. Add file-backed, refusal, environment, and help tests.
The demo no longer changes engraphis/service.py, so the benchmark
evidence hash stays valid. It explains the empty-database warning
instead of suppressing it, and still restores the offline embedder
environment after seeding.
@Coding-Dev-Tools

Copy link
Copy Markdown
Owner Author

Two fresh-context reviews completed.

Blocker fixed: the demo no longer exposes a destructive --force path, and it no longer modifies engraphis/service.py, which had broken the benchmark evidence hash.

Majors fixed: a disposable temp database instead of a user-selectable destructive path; a free-port pre-flight so it never reuses a real dashboard; environment state restored after seeding; the settings pin no longer swallows exceptions; the seed and dashboard both use the offline embedder; file-backed, refusal, environment, and --help tests added; and the entry point is registered in the release smoke map.

Local checks: 58 tests across demo, artifact, and CLI; the benchmark evidence hash test passes; ruff check . passes; commercial manifest and asset-drift checks pass; live launch reached /api/ready and returned acme-api 9 memories and acme-web 3. CI is running.

Ready for the gate once CI is green and the operator records the merge instruction. No merge authorization is recorded in this comment.

pyproject.toml is a protected packaging path in the merge gate. Keep the
seeded demo runnable as python -m scripts.demo and move the console
entry point to a separate packaging change.
@Coding-Dev-Tools
Coding-Dev-Tools merged commit 6dcdca6 into main Nov 9, 2026
29 checks passed
@Coding-Dev-Tools
Coding-Dev-Tools deleted the feat/demo-seed branch November 9, 2026 08:52
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