From fee507ea3e21c948519d8e6665fb624904f841c9 Mon Sep 17 00:00:00 2001 From: konojunya Date: Sun, 6 Sep 2026 14:47:27 +0900 Subject: [PATCH 1/2] Document live node kind previews --- content/site/ja/language/nodes-and-groups.md | 6 +++++- content/site/ja/language/themes-and-icons.md | 2 +- content/site/ko/language/nodes-and-groups.md | 6 +++++- content/site/ko/language/themes-and-icons.md | 2 +- content/site/language/nodes-and-groups.md | 6 +++++- content/site/language/themes-and-icons.md | 2 +- content/site/zh/language/nodes-and-groups.md | 6 +++++- content/site/zh/language/themes-and-icons.md | 2 +- generated/manifest.json | 16 ++++++++-------- generated/site/ja/language/nodes-and-groups.md | 6 +++++- generated/site/ja/language/themes-and-icons.md | 2 +- generated/site/ko/language/nodes-and-groups.md | 6 +++++- generated/site/ko/language/themes-and-icons.md | 2 +- generated/site/language/nodes-and-groups.md | 6 +++++- generated/site/language/themes-and-icons.md | 2 +- generated/site/zh/language/nodes-and-groups.md | 6 +++++- generated/site/zh/language/themes-and-icons.md | 2 +- 17 files changed, 56 insertions(+), 24 deletions(-) diff --git a/content/site/ja/language/nodes-and-groups.md b/content/site/ja/language/nodes-and-groups.md index b00e75e..b86aebf 100644 --- a/content/site/ja/language/nodes-and-groups.md +++ b/content/site/ja/language/nodes-and-groups.md @@ -36,7 +36,11 @@ diagram "Node example" { | `storage` | Blob、object、file、archive storage | | `external` | Architectureのcontrol boundary外のsystem | -Kindはvendor shapeではなくsemantic categoryです。Hosted PostgreSQLも`database`で、technology名は`detail`に書きます。 +各kindの実際のfallback renderを以下で比較できます。Themeを切り替えてvisual systemを確認し、cardを選択すると対応する`kind` statementをコピーできます。Previewは事前生成した画像ではなく、Playgroundと同じpin済みEngine / WASMが端末上で描画します。 + + + +Kindは固定のvendor shapeではなくsemantic categoryです。Hosted PostgreSQLも`database`で、technology名は`detail`に書きます。各kindのshape、palette、fallback iconはactive themeが所有するため、custom themeはarchitectureの意味を変えずに見た目を変更できます。 ## Labelとdetail diff --git a/content/site/ja/language/themes-and-icons.md b/content/site/ja/language/themes-and-icons.md index 0140fa0..55262d0 100644 --- a/content/site/ja/language/themes-and-icons.md +++ b/content/site/ja/language/themes-and-icons.md @@ -107,7 +107,7 @@ Free core catalogは、次のprovider-neutralな明示iconを`default`、`light` | `email` | Email delivery | Email delivery / inbox | | `ai` | Artificial intelligence system | AI model / inference service | -下のpreviewをlight / darkへ切り替えると、実際のoutputを比較できます。各imageは公開`@stack-sh/engine@0.7.0`がlocalでrenderし、DocumentationにTheme SVG assetを複製していません。Syntaxの行を選ぶとコピーできます。 +下のpreviewをlight / darkへ切り替えると、実際のoutputを比較できます。DocumentationがpinしたEngine / WASM packageが各imageをlocalでrenderし、gallery横にversionを表示します。DocumentationにTheme SVG assetは複製しません。Syntaxの行を選ぶとコピーできます。 diff --git a/content/site/ko/language/nodes-and-groups.md b/content/site/ko/language/nodes-and-groups.md index a957a82..d4aa1be 100644 --- a/content/site/ko/language/nodes-and-groups.md +++ b/content/site/ko/language/nodes-and-groups.md @@ -36,7 +36,11 @@ diagram "Node example" { | `storage` | Blob, object, file, archive storage | | `external` | 아키텍처 제어 경계 밖의 시스템 | -Kind는 벤더별 모양이 아닌 의미 범주입니다. 호스팅된 PostgreSQL도 `database`이며 기술 이름은 `detail`에 작성합니다. +아래에서 각 kind의 실제 fallback 렌더링을 비교할 수 있습니다. 테마를 전환해 비주얼 시스템을 확인하고 카드를 선택하면 해당 `kind` 문장을 복사할 수 있습니다. 미리보기는 사전 생성된 스크린샷이 아니라 Playground와 동일하게 고정된 Engine/WASM이 사용자의 기기에서 렌더링합니다. + + + +Kind는 고정된 벤더 모양이 아닌 의미 범주입니다. 호스팅된 PostgreSQL도 `database`이며 기술 이름은 `detail`에 작성합니다. 각 kind의 모양, 팔레트, fallback 아이콘은 활성 테마가 관리하므로 사용자 정의 테마는 아키텍처 의미를 바꾸지 않고 표현만 바꿀 수 있습니다. ## 라벨과 상세 diff --git a/content/site/ko/language/themes-and-icons.md b/content/site/ko/language/themes-and-icons.md index d17fac8..1b45b89 100644 --- a/content/site/ko/language/themes-and-icons.md +++ b/content/site/ko/language/themes-and-icons.md @@ -107,7 +107,7 @@ diagram "Explicit icon" { | `email` | Email delivery | 이메일 전송 또는 받은편지함 | | `ai` | Artificial intelligence system | AI 모델 또는 추론 서비스 | -아래 미리보기를 라이트와 다크로 전환하여 실제 출력을 비교할 수 있습니다. 각 이미지는 공개된 `@stack-sh/engine@0.7.0`이 로컬에서 렌더링하며 문서에 Theme SVG 에셋을 복제하지 않습니다. 문법 행을 선택하면 복사됩니다. +아래 미리보기를 라이트와 다크로 전환하여 실제 출력을 비교할 수 있습니다. 문서가 고정한 Engine/WASM package가 각 이미지를 로컬에서 렌더링하고 gallery 옆에 버전을 표시합니다. 문서에는 Theme SVG 에셋을 복제하지 않습니다. 문법 행을 선택하면 복사됩니다. diff --git a/content/site/language/nodes-and-groups.md b/content/site/language/nodes-and-groups.md index 9f94e33..edc7701 100644 --- a/content/site/language/nodes-and-groups.md +++ b/content/site/language/nodes-and-groups.md @@ -36,7 +36,11 @@ Two nodes may share a visible label when they are distinct entities, though labe | `storage` | Blob, object, file, or archival storage | | `external` | System outside the architecture's control boundary | -Kinds are semantic categories, not vendor shapes. A hosted PostgreSQL instance is still a `database`; name the technology in `detail`. +Compare the actual fallback rendered for every kind below. Switch the theme to inspect its visual system, then select a card to copy the corresponding `kind` statement. These previews are rendered on your device by the same pinned Engine/WASM package as the Playground; they are not pre-generated screenshots. + + + +Kinds are semantic categories, not fixed vendor shapes. A hosted PostgreSQL instance is still a `database`; name the technology in `detail`. The active theme owns each kind's shape, palette, and fallback icon, so a custom theme can change the presentation without changing the architecture's meaning. ## Labels and details diff --git a/content/site/language/themes-and-icons.md b/content/site/language/themes-and-icons.md index 401b270..0eb1fc1 100644 --- a/content/site/language/themes-and-icons.md +++ b/content/site/language/themes-and-icons.md @@ -107,7 +107,7 @@ The free core catalog includes these provider-neutral explicit icons in `default | `email` | Email delivery | Email delivery or inboxes | | `ai` | Artificial intelligence system | AI models or inference services | -Switch the preview below between light and dark to inspect the actual output. The published `@stack-sh/engine@0.7.0` renders every image locally; the Documentation does not copy Theme SVG assets. Select a syntax row to copy it. +Switch the preview below between light and dark to inspect the actual output. The Documentation's pinned Engine/WASM package renders every image locally and reports its version beside the gallery; the Documentation does not copy Theme SVG assets. Select a syntax row to copy it. diff --git a/content/site/zh/language/nodes-and-groups.md b/content/site/zh/language/nodes-and-groups.md index b64140c..938a7c4 100644 --- a/content/site/zh/language/nodes-and-groups.md +++ b/content/site/zh/language/nodes-and-groups.md @@ -36,7 +36,11 @@ diagram "Node example" { | `storage` | Blob、对象、文件或归档存储 | | `external` | 架构控制边界之外的系统 | -Kind 是语义分类，不是厂商形状。托管 PostgreSQL 仍是 `database`，技术名称应写入 `detail`。 +可在下方比较每种 kind 的实际 fallback 渲染。切换主题可以查看对应视觉系统；选择卡片即可复制相应的 `kind` 语句。这些预览不是预生成截图，而是由与 Playground 相同的固定版本 Engine/WASM 在您的设备上渲染。 + + + +Kind 是语义分类，不是固定的厂商形状。托管 PostgreSQL 仍是 `database`，技术名称应写入 `detail`。每种 kind 的形状、配色和 fallback 图标由当前主题控制，因此自定义主题可以改变外观而不改变架构语义。 ## 标签与详情 diff --git a/content/site/zh/language/themes-and-icons.md b/content/site/zh/language/themes-and-icons.md index 8b58888..81e567b 100644 --- a/content/site/zh/language/themes-and-icons.md +++ b/content/site/zh/language/themes-and-icons.md @@ -107,7 +107,7 @@ diagram "Explicit icon" { | `email` | Email delivery | 邮件投递或收件箱 | | `ai` | Artificial intelligence system | AI 模型或推理服务 | -切换下方预览的浅色与深色模式即可比较真实输出。每张图片都由已发布的 `@stack-sh/engine@0.7.0` 在本地渲染；文档没有复制 Theme SVG 资源。选择语法行即可复制。 +切换下方预览的浅色与深色模式即可比较真实输出。文档固定版本的 Engine/WASM package 会在本地渲染每张图片，并在画廊旁显示版本；文档不会复制 Theme SVG 资源。选择语法行即可复制。 diff --git a/generated/manifest.json b/generated/manifest.json index 2158106..a4a41a4 100644 --- a/generated/manifest.json +++ b/generated/manifest.json @@ -80,7 +80,7 @@ }, { "path": "site/ja/language/nodes-and-groups.md", - "sha256": "e953db6f6cd06d4ee645e2a83583f2d0b2eec92ea09bc1390edcf994d52b514c" + "sha256": "a8d7612cc5f0927d017e7e8c4242d297b5ab1141ac13f677a04eba1bb2a78319" }, { "path": "site/ja/language/syntax.md", @@ -88,7 +88,7 @@ }, { "path": "site/ja/language/themes-and-icons.md", - "sha256": "a62ca441e0773d12140a518311b0fc79060f52d4450e29c6107c85ee45823613" + "sha256": "c3379a236f22a0e5f14e5e777095235c0f4f25c80512ab17ba360cfb0e610fcd" }, { "path": "site/ja/reference/diagnostics-and-limits.md", @@ -136,7 +136,7 @@ }, { "path": "site/ko/language/nodes-and-groups.md", - "sha256": "bba8f1c8f9ac9897c6cf39f8bf21ce618335824d2d3c0b2bd3179765dbfcd7b3" + "sha256": "3004ef8291217765b8d7f4e9708ad2dfa8d6f6ad1972c4dba35a275ca371bfa5" }, { "path": "site/ko/language/syntax.md", @@ -144,7 +144,7 @@ }, { "path": "site/ko/language/themes-and-icons.md", - "sha256": "af84dc459db2cd9fa7b14552cb218874d8e7f418155fb6d876749b76b9cb3bc3" + "sha256": "bab922ec5167d57bc3d85680dba6724efed60a10bb3dc4edf9df92583b90cedd" }, { "path": "site/ko/reference/diagnostics-and-limits.md", @@ -164,7 +164,7 @@ }, { "path": "site/language/nodes-and-groups.md", - "sha256": "be3819622ac9c561ac4a5bb947c7025607ec2d5609a4e62a9e9d35805d3d416f" + "sha256": "143b6460010a66a3d7b7898ee40e7170bf49bc3b98a66832f8f6f293b1b18bb1" }, { "path": "site/language/syntax.md", @@ -172,7 +172,7 @@ }, { "path": "site/language/themes-and-icons.md", - "sha256": "4e2a59b62db144914fcd5b6f166524c9472d65a748432da339becad068c2ca7e" + "sha256": "adce66fa4273ed18216bd2632efb7e21256ae0a3c6c0c8a295bd4d374e9dc303" }, { "path": "site/reference/diagnostics-and-limits.md", @@ -220,7 +220,7 @@ }, { "path": "site/zh/language/nodes-and-groups.md", - "sha256": "48a1a9186b2f817be780a01015b6bcae0e3f0b47675546dc36d4c172b40bc3b9" + "sha256": "c6c98ac30b3b5f56c0f116ac087cf6c2d58a94ef644e493552c44c720054722c" }, { "path": "site/zh/language/syntax.md", @@ -228,7 +228,7 @@ }, { "path": "site/zh/language/themes-and-icons.md", - "sha256": "376293b52fac1992c763d970410a72093f26275b97109d17e478d0e7257c339e" + "sha256": "64ee932a93b4d6befc72d164be71d699f2a7258fcf37c311f09cf5fba1ed3419" }, { "path": "site/zh/reference/diagnostics-and-limits.md", diff --git a/generated/site/ja/language/nodes-and-groups.md b/generated/site/ja/language/nodes-and-groups.md index b00e75e..b86aebf 100644 --- a/generated/site/ja/language/nodes-and-groups.md +++ b/generated/site/ja/language/nodes-and-groups.md @@ -36,7 +36,11 @@ diagram "Node example" { | `storage` | Blob、object、file、archive storage | | `external` | Architectureのcontrol boundary外のsystem | -Kindはvendor shapeではなくsemantic categoryです。Hosted PostgreSQLも`database`で、technology名は`detail`に書きます。 +各kindの実際のfallback renderを以下で比較できます。Themeを切り替えてvisual systemを確認し、cardを選択すると対応する`kind` statementをコピーできます。Previewは事前生成した画像ではなく、Playgroundと同じpin済みEngine / WASMが端末上で描画します。 + + + +Kindは固定のvendor shapeではなくsemantic categoryです。Hosted PostgreSQLも`database`で、technology名は`detail`に書きます。各kindのshape、palette、fallback iconはactive themeが所有するため、custom themeはarchitectureの意味を変えずに見た目を変更できます。 ## Labelとdetail diff --git a/generated/site/ja/language/themes-and-icons.md b/generated/site/ja/language/themes-and-icons.md index 0140fa0..55262d0 100644 --- a/generated/site/ja/language/themes-and-icons.md +++ b/generated/site/ja/language/themes-and-icons.md @@ -107,7 +107,7 @@ Free core catalogは、次のprovider-neutralな明示iconを`default`、`light` | `email` | Email delivery | Email delivery / inbox | | `ai` | Artificial intelligence system | AI model / inference service | -下のpreviewをlight / darkへ切り替えると、実際のoutputを比較できます。各imageは公開`@stack-sh/engine@0.7.0`がlocalでrenderし、DocumentationにTheme SVG assetを複製していません。Syntaxの行を選ぶとコピーできます。 +下のpreviewをlight / darkへ切り替えると、実際のoutputを比較できます。DocumentationがpinしたEngine / WASM packageが各imageをlocalでrenderし、gallery横にversionを表示します。DocumentationにTheme SVG assetは複製しません。Syntaxの行を選ぶとコピーできます。 diff --git a/generated/site/ko/language/nodes-and-groups.md b/generated/site/ko/language/nodes-and-groups.md index a957a82..d4aa1be 100644 --- a/generated/site/ko/language/nodes-and-groups.md +++ b/generated/site/ko/language/nodes-and-groups.md @@ -36,7 +36,11 @@ diagram "Node example" { | `storage` | Blob, object, file, archive storage | | `external` | 아키텍처 제어 경계 밖의 시스템 | -Kind는 벤더별 모양이 아닌 의미 범주입니다. 호스팅된 PostgreSQL도 `database`이며 기술 이름은 `detail`에 작성합니다. +아래에서 각 kind의 실제 fallback 렌더링을 비교할 수 있습니다. 테마를 전환해 비주얼 시스템을 확인하고 카드를 선택하면 해당 `kind` 문장을 복사할 수 있습니다. 미리보기는 사전 생성된 스크린샷이 아니라 Playground와 동일하게 고정된 Engine/WASM이 사용자의 기기에서 렌더링합니다. + + + +Kind는 고정된 벤더 모양이 아닌 의미 범주입니다. 호스팅된 PostgreSQL도 `database`이며 기술 이름은 `detail`에 작성합니다. 각 kind의 모양, 팔레트, fallback 아이콘은 활성 테마가 관리하므로 사용자 정의 테마는 아키텍처 의미를 바꾸지 않고 표현만 바꿀 수 있습니다. ## 라벨과 상세 diff --git a/generated/site/ko/language/themes-and-icons.md b/generated/site/ko/language/themes-and-icons.md index d17fac8..1b45b89 100644 --- a/generated/site/ko/language/themes-and-icons.md +++ b/generated/site/ko/language/themes-and-icons.md @@ -107,7 +107,7 @@ diagram "Explicit icon" { | `email` | Email delivery | 이메일 전송 또는 받은편지함 | | `ai` | Artificial intelligence system | AI 모델 또는 추론 서비스 | -아래 미리보기를 라이트와 다크로 전환하여 실제 출력을 비교할 수 있습니다. 각 이미지는 공개된 `@stack-sh/engine@0.7.0`이 로컬에서 렌더링하며 문서에 Theme SVG 에셋을 복제하지 않습니다. 문법 행을 선택하면 복사됩니다. +아래 미리보기를 라이트와 다크로 전환하여 실제 출력을 비교할 수 있습니다. 문서가 고정한 Engine/WASM package가 각 이미지를 로컬에서 렌더링하고 gallery 옆에 버전을 표시합니다. 문서에는 Theme SVG 에셋을 복제하지 않습니다. 문법 행을 선택하면 복사됩니다. diff --git a/generated/site/language/nodes-and-groups.md b/generated/site/language/nodes-and-groups.md index 9f94e33..edc7701 100644 --- a/generated/site/language/nodes-and-groups.md +++ b/generated/site/language/nodes-and-groups.md @@ -36,7 +36,11 @@ Two nodes may share a visible label when they are distinct entities, though labe | `storage` | Blob, object, file, or archival storage | | `external` | System outside the architecture's control boundary | -Kinds are semantic categories, not vendor shapes. A hosted PostgreSQL instance is still a `database`; name the technology in `detail`. +Compare the actual fallback rendered for every kind below. Switch the theme to inspect its visual system, then select a card to copy the corresponding `kind` statement. These previews are rendered on your device by the same pinned Engine/WASM package as the Playground; they are not pre-generated screenshots. + + + +Kinds are semantic categories, not fixed vendor shapes. A hosted PostgreSQL instance is still a `database`; name the technology in `detail`. The active theme owns each kind's shape, palette, and fallback icon, so a custom theme can change the presentation without changing the architecture's meaning. ## Labels and details diff --git a/generated/site/language/themes-and-icons.md b/generated/site/language/themes-and-icons.md index 401b270..0eb1fc1 100644 --- a/generated/site/language/themes-and-icons.md +++ b/generated/site/language/themes-and-icons.md @@ -107,7 +107,7 @@ The free core catalog includes these provider-neutral explicit icons in `default | `email` | Email delivery | Email delivery or inboxes | | `ai` | Artificial intelligence system | AI models or inference services | -Switch the preview below between light and dark to inspect the actual output. The published `@stack-sh/engine@0.7.0` renders every image locally; the Documentation does not copy Theme SVG assets. Select a syntax row to copy it. +Switch the preview below between light and dark to inspect the actual output. The Documentation's pinned Engine/WASM package renders every image locally and reports its version beside the gallery; the Documentation does not copy Theme SVG assets. Select a syntax row to copy it. diff --git a/generated/site/zh/language/nodes-and-groups.md b/generated/site/zh/language/nodes-and-groups.md index b64140c..938a7c4 100644 --- a/generated/site/zh/language/nodes-and-groups.md +++ b/generated/site/zh/language/nodes-and-groups.md @@ -36,7 +36,11 @@ diagram "Node example" { | `storage` | Blob、对象、文件或归档存储 | | `external` | 架构控制边界之外的系统 | -Kind 是语义分类，不是厂商形状。托管 PostgreSQL 仍是 `database`，技术名称应写入 `detail`。 +可在下方比较每种 kind 的实际 fallback 渲染。切换主题可以查看对应视觉系统；选择卡片即可复制相应的 `kind` 语句。这些预览不是预生成截图，而是由与 Playground 相同的固定版本 Engine/WASM 在您的设备上渲染。 + + + +Kind 是语义分类，不是固定的厂商形状。托管 PostgreSQL 仍是 `database`，技术名称应写入 `detail`。每种 kind 的形状、配色和 fallback 图标由当前主题控制，因此自定义主题可以改变外观而不改变架构语义。 ## 标签与详情 diff --git a/generated/site/zh/language/themes-and-icons.md b/generated/site/zh/language/themes-and-icons.md index 8b58888..81e567b 100644 --- a/generated/site/zh/language/themes-and-icons.md +++ b/generated/site/zh/language/themes-and-icons.md @@ -107,7 +107,7 @@ diagram "Explicit icon" { | `email` | Email delivery | 邮件投递或收件箱 | | `ai` | Artificial intelligence system | AI 模型或推理服务 | -切换下方预览的浅色与深色模式即可比较真实输出。每张图片都由已发布的 `@stack-sh/engine@0.7.0` 在本地渲染；文档没有复制 Theme SVG 资源。选择语法行即可复制。 +切换下方预览的浅色与深色模式即可比较真实输出。文档固定版本的 Engine/WASM package 会在本地渲染每张图片，并在画廊旁显示版本；文档不会复制 Theme SVG 资源。选择语法行即可复制。 From 9751bb556b81b101eb2c4690e74f5077adb243ff Mon Sep 17 00:00:00 2001 From: konojunya Date: Sun, 6 Sep 2026 17:00:20 +0900 Subject: [PATCH 2/2] Refresh Docs for Stack CLI 0.5.3 --- content/cli-release.json | 4 ++-- generated/guide/agent-workflow.md | 4 ++-- generated/manifest.json | 24 +++++++++++----------- generated/site/guide/agent-workflow.md | 4 ++-- generated/site/guide/getting-started.md | 10 ++++----- generated/site/ja/guide/agent-workflow.md | 4 ++-- generated/site/ja/guide/getting-started.md | 10 ++++----- generated/site/ko/guide/agent-workflow.md | 4 ++-- generated/site/ko/guide/getting-started.md | 10 ++++----- generated/site/zh/guide/agent-workflow.md | 4 ++-- generated/site/zh/guide/getting-started.md | 10 ++++----- generated/skills/stack-diagrams/SKILL.md | 4 ++-- package-lock.json | 8 ++++---- package.json | 2 +- 14 files changed, 51 insertions(+), 51 deletions(-) diff --git a/content/cli-release.json b/content/cli-release.json index 4e62b5f..b532e60 100644 --- a/content/cli-release.json +++ b/content/cli-release.json @@ -1,5 +1,5 @@ { "repository": "stack-sh/cli", - "revision": "f6220c5c24bc515574ea6f6dd6d55af00d35f89d", - "version": "0.5.2" + "revision": "d66ff06fc75337e7d4e966108e7793dddd6b1e53", + "version": "0.5.3" } diff --git a/generated/guide/agent-workflow.md b/generated/guide/agent-workflow.md index fea6bbd..3b73e9a 100644 --- a/generated/guide/agent-workflow.md +++ b/generated/guide/agent-workflow.md @@ -6,9 +6,9 @@ Deliver editable `.stack` source and, when rendering is available, an SVG. Prese ## Start with the available tools -Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.2. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. +Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.3. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. -If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. +If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. ## Read only the relevant reference diff --git a/generated/manifest.json b/generated/manifest.json index a4a41a4..9a367b7 100644 --- a/generated/manifest.json +++ b/generated/manifest.json @@ -2,17 +2,17 @@ "schemaVersion": "1.0", "cli": { "repository": "stack-sh/cli", - "revision": "f6220c5c24bc515574ea6f6dd6d55af00d35f89d", - "version": "0.5.2" + "revision": "d66ff06fc75337e7d4e966108e7793dddd6b1e53", + "version": "0.5.3" }, "files": [ { "path": "skills/stack-diagrams/SKILL.md", - "sha256": "70fdcce8810091502b3567a838ca9eb145f3dd9c187d1c51edbc52dd17d0cd0c" + "sha256": "0925d134745a0db9f57ccfff589585f461981b3cec2330880722d4c8803d2a31" }, { "path": "guide/agent-workflow.md", - "sha256": "c1ce223c9df56e62555909fb58c82928b4a92ff1f157dd2cbc0c03c676bc58f6" + "sha256": "12ab60398e9700817de352a918490de96f16f7068c968204dae93ed5114cb1b5" }, { "path": "site/examples/index.md", @@ -24,7 +24,7 @@ }, { "path": "site/guide/getting-started.md", - "sha256": "807e0b5ea42ab7f281c9c9f6a672415a8e4425bd89188a4a28209b3ab4c708f3" + "sha256": "eb2682e1e2d5354e83c4d532efdbee7aa76fdca2545b3a3428e4b00a37d630a1" }, { "path": "site/guide/playground.md", @@ -52,7 +52,7 @@ }, { "path": "site/ja/guide/getting-started.md", - "sha256": "e5cb089c8e51a95ac5c5085cbd316de33190ae3f0ce6533d8f13ed551d54f53e" + "sha256": "43e3fb1fb0beb2b37cb5ab06d4f6b37c49634de26c1089aa791a3d621152ed71" }, { "path": "site/ja/guide/playground.md", @@ -108,7 +108,7 @@ }, { "path": "site/ko/guide/getting-started.md", - "sha256": "999c53bd1dd88e1a17ea6a0b1df548e37a9e8325711c0b1f3c67431ea65de77c" + "sha256": "8cb9ac1ed8cdbf5fba99ecd9b85b046d5d109bf619ff2f3125e8d61156c0d442" }, { "path": "site/ko/guide/playground.md", @@ -192,7 +192,7 @@ }, { "path": "site/zh/guide/getting-started.md", - "sha256": "0b5162f8c023ead20434867d354fdc4aa7df268d93cad8fbf2d89bde9d65a673" + "sha256": "2d9edefa83fbaa04dbdb34d7641e36dc7ef09a846e38090cdead622b635735cd" }, { "path": "site/zh/guide/playground.md", @@ -240,19 +240,19 @@ }, { "path": "site/guide/agent-workflow.md", - "sha256": "03ed896542fc628227013b7bf69cdc232f77f77a0d630c10f02f27d7b25cefe2" + "sha256": "34ac441e89a44cead076e0fa7cce19cdbcd0dca40281834bb51de45e138a1468" }, { "path": "site/ja/guide/agent-workflow.md", - "sha256": "03ed896542fc628227013b7bf69cdc232f77f77a0d630c10f02f27d7b25cefe2" + "sha256": "34ac441e89a44cead076e0fa7cce19cdbcd0dca40281834bb51de45e138a1468" }, { "path": "site/zh/guide/agent-workflow.md", - "sha256": "03ed896542fc628227013b7bf69cdc232f77f77a0d630c10f02f27d7b25cefe2" + "sha256": "34ac441e89a44cead076e0fa7cce19cdbcd0dca40281834bb51de45e138a1468" }, { "path": "site/ko/guide/agent-workflow.md", - "sha256": "03ed896542fc628227013b7bf69cdc232f77f77a0d630c10f02f27d7b25cefe2" + "sha256": "34ac441e89a44cead076e0fa7cce19cdbcd0dca40281834bb51de45e138a1468" }, { "path": "machine/v1.0.0/manifest.json", diff --git a/generated/site/guide/agent-workflow.md b/generated/site/guide/agent-workflow.md index afe60af..d912b16 100644 --- a/generated/site/guide/agent-workflow.md +++ b/generated/site/guide/agent-workflow.md @@ -6,9 +6,9 @@ Deliver editable `.stack` source and, when rendering is available, an SVG. Prese ## Start with the available tools -Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.2. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. +Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.3. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. -If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. +If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. ## Read only the relevant reference diff --git a/generated/site/guide/getting-started.md b/generated/site/guide/getting-started.md index 2124b99..4bd822d 100644 --- a/generated/site/guide/getting-started.md +++ b/generated/site/guide/getting-started.md @@ -4,7 +4,7 @@ Choose one installer, then create your first SVG below. Prefer working in your t ## Install the CLI -Stack CLI 0.5.2 supports macOS and glibc Linux on arm64 and x86_64. Prebuilt archives require macOS 13 or glibc 2.31 or newer; Windows and Alpine/musl are not supported. Choose one installer so different copies do not compete on `PATH`. The [distribution contract](https://github.com/stack-sh/cli/blob/main/docs/distribution.md#supported-platform-matrix) owns the exact support matrix. +Stack CLI 0.5.3 supports macOS and glibc Linux on arm64 and x86_64. Prebuilt archives require macOS 13 or glibc 2.31 or newer; Windows and Alpine/musl are not supported. Choose one installer so different copies do not compete on `PATH`. The [distribution contract](https://github.com/stack-sh/cli/blob/main/docs/distribution.md#supported-platform-matrix) owns the exact support matrix. ### Homebrew @@ -19,7 +19,7 @@ brew install stack-sh/tap/stack Use Rust 1.85 or newer with a native linker: Xcode Command Line Tools on macOS, or a C compiler/linker on Linux. Make sure Cargo’s bin directory is on `PATH`. The package is `stack-diagram-cli`; the installed command is `stack`. ```text -cargo install stack-diagram-cli --version 0.5.2 --locked +cargo install stack-diagram-cli --version 0.5.3 --locked ``` ### Aqua @@ -40,7 +40,7 @@ registries: ref: 42702cda91a4156901b9a601bd143c43dcf05766 path: aqua/registry.yaml packages: - - name: stack-sh/cli@v0.5.2 + - name: stack-sh/cli@v0.5.3 registry: stack-sh ``` @@ -75,7 +75,7 @@ With the [GitHub CLI](https://cli.github.com/) installed and authenticated, run ```text ( set -eu - version=0.5.2 + version=0.5.3 case "$(uname -s)/$(uname -m)" in Darwin/arm64) target=aarch64-apple-darwin ;; Darwin/x86_64) target=x86_64-apple-darwin ;; @@ -113,7 +113,7 @@ $ stack check diagram.stack $ stack render diagram.stack -o diagram.svg ``` -Expected: `stack 0.5.2`, a new `diagram.stack`, no check errors, and a non-empty `diagram.svg`. Open the SVG in a browser or add it to your README. `stack init` protects existing files; use a fresh directory instead of overwriting your work. +Expected: `stack 0.5.3`, a new `diagram.stack`, no check errors, and a non-empty `diagram.svg`. Open the SVG in a browser or add it to your README. `stack init` protects existing files; use a fresh directory instead of overwriting your work. Edit `diagram.stack` to describe your system, then repeat check and render. Format it when needed: diff --git a/generated/site/ja/guide/agent-workflow.md b/generated/site/ja/guide/agent-workflow.md index afe60af..d912b16 100644 --- a/generated/site/ja/guide/agent-workflow.md +++ b/generated/site/ja/guide/agent-workflow.md @@ -6,9 +6,9 @@ Deliver editable `.stack` source and, when rendering is available, an SVG. Prese ## Start with the available tools -Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.2. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. +Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.3. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. -If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. +If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. ## Read only the relevant reference diff --git a/generated/site/ja/guide/getting-started.md b/generated/site/ja/guide/getting-started.md index 1dac03b..03fa120 100644 --- a/generated/site/ja/guide/getting-started.md +++ b/generated/site/ja/guide/getting-started.md @@ -4,7 +4,7 @@ ## CLIを導入する -Stack CLI 0.5.2はarm64 / x86_64のmacOSとglibc Linuxに対応します。配布バイナリーの要件はmacOS 13以降またはglibc 2.31以降です。WindowsとAlpine/muslは対象外です。`PATH`上で複数のバイナリーが競合しないよう、導入方法を1つ選んでください。正確な対応表は[配布契約](https://github.com/stack-sh/cli/blob/main/docs/distribution.md#supported-platform-matrix)が正本です。 +Stack CLI 0.5.3はarm64 / x86_64のmacOSとglibc Linuxに対応します。配布バイナリーの要件はmacOS 13以降またはglibc 2.31以降です。WindowsとAlpine/muslは対象外です。`PATH`上で複数のバイナリーが競合しないよう、導入方法を1つ選んでください。正確な対応表は[配布契約](https://github.com/stack-sh/cli/blob/main/docs/distribution.md#supported-platform-matrix)が正本です。 ### Homebrew @@ -19,7 +19,7 @@ brew install stack-sh/tap/stack Rust 1.85以降とネイティブリンカーが必要です。macOSではXcode Command Line Tools、LinuxではCコンパイラーとリンカーを用意し、Cargoのbinディレクトリを`PATH`へ追加してください。パッケージ名は`stack-diagram-cli`、コマンド名は`stack`です。 ```text -cargo install stack-diagram-cli --version 0.5.2 --locked +cargo install stack-diagram-cli --version 0.5.3 --locked ``` ### Aqua @@ -40,7 +40,7 @@ registries: ref: 42702cda91a4156901b9a601bd143c43dcf05766 path: aqua/registry.yaml packages: - - name: stack-sh/cli@v0.5.2 + - name: stack-sh/cli@v0.5.3 registry: stack-sh ``` @@ -75,7 +75,7 @@ aqua install ```text ( set -eu - version=0.5.2 + version=0.5.3 case "$(uname -s)/$(uname -m)" in Darwin/arm64) target=aarch64-apple-darwin ;; Darwin/x86_64) target=x86_64-apple-darwin ;; @@ -113,7 +113,7 @@ $ stack check diagram.stack $ stack render diagram.stack -o diagram.svg ``` -`stack 0.5.2`と表示され、`diagram.stack`が作成され、checkがエラーなく終了し、空でない`diagram.svg`ができれば成功です。SVGはブラウザーで開いたりREADMEに貼ったりできます。`stack init`は既存ファイルを保護するため、上書きせず新しいディレクトリを使ってください。 +`stack 0.5.3`と表示され、`diagram.stack`が作成され、checkがエラーなく終了し、空でない`diagram.svg`ができれば成功です。SVGはブラウザーで開いたりREADMEに貼ったりできます。`stack init`は既存ファイルを保護するため、上書きせず新しいディレクトリを使ってください。 `diagram.stack`を自分の構成に書き換え、checkとrenderを繰り返します。整形が必要な場合は次を実行します。 diff --git a/generated/site/ko/guide/agent-workflow.md b/generated/site/ko/guide/agent-workflow.md index afe60af..d912b16 100644 --- a/generated/site/ko/guide/agent-workflow.md +++ b/generated/site/ko/guide/agent-workflow.md @@ -6,9 +6,9 @@ Deliver editable `.stack` source and, when rendering is available, an SVG. Prese ## Start with the available tools -Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.2. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. +Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.3. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. -If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. +If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. ## Read only the relevant reference diff --git a/generated/site/ko/guide/getting-started.md b/generated/site/ko/guide/getting-started.md index efc95f0..efbca00 100644 --- a/generated/site/ko/guide/getting-started.md +++ b/generated/site/ko/guide/getting-started.md @@ -4,7 +4,7 @@ ## CLI 설치 -Stack CLI 0.5.2은 arm64 / x86_64 macOS와 glibc Linux를 지원합니다. 미리 빌드된 파일은 macOS 13 또는 glibc 2.31 이상이 필요하며 Windows와 Alpine/musl은 지원하지 않습니다. 여러 바이너리가 `PATH`에서 충돌하지 않도록 설치 방법 하나를 선택하세요. 정확한 지원 범위는 [배포 계약](https://github.com/stack-sh/cli/blob/main/docs/distribution.md#supported-platform-matrix)이 정합니다. +Stack CLI 0.5.3은 arm64 / x86_64 macOS와 glibc Linux를 지원합니다. 미리 빌드된 파일은 macOS 13 또는 glibc 2.31 이상이 필요하며 Windows와 Alpine/musl은 지원하지 않습니다. 여러 바이너리가 `PATH`에서 충돌하지 않도록 설치 방법 하나를 선택하세요. 정확한 지원 범위는 [배포 계약](https://github.com/stack-sh/cli/blob/main/docs/distribution.md#supported-platform-matrix)이 정합니다. ### Homebrew @@ -19,7 +19,7 @@ brew install stack-sh/tap/stack Rust 1.85 이상과 네이티브 링커가 필요합니다. macOS는 Xcode Command Line Tools, Linux는 C 컴파일러와 링커를 준비하세요. Cargo의 bin 디렉터리를 `PATH`에 추가하세요. 패키지 이름은 `stack-diagram-cli`, 설치되는 명령은 `stack`입니다. ```text -cargo install stack-diagram-cli --version 0.5.2 --locked +cargo install stack-diagram-cli --version 0.5.3 --locked ``` ### Aqua @@ -40,7 +40,7 @@ registries: ref: 42702cda91a4156901b9a601bd143c43dcf05766 path: aqua/registry.yaml packages: - - name: stack-sh/cli@v0.5.2 + - name: stack-sh/cli@v0.5.3 registry: stack-sh ``` @@ -75,7 +75,7 @@ aqua install ```text ( set -eu - version=0.5.2 + version=0.5.3 case "$(uname -s)/$(uname -m)" in Darwin/arm64) target=aarch64-apple-darwin ;; Darwin/x86_64) target=x86_64-apple-darwin ;; @@ -113,7 +113,7 @@ $ stack check diagram.stack $ stack render diagram.stack -o diagram.svg ``` -`stack 0.5.2`이 표시되고 `diagram.stack`이 생성되며 오류 없이 검사되고 비어 있지 않은 `diagram.svg`가 만들어지면 성공입니다. SVG를 브라우저에서 열거나 README에 넣으세요. `stack init`은 기존 파일을 보호하므로 덮어쓰는 대신 새 디렉터리를 사용하세요. +`stack 0.5.3`이 표시되고 `diagram.stack`이 생성되며 오류 없이 검사되고 비어 있지 않은 `diagram.svg`가 만들어지면 성공입니다. SVG를 브라우저에서 열거나 README에 넣으세요. `stack init`은 기존 파일을 보호하므로 덮어쓰는 대신 새 디렉터리를 사용하세요. `diagram.stack`을 자신의 시스템에 맞게 수정하고 check와render를 반복하세요. 필요할 때 다음 명령으로 포맷하세요. diff --git a/generated/site/zh/guide/agent-workflow.md b/generated/site/zh/guide/agent-workflow.md index afe60af..d912b16 100644 --- a/generated/site/zh/guide/agent-workflow.md +++ b/generated/site/zh/guide/agent-workflow.md @@ -6,9 +6,9 @@ Deliver editable `.stack` source and, when rendering is available, an SVG. Prese ## Start with the available tools -Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.2. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. +Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.3. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. -If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. +If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. ## Read only the relevant reference diff --git a/generated/site/zh/guide/getting-started.md b/generated/site/zh/guide/getting-started.md index 4710317..e83de64 100644 --- a/generated/site/zh/guide/getting-started.md +++ b/generated/site/zh/guide/getting-started.md @@ -4,7 +4,7 @@ ## 安装CLI -Stack CLI 0.5.2支持arm64 / x86_64的macOS和glibc Linux。预编译文件需要macOS 13或glibc 2.31及以上；不支持Windows和Alpine/musl。请选择一种安装方式，避免多个二进制文件在`PATH`中冲突。准确的支持范围以[分发契约](https://github.com/stack-sh/cli/blob/main/docs/distribution.md#supported-platform-matrix)为准。 +Stack CLI 0.5.3支持arm64 / x86_64的macOS和glibc Linux。预编译文件需要macOS 13或glibc 2.31及以上；不支持Windows和Alpine/musl。请选择一种安装方式，避免多个二进制文件在`PATH`中冲突。准确的支持范围以[分发契约](https://github.com/stack-sh/cli/blob/main/docs/distribution.md#supported-platform-matrix)为准。 ### Homebrew @@ -19,7 +19,7 @@ brew install stack-sh/tap/stack 需要Rust 1.85及以上和本地链接器：macOS使用Xcode Command Line Tools，Linux使用C编译器和链接器。将Cargo的bin目录加入`PATH`。包名为`stack-diagram-cli`，安装后的命令为`stack`。 ```text -cargo install stack-diagram-cli --version 0.5.2 --locked +cargo install stack-diagram-cli --version 0.5.3 --locked ``` ### Aqua @@ -40,7 +40,7 @@ registries: ref: 42702cda91a4156901b9a601bd143c43dcf05766 path: aqua/registry.yaml packages: - - name: stack-sh/cli@v0.5.2 + - name: stack-sh/cli@v0.5.3 registry: stack-sh ``` @@ -75,7 +75,7 @@ aqua install ```text ( set -eu - version=0.5.2 + version=0.5.3 case "$(uname -s)/$(uname -m)" in Darwin/arm64) target=aarch64-apple-darwin ;; Darwin/x86_64) target=x86_64-apple-darwin ;; @@ -113,7 +113,7 @@ $ stack check diagram.stack $ stack render diagram.stack -o diagram.svg ``` -预期结果：显示`stack 0.5.2`、生成`diagram.stack`、检查无错误，并生成非空的`diagram.svg`。用浏览器打开SVG或将其加入README。`stack init`会保护已有文件，请使用新目录而非覆盖原有工作。 +预期结果：显示`stack 0.5.3`、生成`diagram.stack`、检查无错误，并生成非空的`diagram.svg`。用浏览器打开SVG或将其加入README。`stack init`会保护已有文件，请使用新目录而非覆盖原有工作。 修改`diagram.stack`描述自己的系统，再次运行check和render。需要格式化时执行： diff --git a/generated/skills/stack-diagrams/SKILL.md b/generated/skills/stack-diagrams/SKILL.md index 5b404a4..c2523f9 100644 --- a/generated/skills/stack-diagrams/SKILL.md +++ b/generated/skills/stack-diagrams/SKILL.md @@ -12,9 +12,9 @@ Deliver editable `.stack` source and, when rendering is available, an SVG. Prese ## Start with the available tools -Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.2. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. +Run `stack --version` and `stack help` before selecting commands. Use the installed binary's help, not unreleased repository instructions. This workflow is tested with published CLI 0.5.3. The commands below use human-readable output; `check`, `fmt`, and `render` also accept `--json` for structured diagnostics, artifacts, and operational errors. Read the [versioned JSON output contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/machine-readable-output.md) before parsing it, and verify options using `stack help `. -If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.2/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. +If the CLI is missing, consult the [installation guide](https://stack-diagram.com/docs/guide/getting-started.md) and [release distribution contract](https://github.com/stack-sh/cli/blob/v0.5.3/docs/distribution.md). Install only when the user's authorization allows it. Otherwise provide source with an explicit validation gap; do not report it as checked. No remote source upload is required. Upgrade with the package manager that installed Stack, or verify and manually replace a direct download; `stack update` has been removed. For local configuration problems, `stack doctor` and `stack config path` provide read-only diagnosis. ## Read only the relevant reference diff --git a/package-lock.json b/package-lock.json index 5946a1a..7da8be2 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,14 +9,14 @@ "version": "0.1.0", "license": "Apache-2.0", "devDependencies": { - "@stack-sh/engine": "0.8.0", + "@stack-sh/engine": "0.9.0", "ajv": "8.20.0" } }, "node_modules/@stack-sh/engine": { - "version": "0.8.0", - "resolved": "https://registry.npmjs.org/@stack-sh/engine/-/engine-0.8.0.tgz", - "integrity": "sha512-nGZtxpH8Ca5j+1TW0dmlPQHDRynoUYcq1CaQ65DlyWc+ImmEbWEiRo6OiwXDN1tqaALN2a2TLkFpCSYW+fu/sA==", + "version": "0.9.0", + "resolved": "https://registry.npmjs.org/@stack-sh/engine/-/engine-0.9.0.tgz", + "integrity": "sha512-5Vyjr3PteTwCMjx1oKUoiUYs84i94VlET+lbHDVx8e8ffsj44AAFJ7l5JgMK+O01G5zWOVjJnNzUgWYQ7hlQHw==", "dev": true, "license": "Apache-2.0" }, diff --git a/package.json b/package.json index 1be5e80..d9c3460 100644 --- a/package.json +++ b/package.json @@ -15,7 +15,7 @@ "smoke": "node scripts/smoke-skill.mjs && node scripts/first-render.mjs" }, "devDependencies": { - "@stack-sh/engine": "0.8.0", + "@stack-sh/engine": "0.9.0", "ajv": "8.20.0" } }