yarramate 0.18.0 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/README.md +9 -1
  2. package/catalogues/core-enrichment.yaml +52 -1
  3. package/dist/adapters/graphify-cli.js +0 -0
  4. package/dist/adapters/likec4-cli.js +0 -0
  5. package/dist/adapters/likec4-export.d.ts +1 -1
  6. package/dist/adapters/likec4-export.js +32 -0
  7. package/dist/adapters/mcp-cli.js +0 -0
  8. package/dist/adapters/visual/client.js +0 -1
  9. package/dist/adapters/visual/protocol-contract.d.ts +118 -35
  10. package/dist/adapters/visual/protocol-contract.js +1 -11
  11. package/dist/adapters/visual/protocol.d.ts +8 -1
  12. package/dist/adapters/visual/protocol.js +86 -46
  13. package/dist/adapters/visual/request.d.ts +37 -0
  14. package/dist/adapters/visual/request.js +131 -0
  15. package/dist/adapters/visual/session-server.d.ts +12 -14
  16. package/dist/adapters/visual/session-server.js +641 -283
  17. package/dist/adapters/visual/session-store.d.ts +31 -29
  18. package/dist/adapters/visual/session-store.js +94 -94
  19. package/dist/adapters/visual/wire.d.ts +36 -10
  20. package/dist/adapters/visual-cli.d.ts +3 -0
  21. package/dist/adapters/visual-cli.js +66 -1
  22. package/dist/apply-command.d.ts +10 -0
  23. package/dist/apply-command.js +399 -247
  24. package/dist/cli.js +0 -0
  25. package/dist/compiler.d.ts +66 -0
  26. package/dist/compiler.js +209 -89
  27. package/dist/graph-projection.d.ts +62 -0
  28. package/dist/graph-projection.js +222 -0
  29. package/dist/index.d.ts +2 -2
  30. package/dist/index.js +1 -1
  31. package/dist/interrogate-command.d.ts +2 -0
  32. package/dist/interrogate-command.js +22 -0
  33. package/dist/kind-label.d.ts +8 -0
  34. package/dist/kind-label.js +8 -0
  35. package/dist/operations.d.ts +139 -0
  36. package/dist/operations.js +11 -0
  37. package/dist/projection.d.ts +2 -0
  38. package/dist/projection.js +8 -2
  39. package/dist/reconciliation.js +8 -7
  40. package/dist/source-document.d.ts +10 -0
  41. package/dist/source-document.js +21 -1
  42. package/dist/visual-app/assets/index-6oSR9RGM.js +354 -0
  43. package/dist/visual-app/assets/index-dwA9AOr5.css +1 -0
  44. package/dist/visual-app/index.html +2 -2
  45. package/docs/CONSUMING-YARRAMATE.md +25 -19
  46. package/package.json +9 -4
  47. package/schema/yarramate-adapter-mapping.schema.json +1 -1
  48. package/schema/yarramate-apply-result.schema.json +8 -2
  49. package/schema/yarramate-document.schema.json +1 -1
  50. package/schema/yarramate-likec4-diagnostic-result.schema.json +1 -1
  51. package/schema/yarramate-operations.schema.json +203 -1
  52. package/schema/yarramate-projection.schema.json +12 -3
  53. package/schema/yarramate-question-catalogue.schema.json +15 -2
  54. package/schema/yarramate-visual-event.schema.json +143 -0
  55. package/schema/yarramate-visual-graph.schema.json +272 -0
  56. package/schema/yarramate-visual-layout.schema.json +41 -0
  57. package/schema/yarramate-visual-model.schema.json +6 -44
  58. package/schema/yarramate-visual-response.schema.json +170 -19
  59. package/schema/yarramate-visual-session-descriptor.schema.json +1 -1
  60. package/schema/yarramate-visual-session-request.schema.json +0 -70
  61. package/schema/yarramate-visual-session-started.schema.json +2 -9
  62. package/schema/yarramate-visual-status.schema.json +3 -2
  63. package/skills/yarramate-architecture/SKILL.md +20 -13
  64. package/skills/yarramate-architecture/references/journey-checklists.md +4 -2
  65. package/skills/yarramate-architecture/references/native-authoring.md +30 -0
  66. package/skills/yarramate-architecture/references/visual-conversations.md +149 -150
  67. package/dist/adapters/visual/likec4-compiler.d.ts +0 -55
  68. package/dist/adapters/visual/likec4-compiler.js +0 -460
  69. package/dist/visual-app/assets/index-CGvC8e3R.css +0 -1
  70. package/dist/visual-app/assets/index-CXuW1tOj.js +0 -209
