patchdrill 0.1.0

package/fixtures/stacks/uv-python-service/fixture.json

@@ -0,0 +1,47 @@
+{
+  "name": "uv-python-service",
+  "expectedEcosystems": ["python"],
+  "expectedCommands": [
+    "uv run pytest tests/test_service.py",
+    "python -m compileall .",
+    "uv run ruff check .",
+    "uv run mypy .",
+    "uv run pyright"
+  ],
+  "baseFiles": [
+    {
+      "path": "pyproject.toml",
+      "lines": [
+        "[project]",
+        "dependencies = [\"pytest\", \"ruff\", \"mypy\", \"pyright\"]",
+        "",
+        "[tool.ruff]",
+        "line-length = 120",
+        "",
+        "[tool.mypy]",
+        "strict = true",
+        "",
+        "[tool.pyright]",
+        "typeCheckingMode = \"strict\""
+      ]
+    },
+    {
+      "path": "uv.lock",
+      "lines": []
+    },
+    {
+      "path": "app/service.py",
+      "lines": ["def ok():", "    return True"]
+    },
+    {
+      "path": "tests/test_service.py",
+      "lines": ["def test_ok():", "    assert True"]
+    }
+  ],
+  "changeFiles": [
+    {
+      "path": "app/service.py",
+      "lines": ["def ok():", "    return False"]
+    }
+  ]
+}

package/fixtures/stacks/xcode-app/fixture.json

@@ -0,0 +1,72 @@
+{
+  "name": "xcode-app",
+  "expectedEcosystems": ["xcode"],
+  "expectedCommands": [
+    "xcodebuild -project App.xcodeproj -scheme App -testPlan AppTests test",
+    "xcodebuild -project App.xcodeproj -scheme App -showdestinations",
+    "xcodebuild -project App.xcodeproj -scheme App -destination generic/platform=iOS build"
+  ],
+  "baseFiles": [
+    {
+      "path": "App.xcodeproj/project.pbxproj",
+      "lines": [
+        "// !$*UTF8*$!",
+        "{",
+        "  objects = {",
+        "    APP_TARGET /* App */ = {",
+        "      isa = PBXNativeTarget;",
+        "      buildConfigurationList = APP_CONFIGS /* Build configuration list for PBXNativeTarget App */;",
+        "      productType = \"com.apple.product-type.application\";",
+        "    };",
+        "    APP_CONFIGS /* Build configuration list for PBXNativeTarget App */ = {",
+        "      isa = XCConfigurationList;",
+        "      buildConfigurations = (",
+        "        APP_DEBUG /* Debug */,",
+        "      );",
+        "    };",
+        "    APP_DEBUG /* Debug */ = {",
+        "      isa = XCBuildConfiguration;",
+        "      buildSettings = {",
+        "        SDKROOT = iphoneos;",
+        "        SUPPORTED_PLATFORMS = \"iphoneos iphonesimulator\";",
+        "      };",
+        "    };",
+        "  };",
+        "}"
+      ]
+    },
+    {
+      "path": "App.xcodeproj/xcshareddata/xcschemes/App.xcscheme",
+      "lines": [
+        "<Scheme LastUpgradeVersion=\"1600\" version=\"1.7\">",
+        "  <BuildAction>",
+        "    <BuildActionEntries>",
+        "      <BuildActionEntry>",
+        "        <BuildableReference BlueprintIdentifier=\"APP_TARGET\" ReferencedContainer=\"container:App.xcodeproj\" />",
+        "      </BuildActionEntry>",
+        "    </BuildActionEntries>",
+        "  </BuildAction>",
+        "  <TestAction>",
+        "    <TestPlans>",
+        "      <TestPlanReference reference=\"container:AppTests.xctestplan\" default=\"YES\" />",
+        "    </TestPlans>",
+        "  </TestAction>",
+        "</Scheme>"
+      ]
+    },
+    {
+      "path": "AppTests/AppTests.xctestplan",
+      "lines": ["{", "  \"version\": 1", "}"]
+    },
+    {
+      "path": "App/ContentView.swift",
+      "lines": ["import SwiftUI", "struct ContentView: View {", "  var body: some View { Text(\"Hello\") }", "}"]
+    }
+  ],
+  "changeFiles": [
+    {
+      "path": "App/ContentView.swift",
+      "lines": ["import SwiftUI", "struct ContentView: View {", "  var body: some View { Text(\"Hello, PatchDrill\") }", "}"]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "patchdrill",
+  "version": "0.1.0",
+  "description": "A deterministic proof layer for verifying AI-generated and human patches before merge.",
+  "type": "module",
+  "bin": {
+    "patchdrill": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "schemas",
+    "docs",
+    "examples",
+    "fixtures",
+    ".patchdrill.yml",
+    "README.md",
+    "LICENSE",
+    "action.yml",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.eslint.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:fast": "vitest run --exclude tests/dependency.test.ts --exclude tests/fixtures.test.ts --exclude tests/scan.test.ts",
+    "test:integration": "vitest run tests/dependency.test.ts tests/fixtures.test.ts tests/scan.test.ts",
+    "test:coverage": "vitest run --coverage",
+    "check": "npm run build && npm run typecheck && npm run lint && npm test",
+    "prepare": "npm run build",
+    "prepack": "npm run check"
+  },
+  "keywords": [
+    "ai-coding",
+    "ci",
+    "developer-tools",
+    "git",
+    "code-review",
+    "testing",
+    "agentic-coding",
+    "evidence",
+    "sarif",
+    "codeowners",
+    "monorepo",
+    "turborepo",
+    "nx",
+    "supply-chain",
+    "github-actions"
+  ],
+  "author": "PatchDrill contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seungdori/patchdrill.git"
+  },
+  "bugs": {
+    "url": "https://github.com/seungdori/patchdrill/issues"
+  },
+  "homepage": "https://github.com/seungdori/patchdrill#readme",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "4.1.8",
+    "ajv": "^8.20.0",
+    "eslint": "10.4.1",
+    "globals": "17.6.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "8.60.1",
+    "vitest": "^4.1.8"
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
+  }
+}

