auditor-lambda 0.1.0 → 0.2.2

package/docs/windows-setup.md

@@ -5,142 +5,142 @@ This document covers Windows setup for the backend fallback `audit-code` wrapper
 The canonical product route is still `/audit-code` in conversation.
 
 ## Simplest path
-
-From the target repository root in PowerShell:
-
-```powershell
-audit-code
-```
-
-This is the lowest-friction path.
-
-Use it with the default backend:
-
-```json
-{
-  "provider": "local-subprocess",
-  "ui_mode": "visible"
-}
-```
-
-## Claude Code on Windows
-
-If `claude` is on `PATH`, use:
-
-```json
-{
-  "provider": "claude-code",
-  "ui_mode": "visible",
-  "claude_code": {
-    "command": "claude",
-    "extra_args": []
-  }
-}
-```
-
-If you want to force a model:
-
-```json
-{
-  "provider": "claude-code",
-  "ui_mode": "visible",
-  "claude_code": {
-    "command": "claude",
-    "extra_args": ["--model", "sonnet"]
-  }
-}
-```
-
-## OpenCode on Windows
-
-If `opencode` is on `PATH`, use:
-
-```json
-{
-  "provider": "opencode",
-  "ui_mode": "visible",
-  "opencode": {
-    "command": "opencode",
-    "extra_args": []
-  }
-}
-```
-
-If you want to force a provider/model pair:
-
-```json
-{
-  "provider": "opencode",
-  "ui_mode": "visible",
-  "opencode": {
-    "command": "opencode",
-    "extra_args": ["--model", "anthropic/claude-sonnet-4.5"]
-  }
-}
-```
-
-## Generic PowerShell bridge
-
-When you need a provider-neutral launcher from Windows, use a PowerShell template bridge.
-
-Example:
-
-```json
-{
-  "provider": "subprocess-template",
-  "ui_mode": "visible",
-  "subprocess_template": {
-    "command_template": [
-      "pwsh",
-      "-NoProfile",
-      "-ExecutionPolicy",
-      "Bypass",
-      "-Command",
-      "& { {workerCommandShell} }"
-    ]
-  }
-}
-```
-
-If `pwsh` is not installed, replace it with `powershell`.
-
-## VS Code on Windows
-
-The simplest VS Code path is still the integrated terminal.
-
-Open the target repository in VS Code and run:
-
-```powershell
-audit-code
-```
-
-Use a `vscode-task` template only if you specifically need a task-oriented launcher boundary.
-
-Example:
-
-```json
-{
-  "provider": "vscode-task",
-  "ui_mode": "visible",
-  "vscode_task": {
-    "command_template": [
-      "pwsh",
-      "-NoProfile",
-      "-ExecutionPolicy",
-      "Bypass",
-      "-Command",
-      "& { {workerCommandShell} }"
-    ]
-  }
-}
-```
-
-## Antigravity on Windows
-
-There is no dedicated Antigravity provider adapter in this repository today.
-
-The recommended practical path is:
-
-- run `audit-code` from an Antigravity terminal
-- use `local-subprocess` first
-- move to `subprocess-template` only if a launcher bridge is actually needed
+
+From the target repository root in PowerShell:
+
+```powershell
+audit-code
+```
+
+This is the lowest-friction path.
+
+Use it with the default backend:
+
+```json
+{
+  "provider": "local-subprocess",
+  "ui_mode": "visible"
+}
+```
+
+## Claude Code on Windows
+
+If `claude` is on `PATH`, use:
+
+```json
+{
+  "provider": "claude-code",
+  "ui_mode": "visible",
+  "claude_code": {
+    "command": "claude",
+    "extra_args": []
+  }
+}
+```
+
+If you want to force a model:
+
+```json
+{
+  "provider": "claude-code",
+  "ui_mode": "visible",
+  "claude_code": {
+    "command": "claude",
+    "extra_args": ["--model", "sonnet"]
+  }
+}
+```
+
+## OpenCode on Windows
+
+If `opencode` is on `PATH`, use:
+
+```json
+{
+  "provider": "opencode",
+  "ui_mode": "visible",
+  "opencode": {
+    "command": "opencode",
+    "extra_args": []
+  }
+}
+```
+
+If you want to force a provider/model pair:
+
+```json
+{
+  "provider": "opencode",
+  "ui_mode": "visible",
+  "opencode": {
+    "command": "opencode",
+    "extra_args": ["--model", "anthropic/claude-sonnet-4.5"]
+  }
+}
+```
+
+## Generic PowerShell bridge
+
+When you need a provider-neutral launcher from Windows, use a PowerShell template bridge.
+
+Example:
+
+```json
+{
+  "provider": "subprocess-template",
+  "ui_mode": "visible",
+  "subprocess_template": {
+    "command_template": [
+      "pwsh",
+      "-NoProfile",
+      "-ExecutionPolicy",
+      "Bypass",
+      "-Command",
+      "& { {workerCommandShell} }"
+    ]
+  }
+}
+```
+
+If `pwsh` is not installed, replace it with `powershell`.
+
+## VS Code on Windows
+
+The simplest VS Code path is still the integrated terminal.
+
+Open the target repository in VS Code and run:
+
+```powershell
+audit-code
+```
+
+Use a `vscode-task` template only if you specifically need a task-oriented launcher boundary.
+
+Example:
+
+```json
+{
+  "provider": "vscode-task",
+  "ui_mode": "visible",
+  "vscode_task": {
+    "command_template": [
+      "pwsh",
+      "-NoProfile",
+      "-ExecutionPolicy",
+      "Bypass",
+      "-Command",
+      "& { {workerCommandShell} }"
+    ]
+  }
+}
+```
+
+## Antigravity on Windows
+
+There is no dedicated Antigravity provider adapter in this repository today.
+
+The recommended practical path is:
+
+- run `audit-code` from an Antigravity terminal
+- use `local-subprocess` first
+- move to `subprocess-template` only if a launcher bridge is actually needed

