@hecer/yoke 0.8.0 → 1.0.0

package/package.json

@@ -1,67 +1,82 @@
-{
-  "name": "@hecer/yoke",
-  "version": "0.8.0",
-  "description": "One harness, three agents, zero trust in \"done\" — cross-agent coding harness for Claude Code, Codex CLI, and Gemini CLI: one skill canon, mechanical safety gates, an autonomous loop with screenshot/video proofs.",
-  "type": "module",
-  "bin": {
-    "yoke": "./dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "canon",
-    "bench",
-    "docs",
-    "CHANGELOG.md",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/HECer/yoke.git"
-  },
-  "homepage": "https://github.com/HECer/yoke#readme",
-  "bugs": {
-    "url": "https://github.com/HECer/yoke/issues"
-  },
-  "keywords": [
-    "claude-code",
-    "codex",
-    "gemini-cli",
-    "agents",
-    "agentic-coding",
-    "harness",
-    "autonomous",
-    "ralph-loop",
-    "code-review",
-    "skills",
-    "agents-md",
-    "tdd",
-    "claude-plugin",
-    "claude-code-plugin",
-    "gemini-cli-extension"
-  ],
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "yoke": "tsx src/cli.ts",
-    "prepublishOnly": "npm run build && vitest run"
-  },
-  "dependencies": {
-    "yaml": "^2.5.0",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/node": "^22.7.0",
-    "smol-toml": "^1.7.0",
-    "tsx": "^4.19.1",
-    "typescript": "^5.6.2",
-    "vitest": "^2.1.1"
-  }
-}
+{
+  "name": "@hecer/yoke",
+  "version": "1.0.0",
+  "description": "One harness, three agents, zero trust in \"done\" — cross-agent coding harness for Claude Code, Codex CLI, and Gemini CLI: one skill canon, mechanical safety gates, an autonomous loop with screenshot/video proofs.",
+  "type": "module",
+  "bin": {
+    "yoke": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "canon",
+    ".codex-plugin",
+    "agents",
+    "hooks",
+    "bench/README.md",
+    "bench/RESULTS.md",
+    "bench/result-schema.mjs",
+    "bench/run.mjs",
+    "bench/run-matrix.mjs",
+    "bench/fixtures",
+    "bench/results",
+    "docs",
+    "CHANGELOG.md",
+    "TODOS.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HECer/yoke.git"
+  },
+  "homepage": "https://github.com/HECer/yoke#readme",
+  "bugs": {
+    "url": "https://github.com/HECer/yoke/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "codex",
+    "gemini-cli",
+    "agents",
+    "agentic-coding",
+    "harness",
+    "autonomous",
+    "ralph-loop",
+    "code-review",
+    "skills",
+    "agents-md",
+    "tdd",
+    "claude-plugin",
+    "claude-code-plugin",
+    "gemini-cli-extension"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "docs:check": "node scripts/release-metadata.mjs --check",
+    "docs:update": "node scripts/release-metadata.mjs --write",
+    "audit:ci": "npm audit --audit-level=high",
+    "package:check": "npm pack --dry-run",
+    "yoke": "tsx src/cli.ts",
+    "prepublishOnly": "npm run lint && npm run build && vitest run && npm run docs:check && npm run package:check"
+  },
+  "dependencies": {
+    "yaml": "^2.5.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "smol-toml": "^1.7.0",
+    "tsx": "^4.19.1",
+    "typescript": "^5.6.2",
+    "vitest": "^4.1.10"
+  }
+}

package/bench/.runs/claude-2026-07-09T22-34-01/.yoke/config.yaml

@@ -1,6 +0,0 @@
-canonVersion: 0.1.0
-agents: []
-loop:
-  enabled: true
-verify:
-  command: node bench-verify.mjs

package/bench/.runs/claude-2026-07-09T22-34-01/.yoke/context/DECISIONS.md

@@ -1,9 +0,0 @@
-
-## 2026-07-09 — STORY-1: slugify(text): URL-safe slugs
-claude implemented STORY-1
-
-## 2026-07-09 — STORY-2: truncate(text, max): word-boundary truncation with ellipsis
-claude implemented STORY-2
-
-## 2026-07-09 — STORY-3: titleCase(text): English title casing
-claude implemented STORY-3

package/bench/.runs/claude-2026-07-09T22-34-01/.yoke/prd.yaml

