prompt-contract 0.2.0 → 0.2.1

package/README.md

@@ -7,8 +7,7 @@
 
 English · [简体中文](README.zh-CN.md)
 
-![PromptContract playground running the self-contained demo: a vague one-line request enhanced into a structured task spec, with six rule assertions passing](docs/assets/hero-playground.png)
-<sub>The playground running its self-contained demo (`?demo=1`) against the local mock upstream — actual pipeline output, six rule assertions passing.</sub>
+![PromptContract — a vague one-line request becomes a structured task spec (goal, scope, acceptance criteria, non-goals), verified by six hard rules via `prompt-contract check`. Real-LLM latency P50 2.3s; engine adds 0.005ms. CLI · MCP · Playground — zero dependencies, BYOK, offline-capable.](docs/assets/hero-cover.png)
 
 **PromptContract is a deterministic prompt-contract layer for AI coding agents.** It compiles a vague one-line request into a structured task specification — goal, scope, constraints, acceptance criteria — and verifies the result against six hard rules before you ever see it.
 
@@ -17,7 +16,7 @@ It is *not* a smarter brain: your model does the thinking, PromptContract makes
 ## Why PromptContract
 
 - **Stable agent inputs** — a profile plus hard constraints turn "a website for my dog" into goal / scope / acceptance criteria / explicit non-goals. Reduced retries and scope drift are hypotheses measured by the task-level harness, not current product claims.
-- **Six deterministic guardrails** — language consistency, enhanced-text-only, length & completeness, expand-don't-answer, no hallucinated tech. Every enhancement can be asserted with `contract check`; the same spec drives templates and tests.
+- **Six deterministic guardrails** — language consistency, enhanced-text-only, length & completeness, expand-don't-answer, no hallucinated tech. Every enhancement can be asserted with `prompt-contract check`; the same spec drives templates and tests.
 - **One engine, three surfaces** — a CLI, an MCP server (agent-invoked **tool** + user-invoked **slash prompts**), and a browser playground. All share one zero-dependency core.
 - **Private by architecture** — bring your own key, no server in the middle, no telemetry, offline-capable via Ollama.
 
@@ -37,10 +36,10 @@ Install: `npm i -g prompt-contract` — or zero-install: `npx prompt-contract "y
 
 ```bash
 export CONTRACT_API_KEY=sk-xxx CONTRACT_MODEL=gpt-4o-mini    # any OpenAI-compatible endpoint (DeepSeek, Qwen, GLM, vLLM…)
-contract "A website for my dog"
+prompt-contract "A website for my dog"
 
 export CONTRACT_PROVIDER=ollama CONTRACT_MODEL=qwen3:4b      # fully local/offline; keep_alive pins the model in RAM
-contract "帮我写一封请假邮件"
+prompt-contract "帮我写一封请假邮件"
 ```
 
 Or write `~/.prompt-contract/config.json` once: `{ "provider": "openai", "baseUrl": "…", "apiKey": "…", "model": "…" }`.
@@ -88,8 +87,8 @@ raw input → script/scenario detect → profile + hard constraints + strength (
 
 ## Status & roadmap — stated honestly
 
-- **Shipped:** engine, CLI (`contract` / `check` / `doctor` / `profiles` / `spike-0`), MCP server (tool + zero-key prompts), playground, 3 profiles, eval cases, CI matrix.
-- **Gated:** `contract watch` (global-hotkey resident mode) remains intentionally unavailable. `contract spike-0` measures macOS capture/clipboard safety and dry-run focus eligibility, but never pastes or unlocks watch by itself; see [docs/SPIKE-0.md](docs/SPIKE-0.md).
+- **Shipped:** engine, CLI (`prompt-contract` / `check` / `doctor` / `profiles` / `spike-0`), MCP server (tool + zero-key prompts), playground, 3 profiles, eval cases, CI matrix.
+- **Gated:** `prompt-contract watch` (global-hotkey resident mode) remains intentionally unavailable. `prompt-contract spike-0` measures macOS capture/clipboard safety and dry-run focus eligibility, but never pastes or unlocks watch by itself; see [docs/SPIKE-0.md](docs/SPIKE-0.md).
 - **Open validation:** task-level outcome evaluation remains an evidence-gathering task. The harness and curated fixture set exist, but PromptContract's downstream effectiveness is still a hypothesis until a declared runner produces reviewed results.
 - Deferred: animated demo asset, IDE plugins, LLM-as-judge as *one* scorer inside the task-level eval.
 

package/README.zh-CN.md

@@ -6,16 +6,16 @@
 
 [English](README.md) · 简体中文
 
+![PromptContract——模糊的一句话被编译成结构化任务规范（目标 / 范围 / 验收标准 / 明确不做的事），六条硬规则经 `contract check` 校验。真实 LLM 端到端 P50 2.3s，引擎附加开销 0.005ms。CLI · MCP · Playground——零依赖、BYOK、可离线。](docs/assets/hero-cover.png)
+
 **PromptContract 是面向 AI 编码 agent 的确定性 prompt 契约层**：把模糊的一句话编译成结构化任务规范（目标 / 范围 / 约束 / 验收标准），并在你看到结果之前用六条硬规则完成校验。
 
 它不是「更聪明的大脑」：思考由你的模型完成，PromptContract 让 agent 的输入变得稳定、可审查、可跨模型与跨工具迁移。
 
-![Playground 自运行演示：模糊一句话被增强为结构化任务规范，六条规则断言全部通过](docs/assets/hero-playground.png)
-
 ## 为什么
 
 - **稳定的 agent 输入**——profile + 硬约束把「帮我做个网站」编译成目标 / 范围 / 验收标准 / 明确不做的事；重试与范围漂移是否减少，仍须由任务级 harness 验证，当前不作产品结论
-- **六条确定性护栏**——语言一致性、只输出增强文本、长度与完整性、扩写而非回答、无幻觉技术栈；`contract check` 随时可断言，模板与测试共用同一份规格
+- **六条确定性护栏**——语言一致性、只输出增强文本、长度与完整性、扩写而非回答、无幻觉技术栈；`prompt-contract check` 随时可断言，模板与测试共用同一份规格
 - **一个引擎、三个形态**——CLI、MCP server（agent 调用的 tool + 用户调用的斜杠 prompts）、浏览器 Playground，共享同一个零依赖内核
 - **隐私即架构**——BYOK、无中间服务、零遥测，Ollama 全本地可用
 
@@ -35,10 +35,10 @@ node packages/playground/serve.js                       # → http://127.0.0.1:8
 
 ```bash
 export CONTRACT_API_KEY=sk-xxx CONTRACT_MODEL=gpt-4o-mini   # 任意 OpenAI 兼容端点（DeepSeek/Qwen/GLM/vLLM…）
