@adhd/agent-core-env 0.0.1

package/README.md

@@ -0,0 +1,11 @@
+# agent-agent-core-env
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build agent-agent-core-env` to build the library.
+
+## Running unit tests
+
+Run `nx test agent-agent-core-env` to execute the unit tests via [Vitest](https://vitest.dev/).

package/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("@adhd/environment"),i=require("node:fs"),o=require("node:path"),y=require("better-sqlite3"),u=require("drizzle-orm/better-sqlite3"),d="agent-registry",a={namespaces:["production"],dirs:{data:{kind:"data",scope:"global"}},files:{registry:{in:"data",name:"registry.db"}},config:{}};function c(r={}){if(r.registryDbPath)return r.registryDbPath;const t=process.env.ADHD_AGENT_REGISTRY_DB_PATH;if(t)return t;const n=process.env.REGISTRY_DATABASE_PATH;if(n)return n;const e=process.env.DATABASE_PATH;return e||new g.Environment("agent-registry",a,r.scope?{scope:r.scope}:{}).files.registry}function D(r={}){const t=o.resolve(c({registryDbPath:r.registryDbPath})),n=o.dirname(t);i.existsSync(n)||i.mkdirSync(n,{recursive:!0});const e=new y(t);e.pragma("journal_mode = WAL"),e.pragma("foreign_keys = ON");const s=u.drizzle(e);return{sqlite:e,db:s}}exports.AGENT_REGISTRY_PROJECT_ID=d;exports.agentRegistryEnvironmentSpec=a;exports.openRegistryDb=D;exports.resolveRegistryDbPath=c;

package/index.d.ts

@@ -0,0 +1,6 @@
+export { resolveRegistryDbPath } from './resolve-registry-db-path.js';
+export type { ResolveRegistryDbPathOpts } from './resolve-registry-db-path.js';
+export { openRegistryDb } from './open-registry-db.js';
+export type { OpenRegistryDbOpts, RegistryDbHandle } from './open-registry-db.js';
+export { agentRegistryEnvironmentSpec, AGENT_REGISTRY_PROJECT_ID } from './spec.js';
+export type { AgentRegistryEnvConfig } from './spec.js';

package/index.js

@@ -0,0 +1,45 @@
+import { Environment as a } from "@adhd/environment";
+import o from "node:fs";
+import i from "node:path";
+import c from "better-sqlite3";
+import { drizzle as g } from "drizzle-orm/better-sqlite3";
+const b = "agent-registry", m = {
+  namespaces: ["production"],
+  dirs: {
+    data: { kind: "data", scope: "global" }
+  },
+  files: {
+    registry: { in: "data", name: "registry.db" }
+  },
+  config: {}
+};
+function f(e = {}) {
+  if (e.registryDbPath)
+    return e.registryDbPath;
+  const t = process.env.ADHD_AGENT_REGISTRY_DB_PATH;
+  if (t)
+    return t;
+  const n = process.env.REGISTRY_DATABASE_PATH;
+  if (n)
+    return n;
+  const r = process.env.DATABASE_PATH;
+  return r || new a(
+    "agent-registry",
+    m,
+    e.scope ? { scope: e.scope } : {}
+  ).files.registry;
+}
+function u(e = {}) {
+  const t = i.resolve(f({ registryDbPath: e.registryDbPath })), n = i.dirname(t);
+  o.existsSync(n) || o.mkdirSync(n, { recursive: !0 });
+  const r = new c(t);
+  r.pragma("journal_mode = WAL"), r.pragma("foreign_keys = ON");
+  const s = g(r);
+  return { sqlite: r, db: s };
+}
+export {
+  b as AGENT_REGISTRY_PROJECT_ID,
+  m as agentRegistryEnvironmentSpec,
+  u as openRegistryDb,
+  f as resolveRegistryDbPath
+};

package/open-registry-db.d.ts

@@ -0,0 +1,28 @@
+import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import { default as Database } from 'better-sqlite3';
+
+export interface OpenRegistryDbOpts {
+    /** Explicit path override — forwarded to `resolveRegistryDbPath()`. When
+     *  absent, the full precedence chain (function arg / env vars / canonical
+     *  default) resolves the path. */
+    registryDbPath?: string;
+}
+export interface RegistryDbHandle {
+    /** The raw `better-sqlite3` connection — WAL mode + `foreign_keys = ON`
+     *  already set, matching every existing family client's pragmas. */
+    sqlite: Database.Database;
+    /** A schema-less Drizzle instance over `sqlite`. Each family package
+     *  binds its OWN schema-typed Drizzle instance against this same
+     *  connection (`drizzle(handle.sqlite, { schema })`) — this package owns
+     *  no registry-family schema itself. */
+    db: BetterSQLite3Database;
+}
+/**
+ * Opens (and, if needed, creates) the shared registry SQLite file, applying
+ * the same pragmas every existing family client already applied
+ * (`journal_mode = WAL`, `foreign_keys = ON`) and `mkdir -p`'ing the parent
+ * directory first. Safe to call more than once — each call opens its own
+ * connection (matching the pre-migration behavior of `db/client.ts`, which
+ * every consumer already expected to be a single connection per process).
+ */
+export declare function openRegistryDb(opts?: OpenRegistryDbOpts): RegistryDbHandle;

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@adhd/agent-core-env",
+  "version": "0.0.1",
+  "description": "Shared @adhd/environment-backed resolver for the agent-registry family's one shared SQLite file (agent-store-prompts/-tools, agent-core-policy/-provider, agent-engine-compiler) — resolveRegistryDbPath() + lazy openRegistryDb(), no import-time DB open.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "dependencies": {
+    "@adhd/environment": "^0.0.1",
+    "better-sqlite3": "12.10.0",
+    "drizzle-orm": "0.45.2"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PseudoSky/adhd.git",
+    "directory": "packages/agent/agent-core-env"
+  },
+  "homepage": "https://github.com/PseudoSky/adhd/tree/main/packages/agent/agent-core-env#readme",
+  "bugs": {
+    "url": "https://github.com/PseudoSky/adhd/issues"
+  }
+}

package/resolve-registry-db-path.d.ts

@@ -0,0 +1,37 @@
+import { Scope } from '@adhd/environment';
+
+export interface ResolveRegistryDbPathOpts {
+    /** Explicit override — highest precedence. Callers (e.g. tests) that know
+     *  exactly which file they want should pass this instead of relying on
+     *  env vars. */
+    registryDbPath?: string;
+    /** Forces the active `Environment` scope, bypassing the pinned `'global'`
+     *  default on `dirs.data` (see `spec.ts`) — equivalent to setting
+     *  `ADHD_ENV_SCOPE` for just this call. */
+    scope?: Scope;
+}
+/**
+ * Resolves the registry database path with the following precedence
+ * (highest → lowest), exactly as specified in
+ * `docs/environment/agent-base-env/DESIGN.md` Decision 4:
+ *
+ *   1. `opts.registryDbPath` — explicit caller-supplied override.
+ *   2. `ADHD_AGENT_REGISTRY_DB_PATH` — agent-mcp's current,
+ *      `ADHD_AGENT_*`-prefixed convention.
+ *   3. `REGISTRY_DATABASE_PATH` — the more specific of the two legacy
+ *      family env-var names (`agent-store-prompts`/`agent-engine-compiler`
+ *      `db/client.ts`).
+ *   4. `DATABASE_PATH` — the generic legacy name (all 5 clients accepted it
+ *      as a fallback).
+ *   5. The `@adhd/environment`-resolved canonical default —
+ *      `~/.adhd/agent-registry/production/data/registry.db` (or under
+ *      `ADHD_ENV_SCOPE=project`'s project root, or `opts.scope`).
+ *
+ * This precedence lives as explicit code (not a single `FieldSpec.env`
+ * mapping) because 3 independent legacy env-var names must all keep
+ * resolving — `FieldSpec` only carries one explicit env name per field.
+ *
+ * Never auto-migrates or copies any file that happens to already exist at
+ * a legacy path — it only computes where the canonical file should live.
+ */
+export declare function resolveRegistryDbPath(opts?: ResolveRegistryDbPathOpts): string;

package/spec.d.ts

@@ -0,0 +1,9 @@
+import { EnvironmentSpec } from '@adhd/environment';
+
+/** The resolved, nested `env.config` shape for the `'agent-registry'`
+ *  `Environment` instance. Empty — see module doc above. */
+export interface AgentRegistryEnvConfig {
+}
+/** Logical `Environment` project id shared by every registry-family package. */
+export declare const AGENT_REGISTRY_PROJECT_ID = "agent-registry";
+export declare const agentRegistryEnvironmentSpec: EnvironmentSpec<AgentRegistryEnvConfig>;