@@ -1,38 +0,0 @@
-- id: STORY-1
-  title: "slugify(text): URL-safe slugs"
-  priority: 1
-  acceptance:
-    - Export `slugify(text)` from src/index.mjs
-    - Lowercases input and joins words with single dashes
-    - "Strips characters that are not alphanumeric, dash, or space (apostrophes
-      vanish: \"What's Up, Doc?\" -> \"whats-up-doc\")"
-    - Collapses runs of spaces/dashes into one dash; trims leading/trailing
-      dashes
-    - Input with no usable characters returns the empty string
-    - node bench-verify.mjs exits 0
-  passes: true
-- id: STORY-2
-  title: "truncate(text, max): word-boundary truncation with ellipsis"
-  priority: 2
-  acceptance:
-    - Export `truncate(text, max)` from src/index.mjs
-    - Strings with length <= max are returned unchanged
-    - Longer strings are cut at a word boundary and end with the single
-      character … (U+2026); result length never exceeds max
-    - If even the first word does not fit, hard-cut mid-word so the result
-      (incl. …) has exactly max characters
-    - max < 1 throws RangeError
-    - node bench-verify.mjs exits 0
-  passes: true
-- id: STORY-3
-  title: "titleCase(text): English title casing"
-  priority: 3
-  acceptance:
-    - Export `titleCase(text)` from src/index.mjs
-    - Capitalizes the first letter of each significant word; rest of each word
-      lowercased (handles ALL-CAPS input)
-    - Small words (a, an, the, and, but, or, for, nor, of, on, in, to, at, by,
-      up) stay lowercase mid-title
-    - The first and the last word are always capitalized, even if small
-    - node bench-verify.mjs exits 0
-  passes: true

package/bench/.runs/claude-2026-07-09T22-34-01/bench-verify.mjs

@@ -1,15 +0,0 @@
-// Cumulative verify: the loop sets YOKE_STORY (e.g. STORY-2); we run the test
-// files for that story AND all earlier ones, so later stories can't break
-// earlier work. Without YOKE_STORY (final quality check), all tests run.
-import { spawnSync } from 'node:child_process'
-
-const TOTAL = 3
-const story = process.env.YOKE_STORY
-const n = story ? Number(story.split('-')[1]) : TOTAL
-const upTo = Number.isFinite(n) && n >= 1 && n <= TOTAL ? n : TOTAL
-
-const files = []
-for (let i = 1; i <= upTo; i++) files.push(`tests/STORY-${i}.test.mjs`)
-
-const r = spawnSync(process.execPath, ['--test', ...files], { stdio: 'inherit' })
-process.exit(r.status ?? 1)

package/bench/.runs/claude-2026-07-09T22-34-01/package.json

@@ -1,9 +0,0 @@
-{
-  "name": "bench-string-kit",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "test": "node bench-verify.mjs"
-  }
-}

package/bench/.runs/claude-2026-07-09T22-34-01/src/index.mjs

