@adhd/backlog 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -1,3 +1,28 @@
+## 0.1.8 (2026-08-19)
+
+
+### 🩹 Fixes
+
+- **backlog:** singleton writer lock for `serve` — two concurrent servers against one store corrupted the db (BUG-020). O_EXCL PID-file lock keyed on the canonical realpath'd db path, held from before the store opens until after it is fully closed, so a second `serve` during shutdown drain is refused rather than admitted. Dead holders reclaimed; refusal names the holder pid and lock path.
+- **backlog:** consume `@adhd/sox-store-adapter` 0.7.0. The dependency was pinned `^0.5.8`, and a caret on a 0.x pins the MINOR — so it could never resolve past 0.6.0 and none of the WAL/durability work reached this store. Brings the adaptive idle-flush debounce (BL-590), baseline-relative WAL cap (BL-587), and verified busy-error classification in the wal-cap backstop (BUG-019).
+
+
+### ❤️  Thank You
+
+- pseudosky
+
+## 0.1.7 (2026-08-14)
+
+
+### 🩹 Fixes
+
+- **backlog:** persist citations, atomic repo migration, signal cleanup
+
+
+### ❤️  Thank You
+
+- pseudosky
+
 ## 0.1.6 (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

@@ -61,3 +61,36 @@ export declare function resolveBacklogDbPath(env: Environment<BacklogConfig>): s
  * `claimItem` itself.
  */
 export declare function suggestClaimantIdentity(agentName: string, instanceId: string): string;
+/**
+ * BUG-CACHE-CWD-001: the effective apigen extract-stage IR-cache file path.
+ * Prior to this fix, `server.ts`'s `irCacheFile()` defaulted to
+ * `join(process.cwd(), 'tmp', 'apigen', 'ir-cache', 'backlog-client.ir.json')`
+ * — a NEW cache (and a NEW `tmp/apigen/ir-cache/` directory) was created in
+ * every distinct directory `backlog` was ever invoked from: every repo, every
+ * git worktree, and — because `startBacklogServer`'s `opts.cwd` test-override
+ * plumbing was sometimes used unintentionally as a live cwd — even
+ * `~/.adhd/backlog/production/data/tmp/apigen/ir-cache/`, nested one level
+ * inside the live store's own data directory. None of these scattered copies
+ * ever saw a cache HIT from any other copy, so every distinct invocation
+ * directory paid a full re-extraction — a correctness-neutral but pure
+ * performance and disk-hygiene regression (FEAT-002's entire point, undone).
+ *
+ * Resolution order (highest precedence first), matching `resolveBacklogDbPath`'s
+ * own precedence-comment convention:
+ *
+ *   1. `APIGEN_IR_CACHE_FILE` (explicit escape hatch — tests point this at a
+ *      throwaway file; see `ir-cache.integration.spec.ts`) — wins outright.
+ *   2. The `cache` dir's resolved path (`kind: 'cache'` → shared, scope
+ *      forced to `'global'` — see the `dirs.cache` doc comment above) +
+ *      `apigen/ir-cache/backlog-client.ir.json`. Absolute, `process.cwd()`-
+ *      independent, and identical across every scope/repo/worktree on this
+ *      machine — exactly the fast-path guarantee FEAT-002 designed for.
+ *
+ * `adhdRoot`/`instanceId` are accepted purely for test isolation (mirrors
+ * `buildBacklogEnv`'s own test-isolation fields) — production callers never
+ * pass them.
+ */
+export declare function resolveIrCacheFile(options?: {
+    adhdRoot?: string;
+    instanceId?: string;
+}): string;