agentskeptic 6.0.0 → 6.0.1

package/dist/execution-identity.v1.json

@@ -4,7 +4,7 @@
   "identityVersion": "1.0.0",
   "mergeGateFingerprintSha256": "64b5ae2ed5025c08c7c9d7b601958cc90edc32c0d80ea207fdaa373de5b9c2fc",
   "nodeEnginesDeclared": "22.x || 24.x",
-  "npmPackageVersion": "6.0.0",
+  "npmPackageVersion": "6.0.1",
   "pythonPipExtrasFragment": "dev,postgres",
   "verificationContractManifest": {
     "manifestSha256": "c5f23ec43576716c4b9a13e752cd2962a78bb4b4da1f9e521f911e15dfd80268",

package/dist/publicDistribution.generated.d.ts

@@ -1,5 +1,5 @@
 export declare const PUBLIC_DISTRIBUTION_SSOT_BLOB_URL = "https://github.com/jwekavanagh/agentskeptic/blob/main/docs/public-distribution.md";
 export declare const PUBLIC_CANONICAL_SITE_ORIGIN = "https://agentskeptic.com";
-export declare const AGENTSKEPTIC_CLI_SEMVER = "6.0.0";
+export declare const AGENTSKEPTIC_CLI_SEMVER = "6.0.1";
 export declare function formatDistributionFooter(): string;
 //# sourceMappingURL=publicDistribution.generated.d.ts.map

package/dist/publicDistribution.generated.js

@@ -1,7 +1,7 @@
 // Generated by npm run emit-primary-marketing — do not hand edit.
 export const PUBLIC_DISTRIBUTION_SSOT_BLOB_URL = "https://github.com/jwekavanagh/agentskeptic/blob/main/docs/public-distribution.md";
 export const PUBLIC_CANONICAL_SITE_ORIGIN = "https://agentskeptic.com";
-export const AGENTSKEPTIC_CLI_SEMVER = "6.0.0";
+export const AGENTSKEPTIC_CLI_SEMVER = "6.0.1";
 export function formatDistributionFooter() {
     return "Context: https://agentskeptic.com/database-truth-vs-traces\n"
         + "https://agentskeptic.com/integrate\n"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentskeptic",
-  "version": "6.0.0",
+  "version": "6.0.1",
   "description": "Structured tool activity vs downstream state at verify time: SQL (SQLite, Postgres, MySQL), HTTP witnesses, supported vector indexes, MongoDB documents, and S3-compatible objects when configured—deterministic verdict artifacts (see verification-state-stores.md).",
   "license": "MIT",
   "type": "module",

package/schemas/openapi-commercial-v1.yaml

@@ -1,7 +1,7 @@
 openapi: "3.0.3"
 info:
   title: AgentSkeptic commercial license API
-  version: "6.0.0"
+  version: "6.0.1"
   contact:
     url: https://agentskeptic.com
   x-agentskeptic-distribution:

package/scripts/emit-primary-marketing.cjs

@@ -178,6 +178,42 @@ Normative **public distribution** and anchor sync: [\`docs/public-distribution.m
 - Verification Contract Manifest (repo raw): ${contractRaw}
 - Acquisition page (canonical): ${acquisitionUrl}
 - CI regeneration + drift pathspecs: [\`schemas/ci/verification-truth.manifest.json\`](schemas/ci/verification-truth.manifest.json) (validated by [\`test/verification-truth.closed-drift.contract.test.mjs\`](test/verification-truth.closed-drift.contract.test.mjs))
+
+## Cursor Cloud specific instructions
+
+### Architecture
+
+This is an npm workspace monorepo with two packages:
+- **Root** (\`agentskeptic\`): Core verification library + CLI. Framework-agnostic Node.js, ESM, TypeScript.
+- **\`website/\`** (\`agentskeptic-web\`): Next.js 16 commercial SaaS app (Auth, Stripe, API keys, verification demo).
+
+### Prerequisites
+
+- **Node.js 22.x** (required by \`engines\` field). Install via nvm: \`nvm install 22\`.
+- **PostgreSQL 16** with two databases: \`wfv_website\` (core) and \`wfv_telemetry\` (telemetry).
+- The env file at \`website/.env\` (gitignored) must have \`DATABASE_URL\` and \`TELEMETRY_DATABASE_URL\` pointing to local Postgres. See \`website/.env.example\` for all variables.
+
+### Common commands
+
+| Task | Command | Notes |
+|------|---------|-------|
+| Install deps | \`npm install\` (repo root) | Installs root + website workspace |
+| Build core | \`npm run build\` | TypeScript compile + asset generation |
+| Run demo | \`npm start\` | Builds then runs bundled wf_complete/wf_missing verification |
+| Website dev | \`npm run dev\` (repo root) | Delegates to \`next dev --turbopack\` in website workspace |
+| Core vitest | \`npx vitest run\` (repo root) | Runs \`src/**/*.test.ts\` and \`test/**/*.test.ts\` |
+| SQLite tests | \`npm run test:node:sqlite\` | Builds first, then runs node:test suite (fast, no Postgres) |
+| Website vitest | \`npm run test:vitest -w agentskeptic-web\` | Needs \`DATABASE_URL\` + \`TELEMETRY_DATABASE_URL\` |
+| Full CI gate | \`npm test\` (or \`npm run verification:truth\`) | Requires Postgres; see \`docs/testing.md\` |
+| DB migrate | \`npm run db:migrate\` / \`npm run db:migrate:telemetry\` (from \`website/\`) | Requires \`DATABASE_URL\`/\`TELEMETRY_DATABASE_URL\` in env or \`website/.env\` |
+
+### Gotchas
+
+- \`npm run build\` must complete before the CLI (\`node dist/cli.js\`) or website demo API (\`/api/verify\`) work.
+- The website migration scripts (\`db-migrate.mjs\`) load \`website/.env\` but only for keys not already in \`process.env\`. If env vars are not exported in the shell, the \`.env\` file must exist.
+- The commit hook (\`.husky/commit-msg\`) runs \`commitlint\` for Conventional Commits. Use \`--no-verify\` to skip if needed, but CI enforces the same rules on PRs.
+- PostgreSQL must be running before migrations or website dev. Start with: \`pg_ctlcluster 16 main start\`.
+- \`src/planTransition.test.ts\` has a known timeout-sensitive integration test that may flake in resource-constrained environments. This is pre-existing, not a setup issue.
 `;
   writeFileSync(join(ROOT, "AGENTS.md"), body, "utf8");
 }