-contract "A website for my dog"
+prompt-contract "A website for my dog"
 
 export CONTRACT_PROVIDER=ollama CONTRACT_MODEL=qwen3:4b     # 全本地；keep_alive 把模型钉在内存
-contract "帮我写一封请假邮件"
+prompt-contract "帮我写一封请假邮件"
 ```
 
 或一次写入 `~/.prompt-contract/config.json`。
@@ -64,7 +64,7 @@ npm run bench   # 引擎自身开销 P50 ≈ 0.005ms（预算 <5ms）
 ## 状态与路线图（诚实版）
 
 - **已交付**：引擎、CLI（含 `spike-0`）、MCP server（tool + 零 key prompts）、Playground、3 个 profiles、eval 用例、CI 矩阵
-- **被门控**：`contract watch`（全局热键常驻）仍不可用。`contract spike-0` 只测 macOS 取词、剪贴板恢复和焦点校验的 dry-run，不发送粘贴，也不会自行解锁 watch；见 [docs/SPIKE-0.md](docs/SPIKE-0.md)
+- **被门控**：`prompt-contract watch`（全局热键常驻）仍不可用。`prompt-contract spike-0` 只测 macOS 取词、剪贴板恢复和焦点校验的 dry-run，不发送粘贴，也不会自行解锁 watch；见 [docs/SPIKE-0.md](docs/SPIKE-0.md)
 - **开放验证**：任务级效果评测的 harness 与任务 fixture 已交付，但还没有声明 runner 产生并复核结果；长期价值在此之前仍是假设
 - **推迟**：动画 demo 资产、IDE 插件、LLM-as-judge（作为任务级评测中的评分器之一）
 

package/package.json

@@ -1,21 +1,22 @@
 {
   "name": "prompt-contract",
-  "version": "0.2.0",
-  "description": "pc — one-key prompt enhancement: turn vague ideas into structured task specs anywhere you type to an AI. CLI + MCP server. Zero dependencies, BYOK, offline-capable (Ollama).",
+  "version": "0.2.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "One-key prompt enhancement — turn vague ideas into structured task specs anywhere you type to an AI. CLI + MCP server. Zero dependencies, BYOK, offline-capable (Ollama).",
   "license": "Apache-2.0",
   "type": "module",
   "engines": {
     "node": ">=20"
   },
   "bin": {
-    "contract": "./packages/cli/bin/contract.js",
     "prompt-contract": "./packages/cli/bin/contract.js",
-    "prompt-contract-mcp": "./packages/mcp-server/bin/prompt-contract-mcp.js",
-    "pb": "./packages/cli/bin/contract.js"
+    "contract": "./packages/cli/bin/contract.js",
+    "prompt-contract-mcp": "./packages/mcp-server/bin/prompt-contract-mcp.js"
   },
   "keywords": [
     "prompt",
-    "prompt-contract",
     "prompt-engineering",
     "llm",
     "cli",
@@ -36,7 +37,7 @@
     "packages/",
     "profiles/",
     "README.md",
-    "README.en.md",
+    "README.zh-CN.md",
     "LICENSE"
   ]
 }

package/packages/cli/bin/contract.js

@@ -24,18 +24,18 @@ if (basename(process.argv[1] || '') === 'contract') {
   process.stderr.write('[deprecated] this CLI is now `contract` (prompt-contract); the `contract` command will be removed in a future release.\n');
 }
 
-const VERSION = '0.2.0';
-const USAGE = `contract — one-key prompt enhancement (PromptContract v${VERSION})
+const VERSION = '0.2.1';
+const USAGE = `prompt-contract — one-key prompt enhancement (PromptContract v${VERSION})
 
 Usage:
-  contract "build me a website for my dog"     enhance a prompt (prints enhanced text to stdout)
-  cat prompt.txt | contract                    enhance from stdin
-  contract profiles                            list built-in profiles
-  contract check --original "..." --enhanced "..."
+  prompt-contract "build me a website for my dog"     enhance a prompt (prints enhanced text to stdout)
+  cat prompt.txt | prompt-contract                    enhance from stdin
+  prompt-contract profiles                            list built-in profiles
+  prompt-contract check --original "..." --enhanced "..."
                                          run the six hard-constraint rule assertions
-  contract doctor                              verify config, provider reachability, profiles
-  contract spike-0                             macOS-only capture/restore compatibility diagnostic (dry-run)
-  contract watch                               NOT BUILT — gated by decision D7 (Spike-0 first); see docs/SPIKE-0.md
+  prompt-contract doctor                              verify config, provider reachability, profiles
+  prompt-contract spike-0                             macOS-only capture/restore compatibility diagnostic (dry-run)
+  prompt-contract watch                               NOT BUILT — gated by decision D7 (Spike-0 first); see docs/SPIKE-0.md
 
 Options:
   -p, --profile <name>     scenario profile (default: coding-agent)

package/packages/cli/test/cli.test.js

@@ -1,89 +0,0 @@
-import { test, before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { spawn } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import { createMockServer, ZH_RESULT } from '../../../mock/server.js';
-
-let mock, base, repoRoot;
-const PB = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'contract.js');
-
-before(async () => {
-  mock = createMockServer({});
-  const port = await mock.listen();
-  base = `http://127.0.0.1:${port}`;
-  repoRoot = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
-});
-
-after(async () => { await mock.close(); });
-
-function runPb(args, { env = {}, input } = {}) {
-  return new Promise((resolveRun) => {
-    const child = spawn(process.execPath, [PB, ...args], {
-      cwd: repoRoot,
-      env: { ...process.env, ...env }
-    });
-    let stdout = '', stderr = '';
-    child.stdout.on('data', (d) => { stdout += d; });
-    child.stderr.on('data', (d) => { stderr += d; });
-    if (input !== undefined) child.stdin.end(input); else child.stdin.end();
-    child.on('close', (code) => resolveRun({ code, stdout, stderr }));
-  });
-}
-
-const OPENAI_ENV = { CONTRACT_PROVIDER: 'openai', CONTRACT_BASE_URL: `${base}/v1`, CONTRACT_API_KEY: 'test-key-123', CONTRACT_MODEL: 'mock-model' };
-
-test('e2e: contract "..." enhances via openai-compatible upstream and passes rule assertions', async () => {
-  const { code, stdout, stderr } = await runPb(['--json', '--provider', 'openai', '--base-url', `${base}/v1`, '--api-key', 'test-key-123', '--model', 'mock-model', '帮我做一个展示我家狗的网站']);
-  assert.equal(code, 0, stderr);
-  const out = JSON.parse(stdout);
-  assert.equal(out.original, '帮我做一个展示我家狗的网站');
-  assert.equal(out.enhanced, ZH_RESULT);
-  assert.equal(out.meta.profile, 'coding-agent');
-  assert.equal(out.meta.model, 'mock-model');
-  assert.equal(out.rules.pass, true, JSON.stringify(out.rules.results));
-});
-
-test('e2e: contract reads prompt from stdin (pipe mode)', async () => {
-  const { code, stdout } = await runPb(
-    ['--no-stream', '--provider', 'openai', '--base-url', `${base}/v1`, '--api-key', 'test-key-123', '--model', 'mock-model'],
-    { input: '帮我做一个展示我家狗的网站' }
-  );
-  assert.equal(code, 0);
-  assert.equal(stdout.trim(), ZH_RESULT);
-});
-
-test('contract profiles lists the three built-in profiles', async () => {
-  const { code, stdout } = await runPb(['profiles']);
-  assert.equal(code, 0);
-  for (const name of ['coding-agent', 'writing', 'image-gen']) assert.match(stdout, new RegExp(name));
-});
-
-test('contract check exits 1 on a failing pair (gate mode) and 0 on a good pair', async () => {
-  const bad = await runPb(['check', '--original', '做个博客', '--enhanced', '好的，以下是实现方案：先安装依赖。']);
-  assert.equal(bad.code, 1);
-  assert.match(bad.stderr, /FAIL/);
-  const good = await runPb(['check', '--original', '帮我做一个展示我家狗的网站', '--enhanced', ZH_RESULT]);
-  assert.equal(good.code, 0, good.stderr);
-});
-
-test('contract watch is gated by decision D7', async () => {
-  const { code, stderr } = await runPb(['watch']);
-  assert.equal(code, 2);
-  assert.match(stderr, /D7/);
-});
-
-test('contract spike-0 exposes the macOS dry-run diagnostic', async () => {
-  const { code, stdout } = await runPb(['spike-0', '--help']);
-  assert.equal(code, 0);
-  assert.match(stdout, /dry-run/);
-  assert.match(stdout, /Chrome/);
-  assert.match(stdout, /PyCharm/);
-  assert.match(stdout, /iTerm/);
-});
-
-test('contract doctor reports provider problems honestly', async () => {
-  const { code, stderr } = await runPb(['doctor', '--provider', 'openai', '--base-url', `${base}/v1`, '--api-key', 'wrong-key', '--model', 'mock-model']);
-  assert.equal(code, 1);
-  assert.match(stderr, /FAIL/);
-});

