contextos-agents 2.0.0-beta.3 → 2.0.0

package/.agents/doctor.js

@@ -5,7 +5,7 @@
  * Implements Milestone 8 Doctor v2 specification:
  * - Standardized status outcomes: PASS, WARN, FAIL, SKIP, UNVERIFIED, RECOVERY_REQUIRED
  * - Deep diagnostic checks:
- *   1. Node.js environment (Node 18 for Core, Node 20 for Runtime)
+ *   1. Node.js environment (Node 22+ for the stable Core)
  *   2. Git availability & version
  *   3. Filesystem permissions and path containment
  *   4. Manifests & schema compliance
@@ -76,33 +76,20 @@ function checkNodeVersion() {
       ok: false,
       version,
       message: `${version} (unknown format)`,
-      remediation: 'Install Node.js >= 18.0.0 from https://nodejs.org',
+      remediation: 'Install Node.js >= 22.0.0 from https://nodejs.org',
     };
   }
 
   const major = parseInt(match[1], 10);
-  const minor = parseInt(match[2], 10);
-
-  // Core requires Node >= 18.0.0 (or 16.7.0 for basic cpSync). Runtime requires Node >= 20.0.0.
-  if (major < 18) {
+  // Stable Core requires Node.js 22 or newer.
+  if (major < 22) {
     return {
       id: 'node_version',
       status: STATUS.FAIL,
       ok: false,
       version,
-      message: `Node.js ${version} (< 18.0.0, Node 18 required for Core)`,
-      remediation: 'Upgrade Node.js to >= 18.0.0 (recommended >= 20.0.0 for ContextOS Runtime)',
-    };
-  }
-
-  if (major < 20) {
-    return {
-      id: 'node_version',
-      status: STATUS.WARN,
-      ok: true,
-      version,
-      message: `Node.js ${version} (>= 18.0.0 for Core, Node 20 recommended for Runtime)`,
-      remediation: 'Upgrade to Node.js >= 20.0.0 for optimal sandbox and runtime worker support',
+      message: `Node.js ${version} (< 22.0.0, Node 22 required for Core)`,
+      remediation: 'Upgrade Node.js to >= 22.0.0 from https://nodejs.org',
     };
   }
 
@@ -111,7 +98,7 @@ function checkNodeVersion() {
     status: STATUS.PASS,
     ok: true,
     version,
-    message: `Node.js ${version} (>= 20.0.0, optimal)`,
+    message: `Node.js ${version} (>= 22.0.0, supported)`,
     remediation: null,
   };
 }

package/LICENSE

