@elie-laloum/outpost 9.0.5 → 9.0.8

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 9.0.8
+
+- Redesign the bilingual documentation home with a full-viewport hero, a four-step journey and a nine-capability grid linking to the Guide. Show a medium-sized CSV-export workflow with parallel tests and review, bounded correction rounds and human approval.
+- Add a site favicon, localized social previews, homepage search metadata and structured data, and a robots endpoint.
+- Replace direct console output in Guide, homepage and README snippets with reporters and sample-output comments. Typecheck the shared reporter and execute the offline examples in both languages.
+- Hide code-tab and snippet scrollbars while preserving horizontal scrolling, mouse dragging and keyboard navigation.
+- Include the shared reporter when executing real container documentation examples in both languages.
+
+Public library contracts and runtime behavior are unchanged.
+
+## 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.

package/README.md

@@ -34,34 +34,27 @@ 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 {
   createAgent,
   createCodexHarness,
+  createReporter,
   dispatch,
 } from "@elie-laloum/outpost";
 import { createDockerSandboxProvider } from "@elie-laloum/outpost/providers/docker";
@@ -72,15 +65,17 @@ const result = await dispatch({
     harness: createCodexHarness({ authentication: "account" }),
   }),
   sandboxProvider: createDockerSandboxProvider({ image: "outpost:dev" }),
+  observe: createReporter(),
   branch: { mode: "named", name: "outpost/fix-tests" },
   brief: {
     text: "Fix the failing tests, run them to verify and commit the change.",
   },
 });
 
-console.log(result.text);
-console.log(result.branch, result.commits);
-console.log(result.usage);
+// Example output:
+// [outpost · pass 1] running · codex
+// Fixed the failing tests and committed the change.
+// [outpost · pass 1] finished · 12.00s · status 0 · input 1200 · cache read 0 · cache write 0 · output 320
 ```
 
 `dispatch()` closes the sandbox it allocates; the named branch remains for review. Use a fresh branch name for each independent task. The agent’s answer is not an enforced test result: add explicit verification when checks must gate integration.
@@ -108,7 +103,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.5",
+  "version": "9.0.8",
   "description": "Programmable sandboxes, coding agents and typed workflows.",
   "type": "module",
   "license": "MIT",