package/packages/cli/test/spike-0.test.js

@@ -1,260 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import {
-  captureSelectedText,
-  validatePasteBackDryRun,
-  buildCompatibilityReport,
-  DEFAULT_SPIKE_THRESHOLDS,
-  isPlainTextClipboardInfo,
-  runSpike0,
-} from '../src/spike-0.js';
-
-function context(overrides = {}) {
-  return {
-    processName: 'Google Chrome',
-    bundleId: 'com.google.Chrome',
-    pid: 123,
-    windowTitle: 'Prompt test',
-    focus: {
-      role: 'AXTextField',
-      subrole: 'AXStandardWindow',
-      identifier: 'prompt-input',
-      title: '',
-      description: 'Prompt input',
-    },
-    ...overrides,
-  };
-}
-
-function fakeAdapter({
-  clipboard = 'keep this clipboard',
-  selectedText = 'selected prompt',
-  contexts = [context(), context(), context()],
-  copyError,
-  clipboardCheckError,
-} = {}) {
-  const state = { clipboard, events: [], contexts: [...contexts] };
-  return {
-    state,
-    async readClipboard() {
-      state.events.push('readClipboard');
-      return state.clipboard;
-    },
-    async checkClipboardRestorable() {
-      state.events.push('checkClipboardRestorable');
-      if (clipboardCheckError) throw clipboardCheckError;
-    },
-    async writeClipboard(value) {
-      state.events.push(['writeClipboard', value]);
-      state.clipboard = value;
-    },
-    async copySelection() {
-      state.events.push('copySelection');
-      if (copyError) throw copyError;
-      state.clipboard = selectedText;
-    },
-    async getFocusIdentity() {
-      state.events.push('getFocusIdentity');
-      return state.contexts.shift() || context();
-    },
-    async sleep() {
-      state.events.push('sleep');
-    },
-  };
-}
-
-test('captureSelectedText restores the original clipboard after a successful copy', async () => {
-  const adapter = fakeAdapter();
-
-  const result = await captureSelectedText(adapter, { settleMs: 0 });
-
-  assert.equal(result.selectedText, 'selected prompt');
-  assert.equal(result.selectedTextLength, 15);
-  assert.equal(result.clipboardRestored, true);
-  assert.equal(result.userTextMutated, false);
-  assert.equal(adapter.state.clipboard, 'keep this clipboard');
-  assert.deepEqual(adapter.state.events, [
-    'readClipboard',
-    'checkClipboardRestorable',
-    'getFocusIdentity',
-    'copySelection',
-    'sleep',
-    'readClipboard',
-    'getFocusIdentity',
-    ['writeClipboard', 'keep this clipboard'],
-    'readClipboard',
-  ]);
-});
-
-test('captureSelectedText restores the clipboard when copy fails', async () => {
-  const adapter = fakeAdapter({ copyError: new Error('Accessibility denied') });
-
-  const result = await captureSelectedText(adapter, { settleMs: 0 });
-
-  assert.equal(result.selectedText, null);
-  assert.equal(result.clipboardRestored, true);
-  assert.equal(result.userTextMutated, false);
-  assert.match(result.error, /Accessibility denied/);
-  assert.equal(adapter.state.clipboard, 'keep this clipboard');
-  assert.equal(adapter.state.events.some((event) => Array.isArray(event) && event[0] === 'writeClipboard'), true);
-});
-
-test('captureSelectedText refuses an unsupported clipboard without rewriting it', async () => {
-  const adapter = fakeAdapter({ clipboardCheckError: new Error('clipboard_not_plain_text') });
-
-  const result = await captureSelectedText(adapter, { settleMs: 0 });
-
-  assert.equal(result.selectedText, null);
-  assert.match(result.error, /clipboard_not_plain_text/);
-  assert.equal(result.clipboardRestored, false);
-  assert.equal(result.clipboardUntouched, true);
-  assert.equal(adapter.state.clipboard, 'keep this clipboard');
-  assert.equal(adapter.state.events.includes('copySelection'), false);
-  assert.equal(adapter.state.events.some((event) => Array.isArray(event) && event[0] === 'writeClipboard'), false);
-});
-
-test('isPlainTextClipboardInfo accepts text-only pasteboards and rejects rich types', () => {
-  assert.equal(
-    isPlainTextClipboardInfo('«class utf8», 0, «class ut16», 2, string, 0, Unicode text, 0'),
-    true,
-  );
-  assert.equal(
-    isPlainTextClipboardInfo('«class utf8», 4, «class HTML», 128'),
-    false,
-  );
-});
-
-test('runSpike0 supports a setup delay before each target without changing capture semantics', async () => {
-  const adapter = fakeAdapter();
-  const announcements = [];
-
-  await runSpike0({
-    adapter,
-    targets: ['Chrome'],
-    iterations: 1,
-    setupDelayMs: 25,
-    interactive: false,
-    announce: (message) => announcements.push(message),
-    now: () => new Date('2026-09-07T00:00:00.000Z'),
-  });
-
-  assert.deepEqual(announcements, ['Focus Chrome and select text now; capture starts after the setup delay.']);
-  assert.equal(adapter.state.events[0], 'sleep');
-  assert.equal(adapter.state.events.includes('copySelection'), true);
-});
-
-test('validatePasteBackDryRun checks focus stability without issuing paste', async () => {
-  const adapter = fakeAdapter();
-  const before = context();
-
-  const result = await validatePasteBackDryRun(adapter, {
-    capturedContext: before,
-    selectedText: 'selected prompt',
-    pauseMs: 0,
-  });
-
-  assert.equal(result.mode, 'dry-run');
-  assert.equal(result.executed, false);
-  assert.equal(result.wouldPasteBack, true);
-  assert.equal(result.userTextMutated, false);
-  assert.equal(adapter.state.events.includes('pasteSelection'), false);
-});
-
-test('validatePasteBackDryRun rejects focus drift without changing user text', async () => {
-  const adapter = fakeAdapter({ contexts: [context({ pid: 456, windowTitle: 'Other app' })] });
-
-  const result = await validatePasteBackDryRun(adapter, {
-    capturedContext: context(),
-    selectedText: 'selected prompt',
-    pauseMs: 0,
-  });
-
-  assert.equal(result.wouldPasteBack, false);
-  assert.equal(result.reason, 'focus_drift');
-  assert.equal(result.executed, false);
-  assert.equal(result.userTextMutated, false);
-});
-
-test('validatePasteBackDryRun tolerates a transiently unavailable window title', async () => {
-  const adapter = fakeAdapter({ contexts: [context({ windowTitle: '' })] });
-
-  const result = await validatePasteBackDryRun(adapter, {
-    capturedContext: context(),
-    selectedText: 'selected prompt',
-    pauseMs: 0,
-  });
-
-  assert.equal(result.wouldPasteBack, true);
-  assert.equal(result.focusStable, true);
-  assert.equal(result.executed, false);
-});
-
-test('buildCompatibilityReport applies the Spike-0 cohort thresholds', () => {
-  const runs = [];
-  for (const target of ['Chrome', 'PyCharm', 'iTerm']) {
-    for (let iteration = 1; iteration <= 20; iteration++) {
-      runs.push({
-        target,
-        iteration,
-        capture: {
-          selectedTextCaptured: true,
-          clipboardRestored: true,
-          clipboardRestoreVerified: true,
-          focusRecorded: true,
-        },
-        pasteBack: { mode: 'dry-run', wouldPasteBack: true, contextAtValidation: {} },
-        safety: { userTextMutated: false, pasteCommandSent: false },
-      });
-    }
-  }
-
-  const report = buildCompatibilityReport({
-    runs,
-    targets: ['Chrome', 'PyCharm', 'iTerm'],
-    thresholds: DEFAULT_SPIKE_THRESHOLDS,
-    platformInfo: { os: 'darwin', arch: 'arm64' },
-    startedAt: '2026-09-07T00:00:00.000Z',
-    finishedAt: '2026-09-07T00:00:01.000Z',
-  });
-
-  assert.equal(report.schemaVersion, 'prompt-contract/spike-0.v1');
-  assert.equal(report.mode, 'dry-run');
-  assert.equal(report.summary.captureSuccessRate, 1);
-  assert.equal(report.summary.clipboardRestoreSuccessRate, 1);
-  assert.equal(report.decision.pass, true);
-  assert.equal(report.decision.watchGate, 'closed');
-});
-
-test('buildCompatibilityReport fails below the combined capture threshold', () => {
-  const runs = [];
-  for (const target of ['Chrome', 'PyCharm', 'iTerm']) {
-    for (let iteration = 1; iteration <= 20; iteration++) {
-      const failed = target === 'iTerm' && iteration <= 7;
-      runs.push({
-        target,
-        iteration,
-        capture: {
-          selectedTextCaptured: !failed,
-          clipboardRestored: true,
-          clipboardRestoreVerified: true,
-          focusRecorded: true,
-        },
-        pasteBack: { mode: 'dry-run', wouldPasteBack: !failed, contextAtValidation: {} },
-        safety: { userTextMutated: false, pasteCommandSent: false },
-      });
-    }
-  }
-
-  const report = buildCompatibilityReport({
-    runs,
-    targets: ['Chrome', 'PyCharm', 'iTerm'],
-    thresholds: DEFAULT_SPIKE_THRESHOLDS,
-    platformInfo: { os: 'darwin', arch: 'arm64' },
-    startedAt: '2026-09-07T00:00:00.000Z',
-    finishedAt: '2026-09-07T00:00:01.000Z',
-  });
-
-  assert.equal(report.summary.captureSuccessRate, 0.8833);
-  assert.equal(report.decision.pass, false);
-  assert.match(report.decision.reasons.join(' '), /dry-run paste-back/);
-});

