scip-query 0.19.4 → 0.19.6

package/docs/schemas/project-config.schema.json

@@ -0,0 +1,247 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/scip-query/docs/schemas/project-config.schema.json",
+  "title": "scip-query project configuration",
+  "description": "Repository-owned indexing, watch, architecture, documentation, and detector policy. Unknown fields are retained for forward-compatible rewrites.",
+  "type": "object",
+  "required": ["schemaVersion"],
+  "additionalProperties": true,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Editor schema hint. scip-query writers default this to the schema bundled in node_modules."
+    },
+    "schemaVersion": {
+      "const": 2,
+      "description": "Persisted project-config format version. Unversioned and explicit version 1 records are readable legacy input."
+    },
+    "languages": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/supportedLanguage" }
+    },
+    "indexerConcurrency": { "type": "integer", "minimum": 1 },
+    "watch": { "$ref": "#/$defs/watch" },
+    "hooks": { "$ref": "#/$defs/hooks" },
+    "indexer": {
+      "type": "object",
+      "propertyNames": { "$ref": "#/$defs/supportedLanguage" },
+      "additionalProperties": { "$ref": "#/$defs/indexerOverride" }
+    },
+    "dbPath": { "type": "string", "minLength": 1 },
+    "entryRoots": { "$ref": "#/$defs/entryRoots" },
+    "semantic": { "$ref": "#/$defs/semantic" },
+    "suppressions": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/suppression" }
+    },
+    "declaredCouplings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/declaredCoupling" }
+    },
+    "locality": { "$ref": "#/$defs/locality" },
+    "architecture": { "$ref": "#/$defs/architecture" },
+    "coverageContracts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/coverageContract" }
+    },
+    "docs": { "$ref": "#/$defs/docs" }
+  },
+  "$defs": {
+    "supportedLanguage": {
+      "enum": [
+        "typescript",
+        "javascript",
+        "java",
+        "scala",
+        "kotlin",
+        "rust",
+        "python",
+        "ruby",
+        "go",
+        "cpp",
+        "c",
+        "csharp",
+        "vb",
+        "dart",
+        "php",
+        "clojure"
+      ]
+    },
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "watch": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "debounceMs": { "type": "integer", "exclusiveMinimum": 0 },
+        "cooldownMs": { "type": "integer", "minimum": 0 },
+        "gitPollMs": { "type": "integer", "exclusiveMinimum": 0 },
+        "idleTimeoutMs": { "type": "integer", "minimum": 0 },
+        "autoRefresh": { "type": "boolean" },
+        "ignore": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "hooks": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "router": { "enum": ["off", "single"] }
+      }
+    },
+    "indexerOverride": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "pnpmWorkspaces": { "type": "boolean" },
+        "projectMode": { "enum": ["single", "workspace"] },
+        "projects": { "$ref": "#/$defs/stringArray" },
+        "configPath": { "type": "string", "minLength": 1 }
+      }
+    },
+    "entryRoots": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "pathPrefixes": { "$ref": "#/$defs/stringArray" },
+        "files": { "$ref": "#/$defs/stringArray" },
+        "symbolPatterns": { "$ref": "#/$defs/stringArray" },
+        "qualifiedVars": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "semantic": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "typescript": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "tsconfigs": { "$ref": "#/$defs/stringArray" }
+          }
+        },
+        "rust": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "rustAnalyzerPath": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "suppression": {
+      "type": "object",
+      "required": ["reason"],
+      "additionalProperties": true,
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "check": { "type": "string", "minLength": 1 },
+        "file": { "type": "string", "minLength": 1 },
+        "reason": { "type": "string", "minLength": 1 },
+        "expiresAt": { "type": "string", "format": "date-time" },
+        "createdAt": { "type": "string", "format": "date-time" }
+      },
+      "anyOf": [{ "required": ["id"] }, { "required": ["check"] }]
+    },
+    "declaredCoupling": {
+      "type": "object",
+      "required": ["name", "files"],
+      "additionalProperties": true,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "files": {
+          "type": "array",
+          "minItems": 2,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "reason": { "type": "string" }
+      }
+    },
+    "locality": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "architecturalBoundarySegments": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "architectureBoundary": {
+      "type": "object",
+      "required": ["name", "paths"],
+      "additionalProperties": true,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "paths": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "maxFiles": { "type": "integer", "minimum": 1 },
+        "subUnits": { "enum": ["directory", "file"] }
+      }
+    },
+    "architecture": {
+      "type": "object",
+      "required": ["boundaries"],
+      "additionalProperties": true,
+      "properties": {
+        "boundaries": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/architectureBoundary" }
+        },
+        "allowedDependencies": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/stringArray" }
+        },
+        "requireCompletePolicy": { "type": "boolean" },
+        "requireAcyclic": { "type": "boolean" },
+        "requireResolvedBoundaries": { "type": "boolean" },
+        "requireMinimalPolicy": { "type": "boolean" },
+        "maxBoundaryFanOut": { "type": "integer", "minimum": 0 },
+        "maxBoundaryFiles": { "type": "integer", "minimum": 1 },
+        "testPaths": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "coverageContract": {
+      "type": "object",
+      "required": ["name", "file", "keys", "mustEqual"],
+      "additionalProperties": true,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "file": { "type": "string", "minLength": 1 },
+        "keys": {
+          "type": "object",
+          "required": ["type"],
+          "additionalProperties": true,
+          "properties": {
+            "type": { "enum": ["object-literal-keys", "string-array", "markdown-list"] },
+            "identifier": { "type": "string", "minLength": 1 },
+            "marker": { "type": "string", "minLength": 1 }
+          }
+        },
+        "mustEqual": {
+          "type": "object",
+          "required": ["type"],
+          "additionalProperties": true,
+          "properties": {
+            "type": { "enum": ["top-level-dirs", "file-glob", "registered-commands", "builtin-skills"] },
+            "path": { "type": "string", "minLength": 1 },
+            "pattern": { "type": "string", "minLength": 1 }
+          }
+        },
+        "allowExtra": { "type": "boolean" }
+      }
+    },
+    "docs": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "snapshotPaths": { "$ref": "#/$defs/stringArray" }
+      }
+    }
+  }
+}

