@agentskit/code-review 0.1.0 → 0.4.2

package/llms.txt

@@ -0,0 +1,24 @@
+AgentsKit Code Review is a pre-v1 provider-neutral CLI and GitHub Action for low-noise review using seven lenses and adversarial verification. It intentionally has no Fumadocs site or embedded chat.
+
+## Documentation surfaces
+
+- Full corpus: llms-full.txt
+- Public README: https://github.com/AgentsKit-io/code-review#readme
+- Operations: docs/OPERATIONS.md
+- For agents: docs/for-agents/index.md
+- Raw sources: https://raw.githubusercontent.com/AgentsKit-io/code-review/main/
+
+## AgentsKit ecosystem
+
+- AgentsKit: https://www.agentskit.io/docs
+- Registry: https://registry.agentskit.io/docs
+- AgentsKit Chat: https://chat.agentskit.io/docs
+- Playbook: https://playbook.agentskit.io/docs
+- Doc Bridge: https://agentskit-io.github.io/doc-bridge/
+- Code Review: https://github.com/AgentsKit-io/code-review#readme
+- AKOS: https://akos.agentskit.io/docs
+
+## Knowledge
+
+- [Code Review CLI handoff](docs/for-agents/code-review-cli.md): Provider-neutral, low-noise AI code review for local Git diffs, files/stdin, and GitHub pull requests. Seven focused lenses propose findings; adversarial votes remove weak findings; reporters emit Markdown, GitHub reviews, and SARIF.
+- [Code Review agent docs](docs/for-agents/index.md): - Code Review CLI handoff — ownership, change routes, security boundaries, and verification: https://raw.githubusercontent.com/AgentsKit-io/code-review/main/docs/for-agents/code-review-cli.md - Concise machine map — discovery, raw sources, and all seven ecosystem products: https://raw.githubusercontent.com/AgentsKit-io/code-review/main/llms.txt - Full machine corpus — public, operational,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/code-review",
-  "version": "0.1.0",
+  "version": "0.4.2",
   "type": "module",
   "description": "Provider-agnostic, low-noise AI code review for local development and GitHub Actions.",
   "license": "MIT",
@@ -10,14 +10,44 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "AGENTS.md",
+    ".pre-commit-hooks.yaml",
+    "action.yml",
+    "examples/pull-request.yml",
+    "SECURITY.md",
+    "CONTRIBUTING.md",
+    "ROADMAP.md",
+    "CHANGELOG.md",
+    "doc-bridge.config.json",
+    ".doc-bridge/index.json",
+    ".doc-bridge/capabilities.json",
+    "ecosystem.json",
+    "ecosystem-claims.json",
+    "llms.txt",
+    "llms-full.txt",
+    "docs/OPERATIONS.md",
+    "docs/provider-compatibility.json",
+    "docs/for-agents",
+    "docs/plans",
+    "docs/assets",
+    "docs/continuous-improvement.md",
+    "test/cli-smoke.test.mjs",
+    "test/continuous-improvement.test.mjs",
+    "test/documentation.test.mjs",
+    "test/release-workflow.test.mjs",
+    "scripts/generate-llms-full.mjs",
+    "scripts/run-cycle-benchmark.mjs"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/AgentsKit-io/code-review-cli.git"
+    "url": "git+https://github.com/AgentsKit-io/code-review.git"
+  },
+  "homepage": "https://github.com/AgentsKit-io/code-review#readme",
+  "bugs": "https://github.com/AgentsKit-io/code-review/issues",
+  "publishConfig": {
+    "access": "public"
   },