@@ -1,48 +0,0 @@
-// Implement the functions required by the PRD stories here (or in modules
-// re-exported from here). Tests import from this file.
-
-export function slugify(text) {
-  return String(text)
-    .toLowerCase()
-    .replace(/[^a-z0-9\s-]/g, '')
-    .replace(/[\s-]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-}
-
-export function truncate(text, max) {
-  if (max < 1) throw new RangeError('max must be >= 1')
-
-  const str = String(text)
-  if (str.length <= max) return str
-
-  const available = max - 1 // reserve one char for the ellipsis
-  const words = str.trim().split(/\s+/)
-
-  let result = ''
-  for (const word of words) {
-    const candidate = result ? `${result} ${word}` : word
-    if (candidate.length <= available) result = candidate
-    else break
-  }
-
-  if (result === '') result = str.slice(0, available) // hard-cut mid-word
-  return `${result}…`
-}
-
-const SMALL_WORDS = new Set([
-  'a', 'an', 'the', 'and', 'but', 'or', 'for', 'nor',
-  'of', 'on', 'in', 'to', 'at', 'by', 'up',
-])
-
-export function titleCase(text) {
-  const words = String(text).trim().split(/\s+/)
-
-  return words
-    .map((word, i) => {
-      const lower = word.toLowerCase()
-      const isEdge = i === 0 || i === words.length - 1
-      if (!isEdge && SMALL_WORDS.has(lower)) return lower
-      return lower.charAt(0).toUpperCase() + lower.slice(1)
-    })
-    .join(' ')
-}

package/bench/.runs/claude-2026-07-09T22-34-01/tests/STORY-1.test.mjs

@@ -1,24 +0,0 @@
-import { test } from 'node:test'
-import assert from 'node:assert/strict'
-import { slugify } from '../src/index.mjs'
-
-test('lowercases and replaces spaces with single dashes', () => {
-  assert.equal(slugify('Hello World'), 'hello-world')
-})
-
-test('strips characters that are not alphanumeric, dash, or space', () => {
-  assert.equal(slugify("What's Up, Doc?"), 'whats-up-doc')
-})
-
-test('collapses runs of spaces/dashes into one dash', () => {
-  assert.equal(slugify('a  --  b'), 'a-b')
-})
-
-test('trims leading/trailing dashes', () => {
-  assert.equal(slugify('  hello  '), 'hello')
-  assert.equal(slugify('-hello-'), 'hello')
-})
-
-test('returns empty string for input with no usable characters', () => {
-  assert.equal(slugify('!!!'), '')
-})

package/bench/.runs/claude-2026-07-09T22-34-01/tests/STORY-2.test.mjs

@@ -1,28 +0,0 @@
-import { test } from 'node:test'
-import assert from 'node:assert/strict'
-import { truncate } from '../src/index.mjs'
-
-test('returns short strings unchanged', () => {
-  assert.equal(truncate('hello', 10), 'hello')
-})
-
-test('string of exactly max length is unchanged', () => {
-  assert.equal(truncate('exact', 5), 'exact')
-})
-
-test('truncates at a word boundary and appends a single ellipsis character', () => {
-  assert.equal(truncate('the quick brown fox', 12), 'the quick…')
-})
-
-test('result length never exceeds max', () => {
-  const out = truncate('the quick brown fox jumps', 10)
-  assert.ok(out.length <= 10, `expected <= 10, got ${out.length}: "${out}"`)
-})
-
-test('falls back to a hard cut when the first word is longer than max', () => {
-  assert.equal(truncate('extraordinary', 6), 'extra…')
-})
-
-test('throws RangeError for max < 1', () => {
-  assert.throws(() => truncate('x', 0), RangeError)
-})

package/bench/.runs/claude-2026-07-09T22-34-01/tests/STORY-3.test.mjs

@@ -1,25 +0,0 @@
-import { test } from 'node:test'
-import assert from 'node:assert/strict'
-import { titleCase } from '../src/index.mjs'
-
-test('capitalizes each significant word', () => {
-  assert.equal(titleCase('the quick brown fox'), 'The Quick Brown Fox')
-})
-
-test('keeps small words lowercase mid-title', () => {
-  assert.equal(titleCase('a tale of two cities'), 'A Tale of Two Cities')
-  assert.equal(titleCase('war and peace'), 'War and Peace')
-})
-
-test('always capitalizes the first and last word, even small ones', () => {
-  assert.equal(titleCase('of mice and men'), 'Of Mice and Men')
-  assert.equal(titleCase('what dreams may come to'), 'What Dreams May Come To')
-})
-
-test('normalizes ALL-CAPS input', () => {
-  assert.equal(titleCase('THE GREAT GATSBY'), 'The Great Gatsby')
-})
-
-test('single word is capitalized', () => {
-  assert.equal(titleCase('dune'), 'Dune')
-})

package/bench/.runs/gemini-2026-07-09T22-34-02/.yoke/config.yaml

@@ -1,6 +0,0 @@
-canonVersion: 0.1.0
-agents: []
-loop:
-  enabled: true
-verify:
-  command: node bench-verify.mjs

package/bench/.runs/gemini-2026-07-09T22-34-02/.yoke/prd.yaml

@@ -1,32 +0,0 @@
-- id: STORY-1
-  title: "slugify(text): URL-safe slugs"
-  priority: 1
-  acceptance:
-    - "Export `slugify(text)` from src/index.mjs"
-    - "Lowercases input and joins words with single dashes"
-    - "Strips characters that are not alphanumeric, dash, or space (apostrophes vanish: \"What's Up, Doc?\" -> \"whats-up-doc\")"
-    - "Collapses runs of spaces/dashes into one dash; trims leading/trailing dashes"
-    - "Input with no usable characters returns the empty string"
-    - "node bench-verify.mjs exits 0"
-  passes: false
-- id: STORY-2
-  title: "truncate(text, max): word-boundary truncation with ellipsis"
-  priority: 2
-  acceptance:
-    - "Export `truncate(text, max)` from src/index.mjs"
-    - "Strings with length <= max are returned unchanged"
-    - "Longer strings are cut at a word boundary and end with the single character … (U+2026); result length never exceeds max"
-    - "If even the first word does not fit, hard-cut mid-word so the result (incl. …) has exactly max characters"
-    - "max < 1 throws RangeError"
-    - "node bench-verify.mjs exits 0"
-  passes: false
-- id: STORY-3
-  title: "titleCase(text): English title casing"
-  priority: 3
-  acceptance:
-    - "Export `titleCase(text)` from src/index.mjs"
-    - "Capitalizes the first letter of each significant word; rest of each word lowercased (handles ALL-CAPS input)"
-    - "Small words (a, an, the, and, but, or, for, nor, of, on, in, to, at, by, up) stay lowercase mid-title"
-    - "The first and the last word are always capitalized, even if small"
-    - "node bench-verify.mjs exits 0"
-  passes: false

package/bench/.runs/gemini-2026-07-09T22-34-02/bench-verify.mjs

@@ -1,15 +0,0 @@
-// Cumulative verify: the loop sets YOKE_STORY (e.g. STORY-2); we run the test
-// files for that story AND all earlier ones, so later stories can't break
-// earlier work. Without YOKE_STORY (final quality check), all tests run.
-import { spawnSync } from 'node:child_process'
-
-const TOTAL = 3
-const story = process.env.YOKE_STORY
-const n = story ? Number(story.split('-')[1]) : TOTAL
-const upTo = Number.isFinite(n) && n >= 1 && n <= TOTAL ? n : TOTAL
-
-const files = []
-for (let i = 1; i <= upTo; i++) files.push(`tests/STORY-${i}.test.mjs`)
-
-const r = spawnSync(process.execPath, ['--test', ...files], { stdio: 'inherit' })
-process.exit(r.status ?? 1)

package/bench/.runs/gemini-2026-07-09T22-34-02/package.json

@@ -1,9 +0,0 @@
-{
-  "name": "bench-string-kit",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "test": "node bench-verify.mjs"
-  }
-}

