@moretea-labs/forge 1.8.0 → 1.8.2

package/docs/wiki/Quick-Start.md

@@ -1,27 +1,29 @@
-# Quick Start
+# Quick Start — use ChatGPT to work with your computer via Forge MCP
 
-## 1. Install from source
+Forge gives an external controller (ChatGPT recommended) a local-first, permission-scoped execution runtime for files, Git repositories, browser/desktop actions, and connected services. Forge itself is **not** a second AI agent and does not require a separate OpenAI API key when your controller is ChatGPT.
 
-Until the npm RC is publicly available, use the verified source path:
+## 1. Install the current stable CLI
+
+Requires Node.js 20.10+, npm, and a writable home directory.
 
 ```bash
-git clone https://github.com/moretea-labs/forge.git
-cd forge
-bun install --frozen-lockfile
-npm install -g . --omit=optional --no-audit --no-fund
+npm install -g @moretea-labs/forge@latest
+forge --version
 ```
 
-Requirements: Git, Node.js 20.10+, npm, and a writable user directory. Bun is recommended for development and the complete test suite.
+Bun alternative: `bun add -g @moretea-labs/forge`. Source compilation is **not** necessary for a normal install; see [Installation](Installation).
 
-## 2. Initialize and diagnose
+## 2. Configure ChatGPT as the external controller
 
 ```bash
-forge --version
-forge install --target both
-forge doctor
+forge setup
+forge setup configure --controller chatgpt --tunnel auto
+forge setup next
 ```
 
