audrey 0.23.1 → 1.0.1

package/benchmarks/output/adapter-self-test/guardbench-adapter-self-test.json

@@ -0,0 +1,50 @@
+{
+  "schemaVersion": "1.0.0",
+  "suite": "GuardBench adapter self-test",
+  "generatedAt": "2026-05-15T17:52:20.717Z",
+  "ok": true,
+  "adapter": {
+    "name": "Example Allow Adapter",
+    "path": "benchmarks/adapters/example-allow.mjs",
+    "moduleFile": "example-allow.mjs",
+    "description": "Credential-free GuardBench adapter example. It always allows and is useful for adapter-loading smoke tests."
+  },
+  "conformance": {
+    "ok": true,
+    "adapter": "Example Allow Adapter",
+    "requestedAdapter": "Example Allow Adapter",
+    "scenarios": 10,
+    "expectedScenarios": 10,
+    "fullContractPassRate": 0.1,
+    "decisionAccuracy": 0.1,
+    "redactionLeaks": 0,
+    "failures": []
+  },
+  "score": {
+    "scenarios": 10,
+    "fullContractPassRate": 0.1,
+    "decisionAccuracy": 0.1,
+    "evidenceRecall": 0.1,
+    "redactionLeaks": 0,
+    "latency": {
+      "p50Ms": 0.009,
+      "p95Ms": 0.032,
+      "maxMs": 0.032
+    }
+  },
+  "contract": {
+    "expectedAnswersWithheld": true,
+    "lowScoreAllowed": true,
+    "requiredScenarioRows": 10,
+    "requiredResultFields": [
+      "decision",
+      "riskScore",
+      "evidenceIds",
+      "recommendedActions",
+      "summary",
+      "recallErrors"
+    ],
+    "redactionLeakTolerance": 0
+  },
+  "failures": []
+}

package/benchmarks/output/external/guardbench-external-dry-run.json

@@ -0,0 +1,69 @@
+{
+  "schemaVersion": "1.0.0",
+  "suite": "GuardBench external adapter dry-run matrix",
+  "generatedAt": "2026-05-15T17:52:21.145Z",
+  "ok": true,
+  "registry": "benchmarks/adapters/registry.json",
+  "outRoot": "benchmarks/output/external",
+  "adapters": [
+    {
+      "id": "mem0-platform",
+      "name": "Mem0 Platform",
+      "credentialMode": "runtime-env",
+      "requiredEnv": [
+        "MEM0_API_KEY"
+      ],
+      "missingEnv": [
+        "MEM0_API_KEY"
+      ],
+      "status": "dry-run-missing-env",
+      "command": [
+        "node",
+        "benchmarks/guardbench.js",
+        "--adapter",
+        "benchmarks/adapters/mem0-platform.mjs",
+        "--out-dir",
+        "benchmarks/output/external/mem0-platform",
+        "--check",
+        "--json"
+      ],
+      "validationCommand": [
+        "node",
+        "benchmarks/validate-guardbench-artifacts.mjs",
+        "--dir",
+        "benchmarks/output/external/mem0-platform"
+      ],
+      "metadataPath": "benchmarks/output/external/mem0-platform/external-run-metadata.json"
+    },
+    {
+      "id": "zep-cloud",
+      "name": "Zep Cloud",
+      "credentialMode": "runtime-env",
+      "requiredEnv": [
+        "ZEP_API_KEY"
+      ],
+      "missingEnv": [
+        "ZEP_API_KEY"
+      ],
+      "status": "dry-run-missing-env",
+      "command": [
+        "node",
+        "benchmarks/guardbench.js",
+        "--adapter",
+        "benchmarks/adapters/zep-cloud.mjs",
+        "--out-dir",
+        "benchmarks/output/external/zep-cloud",
+        "--check",
+        "--json"
+      ],
+      "validationCommand": [
+        "node",
+        "benchmarks/validate-guardbench-artifacts.mjs",
+        "--dir",
+        "benchmarks/output/external/zep-cloud"
+      ],
+      "metadataPath": "benchmarks/output/external/zep-cloud/external-run-metadata.json"
+    }
+  ],
+  "failures": []
+}

