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
17 changes: 9 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ npx @forgeplan/web init -y --image nightly # pre-release track
```

Every release ships two named **images** of the scaffold. The bytes are
the same self-contained ~1.8 MB single-file bundle (no `node_modules/`,
the same self-contained ~1.4 MB single-file bundle (no `node_modules/`,
no `npm install` at user side); the difference is the feature-flag set
each image carries. v1 ships both images with **zero** flags — the
framework is in place for opt-in features without users-of-stable
Expand Down Expand Up @@ -158,7 +158,7 @@ appear in seconds (after `forgeplan reindex`).

| | |
| :-------------------------- | :-------------------------------------------------------------------------------------------------------------------- |
| **📦 Zero install at user** | The package ships one self-contained ~1.8 MB single-file bundle per declared image (`dist/` for `stable`, `dist-nightly/` for `nightly`). `init` is a `cp -r` — no `npm install` runs at user side. |
| **📦 Zero install at user** | The package ships one self-contained ~1.4 MB single-file bundle per declared image (`dist/` for `stable`, `dist-nightly/` for `nightly`). `init` is a `cp -r` — no `npm install` runs at user side. |
| **🪟 Truly cross-platform** | Smoke matrix on `ubuntu-latest` / `macos-latest` / `windows-latest` × Node 22, green on every push since v0.1.3. |
| **🔒 Read-only by design** | `/api/*` proxy invokes only read-only `forgeplan` subcommands (rule 22). The viewer **cannot mutate** your workspace. |
| **🌐 Five graph views** | Force, Lanes, Matrix, Radial, Tree. Each picks a different question — flow, adjacency, hierarchy, parent/child. |
Expand Down Expand Up @@ -193,15 +193,16 @@ Three entry points — pick the one that matches what you need now.

<table>
<tr>
<td align="center"><b>~200</b><br>LOC in the bin script</td>
<td align="center"><b>3</b><br>OS verified in CI</td>
<td align="center"><b>0</b><br>runtime deps in <code>bin/</code></td>
<td align="center"><b>~6 MB</b><br>tarball with bundled <code>node_modules</code></td>
<td align="center"><b>~1.4 MB</b><br>per image (esbuild bundle)</td>
<td align="center"><b>~870 kB</b><br>packed tarball (~3 MB unpacked)</td>
<td align="center"><b>3 OS × Node 22</b><br>green smoke matrix</td>
<td align="center"><b>1 dep</b><br>in <code>bin/</code> (<code>citty</code>, 0 transitive)</td>
</tr>
</table>

This repository follows its own methodology — every PRD, RFC, ADR and
EvidencePack lives in [`.forgeplan/`](./.forgeplan/), validated and scored
EvidencePack lives in [`.forgeplan/`](./.forgeplan/) (100+ artifacts at
HEAD, browsable in the same UI this package ships). Validated and scored
locally; nothing ships to `main` without `R_eff > 0`, an active artifact,
and a green smoke matrix.

Expand All @@ -224,7 +225,7 @@ rejected with `GH006` / `GH013`. Full guide — [`CLAUDE.md`](CLAUDE.md).
### Local dev modes

```bash
npm run dev # HMR against this repo's own .forgeplan/ (~11 artifacts)
npm run dev # HMR against this repo's own .forgeplan/ (100+ artifacts)
npm run dev:playground # HMR against playground/.forgeplan/ (~123 seeded Helios artifacts)
```

Expand Down
21 changes: 11 additions & 10 deletions README.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ npx @forgeplan/web init -y --image nightly # pre-release ветка
```

Каждый релиз шипит два именованных **образа** (image) скаффолда. Байты
у обоих одинаковые — self-contained ~1.8 MB single-file bundle (без
у обоих одинаковые — self-contained ~1.4 MB single-file bundle (без
`node_modules/`, никакого `npm install` на стороне пользователя);
разница в наборе фичефлагов, которые несёт каждый образ. v1 шипит оба
образа с **нулём** флагов — фреймворк готов к опт-ин фичам без того
Expand Down Expand Up @@ -158,7 +158,7 @@ kind, status, диапазону `R_eff`; кликни узел — увидиш

| | |
| :---------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
| **📦 Без установок у пользователя** | Пакет содержит один self-contained ~1.8 MB single-file bundle на каждый объявленный образ (`dist/` для `stable`, `dist-nightly/` для `nightly`). `init` — это `cp -r`. У пользователя ничего не ставится. |
| **📦 Без установок у пользователя** | Пакет содержит один self-contained ~1.4 MB single-file bundle на каждый объявленный образ (`dist/` для `stable`, `dist-nightly/` для `nightly`). `init` — это `cp -r`. У пользователя ничего не ставится. |
| **🪟 По-настоящему cross-platform** | Smoke-матрица `ubuntu-latest` / `macos-latest` / `windows-latest` × Node 22, зелёная на каждом push с v0.1.3. |
| **🔒 Read-only by design** | `/api/*` дёргает только read-only подкоманды `forgeplan` (правило 22). Вьювер **не может** изменить воркспейс. |
| **🌐 Пять видов графа** | Force, Lanes, Matrix, Radial, Tree. Каждый отвечает на свой вопрос — поток, смежность, иерархия, parent/child. |
Expand Down Expand Up @@ -193,17 +193,18 @@ kind, status, диапазону `R_eff`; кликни узел — увидиш

<table>
<tr>
<td align="center"><b>~200</b><br>строк в bin-скрипте</td>
<td align="center"><b>3</b><br>OS в CI</td>
<td align="center"><b>0</b><br>runtime-зависимостей в <code>bin/</code></td>
<td align="center"><b>~6 МБ</b><br>tarball вместе с <code>node_modules</code></td>
<td align="center"><b>~1.4 МБ</b><br>на образ (esbuild-бандл)</td>
<td align="center"><b>~870 КБ</b><br>tarball (~3 МБ распакованный)</td>
<td align="center"><b>3 OS × Node 22</b><br>зелёная smoke-матрица</td>
<td align="center"><b>1 dep</b><br>в <code>bin/</code> (<code>citty</code>, 0 транзитивных)</td>
</tr>
</table>

Этот репозиторий использует свою же методологию — каждый PRD, RFC, ADR и
EvidencePack лежит в [`.forgeplan/`](./.forgeplan/), локально валидируется
и скорится; ничего не уходит в `main` без `R_eff > 0`, активного артефакта
и зелёной smoke-матрицы.
EvidencePack лежит в [`.forgeplan/`](./.forgeplan/) (на HEAD — 100+
артефактов, листать можно в этом же UI, который пакет шипит). Локально
валидируется и скорится; ничего не уходит в `main` без `R_eff > 0`,
активного артефакта и зелёной smoke-матрицы.

## Contributing

Expand All @@ -224,7 +225,7 @@ Branch protection защищает правила на сервере — пря
### Локальные dev-режимы

```bash
npm run dev # HMR против собственного .forgeplan/ репо (~11 артефактов)
npm run dev # HMR против собственного .forgeplan/ репо (100+ артефактов)
npm run dev:playground # HMR против playground/.forgeplan/ (~123 засеянных Helios-артефакта)
```

Expand Down
Loading