@opengsd/gsd-pi 1.2.0-dev.e8563f58 → 1.2.0-dev.fbdca60b

package/src/resources/extensions/gsd/tests/remote-notification-from-desktop.test.ts

@@ -5,103 +5,53 @@
  * as a fire-and-forget side-effect so that Telegram/Slack/Discord channels
  * receive the same events as native desktop notifications.
  *
- * Testing strategy (structural analysis):
- *   node:test does not support mock.module without --experimental-test-module-mocks,
- *   so we use the same source-code structural approach established in this codebase
- *   (see session-start-footer.test.ts). We read notifications.ts and assert that:
- *     1. It imports sendRemoteNotification from the remote-questions/notify module.
- *     2. The sendDesktopNotification function body calls sendRemoteNotification
- *        with title and message as arguments.
- *     3. The call uses the void fire-and-forget pattern with a .catch(() => {})
- *        suppressor so that async failures never break the synchronous caller.
+ * Testing strategy (behavioral):
+ *   Import sendDesktopNotification and the swappable remoteNotificationDispatcher.
+ *   Mock the dispatcher's send method, call sendDesktopNotification, and assert
+ *   that the dispatcher received the same title/message and that the call is
+ *   fire-and-forget (the function returns without awaiting).
  *
  * Relates to #4341.
  */
 
 import test from "node:test";
 import assert from "node:assert/strict";