@@ -0,0 +1 @@
1
+ :root{--paper:#e8eef0;--ink:#182228;--eucalyptus:#416f65;--ochre:#8c4d18;--cobalt:#2457a6;--failure:#a3403a;--sheet:color-mix(in oklab, var(--paper) 55%, white);--rule:color-mix(in oklab, var(--ink) 16%, transparent);--rule-firm:color-mix(in oklab, var(--ink) 34%, transparent);--quiet:color-mix(in oklab, var(--ink) 62%, var(--paper));--display:"Iowan Old Style", "Palatino Linotype", Palatino, "Book Antiqua", Georgia, serif;--body:"Avenir Next", Avenir, -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;--utility:ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;--step:.5rem;--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light}*{box-sizing:border-box}html,body{margin:0;padding:0}body{background:var(--paper);color:var(--ink);font-family:var(--body);-webkit-font-smoothing:antialiased;font-size:15px;line-height:1.5}:focus-visible{outline:3px solid var(--cobalt);outline-offset:2px}.offscreen{clip-path:inset(50%);white-space:nowrap;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}.visual-shell{background:var(--paper);min-width:0;height:100dvh;color:var(--ink);grid-template-rows:auto minmax(0,1fr);display:grid;overflow:hidden}.command-strip{z-index:10;justify-content:space-between;align-items:center;gap:calc(var(--step) * 2);min-height:48px;padding:calc(var(--step) * .75) calc(var(--step) * 2);border-bottom:1px solid var(--rule);background:var(--sheet);flex-wrap:wrap;display:flex;position:relative}.command-identity,.command-actions{align-items:center;gap:var(--step);min-width:0;display:flex}.command-identity{flex:10rem}.command-actions{flex-wrap:wrap;flex:0 auto;justify-content:flex-end}.command-identity h1{min-width:8ch;font-family:var(--display);text-overflow:ellipsis;white-space:nowrap;margin:0;font-size:15px;line-height:1.2;overflow:hidden}.command-actions select,.command-actions button,.command-actions .quick-filter{min-height:32px;font-family:var(--utility);letter-spacing:.08em;color:var(--ink);background:var(--paper);border:1px solid var(--rule-firm);cursor:pointer;border-radius:0;padding:0 .7rem;font-size:12px}.command-actions select{text-overflow:ellipsis;max-width:12rem}.command-actions .quick-filter{cursor:text;width:160px}.command-actions .quick-filter::placeholder{color:var(--quiet)}.command-actions select{padding-right:.35rem}.command-actions select:hover:enabled,.command-actions button:hover:enabled,.command-actions .quick-filter:hover,.command-actions .quick-filter:focus{border-color:var(--cobalt)}.command-actions select:disabled,.command-actions button:disabled{color:var(--quiet);border-color:var(--rule);cursor:not-allowed;background:0 0}.command-actions button[aria-expanded=true]{color:var(--paper);background:var(--cobalt);border-color:var(--cobalt)}.command-actions .end-session:hover:enabled{color:var(--paper);background:var(--failure);border-color:var(--failure)}.connection-state{font-family:var(--utility);letter-spacing:.14em;text-transform:uppercase;color:var(--quiet);flex:none;font-size:11px}.end-transition-status{max-width:28rem;font-family:var(--utility);color:var(--quiet);font-size:11px;line-height:1.25}.end-transition-status:empty{display:none}.direction-notice{max-width:16rem;font-family:var(--utility);color:var(--quiet);font-size:11px;line-height:1.25}.direction-notice:empty{display:none}.authority{white-space:nowrap;font-family:var(--utility);letter-spacing:.14em;text-transform:uppercase;color:var(--eucalyptus);flex:none;margin:0;font-size:11px}.authority:before{content:"";vertical-align:0;background:currentColor;width:.5rem;height:.5rem;margin-right:.5rem;display:inline-block}.beta-badge{font-family:var(--utility);letter-spacing:.1em;text-transform:uppercase;color:var(--ochre);border:1px solid var(--ochre);flex:none;padding:.05rem .4rem;font-size:10px;font-weight:600}.session-details{align-items:flex-start;gap:calc(var(--step) * 2);padding:var(--step) calc(var(--step) * 2) calc(var(--step) * 1.5);border-bottom:1px solid var(--rule);background:var(--sheet);display:flex;position:absolute;top:100%;left:0;right:0;box-shadow:0 12px 28px #1323391f}.session-details[hidden]{display:none}.session-details p{max-width:90ch;color:var(--quiet);margin:0}.details-close{min-height:28px;font-family:var(--utility);letter-spacing:.08em;color:var(--ink);background:var(--paper);border:1px solid var(--rule-firm);cursor:pointer;border-radius:0;flex:none;margin-left:auto;padding:0 .6rem;font-size:11px}.details-close:hover{border-color:var(--cobalt)}.attention-count{background:var(--cobalt);color:#fff;text-align:center;border-radius:999px;min-width:1.25rem;padding:0 .35rem;font-size:11px}.workspace{min-width:0;min-height:0;display:grid;overflow:hidden}.workspace-conversation-open{grid-template-columns:minmax(0, 1fr) auto var(--conversation-width)}.workspace-conversation-closed{grid-template-columns:minmax(0,1fr)}.diagram-workspace{background:var(--paper);min-width:0;min-height:0;position:relative;overflow:hidden}.canvas{width:100%;min-width:0;height:100%;min-height:0}.diagram-workspace>.faults{z-index:4;max-height:50%;position:absolute;inset:auto 0 0;overflow:auto}.diagram-workspace>.filter-pill{inset:var(--step) auto auto var(--step);z-index:4;align-items:center;gap:var(--step);max-width:min(52ch, calc(100% - var(--step) * 2));border:1px solid var(--rule-firm);background:var(--sheet);font-family:var(--utility);color:var(--ink);border-radius:999px;padding:.35rem .7rem;font-size:12px;display:flex;position:absolute}.filter-pill span{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.filter-pill code{font-weight:700}.filter-pill button{color:var(--cobalt);font-family:inherit;font-size:inherit;cursor:pointer;background:0 0;border:none;flex:none;padding:0;text-decoration:underline}.filter-pill button:hover{color:var(--ink)}.conversation-separator{z-index:3;cursor:col-resize;touch-action:none;width:10px;height:100%;position:relative}.conversation-separator:before{background:var(--rule);content:"";width:1px;position:absolute;inset:0 auto 0 4px}.conversation-separator:hover:before,.conversation-separator:focus-visible:before{background:var(--cobalt);width:2px}.waiting{padding:calc(var(--step) * 4);font-family:var(--utility);letter-spacing:.1em;text-transform:uppercase;color:var(--quiet);margin:0;font-size:12px}.talk{border-left:1px solid var(--rule);background:var(--sheet);grid-template-rows:minmax(0,1fr) auto;grid-template-columns:minmax(0,1fr);min-width:0;min-height:0;display:grid;overflow:hidden}.talk[hidden]{display:none}.conversation-scroll{min-width:0;min-height:0;overflow:auto}.subject-inspector{min-width:0;padding:calc(var(--step) * 1.5);border-bottom:1px solid var(--rule);background:color-mix(in srgb, var(--sheet) 92%, var(--cobalt) 8%)}.subject-heading-row{justify-content:space-between;align-items:flex-start;gap:var(--step);min-width:0;display:flex}.subject-heading-row>:first-child,.subject-heading-row h2{min-width:0}.subject-type{margin:0 0 calc(var(--step) * .25);color:var(--quiet);letter-spacing:.12em;text-transform:uppercase;font-size:10px;font-weight:700}.subject-heading-row h2{font-family:var(--display);overflow-wrap:anywhere;margin:0;font-size:16px;line-height:1.25}.subject-facts{gap:calc(var(--step) * .5);margin:var(--step) 0;display:grid}.subject-facts>div{gap:var(--step);grid-template-columns:minmax(5.5rem,auto) minmax(0,1fr);display:grid}.subject-facts dt{color:var(--quiet);font-size:11px}.subject-facts dd{overflow-wrap:anywhere;min-width:0;margin:0}.subject-description p{white-space:pre-wrap;overflow-wrap:anywhere;margin:0}.description-clamped{-webkit-line-clamp:3;-webkit-box-orient:vertical;display:-webkit-box;overflow:hidden}.subject-description button,.subject-navigate,.subject-clear{margin-top:calc(var(--step) * .5);min-height:28px}.ledger{padding:calc(var(--step) * 2) calc(var(--step) * 2.5);min-height:0;margin:0;list-style:none;overflow:visible}.ledger .empty p{color:var(--quiet);font-family:var(--utility);margin:0;font-size:12px}.said{padding:0 0 calc(var(--step) * 1.75) calc(var(--step) * 1.5);border-left:2px solid var(--rule)}.said+.said{padding-top:calc(var(--step) * 1.75)}.said-reviewer{border-left-color:var(--cobalt)}.said-agent{border-left-color:var(--eucalyptus)}.said-session{border-left-color:var(--ochre)}.who{font-family:var(--utility);letter-spacing:.16em;text-transform:uppercase;color:var(--quiet);margin:0 0 .15rem;font-size:10px}.words{white-space:pre-wrap;overflow-wrap:anywhere;margin:0}.faults{padding:calc(var(--step) * 1.5) calc(var(--step) * 2.5);border-top:1px solid var(--failure);background:color-mix(in oklab, var(--failure) 8%, var(--sheet))}.faults-title{margin:0 0 var(--step);color:var(--failure);font-size:13px}.faults ul{font-family:var(--utility);margin:0;padding-left:1.1rem;font-size:11px;line-height:1.6}.faults .code{font-weight:700}.faults .where{color:var(--quiet);margin-left:.4rem}.choices{padding:calc(var(--step) * 1.5) calc(var(--step) * 2.5);border-top:1px solid var(--rule)}.question{margin:0 0 var(--step);font-family:var(--display);font-size:1.05rem}.choices ul{gap:var(--step);margin:0;padding:0;list-style:none;display:grid}.choices button{text-align:left;width:100%;font-family:var(--body);color:var(--ink);background:var(--paper);border:1px solid var(--rule-firm);cursor:pointer;border-radius:0;padding:.5rem .7rem;font-size:14px;display:block}.choices button:hover:enabled{border-color:var(--cobalt)}.choices button:disabled{color:var(--quiet);cursor:not-allowed}.choices .detail{color:var(--quiet);font-size:12px;display:block}.composer{padding:calc(var(--step) * 1.5) calc(var(--step) * 2.5) calc(var(--step) * 2);border-top:1px solid var(--rule)}.composer textarea{resize:vertical;width:100%;font-family:var(--body);color:var(--ink);background:var(--paper);border:1px solid var(--rule-firm);border-radius:0;padding:.55rem .65rem;font-size:14px;display:block}.composer textarea:disabled{color:var(--quiet);background:color-mix(in oklab, var(--paper) 70%, var(--sheet));cursor:not-allowed}.composer-foot{justify-content:space-between;align-items:center;gap:var(--step);margin-top:var(--step);display:flex}.agent-status{align-items:center;gap:calc(var(--step) * .5);font-family:var(--utility);letter-spacing:.14em;text-transform:uppercase;color:var(--quiet);margin:0;font-size:10px;display:flex}.agent-spinner{border:1px solid;border-right-color:#0000;border-radius:50%;flex:none;width:.75rem;height:.75rem;animation:.7s linear infinite agent-spinner-turn}@keyframes agent-spinner-turn{to{transform:rotate(1turn)}}.composer button{font-family:var(--utility);letter-spacing:.08em;color:var(--paper);background:var(--cobalt);border:1px solid var(--cobalt);cursor:pointer;border-radius:0;padding:.45rem 1.1rem;font-size:12px}.composer button:disabled{color:var(--quiet);border-color:var(--rule-firm);cursor:not-allowed;background:0 0}.subject-chip{justify-content:space-between;align-items:center;gap:var(--step);margin-bottom:calc(var(--step) * .75);padding:calc(var(--step) * .5) calc(var(--step) * .75);border:1px solid var(--cobalt);color:var(--cobalt);border-radius:999px;display:flex}.subject-chip span{text-overflow:ellipsis;white-space:nowrap;min-width:0;overflow:hidden}.subject-chip button{min-height:24px;padding:0 calc(var(--step) * .5);color:inherit;background:0 0;border:0;flex:none}.filter-panel{position:relative}.filter-panel>button{min-height:32px;font-family:var(--utility);letter-spacing:.08em;color:var(--ink);background:var(--paper);border:1px solid var(--rule-firm);cursor:pointer;border-radius:0;padding:0 .7rem;font-size:12px}.filter-panel>button:hover:enabled{border-color:var(--cobalt)}.filter-panel>button[aria-expanded=true]{color:var(--paper);background:var(--cobalt);border-color:var(--cobalt)}.filter-panel-body{z-index:9;min-width:320px;max-width:480px;padding:calc(var(--step) * 1.5);border:1px solid var(--rule-firm);background:var(--sheet);border-top:none;margin-top:-1px;position:absolute;top:100%;left:0;box-shadow:0 12px 28px #1323391f}.filter-panel-body[hidden]{display:none}.filter-grid{gap:calc(var(--step) * 1.5);grid-template-columns:1fr;display:grid}.filter-field{gap:calc(var(--step) * .75);flex-direction:column;display:flex}.filter-field>label,.filter-field legend{font-family:var(--utility);letter-spacing:.08em;text-transform:uppercase;color:var(--quiet);font-size:11px}.tag-input{align-items:center;gap:var(--step);padding:calc(var(--step) * .5);border:1px solid var(--rule-firm);background:var(--paper);border-radius:2px;flex-wrap:wrap;display:flex}.tag-input input{min-width:80px;font:inherit;background:0 0;border:none;flex:1;font-size:15px}.tag-input input:focus{outline:none}.tag-chip{background:var(--cobalt);color:var(--paper);border-radius:2px;align-items:center;gap:.4rem;padding:.2rem .6rem;font-size:13px;display:inline-flex}.tag-chip button{color:currentColor;cursor:pointer;background:0 0;border:none;min-width:0;min-height:0;margin:0;padding:0;font-size:16px;line-height:1;display:inline}.tag-chip button:hover{opacity:.8}.filter-field select{font-family:var(--body);color:var(--ink);background:var(--paper);border:1px solid var(--rule-firm);cursor:pointer;border-radius:0;padding:.4rem .7rem;font-size:15px}.filter-field select:hover{border-color:var(--cobalt)}.filter-checkbox-group{border:none;margin:0;padding:0}.filter-checkbox-option{cursor:pointer;align-items:center;gap:.5rem;padding:.4rem 0;font-size:15px;display:flex}.filter-checkbox-option input{cursor:pointer}@media (max-width:899px){.command-strip{gap:calc(var(--step) * .5);padding-inline:var(--step)}.command-identity,.command-actions{gap:calc(var(--step) * .5)}.workspace{grid-template-rows:minmax(0,1fr) auto;grid-template-columns:minmax(0,1fr);min-height:0}.conversation-separator{display:none}.talk{border-top:1px solid var(--rule);border-left:0;border-radius:18px 18px 0 0;max-height:56dvh;box-shadow:0 -12px 36px #13233924}}@media (prefers-reduced-motion:reduce){*,:before,:after{scroll-behavior:auto!important;transition-duration:.01ms!important;animation-duration:.01ms!important;animation-iteration-count:1!important}}.save-view-control{display:contents}.save-view-toggle{padding:0 calc(var(--step) * .75rem);border:1px solid var(--rule-firm);background:var(--paper);height:32px;color:var(--ink);cursor:pointer;border-radius:2px;font-size:13px}.save-view-toggle:hover:not(:disabled){border-color:var(--rule);background:color-mix(in oklab, var(--paper) 90%, var(--ink))}.save-view-toggle:disabled{opacity:.5;cursor:not-allowed}.save-view-panel{background:var(--sheet);border:1px solid var(--rule-firm);z-index:10;border-radius:4px;position:absolute;top:calc(100% + 8px);right:0;box-shadow:0 2px 8px #0000001f}.save-view-panel-body{padding:calc(var(--step) * 1.5);min-width:300px}.save-view-form{gap:calc(var(--step) * 1);flex-direction:column;display:flex}.save-view-form div{gap:calc(var(--step) * .5);flex-direction:column;display:flex}.save-view-form label{color:var(--ink);font-size:12px;font-weight:500}.save-view-form input,.save-view-form textarea{padding:calc(var(--step) * .5);border:1px solid var(--rule);font-family:var(--body);border-radius:2px;font-size:13px}.save-view-actions{gap:calc(var(--step) * 1);margin-top:calc(var(--step) * .5);display:flex}.save-view-actions button{padding:calc(var(--step) * .5) calc(var(--step) * 1);border:1px solid var(--rule-firm);background:var(--paper);color:var(--ink);cursor:pointer;border-radius:2px;flex:1;font-size:13px}.save-view-actions button:hover:not(:disabled){background:color-mix(in oklab, var(--paper) 85%, var(--ink))}.save-view-notice{align-items:center;gap:calc(var(--step) * .75);padding:calc(var(--step) * .75) calc(var(--step) * 1.5);background:color-mix(in oklab, var(--eucalyptus) 15%, var(--sheet));border:1px solid var(--eucalyptus);color:var(--ink);border-radius:4px;font-size:13px;display:flex}.save-view-notice button{padding:0 calc(var(--step) * .5);color:var(--eucalyptus);cursor:pointer;background:0 0;border:none;margin-left:auto;font-size:11px;text-decoration:underline}.confirm-dialog-backdrop{z-index:1000;background:#0006;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.confirm-dialog{background:var(--sheet);border:1px solid var(--rule-firm);padding:calc(var(--step) * 2);text-align:center;border-radius:8px;max-width:400px;box-shadow:0 8px 24px #00000029}.confirm-dialog h2{margin:0 0 calc(var(--step) * 1) 0;font-size:16px}.confirm-dialog p{margin:0 0 calc(var(--step) * 1.5) 0;color:var(--quiet);font-size:13px}.confirm-dialog-actions{gap:calc(var(--step) * 1);display:flex}.confirm-dialog-actions button{padding:calc(var(--step) * .75);border:1px solid var(--rule-firm);background:var(--paper);color:var(--ink);cursor:pointer;border-radius:2px;flex:1;font-size:13px}.confirm-dialog-actions button:hover{background:color-mix(in oklab, var(--paper) 85%, var(--ink))}.changeset-tray{padding:calc(var(--step) * 1.5) calc(var(--step) * 2.5);border-top:1px solid var(--rule);background:color-mix(in srgb, var(--sheet) 92%, var(--cobalt) 8%)}.changeset-heading-row{justify-content:space-between;align-items:baseline;gap:var(--step);display:flex}.changeset-heading-row h2{font-family:var(--display);margin:0;font-size:15px}.changeset-discard-all{color:var(--eucalyptus);cursor:pointer;background:0 0;border:none;padding:0;font-size:12px;text-decoration:underline}.changeset-rows{margin:var(--step) 0 0;gap:calc(var(--step) * .75);padding:0;list-style:none;display:grid}.changeset-row{padding:calc(var(--step) * .75);border:1px solid var(--rule-firm);background:var(--paper);border-radius:2px}.changeset-row-line{justify-content:space-between;align-items:center;gap:var(--step);display:flex}.changeset-row-label{overflow-wrap:anywhere;min-width:0;font-family:var(--utility);color:var(--ink);font-size:12px}.changeset-row-discard{color:var(--eucalyptus);cursor:pointer;background:0 0;border:none;flex:none;padding:0;font-size:11px;text-decoration:underline}.changeset-row-diagnostics,.changeset-batch-diagnostics{margin:calc(var(--step) * .5) 0 0;font-family:var(--utility);color:var(--failure);padding-left:1.1rem;font-size:11px}.changeset-batch-diagnostics{margin:0 0 var(--step)}.changeset-row-diagnostics .code,.changeset-batch-diagnostics .code{font-weight:700}.changeset-row-diagnostics .where,.changeset-batch-diagnostics .where{color:var(--quiet);margin-left:.4rem}.changeset-actions{margin-top:var(--step)}.changeset-commit{width:100%;padding:calc(var(--step) * .75);border:1px solid var(--cobalt);background:var(--cobalt);color:var(--paper);cursor:pointer;border-radius:2px;font-size:13px}.changeset-commit:disabled{border-color:var(--rule-firm);color:var(--quiet);cursor:not-allowed;background:0 0}.changeset-notice{margin-top:var(--step);padding:calc(var(--step) * .75) calc(var(--step) * 1);border:1px solid var(--eucalyptus);background:color-mix(in oklab, var(--eucalyptus) 15%, var(--sheet));color:var(--ink);border-radius:4px;font-size:12px}.changeset-notice p{margin:0 0 calc(var(--step) * .25);font-weight:700}.changeset-notice ul{font-family:var(--utility);margin:0;padding-left:1.1rem}.layout-notice-pill{inset:var(--step) var(--step) auto auto;z-index:4;align-items:center;gap:var(--step);max-width:calc(100% - var(--step) * 2);border:1px solid var(--rule-firm);background:var(--sheet);font-family:var(--utility);color:var(--ink);border-radius:999px;padding:.35rem .7rem;font-size:12px;display:flex;position:absolute}.layout-notice-pill span{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.subject-form{gap:calc(var(--step) * 1.25);margin:calc(var(--step) * 1) 0;flex-direction:column;display:flex}.subject-form-field{gap:calc(var(--step) * .35);flex-direction:column;display:flex}.subject-form-label{font-family:var(--utility);letter-spacing:.02em;text-transform:uppercase;color:var(--quiet);font-size:11px}.subject-form-field input[type=text],.subject-form-field select{border:1px solid var(--rule-firm);border-radius:calc(var(--step) * .5);background:var(--paper);font-family:var(--body);color:var(--ink);padding:.35rem .5rem;font-size:13px}.subject-form-list{border-top:1px solid var(--rule);padding-top:calc(var(--step) * .75)}.subject-form-row{align-items:flex-start;gap:calc(var(--step) * .5);margin-bottom:calc(var(--step) * .5);display:flex}.subject-form-row-body{align-items:center;gap:calc(var(--step) * .5);flex-wrap:wrap;flex:1;display:flex}.subject-form-toggle{align-items:center;gap:calc(var(--step) * .35);font-family:var(--utility);color:var(--quiet);font-size:12px;display:flex}.subject-form-row-add,.subject-form-row-remove{border:1px solid var(--rule-firm);border-radius:calc(var(--step) * .5);background:var(--sheet);font-family:var(--utility);cursor:pointer;padding:.25rem .6rem;font-size:12px}
@@ -5,8 +5,8 @@
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
6
  <meta name="referrer" content="no-referrer" />
7
7
  <title>YarraMate visual session</title>
8
- <script type="module" crossorigin src="./assets/index-CXuW1tOj.js"></script>
9
- <link rel="stylesheet" crossorigin href="./assets/index-CGvC8e3R.css">
8
+ <script type="module" crossorigin src="./assets/index-6oSR9RGM.js"></script>
9
+ <link rel="stylesheet" crossorigin href="./assets/index-dwA9AOr5.css">
10
10
  </head>
11
11
  <body>
12
12
  <div id="visual-session"></div>
@@ -165,29 +165,35 @@ provides the journey. Neither contains the other.
165
165
 
166
166
  What the journey guarantees:
167
167
 
168
- - **Authority is labelled.** Repository architecture is rendered only from a
169
- workspace that passes `yarramate check`, through
170
- `yarramate ask <workspace> "<topic>" --json`. Everything else — general
171
- questions, hypotheticals, comparisons of undecided options — is rendered as
172
- a temporary `ad-hoc` model the browser labels non-canonical. A choice
173
- confirmed in the browser is a recorded selection, not declared intent; it
174
- becomes canonical only through the normal design journey and Git review.
168
+ - **Authority is canonical, and labelled.** A session renders one workspace
169
+ that passed `yarramate check`, through
170
+ `yarramate ask <workspace> "<topic>" --json`. There is no non-canonical
171
+ rendering mode: the browser names the model it is showing, and every edit is
172
+ judged against that workspace.
175
173
  - **The server is local only.** It binds `127.0.0.1` on a random port, issues
176
174
  separate browser and agent credentials, ships no external assets, and stores
177
175
  no provider credentials. Session state lives under the ignored
178
176
  `.yarramate-out/visual/` directory and is never canonical.
179
- - **The renderer is consented.** The skill prefers a repository-local
180
- `likec4` in `>=1.59.2 <1.60.0`. With none available it asks once before
181
- resolving the pinned `likec4@1.59.2` runner, which needs Node `>=22.22.3`
182
- and adds no dependency to your repository. The semantic binaries keep the
183
- package's existing Node contract.
184
- - **Chat is capability-gated.** Where the harness can delegate a child agent,
185
- deliver its completion back, and stay interruptible, the browser carries a
186
- chat widget answered by a bounded visual agent. That agent may replace only
187
- the temporary session model; it cannot edit repository files, `.yarramate/`,
188
- credentials, or harness configuration.
189
- - **Otherwise you get diagram-only mode.** The same custom renderer and view
190
- navigation, with the conversation continuing in the main harness.
177
+ - **The renderer is native and dependency-free.** cytoscape.js draws the
178
+ compiled graph v2 model directly in the prebuilt browser application. There
179
+ is no DSL round-trip, no external renderer to resolve, and no consent
180
+ prompt; the visual binary keeps the package's existing Node contract.
181
+ - **Editing is mechanical, and it lands through `apply`.** Inspector fields are
182
+ constrained to what the model allows, edits accumulate in a changeset, and
183
+ **Commit changes** submits them as one `yarramate/operations/v1` batch
184
+ through the same validated `yarramate apply` write the CLI performs. A
185
+ refused batch writes nothing and returns the diagnostics that refused it. A
186
+ landed batch is an ordinary working-tree change — the runtime never runs
187
+ `git commit`, so Git review still decides what becomes declared
188
+ architecture, and revert is `git revert`.
189
+ - **Chat explains, filters, and focuses; it cannot mutate.** Where the harness
190
+ can delegate a child agent, deliver its completion back, and stay
191
+ interruptible, the browser carries a chat widget answered by a bounded visual
192
+ agent. That agent cannot author a model, edit repository files,
193
+ `.yarramate/`, credentials, or harness configuration; a filter it applies is
194
+ evaluated server-side, badged on the canvas, and dismissible in one click.
195
+ - **Otherwise you get diagram-only mode.** The same renderer, view navigation,
196
+ filtering, and editing, with the conversation continuing in the main harness.
191
197
  - **Recovery is the main agent's.** On End, cancellation, or any failure the
192
198
  main agent recovers a structured handoff — confirmed decisions, requested
193
199
  changes, unresolved questions, final views, termination reason — before
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "yarramate",
3
- "version": "0.18.0",
3
+ "version": "0.20.0",
4
4
  "description": "Tool-neutral semantic architecture engine and guided methodology",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -79,7 +79,9 @@
79
79
  "./schema/visual-event": "./schema/yarramate-visual-event.schema.json",
80
80
  "./schema/visual-response": "./schema/yarramate-visual-response.schema.json",
81
81
  "./schema/visual-model": "./schema/yarramate-visual-model.schema.json",
82
+ "./schema/visual-graph": "./schema/yarramate-visual-graph.schema.json",
82
83
  "./schema/visual-handoff": "./schema/yarramate-visual-handoff.schema.json",
84
+ "./schema/visual-layout": "./schema/yarramate-visual-layout.schema.json",
83
85
  "./schema/visual-status": "./schema/yarramate-visual-status.schema.json",
84
86
  "./schema/visual-diagnostic-result": "./schema/yarramate-visual-diagnostic-result.schema.json"
85
87
  },