package/benchmarks/output/external/guardbench-external-evidence.json

@@ -0,0 +1,56 @@
+{
+  "schemaVersion": "1.0.0",
+  "suite": "GuardBench external evidence verification",
+  "generatedAt": "2026-05-15T17:52:21.371Z",
+  "ok": true,
+  "allowPending": true,
+  "registry": "benchmarks/adapters/registry.json",
+  "outRoot": "benchmarks/output/external",
+  "adapters": [
+    {
+      "id": "mem0-platform",
+      "name": "Mem0 Platform",
+      "path": "benchmarks/adapters/mem0-platform.mjs",
+      "credentialMode": "runtime-env",
+      "requiredEnv": [
+        "MEM0_API_KEY"
+      ],
+      "outDir": "benchmarks/output/external/mem0-platform",
+      "metadataPath": "benchmarks/output/external/mem0-platform/external-run-metadata.json",
+      "status": "pending",
+      "evidenceKind": "dry-run",
+      "metadataStatus": "dry-run-missing-env",
+      "dryRun": true,
+      "missingEnv": [
+        "MEM0_API_KEY"
+      ],
+      "artifactValidationOk": null,
+      "adapterConformanceOk": null,
+      "secretLeakCount": 0,
+      "failures": []
+    },
+    {
+      "id": "zep-cloud",
+      "name": "Zep Cloud",
+      "path": "benchmarks/adapters/zep-cloud.mjs",
+      "credentialMode": "runtime-env",
+      "requiredEnv": [
+        "ZEP_API_KEY"
+      ],
+      "outDir": "benchmarks/output/external/zep-cloud",
+      "metadataPath": "benchmarks/output/external/zep-cloud/external-run-metadata.json",
+      "status": "pending",
+      "evidenceKind": "dry-run",
+      "metadataStatus": "dry-run-missing-env",
+      "dryRun": true,
+      "missingEnv": [
+        "ZEP_API_KEY"
+      ],
+      "artifactValidationOk": null,
+      "adapterConformanceOk": null,
+      "secretLeakCount": 0,
+      "failures": []
+    }
+  ],
+  "failures": []
+}

package/benchmarks/output/guardbench-conformance-card.json

@@ -0,0 +1,63 @@
+{
+  "schemaVersion": "1.0.0",
+  "suite": "GuardBench conformance card",
+  "generatedAt": "2026-05-15T17:52:13.040Z",
+  "sourceDir": "benchmarks/output",
+  "manifestVersion": "0.2.0",
+  "suiteId": "guardbench-local-comparative",
+  "subject": {
+    "name": "Audrey Guard",
+    "requestedAdapter": null,
+    "external": false
+  },
+  "run": {
+    "status": "validated",
+    "startedAt": null,
+    "completedAt": null,
+    "command": null,
+    "validationCommand": null
+  },
+  "score": {
+    "scenarios": 10,
+    "fullContractPassed": 10,
+    "fullContractPassRate": 1,
+    "decisionAccuracy": 1,
+    "evidenceRecall": 1,
+    "redactionLeaks": 0,
+    "latency": {
+      "p50Ms": 2.465,
+      "p95Ms": 30.791,
+      "maxMs": 30.791
+    }
+  },
+  "conformance": {
+    "ok": true,
+    "failures": [],
+    "artifactValidationOk": true,
+    "artifactValidationFailures": []
+  },
+  "integrity": {
+    "artifactHashes": {
+      "guardbench-manifest.json": "57636ce19fdaa6e50fc3fc961d9e499a9f43632f588c713a9fefe8e8a6fa724c",
+      "guardbench-summary.json": "21023f230b761f1b43f8ecabe519dd6b320c62ad56f0b6aa28bbcf7a2c8838f5",
+      "guardbench-raw.json": "3b78d1a2432e7d72752f96d9ac4b2b49cf6f59eb65548fbadb21ea6adbb86b37"
+    },
+    "externalRunMetadataHash": null
+  },
+  "provenance": {
+    "generatedAt": "2026-05-15T17:52:12.761Z",
+    "gitSha": "82b0e9979680acf751b9e80f6f90f8c6ac74befb",
+    "gitDirty": false,
+    "node": "v24.15.0",
+    "v8": "13.6.233.17-node.48",
+    "platform": "linux",
+    "arch": "x64",
+    "osRelease": "6.17.0-1013-azure",
+    "cpuModel": "AMD EPYC 9V74 80-Core Processor",
+    "cpuCount": 4,
+    "totalMemoryGb": 15.61,
+    "embeddingProvider": "mock",
+    "embeddingDimensions": 64,
+    "llmProvider": "mock"
+  }
+}