package/bench/.runs/gemini-2026-07-09T22-34-02/src/index.mjs

@@ -1,3 +0,0 @@
-// Implement the functions required by the PRD stories here (or in modules
-// re-exported from here). Tests import from this file.
-export {}

package/bench/.runs/gemini-2026-07-09T22-34-02/tests/STORY-1.test.mjs

@@ -1,24 +0,0 @@
-import { test } from 'node:test'
-import assert from 'node:assert/strict'
-import { slugify } from '../src/index.mjs'
-
-test('lowercases and replaces spaces with single dashes', () => {
-  assert.equal(slugify('Hello World'), 'hello-world')
-})
-
-test('strips characters that are not alphanumeric, dash, or space', () => {
-  assert.equal(slugify("What's Up, Doc?"), 'whats-up-doc')
-})
-
-test('collapses runs of spaces/dashes into one dash', () => {
-  assert.equal(slugify('a  --  b'), 'a-b')
-})
-
-test('trims leading/trailing dashes', () => {
-  assert.equal(slugify('  hello  '), 'hello')
-  assert.equal(slugify('-hello-'), 'hello')
-})
-
-test('returns empty string for input with no usable characters', () => {
-  assert.equal(slugify('!!!'), '')
-})

package/bench/.runs/gemini-2026-07-09T22-34-02/tests/STORY-2.test.mjs

@@ -1,28 +0,0 @@
-import { test } from 'node:test'
-import assert from 'node:assert/strict'
-import { truncate } from '../src/index.mjs'
-
-test('returns short strings unchanged', () => {
-  assert.equal(truncate('hello', 10), 'hello')
-})
-
-test('string of exactly max length is unchanged', () => {
-  assert.equal(truncate('exact', 5), 'exact')
-})
-
-test('truncates at a word boundary and appends a single ellipsis character', () => {
-  assert.equal(truncate('the quick brown fox', 12), 'the quick…')
-})
-
-test('result length never exceeds max', () => {
-  const out = truncate('the quick brown fox jumps', 10)
-  assert.ok(out.length <= 10, `expected <= 10, got ${out.length}: "${out}"`)
-})
-
-test('falls back to a hard cut when the first word is longer than max', () => {
-  assert.equal(truncate('extraordinary', 6), 'extra…')
-})
-
-test('throws RangeError for max < 1', () => {
-  assert.throws(() => truncate('x', 0), RangeError)
-})

package/bench/.runs/gemini-2026-07-09T22-34-02/tests/STORY-3.test.mjs

@@ -1,25 +0,0 @@
-import { test } from 'node:test'
-import assert from 'node:assert/strict'
-import { titleCase } from '../src/index.mjs'
-
-test('capitalizes each significant word', () => {
-  assert.equal(titleCase('the quick brown fox'), 'The Quick Brown Fox')
-})
-
-test('keeps small words lowercase mid-title', () => {
-  assert.equal(titleCase('a tale of two cities'), 'A Tale of Two Cities')
-  assert.equal(titleCase('war and peace'), 'War and Peace')
-})
-
-test('always capitalizes the first and last word, even small ones', () => {
-  assert.equal(titleCase('of mice and men'), 'Of Mice and Men')
-  assert.equal(titleCase('what dreams may come to'), 'What Dreams May Come To')
-})
-
-test('normalizes ALL-CAPS input', () => {
-  assert.equal(titleCase('THE GREAT GATSBY'), 'The Great Gatsby')
-})
-
-test('single word is capitalized', () => {
-  assert.equal(titleCase('dune'), 'Dune')
-})