@uniqbit/mate-core 0.18.1-canary.4 → 0.18.1

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 (24) hide show
  1. package/package.json +1 -1
  2. package/src/cli/commands/report/delivery.ts +50 -0
  3. package/src/cli/commands/report/index.ts +22 -4
  4. package/src/cli/commands/studio/access.ts +6 -0
  5. package/src/cli/commands/studio/actions.ts +87 -0
  6. package/src/cli/commands/studio/reports.ts +176 -0
  7. package/src/cli/commands/studio/routes.ts +12 -0
  8. package/src/cli/commands/studio/selection.ts +2 -1
  9. package/src/cli/commands/studio/server.ts +276 -4
  10. package/src/cli/commands/studio/terminal-launch.ts +38 -3
  11. package/src/cli/commands/studio/terminal.ts +48 -4
  12. package/src/cli/commands/studio/vault.ts +55 -8
  13. package/src/cli/commands/studio/views/client.ts +263 -27
  14. package/src/cli/commands/studio/views/document.tsx +168 -20
  15. package/src/cli/commands/studio/views/model.ts +2 -0
  16. package/src/cli/commands/studio/views/reports/index.tsx +49 -0
  17. package/src/cli/commands/studio/views/specs/index.tsx +65 -9
  18. package/src/cli/commands/studio/views/styles.ts +26 -6
  19. package/src/cli/commands/studio/views/terminal.tsx +62 -4
  20. package/src/cli/commands/studio/views/vault/state.ts +1 -0
  21. package/src/templates/mate-skills/agents/mate-show-me/SKILL.md +11 -5
  22. package/src/templates/mate-skills/claude/mate-show-me/SKILL.md +11 -5
  23. package/src/tools/setup/__snapshots__/runtime-surface-golden.test.ts.snap +12 -12
  24. package/src/tools/setup/mate.ts +1 -1
package/src/templates/mate-skills/agents/mate-show-me/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: mate-show-me
3
- description: Explain the current topic or the applied change in a browser-rendered Mate report. Use only when the user explicitly invokes the skill to see how something works, what a change did, or wants a diagram, call tree, or rendered diff of the current work.
3
+ description: Explain the current topic, the applied change, or a named spec capability in a browser-rendered Mate report. Use only when the user explicitly invokes the skill to see how something works, what a change did, what a spec capability specifies, or wants a diagram, call tree, or rendered diff of the current work.
4
4
  disable-model-invocation: true
5
5
  allowed-tools: Bash(git:*), Bash(mate:*)
6
6
  license: MIT
@@ -19,9 +19,15 @@ metadata:
19
19
 
20
20
  Explain the current topic visually in a browser-rendered Mate report. Skip the preamble, keep prose brief, and pick the smallest report view that makes the key point clear.
21
21
 
22
+ ## Subject
23
+
24
+ - With no argument, explain the current topic or the applied change, as described below.
25
+ - With an argument naming a spec capability (`$ARGUMENTS`, for example `acme-capability`), explain that capability instead: read its canonical spec under `openspec/specs/` in the Companion Repository and report its purpose, its requirements, and the flow or structure they establish. Name the capability in the report `metadata`, include a `diagram` section, and omit the `diff` section.
26
+ - When the named capability has no canonical spec, say so, suggest close capability names from `openspec/specs/`, and write nothing: no report, no file.
27
+
22
28
  ## Mate Workflow
23
29
 
24
- - Explanation only. Never write or edit source code, tests, documentation, OpenSpec artifacts, context files, or ADRs. The only file this skill produces is the report document handed to `mate report --input`, which the CLI writes into the operating system temporary directory.
30
+ - Explanation only. Never write or edit source code, tests, documentation, OpenSpec artifacts, context files, or ADRs. The only file this skill produces is the report document handed to `mate report --input`; the CLI hosts or opens the rendered report.
25
31
  - Draw from the repositories, not from memory. Every diagram and every diff line comes from the inspected repository state, never from recollection of the conversation. Use the available code-graph tools before broad source scans.
26
32
  - Code lives in the Working Repository; the Companion Repository holds only artifacts. Run `git diff` in the Working Repository.
27
33
  - Never put an absolute local path, home directory, username, machine name, temporary report path, Companion Repository path, or raw path-valued environment variable in the report. Use repository-relative paths or neutral labels such as `Working Repository` and `Companion Repository`.
@@ -29,7 +35,7 @@ Explain the current topic visually in a browser-rendered Mate report. Skip the p
29
35
 
30
36
  ## Browser Report Required
31
37
 