package/packages/core/bench/bench.js

@@ -1,48 +0,0 @@
-/**
- * Engine overhead benchmark — the part of the latency budget we own (PRD §5.3/§7.6).
- * The model TTFT is external and dominates end-to-end latency; this proves the engine adds
- * effectively nothing on top (budget: P50 < 5ms, in practice microseconds).
- */
-import { assembleMessages } from '../src/pipeline.js';
-import { postprocess } from '../src/clean.js';
-import { checkRules } from '../src/rules.js';
-
-const PROFILE = { name: 'coding-agent', maxChars: 800, body: 'You rewrite vague requests for a coding assistant. '.repeat(4) };
-const INPUTS = [
-  '帮我做一个展示我家狗的网站',
-  'A website for my dog',
-  'explain this code',
-  '把这份周报改正式一点',
-  '一只在雪地里的柴犬'
-];
-const OUTPUT = '做一个展示宠物的小型网站：包含照片画廊、简介页与动态页，导航保持单层，暂不需要评论功能。';
-
-const N = 20000;
-const times = [];
-// warmup
-for (let i = 0; i < 500; i++) {
-  const { system, user } = assembleMessages(INPUTS[i % INPUTS.length], { profile: PROFILE, strength: 'standard' });
-  postprocess(system + user, 800);
-}
-for (let i = 0; i < N; i++) {
-  const t0 = performance.now();
-  const { system, user } = assembleMessages(INPUTS[i % INPUTS.length], { profile: PROFILE, strength: 'standard' });
-  const cleaned = postprocess(`“${OUTPUT}”`, 800);
-  checkRules(INPUTS[i % INPUTS.length], cleaned, { maxChars: 800 });
-  if (system.length === 0 || user.length === 0) throw new Error('assembly broke');
-  times.push(performance.now() - t0);
-}
-times.sort((a, b) => a - b);
-const p50 = times[Math.floor(N * 0.5)];
-const p95 = times[Math.floor(N * 0.95)];
-const mean = times.reduce((a, b) => a + b, 0) / N;
-
-console.log(`engine overhead per enhancement (assemble + clean + rules), n=${N}`);
-console.log(`  P50: ${p50.toFixed(3)}ms`);
-console.log(`  P95: ${p95.toFixed(3)}ms`);
-console.log(`  mean: ${mean.toFixed(3)}ms`);
-if (p50 >= 5) {
-  console.error('BUDGET VIOLATION: P50 must stay under 5ms');
-  process.exit(1);
-}
-console.log('budget check: PASS (P50 < 5ms)');

