gsd-pi 2.78.1-dev.0fdacd524 → 2.78.1-dev.2ff77b0ce

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

@@ -26,6 +26,7 @@ import { GSDError, GSD_STALE_STATE } from "./errors.js";
 import { getGateIdsForTurn } from "./gate-registry.js";
 import { logError, logWarning } from "./workflow-logger.js";
 const _require = createRequire(import.meta.url);
+const BETTER_SQLITE3_PACKAGE = ["better", "sqlite3"].join("-");
 let providerName = null;
 let providerModule = null;
 let loadAttempted = false;
@@ -63,7 +64,7 @@ function loadProvider() {
         // unavailable
     }
     try {
-        const mod = _require("better-sqlite3");
+        const mod = _require(BETTER_SQLITE3_PACKAGE);
         if (typeof mod === "function" || (mod && mod.default)) {
             providerModule = mod.default || mod;
             providerName = "better-sqlite3";
@@ -135,7 +136,7 @@ function openRawDb(path) {
     const Database = providerModule;
     return new Database(path);
 }
-export const SCHEMA_VERSION = 22;
+export const SCHEMA_VERSION = 23;
 function indexExists(db, name) {
     return !!db.prepare("SELECT 1 as present FROM sqlite_master WHERE type = 'index' AND name = ?").get(name);
 }
@@ -298,7 +299,8 @@ function initSchema(db, fileBacked) {
         verification_uat TEXT NOT NULL DEFAULT '',
         definition_of_done TEXT NOT NULL DEFAULT '[]',
         requirement_coverage TEXT NOT NULL DEFAULT '',
-        boundary_map_markdown TEXT NOT NULL DEFAULT ''
+        boundary_map_markdown TEXT NOT NULL DEFAULT '',
+        sequence INTEGER DEFAULT 0
       )
     `);
         db.exec(`
@@ -1130,6 +1132,16 @@ function migrateSchema(db) {
                 ":applied_at": new Date().toISOString(),
             });
         }