32
- Always assemble and open a Mate report, even when a small inline sketch would be sufficient. Do not answer with an inline-only visual or paste the complete diagram or diff into the conversation. The final response should briefly state what the browser report shows without repeating its temporary file path.
38
+ Always assemble and open a Mate report, even when a small inline sketch would be sufficient. Do not answer with an inline-only visual or paste the complete diagram or diff into the conversation. The final response should briefly state what the report shows, relaying the link or Studio instruction `mate report` printed, without repeating any temporary file path.
33
39
 
34
40
  ## Report Contents
35
41
 
@@ -85,9 +91,9 @@ src/
85
91
 
86
92
  ## Browser Delivery
87
93
 
88
- The report is mandatory. Prefer `mate report --input <temporary-json-file>` without `--json` so the CLI reads the complete document reliably, writes self-contained HTML, and opens it in the default browser. The CLI also supports `mate report --input -` when JSON is piped to stdin; if stdin delivery reports empty or truncated JSON, switch to a temporary JSON file rather than retrying the same transport. If validation fails, fix the report document and retry; do not fall back to an inline explanation or JSON-only delivery.
94
+ The report is mandatory. Prefer `mate report --input <temporary-json-file>` without `--json` so the CLI reads the complete document reliably and renders self-contained HTML. The CLI chooses the surface: inside a Studio terminal it hosts the report in Studio, elsewhere it opens it in the default browser. The CLI also supports `mate report --input -` when JSON is piped to stdin; if stdin delivery reports empty or truncated JSON, switch to a temporary JSON file rather than retrying the same transport. If validation fails, fix the report document and retry; do not fall back to an inline explanation or JSON-only delivery.
89
95
 
90
- Never hand-write an HTML file, never start a server, and never open a browser by any other means. `mate report` is the only browser surface.
96
+ Deliver only through `mate report --input`. Never hand-write an HTML file, start a server, or open a browser yourself. Relay what the CLI prints: a full link when it prints one, otherwise its instruction to open Studio → Reports. Do not invent a link, and do not repeat any loopback address or credential.
91
97
 
92
98
  ## Assembling The Report
93
99
 
package/src/templates/mate-skills/claude/mate-show-me/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: mate-show-me
3
- description: Explain the current topic or the applied change in a browser-rendered Mate report. Use only when the user explicitly invokes the skill to see how something works, what a change did, or wants a diagram, call tree, or rendered diff of the current work.
3
+ description: Explain the current topic, the applied change, or a named spec capability in a browser-rendered Mate report. Use only when the user explicitly invokes the skill to see how something works, what a change did, what a spec capability specifies, or wants a diagram, call tree, or rendered diff of the current work.
4
4
  disable-model-invocation: true
5
5
  allowed-tools: Bash(git:*), Bash(mate:*)
6
6
  license: MIT
@@ -19,9 +19,15 @@ metadata:
19
19
 
20
20
  Explain the current topic visually in a browser-rendered Mate report. Skip the preamble, keep prose brief, and pick the smallest report view that makes the key point clear.
21
21
 
22
+ ## Subject
23
+
24
+ - With no argument, explain the current topic or the applied change, as described below.
25
+ - With an argument naming a spec capability (`$ARGUMENTS`, for example `acme-capability`), explain that capability instead: read its canonical spec under `openspec/specs/` in the Companion Repository and report its purpose, its requirements, and the flow or structure they establish. Name the capability in the report `metadata`, include a `diagram` section, and omit the `diff` section.
26
+ - When the named capability has no canonical spec, say so, suggest close capability names from `openspec/specs/`, and write nothing: no report, no file.
27
+
22
28
  ## Mate Workflow
23
29
 
24
- - Explanation only. Never write or edit source code, tests, documentation, OpenSpec artifacts, context files, or ADRs. The only file this skill produces is the report document handed to `mate report --input`, which the CLI writes into the operating system temporary directory.
30
+ - Explanation only. Never write or edit source code, tests, documentation, OpenSpec artifacts, context files, or ADRs. The only file this skill produces is the report document handed to `mate report --input`; the CLI hosts or opens the rendered report.
25
31
  - Draw from the repositories, not from memory. Every diagram and every diff line comes from the inspected repository state, never from recollection of the conversation. Use the available code-graph tools before broad source scans.
26
32
  - Code lives in the Working Repository; the Companion Repository holds only artifacts. Run `git diff` in the Working Repository.
27
33
  - Never put an absolute local path, home directory, username, machine name, temporary report path, Companion Repository path, or raw path-valued environment variable in the report. Use repository-relative paths or neutral labels such as `Working Repository` and `Companion Repository`.
