From d93779d1d64a57230d0bd1d3a3cf45a47c957140 Mon Sep 17 00:00:00 2001 From: Melvin Carvalho Date: Sun, 7 Jun 2026 08:33:41 +0200 Subject: [PATCH] docs(features/charlie): embed SolidMap demo video Adds the SolidMap demo video (33s, YouTube) as a new "Watch the loop close" subsection at the end of "What it looks like in practice". Complements the existing read/comprehend trace with a visual write/render demonstration: Charlie generates JSON-LD into a pod path; markmap app on the same pod renders the data live. Together the text trace and the video cover both registers of the Charlie pattern: read-and-reason, write-and-render. Closes #27 --- docs/features/charlie.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/features/charlie.md b/docs/features/charlie.md index a57c8d1..4b115a7 100644 --- a/docs/features/charlie.md +++ b/docs/features/charlie.md @@ -50,6 +50,22 @@ Then Charlie examined the ACLs properly. It called `read_acl` on the paths in qu **This is the demonstration.** Not "the pod refused" , that's mere enforcement. But "the pod refused, the agent examined the policy, understood why, and operated within the scope it had been granted." That distinction is what makes scoped consent useful in practice rather than just architecturally tidy. **The WAC is a *language* the agent can read, not a fence the agent runs into.** +### Watch the loop close + +The Charlie pattern extends naturally from reading the pod to writing into it. In the demo below, Charlie generates JSON-LD into `/public/markmap/solid-project.jsonld` on a local JSS pod, while the [markmap](https://markmap.js.org/) app , served from the same pod at `/public/apps/markmap/` , renders the data live. **Agent generates → pod stores → app reads → user sees**, all on the same substrate, no vendor in the loop. + + + +The *"Updated from pod"* indicator at the bottom of the demo is the visible signal that the loop has closed: each Charlie update lands on the pod, the app picks it up, the visualisation re-renders. JSON-LD as the wire format means any tool that speaks linked data can be the rendering surface , markmap here, anything else next. + ## Why this matters ### Consent as language, not cage