package/package.json

@@ -1,56 +1,56 @@
-{
-  "name": "auditor-lambda",
-  "version": "0.1.0",
-  "private": false,
-  "description": "Portable hybrid code-auditing framework for arbitrary repositories.",
-  "type": "module",
-  "bin": {
-    "audit-code": "audit-code.mjs"
-  },
-  "files": [
-    "dist/**",
-    "audit-code.mjs",
-    "audit-code-wrapper-lib.mjs",
-    "schemas/**",
-    "skills/audit-code/**",
-    "README.md",
-    "docs/**"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "check": "tsc -p tsconfig.json --noEmit",
-    "test": "npm run build && node --test tests/*.test.mjs",
-    "verify:release": "npm run check && npm test && npm run smoke:linked-audit-code && npm run smoke:packaged-audit-code",
-    "smoke:linked-audit-code": "node scripts/smoke-linked-audit-code.mjs",
-    "smoke:packaged-audit-code": "node scripts/smoke-packaged-audit-code.mjs",
-    "prepack": "npm run build",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run verify:release",
-    "start": "node dist/index.js",
-    "audit-code": "node audit-code.mjs",
-    "sample-run": "node dist/index.js sample-run"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/EthanBerlant/auditor-lambda.git"
-  },
-  "homepage": "https://github.com/EthanBerlant/auditor-lambda#readme",
-  "bugs": {
-    "url": "https://github.com/EthanBerlant/auditor-lambda/issues"
-  },
-  "keywords": [
-    "audit",
-    "cli",
-    "code-audit",
-    "static-analysis",
-    "orchestration",
-    "agents"
-  ],
-  "devDependencies": {
-    "@types/node": "^24.3.0",
-    "typescript": "^5.9.2"
-  }
-}
+{
+  "name": "auditor-lambda",
+  "version": "0.2.2",
+  "private": false,
+  "description": "Portable hybrid code-auditing framework for arbitrary repositories.",
+  "type": "module",
+  "bin": {
+    "audit-code": "audit-code.mjs"
+  },
+  "files": [
+    "dist/**",
+    "audit-code.mjs",
+    "audit-code-wrapper-lib.mjs",
+    "schemas/**",
+    "skills/audit-code/**",
+    "README.md",
+    "docs/**"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "verify:release": "npm run check && npm test && npm run smoke:linked-audit-code && npm run smoke:packaged-audit-code",
+    "smoke:linked-audit-code": "node scripts/smoke-linked-audit-code.mjs",
+    "smoke:packaged-audit-code": "node scripts/smoke-packaged-audit-code.mjs",
+    "prepack": "npm run build",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run verify:release",
+    "start": "node dist/index.js",
+    "audit-code": "node audit-code.mjs",
+    "sample-run": "node dist/index.js sample-run"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OhOkThisIsFine/auditor-lambda.git"
+  },
+  "homepage": "https://github.com/OhOkThisIsFine/auditor-lambda#readme",
+  "bugs": {
+    "url": "https://github.com/OhOkThisIsFine/auditor-lambda/issues"
+  },
+  "keywords": [
+    "audit",
+    "cli",
+    "code-audit",
+    "static-analysis",
+    "orchestration",
+    "agents"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2"
+  }
+}

package/schemas/audit-code-v1alpha1.schema.json