@@ -1,21 +1,201 @@
-MIT License
-
-Copyright (c) 2026 contextos-agents contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 ContextOS Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,4 @@
+ContextOS (contextos-agents)
+Copyright 2026 ContextOS Contributors
+
+This product includes software developed at ContextOS (https://github.com/kok-o/contextos-agents).

package/README.md

@@ -1,13 +1,13 @@
 # <img src="./Frame%202.png" height="40" align="absmiddle" /> contextos-agents
 
 [![npm version](https://img.shields.io/npm/v/contextos-agents.svg)](https://www.npmjs.com/package/contextos-agents)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org/)
 [![CI](https://github.com/kok-o/contextos-agents/actions/workflows/validate-skills.yml/badge.svg)](https://github.com/kok-o/contextos-agents/actions/workflows/validate-skills.yml)
 
-**One source of truth for every coding agent.**
+**One version-controlled source of engineering rules for supported coding agents.**
 
-ContextOS is a deterministic context and policy compiler for AI coding agents. It transforms your team's version-controlled engineering rules into a minimal, verifiable context payload for Cursor, Claude Code, GitHub Copilot, Aider, and Zed—and detects configuration drift in CI.
+ContextOS is a deterministic context and policy compiler for AI coding agents. It transforms your team's version-controlled engineering rules into focused, verifiable context for Gemini, Claude Code, Cursor, GitHub Copilot, Aider, and Zed—and detects configuration drift in CI.
 
 ## Installation
 
@@ -40,8 +40,8 @@ Most AI coding assistants suffer from two extremes: they either operate in a vac
 
 ### The Three Pillars
 
-1. **Portable:** Define your engineering rules once. ContextOS exports optimized configurations for all major AI editors (Cursor, Claude Code, Copilot, Aider, Zed).
-2. **Minimal:** The dynamic resolver selects only the relevant skills and rules needed for a specific task, eliminating prompt bloat and token waste.
+1. **Portable:** Define your engineering rules once. ContextOS exports configurations for supported agents (Gemini, Claude Code, Cursor, Copilot, Aider, and Zed).
+2. **Focused:** The resolver selects rules and skills relevant to a task so agents receive less unrelated context.
 3. **Verifiable:** Lockfiles, provenance, drift detection, and CI gates make generated agent configuration reproducible and auditable.
 
 ## How it works
@@ -121,25 +121,21 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: kok-o/contextos-agents/.github/actions/contextos-gate@main
+      - uses: kok-o/contextos-agents/.github/actions/contextos-gate@v2.0.0
 ```
 
-## ContextOS MCP Bridge (Beta)
+## Optional MCP integration (Beta)
 
-ContextOS provides a read-only **Model Context Protocol (MCP)** server to allow compatible agents (like Claude Desktop) to dynamically read project rules, resolve context, and check project status.
+The MCP server is a separate beta package. It is not part of the stable `contextos-agents` core.
 
-> [!WARNING]
-> **Separation of Concerns:** The MCP Bridge and experimental runtime orchestration tools are distributed separately in the `@contextos/mcp` package (Beta). The `--with-mcp` flag in the Core CLI is deprecated.
+Install it separately if you want to try the beta integration:
 
-Install the optional MCP Bridge:
-
-`ash
+```bash
 npm install --save-dev @contextos/mcp
 npx contextos-mcp --dir .
-`
+```
 
-The MCP Bridge is read-only by default. Experimental execution tools require
-the explicit --enable-runtime flag and should only be used in trusted repositories.
+The MCP server is read-only by default. Runtime execution remains experimental and is outside the stable core scope.
 
 ## Security — Third-Party Skills
 
@@ -154,4 +150,4 @@ We are open to pull requests! See [CONTRIBUTING.md](./CONTRIBUTING.md) for a ste
 
 ## License
 
-Distributed under the MIT License. You can freely use, modify, and distribute this code.
+Distributed under the Apache License, Version 2.0. See [LICENSE](./LICENSE) and [NOTICE](./NOTICE) for details.

package/bin/commands/update.js

@@ -32,6 +32,7 @@ const {
 } = require('../lib/safe-writer.js');
 
 const pkg = require('../../package.json');
+const profiles = require('../../.agents/profiles.js');
 
 /**
  * Collect all distributable files from the source .agents directory.
@@ -112,13 +113,9 @@ function planUpdate(projectDir, sourceAgentsDir, options = {}) {
   // Determine active profile exclusions if available
   let excludedSkills = [];
   try {
-    const profilesPath = path.join(projectDir, '.agents', 'profiles.js');
-    if (fs.existsSync(profilesPath)) {
-      const profilesModule = require(profilesPath);
-      const active = profilesModule.getActiveProfile(projectDir);
-      if (active && Array.isArray(active.exclude_skills)) {
-        excludedSkills = active.exclude_skills;
-      }
+    const active = profiles.getActiveProfile(projectDir);
+    if (active && Array.isArray(active.exclude_skills)) {
+      excludedSkills = active.exclude_skills;
     }
   } catch {}
 
@@ -299,7 +296,9 @@ function runUpdate(projectDir = process.cwd(), options = {}) {
 
   // Re-compile if ctx.js exists and not skipped
   if (!options.skipCompile) {
-    const ctxPath = path.join(projectDir, '.agents', 'ctx.js');
+    // Run the compiler shipped with this package. The project's .agents/ctx.js
+    // is user-controlled and must never be executed implicitly during update.
+    const ctxPath = path.join(sourceAgentsDir, 'ctx.js');
     if (fs.existsSync(ctxPath)) {
       try {
         const { execFileSync } = require('child_process');

package/package.json

@@ -1,13 +1,14 @@
 {
     "name":  "contextos-agents",
-    "version":  "2.0.0-beta.3",
-    "description":  "ContextOS — Deterministic context compiler and policy engine for AI agents.",
+    "version":  "2.0.0",
+    "description":  "Deterministic context and policy compiler for supported AI coding agents.",
     "bin":  {
                 "contextos":  "./bin/index.js",
                 "contextos-agents":  "./bin/index.js",
                 "koko-contextos-agents":  "./bin/index.js"
             },
     "files":  [
+                  "NOTICE",
                   "bin",
                   "registry.json",
                   "registry.schema.json",
@@ -35,22 +36,18 @@
                   ".agents/workspace",
                   ".agents/filesystem",
                   ".agents/transaction-core",
-                  ".agents/customization-dx.js",
-                  "benchmarks/v2"
+                  ".agents/customization-dx.js"
               ],
     "scripts":  {
                     "build":  "node .agents/ctx.js compile \u0026\u0026 node .agents/ctx.js export all",
                     "compile":  "node .agents/ctx.js compile",
                     "export":  "node .agents/ctx.js export gemini",
                     "validate":  "node .agents/ctx.js validate",
-                    "benchmark":  "node benchmarks/gemini-issues.js",
-                    "benchmark:live":  "node benchmarks/run-live-benchmark.js",
-                    "benchmark:runtime":  "node benchmarks/run-runtime-benchmark.js",
-                    "lint:md":  "markdownlint README.md CONTRIBUTING.md .agents/core/skills/**/*.md --ignore .agents/generated/** --config .markdownlint.json",
+                    "lint:md":  "markdownlint README.md CONTRIBUTING.md GUIDE.md \".agents/core/skills/**/*.md\" --ignore \".agents/generated/**\" --config .markdownlint.json",
                     "check:secrets":  "node scripts/check-secrets.js --all",
                     "setup:hooks":  "node scripts/install-hooks.js",
                     "watch":  "node .agents/watch.js",
-                    "test":  "node --test --test-concurrency=1 tests/install.test.js tests/lockfile.test.js tests/safe-writer.test.js tests/adapter-safety.test.js tests/update.test.js tests/uninstall.test.js tests/plugin-security.test.js tests/export.test.js tests/skills.test.js tests/validate.test.js tests/plugins.test.js tests/benchmark.test.js tests/profile.test.js tests/resolver.test.js tests/cli-registry.test.js tests/profile-enforcement.test.js tests/doctor-hardening.test.js tests/manifest-compiler.test.js tests/canonical-resolver.test.js tests/workspace-graph.test.js tests/profiles-v2.test.js tests/safe-path.test.js tests/project-lock.test.js tests/journaled-transaction.test.js tests/pure-adapters.test.js tests/prompt-skill-system.test.js tests/runtime-state-machine.test.js tests/verification-reviewer-pipeline.test.js tests/durable-concurrency-locks.test.js tests/transactional-git.test.js tests/sandbox-execution.test.js tests/plugin-supply-chain.test.js tests/platform-hardening.test.js tests/customization-dx.test.js tests/claims-governance.test.js tests/benchmark-v2.test.js tests/init-engine.test.js tests/mutation-paths.test.js tests/tarball-smoke.test.js",
+                    "test":  "node --test --test-concurrency=1 tests/install.test.js tests/lockfile.test.js tests/safe-writer.test.js tests/adapter-safety.test.js tests/update.test.js tests/uninstall.test.js tests/plugin-security.test.js tests/export.test.js tests/skills.test.js tests/validate.test.js tests/plugins.test.js tests/benchmark.test.js tests/benchmark-api.test.js tests/profile.test.js tests/resolver.test.js tests/cli-registry.test.js tests/profile-enforcement.test.js tests/doctor-hardening.test.js tests/manifest-compiler.test.js tests/canonical-resolver.test.js tests/workspace-graph.test.js tests/profiles-v2.test.js tests/safe-path.test.js tests/project-lock.test.js tests/journaled-transaction.test.js tests/pure-adapters.test.js tests/prompt-skill-system.test.js tests/runtime-state-machine.test.js tests/verification-reviewer-pipeline.test.js tests/durable-concurrency-locks.test.js tests/transactional-git.test.js tests/sandbox-execution.test.js tests/plugin-supply-chain.test.js tests/platform-hardening.test.js tests/customization-dx.test.js tests/claims-governance.test.js tests/benchmark-v2.test.js tests/init-engine.test.js tests/mutation-paths.test.js tests/tarball-smoke.test.js",
                     "prepublishOnly":  "npm run validate \u0026\u0026 npm run build"
                 },
     "keywords":  [
@@ -65,11 +62,10 @@
                      "github-copilot",
                      "gemini",
                      "zed",
-                     "mcp",
                      "contextos"
                  ],
     "author":  "koko-o",
-    "license":  "MIT",
+    "license":  "Apache-2.0",
     "repository":  {
                        "type":  "git",
                        "url":  "https://github.com/kok-o/contextos-agents.git"
@@ -79,7 +75,7 @@
                  "url":  "https://github.com/kok-o/contextos-agents/issues"
              },
     "engines":  {
-                    "node":  "\u003e=18.0.0"
+                    "node":  "\u003e=22.0.0"
                 },
     "devDependencies":  {
                             "esbuild":  "^0.28.2",

package/benchmarks/v2/analysis/statistics.js

@@ -1,140 +0,0 @@
-/**
- * benchmarks/v2/analysis/statistics.js
- * ContextOS Benchmark v2 — Statistical Analysis Engine
- *
- * Implements Section 24 of CONTEXTOS_IMPLEMENTATION_PLAN.md:
- *   - Primary metric: cost per independently verified successful task
- *   - Wilson score 95% confidence intervals for binomial success proportions
- *   - Pairwise delta comparison between Arm C/D and Arm B (Concise Checklist comparator)
- *   - Structured tabular summary generation
- */
-
-'use strict';
-
-/**
- * Calculates Wilson score 95% confidence interval for a proportion.
- *
- * @param {number} successes
- * @param {number} total
- * @param {number} [z=1.96] - 95% confidence z-score
- * @returns {[number, number]} [lower, upper] as percentages [0, 100]
- */
-function calculateWilsonInterval(successes, total, z = 1.96) {
-  if (total === 0) return [0, 0];
-  const p = successes / total;
-  const z2 = z * z;
-  const denominator = 1 + z2 / total;
-  const center = (p + z2 / (2 * total)) / denominator;
-  const margin = (z * Math.sqrt((p * (1 - p)) / total + z2 / (4 * total * total))) / denominator;
-
-  return [
-    Math.max(0, parseFloat(((center - margin) * 100).toFixed(1))),
-    Math.min(100, parseFloat(((center + margin) * 100).toFixed(1))),
-  ];
-}
-
-class BenchmarkStatistics {
-  /**
-   * Analyzes an array of run outcomes across experimental arms.
-   *
-   * @param {Array<Object>} runs - List of run records: { armId, success, totalCost, durationMs }
-   * @returns {Object} Comprehensive statistical summary
-   */
-  static analyze(runs) {
-    const armsMap = {};
-
-    for (const run of runs) {
-      const { armId, success, totalCost = 0, durationMs = 0 } = run;
-      if (!armsMap[armId]) {
-        armsMap[armId] = {
-          armId,
-          totalRuns: 0,
-          successfulRuns: 0,
-          totalCost: 0,
-          totalDurationMs: 0,
-        };
-      }
-
-      const item = armsMap[armId];
-      item.totalRuns++;
-      if (success) item.successfulRuns++;
-      item.totalCost += totalCost;
-      item.totalDurationMs += durationMs;
-    }
-
-    const armStats = {};
-    for (const [armId, d] of Object.entries(armsMap)) {
-      const successRate = d.totalRuns > 0 ? (d.successfulRuns / d.totalRuns) * 100 : 0;
-      const ci95 = calculateWilsonInterval(d.successfulRuns, d.totalRuns);
-      const costPerSuccess = d.successfulRuns > 0 ? d.totalCost / d.successfulRuns : null;
-      const avgDurationMs = d.totalRuns > 0 ? d.totalDurationMs / d.totalRuns : 0;
-
-      armStats[armId] = {
-        armId,
-        totalRuns: d.totalRuns,
-        successfulRuns: d.successfulRuns,
-        successRate: parseFloat(successRate.toFixed(1)),
-        ci95,
-        totalCost: parseFloat(d.totalCost.toFixed(4)),
-        costPerVerifiedSuccess: costPerSuccess !== null ? parseFloat(costPerSuccess.toFixed(4)) : null,
-        avgDurationMs: Math.round(avgDurationMs),
-      };
-    }
-
-    // Pairwise comparisons against Arm B (Concise Checklist)
-    const comparator = armStats['arm-b-concise-checklist'];
-    const comparisons = {};
-
-    if (comparator) {
-      for (const [armId, stat] of Object.entries(armStats)) {
-        if (armId === 'arm-b-concise-checklist') continue;
-
-        const rateDelta = parseFloat((stat.successRate - comparator.successRate).toFixed(1));
-        let costRatio = null;
-        if (comparator.costPerVerifiedSuccess && stat.costPerVerifiedSuccess) {
-          costRatio = parseFloat((stat.costPerVerifiedSuccess / comparator.costPerVerifiedSuccess).toFixed(2));
-        }
-
-        comparisons[armId] = {
-          vsComparator: 'arm-b-concise-checklist',
-          successRateDelta: rateDelta,
-          costRatio,
-        };
-      }
-    }
-
-    return {
-      timestamp: Date.now(),
-      totalRunsAnalyzed: runs.length,
-      arms: armStats,
-      comparisons,
-    };
-  }
-
-  /**
-   * Formats statistical analysis into an aligned markdown summary table.
-   *
-   * @param {Object} analysis
-   * @returns {string}
-   */
-  static formatTable(analysis) {
-    const lines = [];
-    lines.push('| Arm ID | Runs | Successes | Success Rate (95% CI) | Cost / Verified Success | Avg Latency |');
-    lines.push('|---|---:|---:|---:|---:|---:|');
-
-    for (const arm of Object.values(analysis.arms)) {
-      const ciStr = `[${arm.ci95[0]}%, ${arm.ci95[1]}%]`;
-      const costStr = arm.costPerVerifiedSuccess !== null ? `$${arm.costPerVerifiedSuccess}` : 'N/A';
-      lines.push(
-        `| **${arm.armId}** | ${arm.totalRuns} | ${arm.successfulRuns} | ${arm.successRate}% ${ciStr} | ${costStr} | ${arm.avgDurationMs}ms |`
-      );
-    }
-
-    return lines.join('\n');
-  }
-}
-
-module.exports = {
-  calculateWilsonInterval,
-  BenchmarkStatistics,
-};