@@ -111,7 +113,8 @@
111
113
  "self:check:likec4": "pnpm build && node dist/adapters/likec4-cli.js check .yarramate/likec4-project.yaml .yarramate/workspace.yaml",
112
114
  "self:check:likec4:json": "pnpm build && node dist/adapters/likec4-cli.js check .yarramate/likec4-project.yaml --json .yarramate/workspace.yaml",
113
115
  "self:export:likec4": "pnpm build && node dist/adapters/likec4-cli.js export-project .yarramate/likec4-project.yaml .yarramate-out/likec4 .yarramate/workspace.yaml",
114
- "validate": "pnpm self:export:likec4 && likec4 validate --no-layout .yarramate-out/likec4",
116
+ "self:check:likec4:output": "pnpm build && node dist/adapters/likec4-cli.js export-project --check .yarramate/likec4-project.yaml .yarramate-out/likec4 .yarramate/workspace.yaml",
117
+ "validate": "pnpm self:export:likec4 && pnpm self:check:likec4:output && likec4 validate --no-layout .yarramate-out/likec4",
115
118
  "verify": "pnpm typecheck && pnpm build && pnpm test && pnpm self:check && pnpm validate",
116
119
  "test": "vitest run",
117
120
  "typecheck": "tsc --noEmit && tsc -p tsconfig.visual.json"