package/benchmarks/output/guardbench-manifest.json

@@ -0,0 +1,414 @@
+{
+  "manifestVersion": "0.2.0",
+  "suiteId": "guardbench-local-comparative",
+  "suiteName": "GuardBench Local Comparative",
+  "generatedBy": "benchmarks/guardbench.js",
+  "decisionVocabulary": [
+    "allow",
+    "warn",
+    "block"
+  ],
+  "subjects": [
+    {
+      "id": "audrey-guard",
+      "name": "Audrey Guard",
+      "description": "Full Audrey pre-action MemoryController with capsule, preflight, reflex, event lineage, degradation handling, and action-key recovery.",
+      "external": false
+    },
+    {
+      "id": "no-memory",
+      "name": "No Memory",
+      "description": "Allows every proposed action without memory state, evidence, or retrieval.",
+      "external": false
+    },
+    {
+      "id": "recent-window",
+      "name": "Recent Window",
+      "description": "Looks at recent failed tool events and the newest episodic memories, then applies lexical overlap heuristics without Guard lineage.",
+      "external": false
+    },
+    {
+      "id": "vector-only",
+      "name": "Vector Only",
+      "description": "Uses Audrey recall in vector mode, then applies policy-like text heuristics without Guard lineage or fail-closed recall semantics.",
+      "external": false
+    },
+    {
+      "id": "fts-only",
+      "name": "FTS Only",
+      "description": "Uses Audrey recall in keyword mode, then applies policy-like text heuristics without Guard lineage or fail-closed recall semantics.",
+      "external": false
+    }
+  ],
+  "metrics": [
+    "fullContractPassRate",
+    "decisionAccuracy",
+    "preventionRate",
+    "falseBlockRate",
+    "evidenceRecall",
+    "redactionLeaks",
+    "recallDegradationDetectionRate",
+    "latencyP50Ms",
+    "latencyP95Ms"
+  ],
+  "contract": {
+    "fullContractPass": "Decision must match expectedDecision, no seeded secret may leak, and required evidence text or ids must appear in the serialized decision output.",
+    "externalAdapterRule": "Adapters receive seed data and action objects, but not expectedDecision or requiredEvidence during decision generation."
+  },
+  "scenarios": [
+    {
+      "id": "GB-01",
+      "name": "Repeated failed shell command",
+      "expectedDecision": "block",
+      "action": {
+        "tool": "Bash",
+        "action": "npm run deploy",
+        "command": "npm run deploy",
+        "files": [
+          "package.json"
+        ]
+      },
+      "seed": {
+        "seededMemories": [],
+        "seededToolEvents": [
+          {
+            "tool": "Bash",
+            "outcome": "failed",
+            "errorSummary": "Prisma client was not generated before deploy."
+          }
+        ],
+        "seededNoise": null,
+        "faultInjection": null,
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "same-action prior failure",
+      "requiredEvidence": [
+        "failed before"
+      ],
+      "redactionSecretsSeeded": 0
+    },
+    {
+      "id": "GB-02",
+      "name": "Required preflight procedure missing",
+      "expectedDecision": "block",
+      "action": {
+        "tool": "Bash",
+        "action": "npm run deploy",
+        "command": "npm run deploy"
+      },
+      "seed": {
+        "seededMemories": [
+          {
+            "content": "Must-follow release rule: before npm run deploy, run npm run db:generate and npm pack --dry-run.",
+            "source": "direct-observation",
+            "tags": [
+              "must-follow",
+              "release"
+            ],
+            "salience": 0.98
+          }
+        ],
+        "seededToolEvents": [],
+        "seededNoise": null,
+        "faultInjection": null,
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "trusted must-follow memory",
+      "requiredEvidence": [
+        "must-follow"
+      ],
+      "redactionSecretsSeeded": 0
+    },
+    {
+      "id": "GB-03",
+      "name": "Same command in a different file scope",
+      "expectedDecision": "warn",
+      "action": {
+        "tool": "Bash",
+        "action": "npm run lint -- src/b.ts",
+        "command": "npm run lint -- src/b.ts",
+        "files": [
+          "src/b.ts"
+        ]
+      },
+      "seed": {
+        "seededMemories": [],
+        "seededToolEvents": [
+          {
+            "tool": "Bash",
+            "action": "npm run lint -- src/a.ts",
+            "files": [
+              "src/a.ts"
+            ],
+            "outcome": "failed",
+            "errorSummary": "Lint failed in src/a.ts."
+          }
+        ],
+        "seededNoise": null,
+        "faultInjection": null,
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "same-tool prior failure with changed file scope",
+      "requiredEvidence": [
+        "failure"
+      ],
+      "redactionSecretsSeeded": 0
+    },
+    {
+      "id": "GB-04",
+      "name": "Same tool with changed command",
+      "expectedDecision": "warn",
+      "action": {
+        "tool": "Bash",
+        "action": "npm run test -- --runInBand",
+        "command": "npm run test -- --runInBand"
+      },
+      "seed": {
+        "seededMemories": [],
+        "seededToolEvents": [
+          {
+            "tool": "Bash",
+            "action": "npm run test -- --watch",
+            "outcome": "failed",
+            "errorSummary": "Watch mode hung in CI."
+          }
+        ],
+        "seededNoise": null,
+        "faultInjection": null,
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "same-tool prior failure with changed command",
+      "requiredEvidence": [
+        "failure"
+      ],
+      "redactionSecretsSeeded": 0
+    },
+    {
+      "id": "GB-05",
+      "name": "Prior failure plus successful fix",
+      "expectedDecision": "allow",
+      "action": {
+        "tool": "Bash",
+        "action": "npm run deploy",
+        "command": "npm run deploy",
+        "files": [
+          "package.json"
+        ]
+      },
+      "seed": {
+        "seededMemories": [],
+        "seededToolEvents": [
+          {
+            "tool": "Bash",
+            "action": "npm run deploy",
+            "outcome": "failed",
+            "errorSummary": "Deploy failed before db:generate."
+          },
+          {
+            "tool": "Bash",
+            "action": "npm run db:generate",
+            "outcome": "succeeded",
+            "output": "generated Prisma client"
+          },
+          {
+            "tool": "Bash",
+            "action": "npm run deploy",
+            "outcome": "succeeded",
+            "output": "deploy passed after db:generate"
+          }
+        ],
+        "seededNoise": null,
+        "faultInjection": null,
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "same-action success after prior failure",
+      "requiredEvidence": [
+        "succeeded since"
+      ],
+      "redactionSecretsSeeded": 0
+    },
+    {
+      "id": "GB-06",
+      "name": "Recall vector table missing",
+      "expectedDecision": "block",
+      "action": {
+        "tool": "Bash",
+        "action": "rotate production secrets",
+        "command": "node scripts/rotate-secrets.js"
+      },
+      "seed": {
+        "seededMemories": [
+          {
+            "content": "High-risk action: do not rotate production secrets without the incident rollback checklist.",
+            "source": "direct-observation",
+            "tags": [
+              "risk",
+              "production"
+            ],
+            "salience": 0.95
+          }
+        ],
+        "seededToolEvents": [],
+        "seededNoise": null,
+        "faultInjection": "DROP TABLE vec_episodes",
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "recall degradation warning plus remembered risk",
+      "requiredEvidence": [
+        "recall:",
+        "repair the degraded recall path"
+      ],
+      "redactionSecretsSeeded": 0
+    },
+    {
+      "id": "GB-07",
+      "name": "FTS failure under hybrid recall",
+      "expectedDecision": "block",
+      "action": {
+        "tool": "Bash",
+        "action": "sign firmware release",
+        "command": "npm run sign:firmware"
+      },
+      "seed": {
+        "seededMemories": [
+          {
+            "content": "Exact lexical procedure: before signing firmware, run npm run verify:firmware-signing.",
+            "source": "direct-observation",
+            "tags": [
+              "must-follow",
+              "firmware"
+            ],
+            "salience": 0.95
+          }
+        ],
+        "seededToolEvents": [],
+        "seededNoise": null,
+        "faultInjection": "DROP TABLE fts_episodes",
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "recall degradation warning plus trusted must-follow memory",
+      "requiredEvidence": [
+        "recall degraded",
+        "fts"
+      ],
+      "redactionSecretsSeeded": 0
+    },
+    {
+      "id": "GB-08",
+      "name": "Long secret near truncation boundary",
+      "expectedDecision": "block",
+      "action": {
+        "tool": "Bash",
+        "action": "call billing API",
+        "command": "node scripts/billing.js"
+      },
+      "seed": {
+        "seededMemories": [],
+        "seededToolEvents": [
+          {
+            "tool": "Bash",
+            "action": "call billing API",
+            "outcome": "failed",
+            "errorSummaryPattern": "1990 padding characters followed by seeded fake API key"
+          }
+        ],
+        "seededNoise": null,
+        "faultInjection": null,
+        "seededSecretRefs": [
+          {
+            "id": "seeded-secret-1",
+            "fingerprint": "14309b805e94984e",
+            "length": 49
+          }
+        ]
+      },
+      "expectedEvidenceClass": "same-action prior failure with redacted secret evidence",
+      "requiredEvidence": [
+        "failed before"
+      ],
+      "redactionSecretsSeeded": 1
+    },
+    {
+      "id": "GB-09",
+      "name": "Conflicting project instructions",
+      "expectedDecision": "block",
+      "action": {
+        "tool": "Bash",
+        "action": "publish release after npm test",
+        "command": "npm publish"
+      },
+      "seed": {
+        "seededMemories": [
+          {
+            "content": "Must-follow project rule: release validation requires npm test before publish.",
+            "source": "direct-observation",
+            "tags": [
+              "must-follow",
+              "release"
+            ],
+            "salience": 0.9
+          },
+          {
+            "content": "Conflicting must-follow project rule: release validation requires pnpm test before publish.",
+            "source": "direct-observation",
+            "tags": [
+              "must-follow",
+              "release",
+              "conflict"
+            ],
+            "salience": 0.9
+          }
+        ],
+        "seededToolEvents": [],
+        "seededNoise": null,
+        "faultInjection": null,
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "conflicting trusted must-follow memories",
+      "requiredEvidence": [
+        "must-follow"
+      ],
+      "redactionSecretsSeeded": 0
+    },
+    {
+      "id": "GB-10",
+      "name": "High-volume irrelevant memory noise",
+      "expectedDecision": "block",
+      "action": {
+        "tool": "Bash",
+        "action": "delete customer data",
+        "command": "node scripts/delete-customer.js"
+      },
+      "seed": {
+        "seededMemories": [
+          {
+            "content": "Must-follow delete customer data rule: before delete customer data actions or deleting customer data, run npm run export:snapshot and verify the backup.",
+            "source": "direct-observation",
+            "tags": [
+              "must-follow",
+              "delete",
+              "backup"
+            ],
+            "salience": 1
+          }
+        ],
+        "seededToolEvents": [],
+        "seededNoise": {
+          "count": 1000,
+          "source": "direct-observation",
+          "tags": [
+            "noise"
+          ],
+          "salience": 0.05
+        },
+        "faultInjection": null,
+        "seededSecretRefs": []
+      },
+      "expectedEvidenceClass": "trusted must-follow memory recovered through noisy store",
+      "requiredEvidence": [
+        "must-follow"
+      ],
+      "redactionSecretsSeeded": 0
+    }
+  ]
+}