-## 3. Register a repository
+Follow each reported next step to configure the Package Runtime and authenticated connector. OpenAI Secure MCP Tunnel is preferred when available; it is a transport, not another Forge controller. Read the [ChatGPT MCP setup tutorial](https://github.com/moretea-labs/forge/blob/main/docs/tutorials/02-connect-chatgpt.md).
+
+## 3. Adopt a code repository only when needed
 
 ```bash
 forge adopt --repo /path/to/project --dry-run
@@ -29,18 +31,29 @@ forge adopt --repo /path/to/project
 forge repo list --json
 ```
 
-Use dry-run first when adopting an existing project. Review the proposed files and runtime configuration before applying.
+You can use authorized file, browser or service capabilities without first adopting a Git repository.
+
+## 4. Complete a small task and check the result
 
-## 4. Connect ChatGPT
+Ask ChatGPT to inspect a repository, make a scoped change, run the focused check, review the diff, and commit if verified. The [first repository task](https://github.com/moretea-labs/forge/blob/main/docs/tutorials/03-first-repository-task.md) walks through the process. Destructive, secret-bearing and external effects have separate authorization requirements.
 
-Follow the maintained [connector tutorial](https://github.com/moretea-labs/forge/blob/main/docs/tutorials/02-connect-chatgpt.md). After connection, verify status and repository context before starting write work.
+## Source checkout for contributors
 
-## 5. Complete one bounded task
+A normal package install does not require source, Git, or Bun. If you are modifying Forge itself, use the same frozen Bun dependency lock as CI:
 
-Start with a small change, inspect the diff, run the focused check, commit, and clean the branch or worktree. The full walkthrough is in [First Repository Task](https://github.com/moretea-labs/forge/blob/main/docs/tutorials/03-first-repository-task.md).
+```bash
+git clone https://github.com/moretea-labs/forge.git
+cd forge
+bun install --frozen-lockfile
+npm install -g . --omit=optional --no-audit --no-fund
+```
+
+## Upgrade and help
 
-## Next
+```bash
+npm install -g @moretea-labs/forge@latest
+forge setup next
+forge doctor
+```
 
-- [Core Concepts](Core-Concepts)
-- [Work Lifecycle](Work-Lifecycle)
-- [Troubleshooting](Troubleshooting)
+Read [Releases and Upgrades](Releases-and-Upgrades), [Troubleshooting](Troubleshooting), and the [full documentation](https://github.com/moretea-labs/forge/tree/main/docs). Current stable: [v1.8.1](https://github.com/moretea-labs/forge/releases/tag/v1.8.1).

package/docs/wiki/Releases-and-Upgrades.md

@@ -1,34 +1,24 @@
-# Releases and Upgrades
+# Forge Releases and Upgrades
 
-## Release channels
+## Published stable release
 
-- `next`: release candidates
-- `latest`: stable releases only
+**Forge v1.8.2** was released on October 19, 2026. The canonical package is [`@moretea-labs/forge` on npm](https://www.npmjs.com/package/@moretea-labs/forge), and the matching [GitHub Release](https://github.com/moretea-labs/forge/releases/tag/v1.8.2) provides an immutable `v1.8.1` tag. npm `latest` is the stable channel; `next` is reserved for release candidates.
 
-The package version, Git tag, npm channel, GitHub prerelease state, and release notes must agree. GitHub Releases and npm publication are separate facts.
+## Install or upgrade to the latest stable
 
-## Release gate
+```bash
+npm install -g @moretea-labs/forge@latest
+forge --version
+forge setup next
+forge doctor
+```
 
-A release candidate must pass the repository's release-readiness check on the exact revision. The gate covers type checking, package identity, public documentation, platform contracts, MCP compatibility, public export, package creation, and tarball installation.
+When using the packaged persistent service, `forge runtime service install-package` reconciles the installed Package Runtime. Review [Installation](Installation) and [ChatGPT connection](https://github.com/moretea-labs/forge/blob/main/docs/tutorials/02-connect-chatgpt.md) for platform-specific setup. Updates do not remove the requirement to validate the authenticated MCP connector.
 
-## Stable runtime evidence
+## How releases are verified
 
-Before publication, build an immutable whole-Runtime release from a clean canonical source tree, activate it through the single Forge Runtime service, verify the complete authenticated MCP path, cold-restart that service, and confirm the active release authority still equals the intended commit. Record the fully verified release as known-good.
+Source version, package identity, immutable Git tag, npm dist-tag, and GitHub Release must agree. `check:release` checks source gates, packaging, licensing/open-source hygiene, and isolated installation; `check:release-published` checks npm registry metadata and downloaded tarball integrity against the local version and tag. Publication is performed by protected GitHub Actions with npm OIDC Trusted Publishing.
 
-## Upgrade principles
+Release readiness and active whole-Runtime activation are different authorities; do not infer a healthy local service just from successful package publication. Follow the [maintained release process](https://github.com/moretea-labs/forge/blob/main/docs/operations/releasing.md) for contributor instructions.
 
-- Keep the Forge-only command, state, environment, protocol, and release identity consistent across upgrades.
-- Read release notes before changing runtime or connector configuration.
-- Do not overwrite a healthy active release with a stale rollout operation.
-- Keep a verified rollback path before changing production runtime state.
-
-## Publication sequence
-
-1. Merge reviewed code and docs.
-2. Push the exact main revision.
-3. Wait for required CI and Windows checks on that revision.
-4. Synchronize reviewed Wiki source.
-5. Create the exact `v`-prefixed tag and GitHub prerelease.
-6. Verify npm separately; never claim publication without registry evidence.
-
-See the maintained [release process](https://github.com/moretea-labs/forge/blob/main/docs/operations/releasing.md).
+For future releases, derive their version from the then-current `package.json` and update the matching immutable GitHub Release link.

package/docs/wiki/_Sidebar.md

@@ -1,4 +1,4 @@
-**Forge Wiki**
+**Forge · ChatGPT MCP Wiki**
 
 - [Home](Home)
 - [Quick Start](Quick-Start)
@@ -10,6 +10,8 @@
 - [Implementation](Implementation)
 - [Operations](Operations)
 - [Integrations](Integrations)
+- [Computer and Plugins](Computer-and-Plugins)
+- [Computer 中文使用指南](Computer-and-Plugins.zh-CN)
 - [Troubleshooting](Troubleshooting)
 - [Security Model](Security-Model)
 - [Releases and Upgrades](Releases-and-Upgrades)
@@ -18,4 +20,6 @@
 
 - [Repository](https://github.com/moretea-labs/forge)
 - [Versioned Docs](https://github.com/moretea-labs/forge/tree/main/docs)
+- [Latest stable v1.8.1](https://github.com/moretea-labs/forge/releases/tag/v1.8.1)
+- [npm package](https://www.npmjs.com/package/@moretea-labs/forge)
 - [Support](https://github.com/moretea-labs/forge/blob/main/SUPPORT.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moretea-labs/forge",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "Local-first action assistant for software work with resumable execution, bounded tools, and reviewable evidence",
   "license": "MIT",
   "author": "Moretea Labs contributors",
@@ -39,7 +39,6 @@
     "NOTICE",
     "THIRD_PARTY_NOTICES.md",
     "scripts/verify-forge-runtime.sh",
-    "agents/",
     "assets/",
     "docs/README.md",
     "docs/tutorials/",
@@ -62,12 +61,22 @@
     "install.ps1",
     "bin/",
     "scripts/",
+    "!scripts/benchmark-*",
+    "!scripts/route-nl-vs-ts-eval.ts",
+    "!scripts/check-npm-release.sh",
+    "!scripts/check-public-release-surface.sh",
+    "!scripts/check-release-*",
+    "!scripts/check-tarball-install-smoke.sh",
+    "!scripts/public-release*",
+    "!scripts/publish-release-tarball.sh",
+    "!scripts/stage-runtime-release.ts",
+    "!scripts/package-source-archive.sh",
     "adapters/",
     "packages/",
     "src/",
+    "supervisor/",
     "AGENTS.md",
     "CLAUDE.md",
-    "SKILL.md",
     "README.md"
   ],
   "bin": {
@@ -80,20 +89,18 @@
     "bun": ">=1.0.0"
   },
   "scripts": {
-    "build:controller-ui": "bun scripts/build-controller-ui.ts",
-    "check:controller-ui": "bun scripts/build-controller-ui.ts --check",
     "check:design": "npx -y @google/design.md@0.4.0 lint DESIGN.md",
+    "check:desktop-client": "npm --prefix apps/desktop run check",
     "benchmark:controller-hotpath": "bun scripts/benchmark-controller-hotpath.ts",
     "benchmark:computer-hotpath": "bun scripts/benchmark-computer-hotpath.ts",
     "benchmark:thin-harness-mcp-e2e": "bun scripts/benchmark-thin-harness-mcp-e2e.ts --json",
     "benchmark:mcp-transport": "bun scripts/benchmark-mcp-transport.ts",
     "benchmark:mcp-host": "bash scripts/benchmark-mcp-host.sh",
-    "benchmark:work-efficiency": "bun scripts/benchmark-work-efficiency.ts",
     "benchmark:route-session-concurrency": "bun scripts/benchmark-route-session-concurrency.ts",
     "benchmark:quality-harness": "bun scripts/benchmark-quality-harness.ts",
     "benchmark:background-check-overlap": "bun scripts/benchmark-background-check-overlap.ts",
     "check:quality-harness": "bun scripts/benchmark-quality-harness.ts",
-    "check:evaluation-framework": "bun test ./tests/evaluation-framework.test.ts && bun test ./evaluation/protocol.test.ts && bun test ./evaluation/candidate-runner.test.ts && bun test ./evaluation/calibration.test.ts && bun test ./evaluation/certification.test.ts && bun test ./evaluation/public-mcp-runner.test.ts",
+    "check:evaluation-framework": "bun test ./tests/evaluation-framework.test.ts && bun test ./evaluation/protocol.test.ts && bun test ./evaluation/candidate-runner.test.ts && bun test ./evaluation/calibration.test.ts && bun test ./evaluation/certification.test.ts && bun test ./evaluation/public-mcp-runner.test.ts && bun test ./evaluation/cognitive-skill-retirement.test.ts",
     "check:v2-certification": "bun evaluation/check-v2-certification.ts",
     "check:background-check-overlap": "bun scripts/benchmark-background-check-overlap.ts",
     "check:typescript-navigation": "bun scripts/benchmark-typescript-navigation.ts",
@@ -108,7 +115,13 @@
     "test:fault": "bun scripts/test-governance.ts fault",
     "test:full": "bun scripts/test-governance.ts full",
     "test:coverage": "bun test --coverage",
-    "check:type": "bun x tsc --noEmit",
+    "check:type": "bun x tsc --noEmit && bun x tsc -p supervisor/tsconfig.json",
+    "workflow-supervisor": "bun supervisor/entry.ts",
+    "smoke:workflow-supervisor": "bun scripts/smoke-workflow-supervisor.ts",
+    "smoke:workflow-supervisor-process-restart": "bun scripts/smoke-workflow-supervisor-process-restart.ts",
+    "smoke:workflow-supervisor-restart-recovery": "bun scripts/smoke-workflow-supervisor-restart-recovery.ts",
+    "smoke:workflow-supervisor-chrome-adapter": "bun scripts/smoke-workflow-supervisor-chrome-adapter.ts",
+    "smoke:user-request-continuation-restart": "bun scripts/smoke-user-request-continuation-restart.ts",
     "check:runtime-architecture": "node scripts/check-runtime-architecture.mjs",
     "check:repository-hygiene": "node scripts/check-repository-hygiene.mjs",
     "check:generated-authority": "node scripts/sync-generated-authority.mjs --check",
@@ -118,9 +131,11 @@
     "check:test-governance": "bun scripts/test-governance.ts validate",
     "check:mcp-compatibility": "node --loader ./src/runtime/shared/node-ts-loader.mjs scripts/check-mcp-compatibility.ts",
     "smoke:runtime-recovery": "node --loader ./src/runtime/shared/node-ts-loader.mjs scripts/smoke-runtime-recovery.ts",
+    "smoke:unattended-transport-recovery": "node --loader ./src/runtime/shared/node-ts-loader.mjs scripts/smoke-unattended-transport-recovery.ts",
+    "smoke:control-plane-failure-domain": "node --loader ./src/runtime/shared/node-ts-loader.mjs scripts/smoke-control-plane-failure-domain.ts",
     "smoke:mcp-http-runtime": "node --loader ./src/runtime/shared/node-ts-loader.mjs scripts/smoke-mcp-http-runtime.ts",
     "smoke:tool-surface": "bun scripts/smoke-mcp-tool-surface.ts",
-    "check:smoke": "bun run smoke:mcp-http-runtime && bun run smoke:runtime-recovery && bun run smoke:schedule-engine && bun run smoke:tool-surface",
+    "check:smoke": "bun run smoke:workflow-supervisor && bun run smoke:workflow-supervisor-process-restart && bun run smoke:workflow-supervisor-restart-recovery && bun run smoke:workflow-supervisor-chrome-adapter && bun run smoke:mcp-http-runtime && bun run smoke:runtime-recovery && bun run smoke:unattended-transport-recovery && bun run smoke:control-plane-failure-domain && bun run smoke:schedule-engine && bun run smoke:tool-surface",
     "check:task": "bun scripts/run-governed-gate.ts task",
     "check:main": "bun scripts/run-governed-gate.ts main",
     "check:ci": "bun run check:main",
@@ -150,7 +165,6 @@
     "runtime:activate-source-baseline": "bun scripts/activate-source-baseline.ts request",
     "plugin:install-desktop-operator": "bun scripts/install-desktop-operator-registration.ts",
     "sync:brain-docs": "bun src/cli/index.ts run sync-brain-docs --all",
-    "sync:codex-installed": "bash scripts/sync-codex-installed-copies.sh",
     "check:forge-runtime": "bash scripts/verify-forge-runtime.sh",
     "repo:registry": "bun src/cli/v81-entry.ts repo",
     "smoke:schedule-engine": "node --loader ./src/runtime/shared/node-ts-loader.mjs scripts/smoke-schedule-engine.ts",
@@ -158,26 +172,18 @@
     "test:bun": "bun -e 'console.error(\"[tests] test:bun is deprecated; running explicit test:full\")' && bun run test:full",
     "test:node-smoke": "node --test tests/node/*.test.mjs",
     "check:ci:portable": "FORGE_ALLOW_NODE_ONLY=1 bash scripts/check-ci.sh",
-    "dev:controller-ui": "vite --config src/cli/local-bridge/frontend/vite.config.ts",
     "prepack": "node scripts/sync-generated-authority.mjs --check",
     "check:portable-package": "node --test tests/node/*.test.mjs && npm run smoke:tarball-install"
   },
   "devDependencies": {
-    "@colbymchenry/codegraph": "1.0.1",
     "@types/bun": "latest",
     "@types/cors": "^2.8.19",
-    "@types/express": "^5.0.6",
-    "@types/react": "^19.2.18",
-    "@types/react-dom": "^19.2.4",
-    "@vitejs/plugin-react": "^5.2.0",
-    "vite": "^7.3.0"
+    "@types/express": "^5.0.6"
   },
   "dependencies": {
     "commander": "^14.0.3",
     "express": "^5.2.1",
     "playwright": "^1.54.1",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.8",
     "typescript": "^6.0.3",
     "@modelcontextprotocol/client": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
@@ -186,12 +192,6 @@
   },
   "packageManager": "npm@10.0.0",
   "optionalDependencies": {
-    "@colbymchenry/codegraph-darwin-arm64": "1.0.1",
-    "@colbymchenry/codegraph-darwin-x64": "1.0.1",
-    "@colbymchenry/codegraph-linux-arm64": "1.0.1",
-    "@colbymchenry/codegraph-linux-x64": "1.0.1",
-    "@colbymchenry/codegraph-win32-arm64": "1.0.1",
-    "@colbymchenry/codegraph-win32-x64": "1.0.1",
     "agent-device": "0.20.2"
   }
 }

package/packages/kernel/cognition/api/index.ts

@@ -0,0 +1,6 @@
+export * from '../domain/memory';
+export * from '../domain/learning';
+export * from '../application/activation-service';
+export * from '../application/consolidation-service';
+export * from '../application/memory-service';
+export * from '../application/legacy-experience-adapter';