@@ -122,12 +125,14 @@
122
125
  "yaml": "^2.8.1"
123
126
  },
124
127
  "devDependencies": {
125
- "@likec4/core": "1.59.2",
126
128
  "@types/node": "^26.1.2",
127
129
  "@types/react": "^19.2.18",
128
130
  "@types/react-dom": "^19.2.4",
129
131
  "@types/ws": "^8.18.1",
130
- "likec4": "^1.59.2",
132
+ "cytoscape": "^3.34.1",
133
+ "cytoscape-elk": "^2.3.0",
134
+ "elkjs": "^0.12.0",
135
+ "likec4": "1.59.2",
131
136
  "react": "^19.2.8",
132
137
  "react-dom": "^19.2.8",
133
138
  "typescript": "^7.0.2",
@@ -37,7 +37,7 @@
37
37
  },
38
38
  "nonEmptyText": {
39
39
  "type": "string",
40
- "minLength": 1
40
+ "pattern": "\\S"
41
41
  },
42
42
  "mapping": {
43
43
  "type": "object",
@@ -17,7 +17,10 @@
17
17
  "updatedConcepts",
18
18
  "updatedRelationships",
19
19
  "deletedConcepts",
20
- "deletedRelationships"
20
+ "deletedRelationships",
21
+ "addedObservations",
22
+ "updatedObservations",
23
+ "deletedObservations"
21
24
  ],