@@ -29,7 +35,7 @@ Explain the current topic visually in a browser-rendered Mate report. Skip the p
29
35
 
30
36
  ## Browser Report Required
31
37
 
32
- Always assemble and open a Mate report, even when a small inline sketch would be sufficient. Do not answer with an inline-only visual or paste the complete diagram or diff into the conversation. The final response should briefly state what the browser report shows without repeating its temporary file path.
38
+ Always assemble and open a Mate report, even when a small inline sketch would be sufficient. Do not answer with an inline-only visual or paste the complete diagram or diff into the conversation. The final response should briefly state what the report shows, relaying the link or Studio instruction `mate report` printed, without repeating any temporary file path.
33
39
 
34
40
  ## Report Contents
35
41
 
@@ -85,9 +91,9 @@ src/
85
91
 
86
92
  ## Browser Delivery
87
93
 
88
- The report is mandatory. Prefer `mate report --input <temporary-json-file>` without `--json` so the CLI reads the complete document reliably, writes self-contained HTML, and opens it in the default browser. The CLI also supports `mate report --input -` when JSON is piped to stdin; if stdin delivery reports empty or truncated JSON, switch to a temporary JSON file rather than retrying the same transport. If validation fails, fix the report document and retry; do not fall back to an inline explanation or JSON-only delivery.
94
+ The report is mandatory. Prefer `mate report --input <temporary-json-file>` without `--json` so the CLI reads the complete document reliably and renders self-contained HTML. The CLI chooses the surface: inside a Studio terminal it hosts the report in Studio, elsewhere it opens it in the default browser. The CLI also supports `mate report --input -` when JSON is piped to stdin; if stdin delivery reports empty or truncated JSON, switch to a temporary JSON file rather than retrying the same transport. If validation fails, fix the report document and retry; do not fall back to an inline explanation or JSON-only delivery.
89
95
 
90
- Never hand-write an HTML file, never start a server, and never open a browser by any other means. `mate report` is the only browser surface.
96
+ Deliver only through `mate report --input`. Never hand-write an HTML file, start a server, or open a browser yourself. Relay what the CLI prints: a full link when it prints one, otherwise its instruction to open Studio → Reports. Do not invent a link, and do not repeat any loopback address or credential.
91
97
 
92
98
  ## Assembling The Report
93
99
 
package/src/tools/setup/__snapshots__/runtime-surface-golden.test.ts.snap CHANGED
@@ -2945,7 +2945,7 @@ exports[`runtime surface golden fixtures setup openspec × claude 1`] = `
2945
2945
  "claudeSkills": {
2946
2946
  "mate-artifact-publish/SKILL.md": "9ae069fc6d0d",
2947
2947
  "mate-artifact-publish/references/openspec.md": "b5c986ed9bdc",
2948
- "mate-create-report/SKILL.md": "4dda64fab7b7",
2948
+ "mate-create-report/SKILL.md": "020b5c3a53ce",
2949
2949
  "mate-domain-modeling/SKILL.md": "722d0e5a972d",
2950
2950
  "mate-domain-modeling/references/ADR-FORMAT.md": "824b87e87d9b",
2951
2951
  "mate-domain-modeling/references/CONTEXT-FORMAT.md": "172622594277",
@@ -2954,7 +2954,7 @@ exports[`runtime surface golden fixtures setup openspec × claude 1`] = `
2954
2954
  "mate-grilling/SKILL.md": "f37ff4dd9b6d",
2955
2955
  "mate-interview-me/SKILL.md": "5ac966ca1e48",
2956
2956
  "mate-openspec-backfill/SKILL.md": "fa73daee9951",
2957
- "mate-show-me/SKILL.md": "7ccd84f967cf",
2957
+ "mate-show-me/SKILL.md": "42bdac3dd7f2",
2958
2958
  "mate-simplify-code/SKILL.md": "6fff7fff920c",
2959
2959
  "openspec-apply-change/SKILL.md": "b023edd228ab",
2960
2960
  "openspec-archive-change/SKILL.md": "890bada99035",
