@kensnzk/koyu 0.16.0 → 0.18.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.
- package/README.ja.md +12 -8
- package/README.md +13 -10
- package/dist/analysis/contracts.d.ts +217 -0
- package/dist/analysis/contracts.d.ts.map +1 -0
- package/dist/analysis/contracts.js +27 -0
- package/dist/analysis/contracts.js.map +1 -0
- package/dist/analysis/index.d.ts +5 -0
- package/dist/analysis/index.d.ts.map +1 -0
- package/dist/analysis/index.js +17 -0
- package/dist/analysis/index.js.map +1 -0
- package/dist/analysis/json.d.ts +21 -0
- package/dist/analysis/json.d.ts.map +1 -0
- package/dist/analysis/json.js +111 -0
- package/dist/analysis/json.js.map +1 -0
- package/dist/cli.js +106 -35
- package/dist/cli.js.map +1 -1
- package/dist/core/derive.d.ts +13 -8
- package/dist/core/derive.d.ts.map +1 -1
- package/dist/core/derive.js +19 -13
- package/dist/core/derive.js.map +1 -1
- package/dist/core/diagnose.d.ts +4 -3
- package/dist/core/diagnose.d.ts.map +1 -1
- package/dist/core/diagnose.js +46 -11
- package/dist/core/diagnose.js.map +1 -1
- package/dist/core/diff.d.ts +3 -2
- package/dist/core/diff.d.ts.map +1 -1
- package/dist/core/diff.js +8 -5
- package/dist/core/diff.js.map +1 -1
- package/dist/core/fabric.d.ts +1 -3
- package/dist/core/fabric.d.ts.map +1 -1
- package/dist/core/fabric.js +8 -8
- package/dist/core/fabric.js.map +1 -1
- package/dist/core/graph.d.ts +2 -2
- package/dist/core/graph.d.ts.map +1 -1
- package/dist/core/graph.js +12 -5
- package/dist/core/graph.js.map +1 -1
- package/dist/core/light.d.ts.map +1 -1
- package/dist/core/light.js +2 -2
- package/dist/core/light.js.map +1 -1
- package/dist/core/model.d.ts +59 -10
- package/dist/core/model.d.ts.map +1 -1
- package/dist/core/model.js +128 -26
- package/dist/core/model.js.map +1 -1
- package/dist/core/parse.d.ts.map +1 -1
- package/dist/core/parse.js +83 -82
- package/dist/core/parse.js.map +1 -1
- package/dist/core/poly.d.ts +0 -4
- package/dist/core/poly.d.ts.map +1 -1
- package/dist/core/poly.js +1 -5
- package/dist/core/poly.js.map +1 -1
- package/dist/core/site.d.ts +9 -0
- package/dist/core/site.d.ts.map +1 -1
- package/dist/core/site.js +8 -2
- package/dist/core/site.js.map +1 -1
- package/dist/core/tolerance.d.ts +1 -1
- package/dist/core/tolerance.js +2 -2
- package/dist/core/tolerance.js.map +1 -1
- package/dist/core/vertical.d.ts +9 -2
- package/dist/core/vertical.d.ts.map +1 -1
- package/dist/core/vertical.js +8 -1
- package/dist/core/vertical.js.map +1 -1
- package/dist/core/vocabulary.d.ts.map +1 -1
- package/dist/core/vocabulary.js +17 -5
- package/dist/core/vocabulary.js.map +1 -1
- package/dist/diagnostics.d.ts +2 -0
- package/dist/diagnostics.d.ts.map +1 -0
- package/dist/diagnostics.js +3 -0
- package/dist/diagnostics.js.map +1 -0
- package/dist/diff.d.ts +2 -0
- package/dist/diff.d.ts.map +1 -0
- package/dist/diff.js +3 -0
- package/dist/diff.js.map +1 -0
- package/dist/draw/index.js +1 -1
- package/dist/draw/index.js.map +1 -1
- package/dist/draw/plan.js +5 -5
- package/dist/draw/plan.js.map +1 -1
- package/dist/form.d.ts +5 -0
- package/dist/form.d.ts.map +1 -0
- package/dist/form.js +4 -0
- package/dist/form.js.map +1 -0
- package/dist/graph.d.ts +2 -0
- package/dist/graph.d.ts.map +1 -0
- package/dist/graph.js +3 -0
- package/dist/graph.js.map +1 -0
- package/dist/index.d.ts +2 -14
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +36 -45
- package/dist/index.js.map +1 -1
- package/dist/mcp.js +81 -30
- package/dist/mcp.js.map +1 -1
- package/dist/model.d.ts +3 -0
- package/dist/model.d.ts.map +1 -0
- package/dist/model.js +3 -0
- package/dist/model.js.map +1 -0
- package/dist/parse-file.d.ts.map +1 -1
- package/dist/parse-file.js +18 -3
- package/dist/parse-file.js.map +1 -1
- package/dist/validate/assessment.d.ts +8 -0
- package/dist/validate/assessment.d.ts.map +1 -0
- package/dist/validate/assessment.js +1738 -0
- package/dist/validate/assessment.js.map +1 -0
- package/dist/validate/builtin/access.d.ts +55 -0
- package/dist/validate/builtin/access.d.ts.map +1 -0
- package/dist/validate/builtin/access.js +494 -0
- package/dist/validate/builtin/access.js.map +1 -0
- package/dist/validate/builtin/daylight.d.ts +44 -0
- package/dist/validate/builtin/daylight.d.ts.map +1 -0
- package/dist/validate/builtin/daylight.js +233 -0
- package/dist/validate/builtin/daylight.js.map +1 -0
- package/dist/validate/builtin/door-column-collisions.d.ts +47 -0
- package/dist/validate/builtin/door-column-collisions.d.ts.map +1 -0
- package/dist/validate/builtin/door-column-collisions.js +189 -0
- package/dist/validate/builtin/door-column-collisions.js.map +1 -0
- package/dist/validate/builtin/envelope.d.ts +30 -0
- package/dist/validate/builtin/envelope.d.ts.map +1 -0
- package/dist/validate/builtin/envelope.js +169 -0
- package/dist/validate/builtin/envelope.js.map +1 -0
- package/dist/validate/builtin/freeze.d.ts +3 -0
- package/dist/validate/builtin/freeze.d.ts.map +1 -0
- package/dist/validate/builtin/freeze.js +21 -0
- package/dist/validate/builtin/freeze.js.map +1 -0
- package/dist/validate/builtin/index.d.ts +38 -0
- package/dist/validate/builtin/index.d.ts.map +1 -0
- package/dist/validate/builtin/index.js +106 -0
- package/dist/validate/builtin/index.js.map +1 -0
- package/dist/validate/builtin/site.d.ts +62 -0
- package/dist/validate/builtin/site.d.ts.map +1 -0
- package/dist/validate/builtin/site.js +333 -0
- package/dist/validate/builtin/site.js.map +1 -0
- package/dist/validate/builtin/vertical-runs.d.ts +53 -0
- package/dist/validate/builtin/vertical-runs.d.ts.map +1 -0
- package/dist/validate/builtin/vertical-runs.js +290 -0
- package/dist/validate/builtin/vertical-runs.js.map +1 -0
- package/dist/validate/contracts.d.ts +188 -0
- package/dist/validate/contracts.d.ts.map +1 -0
- package/dist/validate/contracts.js +28 -0
- package/dist/validate/contracts.js.map +1 -0
- package/dist/validate/index.d.ts +2 -59
- package/dist/validate/index.d.ts.map +1 -1
- package/dist/validate/index.js +22 -70
- package/dist/validate/index.js.map +1 -1
- package/dist/vocabulary.d.ts +2 -0
- package/dist/vocabulary.d.ts.map +1 -0
- package/dist/vocabulary.js +3 -0
- package/dist/vocabulary.js.map +1 -0
- package/editors/vscode/syntaxes/koyu.tmLanguage.json +2 -2
- package/examples/basement/main.muro +3 -3
- package/examples/complex/main.muro +1 -1
- package/examples/complex/podium.muro +1 -1
- package/examples/complex/site.muro +6 -6
- package/examples/house/L2.muro +1 -1
- package/examples/house/main.muro +1 -1
- package/examples/house/site.muro +4 -4
- package/examples/house.muro +6 -6
- package/examples/mansion.muro +2 -2
- package/examples/office.muro +3 -3
- package/examples/steps/04-exterior.muro +1 -1
- package/examples/steps/05-two-storeys.muro +1 -1
- package/examples/steps/06-finished.muro +2 -2
- package/examples/tower/L2.muro +1 -1
- package/examples/tower/main.muro +1 -1
- package/examples/tower/site.muro +4 -4
- package/examples/twin/main.muro +1 -1
- package/examples/twin/podium.muro +4 -4
- package/examples/twin/site.muro +8 -8
- package/examples/two-rooms.canonical.json +4 -4
- package/examples/two-rooms.muro +2 -2
- package/package.json +41 -9
- package/src/analysis/contracts.ts +234 -0
- package/src/analysis/index.ts +61 -0
- package/src/analysis/json.ts +117 -0
- package/src/cli.ts +116 -36
- package/src/core/derive.ts +32 -15
- package/src/core/diagnose.ts +63 -16
- package/src/core/diff.ts +10 -6
- package/src/core/fabric.ts +18 -9
- package/src/core/graph.ts +19 -5
- package/src/core/light.ts +2 -2
- package/src/core/model.ts +141 -31
- package/src/core/parse.ts +100 -85
- package/src/core/poly.ts +1 -8
- package/src/core/site.ts +19 -2
- package/src/core/tolerance.ts +2 -2
- package/src/core/vertical.ts +10 -3
- package/src/core/vocabulary.ts +18 -5
- package/src/diagnostics.ts +8 -0
- package/src/diff.ts +14 -0
- package/src/draw/index.ts +1 -1
- package/src/draw/plan.ts +5 -5
- package/src/form.ts +37 -0
- package/src/graph.ts +12 -0
- package/src/index.ts +40 -175
- package/src/mcp.ts +85 -35
- package/src/model.ts +43 -0
- package/src/parse-file.ts +17 -3
- package/src/validate/assessment.ts +1934 -0
- package/src/validate/builtin/access.ts +642 -0
- package/src/validate/builtin/daylight.ts +321 -0
- package/src/validate/builtin/door-column-collisions.ts +266 -0
- package/src/validate/builtin/envelope.ts +227 -0
- package/src/validate/builtin/freeze.ts +19 -0
- package/src/validate/builtin/index.ts +156 -0
- package/src/validate/builtin/site.ts +445 -0
- package/src/validate/builtin/vertical-runs.ts +390 -0
- package/src/validate/contracts.ts +240 -0
- package/src/validate/index.ts +45 -99
- package/src/vocabulary.ts +9 -0
- package/dist/validate/access.d.ts +0 -6
- package/dist/validate/access.d.ts.map +0 -1
- package/dist/validate/access.js +0 -238
- package/dist/validate/access.js.map +0 -1
- package/dist/validate/envelope.d.ts +0 -4
- package/dist/validate/envelope.d.ts.map +0 -1
- package/dist/validate/envelope.js +0 -55
- package/dist/validate/envelope.js.map +0 -1
- package/dist/validate/light.d.ts +0 -6
- package/dist/validate/light.d.ts.map +0 -1
- package/dist/validate/light.js +0 -28
- package/dist/validate/light.js.map +0 -1
- package/dist/validate/runs.d.ts +0 -16
- package/dist/validate/runs.d.ts.map +0 -1
- package/dist/validate/runs.js +0 -60
- package/dist/validate/runs.js.map +0 -1
- package/dist/validate/site.d.ts +0 -6
- package/dist/validate/site.d.ts.map +0 -1
- package/dist/validate/site.js +0 -63
- package/dist/validate/site.js.map +0 -1
- package/spec/README.md +0 -28
- package/spec/canonical-json.md +0 -98
- package/spec/composition.md +0 -121
- package/spec/derivation.md +0 -393
- package/spec/en/README.md +0 -30
- package/spec/en/canonical-json.md +0 -101
- package/spec/en/composition.md +0 -121
- package/spec/en/derivation.md +0 -393
- package/spec/en/language.md +0 -164
- package/spec/en/notation-v0.md +0 -145
- package/spec/en/scope.md +0 -229
- package/spec/en/semantics.md +0 -132
- package/spec/en/tools.md +0 -108
- package/spec/en/validation.md +0 -79
- package/spec/en/vocabulary.md +0 -103
- package/spec/language.md +0 -163
- package/spec/notation-v0.md +0 -184
- package/spec/scope.md +0 -229
- package/spec/semantics.md +0 -130
- package/spec/tools.md +0 -106
- package/spec/validation.md +0 -79
- package/spec/vocabulary.md +0 -114
- package/src/validate/access.ts +0 -279
- package/src/validate/envelope.ts +0 -59
- package/src/validate/light.ts +0 -43
- package/src/validate/runs.ts +0 -87
- package/src/validate/site.ts +0 -84
package/README.ja.md
CHANGED
|
@@ -8,10 +8,12 @@
|
|
|
8
8
|
|
|
9
9
|
## ドキュメント
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
**[docs/](docs/index.md) が文書であり、これが正である。**167頁 ×2言語、目的から引ける形に並べてある。
|
|
12
12
|
|
|
13
|
-
- **[
|
|
14
|
-
- **[
|
|
13
|
+
- **[docs/start/](docs/start/index.md)** — チュートリアル。一室から二階建てまで30〜45分。**koyu を初めて書くならここから**
|
|
14
|
+
- **[docs/why/](docs/why/index.md)** — 解説。なぜ空間が一次要素か、なぜ壁は関係か、なぜ形は一意でなければならないか
|
|
15
|
+
- **[docs/howto/](docs/howto/index.md)** — 手順。目的から引くものと、症状から引くもの
|
|
16
|
+
- **[docs/reference/](docs/reference/index.md)** — 規範。[.muro の全構文](docs/reference/muro/index.md)・[診断65コード](docs/reference/diagnostics/index.md)・[判定15規則](docs/reference/validate/index.md)・[CLI](docs/reference/cli/index.md)・[MCP](docs/reference/mcp/index.md)・[API](docs/reference/api/index.md)・[導出される形](docs/reference/form/index.md)・[正準JSON](docs/reference/json/index.md)
|
|
15
17
|
- **[docs/decisions/](docs/decisions/)** — ADR。なぜそう決めたか、何を棄却したか
|
|
16
18
|
- **[AGENTS.md](AGENTS.md)** — このリポジトリで作業するLLMエージェントの入口
|
|
17
19
|
|
|
@@ -26,7 +28,7 @@ space /L1/a room X1..X2 Y1..Y2
|
|
|
26
28
|
|
|
27
29
|
`koyu plan` が平面図を出す。壁は一本も描かれていない — 空間はあるが、境界が一つも無いからである。
|
|
28
30
|
|
|
29
|
-

|
|
30
32
|
|
|
31
33
|
`space` をもう一行足す。他は何も変えない。
|
|
32
34
|
|
|
@@ -38,7 +40,7 @@ space /L1/a room X1..X2 Y1..Y2
|
|
|
38
40
|
space /L1/b room X2..X3 Y1..Y2
|
|
39
41
|
```
|
|
40
42
|
|
|
41
|
-

|
|
42
44
|
|
|
43
45
|
**壁が一枚現れる。壁を描く操作はどこにも無い。** 壁は二つの空間の境界という関係であり、空間の割付から導出される。接する空間の組に宣言が無ければ、それは「未定義」ではなく「壁」を意味する。
|
|
44
46
|
|
|
@@ -82,11 +84,13 @@ npm run koyu -- site examples/tower/main.muro # ショーケース: polyg
|
|
|
82
84
|
|
|
83
85
|
`koyu-mcp` は依存ゼロのMCPサーバー (stdio、ADR-0012)。LLMエージェントが建物を読み (`layers`)、編集し (`write_layer`)、`check` がビルドの門番になる — エラーは出所レイヤー:行つき。`doors` / `light` / `site` は同じ記述への異なる問い。延床4,786㎡のショーケース一棟が原本8,099トークン (実測 — IFC4は14倍、IFCXは25倍: [examples/comparison/](examples/comparison/README.md)) なので、一棟がコンテキストに余裕で載る。エージェントが正しく*編集*できるかは次の分水嶺 — 編集evalは計画段階でまだ実施していない ([docs/horizon.md](docs/horizon.md))。三軸の構想 (デジタルツイン・W3C BOTへのオントロジー整列・都市接続) も同文書。
|
|
84
86
|
|
|
85
|
-
登録は一行 (`claude mcp add koyu -- npx -p @kensnzk/koyu koyu-mcp`)。Claude Code・Claude Desktop・その他クライアントでの設定と標準ループは [
|
|
87
|
+
登録は一行 (`claude mcp add koyu -- npx -p @kensnzk/koyu koyu-mcp`)。Claude Code・Claude Desktop・その他クライアントでの設定と標準ループは [docs/howto/install-mcp.md](docs/howto/install-mcp.md)、ループの実例は [agent-loop.md](docs/howto/agent-loop.md)。
|
|
88
|
+
|
|
89
|
+
MCPサーバーとCLIは*確かめる*側。muroで仕事をするための知識はエージェントスキルとして別に配り、クライアントが手元で読み込むので呼び出しごとのコストがない — [koyu-design](skills/koyu-design/SKILL.md) が建物を書き、[koyu-validate](skills/koyu-validate/SKILL.md) が判定して直し、[koyu-revise](skills/koyu-revise/SKILL.md) が既存を壊さずに変える。処理系が答える問いごとに一本。導入方法 (Claude Code・Claude.ai・Claude Desktop) は [skills/README.md](skills/README.md)。
|
|
86
90
|
|
|
87
91
|
## 構成
|
|
88
92
|
|
|
89
|
-
|
|
93
|
+
規範は [docs/reference/](docs/reference/index.md) に体系化してある — 記法・診断・判定・CLI・MCP・API・導出される形・正準JSON。**この木が正である。**ADR ([docs/decisions/](docs/decisions/)) は「なぜ」を持つが後から直さないので、現在の真ではなく履歴である。IFC4とのカバレッジ照合は [docs/ifc-coverage.md](docs/ifc-coverage.md)、行程は [docs/roadmap.md](docs/roadmap.md) (Linear: [koyu](https://linear.app/munipersonal/project/koyu-2789f588a03a/overview) と対応)、日々の記録は [docs/log/](docs/log/)。IFCXの読解メモは [docs/ifcx-notes.md](docs/ifcx-notes.md)、同じ二室をIFC4・IFCXで書いた三方比較は [examples/comparison/](examples/comparison/README.md)。実装は src/ に約7,500行 (パーサ・グラフ・チェック・平面図生成・CLI・MCPサーバー)、テストは test/。IFCXの読解メモは [docs/ifcx-notes.md](docs/ifcx-notes.md)、同じ二室をIFC4・IFCXで書いた三方比較は [examples/comparison/](examples/comparison/README.md)。
|
|
90
94
|
|
|
91
95
|
## 技術方針
|
|
92
96
|
|
|
@@ -102,4 +106,4 @@ TypeScriptで書き、実行時依存はゼロに保つ。BIM/IFC系のツール
|
|
|
102
106
|
|
|
103
107
|
## ライセンス
|
|
104
108
|
|
|
105
|
-
コード (src/, test/, examples/ ほか) は [Apache License 2.0](LICENSE)。文書 (docs/,
|
|
109
|
+
コード (src/, test/, examples/ ほか) は [Apache License 2.0](LICENSE)。文書 (docs/, 原稿「[建築を書く](docs/writing-architecture.md)」) は [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.ja)。引用情報は [CITATION.cff](CITATION.cff)。
|
package/README.md
CHANGED
|
@@ -9,11 +9,12 @@ An exploration of text-native architectural description with **space as the prim
|
|
|
9
9
|
|
|
10
10
|
## Documentation
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
**[docs/](docs/index.md) is the documentation, and it is authoritative.** 167 pages in Japanese and English, laid out by what you came to do.
|
|
13
13
|
|
|
14
|
-
- **[
|
|
15
|
-
- **[
|
|
16
|
-
- **[docs/
|
|
14
|
+
- **[docs/start/](docs/start/index.md)** — the tutorial: one room to a two-storey house in 30–45 minutes. **If you are learning koyu, start here.**
|
|
15
|
+
- **[docs/why/](docs/why/index.md)** — the explanations: why space is primary, why a boundary is a relation, why the form must be unique.
|
|
16
|
+
- **[docs/howto/](docs/howto/index.md)** — recipes, by goal and by symptom.
|
|
17
|
+
- **[docs/reference/](docs/reference/index.md)** — the normative reference: [every `.muro` word](docs/reference/muro/index.md), [all 65 diagnostics](docs/reference/diagnostics/index.md), [the 15 verdicts](docs/reference/validate/index.md), [the CLI](docs/reference/cli/index.md), [the MCP server](docs/reference/mcp/index.md), [the API](docs/reference/api/index.md), [the derived form](docs/reference/form/index.md), [canonical JSON](docs/reference/json/index.md).
|
|
17
18
|
- **[AGENTS.md](AGENTS.md)** — the entry point for LLM agents working in this repository.
|
|
18
19
|
|
|
19
20
|
One room is written like this. Four lines, and it is a complete file.
|
|
@@ -27,7 +28,7 @@ space /L1/a room X1..X2 Y1..Y2
|
|
|
27
28
|
|
|
28
29
|
`koyu plan` produces the floor plan. Not one wall is drawn — there is a space, but not one boundary.
|
|
29
30
|
|
|
30
|
-

|
|
31
32
|
|
|
32
33
|
Add one more `space` line. Change nothing else.
|
|
33
34
|
|
|
@@ -39,7 +40,7 @@ space /L1/a room X1..X2 Y1..Y2
|
|
|
39
40
|
space /L1/b room X2..X3 Y1..Y2
|
|
40
41
|
```
|
|
41
42
|
|
|
42
|
-

|
|
43
44
|
|
|
44
45
|
**A wall appears. There is no operation anywhere that draws a wall.** A wall is the boundary relation between two spaces, derived from the layout of those spaces. Where a pair of touching spaces has no declaration, that means "wall" rather than "undefined".
|
|
45
46
|
|
|
@@ -61,7 +62,7 @@ A building can also be written as a set of files and composed — additive layer
|
|
|
61
62
|
2. **Write the four lines above** into `first.muro`, then run `npx tsx src/cli.ts check first.muro` and `npx tsx src/cli.ts plan first.muro -o out/first.svg`.
|
|
62
63
|
3. **Read a bundled example.** `npx tsx src/cli.ts check examples/two-rooms.muro` prints `✔ Consistent — 3 spaces / 3 boundaries`; `stats`, `graph`, and `doors` answer about the same file.
|
|
63
64
|
|
|
64
|
-
`grid` and `level` must be declared before anything that refers to them, and the type (`room`, the second positional word) is required; everything else — the `koyu` version line, `unit`, `name`, heights — is optional. From here, [
|
|
65
|
+
`grid` and `level` must be declared before anything that refers to them, and the type (`room`, the second positional word) is required; everything else — the `koyu` version line, `unit`, `name`, heights — is optional. From here, [docs/start/](docs/start/index.md) is a managed path from this one room to a two-storey house with per-floor plans, a circulation check, and a daylight check.
|
|
65
66
|
|
|
66
67
|
## Usage
|
|
67
68
|
|
|
@@ -91,11 +92,13 @@ npm run koyu -- site examples/tower/main.muro # showcase: polygon site, t
|
|
|
91
92
|
|
|
92
93
|
`koyu-mcp` is a zero-dependency MCP server over stdio (ADR-0012): an LLM agent reads the building (`layers`), edits it (`write_layer`), and `check` acts as the build gate — errors come back with layer:line provenance. `doors` / `light` / `site` / `stats` are the same description read different ways. The whole 4,786m² showcase is 8,099 tokens as source (measured; IFC4 is 14x, IFCX 25x — see [examples/comparison/](examples/comparison/README.md)), so a whole building fits in one context with room to work. Whether an agent can *edit* it correctly is the next watershed — an edit eval is planned, not yet run ([docs/horizon.md](docs/horizon.md)). The horizon design (digital twin, ontology alignment via W3C BOT, city connection) is in the same document.
|
|
93
94
|
|
|
94
|
-
Registering it is one line (`claude mcp add koyu -- npx -p @kensnzk/koyu koyu-mcp`). Setup for Claude Code, Claude Desktop, and other clients, plus the standard loop, is in [
|
|
95
|
+
Registering it is one line (`claude mcp add koyu -- npx -p @kensnzk/koyu koyu-mcp`). Setup for Claude Code, Claude Desktop, and other clients, plus the standard loop, is in [docs/howto/install-mcp.md](docs/howto/install-mcp.md).
|
|
96
|
+
|
|
97
|
+
The MCP server and the CLI are the half that *judges*; the knowledge for working in muro ships separately as agent skills, loaded locally by the client so they cost nothing per call — [koyu-design](skills/koyu-design/SKILL.md) writes a building, [koyu-validate](skills/koyu-validate/SKILL.md) judges and repairs one, [koyu-revise](skills/koyu-revise/SKILL.md) changes one without breaking the rest. One skill per question the processor answers. Installation (Claude Code, Claude.ai, Claude Desktop) is in [skills/README.md](skills/README.md).
|
|
95
98
|
|
|
96
99
|
## Layout
|
|
97
100
|
|
|
98
|
-
The
|
|
101
|
+
The documentation lives in [docs/](docs/index.md) — tutorial, explanations, how-to, and the normative reference (the notation, diagnostics, verdicts, CLI, MCP, API, the derived form, canonical JSON). **That tree is authoritative**; ADRs in [docs/decisions/](docs/decisions/) record why each decision was made and are never amended, so they are history rather than current truth. Coverage against the IFC4 architectural core is [docs/ifc-coverage.md](docs/ifc-coverage.md); the roadmap is [docs/roadmap.md](docs/roadmap.md); daily logs are in [docs/log/](docs/log/). The implementation is ~7,500 lines in src/ (parser, graph, checks, plan generation, CLI, MCP server), tests in test/. Reading notes on IFCX are in [docs/ifcx-notes.md](docs/ifcx-notes.md); the same two rooms written three ways (this notation, IFC4, IFCX) is in [examples/comparison/](examples/comparison/README.md).
|
|
99
102
|
|
|
100
103
|
## Technical stance
|
|
101
104
|
|
|
@@ -111,4 +114,4 @@ The file extension is `.muro` (室, *muro* — room). The unit a file holds is n
|
|
|
111
114
|
|
|
112
115
|
## License
|
|
113
116
|
|
|
114
|
-
Code (src/, test/, examples/, …) is under the [Apache License 2.0](LICENSE). Documents (docs/,
|
|
117
|
+
Code (src/, test/, examples/, …) is under the [Apache License 2.0](LICENSE). Documents (docs/, and the essay "[建築を書く / Writing Architecture](docs/writing-architecture.md)") are under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Citation metadata is in [CITATION.cff](CITATION.cff).
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
import type { Diagnostic } from "../core/diagnose.js";
|
|
2
|
+
import type { Model } from "../core/model.js";
|
|
3
|
+
import type { JsonObject, JsonValue } from "./json.js";
|
|
4
|
+
export declare const COMPONENT_ID_PATTERN: RegExp;
|
|
5
|
+
export interface ComponentIdentity {
|
|
6
|
+
readonly id: string;
|
|
7
|
+
readonly revision: string;
|
|
8
|
+
}
|
|
9
|
+
export declare function isComponentIdentity(value: unknown): value is ComponentIdentity;
|
|
10
|
+
export declare function sameIdentity(a: ComponentIdentity, b: ComponentIdentity): boolean;
|
|
11
|
+
export interface JurisdictionRef {
|
|
12
|
+
readonly country: string;
|
|
13
|
+
readonly region?: string;
|
|
14
|
+
readonly locality?: string;
|
|
15
|
+
readonly authority?: string;
|
|
16
|
+
}
|
|
17
|
+
export interface EffectiveRange {
|
|
18
|
+
readonly from: string;
|
|
19
|
+
readonly to?: string;
|
|
20
|
+
}
|
|
21
|
+
export type SubjectRef = {
|
|
22
|
+
readonly kind: "model";
|
|
23
|
+
readonly ref: "/";
|
|
24
|
+
} | {
|
|
25
|
+
readonly kind: "level" | "space" | "zone" | "boundary" | "opening" | "run" | "site";
|
|
26
|
+
readonly ref: string;
|
|
27
|
+
} | {
|
|
28
|
+
readonly kind: `${string}.${string}`;
|
|
29
|
+
readonly ref: string;
|
|
30
|
+
};
|
|
31
|
+
export interface SourceLocation {
|
|
32
|
+
readonly file?: string;
|
|
33
|
+
readonly line?: number;
|
|
34
|
+
}
|
|
35
|
+
export interface ContextSource {
|
|
36
|
+
readonly kind: "authority" | "survey" | "brief" | "user" | "import" | "other";
|
|
37
|
+
readonly ref: string;
|
|
38
|
+
readonly observedAt?: string;
|
|
39
|
+
readonly retrievedAt?: string;
|
|
40
|
+
}
|
|
41
|
+
export interface AuthorityCitation {
|
|
42
|
+
readonly jurisdiction: JurisdictionRef;
|
|
43
|
+
readonly instrument: string;
|
|
44
|
+
readonly provision?: string;
|
|
45
|
+
readonly uri?: string;
|
|
46
|
+
readonly effective?: EffectiveRange;
|
|
47
|
+
}
|
|
48
|
+
export type SourceRef = {
|
|
49
|
+
readonly kind: "model";
|
|
50
|
+
readonly subject: SubjectRef;
|
|
51
|
+
readonly location?: SourceLocation;
|
|
52
|
+
} | {
|
|
53
|
+
readonly kind: "context";
|
|
54
|
+
readonly key: string;
|
|
55
|
+
readonly source: ContextSource;
|
|
56
|
+
} | {
|
|
57
|
+
readonly kind: "authority";
|
|
58
|
+
readonly citation: AuthorityCitation;
|
|
59
|
+
} | {
|
|
60
|
+
readonly kind: `${string}.${string}`;
|
|
61
|
+
readonly data: JsonObject;
|
|
62
|
+
};
|
|
63
|
+
export interface Quantity {
|
|
64
|
+
readonly value: number;
|
|
65
|
+
readonly unit: string;
|
|
66
|
+
}
|
|
67
|
+
interface EvidenceBase {
|
|
68
|
+
readonly id: string;
|
|
69
|
+
readonly subjects: readonly [SubjectRef, ...SubjectRef[]];
|
|
70
|
+
readonly sources: readonly [SourceRef, ...SourceRef[]];
|
|
71
|
+
readonly producedBy: ComponentIdentity;
|
|
72
|
+
}
|
|
73
|
+
export type Evidence = (EvidenceBase & {
|
|
74
|
+
readonly kind: "fact";
|
|
75
|
+
readonly name: string;
|
|
76
|
+
readonly value: JsonValue | Quantity;
|
|
77
|
+
}) | (EvidenceBase & {
|
|
78
|
+
readonly kind: "comparison";
|
|
79
|
+
readonly observed: Quantity;
|
|
80
|
+
readonly operator: "<" | "<=" | "=" | ">=" | ">" | "inside" | "outside";
|
|
81
|
+
readonly required: Quantity | {
|
|
82
|
+
readonly minimum?: Quantity;
|
|
83
|
+
readonly maximum?: Quantity;
|
|
84
|
+
};
|
|
85
|
+
}) | (EvidenceBase & {
|
|
86
|
+
readonly kind: "route";
|
|
87
|
+
readonly reachable: boolean;
|
|
88
|
+
readonly profile: string;
|
|
89
|
+
readonly path: readonly string[];
|
|
90
|
+
readonly cost?: Quantity;
|
|
91
|
+
}) | (EvidenceBase & {
|
|
92
|
+
readonly kind: "geometry";
|
|
93
|
+
readonly geometry: JsonObject;
|
|
94
|
+
}) | (EvidenceBase & {
|
|
95
|
+
readonly kind: "missing";
|
|
96
|
+
readonly missing: readonly [MissingInput, ...MissingInput[]];
|
|
97
|
+
}) | (EvidenceBase & {
|
|
98
|
+
readonly kind: `${string}.${string}`;
|
|
99
|
+
readonly data: JsonObject;
|
|
100
|
+
});
|
|
101
|
+
export interface ContextEntry {
|
|
102
|
+
readonly value: JsonValue;
|
|
103
|
+
readonly source: ContextSource;
|
|
104
|
+
}
|
|
105
|
+
export interface ContextSnapshot {
|
|
106
|
+
readonly schema: "koyu-context/1";
|
|
107
|
+
readonly asOf: string;
|
|
108
|
+
readonly jurisdiction?: JurisdictionRef;
|
|
109
|
+
readonly values: Readonly<Record<string, ContextEntry>>;
|
|
110
|
+
}
|
|
111
|
+
export type ContextDecode<T extends JsonValue> = {
|
|
112
|
+
readonly ok: true;
|
|
113
|
+
readonly value: T;
|
|
114
|
+
} | {
|
|
115
|
+
readonly ok: false;
|
|
116
|
+
readonly message: string;
|
|
117
|
+
};
|
|
118
|
+
export interface ContextKey<T extends JsonValue> extends ComponentIdentity {
|
|
119
|
+
readonly description: string;
|
|
120
|
+
readonly decode: (value: JsonValue) => ContextDecode<T>;
|
|
121
|
+
}
|
|
122
|
+
export interface ContextRequirement<T extends JsonValue = JsonValue> {
|
|
123
|
+
readonly key: ContextKey<T>;
|
|
124
|
+
readonly presence: "required" | "optional";
|
|
125
|
+
}
|
|
126
|
+
export type ContextRead<T extends JsonValue> = {
|
|
127
|
+
readonly state: "present";
|
|
128
|
+
readonly value: T;
|
|
129
|
+
readonly entry: ContextEntry;
|
|
130
|
+
} | {
|
|
131
|
+
readonly state: "missing";
|
|
132
|
+
} | {
|
|
133
|
+
readonly state: "invalid";
|
|
134
|
+
readonly entry: ContextEntry;
|
|
135
|
+
readonly message: string;
|
|
136
|
+
};
|
|
137
|
+
export interface ContextReader {
|
|
138
|
+
get<T extends JsonValue>(key: ContextKey<T>): ContextRead<T>;
|
|
139
|
+
}
|
|
140
|
+
export type MissingInput = {
|
|
141
|
+
readonly kind: "context";
|
|
142
|
+
readonly key: string;
|
|
143
|
+
readonly reason: "missing" | "invalid";
|
|
144
|
+
readonly message?: string;
|
|
145
|
+
} | {
|
|
146
|
+
readonly kind: "model";
|
|
147
|
+
readonly subjects: readonly SubjectRef[];
|
|
148
|
+
readonly reason: string;
|
|
149
|
+
} | {
|
|
150
|
+
readonly kind: "analysis";
|
|
151
|
+
readonly analysis: ComponentIdentity;
|
|
152
|
+
readonly reason: "partial" | "unavailable";
|
|
153
|
+
} | {
|
|
154
|
+
readonly kind: `${string}.${string}`;
|
|
155
|
+
readonly data: JsonObject;
|
|
156
|
+
};
|
|
157
|
+
export interface ExecutionIssue {
|
|
158
|
+
readonly kind: "model-inconsistent" | "dependency-unavailable" | "missing-context" | "invalid-context" | "execution-error" | `${string}.${string}`;
|
|
159
|
+
readonly message: string;
|
|
160
|
+
readonly subjects?: readonly SubjectRef[];
|
|
161
|
+
readonly missing?: readonly MissingInput[];
|
|
162
|
+
}
|
|
163
|
+
export type AnalysisArtifact<T extends JsonValue> = {
|
|
164
|
+
readonly state: "complete";
|
|
165
|
+
readonly value: T;
|
|
166
|
+
readonly evidence: readonly Evidence[];
|
|
167
|
+
} | {
|
|
168
|
+
readonly state: "partial";
|
|
169
|
+
readonly value: T;
|
|
170
|
+
readonly missing: readonly [MissingInput, ...MissingInput[]];
|
|
171
|
+
readonly evidence: readonly Evidence[];
|
|
172
|
+
} | {
|
|
173
|
+
readonly state: "unavailable";
|
|
174
|
+
readonly missing: readonly [MissingInput, ...MissingInput[]];
|
|
175
|
+
readonly issues: readonly [ExecutionIssue, ...ExecutionIssue[]];
|
|
176
|
+
};
|
|
177
|
+
export interface AnalysisRef<T extends JsonValue = JsonValue> extends ComponentIdentity {
|
|
178
|
+
readonly __output?: T;
|
|
179
|
+
}
|
|
180
|
+
export interface AnalysisRequirement<T extends JsonValue = JsonValue> {
|
|
181
|
+
readonly analysis: AnalysisRef<T>;
|
|
182
|
+
readonly accept: "complete" | "partial";
|
|
183
|
+
}
|
|
184
|
+
export type DeepReadonly<T> = T extends (...args: never[]) => unknown ? T : T extends ReadonlyMap<infer K, infer V> ? ReadonlyMap<DeepReadonly<K>, DeepReadonly<V>> : T extends ReadonlySet<infer U> ? ReadonlySet<DeepReadonly<U>> : T extends readonly (infer U)[] ? readonly DeepReadonly<U>[] : T extends object ? {
|
|
185
|
+
readonly [K in keyof T]: DeepReadonly<T[K]>;
|
|
186
|
+
} : T;
|
|
187
|
+
export interface AnalysisRunContext {
|
|
188
|
+
readonly model: DeepReadonly<Model>;
|
|
189
|
+
readonly context: ContextReader;
|
|
190
|
+
get<T extends JsonValue>(analysis: AnalysisRef<T>): AnalysisArtifact<T>;
|
|
191
|
+
}
|
|
192
|
+
export interface AnalysisDefinition<T extends JsonValue = JsonValue> extends AnalysisRef<T> {
|
|
193
|
+
readonly title: string;
|
|
194
|
+
readonly model: "consistent" | "any";
|
|
195
|
+
readonly dependencies: readonly AnalysisRequirement[];
|
|
196
|
+
readonly context: readonly ContextRequirement[];
|
|
197
|
+
readonly run: (context: AnalysisRunContext) => AnalysisArtifact<T>;
|
|
198
|
+
}
|
|
199
|
+
export interface AnalysisResult<T extends JsonValue = JsonValue> {
|
|
200
|
+
readonly analysis: ComponentIdentity;
|
|
201
|
+
readonly artifact: AnalysisArtifact<T>;
|
|
202
|
+
}
|
|
203
|
+
export declare const ANALYSIS_FORMAT: "koyu-analysis/1";
|
|
204
|
+
export interface AnalysisReport<T extends JsonValue = JsonValue> {
|
|
205
|
+
readonly schema: typeof ANALYSIS_FORMAT;
|
|
206
|
+
readonly profile: ComponentIdentity;
|
|
207
|
+
readonly model: {
|
|
208
|
+
readonly languageVersion: string;
|
|
209
|
+
readonly name?: string;
|
|
210
|
+
readonly state: "consistent" | "inconsistent";
|
|
211
|
+
readonly diagnostics: readonly Diagnostic[];
|
|
212
|
+
};
|
|
213
|
+
readonly context: ContextSnapshot;
|
|
214
|
+
readonly result: AnalysisResult<T>;
|
|
215
|
+
}
|
|
216
|
+
export {};
|
|
217
|
+
//# sourceMappingURL=contracts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/analysis/contracts.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
export const COMPONENT_ID_PATTERN = /^[a-z][a-z0-9-]*(?:\.[a-z0-9-]+)+$/;
|
|
2
|
+
export function isComponentIdentity(value) {
|
|
3
|
+
if (typeof value !== "object" || value === null)
|
|
4
|
+
return false;
|
|
5
|
+
try {
|
|
6
|
+
const id = Object.getOwnPropertyDescriptor(value, "id");
|
|
7
|
+
const revision = Object.getOwnPropertyDescriptor(value, "revision");
|
|
8
|
+
return !!id
|
|
9
|
+
&& "value" in id
|
|
10
|
+
&& id.enumerable === true
|
|
11
|
+
&& typeof id.value === "string"
|
|
12
|
+
&& COMPONENT_ID_PATTERN.test(id.value)
|
|
13
|
+
&& !!revision
|
|
14
|
+
&& "value" in revision
|
|
15
|
+
&& revision.enumerable === true
|
|
16
|
+
&& typeof revision.value === "string"
|
|
17
|
+
&& revision.value.trim() !== "";
|
|
18
|
+
}
|
|
19
|
+
catch {
|
|
20
|
+
return false;
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
export function sameIdentity(a, b) {
|
|
24
|
+
return a.id === b.id && a.revision === b.revision;
|
|
25
|
+
}
|
|
26
|
+
export const ANALYSIS_FORMAT = "koyu-analysis/1";
|
|
27
|
+
//# sourceMappingURL=contracts.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/analysis/contracts.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,oBAAoB,GAAG,oCAAoC,CAAC;AAOzE,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACpE,OAAO,CAAC,CAAC,EAAE;eACN,OAAO,IAAI,EAAE;eACb,EAAE,CAAC,UAAU,KAAK,IAAI;eACtB,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ;eAC5B,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC;eACnC,CAAC,CAAC,QAAQ;eACV,OAAO,IAAI,QAAQ;eACnB,QAAQ,CAAC,UAAU,KAAK,IAAI;eAC5B,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;eAClC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAoB,EAAE,CAAoB;IACrE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAC;AACpD,CAAC;AA2LD,MAAM,CAAC,MAAM,eAAe,GAAG,iBAA0B,CAAC"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
export { COMPONENT_ID_PATTERN, isComponentIdentity, sameIdentity, ANALYSIS_FORMAT, type AnalysisArtifact, type AnalysisDefinition, type AnalysisRef, type AnalysisReport, type AnalysisRequirement, type AnalysisResult, type AnalysisRunContext, type AuthorityCitation, type ComponentIdentity, type ContextDecode, type ContextEntry, type ContextKey, type ContextRead, type ContextReader, type ContextRequirement, type ContextSnapshot, type ContextSource, type DeepReadonly, type EffectiveRange, type Evidence, type ExecutionIssue, type JurisdictionRef, type MissingInput, type Quantity, type SourceLocation, type SourceRef, type SubjectRef, } from "./contracts.js";
|
|
2
|
+
export { assertJsonValue, canonicalJsonValue, codePointCompare, isJsonValue, JsonBoundaryError, type JsonObject, type JsonPrimitive, type JsonValue, } from "./json.js";
|
|
3
|
+
export { runAnalysis } from "../validate/assessment.js";
|
|
4
|
+
export type { RunAnalysisOptions } from "../validate/contracts.js";
|
|
5
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
// koyu — the analysis surface (`@kensnzk/koyu/analysis`)
|
|
2
|
+
//
|
|
3
|
+
// **Analysis makes the material for a judgement; it never holds the authority to judge.**
|
|
4
|
+
// An artifact carries measurements, evidence you can walk back to the model, the identity of
|
|
5
|
+
// the profile and inputs it came from, and whatever input was missing. It carries no `pass`,
|
|
6
|
+
// no `fail`, no level and no verdict — drawing the line is what `@kensnzk/koyu/validate` does.
|
|
7
|
+
//
|
|
8
|
+
// Every run names its context and its versioned profile explicitly. There is no implicit
|
|
9
|
+
// jurisdiction, no process-wide default profile, and no overload that lets a required input
|
|
10
|
+
// be omitted. Two runs that differ do so because the arguments differed, and the difference
|
|
11
|
+
// is visible in the result's provenance rather than hidden in process state.
|
|
12
|
+
export { COMPONENT_ID_PATTERN, isComponentIdentity, sameIdentity, ANALYSIS_FORMAT, } from "./contracts.js";
|
|
13
|
+
export { assertJsonValue, canonicalJsonValue, codePointCompare, isJsonValue, JsonBoundaryError, } from "./json.js";
|
|
14
|
+
// Running one analysis, without running any rule. The registry and profile are the caller's
|
|
15
|
+
// values; see `@kensnzk/koyu/validate` for how they are built.
|
|
16
|
+
export { runAnalysis } from "../validate/assessment.js";
|
|
17
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,0FAA0F;AAC1F,6FAA6F;AAC7F,6FAA6F;AAC7F,+FAA+F;AAC/F,EAAE;AACF,yFAAyF;AACzF,4FAA4F;AAC5F,4FAA4F;AAC5F,6EAA6E;AAE7E,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,eAAe,GA4BhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,GAIlB,MAAM,WAAW,CAAC;AAEnB,4FAA4F;AAC5F,+DAA+D;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export type JsonPrimitive = string | number | boolean | null;
|
|
2
|
+
export type JsonValue = JsonPrimitive | readonly JsonValue[] | {
|
|
3
|
+
readonly [key: string]: JsonValue;
|
|
4
|
+
};
|
|
5
|
+
export type JsonObject = {
|
|
6
|
+
readonly [key: string]: JsonValue;
|
|
7
|
+
};
|
|
8
|
+
export declare class JsonBoundaryError extends TypeError {
|
|
9
|
+
readonly path: string;
|
|
10
|
+
constructor(path: string, message: string);
|
|
11
|
+
}
|
|
12
|
+
/** True only for finite JSON primitives, arrays, and plain string-keyed objects without cycles. */
|
|
13
|
+
export declare function isJsonValue(value: unknown): value is JsonValue;
|
|
14
|
+
export declare function assertJsonValue(value: unknown, path?: string, ancestors?: Set<object>): asserts value is JsonValue;
|
|
15
|
+
/**
|
|
16
|
+
* Clones a JSON boundary value deterministically. Non-index keys use Unicode code-point order;
|
|
17
|
+
* ECMAScript integer-index keys retain the language's mandatory numeric enumeration order.
|
|
18
|
+
*/
|
|
19
|
+
export declare function canonicalJsonValue(value: unknown): JsonValue;
|
|
20
|
+
export declare function codePointCompare(a: string, b: string): number;
|
|
21
|
+
//# sourceMappingURL=json.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/analysis/json.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,SAAS,SAAS,EAAE,GACpB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE/D,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAO9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,SAAM,EAAE,SAAS,cAAoB,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CA8CrH;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAG5D;AAqBD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW7D"}
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
export class JsonBoundaryError extends TypeError {
|
|
2
|
+
path;
|
|
3
|
+
constructor(path, message) {
|
|
4
|
+
super(`${path}: ${message}`);
|
|
5
|
+
this.name = "JsonBoundaryError";
|
|
6
|
+
this.path = path;
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
/** True only for finite JSON primitives, arrays, and plain string-keyed objects without cycles. */
|
|
10
|
+
export function isJsonValue(value) {
|
|
11
|
+
try {
|
|
12
|
+
assertJsonValue(value);
|
|
13
|
+
return true;
|
|
14
|
+
}
|
|
15
|
+
catch {
|
|
16
|
+
return false;
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
export function assertJsonValue(value, path = "$", ancestors = new Set()) {
|
|
20
|
+
if (value === null || typeof value === "string" || typeof value === "boolean")
|
|
21
|
+
return;
|
|
22
|
+
if (typeof value === "number") {
|
|
23
|
+
if (!Number.isFinite(value))
|
|
24
|
+
throw new JsonBoundaryError(path, "number must be finite");
|
|
25
|
+
return;
|
|
26
|
+
}
|
|
27
|
+
if (typeof value !== "object") {
|
|
28
|
+
throw new JsonBoundaryError(path, `${typeof value} is not a JSON value`);
|
|
29
|
+
}
|
|
30
|
+
if (ancestors.has(value))
|
|
31
|
+
throw new JsonBoundaryError(path, "cyclic value is not JSON");
|
|
32
|
+
const prototype = Object.getPrototypeOf(value);
|
|
33
|
+
if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
|
|
34
|
+
throw new JsonBoundaryError(path, "object must have Object.prototype or a null prototype");
|
|
35
|
+
}
|
|
36
|
+
ancestors.add(value);
|
|
37
|
+
try {
|
|
38
|
+
if (Array.isArray(value)) {
|
|
39
|
+
for (const key of Reflect.ownKeys(value)) {
|
|
40
|
+
if (key === "length")
|
|
41
|
+
continue;
|
|
42
|
+
if (typeof key !== "string" || !/^(0|[1-9]\d*)$/.test(key) || Number(key) >= value.length) {
|
|
43
|
+
throw new JsonBoundaryError(path, "array has a non-index own property");
|
|
44
|
+
}
|
|
45
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
46
|
+
if (!("value" in descriptor) || !descriptor.enumerable) {
|
|
47
|
+
throw new JsonBoundaryError(`${path}[${key}]`, "array entries must be enumerable data properties");
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
for (let index = 0; index < value.length; index++) {
|
|
51
|
+
if (!Object.hasOwn(value, index))
|
|
52
|
+
throw new JsonBoundaryError(`${path}[${index}]`, "sparse arrays are not JSON values");
|
|
53
|
+
assertJsonValue(value[index], `${path}[${index}]`, ancestors);
|
|
54
|
+
}
|
|
55
|
+
return;
|
|
56
|
+
}
|
|
57
|
+
for (const key of Reflect.ownKeys(value)) {
|
|
58
|
+
if (typeof key !== "string")
|
|
59
|
+
throw new JsonBoundaryError(path, "symbol keys are not JSON object keys");
|
|
60
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
61
|
+
if (!("value" in descriptor) || !descriptor.enumerable) {
|
|
62
|
+
throw new JsonBoundaryError(`${path}.${key}`, "object members must be enumerable data properties");
|
|
63
|
+
}
|
|
64
|
+
assertJsonValue(descriptor.value, `${path}.${key}`, ancestors);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
finally {
|
|
68
|
+
ancestors.delete(value);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Clones a JSON boundary value deterministically. Non-index keys use Unicode code-point order;
|
|
73
|
+
* ECMAScript integer-index keys retain the language's mandatory numeric enumeration order.
|
|
74
|
+
*/
|
|
75
|
+
export function canonicalJsonValue(value) {
|
|
76
|
+
assertJsonValue(value);
|
|
77
|
+
return canonical(value);
|
|
78
|
+
}
|
|
79
|
+
function canonical(value) {
|
|
80
|
+
if (value === null || typeof value !== "object") {
|
|
81
|
+
return typeof value === "number" && Object.is(value, -0) ? 0 : value;
|
|
82
|
+
}
|
|
83
|
+
if (Array.isArray(value))
|
|
84
|
+
return value.map(canonical);
|
|
85
|
+
const record = value;
|
|
86
|
+
const out = {};
|
|
87
|
+
for (const key of Object.keys(record).sort(codePointCompare)) {
|
|
88
|
+
Object.defineProperty(out, key, {
|
|
89
|
+
value: canonical(record[key]),
|
|
90
|
+
enumerable: true,
|
|
91
|
+
configurable: true,
|
|
92
|
+
writable: true,
|
|
93
|
+
});
|
|
94
|
+
}
|
|
95
|
+
return out;
|
|
96
|
+
}
|
|
97
|
+
export function codePointCompare(a, b) {
|
|
98
|
+
const left = a[Symbol.iterator]();
|
|
99
|
+
const right = b[Symbol.iterator]();
|
|
100
|
+
while (true) {
|
|
101
|
+
const x = left.next();
|
|
102
|
+
const y = right.next();
|
|
103
|
+
if (x.done || y.done)
|
|
104
|
+
return x.done === y.done ? 0 : x.done ? -1 : 1;
|
|
105
|
+
const xPoint = x.value.codePointAt(0);
|
|
106
|
+
const yPoint = y.value.codePointAt(0);
|
|
107
|
+
if (xPoint !== yPoint)
|
|
108
|
+
return xPoint < yPoint ? -1 : 1;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
//# sourceMappingURL=json.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/analysis/json.ts"],"names":[],"mappings":"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"}
|