+        if (currentVersion < 23) {
+            // v23: milestone queue ordering moves into the canonical DB. The
+            // historical QUEUE-ORDER.json file remains a projection, but runtime
+            // derivation must not read it as authoritative state.
+            ensureColumn(db, "milestones", "sequence", "ALTER TABLE milestones ADD COLUMN sequence INTEGER DEFAULT 0");
+            db.prepare("INSERT INTO schema_version (version, applied_at) VALUES (:version, :applied_at)").run({
+                ":version": 23,
+                ":applied_at": new Date().toISOString(),
+            });
+        }
         db.exec("COMMIT");
     }
     catch (err) {
@@ -1191,7 +1203,7 @@ export function openDatabase(path) {
         // node:sqlite loaded but failed to open this file — try better-sqlite3 as fallback.
         if (providerName === "node:sqlite") {
             try {
-                const mod = _require("better-sqlite3");
+                const mod = _require(BETTER_SQLITE3_PACKAGE);
                 const Db = (mod && mod.default) ? mod.default : mod;
                 if (typeof Db === "function") {
                     rawDb = new Db(path);
@@ -1517,6 +1529,31 @@ export function getActiveRequirements() {
         superseded_by: null,
     }));
 }
+export function getRequirementCounts() {
+    if (!currentDb) {
+        return { active: 0, validated: 0, deferred: 0, outOfScope: 0, blocked: 0, total: 0 };
+    }
+    const rows = currentDb
+        .prepare("SELECT lower(status) as status, COUNT(*) as count FROM requirements GROUP BY lower(status)")
+        .all();
+    const counts = { active: 0, validated: 0, deferred: 0, outOfScope: 0, blocked: 0, total: 0 };
+    for (const row of rows) {
+        const status = String(row["status"] ?? "");
+        const count = Number(row["count"] ?? 0);
+        counts.total += count;
+        if (status === "active")
+            counts.active += count;
+        else if (status === "validated")
+            counts.validated += count;
+        else if (status === "deferred")
+            counts.deferred += count;
+        else if (status === "out-of-scope" || status === "out_of_scope")
+            counts.outOfScope += count;
+        else if (status === "blocked")
+            counts.blocked += count;
+    }
+    return counts;
+}
 export function getDbOwnerPid() {
     return currentPid;
 }
@@ -2163,6 +2200,7 @@ function rowToMilestone(row) {
         definition_of_done: JSON.parse(row["definition_of_done"] || "[]"),
         requirement_coverage: row["requirement_coverage"] ?? "",
         boundary_map_markdown: row["boundary_map_markdown"] ?? "",
+        sequence: Number(row["sequence"] ?? 0),
     };
 }
 function rowToArtifact(row) {
@@ -2179,7 +2217,7 @@ function rowToArtifact(row) {
 export function getAllMilestones() {
     if (!currentDb)
         return [];
-    const rows = currentDb.prepare("SELECT * FROM milestones ORDER BY id").all();
+    const rows = currentDb.prepare("SELECT * FROM milestones ORDER BY CASE WHEN sequence > 0 THEN 0 ELSE 1 END, sequence, id").all();
     return rows.map(rowToMilestone);
 }
 export function getMilestone(id) {
@@ -2190,6 +2228,23 @@ export function getMilestone(id) {
         return null;
     return rowToMilestone(row);
 }
+export function setMilestoneQueueOrder(order) {
+    if (!currentDb)
+        throw new GSDError(GSD_STALE_STATE, "gsd-db: No database open");
+    currentDb.exec("BEGIN IMMEDIATE");
+    try {
+        currentDb.prepare("UPDATE milestones SET sequence = 0").run();
+        const stmt = currentDb.prepare("UPDATE milestones SET sequence = :sequence WHERE id = :id");
+        order.forEach((id, index) => {
+            stmt.run({ ":id": id, ":sequence": index + 1 });
+        });
+        currentDb.exec("COMMIT");
+    }
+    catch (err) {
+        currentDb.exec("ROLLBACK");
+        throw err;
+    }
+}
 /**
  * Update a milestone's status in the database.
  * Used by park/unpark to keep the DB in sync with the filesystem marker.
@@ -2357,6 +2412,8 @@ export function reconcileWorktreeDb(mainDbPath, worktreeDbPath) {
             // fall through to the main DB's existing value (not a literal default)
             // so reconcile never silently clears state the main tree has recorded.
             const hasDecisionSource = wtInfo.some((col) => col["name"] === "source");
+            const wtMilestoneInfo = adapter.prepare("PRAGMA wt.table_info('milestones')").all();
+            const hasMilestoneSequence = wtMilestoneInfo.some((col) => col["name"] === "sequence");
             const wtSliceInfo = adapter.prepare("PRAGMA wt.table_info('slices')").all();
             const hasIsSketch = wtSliceInfo.some((col) => col["name"] === "is_sketch");
             const hasSketchScope = wtSliceInfo.some((col) => col["name"] === "sketch_scope");
@@ -2414,7 +2471,7 @@ export function reconcileWorktreeDb(mainDbPath, worktreeDbPath) {
             id, title, status, depends_on, created_at, completed_at,
             vision, success_criteria, key_risks, proof_strategy,
             verification_contract, verification_integration, verification_operational, verification_uat,
-            definition_of_done, requirement_coverage, boundary_map_markdown
+            definition_of_done, requirement_coverage, boundary_map_markdown, sequence
           )
           SELECT w.id, w.title,
                  CASE
@@ -2432,7 +2489,8 @@ export function reconcileWorktreeDb(mainDbPath, worktreeDbPath) {
                  END,
                  w.vision, w.success_criteria, w.key_risks, w.proof_strategy,
                  w.verification_contract, w.verification_integration, w.verification_operational, w.verification_uat,
-                 w.definition_of_done, w.requirement_coverage, w.boundary_map_markdown
+                 w.definition_of_done, w.requirement_coverage, w.boundary_map_markdown,
+                 ${hasMilestoneSequence ? "COALESCE(w.sequence, 0)" : "COALESCE(m.sequence, 0)"}
           FROM wt.milestones w
           LEFT JOIN milestones m ON m.id = w.id
         `).run());
@@ -2658,6 +2716,15 @@ export function getAssessment(path) {
     const row = currentDb.prepare(`SELECT * FROM assessments WHERE path = :path`).get({ ":path": path });
     return row ?? null;
 }
+export function getLatestAssessmentByScope(milestoneId, scope) {
+    if (!currentDb)
+        return null;
+    const row = currentDb.prepare(`SELECT * FROM assessments
+      WHERE milestone_id = :mid AND scope = :scope
+      ORDER BY created_at DESC
+      LIMIT 1`).get({ ":mid": milestoneId, ":scope": scope });
+    return row ?? null;
+}
 // ─── Quality Gates ───────────────────────────────────────────────────────
 function rowToGate(row) {
     return {
@@ -3026,10 +3093,10 @@ export function restoreManifest(manifest) {
         const msStmt = db.prepare(`INSERT INTO milestones (id, title, status, depends_on, created_at, completed_at,
         vision, success_criteria, key_risks, proof_strategy,
         verification_contract, verification_integration, verification_operational, verification_uat,
-        definition_of_done, requirement_coverage, boundary_map_markdown)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        definition_of_done, requirement_coverage, boundary_map_markdown, sequence)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
         for (const m of manifest.milestones) {
-            msStmt.run(m.id, m.title, m.status, JSON.stringify(m.depends_on), m.created_at, m.completed_at, m.vision, JSON.stringify(m.success_criteria), JSON.stringify(m.key_risks), JSON.stringify(m.proof_strategy), m.verification_contract, m.verification_integration, m.verification_operational, m.verification_uat, JSON.stringify(m.definition_of_done), m.requirement_coverage, m.boundary_map_markdown);
+            msStmt.run(m.id, m.title, m.status, JSON.stringify(m.depends_on), m.created_at, m.completed_at, m.vision, JSON.stringify(m.success_criteria), JSON.stringify(m.key_risks), JSON.stringify(m.proof_strategy), m.verification_contract, m.verification_integration, m.verification_operational, m.verification_uat, JSON.stringify(m.definition_of_done), m.requirement_coverage, m.boundary_map_markdown, m.sequence ?? 0);
         }
         // Restore slices (ADR-011 Phase 1: includes is_sketch + sketch_scope)
         const slStmt = db.prepare(`INSERT INTO slices (milestone_id, id, title, status, risk, depends, demo,

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

@@ -0,0 +1,29 @@
+/**
+ * GSD home directory resolution.
+ *
+ * Exports gsdHome() which returns the GSD configuration directory,
+ * defaulting to ~/.gsd with a GSD_HOME env var override.
+ *
+ * For the user's home directory, use os.homedir() directly — it handles
+ * platform-specific env lookup (USERPROFILE on Windows, HOME on POSIX)
+ * with appropriate fallbacks.
+ *
+ * @see https://github.com/gsd-build/gsd-2/issues/5015
+ */
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+/**
+ * Resolve the GSD home directory (typically ~/.gsd).
+ *
+ * `GSD_HOME` env var overrides the default location.
+ * Falls back to `homedir()/.gsd`.
+ *
+ * Always returns an absolute, normalized path — `resolve()` canonicalizes
+ * any relative or non-canonical `GSD_HOME` value so downstream comparison
+ * and redaction sites don't have to.
+ */
+export function gsdHome() {
+    return process.env.GSD_HOME
+        ? resolve(process.env.GSD_HOME)
+        : join(homedir(), ".gsd");
+}