@vostride/agent-qa-safety-local 0.0.1 → 0.2.2

package/LICENSE.md

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 Pranshu Chittora
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/NOTICE.md

@@ -0,0 +1,11 @@
+# agent-qa Notice
+
+agent-qa is provided by Pranshu Chittora.
+
+Copyright 2026 Pranshu Chittora
+
+agent-qa is licensed under the Functional Source License, Version 1.1, ALv2 Future License (FSL-1.1-ALv2). See `LICENSE.md` for the full license terms.
+
+Under the Grant of Future License in `LICENSE.md`, each version of the Software is also granted under the Apache License, Version 2.0 effective on the second anniversary of the date that version was made available.
+
+Third-party dependencies are distributed under their own license terms. This notice covers agent-qa itself and does not replace or modify notices required by third-party dependency owners.

package/dist/index.cjs

@@ -0,0 +1,88 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  detectExecutionContext: () => detectExecutionContext,
+  fingerprint: () => fingerprint,
+  runSafetyScope: () => runSafetyScope
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/fingerprint.ts
+var import_agent_qa_schema = require("@vostride/agent-qa-schema");
+var fingerprint = (raw) => (0, import_agent_qa_schema.sha256hex16)(raw);
+
+// src/execution-context-detector.ts
+var import_agent_qa_safety = require("@vostride/agent-qa-safety");
+var CI_VENDOR_VARS = /* @__PURE__ */ new Set([
+  "GITHUB_ACTIONS",
+  "GITLAB_CI",
+  "CIRCLECI",
+  "BUILDKITE",
+  "JENKINS_URL",
+  "TRAVIS",
+  "APPVEYOR",
+  "TF_BUILD",
+  "CODEBUILD_BUILD_ID",
+  "DRONE",
+  "SEMAPHORE",
+  "BITBUCKET_BUILD_NUMBER",
+  "TEAMCITY_VERSION"
+]);
+function isTruthy(value) {
+  const normalized = value?.trim().toLowerCase();
+  return normalized !== void 0 && normalized !== "" && normalized !== "0" && normalized !== "false";
+}
+function isPresent(value) {
+  return value !== void 0 && value.trim() !== "";
+}
+function readSignals(env = process.env) {
+  let hasVendorMarker = false;
+  for (const name of CI_VENDOR_VARS) {
+    if (isPresent(env[name])) {
+      hasVendorMarker = true;
+      break;
+    }
+  }
+  return {
+    isTty: Boolean(process.stdout?.isTTY) && Boolean(process.stdin?.isTTY),
+    ciMarkers: isTruthy(env.CI) || hasVendorMarker
+  };
+}
+function detectExecutionContext(override) {
+  return (0, import_agent_qa_safety.resolveExecutionContext)(readSignals(), override);
+}
+
+// src/safety-scope.ts
+var import_node_async_hooks = require("async_hooks");
+var import_agent_qa_safety2 = require("@vostride/agent-qa-safety");
+var als = new import_node_async_hooks.AsyncLocalStorage();
+(0, import_agent_qa_safety2.setActiveExecutionContextResolver)(() => als.getStore()?.executionContext ?? detectExecutionContext());
+function runSafetyScope(bundle, fn) {
+  return als.run(bundle, fn);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectExecutionContext,
+  fingerprint,
+  runSafetyScope
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/fingerprint.ts","../src/execution-context-detector.ts","../src/safety-scope.ts"],"sourcesContent":["export { fingerprint } from './fingerprint'\nexport { detectExecutionContext } from './execution-context-detector'\nexport { runSafetyScope } from './safety-scope'\nexport type { SafetyScopeBundle } from './safety-scope'\n","import { sha256hex16 } from '@vostride/agent-qa-schema'\n\n/**\n * One-way 16-hex fingerprint for redactedFingerprint. NOT detection; pure hashing.\n */\nexport const fingerprint = (raw: string): string => sha256hex16(raw)\n","import { resolveExecutionContext, type ExecutionContextSignals } from '@vostride/agent-qa-safety'\nimport type { ExecutionContext } from '@vostride/agent-qa-schema'\n\nexport const CI_VENDOR_VARS = new Set([\n  'GITHUB_ACTIONS',\n  'GITLAB_CI',\n  'CIRCLECI',\n  'BUILDKITE',\n  'JENKINS_URL',\n  'TRAVIS',\n  'APPVEYOR',\n  'TF_BUILD',\n  'CODEBUILD_BUILD_ID',\n  'DRONE',\n  'SEMAPHORE',\n  'BITBUCKET_BUILD_NUMBER',\n  'TEAMCITY_VERSION',\n] as const)\n\nfunction isTruthy(value?: string): boolean {\n  const normalized = value?.trim().toLowerCase()\n  return normalized !== undefined && normalized !== '' && normalized !== '0' && normalized !== 'false'\n}\n\nfunction isPresent(value?: string): boolean {\n  return value !== undefined && value.trim() !== ''\n}\n\nexport function readSignals(env: NodeJS.ProcessEnv = process.env): ExecutionContextSignals {\n  let hasVendorMarker = false\n\n  for (const name of CI_VENDOR_VARS) {\n    if (isPresent(env[name])) {\n      hasVendorMarker = true\n      break\n    }\n  }\n\n  return {\n    isTty: Boolean(process.stdout?.isTTY) && Boolean(process.stdin?.isTTY),\n    ciMarkers: isTruthy(env.CI) || hasVendorMarker,\n  }\n}\n\nexport function detectExecutionContext(override?: ExecutionContext): ExecutionContext {\n  return resolveExecutionContext(readSignals(), override)\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\n\nimport { setActiveExecutionContextResolver } from '@vostride/agent-qa-safety'\nimport type { ExecutionContext } from '@vostride/agent-qa-schema'\n\nimport { detectExecutionContext } from './execution-context-detector'\n\nexport interface SafetyScopeBundle {\n  executionContext?: ExecutionContext\n}\n\n// D-02: exactly ONE AsyncLocalStorage store carries the run-safety bundle, feeding the active\n// execution-context resolver with one nesting-safe, concurrency-safe scope.\nconst als = new AsyncLocalStorage<SafetyScopeBundle>()\n\n// Single install site (Pitfall 9). Reachable from the package barrel so any import of\n// @vostride/agent-qa-safety-local wires the scope.\nsetActiveExecutionContextResolver(() => als.getStore()?.executionContext ?? detectExecutionContext())\n\nexport function runSafetyScope<T>(bundle: SafetyScopeBundle, fn: () => T): T {\n  return als.run(bundle, fn)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,6BAA4B;AAKrB,IAAM,cAAc,CAAC,YAAwB,oCAAY,GAAG;;;ACLnE,6BAAsE;AAG/D,IAAM,iBAAiB,oBAAI,IAAI;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAEV,SAAS,SAAS,OAAyB;AACzC,QAAM,aAAa,OAAO,KAAK,EAAE,YAAY;AAC7C,SAAO,eAAe,UAAa,eAAe,MAAM,eAAe,OAAO,eAAe;AAC/F;AAEA,SAAS,UAAU,OAAyB;AAC1C,SAAO,UAAU,UAAa,MAAM,KAAK,MAAM;AACjD;AAEO,SAAS,YAAY,MAAyB,QAAQ,KAA8B;AACzF,MAAI,kBAAkB;AAEtB,aAAW,QAAQ,gBAAgB;AACjC,QAAI,UAAU,IAAI,IAAI,CAAC,GAAG;AACxB,wBAAkB;AAClB;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,QAAQ,QAAQ,QAAQ,KAAK,KAAK,QAAQ,QAAQ,OAAO,KAAK;AAAA,IACrE,WAAW,SAAS,IAAI,EAAE,KAAK;AAAA,EACjC;AACF;AAEO,SAAS,uBAAuB,UAA+C;AACpF,aAAO,gDAAwB,YAAY,GAAG,QAAQ;AACxD;;;AC9CA,8BAAkC;AAElC,IAAAA,0BAAkD;AAWlD,IAAM,MAAM,IAAI,0CAAqC;AAAA,IAIrD,2DAAkC,MAAM,IAAI,SAAS,GAAG,oBAAoB,uBAAuB,CAAC;AAE7F,SAAS,eAAkB,QAA2B,IAAgB;AAC3E,SAAO,IAAI,IAAI,QAAQ,EAAE;AAC3B;","names":["import_agent_qa_safety"]}

package/dist/index.d.cts

@@ -0,0 +1,15 @@
+import { ExecutionContext } from '@vostride/agent-qa-schema';
+
+/**
+ * One-way 16-hex fingerprint for redactedFingerprint. NOT detection; pure hashing.
+ */
+declare const fingerprint: (raw: string) => string;
+
+declare function detectExecutionContext(override?: ExecutionContext): ExecutionContext;
+
+interface SafetyScopeBundle {
+    executionContext?: ExecutionContext;
+}
+declare function runSafetyScope<T>(bundle: SafetyScopeBundle, fn: () => T): T;
+
+export { type SafetyScopeBundle, detectExecutionContext, fingerprint, runSafetyScope };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { ExecutionContext } from '@vostride/agent-qa-schema';
+
+/**
+ * One-way 16-hex fingerprint for redactedFingerprint. NOT detection; pure hashing.
+ */
+declare const fingerprint: (raw: string) => string;
+
+declare function detectExecutionContext(override?: ExecutionContext): ExecutionContext;
+
+interface SafetyScopeBundle {
+    executionContext?: ExecutionContext;
+}
+declare function runSafetyScope<T>(bundle: SafetyScopeBundle, fn: () => T): T;
+
+export { type SafetyScopeBundle, detectExecutionContext, fingerprint, runSafetyScope };

package/dist/index.js

@@ -0,0 +1,59 @@
+// src/fingerprint.ts
+import { sha256hex16 } from "@vostride/agent-qa-schema";
+var fingerprint = (raw) => sha256hex16(raw);
+
+// src/execution-context-detector.ts
+import { resolveExecutionContext } from "@vostride/agent-qa-safety";
+var CI_VENDOR_VARS = /* @__PURE__ */ new Set([
+  "GITHUB_ACTIONS",
+  "GITLAB_CI",
+  "CIRCLECI",
+  "BUILDKITE",
+  "JENKINS_URL",
+  "TRAVIS",
+  "APPVEYOR",
+  "TF_BUILD",
+  "CODEBUILD_BUILD_ID",
+  "DRONE",
+  "SEMAPHORE",
+  "BITBUCKET_BUILD_NUMBER",
+  "TEAMCITY_VERSION"
+]);
+function isTruthy(value) {
+  const normalized = value?.trim().toLowerCase();
+  return normalized !== void 0 && normalized !== "" && normalized !== "0" && normalized !== "false";
+}
+function isPresent(value) {
+  return value !== void 0 && value.trim() !== "";
+}
+function readSignals(env = process.env) {
+  let hasVendorMarker = false;
+  for (const name of CI_VENDOR_VARS) {
+    if (isPresent(env[name])) {
+      hasVendorMarker = true;
+      break;
+    }
+  }
+  return {
+    isTty: Boolean(process.stdout?.isTTY) && Boolean(process.stdin?.isTTY),
+    ciMarkers: isTruthy(env.CI) || hasVendorMarker
+  };
+}
+function detectExecutionContext(override) {
+  return resolveExecutionContext(readSignals(), override);
+}
+
+// src/safety-scope.ts
+import { AsyncLocalStorage } from "async_hooks";
+import { setActiveExecutionContextResolver } from "@vostride/agent-qa-safety";
+var als = new AsyncLocalStorage();
+setActiveExecutionContextResolver(() => als.getStore()?.executionContext ?? detectExecutionContext());
+function runSafetyScope(bundle, fn) {
+  return als.run(bundle, fn);
+}
+export {
+  detectExecutionContext,
+  fingerprint,
+  runSafetyScope
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fingerprint.ts","../src/execution-context-detector.ts","../src/safety-scope.ts"],"sourcesContent":["import { sha256hex16 } from '@vostride/agent-qa-schema'\n\n/**\n * One-way 16-hex fingerprint for redactedFingerprint. NOT detection; pure hashing.\n */\nexport const fingerprint = (raw: string): string => sha256hex16(raw)\n","import { resolveExecutionContext, type ExecutionContextSignals } from '@vostride/agent-qa-safety'\nimport type { ExecutionContext } from '@vostride/agent-qa-schema'\n\nexport const CI_VENDOR_VARS = new Set([\n  'GITHUB_ACTIONS',\n  'GITLAB_CI',\n  'CIRCLECI',\n  'BUILDKITE',\n  'JENKINS_URL',\n  'TRAVIS',\n  'APPVEYOR',\n  'TF_BUILD',\n  'CODEBUILD_BUILD_ID',\n  'DRONE',\n  'SEMAPHORE',\n  'BITBUCKET_BUILD_NUMBER',\n  'TEAMCITY_VERSION',\n] as const)\n\nfunction isTruthy(value?: string): boolean {\n  const normalized = value?.trim().toLowerCase()\n  return normalized !== undefined && normalized !== '' && normalized !== '0' && normalized !== 'false'\n}\n\nfunction isPresent(value?: string): boolean {\n  return value !== undefined && value.trim() !== ''\n}\n\nexport function readSignals(env: NodeJS.ProcessEnv = process.env): ExecutionContextSignals {\n  let hasVendorMarker = false\n\n  for (const name of CI_VENDOR_VARS) {\n    if (isPresent(env[name])) {\n      hasVendorMarker = true\n      break\n    }\n  }\n\n  return {\n    isTty: Boolean(process.stdout?.isTTY) && Boolean(process.stdin?.isTTY),\n    ciMarkers: isTruthy(env.CI) || hasVendorMarker,\n  }\n}\n\nexport function detectExecutionContext(override?: ExecutionContext): ExecutionContext {\n  return resolveExecutionContext(readSignals(), override)\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\n\nimport { setActiveExecutionContextResolver } from '@vostride/agent-qa-safety'\nimport type { ExecutionContext } from '@vostride/agent-qa-schema'\n\nimport { detectExecutionContext } from './execution-context-detector'\n\nexport interface SafetyScopeBundle {\n  executionContext?: ExecutionContext\n}\n\n// D-02: exactly ONE AsyncLocalStorage store carries the run-safety bundle, feeding the active\n// execution-context resolver with one nesting-safe, concurrency-safe scope.\nconst als = new AsyncLocalStorage<SafetyScopeBundle>()\n\n// Single install site (Pitfall 9). Reachable from the package barrel so any import of\n// @vostride/agent-qa-safety-local wires the scope.\nsetActiveExecutionContextResolver(() => als.getStore()?.executionContext ?? detectExecutionContext())\n\nexport function runSafetyScope<T>(bundle: SafetyScopeBundle, fn: () => T): T {\n  return als.run(bundle, fn)\n}\n"],"mappings":";AAAA,SAAS,mBAAmB;AAKrB,IAAM,cAAc,CAAC,QAAwB,YAAY,GAAG;;;ACLnE,SAAS,+BAA6D;AAG/D,IAAM,iBAAiB,oBAAI,IAAI;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAEV,SAAS,SAAS,OAAyB;AACzC,QAAM,aAAa,OAAO,KAAK,EAAE,YAAY;AAC7C,SAAO,eAAe,UAAa,eAAe,MAAM,eAAe,OAAO,eAAe;AAC/F;AAEA,SAAS,UAAU,OAAyB;AAC1C,SAAO,UAAU,UAAa,MAAM,KAAK,MAAM;AACjD;AAEO,SAAS,YAAY,MAAyB,QAAQ,KAA8B;AACzF,MAAI,kBAAkB;AAEtB,aAAW,QAAQ,gBAAgB;AACjC,QAAI,UAAU,IAAI,IAAI,CAAC,GAAG;AACxB,wBAAkB;AAClB;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,QAAQ,QAAQ,QAAQ,KAAK,KAAK,QAAQ,QAAQ,OAAO,KAAK;AAAA,IACrE,WAAW,SAAS,IAAI,EAAE,KAAK;AAAA,EACjC;AACF;AAEO,SAAS,uBAAuB,UAA+C;AACpF,SAAO,wBAAwB,YAAY,GAAG,QAAQ;AACxD;;;AC9CA,SAAS,yBAAyB;AAElC,SAAS,yCAAyC;AAWlD,IAAM,MAAM,IAAI,kBAAqC;AAIrD,kCAAkC,MAAM,IAAI,SAAS,GAAG,oBAAoB,uBAAuB,CAAC;AAE7F,SAAS,eAAkB,QAA2B,IAAgB;AAC3E,SAAO,IAAI,IAAI,QAAQ,EAAE;AAC3B;","names":[]}

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@vostride/agent-qa-safety-local",
-  "version": "0.0.1",
-  "main": "index.js",
-  "files": []
+  "version": "0.2.2",
+  "private": false,
+  "description": "StorageImplementation shell for the local run-safety scope and execution-context detection in agent-qa.",
+  "keywords": [
+    "agent-qa",
+    "testing",
+    "agent",
+    "ports"
+  ],
+  "license": "FSL-1.1-ALv2",
+  "homepage": "https://github.com/vostride/agent-qa#readme",
+  "bugs": {
+    "url": "https://github.com/vostride/agent-qa/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vostride/agent-qa.git",
+    "directory": "packages/safety-local"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE.md",
+    "NOTICE.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  },
+  "dependencies": {
+    "@vostride/agent-qa-safety": "0.2.2",
+    "@vostride/agent-qa-schema": "0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "~24.12.2",
+    "@vostride/agent-qa-arch": "0.2.2",
+    "tsup": "~8.5.1",
+    "typescript": "~6.0.3",
+    "vitest": "~4.1.5"
+  }
 }