package/packages/core/package.json

@@ -1,11 +0,0 @@
-{
-  "name": "@prompt-contract/core",
-  "version": "0.1.0",
-  "description": "PromptContract engine — profile assembly, single-shot LLM call contract, deterministic cleaning and rule assertions. Zero runtime dependencies, browser-safe.",
-  "type": "module",
-  "license": "Apache-2.0",
-  "exports": {
-    ".": "./src/index.js",
-    "./node": "./src/node.js"
-  }
-}

package/packages/core/test/clean.test.js

@@ -1,44 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { stripWrappingQuotes, stripFences, clampChars, postprocess } from '../src/clean.js';
-
-test('stripWrappingQuotes removes paired quotes repeatedly', () => {
-  assert.equal(stripWrappingQuotes('"hello"'), 'hello');
-  assert.equal(stripWrappingQuotes('“你好世界”'), '你好世界');
-  assert.equal(stripWrappingQuotes('‘“嵌套”’'), '嵌套');
-  assert.equal(stripWrappingQuotes('「block」'), 'block');
-});
-
-test('stripWrappingQuotes keeps inner apostrophes', () => {
-  assert.equal(stripWrappingQuotes("it's ok"), "it's ok");
-});
-
-test('stripFences removes full and partial fences', () => {
-  assert.equal(stripFences('```\ntext\n```'), 'text');
-  assert.equal(stripFences('```md\n# title\n```'), '# title');
-  assert.equal(stripFences('```\nno closing'), 'no closing');
-  assert.equal(stripFences('plain'), 'plain');
-});
-
-test('clampChars cuts at sentence boundary under the limit', () => {
-  const t = '第一句。第二句。' + '长'.repeat(900);
-  const out = clampChars(t, 800);
-  assert.ok([...out].length <= 800);
-  assert.ok(out.endsWith('。') || out.endsWith('长'));
-});
-
-test('clampChars removes dangling colon and list markers', () => {
-  const t = '要点如下：' + 'x'.repeat(798);
-  const out = clampChars(t, 800);
-  assert.ok(!/[:：]\s*$/.test(out));
-  assert.ok(!/[-*+]\s*$/.test(out));
-});
-
-test('clampChars leaves short text untouched', () => {
-  assert.equal(clampChars('短文本', 800), '短文本');
-});
-
-test('postprocess: null for empty, strips combo of fences + quotes', () => {
-  assert.equal(postprocess('   \n\t', 800), null);
-  assert.equal(postprocess('```\n“最终文本”\n```', 800), '最终文本');
-});

package/packages/core/test/lang.test.js

@@ -1,21 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { detectScriptName } from '../src/lang.js';
-
-test('dominant script detection', () => {
-  assert.equal(detectScriptName('你好世界'), 'han');
-  assert.equal(detectScriptName('hello world'), 'latin');
-  assert.equal(detectScriptName('こんにちは世界'), 'japanese');
-  assert.equal(detectScriptName('Привет мир'), 'cyrillic');
-  assert.equal(detectScriptName('안녕하세요'), 'hangul');
-});
-
-test('mixed CJK/latin resolves to the CJK script', () => {
-  assert.equal(detectScriptName('用 React 重构这个 module'), 'han');
-  assert.equal(detectScriptName('refactor this module 用例'), 'han');
-});
-
-test('japanese beats han when kana present (enables zh→ja detection)', () => {
-  assert.equal(detectScriptName('世界'), 'han');
-  assert.equal(detectScriptName('世界です'), 'japanese');
-});

package/packages/core/test/pipeline.test.js