package/schemas/patchdrill-doctor.schema.json

@@ -0,0 +1,171 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchdrill.dev/schemas/patchdrill-doctor.schema.json",
+  "title": "PatchDrill Doctor Report",
+  "description": "Machine-readable repository readiness diagnostics emitted by PatchDrill doctor --format json.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "root", "summary", "projectSignals", "checks", "suggestedCommands"],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "1"
+    },
+    "root": {
+      "type": "string"
+    },
+    "summary": {
+      "$ref": "#/$defs/doctorSummary"
+    },
+    "projectSignals": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/projectSignal"
+      }
+    },
+    "checks": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/doctorCheck"
+      }
+    },
+    "suggestedCommands": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "$defs": {
+    "doctorStatus": {
+      "type": "string",
+      "enum": ["pass", "warn", "info"]
+    },
+    "doctorSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "ok", "passCount", "warnCount", "infoCount", "projectSignalCount"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["pass", "warn"]
+        },
+        "ok": {
+          "type": "boolean"
+        },
+        "passCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "warnCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "infoCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "projectSignalCount": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "doctorCheck": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "title", "detail"],
+      "properties": {
+        "status": {
+          "$ref": "#/$defs/doctorStatus"
+        },
+        "title": {
+          "type": "string"
+        },
+        "detail": {
+          "type": "string"
+        },
+        "remediation": {
+          "type": "string"
+        }
+      }
+    },
+    "ecosystem": {
+      "type": "string",
+      "enum": ["node", "python", "rust", "go", "java", "android", "ruby", "php", "dotnet", "swift", "xcode", "terraform", "docker", "kubernetes", "bazel", "buck", "pants", "github-actions", "unknown"]
+    },
+    "workspacePackage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "path", "scripts"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "projectName": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "scripts": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "targets": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "projectSignal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ecosystem", "manifestPath"],
+      "properties": {
+        "ecosystem": {
+          "$ref": "#/$defs/ecosystem"
+        },
+        "manifestPath": {
+          "type": "string"
+        },
+        "framework": {
+          "type": "string",
+          "enum": ["django", "fastapi", "spring-boot", "rails", "laravel", "aspnet-core"]
+        },
+        "entrypoint": {
+          "type": "string"
+        },
+        "packageManager": {
+          "type": "string"
+        },
+        "taskRunner": {
+          "type": "string",
+          "enum": ["turbo", "nx"]
+        },
+        "scripts": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "workspacePackages": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/workspacePackage"
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/patchdrill-evidence.schema.json

@@ -0,0 +1,239 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchdrill.dev/schemas/patchdrill-evidence.schema.json",
+  "title": "PatchDrill Evidence Manifest",
+  "description": "Audit manifest emitted by PatchDrill scan --evidence with report, artifact, and command-output digests.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "tool",
+    "root",
+    "git",
+    "summary",
+    "report",
+    "artifacts",
+    "commands"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "tool": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "reportSchemaVersion"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "const": "patchdrill"
+        },
+        "reportSchemaVersion": {
+          "type": "string",
+          "const": "1"
+        },
+        "version": {
+          "type": "string"
+        }
+      }
+    },
+    "root": {
+      "type": "string"
+    },
+    "base": {
+      "type": "string"
+    },
+    "head": {
+      "type": "string"
+    },
+    "git": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "branch": {
+          "type": "string"
+        },
+        "headSha": {
+          "$ref": "#/$defs/sha1"
+        },
+        "baseSha": {
+          "$ref": "#/$defs/sha1"
+        }
+      }
+    },
+    "summary": {
+      "$ref": "#/$defs/patchSummary"
+    },
+    "report": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sha256", "bytes", "findingCount", "commandPlanCount", "commandResultCount"],
+      "properties": {
+        "sha256": {
+          "$ref": "#/$defs/sha256"
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "findingCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "commandPlanCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "commandResultCount": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/artifact"
+      }
+    },
+    "commands": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/command"
+      }
+    }
+  },
+  "$defs": {
+    "sha1": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{40}$"
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "patchStatus": {
+      "type": "string",
+      "enum": ["pass", "warn", "fail"]
+    },
+    "patchSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "riskScore",
+        "confidenceScore",
+        "changedFileCount",
+        "additions",
+        "deletions",
+        "requiredCommandCount",
+        "failedCommandCount"
+      ],
+      "properties": {
+        "status": {
+          "$ref": "#/$defs/patchStatus"
+        },
+        "riskScore": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "confidenceScore": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "changedFileCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "additions": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "deletions": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "requiredCommandCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "failedCommandCount": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "path", "sha256", "bytes"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": ["summary-markdown", "markdown", "json", "sarif", "html"]
+        },
+        "path": {
+          "type": "string"
+        },
+        "sha256": {
+          "$ref": "#/$defs/sha256"
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "digest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sha256", "bytes"],
+      "properties": {
+        "sha256": {
+          "$ref": "#/$defs/sha256"
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "command": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "command", "exitCode", "durationMs", "stdout", "stderr"],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "command": {
+          "type": "string"
+        },
+        "exitCode": {
+          "type": "integer"
+        },
+        "durationMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "timedOut": {
+          "type": "boolean"
+        },
+        "stdout": {
+          "$ref": "#/$defs/digest"
+        },
+        "stderr": {
+          "$ref": "#/$defs/digest"
+        }
+      }
+    }
+  }
+}