@@ -3156,7 +3156,7 @@ exports[`runtime surface golden fixtures setup openspec × opencode 1`] = `
3156
3156
  ".openspec-target": "38700dfad571",
3157
3157
  "mate-artifact-publish/SKILL.md": "9ae069fc6d0d",
3158
3158
  "mate-artifact-publish/references/openspec.md": "b5c986ed9bdc",
3159
- "mate-create-report/SKILL.md": "4dda64fab7b7",
3159
+ "mate-create-report/SKILL.md": "020b5c3a53ce",
3160
3160
  "mate-domain-modeling/SKILL.md": "722d0e5a972d",
3161
3161
  "mate-domain-modeling/references/ADR-FORMAT.md": "824b87e87d9b",
3162
3162
  "mate-domain-modeling/references/CONTEXT-FORMAT.md": "172622594277",
@@ -3165,7 +3165,7 @@ exports[`runtime surface golden fixtures setup openspec × opencode 1`] = `
3165
3165
  "mate-grilling/SKILL.md": "f37ff4dd9b6d",
3166
3166
  "mate-interview-me/SKILL.md": "5ac966ca1e48",
3167
3167
  "mate-openspec-backfill/SKILL.md": "fa73daee9951",
3168
- "mate-show-me/SKILL.md": "7ccd84f967cf",
3168
+ "mate-show-me/SKILL.md": "42bdac3dd7f2",
3169
3169
  "mate-simplify-code/SKILL.md": "6fff7fff920c",
3170
3170
  "openspec-apply-change/SKILL.md": "c657f1b4e9eb",
3171
3171
  "openspec-archive-change/SKILL.md": "ad2463670c0f",
