Skip to content

Releases: intent-driven-software/fold-runtime-quickstart

v1.1.0 — Docker-based 2-command quickstart

04 May 07:20
cf8ed55

Choose a tag to compare

The quickstart UX is now two commands, no two-repo dance, no absolute paths.

What changed since v1.0.0

  • Dockerfile + docker-compose + entrypoint — single image clones IDF host on build, runs it on `docker compose up`, bootstraps the `invest` demo domain automatically once the host is healthy. No `IDF_REPO` env var. No second `npm run server` terminal.
  • README rewritten — honest "2 commands" headline, troubleshooting (port 3001 / build slow / ECONNREFUSED / Claude Desktop), explicit "Author your own domain" path that points to `@intent-driven/cli`.
  • `claude_desktop_config.example.json` — uses `IDF_BOOTSTRAP=0` (container already did it), drops the `IDF_ONTOLOGY_PATH` requirement.
  • `legacy/no-docker.md` — old multi-step flow preserved for advanced users authoring their own ontologies.

End-to-end verified

```bash
$ git clone https://github.com/DubovskiyIM/fold-runtime-quickstart && cd $_
$ docker compose up

... ~3 min build first time, then:

fold-host | [fold-quickstart] ✓ domain='invest' bootstrapped
fold-host | [fold-quickstart] entities: 14 · intents: 61 · invariants: 5

$ npm install
$ npm run demo:rogue # → HTTP 403 preapproval_denied (structured)
$ npm run demo:grant # → HTTP 201 effect ingested
$ npm run demo:smart # → HTTP 200 confirmed (scaled $50K → $950)
```

Companion releases

Migrating from v1.0.0

```bash
git pull
docker compose up # replaces `cd ../idf && npm run server`

IDF_REPO=... npm run bootstrap is gone — bootstrap is automatic

```

License: MIT

v1.0.0 — initial public release

04 May 05:21
2bccf80

Choose a tag to compare

First public release of the Fold quickstart. Three-act demo on the real `invest` domain (14 entities, 61 intents, 7-check preapproval guard).

What you get

```bash
git clone https://github.com/DubovskiyIM/idf
cd idf && npm install && npm run server # → :3001

git clone https://github.com/DubovskiyIM/fold-runtime-quickstart
cd fold-runtime-quickstart && npm install
IDF_REPO=$HOME/WebstormProjects/idf npm run bootstrap

npm run demo:rogue # $50K trade → HTTP 403 preapproval_denied (structured)
npm run demo:grant # investor issues $1,000-cap delegate_to_agent
npm run demo:smart # agent reads cap → scales to $950 → 200 OK
```

Real HTTP, no mocks. The agent doesn't bump into a wall — it reads the wall and walks around it.

Companion releases

License: MIT