Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/cli-release.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"repository": "stack-sh/cli",
"revision": "f6220c5c24bc515574ea6f6dd6d55af00d35f89d",
"version": "0.5.2"
"revision": "d66ff06fc75337e7d4e966108e7793dddd6b1e53",
"version": "0.5.3"
}
6 changes: 5 additions & 1 deletion content/site/ja/language/nodes-and-groups.md
Original file line number Diff line number Diff line change
Expand Up @@ -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が端末上で描画します。

<NodeKindCatalog locale="ja" />

Kindは固定のvendor shapeではなくsemantic categoryです。Hosted PostgreSQLも`database`で、technology名は`detail`に書きます。各kindのshape、palette、fallback iconはactive themeが所有するため、custom themeはarchitectureの意味を変えずに見た目を変更できます。

## Labelとdetail

Expand Down
2 changes: 1 addition & 1 deletion content/site/ja/language/themes-and-icons.md
Original file line number Diff line number Diff line change
Expand Up @@ -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の行を選ぶとコピーできます。

<IconCatalog locale="ja" />

Expand Down
6 changes: 5 additions & 1 deletion content/site/ko/language/nodes-and-groups.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,11 @@ diagram "Node example" {
| `storage` | Blob, object, file, archive storage |
| `external` | 아키텍처 제어 경계 밖의 시스템 |

Kind는 벤더별 모양이 아닌 의미 범주입니다. 호스팅된 PostgreSQL도 `database`이며 기술 이름은 `detail`에 작성합니다.
아래에서 각 kind의 실제 fallback 렌더링을 비교할 수 있습니다. 테마를 전환해 비주얼 시스템을 확인하고 카드를 선택하면 해당 `kind` 문장을 복사할 수 있습니다. 미리보기는 사전 생성된 스크린샷이 아니라 Playground와 동일하게 고정된 Engine/WASM이 사용자의 기기에서 렌더링합니다.

<NodeKindCatalog locale="ko" />

Kind는 고정된 벤더 모양이 아닌 의미 범주입니다. 호스팅된 PostgreSQL도 `database`이며 기술 이름은 `detail`에 작성합니다. 각 kind의 모양, 팔레트, fallback 아이콘은 활성 테마가 관리하므로 사용자 정의 테마는 아키텍처 의미를 바꾸지 않고 표현만 바꿀 수 있습니다.

## 라벨과 상세

Expand Down
2 changes: 1 addition & 1 deletion content/site/ko/language/themes-and-icons.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 에셋을 복제하지 않습니다. 문법 행을 선택하면 복사됩니다.

<IconCatalog locale="ko" />

Expand Down
6 changes: 5 additions & 1 deletion content/site/language/nodes-and-groups.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<NodeKindCatalog locale="en" />

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

Expand Down
2 changes: 1 addition & 1 deletion content/site/language/themes-and-icons.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<IconCatalog locale="en" />

Expand Down
6 changes: 5 additions & 1 deletion content/site/zh/language/nodes-and-groups.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,11 @@ diagram "Node example" {
| `storage` | Blob、对象、文件或归档存储 |
| `external` | 架构控制边界之外的系统 |

Kind 是语义分类,不是厂商形状。托管 PostgreSQL 仍是 `database`,技术名称应写入 `detail`。
可在下方比较每种 kind 的实际 fallback 渲染。切换主题可以查看对应视觉系统;选择卡片即可复制相应的 `kind` 语句。这些预览不是预生成截图,而是由与 Playground 相同的固定版本 Engine/WASM 在您的设备上渲染。

<NodeKindCatalog locale="zh" />

Kind 是语义分类,不是固定的厂商形状。托管 PostgreSQL 仍是 `database`,技术名称应写入 `detail`。每种 kind 的形状、配色和 fallback 图标由当前主题控制,因此自定义主题可以改变外观而不改变架构语义。

## 标签与详情

Expand Down
2 changes: 1 addition & 1 deletion content/site/zh/language/themes-and-icons.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 资源。选择语法行即可复制。

<IconCatalog locale="zh" />

Expand Down
4 changes: 2 additions & 2 deletions generated/guide/agent-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <command>`.
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 <command>`.

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

Expand Down
40 changes: 20 additions & 20 deletions generated/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand All @@ -24,7 +24,7 @@
},
{
"path": "site/guide/getting-started.md",
"sha256": "807e0b5ea42ab7f281c9c9f6a672415a8e4425bd89188a4a28209b3ab4c708f3"
"sha256": "eb2682e1e2d5354e83c4d532efdbee7aa76fdca2545b3a3428e4b00a37d630a1"
},
{
"path": "site/guide/playground.md",
Expand Down Expand Up @@ -52,7 +52,7 @@
},
{
"path": "site/ja/guide/getting-started.md",
"sha256": "e5cb089c8e51a95ac5c5085cbd316de33190ae3f0ce6533d8f13ed551d54f53e"
"sha256": "43e3fb1fb0beb2b37cb5ab06d4f6b37c49634de26c1089aa791a3d621152ed71"
},
{
"path": "site/ja/guide/playground.md",
Expand Down Expand Up @@ -80,15 +80,15 @@
},
{
"path": "site/ja/language/nodes-and-groups.md",
"sha256": "e953db6f6cd06d4ee645e2a83583f2d0b2eec92ea09bc1390edcf994d52b514c"
"sha256": "a8d7612cc5f0927d017e7e8c4242d297b5ab1141ac13f677a04eba1bb2a78319"
},
{
"path": "site/ja/language/syntax.md",
"sha256": "542935d48c245856a3852fa05c3e6c5ebe53e88d3cddf7216e89e3ea3a681a07"
},
{
"path": "site/ja/language/themes-and-icons.md",
"sha256": "a62ca441e0773d12140a518311b0fc79060f52d4450e29c6107c85ee45823613"
"sha256": "c3379a236f22a0e5f14e5e777095235c0f4f25c80512ab17ba360cfb0e610fcd"
},
{
"path": "site/ja/reference/diagnostics-and-limits.md",
Expand All @@ -108,7 +108,7 @@
},
{
"path": "site/ko/guide/getting-started.md",
"sha256": "999c53bd1dd88e1a17ea6a0b1df548e37a9e8325711c0b1f3c67431ea65de77c"
"sha256": "8cb9ac1ed8cdbf5fba99ecd9b85b046d5d109bf619ff2f3125e8d61156c0d442"
},
{
"path": "site/ko/guide/playground.md",
Expand Down Expand Up @@ -136,15 +136,15 @@
},
{
"path": "site/ko/language/nodes-and-groups.md",
"sha256": "bba8f1c8f9ac9897c6cf39f8bf21ce618335824d2d3c0b2bd3179765dbfcd7b3"
"sha256": "3004ef8291217765b8d7f4e9708ad2dfa8d6f6ad1972c4dba35a275ca371bfa5"
},
{
"path": "site/ko/language/syntax.md",
"sha256": "2df6f67fabcc053b4a75523773e6b30a3b7d62e14a6f270b0bd3ed485595b43c"
},
{
"path": "site/ko/language/themes-and-icons.md",
"sha256": "af84dc459db2cd9fa7b14552cb218874d8e7f418155fb6d876749b76b9cb3bc3"
"sha256": "bab922ec5167d57bc3d85680dba6724efed60a10bb3dc4edf9df92583b90cedd"
},
{
"path": "site/ko/reference/diagnostics-and-limits.md",
Expand All @@ -164,15 +164,15 @@
},
{
"path": "site/language/nodes-and-groups.md",
"sha256": "be3819622ac9c561ac4a5bb947c7025607ec2d5609a4e62a9e9d35805d3d416f"
"sha256": "143b6460010a66a3d7b7898ee40e7170bf49bc3b98a66832f8f6f293b1b18bb1"
},
{
"path": "site/language/syntax.md",
"sha256": "f7d67c31b9d50e6d78f1fc30efbd129bbc4f64c887b8a8560b1e15aca30af5ce"
},
{
"path": "site/language/themes-and-icons.md",
"sha256": "4e2a59b62db144914fcd5b6f166524c9472d65a748432da339becad068c2ca7e"
"sha256": "adce66fa4273ed18216bd2632efb7e21256ae0a3c6c0c8a295bd4d374e9dc303"
},
{
"path": "site/reference/diagnostics-and-limits.md",
Expand All @@ -192,7 +192,7 @@
},
{
"path": "site/zh/guide/getting-started.md",
"sha256": "0b5162f8c023ead20434867d354fdc4aa7df268d93cad8fbf2d89bde9d65a673"
"sha256": "2d9edefa83fbaa04dbdb34d7641e36dc7ef09a846e38090cdead622b635735cd"
},
{
"path": "site/zh/guide/playground.md",
Expand Down Expand Up @@ -220,15 +220,15 @@
},
{
"path": "site/zh/language/nodes-and-groups.md",
"sha256": "48a1a9186b2f817be780a01015b6bcae0e3f0b47675546dc36d4c172b40bc3b9"
"sha256": "c6c98ac30b3b5f56c0f116ac087cf6c2d58a94ef644e493552c44c720054722c"
},
{
"path": "site/zh/language/syntax.md",
"sha256": "ebb113a0782bfcb3f650b216510b93bdbbd2aa90f774315071ffdb35d58d6360"
},
{
"path": "site/zh/language/themes-and-icons.md",
"sha256": "376293b52fac1992c763d970410a72093f26275b97109d17e478d0e7257c339e"
"sha256": "64ee932a93b4d6befc72d164be71d699f2a7258fcf37c311f09cf5fba1ed3419"
},
{
"path": "site/zh/reference/diagnostics-and-limits.md",
Expand All @@ -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",
Expand Down
4 changes: 2 additions & 2 deletions generated/site/guide/agent-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <command>`.
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 <command>`.

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

Expand Down
Loading