@@ -1,85 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { enhance, assembleMessages, hardConstraints } from '../src/pipeline.js';
-import { PromptContractError } from '../src/errors.js';
-
-const PROFILE = { name: 'coding-agent', maxChars: 800, body: 'You rewrite vague requests for a coding assistant.' };
-
-function fakeProvider(reply, { fail } = {}) {
-  const calls = [];
-  return {
-    calls,
-    async complete(opts) {
-      calls.push(opts);
-      if (fail === 'abort') { const e = new Error('aborted'); e.name = 'AbortError'; throw e; }
-      if (fail === 'boom') throw new Error('socket hang up');
-      return { text: reply };
-    }
-  };
-}
-
-test('assembleMessages embeds profile body, constraints, strength and context', () => {
-  const { system, user } = assembleMessages('做个网站', { profile: PROFILE, strength: 'expand', context: 'repo: pet-project' });
-  assert.match(system, /You rewrite vague requests/);
-  assert.match(system, /HARD CONSTRAINTS:/);
-  assert.match(system, /under 800 characters/);
-  assert.match(system, /STRENGTH MODE: EXPAND/);
-  assert.match(user, /USER INPUT:\n做个网站/);
-  assert.match(user, /CONTEXT \(background[^\n]*\):\nrepo: pet-project/);
-});
-
-test('all three strengths render distinct modes', () => {
-  for (const s of ['polish', 'standard', 'expand']) {
-    const { system } = assembleMessages('x', { profile: PROFILE, strength: s });
-    assert.match(system, new RegExp(`STRENGTH MODE: ${s.toUpperCase()}`));
-  }
-});
-
-test('hardConstraints mirror the six eval rules', () => {
-  const hc = hardConstraints({ maxChars: 800, strength: 'standard' });
-  assert.match(hc, /same language as USER INPUT/);
-  assert.match(hc, /no markdown fences/);
-  assert.match(hc, /under 800 characters/);
-  assert.match(hc, /EXPAND, DO NOT ANSWER/);
-  assert.match(hc, /lightly polish/);
-  assert.match(hc, /do not add requirements, features, or technologies/);
-});
-
-test('enhance: happy path returns cleaned text + original + meta', async () => {
-  const provider = fakeProvider('  “请结构化地说明……”  ');
-  const res = await enhance('帮我解释', { profile: PROFILE, provider, model: 'm1', strength: 'standard' });
-  assert.equal(res.text, '请结构化地说明……');
-  assert.equal(res.original, '帮我解释');
-  assert.equal(res.meta.profile, 'coding-agent');
-  assert.equal(res.meta.model, 'm1');
-  assert.equal(typeof res.meta.ms, 'number');
-  assert.equal(provider.calls[0].maxTokens, Math.ceil(800 * 1.2));
-});
-
-test('enhance: empty input → empty_input', async () => {
-  await assert.rejects(
-    () => enhance('   ', { profile: PROFILE, provider: fakeProvider('x') }),
-    (e) => e instanceof PromptContractError && e.code === 'empty_input'
-  );
-});
-
-test('enhance: empty provider result → llm_error', async () => {
-  await assert.rejects(
-    () => enhance('hello', { profile: PROFILE, provider: fakeProvider('   ') }),
-    (e) => e.code === 'llm_error'
-  );
-});
-
-test('enhance: caller abort → aborted (ADR-017 semantics)', async () => {
-  await assert.rejects(
-    () => enhance('hello', { profile: PROFILE, provider: fakeProvider(null, { fail: 'abort' }) }),
-    (e) => e.code === 'aborted'
-  );
-});
-
-test('enhance: unexpected provider crash → provider_unavailable', async () => {
-  await assert.rejects(
-    () => enhance('hello', { profile: PROFILE, provider: fakeProvider(null, { fail: 'boom' }) }),
-    (e) => e.code === 'provider_unavailable'
-  );
-});

package/packages/core/test/profile.test.js

@@ -1,40 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { parseProfile, parseYamlLite } from '../src/profile.js';
-import { PromptContractError } from '../src/errors.js';
-
-const SAMPLE = `---
-name: test-profile
-domain: 测试场景
-maxChars: 600
-noUnmentionedTech: true
----
-You rewrite vague requests. Preserve intent and language.`;
-
-test('parseProfile reads frontmatter scalars and body', () => {
-  const p = parseProfile(SAMPLE, { path: 'test.md' });
-  assert.equal(p.name, 'test-profile');
-  assert.equal(p.domain, '测试场景');
-  assert.equal(p.maxChars, 600);
-  assert.equal(p.noUnmentionedTech, true);
-  assert.match(p.body, /Preserve intent and language\.$/);
-});
-
-test('parseProfile applies defaults', () => {
-  const p = parseProfile('---\nname: minimal\n---\nBody here.');
-  assert.equal(p.maxChars, 800);
-  assert.equal(p.noUnmentionedTech, true);
-  assert.equal(p.domain, '');
-});
-
-test('parseProfile rejects malformed input with config_error', () => {
-  assert.throws(() => parseProfile('no frontmatter here'), (e) => e instanceof PromptContractError && e.code === 'config_error');
-  assert.throws(() => parseProfile('---\ndomain: x\n---\nbody'), (e) => e.code === 'config_error');
-});
-
-test('parseYamlLite handles string lists', () => {
-  const y = parseYamlLite('items:\n  - a\n  - b\nflag: false\ncount: 3');
-  assert.deepEqual(y.items, ['a', 'b']);
-  assert.equal(y.flag, false);
-  assert.equal(y.count, 3);
-});

package/packages/core/test/rules.test.js

@@ -1,53 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { checkRules } from '../src/rules.js';
-
-const GOOD_EN = 'Build a small responsive website showcasing one pet: a photo gallery, a biography page, and an update feed. Keep navigation simple and skip comments.';
-const GOOD_ZH = '做一个展示宠物的小型网站：包含照片画廊、简介页与动态页，导航保持单层，暂不需要评论功能。';
-
-test('good outputs pass all six assertions', () => {
-  for (const [orig, out] of [['A website for my dog', GOOD_EN], ['帮我做一个宠物网站', GOOD_ZH]]) {
-    const { pass, results } = checkRules(orig, out);
-    assert.equal(pass, true, JSON.stringify(results.filter((r) => !r.pass)));
-  }
-});
-
-test('lang-consistency fails on script switch', () => {
-  const { results } = checkRules('帮我做一个网站', GOOD_EN);
-  const r = results.find((r) => r.id === 'lang-consistency');
-  assert.equal(r.pass, false);
-});
-
-test('only-enhanced-text fails on fences, wrapping quotes and meta labels', () => {
-  for (const bad of ['```text\nx\n```', '“结果”', '增强后的提示词：写一封邮件', 'Enhanced prompt: do something']) {
-    const { results } = checkRules('写一封邮件', bad, { maxChars: 800 });
-    assert.equal(results.find((r) => r.id === 'only-enhanced-text').pass, false, bad);
-  }
-});
-
-test('length-limit fails on overflow and dangling colon', () => {
-  const long = 'x'.repeat(900);
-  const { results } = checkRules('x', long);
-  assert.equal(results.find((r) => r.id === 'length-limit').pass, false);
-  const { results: r2 } = checkRules('x', '要点如下：');
-  assert.equal(r2.find((r) => r.id === 'length-limit').pass, false);
-});
-
-test('expand-not-answer fails on answer openers and clarifying questions', () => {
-  for (const bad of ['好的，以下是实现方案：先装依赖再写组件。', "Here's how you can do it: install the deps first.", '你想用哪种框架？']) {
-    const { results } = checkRules('做个网站', bad);
-    assert.equal(results.find((r) => r.id === 'expand-not-answer').pass, false, bad);
-  }
-});
-
-test('no-hallucinated-tech flags tech names absent from input', () => {
-  const { results } = checkRules('做一个读书笔记应用', '用 React 和 PostgreSQL 构建笔记应用');
-  assert.equal(results.find((r) => r.id === 'no-hallucinated-tech').pass, false);
-  const ok = checkRules('用 React 做个笔记应用', '用 React 实现笔记的增删改查，数据存本地文件，支持全文检索');
-  assert.equal(ok.results.find((r) => r.id === 'no-hallucinated-tech').pass, true);
-});
-
-test('japanese output fails for chinese input (kana detector)', () => {
-  const { results } = checkRules('サイトを作って', '做一个展示宠物的网站：包含照片画廊。');
-  assert.equal(results.find((r) => r.id === 'lang-consistency').pass, false);
-});