@@ -3335,7 +3335,7 @@ exports[`runtime surface golden fixtures setup openspec × claude+opencode 1`] =
3335
3335
  "claudeSkills": {
3336
3336
  "mate-artifact-publish/SKILL.md": "9ae069fc6d0d",
3337
3337
  "mate-artifact-publish/references/openspec.md": "b5c986ed9bdc",
3338
- "mate-create-report/SKILL.md": "4dda64fab7b7",
3338
+ "mate-create-report/SKILL.md": "020b5c3a53ce",
3339
3339
  "mate-domain-modeling/SKILL.md": "722d0e5a972d",
3340
3340
  "mate-domain-modeling/references/ADR-FORMAT.md": "824b87e87d9b",
3341
3341
  "mate-domain-modeling/references/CONTEXT-FORMAT.md": "172622594277",
@@ -3344,7 +3344,7 @@ exports[`runtime surface golden fixtures setup openspec × claude+opencode 1`] =
3344
3344
  "mate-grilling/SKILL.md": "f37ff4dd9b6d",
3345
3345
  "mate-interview-me/SKILL.md": "5ac966ca1e48",
3346
3346
  "mate-openspec-backfill/SKILL.md": "fa73daee9951",
3347
- "mate-show-me/SKILL.md": "7ccd84f967cf",
3347
+ "mate-show-me/SKILL.md": "42bdac3dd7f2",
3348
3348
  "mate-simplify-code/SKILL.md": "6fff7fff920c",
3349
3349
  "openspec-apply-change/SKILL.md": "b023edd228ab",
3350
3350
  "openspec-archive-change/SKILL.md": "890bada99035",
@@ -3375,7 +3375,7 @@ exports[`runtime surface golden fixtures setup openspec × claude+opencode 1`] =
3375
3375
  ".openspec-target": "38700dfad571",
3376
3376
  "mate-artifact-publish/SKILL.md": "9ae069fc6d0d",
3377
3377
  "mate-artifact-publish/references/openspec.md": "b5c986ed9bdc",
3378
- "mate-create-report/SKILL.md": "4dda64fab7b7",
3378
+ "mate-create-report/SKILL.md": "020b5c3a53ce",
3379
3379
  "mate-domain-modeling/SKILL.md": "722d0e5a972d",
3380
3380
  "mate-domain-modeling/references/ADR-FORMAT.md": "824b87e87d9b",
3381
3381
  "mate-domain-modeling/references/CONTEXT-FORMAT.md": "172622594277",
@@ -3384,7 +3384,7 @@ exports[`runtime surface golden fixtures setup openspec × claude+opencode 1`] =
3384
3384
  "mate-grilling/SKILL.md": "f37ff4dd9b6d",
3385
3385
  "mate-interview-me/SKILL.md": "5ac966ca1e48",
3386
3386
  "mate-openspec-backfill/SKILL.md": "fa73daee9951",
3387
- "mate-show-me/SKILL.md": "7ccd84f967cf",
3387
+ "mate-show-me/SKILL.md": "42bdac3dd7f2",
3388
3388
  "mate-simplify-code/SKILL.md": "6fff7fff920c",
3389
3389
  "openspec-apply-change/SKILL.md": "c657f1b4e9eb",
3390
3390
  "openspec-archive-change/SKILL.md": "ad2463670c0f",
@@ -3802,7 +3802,7 @@ Write chunks to $GRAPHIFY_OUT and read $GRAPHIFY_OUT later.
3802
3802
  ,
3803
3803
  "mate-artifact-publish/SKILL.md": "9ae069fc6d0d",
3804
3804
  "mate-artifact-publish/references/openspec.md": "b5c986ed9bdc",
3805
- "mate-create-report/SKILL.md": "4dda64fab7b7",
3805
+ "mate-create-report/SKILL.md": "020b5c3a53ce",
3806
3806
  "mate-domain-modeling/SKILL.md": "722d0e5a972d",
3807
3807
  "mate-domain-modeling/references/ADR-FORMAT.md": "824b87e87d9b",
3808
3808
  "mate-domain-modeling/references/CONTEXT-FORMAT.md": "172622594277",
@@ -3811,7 +3811,7 @@ Write chunks to $GRAPHIFY_OUT and read $GRAPHIFY_OUT later.
3811
3811
  "mate-grilling/SKILL.md": "f37ff4dd9b6d",
3812
3812
  "mate-interview-me/SKILL.md": "5ac966ca1e48",
3813
3813
  "mate-openspec-backfill/SKILL.md": "fa73daee9951",
3814
- "mate-show-me/SKILL.md": "7ccd84f967cf",
3814
+ "mate-show-me/SKILL.md": "42bdac3dd7f2",
3815
3815
  "mate-simplify-code/SKILL.md": "6fff7fff920c",
3816
3816
  "openspec-apply-change/SKILL.md": "b023edd228ab",
3817
3817
  "openspec-archive-change/SKILL.md": "890bada99035",
@@ -3880,7 +3880,7 @@ Write chunks to $GRAPHIFY_OUT and read $GRAPHIFY_OUT later.
3880
3880
  ".openspec-target": "38700dfad571",
3881
3881
  "mate-artifact-publish/SKILL.md": "9ae069fc6d0d",
3882
3882
  "mate-artifact-publish/references/openspec.md": "b5c986ed9bdc",
3883
- "mate-create-report/SKILL.md": "4dda64fab7b7",
3883
+ "mate-create-report/SKILL.md": "020b5c3a53ce",
3884
3884
  "mate-domain-modeling/SKILL.md": "722d0e5a972d",
3885
3885
  "mate-domain-modeling/references/ADR-FORMAT.md": "824b87e87d9b",
3886
3886
  "mate-domain-modeling/references/CONTEXT-FORMAT.md": "172622594277",
@@ -3889,7 +3889,7 @@ Write chunks to $GRAPHIFY_OUT and read $GRAPHIFY_OUT later.
3889
3889
  "mate-grilling/SKILL.md": "f37ff4dd9b6d",
3890
3890
  "mate-interview-me/SKILL.md": "5ac966ca1e48",
3891
3891
  "mate-openspec-backfill/SKILL.md": "fa73daee9951",
3892
- "mate-show-me/SKILL.md": "7ccd84f967cf",
3892
+ "mate-show-me/SKILL.md": "42bdac3dd7f2",
3893
3893
  "mate-simplify-code/SKILL.md": "6fff7fff920c",
3894
3894
  "openspec-apply-change/SKILL.md": "c657f1b4e9eb",
3895
3895
  "openspec-archive-change/SKILL.md": "ad2463670c0f",
package/src/tools/setup/mate.ts CHANGED
@@ -89,7 +89,7 @@ A report carrying a mermaid payload inlines the diagram runtime; a report withou
89
89
  2. Run \`mate report --input <file-or->\`.
90
90
  3. Add \`--json\` when the caller needs normalized JSON instead of browser delivery.
91
91
 
92
- The default path writes self-contained HTML to a unique OS temporary directory and opens it in the default browser. The report includes a visible "Print / Save as PDF" control that calls the browser's native print dialog. If HTML delivery fails, the CLI warns on stderr and emits the complete report document as JSON on stdout.
92
+ The CLI chooses the delivery surface; deliver only through \`mate report\`, never a hand-written file, server, or browser launch. Inside a Studio terminal it hosts the report in Studio and prints a full link only when Studio has a public address, otherwise it tells the operator to open Studio → Reports; relay that output. Elsewhere, or when Studio is unreachable, it writes self-contained HTML to a unique OS temporary directory and opens it in the default browser. The report includes a visible "Print / Save as PDF" control that calls the browser's native print dialog. If HTML delivery fails, the CLI warns on stderr and emits the complete report document as JSON on stdout.
93
93
 
94
94
  The built-in \`mate report\` path collects Mate usage data and adapts it to the same contract and renderer.
95
95
  `;