codebaseiq 0.1.0 → 0.2.0

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

@@ -39,6 +39,8 @@
       },
       "description": "Resident query execution settings."
     },
+    "builder": { "$ref": "#/$defs/builder" },
+    "sentinel": { "$ref": "#/$defs/sentinel" },
     "indexer": {
       "type": "object",
       "propertyNames": { "$ref": "#/$defs/supportedLanguage" },
@@ -313,6 +315,163 @@
       "properties": {
         "snapshotPaths": { "$ref": "#/$defs/stringArray" }
       }
+    },
+    "builderEmbeddingsEndpoint": {
+      "type": "object",
+      "required": ["name", "baseUrl", "model"],
+      "additionalProperties": true,
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_.-]{1,64}$"
+        },
+        "baseUrl": {
+          "type": "string",
+          "pattern": "^https?://"
+        },
+        "model": {
+          "type": "string",
+          "minLength": 1
+        },
+        "queryPrefix": {
+          "type": "string"
+        },
+        "documentPrefix": {
+          "type": "string"
+        },
+        "healthTimeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "warmTimeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "requestTimeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "batchSize": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "dimensions": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "apiKeyEnv": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Name of the environment variable holding a bearer token. Ignored in the committed config; set it in .codebaseiq.local.json."
+        },
+        "allowRemote": {
+          "type": "boolean",
+          "description": "Permit a host outside loopback and private networks. Ignored in the committed config; set it in .codebaseiq.local.json."
+        }
+      }
+    },
+    "builderAgentCommand": {
+      "type": "object",
+      "required": ["name", "argv"],
+      "additionalProperties": true,
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[A-Za-z0-9_.-]{1,64}$"
+        },
+        "argv": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          },
+          "description": "Command line without a shell. {schemaJson}, {schemaFile}, and {outputFile} may appear only as whole arguments."
+        },
+        "timeoutMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "maxOutputBytes": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        }
+      }
+    },
+    "builder": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Symbol builder settings. Per-developer endpoints, credentials, and agent commands belong in .codebaseiq.local.json, whose builder block overrides this one.",
+      "properties": {
+        "mode": {
+          "enum": ["agent", "embeddings", "auto"]
+        },
+        "chain": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^(embeddings|agent):[A-Za-z0-9_.-]{1,64}$"
+          },
+          "description": "Ordered provider references such as embeddings:homelab or agent:claude."
+        },
+        "embeddings": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "endpoints": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/builderEmbeddingsEndpoint"
+              }
+            },
+            "indexBudgetMs": {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            "minCoverage": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "maxCardChars": {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            },
+            "topBandMargin": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            }
+          }
+        },
+        "agent": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "commands": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/builderAgentCommand"
+              },
+              "description": "Ignored in the committed config; set it in .codebaseiq.local.json."
+            },
+            "cacheTtlHours": {
+              "type": "integer",
+              "exclusiveMinimum": 0
+            }
+          }
+        }
+      }
+    },
+    "sentinel": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Trailing sentinel for agent sessions. Delivery mode and mute state are per-user and not committed.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Run the trailing sentinel for agent sessions in this project (default: false)."
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebaseiq",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Evidence and verification for AI coding agents: map code, reuse concepts, finish migrations, and gate diffs.",
   "repository": {
     "type": "git",
@@ -29,7 +29,8 @@
     "scripts/codebaseiq-windows-provenance.mjs",
     "scripts/verify-codebaseiq-windows.mjs",
     "skills/**/*.md",
-    "skills/**/agents/*.yaml"
+    "skills/**/agents/*.yaml",
+    "ui/view/**/*"
   ],
   "sideEffects": false,
   "exports": {
@@ -370,8 +371,8 @@
   "scripts": {
     "build": "node --max-old-space-size=12288 ./node_modules/tsup/dist/cli-default.js",
     "dev": "tsup --watch",
-    "format": "prettier --write \"{src,tests,scripts}/**/*.{ts,tsx,js,mjs,json}\" \"*.{ts,js,json}\"",
-    "format:check": "prettier --check \"{src,tests,scripts}/**/*.{ts,tsx,js,mjs,json}\" \"*.{ts,js,json}\"",
+    "format": "prettier --write \"{src,tests,scripts}/**/*.{ts,tsx,js,mjs,json}\" \"ui/view/**/*.{js,css,html}\" \"*.{ts,js,json}\"",
+    "format:check": "prettier --check \"{src,tests,scripts}/**/*.{ts,tsx,js,mjs,json}\" \"ui/view/**/*.{js,css,html}\" \"*.{ts,js,json}\"",
     "test": "vitest run",
     "soak:cache-lifecycle": "npm run build && vite-node scripts/cache-lifecycle-soak.ts",
     "test:watch": "vitest",
@@ -380,7 +381,7 @@
     "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/audit-production-dependencies.mjs scripts/build-codebaseiq-windows.mjs scripts/cache-lifecycle-soak.ts scripts/codex-exploration-sandbox.mjs scripts/codex-exploration-trial-core.mjs scripts/codex-exploration-trial.mjs scripts/compare-exploration-trials.mjs scripts/exploration-benchmark-core.mjs scripts/exploration-benchmark.mjs scripts/npm-release-state.ts scripts/npm-release.ts scripts/publish-codebaseiq-windows.ts scripts/release-npm-guard.ts scripts/release-npm.ts scripts/codebaseiq-windows-package-identity.ts scripts/codebaseiq-windows-provenance.mjs scripts/codebaseiq-windows-release.ts scripts/verify-identity-collision-cli.mjs scripts/verify-codebaseiq-windows.mjs scripts/verify-codebaseiq-windows-registry.ts && npm run api:check && node scripts/check-skill-links.mjs",
+    "lint": "npm run format:check && eslint src tests ui/view tsup.config.ts scripts/api-surface-contract.mjs scripts/audit-production-dependencies.mjs scripts/build-codebaseiq-windows.mjs scripts/cache-lifecycle-soak.ts scripts/codex-exploration-sandbox.mjs scripts/codex-exploration-trial-core.mjs scripts/codex-exploration-trial.mjs scripts/compare-exploration-trials.mjs scripts/exploration-benchmark-core.mjs scripts/exploration-benchmark.mjs scripts/npm-release-state.ts scripts/npm-release.ts scripts/publish-codebaseiq-windows.ts scripts/release-npm-guard.ts scripts/release-npm.ts scripts/codebaseiq-windows-package-identity.ts scripts/codebaseiq-windows-provenance.mjs scripts/codebaseiq-windows-release.ts scripts/verify-identity-collision-cli.mjs scripts/verify-codebaseiq-windows.mjs scripts/verify-codebaseiq-windows-registry.ts && npm run api:check && node scripts/check-skill-links.mjs",
     "build:codebaseiq-windows": "node scripts/build-codebaseiq-windows.mjs",
     "verify:codebaseiq-windows": "node scripts/verify-codebaseiq-windows.mjs",
     "verify:identity-collision-cli": "node scripts/verify-identity-collision-cli.mjs",
@@ -391,6 +392,8 @@
     "bench:exploration:compare": "node scripts/compare-exploration-trials.mjs",
     "bench:native-symbol-leaf": "node scripts/bench-native-symbol-leaf.mjs",
     "calibrate": "node scripts/accuracy-calibration.mjs",
+    "calibrate:sentinel": "vite-node scripts/sentinel-replay.ts",
+    "calibrate:sentinel-review": "vite-node scripts/sentinel-shadow-review.ts",
     "docs:commands": "vite-node scripts/render-command-reference.ts --write",
     "prepublishOnly": "vite-node scripts/release-npm-guard.ts",
     "postinstall": "node dist/postinstall.js || true",
@@ -427,6 +430,7 @@
     "better-sqlite3": "^13.0.2",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
+    "cytoscape": "^3.34.3",
     "ignore": "^7.0.3",
     "ts-morph": "^28.0.0"
   },

package/skills/codebaseiq/SKILL.md

@@ -72,4 +72,4 @@ Read request, observed facts, calibration, coverage, and recovery together. A co
 
 Before answering, compare the draft to the selected statement-complete behavior—not merely to a remembered narrative. Preserve every observed behavior-changing predicate, returned default, separately merged field, cache invalidation, and cleanup effect that is material to the question. When two named fields use different merge or lifecycle operations, do not collapse them into a generic word such as “properties.” If the evidence already contains a missing detail, repair the answer; do not reopen exploration.
 
-Use codebaseiq rather than a parallel grep/read workflow for tracked text. Native tools are for edits, checks, binary content, or an explicitly reported unsupported gap. After edits, use `diff-impact` when consumers matter, `architecture` for declared boundaries, and `health` for quality or cleanup analysis.
+Use codebaseiq rather than a parallel grep/read workflow for tracked text. Native tools are for edits, checks, binary content, or an explicitly reported unsupported gap. After edits, use `diff-impact` when consumers matter, `architecture` for declared boundaries, and `health` for quality or cleanup analysis. Before adding a new helper, run `codebaseiq reuse` with `--term`, `--name`, and `--calls` probes you choose; its results are heuristic candidates to confirm with `code` or `evidence`, not exact facts.

package/skills/concrete-plan/SKILL.md

@@ -67,7 +67,7 @@ Include this section only when an unknown can change the implementation. Name th
 ## Required reasoning
 
 - Cite direct evidence for each changed owner and material consumer.
-- Compare an existing reuse candidate before adding a new helper, wrapper, hook, component, or module.
+- Compare an existing reuse candidate before adding a new helper, wrapper, hook, component, or module; `codebaseiq reuse` with probes you choose lists candidates to confirm with `code`.
 - Name behavior that must remain true.
 - Name residue that the change must remove.
 - Include architecture rules that constrain dependency direction.