@@ -1,79 +1,81 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://example.invalid/schemas/audit-code-v1alpha1.schema.json",
-  "title": "audit-code wrapper output v1alpha1",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "contract_version",
-    "audit_state",
-    "selected_obligation",
-    "selected_executor",
-    "progress_made",
-    "artifacts_written",
-    "progress_summary",
-    "next_likely_step"
-  ],
-  "properties": {
-    "contract_version": {
-      "const": "audit-code/v1alpha1"
-    },
-    "audit_state": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["status", "obligations"],
-      "properties": {
-        "status": {
-          "enum": ["not_started", "active", "blocked", "complete"]
-        },
-        "last_executor": {
-          "type": "string"
-        },
-        "last_obligation": {
-          "type": "string"
-        },
-        "blockers": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "obligations": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "additionalProperties": false,
-            "required": ["id", "state"],
-            "properties": {
-              "id": {
-                "type": "string"
-              },
-              "state": {
-                "enum": ["missing", "present", "stale", "blocked", "satisfied"]
-              },
-              "reason": {
-                "type": "string"
-              }
-            }
-          }
-        }
-      }
-    },
-    "selected_obligation": {
-      "type": ["string", "null"]
-    },
-    "selected_executor": {
-      "type": ["string", "null"]
-    },
-    "progress_made": {
-      "type": "boolean"
-    },
-    "artifacts_written": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.invalid/schemas/audit-code-v1alpha1.schema.json",
+  "title": "audit-code wrapper output v1alpha1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contract_version",
+    "audit_state",
+    "selected_obligation",
+    "selected_executor",
+    "progress_made",
+    "artifacts_written",
+    "progress_summary",
+    "next_likely_step"
+  ],
+  "properties": {
+    "contract_version": {
+      "const": "audit-code/v1alpha1"
+    },
+    "audit_state": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "obligations"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["not_started", "active", "blocked", "complete"]
+        },
+        "last_executor": {
+          "type": "string"
+        },
+        "last_obligation": {
+          "type": "string"
+        },
+        "blockers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "obligations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "state"],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "state": {
+                "type": "string",
+                "enum": ["missing", "present", "stale", "blocked", "satisfied"]
+              },
+              "reason": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "selected_obligation": {
+      "type": ["string", "null"]
+    },
+    "selected_executor": {
+      "type": ["string", "null"]
+    },
+    "progress_made": {
+      "type": "boolean"
+    },
+    "artifacts_written": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
     "progress_summary": {
       "type": "string"
     },
@@ -97,6 +99,7 @@
       ],
       "properties": {
         "status": {
+          "type": "string",
           "enum": ["not_started", "active", "blocked", "complete"]
         },
         "repo_root": {
@@ -125,6 +128,7 @@
             "required": ["flag", "suggested_path", "description"],
             "properties": {
               "flag": {
+                "type": "string",
                 "enum": [
                   "--results",
                   "--updates",

package/schemas/audit_result.schema.json

@@ -1,48 +1,54 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "audit_result.schema.json",
-  "title": "Audit Result",
-  "type": "object",
-  "required": [
-    "task_id",
-    "unit_id",
-    "pass_id",
-    "lens",
-    "reviewed_ranges",
-    "findings"
-  ],
-  "properties": {
-    "task_id": { "type": "string" },
-    "unit_id": { "type": "string" },
-    "pass_id": { "type": "string" },
-    "lens": { "type": "string" },
-    "agent_role": { "type": "string" },
-    "reviewed_ranges": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["path", "start", "end"],
-        "properties": {
-          "path": { "type": "string" },
-          "start": { "type": "integer" },
-          "end": { "type": "integer" }
-        },
-        "additionalProperties": false
-      }
-    },
-    "findings": {
-      "type": "array",
-      "items": { "$ref": "finding.schema.json" }
-    },
-    "notes": {
-      "type": "array",
-      "items": { "type": "string" }
-    },
-    "requires_followup": { "type": "boolean" },
-    "followup_tasks": {
-      "type": "array",
-      "items": { "type": "string" }
-    }
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "audit_result.schema.json",
+  "title": "Audit Result",
+  "type": "object",
+  "required": [
+    "task_id",
+    "unit_id",
+    "pass_id",
+    "lens",
+    "reviewed_ranges",
+    "findings"
+  ],
+  "$defs": {
+    "Finding": {
+      "$ref": "finding.schema.json"
+    }
+  },
+  "properties": {
+    "task_id": { "type": "string" },
+    "unit_id": { "type": "string" },
+    "pass_id": { "type": "string" },
+    "lens": { "type": "string" },
+    "agent_role": { "type": "string" },
+    "reviewed_ranges": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["path", "start", "end"],
+        "properties": {
+          "path": { "type": "string" },
+          "start": { "type": "integer" },
+          "end": { "type": "integer" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/Finding" }
+    },
+    "notes": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "requires_followup": { "type": "boolean" },
+    "followup_tasks": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": false
+}