-import { readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
 
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const SOURCE = readFileSync(join(__dirname, "..", "notifications.ts"), "utf-8");
+import {
+  sendDesktopNotification,
+  remoteNotificationDispatcher,
+} from "../notifications.js";
 
-test("notifications.ts imports sendRemoteNotification from remote-questions/notify", () => {
-  const hasImport =
-    SOURCE.includes('from "../remote-questions/notify.js"') ||
-    SOURCE.includes("from '../remote-questions/notify.js'");
-  assert.ok(
-    hasImport,
-    "notifications.ts must import from '../remote-questions/notify.js'",
-  );
-
-  const importLine = SOURCE.split("\n").find(
-    (line) =>
-      line.includes("sendRemoteNotification") &&
-      (line.includes("remote-questions/notify") || line.includes("remote-questions/notify.js")),
-  );
-  assert.ok(
-    importLine,
-    "The import statement must include sendRemoteNotification from the remote-questions/notify module",
-  );
-});
-
-test("sendDesktopNotification calls sendRemoteNotification(title, message)", () => {
-  // Extract the body of sendDesktopNotification — from its opening brace to the
-  // closing brace at the same indentation level.
-  const fnStart = SOURCE.indexOf("export function sendDesktopNotification(");
-  assert.ok(fnStart > -1, "sendDesktopNotification must be present in notifications.ts");
+test("sendDesktopNotification calls sendRemoteNotification with title and message", async (t) => {
+  const sendMock = t.mock.method(remoteNotificationDispatcher, "send", async () => {});
 
-  // Find the next exported function/const after sendDesktopNotification to bound the search.
-  const nextExportIdx = SOURCE.indexOf("\nexport ", fnStart + 1);
-  const fnBody = nextExportIdx > -1 ? SOURCE.slice(fnStart, nextExportIdx) : SOURCE.slice(fnStart);
-
-  assert.ok(
-    fnBody.includes("sendRemoteNotification"),
-    "sendDesktopNotification must call sendRemoteNotification",
-  );
+  sendDesktopNotification("Test Title", "Test Message");
 
-  assert.ok(
-    fnBody.includes("sendRemoteNotification(title") || fnBody.includes("sendRemoteNotification(title,"),
-    "sendRemoteNotification must be called with title as first argument",
-  );
+  assert.equal(sendMock.mock.callCount(), 1);
+  assert.deepEqual(sendMock.mock.calls[0].arguments, ["Test Title", "Test Message"]);
 });
 
-test("sendRemoteNotification is invoked as void fire-and-forget with .catch(() => {})", () => {
-  const fnStart = SOURCE.indexOf("export function sendDesktopNotification(");
-  const nextExportIdx = SOURCE.indexOf("\nexport ", fnStart + 1);
-  const fnBody = nextExportIdx > -1 ? SOURCE.slice(fnStart, nextExportIdx) : SOURCE.slice(fnStart);
+test("sendDesktopNotification does not await the remote notification", async (t) => {
+  const sendMock = t.mock.method(remoteNotificationDispatcher, "send", async () => {});
 
-  assert.ok(
-    fnBody.includes("void sendRemoteNotification("),
-    "sendRemoteNotification must be called with void (fire-and-forget)",
-  );
+  const result = sendDesktopNotification("Async Title", "Async Message");
 
-  assert.ok(
-    fnBody.includes(".catch("),
-    "sendRemoteNotification call must be followed by .catch() to suppress unhandled-rejection warnings",
-  );
+  assert.equal(result, undefined, "sendDesktopNotification must return void");
+  assert.equal(sendMock.mock.callCount(), 1);
 });
 
-test("sendRemoteNotification call appears before shouldSendDesktopNotification guard", () => {
-  // Regression guard for the HIGH-severity bug where remote notifications were
-  // gated behind the desktop-notification preference check. Users who disable
-  // desktop notifications must still receive Telegram/Slack/Discord messages.
-  const fnStart = SOURCE.indexOf("export function sendDesktopNotification(");
-  assert.ok(fnStart > -1, "sendDesktopNotification must be present in notifications.ts");
-
-  const nextExportIdx = SOURCE.indexOf("\nexport ", fnStart + 1);
-  const fnBody = nextExportIdx > -1 ? SOURCE.slice(fnStart, nextExportIdx) : SOURCE.slice(fnStart);
+test("sendDesktopNotification fires remote notification even when desktop notifications are disabled", async (t) => {
+  const sendMock = t.mock.method(remoteNotificationDispatcher, "send", async () => {});
 
-  const remoteCallIdx = fnBody.indexOf("sendRemoteNotification(");
-  const guardIdx = fnBody.indexOf("shouldSendDesktopNotification(");
-
-  assert.ok(remoteCallIdx > -1, "sendRemoteNotification must be called inside sendDesktopNotification");
-  assert.ok(guardIdx > -1, "shouldSendDesktopNotification guard must be present inside sendDesktopNotification");
-
-  assert.ok(
-    remoteCallIdx < guardIdx,
-    `sendRemoteNotification (pos ${remoteCallIdx}) must appear BEFORE the shouldSendDesktopNotification guard (pos ${guardIdx}) so that remote channels fire even when desktop notifications are disabled`,
+  sendDesktopNotification(
+    "Remote Title",
+    "Remote Message",
+    "info",
+    "complete",
+    undefined,
+    { notifications: { enabled: false } },
   );
+
+  assert.equal(sendMock.mock.callCount(), 1);
+  assert.deepEqual(sendMock.mock.calls[0].arguments, ["Remote Title", "Remote Message"]);
 });

package/src/resources/extensions/gsd/tests/roadmap-slices.test.ts

@@ -200,6 +200,74 @@ test("parseRoadmapSlices: checkbox slices with pipe characters do not switch to
   assert.deepEqual(slices[2]?.depends, ["S01", "S02"]);
 });
 
+test("parseRoadmapSlices: demo markdown table does not switch checkbox roadmap to table mode (#721)", () => {
+  const checkboxWithDemoTable = [
+    "# M004: Demo Table Repro",
+    "",
+    "## Slices",
+    "",
+    "- [x] **S01: First** `risk:low` `depends:[]`",
+    "  > After this: cli can render examples:",
+    "| Example | Meaning |",
+    "| --- | --- |",
+    "| S01 | Not a roadmap row |",
+    "- [ ] **S02: Second** `risk:medium` `depends:[S01]`",
+    "  > After this: cat file | sort returns stable output.",
+    "",
+  ].join("\n");
+
+  const slices = parseRoadmapSlices(checkboxWithDemoTable);
+  assert.equal(slices.length, 2);
+  assert.equal(slices[0]?.id, "S01");
+  assert.equal(slices[0]?.title, "First");
+  assert.equal(slices[0]?.done, true);
+  assert.equal(slices[1]?.id, "S02");
+  assert.deepEqual(slices[1]?.depends, ["S01"]);
+});
+
+test("parseRoadmapSlices: table preceded by intro prose still parsed as table (#722)", () => {
+  const tableWithIntro = [
+    "# M005: Intro Before Table",
+    "",
+    "## Slices",
+    "",
+    "This milestone is broken into the following slices:",
+    "",
+    "| Slice | Title | Risk | Status |",
+    "| --- | --- | --- | --- |",
+    "| S01 | Foundation | Low | [x] Done |",
+    "| S02 | Core | High | [ ] Pending |",
+    "",
+  ].join("\n");
+
+  const slices = parseRoadmapSlices(tableWithIntro);
+  assert.equal(slices.length, 2);
+  assert.equal(slices[0]?.id, "S01");
+  assert.equal(slices[0]?.done, true);
+  assert.equal(slices[1]?.id, "S02");
+  assert.equal(slices[1]?.done, false);
+});
+
+test("parseRoadmapSlices: table without markdown separator row still parsed as table (#722)", () => {
+  const tableWithoutSeparator = [
+    "# M006: No Separator",
+    "",
+    "## Slices",
+    "",
+    "| Slice | Title | Risk | Status |",
+    "| S01 | Foundation | Low | [x] Done |",
+    "| S02 | Core | High | [ ] Pending |",
+    "",
+  ].join("\n");
+
+  const slices = parseRoadmapSlices(tableWithoutSeparator);
+  assert.equal(slices.length, 2);
+  assert.equal(slices[0]?.id, "S01");
+  assert.equal(slices[0]?.done, true);
+  assert.equal(slices[1]?.id, "S02");
+  assert.equal(slices[1]?.done, false);
+});
+
 // --- Prose slice header completion marker tests (#1803) ---
 
 test("parseRoadmapSlices: prose headers with ✓ marker detected as done", () => {

package/src/resources/extensions/gsd/tests/runtime-invariant-modules.test.ts

@@ -6,7 +6,11 @@ import assert from "node:assert/strict";
 
 import { classifyFailure } from "../recovery-classification.js";
 import { reconcileBeforeDispatch } from "../state-reconciliation.js";
-import { compileUnitContextContract, compileUnitToolContract } from "../tool-contract.js";
+import {
+  compileUnitContextContract,
+  compileUnitToolContract,
+  getUnitWorkflowDispatchReadinessError,
+} from "../tool-contract.js";
 import { shouldBlockAutoUnitToolCall } from "../auto-unit-tool-scope.js";
 import type { GSDState } from "../types.js";
 
@@ -63,7 +67,13 @@ test("Tool Contract compiles known Unit prompt and tool policy", () => {
 
   assert.equal(result.ok, true);
   assert.equal(result.ok && result.contract.unitType, "execute-task");
-  assert.deepEqual(result.ok && result.contract.requiredWorkflowTools, ["gsd_task_complete"]);
+  assert.deepEqual(result.ok && result.contract.requiredWorkflowTools, [
+    "gsd_task_complete",
+    "gsd_exec",
+    "gsd_exec_search",
+    "gsd_resume",
+    "gsd_capture_thought",
+  ]);
   assert.deepEqual(result.ok && result.contract.forbiddenWorkflowTools, []);
   assert.equal(result.ok && result.contract.toolsPolicy.mode, "all");
   assert.ok(result.ok && result.contract.validationRules.includes("closeout-tool-present"));
@@ -87,6 +97,20 @@ test("Tool Contract compiles known Unit prompt and tool policy", () => {
   });
 });
 
+test("Tool Contract derives dispatch readiness from Unit workflow tools", () => {
+  const error = getUnitWorkflowDispatchReadinessError({
+    provider: "claude-code",
+    unitType: "plan-slice",
+    projectRoot: "/tmp/project",
+    env: { GSD_WORKFLOW_MCP_COMMAND: "node" },
+    surface: "auto-mode",
+    authMode: "externalCli",
+    baseUrl: "local://claude-code",
+  });
+
+  assert.equal(error, null);
+});
+
 test("Unit Context Contract exposes prompt context without workflow tool surface", () => {
   const result = compileUnitContextContract("execute-task");
 

package/src/resources/extensions/gsd/tests/single-writer-invariant.test.ts

@@ -1,18 +1,23 @@
-// Structural invariant: gsd-db.ts is the single writer for .gsd/gsd.db.
+// Structural invariant: gsd-db.ts and the typed writer layer own writes for .gsd/gsd.db.
 //
 // No file under src/resources/extensions/gsd/ may issue raw write SQL
 // (INSERT/UPDATE/DELETE/REPLACE) or raw transaction control (BEGIN/COMMIT/
 // ROLLBACK via `.exec(...)`) against the engine database. Every bypass must
-// route through a typed wrapper exported from gsd-db.ts.
+// route through an explicitly allowlisted typed writer.
 //
 // Allowlist:
-// - gsd-db.ts itself — the single writer
+// - gsd-db.ts itself — compatibility barrel and remaining mid-migration wrappers
+// - db/engine.ts — schema, migrations, lifecycle, and transaction primitives
+// - db/writers/** — domain writers
+// - typed coordination/runtime writer modules listed in TYPED_DB_WRITER_FILES
+// - schema/migration helper modules listed in SCHEMA_DB_WRITER_FILES
+// - ADR migration/backfill helpers listed in MIGRATION_BACKFILL_WRITER_FILES
 // - unit-ownership.ts — manages a separate .gsd/unit-claims.db for
 //   cross-worktree claim races; intentionally outside this invariant
 // - tests/** — fixtures and direct DB inspection are fair game
 //
 // When this test fails, do not add a new suppression. Instead:
-// 1. Add a typed wrapper to gsd-db.ts that captures the SQL
+// 1. Add a typed wrapper to the explicit writer layer that captures the SQL
 // 2. Switch the flagged site to call the wrapper
 //
 // See `.claude/plans/joyful-doodling-pony.md` for the full rationale.
@@ -29,17 +34,50 @@ const gsdDir = join(process.cwd(), "src/resources/extensions/gsd");
 //   - db/engine.ts — connection lifecycle, schema/migrations (DDL), and the
 //     BEGIN/COMMIT transaction primitives. The shared handle every writer reads.
 //   - db/writers/**.ts — the Single Writer Layer: one cohesive write subsystem
-//     per file (hierarchy, memory, gates, escalation, reconcile, manifest,
-//     legacy-import, cascades).
+//     per file.
 //   - gsd-db.ts — the barrel that re-exports the layer (still holds wrappers
 //     mid-migration).
+//   - typed coordination/runtime writers listed below.
+//   - schema/migration helpers listed below.
+//   - ADR migration/backfill helpers listed below.
 //   - unit-ownership.ts — a separate .gsd/unit-claims.db, intentionally outside.
 // db/queries.ts is explicitly NOT allowed write SQL (asserted separately below).
+const TYPED_DB_WRITER_FILES = new Set([
+  "db/auto-workers.ts",
+  "db/command-queue.ts",
+  "db/milestone-leases.ts",
+  "db/runtime-kv.ts",
+  "db/unit-dispatches.ts",
+]);
+
+const SCHEMA_DB_WRITER_FILES = new Set([
+  "db-memory-fts-schema.ts",
+  "db-schema-metadata.ts",
+  "db-verification-evidence-schema.ts",
+]);
+
+const MIGRATION_BACKFILL_WRITER_FILES = new Set([
+  "memory-backfill.ts",
+]);
+
+const DB_WRITER_ALLOWLIST_GUIDANCE = [
+  "gsd-db.ts",
+  "db/engine.ts",
+  "db/writers/**",
+  ...TYPED_DB_WRITER_FILES,
+  ...SCHEMA_DB_WRITER_FILES,
+  ...MIGRATION_BACKFILL_WRITER_FILES,
+  "unit-ownership.ts only for .gsd/unit-claims.db",
+].join(", ");
+
 function isSingleWriterFile(rel: string): boolean {
   const norm = rel.split("\\").join("/");
   if (norm === "gsd-db.ts" || norm === "unit-ownership.ts") return true;
   if (norm === "db/engine.ts") return true;
   if (norm.startsWith("db/writers/") && norm.endsWith(".ts")) return true;
+  if (TYPED_DB_WRITER_FILES.has(norm)) return true;
+  if (SCHEMA_DB_WRITER_FILES.has(norm)) return true;
+  if (MIGRATION_BACKFILL_WRITER_FILES.has(norm)) return true;
   return false;
 }
 
@@ -83,11 +121,126 @@ interface Violation {
   kind: string;
 }
 
-// Match .prepare("... INSERT|UPDATE|DELETE|REPLACE ...") in any quoting style.
-const PREPARE_WRITE_RE = /\.prepare\s*\(\s*[`'"][^`'"]*\b(INSERT|UPDATE|DELETE|REPLACE)\b/i;
+const DB_CALL_RE = /\.(prepare|exec)\s*\(/g;
+const PREPARE_WRITE_SQL_RE = /\b(INSERT|UPDATE|DELETE|REPLACE)\b/i;
+const EXEC_WRITE_SQL_RE = /\b(INSERT|UPDATE|DELETE|REPLACE|BEGIN|COMMIT|ROLLBACK)\b/i;
+
+function findRawWriteSqlViolations(file: string, content: string): Violation[] {
+  const violations: Violation[] = [];
+  DB_CALL_RE.lastIndex = 0;
+
+  let match: RegExpExecArray | null;
+  while ((match = DB_CALL_RE.exec(content)) !== null) {
+    const method = match[1] as "prepare" | "exec";
+    const sql = readFirstStringArgument(content, DB_CALL_RE.lastIndex);
+    if (sql === null) continue;
+
+    const keywordMatch =
+      method === "prepare"
+        ? PREPARE_WRITE_SQL_RE.exec(sql)
+        : EXEC_WRITE_SQL_RE.exec(sql);
+    if (keywordMatch === null) continue;
+
+    violations.push({
+      file,
+      line: lineNumberAt(content, match.index),
+      snippet: lineSnippetAt(content, match.index),
+      kind: `${method}(${keywordMatch[1].toUpperCase()})`,
+    });
+  }
+
+  return violations;
+}
+
+function readFirstStringArgument(content: string, index: number): string | null {
+  const quoteIndex = skipWhitespace(content, index);
+  const quote = content[quoteIndex];
+  if (quote !== "`" && quote !== "'" && quote !== '"') return null;
+  return readStringLiteral(content, quoteIndex, quote);
+}
+
+function skipWhitespace(content: string, index: number): number {
+  let cursor = index;
+  while (cursor < content.length && /\s/.test(content[cursor] ?? "")) {
+    cursor++;
+  }
+  return cursor;
+}
+
+function readStringLiteral(content: string, quoteIndex: number, quote: string): string | null {
+  let value = "";
+
+  for (let cursor = quoteIndex + 1; cursor < content.length; cursor++) {
+    const char = content[cursor];
+    if (char === "\\") {
+      value += char;
+      cursor++;
+      if (cursor < content.length) value += content[cursor];
+      continue;
+    }
+    if (char === quote) return value;
+    value += char;
+  }
+
+  return null;
+}
+
+function lineNumberAt(content: string, index: number): number {
+  return content.slice(0, index).split("\n").length;
+}
+
+function lineSnippetAt(content: string, index: number): string {
+  const lineStart = content.lastIndexOf("\n", index) + 1;
+  const nextNewline = content.indexOf("\n", index);
+  const lineEnd = nextNewline === -1 ? content.length : nextNewline;
+  return content.slice(lineStart, lineEnd).trim();
+}
+
+test("scanner catches multiline template-literal db.prepare write SQL", () => {
+  const violations = findRawWriteSqlViolations(
+    "fixture.ts",
+    [
+      "const stmt = db.prepare(",
+      "  `INSERT INTO tasks (id)",
+      "   VALUES (?)`",
+      ");",
+    ].join("\n"),
+  );
+
+  assert.deepEqual(violations.map(({ line, kind }) => ({ line, kind })), [
+    { line: 1, kind: "prepare(INSERT)" },
+  ]);
+});
+
+test("scanner catches multiline raw transaction control in exec", () => {
+  const violations = findRawWriteSqlViolations(
+    "fixture.ts",
+    [
+      "db.exec(",
+      "  `BEGIN`",
+      ");",
+    ].join("\n"),
+  );
+
+  assert.deepEqual(violations.map(({ line, kind }) => ({ line, kind })), [
+    { line: 1, kind: "exec(BEGIN)" },
+  ]);
+});
+
+test("scanner ignores multiline SELECT statements", () => {
+  const violations = findRawWriteSqlViolations(
+    "fixture.ts",
+    [
+      "const stmt = db.prepare(",
+      "  `SELECT id",
+      "   FROM tasks`",
+      ");",
+    ].join("\n"),
+  );
+
+  assert.deepEqual(violations, []);
+});
 
-// Match .exec("... INSERT|UPDATE|DELETE|REPLACE ...") or raw BEGIN/COMMIT/ROLLBACK.
-const EXEC_WRITE_RE = /\.exec\s*\(\s*[`'"][^`'"]*\b(INSERT|UPDATE|DELETE|REPLACE|BEGIN|COMMIT|ROLLBACK)\b/i;
 const DB_WORKSPACE_MECHANICS = new Set([
   "backupDatabaseSnapshot",
   "checkpointDatabase",
@@ -112,7 +265,7 @@ function importNames(specifierBlock: string): string[] {
     .filter(Boolean);
 }
 
-test("no module outside gsd-db.ts issues raw write SQL against the engine DB", () => {
+test("no module outside the explicit DB writer allowlist issues raw write SQL", () => {
   const files = walkTsFiles(gsdDir);
   assert.ok(files.length >= 20, `Expected at least 20 .ts files under gsd/, found ${files.length}`);
 
@@ -129,30 +282,7 @@ test("no module outside gsd-db.ts issues raw write SQL against the engine DB", (
       continue;
     }
 
-    const lines = content.split("\n");
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i];
-
-      const prepareMatch = PREPARE_WRITE_RE.exec(line);
-      if (prepareMatch) {
-        violations.push({
-          file: rel,
-          line: i + 1,
-          snippet: line.trim(),
-          kind: `prepare(${prepareMatch[1].toUpperCase()})`,
-        });
-      }
-
-      const execMatch = EXEC_WRITE_RE.exec(line);
-      if (execMatch) {
-        violations.push({
-          file: rel,
-          line: i + 1,
-          snippet: line.trim(),
-          kind: `exec(${execMatch[1].toUpperCase()})`,
-        });
-      }
-    }
+    violations.push(...findRawWriteSqlViolations(rel, content));
   }
 
   if (violations.length > 0) {
@@ -160,9 +290,9 @@ test("no module outside gsd-db.ts issues raw write SQL against the engine DB", (
       (v) => `  ${v.file}:${v.line} [${v.kind}] — ${v.snippet}`,
     );
     assert.fail(
-      `Found ${violations.length} raw write SQL bypass(es) outside gsd-db.ts:\n` +
+      `Found ${violations.length} raw write SQL bypass(es) outside the explicit DB writer allowlist:\n` +
         lines.join("\n") +
-        "\n\nEach of these must be replaced with a typed wrapper exported from gsd-db.ts.",
+        `\n\nMove each write to the appropriate allowlisted owner: ${DB_WRITER_ALLOWLIST_GUIDANCE}.`,
     );
   }
 });
@@ -174,19 +304,11 @@ test("db/queries.ts (the Query Module) is read-only — contains no write SQL",
   // db/writers/ — this is the explicit, positive statement of intent.)
   const queriesPath = join(gsdDir, "db", "queries.ts");
   const content = readFileSync(queriesPath, "utf-8");
-  const lines = content.split("\n");
-  const violations: Violation[] = [];
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const m = PREPARE_WRITE_RE.exec(line) ?? EXEC_WRITE_RE.exec(line);
-    if (m) {
-      violations.push({ file: "db/queries.ts", line: i + 1, snippet: line.trim(), kind: m[1].toUpperCase() });
-    }
-  }
+  const violations = findRawWriteSqlViolations("db/queries.ts", content);
   assert.equal(
     violations.length,
     0,
-    `db/queries.ts must contain no write SQL — move write wrappers to db/writers/:\n` +
+    `db/queries.ts must contain no write SQL — move write wrappers to the explicit DB writer allowlist:\n` +
       violations.map((v) => `  db/queries.ts:${v.line} [${v.kind}] — ${v.snippet}`).join("\n"),
   );
 });
@@ -299,7 +421,7 @@ test("production modules do not import DB open-state mechanics from gsd-db.ts",
     assert.fail(
       `Found ${violations.length} DB open-state import(s) from gsd-db.ts:\n` +
         lines.join("\n") +
-        "\n\nImport these through db-workspace.ts so gsd-db.ts stays the single-writer implementation, not the caller-facing DB Workspace Interface.",
+        "\n\nImport these through db-workspace.ts so gsd-db.ts stays the writer compatibility barrel, not the caller-facing DB Workspace Interface.",
     );
   }
 });

package/src/resources/extensions/gsd/tests/skill-activation.test.ts

@@ -92,14 +92,14 @@ test("buildSkillActivationBlock activates skills via prefer_skills when context
       prefer_skills: ["react"],
     });
 
-    assert.match(result, /Call Skill\(\{ skill: 'react' \}\)/);
+    assert.match(result, /Read the installed 'react' skill file from <available_skills>/);
     assert.doesNotMatch(result, /swiftui/);
   } finally {
     cleanup(base);
   }
 });
 
-test("buildSkillActivationBlock includes always_use_skills from preferences using exact Skill tool format", () => {
+test("buildSkillActivationBlock includes always_use_skills using read-based skill loading", () => {
   const base = makeTempBase();
   try {
     writeSkill(base, "swift-testing", "Use for Swift Testing assertions and verification patterns.");
@@ -109,7 +109,10 @@ test("buildSkillActivationBlock includes always_use_skills from preferences usin
       always_use_skills: ["swift-testing"],
     });
 
-    assert.equal(result, "<skill_activation>Call Skill({ skill: 'swift-testing' }).</skill_activation>");
+    assert.equal(
+      result,
+      "<skill_activation>Read the installed 'swift-testing' skill file from <available_skills>.</skill_activation>",
+    );
   } finally {
     cleanup(base);
   }
@@ -137,8 +140,8 @@ test("buildSkillActivationBlock includes skill_rules matches and task-plan skill
       skill_rules: [{ when: "prisma database schema", use: ["prisma"] }],
     });
 
-    assert.match(result, /Call Skill\(\{ skill: 'accessibility' \}\)/);
-    assert.match(result, /Call Skill\(\{ skill: 'prisma' \}\)/);
+    assert.match(result, /Read the installed 'accessibility' skill file from <available_skills>/);
+    assert.match(result, /Read the installed 'prisma' skill file from <available_skills>/);
   } finally {
     cleanup(base);
   }
@@ -160,7 +163,7 @@ test("buildSkillActivationBlock matches skill_rules against exact unit type cont
       ],
     });
 
-    assert.match(result, /Call Skill\(\{ skill: 'complete-slice-policies' \}\)/);
+    assert.match(result, /Read the installed 'complete-slice-policies' skill file from <available_skills>/);
     assert.doesNotMatch(result, /slice-broad/);
   } finally {
     cleanup(base);
@@ -264,8 +267,8 @@ test("buildSkillActivationBlock allows valid skill names and rejects invalid one
     });
 
     assert.match(result, /skill_activation/);
-    assert.match(result, /Call Skill\(\{ skill: 'react' \}\)/);
-    assert.match(result, /Call Skill\(\{ skill: 'good-skill-2' \}\)/);
+    assert.match(result, /Read the installed 'react' skill file from <available_skills>/);
+    assert.match(result, /Read the installed 'good-skill-2' skill file from <available_skills>/);
     assert.doesNotMatch(result, /bad'name/);
   } finally {
     cleanup(base);
@@ -289,8 +292,8 @@ test("buildSkillActivationBlock: explicit always_use_skills bypass the unit-type
       always_use_skills: ["write-docs", "swiftui"],
     });
 
-    assert.match(result, /Call Skill\(\{ skill: 'write-docs' \}\)/);
-    assert.match(result, /Call Skill\(\{ skill: 'swiftui' \}\)/);
+    assert.match(result, /Read the installed 'write-docs' skill file from <available_skills>/);
+    assert.match(result, /Read the installed 'swiftui' skill file from <available_skills>/);
   } finally {
     cleanup(base);
   }
@@ -307,7 +310,7 @@ test("buildSkillActivationBlock falls through to all skills for unknown unit typ
     });
 
     // Unknown unit type = wildcard fallback (pre-manifest behavior).
-    assert.match(result, /Call Skill\(\{ skill: 'swiftui' \}\)/);
+    assert.match(result, /Read the installed 'swiftui' skill file from <available_skills>/);
   } finally {
     cleanup(base);
   }
@@ -324,7 +327,7 @@ test("buildSkillActivationBlock without unitType preserves pre-manifest behavior
       always_use_skills: ["swiftui"],
     });
 
-    assert.match(result, /Call Skill\(\{ skill: 'swiftui' \}\)/);
+    assert.match(result, /Read the installed 'swiftui' skill file from <available_skills>/);
   } finally {
     cleanup(base);
   }
@@ -341,12 +344,12 @@ test("milestone prompt builders propagate always_use_skills through buildSkillAc
     loadOnlyTestSkills(base);
 
     const researchPrompt = await buildResearchMilestonePrompt("M001", "Test", base);
-    assert.match(researchPrompt, /Call Skill\(\{ skill: 'write-docs' \}\)/);
-    assert.match(researchPrompt, /Call Skill\(\{ skill: 'swiftui' \}\)/);
+    assert.match(researchPrompt, /Read the installed 'write-docs' skill file from <available_skills>/);
+    assert.match(researchPrompt, /Read the installed 'swiftui' skill file from <available_skills>/);
 
     const planPrompt = await buildPlanMilestonePrompt("M001", "Test", base);
-    assert.match(planPrompt, /Call Skill\(\{ skill: 'write-docs' \}\)/);
-    assert.match(planPrompt, /Call Skill\(\{ skill: 'swiftui' \}\)/);
+    assert.match(planPrompt, /Read the installed 'write-docs' skill file from <available_skills>/);
+    assert.match(planPrompt, /Read the installed 'swiftui' skill file from <available_skills>/);
   } finally {
     cleanup(base);
   }
@@ -377,7 +380,7 @@ test("complete-slice prompt propagates always_use_skills through buildSkillActiv
 
     const prompt = await buildCompleteSlicePrompt("M001", "Test", "S01", "Slice", base);
 
-    assert.match(prompt, /Call Skill\(\{ skill: 'write-docs' \}\)/);
+    assert.match(prompt, /Read the installed 'write-docs' skill file from <available_skills>/);
   } finally {
     cleanup(base);
   }