@adhd/backlog 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+## 0.1.7 (2026-08-14)
+
+
+### 🩹 Fixes
+
+- **backlog:** persist citations, atomic repo migration, signal cleanup
+
+
+### ❤️  Thank You
+
+- pseudosky
+
+## 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/client.d.ts

@@ -1,6 +1,6 @@
 import { GraphBacklogStore } from './store/graph-backlog-store.js';
 import { BacklogConfig } from './env.js';
-import { ArchiveOpts, ArchiveResult, AuditTrailResult, BacklogFilter, BacklogItem, BacklogStats, BacklogStatus, ClaimOpts, ClaimResult, Citation, CreateItemInput, CreateItemResult, DependencyGraph, ImportMarkdownInput, ImportResult, MigrationPhase, MigrationStatusResult, Priority, ReleaseResult, SetMigrationPhaseResult, StatsScope, TopoOrderResult, TransitionOpts, UpdateItemInput } from './model.js';
+import { ArchiveOpts, ArchiveResult, AuditTrailResult, BacklogFilter, BacklogItem, BacklogStats, BacklogStatus, ClaimOpts, ClaimResult, Citation, CreateItemInput, CreateItemResult, DependencyGraph, ImportMarkdownInput, ImportResult, MigrationPhase, MigrationStatusResult, Priority, ReleaseResult, RepoMigrationResult, SetMigrationPhaseResult, StatsScope, TopoOrderResult, TransitionOpts, UpdateItemInput } from './model.js';
 import { Environment } from '@adhd/environment';
 
 /** The one type apigen special-cases via the `ctx-name-only` invariant. */
@@ -92,6 +92,30 @@ export declare function mergeItems(ctx: BacklogCtx, repo: string, keepHumanId: s
 export declare function setPriority(ctx: BacklogCtx, repo: string, humanId: string, priority: Priority): Promise<BacklogItem>;
 /** MEMBER_OF edge to a plan node (auto-created if the plan slug hasn't been seen before). */
 export declare function attachToPlan(ctx: BacklogCtx, repo: string, humanId: string, planSlug: string): Promise<void>;
+/**
+ * BUG-BACKLOG-REPO-SPLIT-001 / DEBT-BACKLOG-REPO-MOVE-001 — the dedicated
+ * primitive to move every live item out of `fromRepo` into `toRepo` (a
+ * repo-key correction, e.g. a legacy `"adhd"` string onto the canonical
+ * `"PseudoSky/adhd"`). `dryRun` defaults to `true`: a caller must pass
+ * `dryRun:false` explicitly to write anything — the default call is always
+ * safe to make speculatively and returns the full plan (including which
+ * items would be renamed, and to what) with zero mutation.
+ *
+ * Collisions (a humanId already live in `toRepo`) are never silently
+ * dropped, overwritten, or left ambiguous — each is deterministically
+ * renamed to the next free number in its own family within `toRepo`
+ * (`store/repo-migration.ts`'s `planRepoMigration`), and an audit note
+ * recording the original `(fromRepo, humanId)` is attached to the moved
+ * item so the rename is traceable. Cross-item links (DEPENDS_ON,
+ * RELATES_TO, PART_OF, SUPERSEDES, SAME_AS, MEMBER_OF, ASSIGNED_TO) are
+ * preserved automatically — a move never changes a node's id, only its
+ * `namespace`/`repo`/`humanId`/`name`/`content`.
+ *
+ * Every planned item gets exactly one reported outcome
+ * (`results[i].ok`/`error`) when `dryRun:false` — a per-item failure never
+ * aborts the rest of the batch and never goes unreported.
+ */
+export declare function migrateRepo(ctx: BacklogCtx, fromRepo: string, toRepo: string, by: string, dryRun?: boolean): Promise<RepoMigrationResult>;
 export declare function importFromMarkdown(ctx: BacklogCtx, input: ImportMarkdownInput): Promise<ImportResult>;
 /**
  * Excludes archived items (SPEC.md §5.4 archiveResolved) — see markdown.ts's

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';