prompt-contract 0.2.0 → 0.3.0

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');
-});