22
25
  "properties": {
23
26
  "addedConcepts": { "type": "integer", "minimum": 0 },
@@ -25,7 +28,10 @@
25
28
  "updatedConcepts": { "type": "integer", "minimum": 0 },
26
29
  "updatedRelationships": { "type": "integer", "minimum": 0 },
27
30
  "deletedConcepts": { "type": "integer", "minimum": 0 },
28
- "deletedRelationships": { "type": "integer", "minimum": 0 }
31
+ "deletedRelationships": { "type": "integer", "minimum": 0 },
32
+ "addedObservations": { "type": "integer", "minimum": 0 },
33
+ "updatedObservations": { "type": "integer", "minimum": 0 },
34
+ "deletedObservations": { "type": "integer", "minimum": 0 }
29
35
  }
30
36
  },
31
37
  "documents": {
@@ -48,7 +48,7 @@
48
48
  },
49
49
  "nonEmptyText": {
50
50
  "type": "string",
51
- "minLength": 1
51
+ "pattern": "\\S"
52
52
  },
53
53
  "reference": {
54
54
  "type": "string",
@@ -34,7 +34,7 @@
34
34
  "const": "error"
35
35
  },
36
36
  "code": {
37
- "enum": ["YMLC101", "YMLC102", "YMLC103", "YMLC104", "YMLC105", "YMLC106", "YMLC107", "YMLC108", "YMLC109", "YMLC110"]
37
+ "enum": ["YMLC101", "YMLC102", "YMLC103", "YMLC104", "YMLC105", "YMLC106", "YMLC107", "YMLC108", "YMLC109", "YMLC110", "YMLC111", "YMLC112"]
38
38
  },
