From a16cbe4e1eca9aeecb1b4182ab21b946c8124c8d Mon Sep 17 00:00:00 2001 From: ignatdubovskiy Date: Sun, 10 May 2026 12:00:50 +0300 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=D0=B5=D0=B4=D0=B8=D0=BD=D1=8B?= =?UTF-8?q?=D0=B9=20pitch=20What=20is=20Fold=20(=D0=B8=D1=81=D1=82=D0=BE?= =?UTF-8?q?=D1=87=D0=BD=D0=B8=D0=BA=20=D0=B8=D1=81=D1=82=D0=B8=D0=BD=D1=8B?= =?UTF-8?q?=20=D0=B4=D0=BB=D1=8F=20landing=20=D0=B8=20quickstart)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/what-is-fold.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 docs/what-is-fold.md diff --git a/docs/what-is-fold.md b/docs/what-is-fold.md new file mode 100644 index 0000000..d30ea47 --- /dev/null +++ b/docs/what-is-fold.md @@ -0,0 +1,30 @@ +# What is Fold? + +**Fold** — agent governance runtime. Коробочный slot-in между LLM-агентом и реальным backend'ом. + +## Решает 4 задокументированные боли AI-агентов + +1. **Destructive actions без permission scope** (PocketOS, Replit incidents) → `role.base` + `role.scope` filtering +2. **Generic 500 без machine-readable reason** (90.8% retry waste) → structured rejections с invariant-violation reasons +3. **Over-broad capability tokens** (Supabase service_role, GitHub MCP PAT leaks) → preapproval guards + maxAmount/csvInclude/dailySum predicates +4. **Нет point of no return** (Railway blog) → `__irr.point` irreversibility primitive с escape-proof доказательством + +## Что входит в Fold + +| Часть | Репо | npm | +|---|---|---| +| MCP server | `idf-mcp/` | `@intent-driven/mcp-server` | +| Standalone runtime | `idf-sdk/packages/runtime-local/` | `@intent-driven/runtime-local` | +| CLI (`idf serve`, `idf approvals`, `idf approve`) | `idf-sdk/packages/cli/` | `@intent-driven/cli` | +| Docker quickstart | `fold-runtime-quickstart/` | — | +| Landing | `fold-landing/` | fold.intent-design.tech | + +## Что не Fold + +- **Не Studio** — Fold не делает UI, не имеет multi-tenant control plane. Studio — отдельный продукт (см. `~/WebstormProjects/idf/docs/products.md`). +- **Не сам формат IDF** — Fold потребляет IDF-онтологию, но спецификация формата живёт в `idf-spec/`. +- **Не middleware** — Fold sibling к backend'у через MCP, не proxy перед API. + +## Time to first `approve_pending` + +Цель: ≤ 15 минут от `npm install` на NestJS+TypeORM+PG проекте. Quickstart-доc — `~/WebstormProjects/fold-runtime-quickstart/README.md`. From 431c70a1d39db53e0d3824e6ce7b52b981a7ef11 Mon Sep 17 00:00:00 2001 From: ignatdubovskiy Date: Sun, 10 May 2026 12:05:39 +0300 Subject: [PATCH 2/2] =?UTF-8?q?docs(what-is-fold):=20fix=20code=20review?= =?UTF-8?q?=20(path-=D1=81=D1=82=D0=B0=D0=B1=D0=B8=D0=BB=D1=8C=D0=BD=D0=BE?= =?UTF-8?q?=D1=81=D1=82=D1=8C,=20=D1=83=D0=BF=D1=80=D0=BE=D1=89=D0=B5?= =?UTF-8?q?=D0=BD=D0=B8=D0=B5=20jargon,=20=D1=82=D0=BE=D1=87=D0=BD=D0=BE?= =?UTF-8?q?=D0=B5=20slot-in=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8?= =?UTF-8?q?=D0=B5,=20TTFA=20=D1=83=D1=82=D0=BE=D1=87=D0=BD=D0=B5=D0=BD?= =?UTF-8?q?=D0=B8=D0=B5)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/what-is-fold.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/what-is-fold.md b/docs/what-is-fold.md index d30ea47..7c0e514 100644 --- a/docs/what-is-fold.md +++ b/docs/what-is-fold.md @@ -1,13 +1,13 @@ # What is Fold? -**Fold** — agent governance runtime. Коробочный slot-in между LLM-агентом и реальным backend'ом. +**Fold** — agent governance runtime. MCP-сервер (stdio adapter, slot-in для Claude Desktop / Cursor / Zed) перед runtime-сервисом, который sibling к реальному backend'у — не middleware и не proxy. ## Решает 4 задокументированные боли AI-агентов 1. **Destructive actions без permission scope** (PocketOS, Replit incidents) → `role.base` + `role.scope` filtering 2. **Generic 500 без machine-readable reason** (90.8% retry waste) → structured rejections с invariant-violation reasons -3. **Over-broad capability tokens** (Supabase service_role, GitHub MCP PAT leaks) → preapproval guards + maxAmount/csvInclude/dailySum predicates -4. **Нет point of no return** (Railway blog) → `__irr.point` irreversibility primitive с escape-proof доказательством +3. **Over-broad capability tokens** (Supabase service_role, GitHub MCP over-broad PAT scope) → preapproval guards с предикатами вроде `maxAmount` (cap на сумму), `dailySum` (rate-limit) или `csvInclude` (whitelist по списку) +4. **Нет point of no return** (Railway blog) → `__irr.point` irreversibility primitive: past confirmed effect с `point: high` блокирует `α:remove` на той же сущности; forward-correction через `α:replace` остаётся возможной ## Что входит в Fold @@ -21,10 +21,10 @@ ## Что не Fold -- **Не Studio** — Fold не делает UI, не имеет multi-tenant control plane. Studio — отдельный продукт (см. `~/WebstormProjects/idf/docs/products.md`). +- **Не Studio** — Fold не делает UI, не имеет multi-tenant control plane. Studio — отдельный продукт (см. host-репо `idf/`, файл `docs/products.md` после Phase 0 merge). - **Не сам формат IDF** — Fold потребляет IDF-онтологию, но спецификация формата живёт в `idf-spec/`. - **Не middleware** — Fold sibling к backend'у через MCP, не proxy перед API. ## Time to first `approve_pending` -Цель: ≤ 15 минут от `npm install` на NestJS+TypeORM+PG проекте. Quickstart-доc — `~/WebstormProjects/fold-runtime-quickstart/README.md`. +Цель: ≤ 15 минут от `npm install` до первого `approve_pending` в Claude Desktop на NestJS+TypeORM+PG проекте. Quickstart-доc — `~/WebstormProjects/fold-runtime-quickstart/README.md`.