-  "homepage": "https://github.com/AgentsKit-io/code-review-cli#readme",
-  "bugs": "https://github.com/AgentsKit-io/code-review-cli/issues",
   "keywords": [
     "ai-code-review",
     "code-review",
@@ -29,9 +59,20 @@
     "review": "tsx src/cli.ts",
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
-    "check": "npm run typecheck && npm run build && node dist/src/cli.js --help",
+    "test": "npm run build && node --test --test-concurrency=1 test/*.test.mjs",
+    "benchmark:cycle": "npm run build && node scripts/run-cycle-benchmark.mjs",
+    "docs:full": "node scripts/generate-llms-full.mjs",
+    "docs:index": "ak-docs index && npm run docs:full",
+    "docs:gate": "ak-docs gate run && ak-docs conformance run documentation-standard-v1 --text && node scripts/generate-llms-full.mjs --check && node --test test/documentation.test.mjs",
+    "docs:doctor": "ak-docs doctor --text",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "check": "npm run typecheck && npm run test && npm run docs:gate && node dist/src/cli.js --help && npm run check:readme-standard",
     "prepare": "npm run build",
-    "prepack": "npm run build"
+    "prepack": "npm run build && npm run docs:gate",
+    "check:readme-standard": "node scripts/check-readme-standard.mjs",
+    "test:readme-standard": "node --test scripts/readme-standard.test.mjs",
+    "readme:standard:refresh": "node scripts/refresh-readme-standard.mjs"
   },
   "dependencies": {
     "@agentskit/adapters": "^0.12.2",
@@ -42,7 +83,12 @@
     "zod": "^3.25.0",
     "zod-to-json-schema": "^3.24.0"
   },
