scip-query 0.19.5 → 0.19.8

package/docs/schemas/cli-output-page.schema.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/ainsleyclark/scip-query/blob/main/docs/schemas/cli-output-page.schema.json",
+  "title": "scip-query CLI output page v1",
+  "description": "A bounded, resumable page of rendered scip-query output.",
+  "type": "object",
+  "required": ["kind", "schemaVersion", "producer", "command", "contentType", "page", "content"],
+  "properties": {
+    "kind": {
+      "const": "scip-query-output-page"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "producer": {
+      "type": "object",
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "const": "scip-query"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "command": {
+      "type": "string",
+      "minLength": 1
+    },
+    "contentType": {
+      "enum": ["text/plain", "application/json"]
+    },
+    "agentInstruction": {
+      "type": "string",
+      "minLength": 1,
+      "description": "A direct evidence-completeness obligation for an AI agent consuming this page."
+    },
+    "page": {
+      "type": "object",
+      "required": [
+        "offset",
+        "returnedCharacters",
+        "totalCharacters",
+        "omittedCharacters",
+        "remainingCharacters",
+        "complete",
+        "outputHash"
+      ],
+      "properties": {
+        "offset": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "returnedCharacters": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "totalCharacters": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "omittedCharacters": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "remainingCharacters": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "complete": {
+          "type": "boolean"
+        },
+        "outputHash": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "continuation": {
+          "type": "object",
+          "required": ["cursor", "command"],
+          "properties": {
+            "cursor": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4096
+            },
+            "command": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "content": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}

package/docs/schemas/npm-release-state.schema.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/PlunderStruck/scip-query/blob/main/docs/schemas/npm-release-state.schema.json",
+  "title": "scip-query npm release state",
+  "description": "Durable local progress for one exact main-package and Windows-sidecar npm release.",
+  "type": "object",
+  "required": [
+    "kind",
+    "schemaVersion",
+    "releaseId",
+    "source",
+    "packages",
+    "completedStages",
+    "createdAt",
+    "updatedAt",
+    "writer"
+  ],
+  "properties": {
+    "kind": {
+      "const": "scip-query-npm-release-state"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "releaseId": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "source": {
+      "type": "object",
+      "required": ["gitRevision", "registry"],
+      "properties": {
+        "gitRevision": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{40,64}$"
+        },
+        "registry": {
+          "type": "string",
+          "format": "uri",
+          "pattern": "^https://",
+          "allOf": [
+            {
+              "not": {
+                "pattern": "^https://[^/]*@"
+              }
+            },
+            {
+              "not": {
+                "pattern": "[?#]"
+              }
+            }
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "packages": {
+      "type": "object",
+      "required": ["main", "sidecar"],
+      "properties": {
+        "main": {
+          "$ref": "#/$defs/packageIdentity"
+        },
+        "sidecar": {
+          "$ref": "#/$defs/packageIdentity"
+        }
+      },
+      "additionalProperties": true
+    },
+    "completedStages": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "enum": ["local-preflight-complete", "sidecar-registry-verified", "main-registry-verified"]
+      },
+      "oneOf": [
+        {
+          "const": ["local-preflight-complete"]
+        },
+        {
+          "const": ["local-preflight-complete", "sidecar-registry-verified"]
+        },
+        {
+          "const": ["local-preflight-complete", "main-registry-verified"]
+        },
+        {
+          "const": ["local-preflight-complete", "sidecar-registry-verified", "main-registry-verified"]
+        }
+      ]
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "writer": {
+      "type": "object",
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "const": "scip-query"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The main-package version that produced this state; the executable reader requires it to equal packages.main.version."
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "$defs": {
+    "packageIdentity": {
+      "type": "object",
+      "required": ["name", "version", "size", "shasum", "integrity"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "shasum": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{40}$"
+        },
+        "integrity": {
+          "type": "string",
+          "pattern": "^sha512-[A-Za-z0-9+/]+={0,2}$"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/docs/schemas/outcome-event-record.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/scip-query/docs/schemas/outcome-event-record.schema.json",
+  "title": "scip-query outcome event record v1",
+  "description": "One immutable repository-owned finding transition stored under .scipquery/events/.",
+  "type": "object",
+  "required": ["kind", "schemaVersion", "eventIdentity", "writer", "ts", "check", "findingId", "event", "commit"],
+  "properties": {
+    "kind": { "const": "scip-query-outcome-event" },
+    "schemaVersion": { "const": 1 },
+    "eventIdentity": { "type": "string", "minLength": 1 },
+    "writer": {
+      "type": "object",
+      "required": ["tool", "version"],
+      "properties": {
+        "tool": { "const": "scip-query" },
+        "version": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": true
+    },
+    "ts": { "type": "number" },
+    "check": { "type": "string", "minLength": 1 },
+    "findingId": { "type": "string", "minLength": 1 },
+    "event": { "enum": ["caught", "resolved", "suppressed", "reopened"] },
+    "commit": {
+      "oneOf": [{ "type": "string" }, { "type": "null" }]
+    },
+    "comparisonBaseCommit": { "type": "string" },
+    "verifiedAgainstCommit": { "type": "string" },
+    "symbol": { "type": "string" }
+  },
+  "allOf": [
+    {
+      "if": { "required": ["verifiedAgainstCommit"] },
+      "then": { "properties": { "event": { "const": "resolved" } } }
+    }
+  ],
+  "additionalProperties": true
+}

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
+}