@elie-laloum/outpost 9.0.4 → 9.0.6

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 9.0.6
+
+- Rewrite the English and French Guide with clearer titles and explanations. The recommended setup builds an agent image, then imports Outpost in user-written TypeScript files; generated `init` workflow projects remain optional. Link option and property definitions to their API contracts instead of repeating them in the Guide.
+- Limit Guide code blocks to 20 lines, split longer examples into named `.ts` files in tabs and place their explanations beside them. Code tabs support horizontal scrolling and mouse dragging so every file stays reachable.
+- Replace Guide flows with pannable, zoomable canvases, illustrate cards with icons, extend notices across the content section and give page navigation actions equal widths. Reduce spacing in the sidebar.
+- Rebuild the bilingual home around what developers can accomplish with Outpost, with a direct starting point, short working examples, illustrated use cases and a canvas. Reuse the Guide's layout and components, and regenerate content when starting or building the site so development and production render the same page.
+- Keep only Guide and API in the header. Open the changelog exclusively from the version button, including on mobile, and keep the roadmap in the repository's `roadmap.md`. The version button's hover fills its whole cell, and Guide/API buttons keep their size while fonts load and the active page changes.
+
+Public library contracts and runtime behavior are unchanged.
+
+## 9.0.5
+
+- Add a development-workflow use case that takes a ticket to a reviewed branch: an agent questions the owner and plans, the owner approves the plan, then agents write failing tests and the code that makes them pass under a reviewer agent, while the workflow checks every step and makes every commit. It replaces the “Write a specification with a human” recipe, whose URL redirects to it.
+- Open four Guide chapters with an overview page — isolation, typed workflows, unattended runs, and observe and recover — that maps the chapter's choices before its detailed pages. Flows drawn in Guide pages can now be panned and zoomed.
+- Label the Reference space “API” in the header, sidebar and breadcrumbs in both languages; its URLs stay under `/reference/`. The sidebar lists every public symbol alphabetically with its kind icon, and the family map with each overview moves to the reference home.
+- Show the landing page's install command for each package manager in tabs. Public library contracts are unchanged.
+
 ## 9.0.4
 
 - Make the landing page's typed-response brief ask for the shape it expects. The brief now carries `<verdict>{"approved": true, "reasons": []}</verdict>`, so the schema, the request and the agent's tagged reply agree: Outpost sends a brief unchanged and adds no format instructions, so a brief that does not show the shape is one the agent cannot satisfy. A comment beside `repairs` says what the option buys — two more turns to fix an answer the schema rejects, on the same conversation.

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://elie-laloum.github.io/outpost/">
-    <img src="docs/src/assets/outpost-logo.png" alt="Outpost" width="180">
+    <img src="outpost-banner.png" alt="Outpost — Coding agents. Workflows in TypeScript." width="100%">
   </a>
 </p>
 
@@ -34,29 +34,21 @@ Outpost is a TypeScript library and CLI for running coding agents in sandboxes a
 
 ## Quickstart
 
-You need **Node.js 24+**, **Git**, a repository with at least one commit, and **Docker** running. This example uses Codex with account authentication: prepare its host login using the [setup guide](https://elie-laloum.github.io/outpost/guide/setup/) before running a task. [Authentication](https://elie-laloum.github.io/outpost/guide/authentication/) covers other agents and API-key billing.
+You need **Node.js 24+**, **Git**, a repository with at least one commit, and **Docker** running. This example uses Codex with account authentication: prepare its host login using the [Codex guide](https://elie-laloum.github.io/outpost/guide/codex/) before running a task. [Authentication](https://elie-laloum.github.io/outpost/guide/authentication/) covers other agents and API-key billing.
 
-Create a workflow directory and point it at your checkout:
+Install the package, then build the agent image in a dedicated directory:
 
 ```sh
-mkdir my-workflow
-cd my-workflow
-npx @elie-laloum/outpost init --yes --repository /absolute/path/to/repository --image outpost:dev --install
+npm install @elie-laloum/outpost
+npm pkg set type=module
+npx outpost init --yes --directory .outpost-image --image outpost:dev
 ```
 
-This installs the workflow dependencies, generates `run.ts`, `brief.md` and configuration files, and builds the Docker image. The first build downloads the agent CLIs. Use `--no-build` if the image already exists. Existing package manifests are preserved; explicit CommonJS projects get `run.mts`.
+The first build downloads the agent CLIs. The image directory also receives example workflow files; write your own script as shown below. See [agent images](https://elie-laloum.github.io/outpost/guide/agent-images/) to add project tools or use Podman.
 
-Run your first task:
+## Write a TypeScript script
 
-```sh
-node run.ts "Describe this repository and suggest one small improvement. Do not edit files."
-```
-
-The generated script prints the branch, collected commits and conversation reference. It uses **local branch integration**: when you later ask the agent to change and commit code, those commits are integrated into the target checkout. Use a named branch, as below, to keep changes separate for review. See [branch strategies](https://elie-laloum.github.io/outpost/guide/repository-and-branch/).
-
-## Use the library
-
-The workflow is ordinary TypeScript. After the setup above, save this as `task.mts` next to the generated script, replace the repository path, and run `node task.mts`:
+Use an ESM directory (`"type": "module"` in `package.json`); a CommonJS repository can keep the scripts in a separate directory with its own manifest. Save this as `task.ts`, replace the repository path, and run it with `node task.ts`. It keeps the agent’s changes on a named branch for review:
 
 ```ts
 import {
@@ -108,7 +100,7 @@ Conversation support varies: Claude Code, Codex and Kimi support capture, resume
 
 Docker and Podman mount the selected workspace and Git metadata by default. These mounts are not an adversarial security boundary. Cloud providers receive repository data and declared credentials; explicit local execution runs on the host without isolation. Read [SECURITY.md](SECURITY.md) before choosing an environment for untrusted code.
 
-Speculation remains experimental. See the [roadmap](https://elie-laloum.github.io/outpost/project/roadmap/) for validation limits and planned work, and the [changelog](CHANGELOG.md) for version history and migration notes.
+Speculation remains experimental. See the [roadmap](roadmap.md) for validation limits and planned work, and the [changelog](CHANGELOG.md) for version history and migration notes.
 
 ## Development and contributions
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elie-laloum/outpost",
-  "version": "9.0.4",
+  "version": "9.0.6",
   "description": "Programmable sandboxes, coding agents and typed workflows.",
   "type": "module",
   "license": "MIT",