package/docs/schemas/suppression-record.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/scip-query/docs/schemas/suppression-record.schema.json",
+  "title": "scip-query suppression record v1",
+  "description": "A repository-owned policy decision stored as one file under .scipquery/suppressions/.",
+  "type": "object",
+  "required": ["kind", "schemaVersion", "suppressionIdentity", "writer", "reason", "createdAt"],
+  "properties": {
+    "kind": { "const": "scip-query-suppression" },
+    "schemaVersion": { "const": 1 },
+    "suppressionIdentity": { "type": "string", "minLength": 1 },
+    "writer": {
+      "type": "object",
+      "required": ["tool", "version"],
+      "properties": {
+        "tool": { "const": "scip-query" },
+        "version": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": true
+    },
+    "id": { "type": "string", "minLength": 1 },
+    "check": { "type": "string", "minLength": 1 },
+    "file": { "type": "string", "minLength": 1 },
+    "reason": { "type": "string", "minLength": 1 },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "anyOf": [{ "required": ["id"] }, { "required": ["check"] }],
+  "additionalProperties": true
+}

package/docs/schemas/windows-sidecar-provenance.schema.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/PlunderStruck/scip-query/blob/main/docs/schemas/windows-sidecar-provenance.schema.json",
+  "title": "scip-query Windows sidecar provenance",
+  "type": "object",
+  "required": ["kind", "schemaVersion", "package", "source", "toolchain", "build", "binaries"],
+  "properties": {
+    "kind": {
+      "const": "scip-query-windows-sidecar-provenance"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "package": {
+      "type": "object",
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "const": "scip-query-scip-windows"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": true
+    },
+    "source": {
+      "type": "object",
+      "required": ["repository", "tag", "commit"],
+      "properties": {
+        "repository": {
+          "type": "string",
+          "minLength": 1
+        },
+        "tag": {
+          "type": "string",
+          "minLength": 1
+        },
+        "commit": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{40}$"
+        }
+      },
+      "additionalProperties": true
+    },
+    "toolchain": {
+      "type": "object",
+      "required": ["goVersion"],
+      "properties": {
+        "goVersion": {
+          "type": "string",
+          "pattern": "^go[0-9]+\\.[0-9]+"
+        }
+      },
+      "additionalProperties": true
+    },
+    "build": {
+      "type": "object",
+      "required": ["command", "package", "flags", "environment"],
+      "properties": {
+        "command": {
+          "const": "go build"
+        },
+        "package": {
+          "const": "./cmd/scip"
+        },
+        "flags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "environment": {
+          "type": "object",
+          "required": ["CGO_ENABLED", "GOOS"],
+          "properties": {
+            "CGO_ENABLED": {
+              "const": "0"
+            },
+            "GOOS": {
+              "const": "windows"
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
+    },
+    "binaries": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 2,
+      "items": {
+        "type": "object",
+        "required": ["filename", "target", "size", "sha256", "peMachine", "peMachineCode"],
+        "properties": {
+          "filename": {
+            "enum": ["scip-win32-x64.exe", "scip-win32-arm64.exe"]
+          },
+          "target": {
+            "type": "object",
+            "required": ["goos", "goarch", "packageArch"],
+            "properties": {
+              "goos": {
+                "const": "windows"
+              },
+              "goarch": {
+                "enum": ["amd64", "arm64"]
+              },
+              "packageArch": {
+                "enum": ["x64", "arm64"]
+              }
+            },
+            "additionalProperties": true
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "sha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "peMachine": {
+            "enum": ["AMD64", "ARM64"]
+          },
+          "peMachineCode": {
+            "enum": ["0x8664", "0xaa64"]
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scip-query",
-  "version": "0.19.4",
+  "version": "0.19.6",
   "description": "Evidence and verification for AI coding agents: map code, reuse concepts, finish migrations, and gate diffs.",
   "type": "module",
   "main": "dist/index.js",
@@ -13,9 +13,12 @@
     "dist/**/*.js",
     "dist/**/*.d.ts",
     "docs/assets/**/*",
+    "docs/schemas/**/*",
     "docs/*.md",
     "scripts/build-scip-windows.mjs",
     "scripts/evidence-product-contract.mjs",
+    "scripts/scip-windows-provenance.mjs",
+    "scripts/verify-scip-windows.mjs",
     "skills/**/*.md",
     "skills/**/agents/*.yaml"
   ],
@@ -318,15 +321,22 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "lint": "npm run format:check && eslint src tests tsup.config.ts && node scripts/check-skill-links.mjs",
+    "api:report": "node scripts/api-surface-contract.mjs report",
+    "api:check": "npm run build && node scripts/api-surface-contract.mjs check && tsc -p tests/fixtures/public-api-consumer/tsconfig.json",
+    "api:update": "npm run build && node scripts/api-surface-contract.mjs update",
+    "lint": "npm run format:check && eslint src tests tsup.config.ts scripts/api-surface-contract.mjs scripts/build-scip-windows.mjs scripts/npm-release-state.ts scripts/npm-release.ts scripts/publish-scip-windows.ts scripts/release-npm-guard.ts scripts/release-npm.ts scripts/scip-windows-package-identity.ts scripts/scip-windows-provenance.mjs scripts/scip-windows-release.ts scripts/verify-scip-windows.mjs scripts/verify-scip-windows-registry.ts && npm run api:check && node scripts/check-skill-links.mjs",
     "build:scip-windows": "node scripts/build-scip-windows.mjs",
+    "verify:scip-windows": "node scripts/verify-scip-windows.mjs",
+    "verify:scip-windows-registry": "vite-node scripts/verify-scip-windows-registry.ts",
     "bench:evidence-products": "node scripts/evidence-product-contract.mjs",
     "bench:native-symbol-leaf": "node scripts/bench-native-symbol-leaf.mjs",
     "calibrate": "node scripts/accuracy-calibration.mjs",
     "docs:commands": "vite-node scripts/render-command-reference.ts --write",
-    "prepublishOnly": "vite-node scripts/publish-scip-windows.ts && npm run build",
+    "prepublishOnly": "vite-node scripts/release-npm-guard.ts",
     "postinstall": "node dist/postinstall.js || true",
-    "publish:scip-windows": "vite-node scripts/publish-scip-windows.ts"
+    "publish:scip-windows": "vite-node scripts/publish-scip-windows.ts",
+    "release:npm": "vite-node scripts/release-npm.ts",
+    "release:npm:dry-run": "vite-node scripts/release-npm.ts --dry-run"
   },
   "keywords": [
     "scip",
@@ -364,7 +374,7 @@
   "optionalDependencies": {
     "@sourcegraph/scip-typescript": "^0.4.0",
     "scip-python-plus": "^0.7.4",
-    "scip-query-scip-windows": "0.13.0",
+    "scip-query-scip-windows": "0.13.1",
     "tree-sitter": "0.21.1",
     "tree-sitter-c": "0.23.2",
     "tree-sitter-c-sharp": "0.23.1",