@adhd/backlog 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 0.1.6 (2026-08-12)
+
+
+### 🩹 Fixes
+
+- **backlog:** honor ADHD_BACKLOG_DATABASE_PATH env override (BUG-002)
+
+
+### ❤️  Thank You
+
+- pseudosky
+
 ## 0.1.5 (2026-08-12)
 
 

package/env.d.ts

@@ -32,6 +32,29 @@ export interface BuildBacklogEnvOptions {
     instanceId?: string;
 }
 export declare function buildBacklogEnv(options?: BuildBacklogEnvOptions): Environment<BacklogConfig>;
+/**
+ * BUG-002: the effective SQLite backlog-graph DB path. Every store-open site
+ * (`cli.ts`'s `runBacklogCli`, `server.ts`'s `startBacklogServer`) must
+ * resolve the path through THIS helper — never `env.files.db` directly —
+ * or a consumer setting `ADHD_BACKLOG_DATABASE_PATH` silently hits the
+ * scope-root file instead of the path they asked for (the env var was
+ * declared on `db.path` in `backlogEnvironmentSpec` but nothing consumed
+ * it, so a controlled scratch experiment redirected nowhere and opened the
+ * production store). Resolution order, matching the FieldSpec cascade the
+ * `@adhd/environment` builder implements (config-resolver.ts §2.2):
+ *
+ *   1. `ADHD_BACKLOG_DATABASE_PATH` (env var → `config.db.path`) — wins;
+ *   2. `db.path` from a config file (system/global/project/local layers);
+ *   3. fallback: `files.db` — the namespaced `backlog.db` under the resolved
+ *      scope root (the declaration's own "Unset ⇒ falls back to env.files.db").
+ *
+ * Mirrors `agent-mcp`'s `db/client.ts` precedent
+ * (`config.db.path ?? files['db']`), with one deliberate divergence: no
+ * `path.resolve` wrap here, because `openGraphBacklogStore` treats the
+ * literal `':memory:'` as a special in-memory path and `resolve()` would
+ * corrupt it into `<cwd>/':memory:'`.
+ */
+export declare function resolveBacklogDbPath(env: Environment<BacklogConfig>): string;
 /**
  * DESIGN.md §4.4 — the recommended (not enforced) claimant identity shape:
  * `${agentName}:${instanceId}`. Exposed as a plain helper, never baked into

package/index.d.ts

@@ -8,7 +8,7 @@ export { installSkill, runInstallSkillCommand } from './install-skill.js';
 export type { InstallSkillResult, SkillHost, SkillScope } from './install-skill.js';
 export { runServeCommand } from './serve.js';
 export type { RunServeCommandOpts } from './serve.js';
-export { buildBacklogEnv, resolveBacklogScope, suggestClaimantIdentity, backlogEnvironmentSpec } from './env.js';
+export { buildBacklogEnv, resolveBacklogScope, resolveBacklogDbPath, suggestClaimantIdentity, backlogEnvironmentSpec } from './env.js';
 export type { BacklogConfig, BuildBacklogEnvOptions } from './env.js';
 export { openGraphBacklogStore, closeGraphBacklogStore } from './store/graph-backlog-store.js';
 export type { GraphBacklogStore } from './store/graph-backlog-store.js';