Skip to content

feat(minigraph-playground): deploy tutorials 2 to 14 as a graph set; drop the import advisory's redundant sentence - #387

Merged
acn-ericlaw merged 4 commits into
mainfrom
feat/playground-graph-set-example
Oct 18, 2026
Merged

acn-ericlaw merged 4 commits into
mainfrom
feat/playground-graph-set-example

Conversation

@acn-ericlaw

@acn-ericlaw acn-ericlaw commented Oct 18, 2026 •

Copy link
Copy Markdown
Collaborator

What

Lock-step twin of Accenture/mercury-composable#567.

  • A worked example of graph sets. examples/minigraph-playground/resources/graphs.yaml keeps tutorial-1 and support-triage as loose graphs and deploys tutorials 2 to 14 as the set tutorials (resources/graph/tutorials.pack, version 1.0), unpacked into file:/tmp/unpack. This repo's graph-packager builds the pack from crates/knowledge-graph/resources/graph/tutorial-{2..14}.json byte-identical with the Java example's (SHA-256 33107f91…). The README's manifest rows name the set.
  • The import fallback's redundant sentence is gone from commands.rs: the console shows Found deployed graph model in {location} and then "Graph model imported as draft". The bundle (index-BTVKYfNr) and the five tutorial help pages come from the Java webapp's npm run release:all.
  • The unpack-folder examples are fixed. check_unpack refuses an unpack folder inside the Playground's temp folder, yet help package, the starter template's commented manifest and the AI agent guide's deploy-a-set steps showed one under /tmp/graph. They now use file:/tmp/unpack and state the rule; the configuration reference adds "or a folder inside it". tests/graph_set_loader.rs keeps /tmp/graph/unpacked as its negative case. Bundle index-BVYn3P8C.

Why

Graph sets had no running example on either engine. The Playground example now deploys loose graphs and a set side by side, and tests/tutorials.rs - which asserts all fourteen tutorials deployed - exercises the set. The advisory line asked the user to do what the import had just done.

Verification

  • cargo fmt --all --check clean; cargo clippy -p mercury-knowledge-graph -p minigraph-playground --all-targets -- -D warnings clean
  • cargo test -p mercury-knowledge-graph -p minigraph-playground - 99 passed, 0 failed; the loader's generated manifest in /tmp/unpack records the set deployed from classpath:/graph/tutorials.pack

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

🤖 Generated with Claude Code

acn-ericlaw and others added 2 commits October 18, 2026 16:05
…drop the import advisory's redundant sentence

Lock-step twin of the Java example. The Playground example is now the worked example of
graph sets: tutorial-1 and support-triage stay loose graphs, and tutorials 2 to 14 deploy
as the set 'tutorials' (resources/graph/tutorials.pack, version 1.0) unpacked into
file:/tmp/unpack. This repo's graph-packager builds the pack from the engine crate's
tutorial JSON byte-identical with the Java example's.

The import fallback prints "Found deployed graph model in {location}" without the
redundant "Please export an updated version and re-import ..." line. The bundle
(index-BTVKYfNr) and the five tutorial help pages come from the Java webapp's
'npm run release:all'.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
acn-ericlaw and others added 2 commits October 18, 2026 16:13
…efuses a folder inside the Playground's temp folder

Twin of the Java follow-up. 'help package', the starter template's commented manifest and
the AI agent guide's deploy-a-set steps showed an unpack folder under /tmp/graph, which
check_unpack refuses at startup. They now use file:/tmp/unpack and state the rule, and the
configuration reference's refusal sentence names a folder inside the temp folder too.
tests/graph_set_loader.rs keeps /tmp/graph/unpacked as its negative case. The bundle
(index-BVYn3P8C) and the help page come from the Java webapp's 'npm run release:all'.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@acn-ericlaw
acn-ericlaw merged commit b6f1cca into main Oct 18, 2026
8 checks passed
@acn-ericlaw
acn-ericlaw deleted the feat/playground-graph-set-example branch October 18, 2026 23:23
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