+  "optionalDependencies": {
+    "@agentskit/doc-bridge": "^1.1.1"
+  },
   "devDependencies": {
+    "@changesets/changelog-github": "^0.7.0",
+    "@changesets/cli": "^2.31.0",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^22.10.0",
     "tsx": "^4.19.0",

package/scripts/generate-llms-full.mjs

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const outputPath = resolve(root, 'llms-full.txt')
+const rawBase = 'https://raw.githubusercontent.com/AgentsKit-io/code-review/main/'
+const blobBase = 'https://github.com/AgentsKit-io/code-review/blob/main/'
+const sources = [
+  ['Public README', 'README.md'],
+  ['Operations guide', 'docs/OPERATIONS.md'],
+  ['Agent documentation index', 'docs/for-agents/index.md'],
+  ['Code Review agent handoff', 'docs/for-agents/code-review-cli.md'],
+  ['Security policy', 'SECURITY.md'],
+  ['Contributing guide', 'CONTRIBUTING.md'],
+  ['Roadmap', 'ROADMAP.md'],
+  ['Changelog', 'CHANGELOG.md'],
+]
+
+const rebaseRelativeLinks = (markdown, sourcePath) => markdown
+  .replace(
+    /!\[([^\]]*)\]\((?!https?:\/\/|mailto:|#)([^)]+)\)/g,
+    (_match, alt, target) => `![${alt}](${new URL(target, `${rawBase}${sourcePath}`).href})`,
+  )
+  .replace(
+    /\]\((?!https?:\/\/|mailto:|#)([^)]+)\)/g,
+    (_match, target) => `](${new URL(target, `${blobBase}${sourcePath}`).href})`,
+  )
+
+const ecosystem = JSON.parse(readFileSync(resolve(root, 'ecosystem.json'), 'utf8'))
+const productLines = ecosystem.products
+  .sort((left, right) => left.navigation.order - right.navigation.order)
+  .map((product) => `- ${product.name}: ${product.surfaces.docs ?? product.surfaces.home}`)
+
+const sections = sources.map(([title, path]) => [
+  `## ${title}`,
+  '',
+  `Canonical source: ${rawBase}${path}`,
+  '',
+  rebaseRelativeLinks(readFileSync(resolve(root, path), 'utf8').trim(), path),
+].join('\n'))
+
+const content = [
+  '# AgentsKit Code Review — full documentation corpus',
+  '',
+  'Generated from the public repository documentation. Prefer llms.txt for concise discovery and this file only when the full operating and ownership context is required.',
+  '',
+  '## AgentsKit ecosystem',
+  '',
+  ...productLines,
+  '',
+  ...sections,
+  '',
+].join('\n')
+
+if (process.argv.includes('--check')) {
+  const current = readFileSync(outputPath, 'utf8')
+  if (current !== content) {
+    console.error('llms-full.txt is stale; run npm run docs:full')
+    process.exit(1)
+  }
+  console.log('llms-full.txt is fresh.')
+} else {
+  writeFileSync(outputPath, content)
+  console.log(`Generated llms-full.txt from ${sources.length} canonical sources.`)
+}

package/scripts/run-cycle-benchmark.mjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process'
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const fixtureBin = join(root, 'test/fixtures/bin')
+const workdir = mkdtempSync(join(tmpdir(), 'agentskit-review-cycle-'))
+const source = 'export const answer = 42\n'
+
+function runCase(id, options = {}) {
+  const result = join(workdir, `${id}.json`)
+  const startedAt = Date.now()
+  const run = spawnSync(process.execPath, [
+    'dist/src/cli.js', '--provider', 'codex-cli', '--stdin', '--lang', 'ts',
+    '--profile', options.profile ?? 'full', '--health-check', 'off', '--deadline-ms', options.deadlineMs ?? '3000',
+    '--result', result, '--no-fail',
+  ], {
+    cwd: root, input: source, encoding: 'utf8', timeout: 10_000,
+    env: { ...process.env, ...options.env, PATH: `${fixtureBin}:${process.env.PATH ?? ''}` },
+  })
+  let artifact
+  let artifactError
+  try { artifact = JSON.parse(readFileSync(result, 'utf8')) } catch (error) { artifactError = error instanceof Error ? error.message : String(error) }
+  return {
+    id, exitCode: run.status, elapsedMs: Date.now() - startedAt,
+    artifact: artifact && {
+      verdict: artifact.verdict, blocking: artifact.blocking, incomplete: artifact.incomplete,
+      execution: artifact.execution, evidence: artifact.evidence,
+    },
+    stderr: run.stderr.trim(),
+    artifactError,
+  }
+}
+
+function requireCase(condition, message) {
+  if (!condition) throw new Error(`cycle benchmark failed: ${message}`)
+}
+
+try {
+  const cases = [
+    runCase('clean'),
+    runCase('required-lens-failure', { env: { CODEX_FIXTURE_FAIL_CATEGORY: 'security' } }),
+    runCase('deadline', { profile: 'fast', deadlineMs: '50', env: { CODEX_FIXTURE_HANG: '1' } }),
+  ]
+  const [clean, lensFailure, deadline] = cases
+  requireCase(clean.exitCode === 0 && clean.artifact?.verdict === 'APPROVE' && clean.artifact?.incomplete === false, 'clean review must complete as APPROVE')
+  requireCase(
+    Number.isInteger(clean.artifact?.execution?.attempted) &&
+      Number.isInteger(clean.artifact?.execution?.succeeded) &&
+      clean.artifact.execution.attempted > 0 &&
+      clean.artifact.execution.succeeded === clean.artifact.execution.attempted,
+    'clean review must retain complete execution evidence',
+  )
+  requireCase(lensFailure.exitCode === 2 && lensFailure.artifact?.incomplete === true, 'required lens failure must fail closed with an artifact')
+  requireCase((lensFailure.artifact?.execution?.failed ?? 0) > 0, 'required lens failure must retain failed-call evidence')
+  requireCase(deadline.exitCode === 2 && deadline.artifact?.incomplete === true && deadline.artifact?.blocking === true, 'deadline must create a blocking incomplete artifact')
+  requireCase(deadline.artifact?.evidence?.deadlineExceeded === true, 'deadline must retain deadline evidence')
+  process.stdout.write(`${JSON.stringify({ version: 1, cases }, null, 2)}\n`)
+} finally {
+  rmSync(workdir, { recursive: true, force: true })
+}