package/packages/mcp-server/package.json

@@ -1,10 +0,0 @@
-{
-  "name": "@prompt-contract/mcp-server",
-  "version": "0.1.0",
-  "description": "PromptContract MCP server — enhance_prompt tool + boost-* prompts, stdio JSON-RPC, zero dependencies",
-  "type": "module",
-  "license": "Apache-2.0",
-  "bin": {
-    "prompt-contract-mcp": "./bin/prompt-contract-mcp.js"
-  }
-}

package/packages/mcp-server/test/mcp.test.js

@@ -1,167 +0,0 @@
-import { test, before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { spawn } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import { createMockServer, ZH_RESULT } from '../../../mock/server.js';
-
-let mock, base;
-const SERVER = join(dirname(fileURLToPath(import.meta.url)), '..', 'src', 'server.js');
-
-before(async () => {
-  mock = createMockServer({});
-  const port = await mock.listen();
-  base = `http://127.0.0.1:${port}`;
-});
-
-after(async () => { await mock.close(); });
-
-function startServer() {
-  const child = spawn(process.execPath, [SERVER], {
-    env: { ...process.env, CONTRACT_PROVIDER: 'openai', CONTRACT_BASE_URL: `${base}/v1`, CONTRACT_API_KEY: 'test-key-123', CONTRACT_MODEL: 'mock-model' }
-  });
-  const pending = [];
-  let buffer = '';
-  const waiters = [];
-  child.stdout.setEncoding('utf8');
-  child.stdout.on('data', (d) => {
-    buffer += d;
-    let nl;
-    while ((nl = buffer.indexOf('\n')) >= 0) {
-      const line = buffer.slice(0, nl).trim();
-      buffer = buffer.slice(nl + 1);
-      if (!line) continue;
-      const msg = JSON.parse(line);
-      const w = waiters.shift();
-      if (w) w(msg);
-      else pending.push(msg);
-    }
-  });
-  let stderr = '';
-  child.stderr.on('data', (d) => { stderr += d; });
-  const request = (obj) => new Promise((resolveReq) => {
-    const waiter = (msg) => resolveReq(msg);
-    if (pending.length) waiter(pending.shift()); else waiters.push(waiter);
-    child.stdin.write(JSON.stringify(obj) + '\n');
-  });
-  const done = () => new Promise((r) => child.on('close', r));
-  const kill = () => { child.stdin.end(); };
-  return { child, request, done, kill, getStderr: () => stderr };
-}
-
-test('MCP: initialize → tools → tool call → prompts, full handshake', async () => {
-  const s = startServer();
-  try {
-    const init = await s.request({ jsonrpc: '2.0', id: 1, method: 'initialize', params: { protocolVersion: '2025-06-18' } });
-    assert.equal(init.result.serverInfo.name, 'prompt-contract');
-    assert.ok(init.result.capabilities.tools);
-    assert.ok(init.result.capabilities.prompts);
-
-    const tools = await s.request({ jsonrpc: '2.0', id: 2, method: 'tools/list' });
-    assert.equal(tools.result.tools.length, 1);
-    assert.equal(tools.result.tools[0].name, 'enhance_prompt');
-    assert.deepEqual(tools.result.tools[0].inputSchema.required, ['text']);
-
-    const call = await s.request({
-      jsonrpc: '2.0', id: 3, method: 'tools/call',
-      params: { name: 'enhance_prompt', arguments: { text: '帮我做一个展示我家狗的网站' } }
-    });
-    assert.equal(call.result.isError, undefined);
-    assert.equal(call.result.content[0].text, ZH_RESULT);
-
-    const callProfiled = await s.request({
-      jsonrpc: '2.0', id: 4, method: 'tools/call',
-      params: { name: 'enhance_prompt', arguments: { text: 'A website for my dog', profile: 'writing', strength: 'polish' } }
-    });
-    assert.equal(callProfiled.result.isError, undefined);
-    assert.ok(callProfiled.result.content[0].text.length > 0);
-
-    const prompts = await s.request({ jsonrpc: '2.0', id: 5, method: 'prompts/list' });
-    assert.deepEqual(prompts.result.prompts.map((p) => p.name), ['contract-coding-agent', 'contract-image-gen', 'contract-writing']);
-
-    const get = await s.request({
-      jsonrpc: '2.0', id: 6, method: 'prompts/get',
-      params: { name: 'contract-writing', arguments: { text: '帮我写一封请假邮件' } }
-    });
-    const promptText = get.result.messages[0].content.text;
-    assert.match(promptText, /USER INPUT:\s*\n+帮我写一封请假邮件/);
-    assert.match(promptText, /HARD CONSTRAINTS:/);
-
-    const unknown = await s.request({ jsonrpc: '2.0', id: 7, method: 'bogus/method' });
-    assert.equal(unknown.error.code, -32601);
-
-    const badTool = await s.request({
-      jsonrpc: '2.0', id: 8, method: 'tools/call',
-      params: { name: 'enhance_prompt', arguments: { text: '' } }
-    });
-    assert.equal(badTool.result.isError, true);
-    assert.match(badTool.result.content[0].text, /empty_input/);
-  } finally {
-    s.kill();
-    await s.done();
-  }
-});
-
-test('MCP: notification messages get no response frame', async () => {
-  const s = startServer();
-  try {
-    child_notify(s);
-    const res = await s.request({ jsonrpc: '2.0', id: 100, method: 'ping' });
-    assert.deepEqual(res.result, {});
-  } finally {
-    s.kill();
-    await s.done();
-  }
-});
-
-test('MCP: zero-key startup — prompts work, tool calls report config_error honestly (R12 caveat fixed)', async () => {
-  // strip every config source so nothing can satisfy the tool mode
-  const cleanEnv = { ...process.env };
-  for (const k of Object.keys(cleanEnv)) if (k.startsWith('PB_')) delete cleanEnv[k];
-  cleanEnv.CONTRACT_CONFIG = '/tmp/definitely-missing-contract-config.json';
-  const child = spawn(process.execPath, [SERVER], { env: cleanEnv });
-  const pending = [];
-  let buffer = '';
-  child.stdout.setEncoding('utf8');
-  child.stdout.on('data', (d) => {
-    buffer += d;
-    let nl;
-    while ((nl = buffer.indexOf('\n')) >= 0) {
-      const line = buffer.slice(0, nl).trim();
-      buffer = buffer.slice(nl + 1);
-      if (line) pending.push(JSON.parse(line));
-    }
-  });
-  const request = (obj) => new Promise((resolveReq) => {
-    const check = () => {
-      if (pending.length) resolveReq(pending.shift());
-      else setTimeout(check, 20);
-    };
-    child.stdin.write(JSON.stringify(obj) + '\n');
-    check();
-  });
-  try {
-    const init = await request({ jsonrpc: '2.0', id: 1, method: 'initialize', params: {} });
-    assert.equal(init.result.serverInfo.name, 'prompt-contract');
-
-    const get = await request({
-      jsonrpc: '2.0', id: 2, method: 'prompts/get',
-      params: { name: 'contract-coding-agent', arguments: { text: '做个网站' } }
-    });
-    assert.match(get.result.messages[0].content.text, /USER INPUT:\s*\n+做个网站/);
-
-    const call = await request({
-      jsonrpc: '2.0', id: 3, method: 'tools/call',
-      params: { name: 'enhance_prompt', arguments: { text: '做个网站' } }
-    });
-    assert.equal(call.result.isError, true);
-    assert.match(call.result.content[0].text, /config_error/);
-  } finally {
-    child.stdin.end();
-    await new Promise((r) => child.on('close', r));
-  }
-});
-
-function child_notify(s) {
-  s.child.stdin.write(JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' }) + '\n');
-}

package/packages/providers/package.json

@@ -1,7 +0,0 @@
-{
-  "name": "@prompt-contract/providers",
-  "version": "0.1.0",
-  "description": "Provider adapters — OpenAI-compatible SSE and Ollama (with keep_alive model pinning). Fetch-based, browser-safe.",
-  "type": "module",
-  "license": "Apache-2.0"
-}

package/packages/providers/test/providers.test.js

@@ -1,64 +0,0 @@
-import { test, before, after } from 'node:test';
-import assert from 'node:assert/strict';
-import { createMockServer, EN_RESULT, ZH_RESULT } from '../../../mock/server.js';
-import { createOpenAIProvider } from '../src/openai.js';
-import { createOllamaProvider } from '../src/ollama.js';
-import { PromptContractError } from '../../core/src/errors.js';
-
-let mock, base;
-before(async () => {
-  mock = createMockServer({});
-  const port = await mock.listen();
-  base = `http://127.0.0.1:${port}`;
-});
-after(async () => { await mock.close(); });
-
-test('openai provider reassembles SSE chunks in order', async () => {
-  const p = createOpenAIProvider({ baseUrl: `${base}/v1`, apiKey: 'test-key-123' });
-  let deltas = 0;
-  const { text } = await p.complete({ system: 's', user: 'USER INPUT:\n帮我做一个展示我家狗的网站', model: 'mock-model', onDelta: () => deltas++ });
-  assert.equal(text, ZH_RESULT);
-  assert.ok(deltas > 3, `expected multiple deltas, got ${deltas}`);
-});
-
-test('openai provider handles english input', async () => {
-  const p = createOpenAIProvider({ baseUrl: `${base}/v1`, apiKey: 'test-key-123' });
-  const { text } = await p.complete({ system: 's', user: 'USER INPUT:\nA website for my dog', model: 'mock-model' });
-  assert.equal(text, EN_RESULT);
-});
-
-test('openai provider maps non-200 to provider_unavailable', async () => {
-  const p = createOpenAIProvider({ baseUrl: base, apiKey: 'test-key-123' }); // /chat/completions → 404
-  await assert.rejects(
-    () => p.complete({ system: 's', user: 'u', model: 'm' }),
-    (e) => e instanceof PromptContractError && e.code === 'provider_unavailable'
-  );
-});
-
-test('openai provider: caller abort cancels the stream (ADR-017)', async () => {
-  const p = createOpenAIProvider({ baseUrl: `${base}/v1`, apiKey: 'test-key-123' });
-  const ctrl = new AbortController();
-  const promise = p.complete({
-    system: 's', user: 'USER INPUT:\nA website for my dog', model: 'm',
-    signal: ctrl.signal,
-    onDelta: () => ctrl.abort()
-  });
-  await assert.rejects(promise, (e) => e.name === 'AbortError');
-  await new Promise((r) => setTimeout(r, 50));
-  assert.ok(mock.state.aborts >= 1, 'mock should have observed the aborted connection');
-});
-
-test('ollama provider sends keep_alive so the model stays warm (R10)', async () => {
-  const p = createOllamaProvider({ baseUrl: base, keepAlive: '60m' });
-  const { text } = await p.complete({ system: 's', user: 'USER INPUT:\n帮我做一个展示我家狗的网站', model: 'mock-model', maxTokens: 960 });
-  assert.equal(text, ZH_RESULT);
-  assert.equal(mock.state.lastChatBody.keep_alive, '60m');
-  assert.equal(mock.state.lastChatBody.options.num_predict, 960);
-});
-
-test('ollama warmup preloads the model via /api/generate (R10)', async () => {
-  const p = createOllamaProvider({ baseUrl: base, keepAlive: '30m' });
-  await p.warmup({ model: 'mock-model' });
-  assert.equal(mock.state.lastGenerateBody.model, 'mock-model');
-  assert.equal(mock.state.lastGenerateBody.keep_alive, '30m');
-});