39
39
  "message": {
40
40
  "type": "string",
@@ -24,7 +24,7 @@
24
24
  "$defs": {
25
25
  "nonEmptyText": {
26
26
  "type": "string",
27
- "minLength": 1
27
+ "pattern": "\\S"
28
28
  },
29
29
  "identifiedReference": {
30
30
  "type": "object",
@@ -247,7 +247,146 @@
247
247
  }
248
248
  }
249
249
  },
250
+ "observationTarget": {
251
+ "type": "object",
252
+ "additionalProperties": false,
253
+ "properties": {
254
+ "subject": {
255
+ "$ref": "#/$defs/nonEmptyText"
256
+ },
257
+ "claim": {
258
+ "$ref": "#/$defs/nonEmptyText"
259
+ },
260
+ "key": {
261
+ "$ref": "#/$defs/nonEmptyText"
262
+ }
263
+ },
264
+ "oneOf": [
265
+ {
266
+ "required": ["subject"],
267
+ "not": {
268
+ "required": ["claim"]
269
+ }
270
+ },
271
+ {
272
+ "required": ["claim"],
273
+ "not": {
274
+ "required": ["subject"]
275
+ }
276
+ }
277
+ ]
278
+ },
279
+ "observationFields": {
280
+ "type": "object",
281
+ "additionalProperties": false,
282
+ "dependentRequired": {
283
+ "key": ["value"],
284
+ "value": ["key"]
285
+ },
286
+ "properties": {
287
+ "subject": {
288
+ "$ref": "#/$defs/nonEmptyText"
289
+ },
290
+ "claim": {
291
+ "$ref": "#/$defs/nonEmptyText"
292
+ },
293
+ "key": {
294
+ "$ref": "#/$defs/nonEmptyText"
295
+ },
296
+ "value": {
297
+ "$ref": "#/$defs/nonEmptyText"
298
+ },
299
+ "result": {
300
+ "enum": ["confirmed", "contradicted", "unknown", "not-observed"]
301
+ },
302
+ "evidence": {
303
+ "type": "object",
304
+ "additionalProperties": false,
305
+ "required": ["uri"],
306
+ "properties": {
307
+ "uri": {
308
+ "$ref": "#/$defs/nonEmptyText"
309
+ },
310
+ "message": {
311
+ "$ref": "#/$defs/nonEmptyText"
312
+ }
313
+ }
314
+ }
315
+ },
316
+ "oneOf": [
317
+ {
318
+ "required": ["subject"],
319
+ "not": {
320
+ "required": ["claim"]
321
+ }
322
+ },
323
+ {
324
+ "required": ["claim"],
325
+ "not": {
326
+ "required": ["subject"]
327
+ }
328
+ }
329
+ ]
330
+ },
331
+ "observationChange": {
332
+ "type": "object",
333
+ "additionalProperties": false,
334
+ "dependentRequired": {
335
+ "value": ["key"]
336
+ },
337
+ "properties": {
338
+ "subject": {
339
+ "$ref": "#/$defs/nonEmptyText"
340
+ },
341
+ "claim": {
342
+ "$ref": "#/$defs/nonEmptyText"
343
+ },
344
+ "key": {
345
+ "$ref": "#/$defs/nonEmptyText"
346
+ },
347
+ "value": {
348
+ "$ref": "#/$defs/nonEmptyText"
349
+ },
350
+ "result": {
351
+ "enum": ["confirmed", "contradicted", "unknown", "not-observed"]
352
+ },
353
+ "evidence": {
354
+ "type": "object",
355
+ "additionalProperties": false,
356
+ "properties": {
357
+ "uri": {
358
+ "$ref": "#/$defs/nonEmptyText"
359
+ },
360
+ "message": {
361
+ "$ref": "#/$defs/nonEmptyText"
362
+ }
363
+ }
364
+ }
365
+ },
366
+ "oneOf": [
367
+ {
368
+ "required": ["subject"],
369
+ "not": {
370
+ "required": ["claim"]
371
+ }
372
+ },
373
+ {
374
+ "required": ["claim"],
375
+ "not": {
376
+ "required": ["subject"]
377
+ }
378
+ }
379
+ ]
380
+ },
250
381
  "operation": {
382
+ "description": "A discriminated union: the `op` tag selects exactly one branch, so a malformed operation is reported against the shape its author named rather than against all nine.",
383
+ "type": "object",
384
+ "required": [
385
+ "op"
386
+ ],
387
+ "discriminator": {
388
+ "propertyName": "op"
389
+ },
251
390
  "oneOf": [
252
391
  {
253
392
  "type": "object",
@@ -447,6 +586,69 @@
447
586
  "$ref": "#/$defs/deleteTarget"
448
587
  }
449
588
  }
589
+ },
590
+ {
591
+ "type": "object",
592
+ "additionalProperties": false,
593
+ "required": ["op", "document", "observation"],
594
+ "properties": {
595
+ "op": {
596
+ "const": "add-observation"
597
+ },
598
+ "document": {
599
+ "$ref": "#/$defs/nonEmptyText"
600
+ },
601
+ "observation": {
602
+ "allOf": [
603
+ {
604
+ "$ref": "#/$defs/observationFields"
605
+ },
606
+ {
607
+ "type": "object",
608
+ "required": ["result", "evidence"]
609
+ }
610
+ ]
611
+ }
612
+ }
613
+ },
614
+ {
615
+ "type": "object",
616
+ "additionalProperties": false,
617
+ "required": ["op", "document", "observation"],
618
+ "properties": {
619
+ "op": {
620
+ "const": "update-observation"
621
+ },
622
+ "document": {
623
+ "$ref": "#/$defs/nonEmptyText"
624
+ },
625
+ "observation": {
626
+ "$ref": "#/$defs/observationChange"
627
+ },
628
+ "remove": {
629
+ "type": "array",
630
+ "minItems": 1,
631
+ "items": {
632
+ "enum": ["message"]
633
+ }
634
+ }
635
+ }
636
+ },
637
+ {
638
+ "type": "object",
639
+ "additionalProperties": false,
640
+ "required": ["op", "document", "observation"],
641
+ "properties": {
642
+ "op": {
643
+ "const": "delete-observation"
644
+ },
645
+ "document": {
646
+ "$ref": "#/$defs/nonEmptyText"
647
+ },
648
+ "observation": {
649
+ "$ref": "#/$defs/observationTarget"
650
+ }
651
+ }
450
652
  }
