@adhd/backlog 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 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