@opengsd/gsd-pi 1.0.1 → 1.0.2

package/dist/resources/extensions/gsd/commands/handlers/ops.js

@@ -262,7 +262,7 @@ Examples:
         await handleInspect(ctx);
         return true;
     }
-    if (trimmed === "update") {
+    if (trimmed === "update" || trimmed === "upgrade") {
         await handleUpdate(ctx);
         return true;
     }

package/dist/resources/extensions/gsd/commands-bootstrap.js

@@ -44,6 +44,7 @@ const TOP_LEVEL_SUBCOMMANDS = [
     { cmd: "park", desc: "Park a milestone" },
     { cmd: "unpark", desc: "Reactivate a parked milestone" },
     { cmd: "update", desc: "Update GSD to the latest version" },
+    { cmd: "upgrade", desc: "Alias for update; installs the latest @opengsd package" },
     { cmd: "start", desc: "Start a workflow template" },
     { cmd: "templates", desc: "List available workflow templates" },
     { cmd: "extensions", desc: "Manage extensions" },

package/dist/resources/extensions/gsd/commands-closeout.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Handles /gsd closeout recovery commands for failed git closeout.
 import { ensureDbOpen } from "./bootstrap/dynamic-tools.js";
 import { formatCloseoutAutoBlockMessage, listCloseoutFailures, listUnresolvedCloseoutFailures, markLatestCloseoutFailureResolved, retryLatestCloseoutFailure, } from "./closeout-recovery.js";

package/dist/resources/extensions/gsd/commands-ship.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Ship command for creating pull requests from GSD milestone evidence.
 import { execFileSync } from "node:child_process";
 import { existsSync, readFileSync, readdirSync } from "node:fs";

package/dist/resources/extensions/gsd/commands-verdict.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Handles manual milestone validation verdict overrides.
 import { loadFile } from "./files.js";
 import { resolveMilestoneFile } from "./paths.js";

package/dist/resources/extensions/gsd/commands-workflow-templates.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Workflow template commands for starting, listing, and dispatching workflows.
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/resources/extensions/gsd/commands-worktree.js

@@ -1,4 +1,4 @@
-// GSD-2 — In-TUI handler for /gsd worktree commands (list, merge, clean, remove).
+// gsd-pi — In-TUI handler for /gsd worktree commands (list, merge, clean, remove).
 //
 // Mirrors the CLI subcommands in src/worktree-cli.ts but emits results via
 // ctx.ui.notify() instead of writing colored output to stderr. Reuses the

package/dist/resources/extensions/gsd/component-loader.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Loads modern component.yaml definitions and legacy skill/agent formats.
 import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { basename, dirname, join } from 'node:path';

package/dist/resources/extensions/gsd/db/auto-workers.js

@@ -1,4 +1,4 @@
-// gsd-2 + Auto-mode worker process registry (DB-backed coordination, Phase B)
+// gsd-pi + Auto-mode worker process registry (DB-backed coordination, Phase B)
 //
 // IMPORTANT — naming clarification (codex review LOW N1):
 // This module is the AUTO-MODE PROCESS REGISTRY. It tracks long-running

package/dist/resources/extensions/gsd/db/command-queue.js

@@ -1,4 +1,4 @@
-// gsd-2 + Worker IPC command queue (DB-backed coordination, Phase B)
+// gsd-pi + Worker IPC command queue (DB-backed coordination, Phase B)
 //
 // New infrastructure for dispatcher-to-worker IPC (cancel signals, pause
 // requests, etc.). NOT a replacement for any existing on-disk queue and

package/dist/resources/extensions/gsd/db/milestone-leases.js

@@ -1,4 +1,4 @@
-// gsd-2 + Milestone leases with fencing tokens (DB-backed coordination, Phase B)
+// gsd-pi + Milestone leases with fencing tokens (DB-backed coordination, Phase B)
 //
 // One worker at a time may hold a lease on a given milestone. Leases carry a
 // monotonic fencing token that increments on every successful takeover, so
@@ -87,10 +87,13 @@ export function claimMilestoneLease(workerId, milestoneId) {
             return { ok: true, token: 1, expiresAt: expiresIso };
         }
         // Step 2: takeover. Conditional UPDATE — only succeeds if the existing
-        // lease is expired or explicitly released. Fencing token is incremented
-        // by SQL (`fencing_token + 1`) so the new holder's token monotonically
-        // exceeds the prior holder's. db.changes() === 1 confirms the takeover
-        // actually happened (vs. losing the race to another worker).
+        // lease is expired/released, or if the claimant is a re-entrant worker row
+        // for the same live host/PID/project. The latter prevents a single
+        // orchestrator process from blocking on its own previous worker token.
+        // Fencing token is incremented by SQL (`fencing_token + 1`) so the new
+        // holder's token monotonically exceeds the prior holder's. db.changes()
+        // === 1 confirms the takeover actually happened (vs. losing the race to
+        // another worker).
         const updateResult = db.prepare(`UPDATE milestone_leases
        SET worker_id = :worker_id,
            fencing_token = fencing_token + 1,
@@ -99,7 +102,18 @@ export function claimMilestoneLease(workerId, milestoneId) {
            status = 'held'
        WHERE milestone_id = :milestone_id
          AND (status IN ('expired','released')
-              OR datetime(expires_at) < datetime('now'))`).run({
+              OR datetime(expires_at) < datetime('now')
+              OR EXISTS (
+                SELECT 1
+                FROM workers holder
+                JOIN workers claimant ON claimant.worker_id = :worker_id
+                WHERE holder.worker_id = milestone_leases.worker_id
+                  AND holder.status = 'active'
+                  AND claimant.status = 'active'
+                  AND holder.host = claimant.host
+                  AND holder.pid = claimant.pid
+                  AND holder.project_root_realpath = claimant.project_root_realpath
+              ))`).run({
             ":milestone_id": milestoneId,
             ":worker_id": workerId,
             ":acquired_at": nowIso,

package/dist/resources/extensions/gsd/db/runtime-kv.js

@@ -1,4 +1,4 @@
-// gsd-2 + Non-correctness-critical key-value storage (Phase C — file-state migration)
+// gsd-pi + Non-correctness-critical key-value storage (Phase C — file-state migration)
 //
 // STRICT INVARIANT (re-stated from gsd-db.ts createRuntimeKvTableV25):
 // runtime_kv is for SOFT state only. UI cursors, dashboard caches,

package/dist/resources/extensions/gsd/db/unit-dispatches.js

@@ -1,4 +1,4 @@
-// gsd-2 + Unit dispatch ledger (DB-backed coordination, Phase B)
+// gsd-pi + Unit dispatch ledger (DB-backed coordination, Phase B)
 //
 // Records every auto-mode unit dispatch (plan-slice, run-task, summarize, …)
 // with worker_id, fencing token, status lifecycle, and retry metadata. The

package/dist/resources/extensions/gsd/db-adapter.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Normalized SQLite adapter wrapper used by the GSD database facade.
 export function normalizeDbRow(row) {
     if (row == null)

package/dist/resources/extensions/gsd/db-base-schema.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Base table, index, and view DDL for the GSD database facade.
 export function createBaseSchemaObjects(db, hooks) {
     db.exec(`

package/dist/resources/extensions/gsd/db-connection-cache.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Workspace-scoped database connection cache helpers for the GSD database facade.
 export class DbConnectionCache {
     entries = new Map();

package/dist/resources/extensions/gsd/db-coordination-schema.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Auto-mode coordination SQLite schema helper for the GSD database facade.
 /**
  * Create the v24 coordination tables (workers, milestone_leases,

package/dist/resources/extensions/gsd/db-decision-requirement-rows.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Decision and requirement row mappers for the GSD database facade.
 export function rowToDecision(row) {
     return {

package/dist/resources/extensions/gsd/db-gate-rows.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Quality gate row mapper for the GSD database facade.
 export function rowToGate(row) {
     return {

package/dist/resources/extensions/gsd/db-lightweight-query-rows.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Lightweight DB query row mappers for hot-path status reads.
 export function rowToIdStatusSummary(row) {
     return {

package/dist/resources/extensions/gsd/db-memory-fts-schema.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Memory FTS5 SQLite schema helpers for the GSD database facade.
 function formatFtsUnavailableError(err) {
     const message = err instanceof Error ? err.message : String(err);

package/dist/resources/extensions/gsd/db-migration-backup.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Pre-migration backup helper for GSD database schema upgrades.
 export function backupDatabaseBeforeMigration(db, dbPath, currentVersion, deps) {
     if (!dbPath || dbPath === ":memory:" || !deps.existsSync(dbPath))

package/dist/resources/extensions/gsd/db-migration-steps.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Schema migration DDL steps for the GSD database facade.
 import { ensureColumn } from "./db-schema-metadata.js";
 export function applyMigrationV2Artifacts(db) {

package/dist/resources/extensions/gsd/db-milestone-artifact-rows.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Milestone and artifact row mappers for the GSD database facade.
 export function rowToMilestone(row) {
     return {

package/dist/resources/extensions/gsd/db-open-state.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Tracks database open attempt and error status for the GSD database facade.
 export class DbOpenState {
     attempted = false;

package/dist/resources/extensions/gsd/db-provider.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: SQLite provider loading and fallback helpers for the GSD database facade.
 export const BETTER_SQLITE3_PACKAGE = ["better", "sqlite3"].join("-");
 export function suppressSqliteWarning() {

package/dist/resources/extensions/gsd/db-runtime-kv-schema.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Runtime key-value SQLite schema helper for the GSD database facade.
 /**
  * Create the v25 runtime_kv table. Idempotent — uses IF NOT EXISTS.

package/dist/resources/extensions/gsd/db-schema-metadata.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: SQLite schema metadata helpers for the GSD database facade and migrations.
 export function indexExists(db, name) {
     return !!db.prepare("SELECT 1 as present FROM sqlite_master WHERE type = 'index' AND name = ?").get(name);

package/dist/resources/extensions/gsd/db-task-slice-rows.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Task and slice row mappers for the GSD database facade.
 export function parseTaskArrayColumn(raw) {
     if (Array.isArray(raw)) {

package/dist/resources/extensions/gsd/db-transaction.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Transaction depth helper for the GSD database facade.
 export class DbTransactionRunner {
     depth = 0;

package/dist/resources/extensions/gsd/db-verification-evidence-rows.js

@@ -1,3 +1,3 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verification evidence row contract for GSD workflow database consumers.
 export {};

package/dist/resources/extensions/gsd/db-verification-evidence-schema.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Verification evidence SQLite schema helpers for the GSD database facade.
 import { indexExists } from "./db-schema-metadata.js";
 export function dedupeVerificationEvidenceRows(db) {

package/dist/resources/extensions/gsd/doctor-git-checks.js

@@ -1,4 +1,4 @@
-// GSD-2 doctor git health checks
+// gsd-pi doctor git health checks
 import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
 import { join } from "node:path";

package/dist/resources/extensions/gsd/ecosystem/gsd-extension-api.js

@@ -1,4 +1,4 @@
-// GSD2 — Ecosystem Extension API wrapper
+// gsd-pi — Ecosystem Extension API wrapper
 // Wraps pi's ExtensionAPI to expose typed GSD context (phase + active unit)
 // to extensions loaded from `./.gsd/extensions/`. The wrapper intercepts only
 // `on("before_agent_start", ...)` so GSD can dispatch ecosystem handlers AFTER

package/dist/resources/extensions/gsd/ecosystem/loader.js

@@ -1,4 +1,4 @@
-// GSD2 — Ecosystem extension loader for ./.gsd/extensions/
+// gsd-pi — Ecosystem extension loader for ./.gsd/extensions/
 // Discovers and registers single-file extensions that consume GSDExtensionAPI.
 // Trust-gated (mirrors pi's `.pi/extensions/` model) and isolated from pi's
 // own loader chain — handlers run in GSD's own dispatch step, not pi's.

package/dist/resources/extensions/gsd/escalation.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Mid-execution escalation artifact and state helpers for GSD tasks.
 // GSD Extension — ADR-011 Phase 2 Mid-Execution Escalation
 //

package/dist/resources/extensions/gsd/fresh-run-ui.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Clears stale GSD run surfaces before starting new workflow work.
 const FRESH_RUN_COMMANDS = new Set([
     "",

package/dist/resources/extensions/gsd/git-conflict-state.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Detect unresolved Git conflict state before automation runs.
 import { execFileSync } from "node:child_process";
 import { GIT_NO_PROMPT_ENV } from "./git-constants.js";

package/dist/resources/extensions/gsd/git-service.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Git operations, commit-message formatting, and turn git actions.
 /**
  * GSD Git Service

package/dist/resources/extensions/gsd/gsd-command-home.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: State-aware home menu for the bare /gsd command.
 import { showNextAction } from "../shared/tui.js";
 import { startAutoDetached } from "./auto.js";

package/dist/resources/extensions/gsd/gsd-db.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: GSD database facade, schema, migrations, and single-writer write API.
 // GSD Database Abstraction Layer
 // Provides a SQLite database with provider fallback chain:

package/dist/resources/extensions/gsd/guided-unit-context.js

@@ -1,4 +1,4 @@
-// GSD-2 — Guided workflow Unit context.
+// gsd-pi — Guided workflow Unit context.
 // Tracks the guided Unit whose queued turn should use manifest Tool Contract policy.
 const guidedUnitContextByBasePath = new Map();
 export function setGuidedUnitContext(basePath, unitType) {

package/dist/resources/extensions/gsd/health-widget.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Always-on ambient health signal rendered below the editor.
 import { runProviderChecks, summariseProviderIssues } from "./doctor-providers.js";
 import { runEnvironmentChecks } from "./doctor-environment.js";

package/dist/resources/extensions/gsd/knowledge-backfill.js

@@ -1,4 +1,4 @@
-// GSD2 — KNOWLEDGE.md -> memories backfill (ADR-013 Stage 2b).
+// gsd-pi — KNOWLEDGE.md -> memories backfill (ADR-013 Stage 2b).
 //
 // Idempotent migration of `.gsd/KNOWLEDGE.md` Patterns and Lessons rows into
 // the `memories` table. Patterns become memories with `category: "pattern"`;

package/dist/resources/extensions/gsd/knowledge-capture.js

@@ -1,4 +1,4 @@
-// GSD2 — KNOWLEDGE.md write-side cutover (ADR-013 Stage 2c).
+// gsd-pi — KNOWLEDGE.md write-side cutover (ADR-013 Stage 2c).
 //
 // Replaces the legacy `appendKnowledge` file-append path for Patterns and
 // Lessons with `createMemory` calls. Rules (K###) continue to flow through

package/dist/resources/extensions/gsd/knowledge-parser.js

@@ -1,4 +1,4 @@
-// GSD-2 — KNOWLEDGE.md parsing helpers shared by the consolidation scanner,
+// gsd-pi — KNOWLEDGE.md parsing helpers shared by the consolidation scanner,
 // the Patterns/Lessons backfill, and the hybrid projection renderer
 // (ADR-013 Stage 2a/2b).
 //

package/dist/resources/extensions/gsd/knowledge-projection.js

@@ -1,4 +1,4 @@
-// GSD2 — KNOWLEDGE.md hybrid projection renderer (ADR-013 Stage 2b).
+// gsd-pi — KNOWLEDGE.md hybrid projection renderer (ADR-013 Stage 2b).
 //
 // Renders `.gsd/KNOWLEDGE.md` as a hybrid file:
 //   - Rules section: read directly from the existing KNOWLEDGE.md (manual,

package/dist/resources/extensions/gsd/legacy-telemetry.js

@@ -1,10 +1,9 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Runtime counters for telemetry-gated legacy compatibility paths.
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 import { logWarning } from "./workflow-logger.js";
 const COUNTERS = [
-    "legacy.markdownFallbackUsed",
     "legacy.workflowEngineUsed",
     "legacy.uokFallbackUsed",
     "legacy.mcpAliasUsed",
@@ -14,7 +13,6 @@ const COUNTERS = [
 const values = Object.fromEntries(COUNTERS.map((counter) => [counter, 0]));
 const warnedCounters = new Set();
 const DIAGNOSTICS = {
-    "legacy.markdownFallbackUsed": "Deprecated markdown state fallback used; migrate projects to DB-authoritative state before removing markdown derivation.",
     "legacy.workflowEngineUsed": "Deprecated workflow engine path used; prefer auto-milestone workflow templates before removing legacy engines.",
     "legacy.uokFallbackUsed": "Deprecated UOK fallback path used; resolve UOK kernel blockers before removing parity fallback wrappers.",
     "legacy.mcpAliasUsed": "Deprecated MCP alias tool used; update callers to the canonical gsd_* tool name before alias removal.",

package/dist/resources/extensions/gsd/markdown-renderer.js

@@ -1,4 +1,4 @@
-// Project/App: GSD-2
+// Project/App: gsd-pi
 // File Purpose: Markdown projection renderer for GSD workflow database rows.
 // GSD Markdown Renderer — DB → Markdown file generation
 //

package/dist/resources/extensions/gsd/md-importer.js

@@ -138,8 +138,8 @@ export function parseRequirementsSections(content) {
             }
             continue;
         }
-        // Check for requirement heading (### RXXX — Title)
-        const reqMatch = line.match(/^###\s+(R\d+)\s*[—–-]\s*(.+)/);
+        // Check for requirement heading (### RXXX — Title or ### NET-01 — Title)
+        const reqMatch = line.match(/^###\s+([A-Z][A-Z0-9]*-\d+|R\d+)\s*[—–-]\s*(.+)/i);
         if (reqMatch) {
             flushReq();
             if (currentSectionStatus !== null) {

package/dist/resources/extensions/gsd/memory-backfill.js

@@ -1,4 +1,4 @@
-// GSD2 — Decisions -> memories backfill (ADR-013 step 5)
+// gsd-pi — Decisions -> memories backfill (ADR-013 step 5)
 //
 // Idempotent migration that copies every decisions row (active and
 // superseded — see Stage 2a note below) into the memories table with

package/dist/resources/extensions/gsd/memory-consolidation-scanner.js

@@ -1,4 +1,4 @@
-// GSD-2 — ADR-013 Phase 6 preflight scanner.
+// gsd-pi — ADR-013 Phase 6 preflight scanner.
 //
 // Read-only detection of rows in the legacy knowledge surfaces (decisions
 // table, `.gsd/KNOWLEDGE.md`) that lack a corresponding `memories` row.

package/dist/resources/extensions/gsd/metrics.js

@@ -1,4 +1,4 @@
-// GSD-2 + metrics.ts: token & cost tracking for auto-mode units
+// gsd-pi + metrics.ts: token & cost tracking for auto-mode units
 /**
  * GSD Metrics — Token & Cost Tracking
  *

package/dist/resources/extensions/gsd/migrate/audit.js

@@ -1,4 +1,4 @@
-// GSD-2 - /gsd migrate audit helpers.
+// gsd-pi - /gsd migrate audit helpers.
 // File Purpose: Legacy archive, migration manifest, and projection verification support.
 import { cpSync, existsSync, readFileSync } from "node:fs";
 import { join, relative } from "node:path";
@@ -31,7 +31,7 @@ export async function archiveLegacyPlanningDirectory(sourcePath, targetRoot) {
         sourcePath,
         archivePath: relToGsd(targetRoot, archivePath),
         strategy: "full-source-copy",
-        note: "Full .planning source copied so legacy content without a GSD-2 field is not lost.",
+        note: "Full .planning source copied so legacy content without a gsd-pi field is not lost.",
     };
     await saveFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
     return {
@@ -59,6 +59,7 @@ export async function verifyMigrationProjection(targetRoot, preview) {
     return {
         markdown,
         db,
+        dbReadiness: { phase: "not-checked", registry: 0 },
         rendered: render.rendered,
         skipped: render.skipped,
         errors,
@@ -89,6 +90,7 @@ function formatMigrationMarkdown(input) {
         "",
         `- DB: ${input.verification.db.milestones}M/${input.verification.db.slices}S/${input.verification.db.tasks}T`,
         `- Markdown: ${input.verification.markdown.milestones}M/${input.verification.markdown.slices}S/${input.verification.markdown.tasks}T`,
+        `- DB readiness: ${input.verification.dbReadiness.phase} (${input.verification.dbReadiness.registry} milestone(s) visible)`,
         `- Rendered: ${input.verification.rendered}`,
         `- Skipped: ${input.verification.skipped}`,
         "",

package/dist/resources/extensions/gsd/migrate/command.js

@@ -6,7 +6,7 @@
  * All business logic lives in the pipeline modules (S01–S03).
  *
  * After a successful write, offers a read-only review that audits the output
- * for GSD-2 standards compliance.
+ * for gsd-pi standards compliance.
  */
 import { existsSync, readFileSync } from "node:fs";
 import { join, dirname } from "node:path";
@@ -17,7 +17,7 @@ import { validatePlanningDirectory, parsePlanningDirectory, transformToGSD, gene
 import { ensureDbOpen } from "../bootstrap/dynamic-tools.js";
 import { clearArtifacts, clearDecisions, clearRequirements, clearEngineHierarchy, transaction } from "../gsd-db.js";
 import { migrateFromMarkdown } from "../md-importer.js";
-import { invalidateStateCache } from "../state.js";
+import { deriveState, invalidateStateCache } from "../state.js";
 import { archiveLegacyPlanningDirectory, verifyMigrationProjection, writeMigrationAudit, } from "./audit.js";
 import { assertMigrationHasSlices, assertMigrationTargetAvailable, prepareMigrationTarget, resolveMigrationPaths, restoreMigrationTarget, } from "./safety.js";
 function assertMigrationImportMatchesPreview(imported, preview) {
@@ -59,6 +59,21 @@ export async function importWrittenMigrationToDb(basePath, preview) {
     invalidateStateCache();
     return counts;
 }
+export async function assertMigrationDbReadiness(targetRoot, preview) {
+    invalidateStateCache();
+    const state = await deriveState(targetRoot);
+    const dbUnavailable = state.blockers.some((blocker) => blocker.includes("DB unavailable"));
+    if (dbUnavailable) {
+        throw new Error(`migration DB readiness failed: ${state.blockers.join("; ")}`);
+    }
+    if (state.registry.length !== preview.milestoneCount) {
+        throw new Error(`migration DB readiness failed: registry ${state.registry.length}/${preview.milestoneCount}`);
+    }
+    return {
+        phase: state.phase,
+        registry: state.registry.length,
+    };
+}
 export async function executeMigrationWrite(sourcePath, targetRoot, project, preview, startedAt = new Date().toISOString()) {
     const backup = prepareMigrationTarget(targetRoot);
     try {
@@ -66,6 +81,7 @@ export async function executeMigrationWrite(sourcePath, targetRoot, project, pre
         const legacyArchive = await archiveLegacyPlanningDirectory(sourcePath, targetRoot);
         const imported = await importWrittenMigrationToDb(targetRoot, preview);
         const verification = await verifyMigrationProjection(targetRoot, preview);
+        verification.dbReadiness = await assertMigrationDbReadiness(targetRoot, preview);
         const audit = await writeMigrationAudit({
             sourcePath,
             targetRoot,
@@ -94,7 +110,10 @@ function formatPreviewStats(preview) {
         `- Tasks: ${preview.totalTasks} (${preview.doneTasks} done — ${preview.taskCompletionPct}%)`,
     ];
     if (preview.requirements.total > 0) {
-        lines.push(`- Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred)`);
+        lines.push(`- Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred, ${preview.requirements.outOfScope} out of scope)`);
+    }
+    if (preview.migrationInputs) {
+        lines.push(`- Legacy inputs: ${preview.migrationInputs.milestonePhaseDirs} milestone phase dir(s), ${preview.migrationInputs.decisions} decision file(s), ${preview.migrationInputs.seeds} seed file(s)`);
     }
     return lines.join("\n");
 }
@@ -161,7 +180,10 @@ export async function handleMigrate(args, ctx, pi) {
         `Tasks: ${preview.totalTasks} (${preview.doneTasks} done — ${preview.taskCompletionPct}%)`,
     ];
     if (preview.requirements.total > 0) {
-        lines.push(`Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred)`);
+        lines.push(`Requirements: ${preview.requirements.total} (${preview.requirements.validated} validated, ${preview.requirements.active} active, ${preview.requirements.deferred} deferred, ${preview.requirements.outOfScope} out of scope)`);
+    }
+    if (preview.migrationInputs) {
+        lines.push(`Legacy inputs: ${preview.migrationInputs.milestonePhaseDirs} milestone phase dir(s), ${preview.migrationInputs.decisions} decision file(s), ${preview.migrationInputs.seeds} seed file(s)`);
     }
     const targetGsdExists = existsSync(gsdRoot(targetRoot));
     if (targetGsdExists) {
@@ -214,7 +236,7 @@ export async function handleMigrate(args, ctx, pi) {
             `Legacy source archived at ${execution.legacyArchive.archivePath}`,
             `Migration audit written at ${execution.audit.migrationPath}`,
             "",
-            "The agent can now review the migrated output against GSD-2 standards —",
+            "The agent can now review the migrated output against gsd-pi standards —",
             "checking structure, content quality, deriveState() round-trip, and",
             "requirement statuses. The review is read-only by default.",
         ],