451
653
  ]
452
654
  }
@@ -16,6 +16,14 @@
16
16
  "type": "string",
17
17
  "pattern": "^[0-9]+\\.[0-9]+$"
18
18
  },
19
+ "query": {
20
+ "$ref": "#/$defs/query"
21
+ },
22
+ "presentation": {
23
+ "$ref": "#/$defs/presentation"
24
+ }
25
+ },
26
+ "$defs": {
19
27
  "query": {
20
28
  "type": "object",
21
29
  "additionalProperties": false,
@@ -135,6 +143,9 @@
135
143
  },
136
144
  "showOwnership": {
137
145
  "type": "boolean"
146
+ },
147
+ "notation": {
148
+ "enum": ["native", "archimate"]
138
149
  }
139
150
  },
140
151
  "allOf": [
@@ -147,9 +158,7 @@
147
158
  }
148
159
  }
149
160
  ]
150
- }
151
- },
152
- "$defs": {
161
+ },
153
162
  "id": {
154
163
  "type": "string",
155
164
  "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
@@ -346,6 +346,19 @@
346
346
  "const": "near-duplicate"
347
347
  }
348
348
  }
349
+ },
350
+ {
351
+ "type": "object",
352
+ "additionalProperties": false,
353
+ "description": "The subject's kind is never tested by anything the compiler can check: it participates in no relationship whose kind pins the aspect at the subject's end, so reclassifying it to any other kind of any other aspect would still compile. The kind is a label rather than a constraint (ADR 0083).",
354
+ "required": [
355
+ "condition"
356
+ ],
357
+ "properties": {
358
+ "condition": {
359
+ "const": "unconstrained-kind"
360
+ }
361
+ }
349
362
  }
350
363
  ]
351
364
  },
@@ -399,9 +412,9 @@
399
412
  "$ref": "#/$defs/nonEmptyText"
400
413
  },
401
414
  "authority": {
402
- "description": "Who may answer. evidence: an agent may propose the answer from repository evidence (still lands as a reviewable diff). human: a genuine design decision that must be escalated. either: evidence may propose, human confirms.",
415
+ "description": "Who may answer. A label carried into reports, never a gate (ADR 0082). agent: an agent may propose the answer from repository evidence (still lands as a reviewable diff). human: a genuine design decision that must be escalated. either: an agent may propose, a human confirms.",
403
416
  "enum": [
404
- "evidence",
417
+ "agent",
405
418
  "human",
406
419
  "either"
407
420
  ]