@programinglive/dev-workflow-mcp-server 1.13.8 → 1.13.10

package/README.md

@@ -610,14 +610,33 @@ then reinstall.
 changes** - git ran in the wrong repository. The server used to fall back to its
 own package directory, which is also a git repo, so commits landed there (or
 nowhere) instead of in your project. It now refuses to run git in the package
-repo and asks for the project explicitly:
+repo and asks for the project explicitly.
+
+Since 30 October 2026 the reliable fix is **per task**, not global. Pass
+`projectDir` to `start_task`; the repo is pinned for that task and every later
+git operation uses it:
+
+```json
+{ "description": "Fix login redirect", "type": "bugfix", "projectDir": "D:\\code\\clinic" }
+```
+
+`start_task` answers with `📁 Repo proyek: <path> (<source>)`, so the repo in use
+is never a guess. `commit_and_push` repeats it on every response.
+
+`WORKFLOW_PROJECT_DIR` still works as an operator-wide default and still wins
+over the session directory, but it is one value for the whole server process.
+When the session directory points at a *different* repo, `start_task` now
+reports `⚠️ KONFLIK` and tells you to pass `projectDir` — previously that
+mismatch was silent, which is how a commit landed in the wrong repo. Prefer
+`projectDir`; keep the env var only for machines with a single project.
 
 ```bash
 export WORKFLOW_PROJECT_DIR=/path/to/your/project
 ```
 
 Point it at any directory inside the project; the repo root is discovered
-upward. Non-git commands are unaffected.
+upward. Non-git commands are unaffected. Full incident write-up:
+[`docs/2026-10-30-project-dir-misrouting.md`](docs/2026-10-30-project-dir-misrouting.md).
 
 **A task jumped straight to `done` after reporting `review`** - it was reported
 twice. Factory treats the second report as approval. Current versions block that

package/exec.js

@@ -49,64 +49,138 @@ function samePath(a, b) {
 }
 
 /**
- * Menentukan direktori repo proyek tempat git boleh dijalankan.
+ * Direktori repo proyek yang aktif untuk pemanggilan ini.
  *
- * Urutan: eksplisit -> WORKFLOW_PROJECT_DIR/PROJECT_DIR -> kandidat.
+ * Kenapa ada: `WORKFLOW_PROJECT_DIR` adalah satu nilai global untuk seluruh
+ * proses MCP. Di mesin ini nilainya `D:\code\clinic`, sehingga sesi yang
+ * sebenarnya bekerja di repo lain tetap menjalankan git di clinic — dan
+ * `commit_and_push` melaporkan "No changes detected" seolah sudah selesai.
  *
- * Repo paket MCP sengaja tidak dipilih sebagai cadangan: dulu server pernah
- * menjalankan git di repo-nya sendiri saat cwd proyek gagal diresolusi, lalu
- * melaporkan "No changes detected" sementara perubahan proyek tidak pernah
- * ter-commit.
+ * Direktori aktif diisi dari state sesi (`projectDir`), yang ditentukan saat
+ * `start_task` atau saat `commit_and_push`/`perform_release` dipanggil dengan
+ * argumen `projectDir` eksplisit.
+ */
+let activeProjectDir = "";
+
+export function setActiveProjectDir(dir) {
+  activeProjectDir = dir ? path.resolve(dir) : "";
+  return activeProjectDir;
+}
+
+export function getActiveProjectDir() {
+  return activeProjectDir;
+}
+
+function repoRootOrThrow(dir, message) {
+  const root = findRepoRoot(dir);
+  if (!root) {
+    throw new Error(message);
+  }
+  return root;
+}
+
+/**
+ * Menentukan direktori repo proyek, sekaligus melaporkan DARI MANA asalnya.
  *
- * Tetapi kandidat yang MEMANG berada di dalam repo paket berarti pemanggil
- * sengaja bekerja di sana - misalnya saat mengembangkan server MCP ini sendiri.
- * Membuangnya tanpa syarat membuat `commit_and_push` mustahil dipakai di repo
- * paket, jadi kandidat seperti itu diterima. Repo proyek lain tetap menang.
+ * Urutan (per 30 Oktober 2026):
+ *   1. explicit  - argumen `projectDir` pada panggilan tool
+ *   2. pinned    - `projectDir` yang dicatat `start_task` untuk sesi ini
+ *   3. env       - WORKFLOW_PROJECT_DIR / PROJECT_DIR (setelan operator, global)
+ *   4. cwd       - direktori kerja sesi (kandidat)
+ *
+ * `env` tetap di atas `cwd` karena ia setelan operator yang disengaja: kalau
+ * seseorang menunjuk repo lewat env, ia bermaksud demikian.
+ *
+ * Yang berubah: env sekarang bisa DIKALAHKAN per sesi lewat `projectDir`, dan
+ * bila env dipakai sementara direktori sesi menunjuk repo lain, konfliknya
+ * dilaporkan (`conflict`). Sebelumnya tidak ada jalan keluar sama sekali:
+ * satu nilai global membajak semua sesi, `git status` di repo yang salah
+ * menjawab "bersih", dan workflow melaporkan sukses palsu.
+ *
+ * `source` dan `conflict` dipakai tool untuk memberi tahu pengguna repo mana
+ * yang dipakai - dan kapan ia kemungkinan salah.
  */
-export function resolveWorkingDirectory({ explicit = "", env = process.env, candidates = [] } = {}) {
+export function resolveProjectDir({ explicit = "", pinned = "", env = process.env, candidates = [] } = {}) {
   if (explicit) {
-    const root = findRepoRoot(explicit);
-    if (!root) {
-      throw new Error(`Direktori "${explicit}" bukan repo git (tidak ada .git).`);
-    }
-    return root;
+    return {
+      dir: repoRootOrThrow(explicit, `Direktori "${explicit}" bukan repo git (tidak ada .git).`),
+      source: "explicit",
+      conflict: null,
+    };
   }
 
-  const envDir = (env.WORKFLOW_PROJECT_DIR || env.PROJECT_DIR || "").trim();
-  if (envDir) {
-    const root = findRepoRoot(envDir);
-    if (!root) {
-      throw new Error(`WORKFLOW_PROJECT_DIR "${envDir}" bukan repo git (tidak ada .git).`);
-    }
-    return root;
+  if (pinned) {
+    return {
+      dir: repoRootOrThrow(
+        pinned,
+        `projectDir sesi "${pinned}" bukan repo git (tidak ada .git). ` +
+        "Perbaiki dengan memanggil 'start_task' lagi dengan projectDir yang benar.",
+      ),
+      source: "pinned",
+      conflict: null,
+    };
   }
 
   const found = candidates.map((candidate) => findRepoRoot(candidate)).filter(Boolean);
+  const cwdRepo = found.find((dir) => !samePath(dir, PACKAGE_DIR)) || null;
+  const packageCandidate = found.some((dir) => samePath(dir, PACKAGE_DIR));
+
+  const envDir = (env.WORKFLOW_PROJECT_DIR || env.PROJECT_DIR || "").trim();
+  if (envDir) {
+    const envRepo = repoRootOrThrow(envDir, `WORKFLOW_PROJECT_DIR "${envDir}" bukan repo git (tidak ada .git).`);
+    return {
+      dir: envRepo,
+      source: "env",
+      // Direktori sesi menunjuk repo lain: kemungkinan besar env ini milik
+      // proyek lain, dan git akan berjalan di repo yang salah.
+      conflict: cwdRepo && !samePath(cwdRepo, envRepo) ? { envDir: envRepo, cwdDir: cwdRepo } : null,
+    };
+  }
 
-  const projectRepo = found.find((dir) => !samePath(dir, PACKAGE_DIR));
-  if (projectRepo) {
-    return projectRepo;
+  if (cwdRepo) {
+    return { dir: cwdRepo, source: "cwd", conflict: null };
   }
 
   // Hanya repo paket yang ditemukan. Itu hanya mungkin bila salah satu kandidat
   // benar-benar berada di dalamnya, jadi pemanggil memilih repo ini dengan sadar.
-  if (found.some((dir) => samePath(dir, PACKAGE_DIR))) {
-    return path.resolve(PACKAGE_DIR);
+  if (packageCandidate) {
+    return { dir: path.resolve(PACKAGE_DIR), source: "cwd", conflict: null };
   }
 
   throw new Error(
     "Tidak bisa menentukan repo proyek: tidak ada repository git pada " +
     `${candidates.filter(Boolean).map((candidate) => `"${candidate}"`).join(", ") || "direktori kerja"}. ` +
-    "Set WORKFLOW_PROJECT_DIR ke direktori proyek, atau jalankan server MCP dari dalam direktori proyek.",
+    "Sebutkan 'projectDir' pada 'start_task' (disarankan), atau set WORKFLOW_PROJECT_DIR, " +
+    "atau jalankan server MCP dari dalam direktori proyek.",
   );
 }
 
+/**
+ * Penentu direktori repo proyek tempat git boleh dijalankan.
+ *
+ * Urutan: eksplisit -> WORKFLOW_PROJECT_DIR/PROJECT_DIR -> kandidat.
+ *
+ * Repo paket MCP sengaja tidak dipilih sebagai cadangan: dulu server pernah
+ * menjalankan git di repo-nya sendiri saat cwd proyek gagal diresolusi, lalu
+ * melaporkan "No changes detected" sementara perubahan proyek tidak pernah
+ * ter-commit.
+ *
+ * Tetapi kandidat yang MEMANG berada di dalam repo paket berarti pemanggil
+ * sengaja bekerja di sana - misalnya saat mengembangkan server MCP ini sendiri.
+ * Membuangnya tanpa syarat membuat `commit_and_push` mustahil dipakai di repo
+ * paket, jadi kandidat seperti itu diterima. Repo proyek lain tetap menang.
+ */
+export function resolveWorkingDirectory(options = {}) {
+  return resolveProjectDir(options).dir;
+}
+
 function getDefaultCwd(command) {
   try {
-    return resolveWorkingDirectory({
+    return resolveProjectDir({
+      explicit: activeProjectDir,
       env: process.env,
       candidates: [process.cwd(), process.env.INIT_CWD],
-    });
+    }).dir;
   } catch (error) {
     // Perintah non-git (echo, npm run release, ...) tidak butuh repo proyek.
     // Yang berbahaya hanya git: di sana cwd menentukan repo mana yang diubah.

package/index.js

@@ -13,7 +13,7 @@ import {
   GetPromptRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
 import { fileURLToPath } from "url";
-import { exec } from "./exec.js";
+import { exec, setActiveProjectDir } from "./exec.js";
 import { normalizeRequestArgs, shellEscape } from "./utils.js";
 import { createGitFacade } from "./git-facade.js";
 import {
@@ -60,6 +60,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const sessionId = sessionKeyFromRequest(request);
     if (sessionId) await workflowState.useSession(sessionId);
     await workflowState.load();
+    // Repo proyek mengikuti sesi, bukan satu nilai global. Tanpa ini, sesi yang
+    // bekerja di repo lain tetap menjalankan git di WORKFLOW_PROJECT_DIR.
+    setActiveProjectDir(workflowState.state.projectDir || "");
   }
   return securityOutputFilter(await handleToolCall({
     request,
@@ -234,6 +237,7 @@ async function cliMain(argv) {
     workflowState = new WorkflowState();
     await workflowState.load();
     await workflowState.ensurePrimaryFile();
+    setActiveProjectDir(workflowState.state.projectDir || "");
 
     const request = {
       params: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@programinglive/dev-workflow-mcp-server",
-  "version": "1.13.8",
+  "version": "1.13.10",
   "description": "MCP server to enforce development workflow discipline",
   "homepage": "https://devworkflow.programinglive.com/",
   "mcpName": "io.github.programinglive/dev-workflow-mcp-server",

package/tools/definitions.js

@@ -25,6 +25,14 @@ export function getToolList() {
             enum: ["feature", "bugfix", "refactor", "other"],
             description: "Type of task",
           },
+          projectDir: {
+            type: "string",
+            description:
+              "Absolute path to the repository this task works on (e.g. D:\\code\\clinic). " +
+              "Pinned for the whole task; every git operation afterwards runs there. " +
+              "Pass it whenever the session directory is not itself a git repository, " +
+              "otherwise the server may fall back to WORKFLOW_PROJECT_DIR and commit to the wrong repo.",
+          },
         },
         required: ["description", "type"],
       },
@@ -153,6 +161,12 @@ export function getToolList() {
             type: "string",
             description: "Optional branch name to push to (defaults to current branch)",
           },
+          projectDir: {
+            type: "string",
+            description:
+              "Absolute path to the repository to commit in. Overrides the repo pinned by 'start_task' " +
+              "for this call. Use it to fix a misdirected commit without restarting the task.",
+          },
         },
         required: [],
       },
@@ -172,6 +186,11 @@ export function getToolList() {
             type: "string",
             description: "Optional release notes",
           },
+          projectDir: {
+            type: "string",
+            description:
+              "Absolute path to the repository to release. Overrides the repo pinned by 'start_task' for this call.",
+          },
         },
         required: ["command"],
       },

package/tools/handler-modules/commit-handlers.js

@@ -1,9 +1,58 @@
 import { textResponse, isReleaseSatisfied, formatChecklist } from "./shared.js";
 import { handleReadyCheck } from "./status-handlers.js";
 import { containsTestFilesInStatus } from "../../git-helpers.js";
+import { resolveProjectDir, setActiveProjectDir, getActiveProjectDir } from "../../exec.js";
+
+/**
+ * Label repo yang benar-benar dipakai, untuk ditampilkan di setiap jawaban.
+ *
+ * Tanpa ini, "No changes detected" tidak bisa dibedakan antara "sudah commit"
+ * dan "git berjalan di repo yang salah". Itu persis yang menyamarkan commit
+ * salah arah pada 30 Oktober 2026.
+ */
+function repoLabel() {
+  try {
+    const resolved = resolveProjectDir({
+      explicit: getActiveProjectDir(),
+      env: process.env,
+      candidates: [process.cwd(), process.env.INIT_CWD],
+    });
+    const origin = resolved.source === "env" ? " — dari WORKFLOW_PROJECT_DIR (global)" : "";
+    return resolved.dir + origin;
+  } catch {
+    return "(tidak bisa ditentukan)";
+  }
+}
+
+/**
+ * Terapkan `projectDir` dari argumen tool bila ada.
+ * Mengembalikan pesan kesalahan, atau null bila tidak ada masalah.
+ */
+function applyProjectDirOverride(args) {
+  const requested = typeof args.projectDir === "string" ? args.projectDir.trim() : "";
+  if (!requested) {
+    return null;
+  }
+
+  try {
+    const resolved = resolveProjectDir({ explicit: requested });
+    setActiveProjectDir(resolved.dir);
+    return null;
+  } catch (error) {
+    return `❌ projectDir tidak valid: ${error.message}`;
+  }
+}
 
 export async function handleCommitAndPush(args, context) {
   const { workflowState, exec, git, utils } = context;
+
+  const projectDirError = applyProjectDirOverride(args);
+  if (projectDirError) {
+    return textResponse(projectDirError);
+  }
+
+  workflowState.state.projectDir = getActiveProjectDir() || workflowState.state.projectDir || "";
+
   if (!workflowState.state.readyToCommit || !workflowState.state.readyCheckCompleted) {
     const readyResponse = await handleReadyCheck(workflowState);
     if (workflowState.state.currentPhase !== "commit") {
@@ -29,8 +78,9 @@ export async function handleCommitAndPush(args, context) {
   } catch (error) {
     return textResponse(
       `❌ Tidak bisa memeriksa repository Git, jadi tidak ada yang di-commit.\n\n` +
+      `Repo: ${repoLabel()}\n` +
       `Penyebab: ${error.message}\n\n` +
-      `Set WORKFLOW_PROJECT_DIR ke direktori proyek, atau jalankan server MCP dari dalam direktori proyek.`
+      `Sebutkan 'projectDir' pada 'start_task' atau 'commit_and_push' untuk menunjuk repo yang benar.`
     );
   }
 
@@ -47,7 +97,7 @@ export async function handleCommitAndPush(args, context) {
     await workflowState.save();
 
     return textResponse(
-      `ℹ️ No changes detected. Assuming commit and push already completed.\nLast commit: ${effectiveCommitMessage || "(unavailable)"
+      `ℹ️ No changes detected. Assuming commit and push already completed.\nRepo: ${repoLabel()}\nLast commit: ${effectiveCommitMessage || "(unavailable)"
       }\n\nNext: Run 'perform_release' to handle the release and push tags.`
     );
   }
@@ -109,7 +159,7 @@ export async function handleCommitAndPush(args, context) {
   await workflowState.save();
 
   return textResponse(
-    `✅ Commit and push completed!\n\nCommit message: ${generatedSummary}\nPushed to: ${branchForPush || "(default upstream)"
+    `✅ Commit and push completed!\nRepo: ${repoLabel()}\n\nCommit message: ${generatedSummary}\nPushed to: ${branchForPush || "(default upstream)"
     }\n\nNext: Run 'perform_release' to handle the release and push tags.`
   );
 }

package/tools/handler-modules/release-handlers.js

@@ -1,4 +1,5 @@
 import { textResponse, isReleaseSatisfied, resetToCommitIfWorkingChanges, summarizeHistory } from "./shared.js";
+import { resolveProjectDir, setActiveProjectDir, getActiveProjectDir } from "../../exec.js";
 
 export async function handleSkipRelease(args, workflowState) {
   if (workflowState.state.currentPhase === "idle") {
@@ -50,6 +51,18 @@ export async function handlePerformRelease(args, context) {
     return textResponse("⚠️ Please start a task first using 'start_task'!");
   }
 
+  // Sama seperti commit_and_push: projectDir eksplisit menang atas repo sesi.
+  const requestedProjectDir =
+    typeof args.projectDir === "string" ? args.projectDir.trim() : "";
+  if (requestedProjectDir) {
+    try {
+      setActiveProjectDir(resolveProjectDir({ explicit: requestedProjectDir }).dir);
+    } catch (error) {
+      return textResponse(`❌ projectDir tidak valid: ${error.message}`);
+    }
+    workflowState.state.projectDir = getActiveProjectDir();
+  }
+
   let hasNewChanges;
   try {
     hasNewChanges = await resetToCommitIfWorkingChanges(workflowState, git);
@@ -81,7 +94,7 @@ export async function handlePerformRelease(args, context) {
       return textResponse(
         `❌ Tidak bisa memeriksa repository Git, jadi status rilis tidak dapat diverifikasi.\n\n` +
         `Penyebab: ${error.message}\n\n` +
-        `Set WORKFLOW_PROJECT_DIR ke direktori proyek, atau jalankan server MCP dari dalam direktori proyek.`
+        `Sebutkan 'projectDir' pada 'perform_release' untuk menunjuk repo yang benar.`
       );
     }
 

package/tools/handler-modules/workflow-handlers.js

@@ -1,5 +1,71 @@
 import { classify } from '../../security/policy.js';
 import { textResponse, isReleaseSatisfied, isErrorResponse, ensurePrdExists } from "./shared.js";
+import { resolveProjectDir, setActiveProjectDir } from "../../exec.js";
+
+/**
+ * Catat repo proyek untuk sesi ini.
+ *
+ * Tanpa ini, satu-satunya penentu adalah WORKFLOW_PROJECT_DIR yang global.
+ * Di mesin ini nilainya `D:\code\clinic`, jadi task yang sebenarnya bekerja di
+ * repo lain tetap menjalankan git di clinic dan `commit_and_push` menjawab
+ * "No changes detected" seolah sudah selesai (30 Oktober 2026).
+ *
+ * Best-effort: kalau repo belum bisa ditentukan, task tetap boleh mulai, tapi
+ * pengguna diberi tahu supaya tidak terkejut saat commit.
+ */
+function pinProjectDir(args, workflowState) {
+  const requested = typeof args.projectDir === "string" ? args.projectDir.trim() : "";
+
+  let resolved = null;
+  let error = null;
+  try {
+    resolved = resolveProjectDir({
+      explicit: requested,
+      env: process.env,
+      candidates: [process.cwd(), process.env.INIT_CWD],
+    });
+  } catch (resolveError) {
+    error = resolveError;
+  }
+
+  if (!resolved) {
+    workflowState.state.projectDir = "";
+    setActiveProjectDir("");
+    return {
+      message:
+        `⚠️ Repo proyek belum ditentukan: ${error.message}\n` +
+        `   Sebutkan 'projectDir' pada 'start_task' supaya commit tidak salah arah.`,
+    };
+  }
+
+  workflowState.state.projectDir = resolved.dir;
+  setActiveProjectDir(resolved.dir);
+
+  const sourceNote = {
+    explicit: "dari argumen projectDir",
+    cwd: "dari direktori kerja sesi",
+    env: "dari WORKFLOW_PROJECT_DIR (nilai global)",
+    pinned: "dari projectDir sesi",
+  }[resolved.source] || resolved.source;
+
+  let message = `📁 Repo proyek: ${resolved.dir} (${sourceNote})`;
+
+  // Sumber env berarti tidak ada sinyal per-sesi sama sekali. Kalau direktori
+  // sesi ternyata menunjuk repo LAIN, hampir pasti env ini milik proyek lain -
+  // dan itulah yang dulu membuat `git add .` berjalan di repo yang salah.
+  if (resolved.conflict) {
+    message +=
+      `\n   ⚠️ KONFLIK: direktori sesi menunjuk repo lain, ${resolved.conflict.cwdDir}.` +
+      `\n   Repo dipilih dari WORKFLOW_PROJECT_DIR. Kalau task ini untuk repo sesi,` +
+      `\n   ulangi 'start_task' dengan projectDir: "${resolved.conflict.cwdDir}".`;
+  } else if (resolved.source === "env") {
+    message +=
+      `\n   ⚠️ Repo ini berasal dari WORKFLOW_PROJECT_DIR, bukan dari sesi.` +
+      `\n   Kalau task ini bekerja di repo lain, ulangi 'start_task' dengan projectDir yang benar.`;
+  }
+
+  return { message };
+}
 
 export async function handleStartTask(args, workflowState) {
   // Selamatkan dulu pekerjaan yang mungkin tertimpa. Ini menangani dua kasus:
@@ -17,6 +83,8 @@ export async function handleStartTask(args, workflowState) {
   workflowState.state.commitAndPushCompleted = false;
   workflowState.state.lastCommitMessage = "";
   workflowState.state.lastPushBranch = "";
+  // Setelah reset(), karena reset mengosongkan projectDir.
+  const project = pinProjectDir(args, workflowState);
   // start_task memang bermaksud MENGGANTI task, jadi ia boleh menang atas
   // task berjalan. Task yang diganti tetap diarsipkan oleh reconcileWithDisk,
   // bukan dihapus.
@@ -47,7 +115,7 @@ export async function handleStartTask(args, workflowState) {
   const warningBlock = warnings.length > 0 ? `\n\n${warnings.join("\n\n")}` : "";
 
   return textResponse(
-    `✅ Task Started: ${args.description}${warningBlock}\n\n🎯 Be conscious about what you're coding!\n\nWorkflow Steps:\n1. ✓ Start task (current)\n2. ⏳ Describe feature flow with Mermaid\n3. ⏳ Fix/implement the feature\n4. ⏳ Create tests\n5. ⏳ Run tests (must pass!)\n6. ⏳ Create documentation\n7. ⏳ Run 'check_ready_to_commit'\n8. ⏳ Run 'commit_and_push' (commits and pushes)\n9. ⏳ Run 'perform_release' (handles versioning and tags) or 'skip_release' (when no release is needed)\n10. ⏳ Complete task\n\nReminder: Focus on writing clean, maintainable code!`
+    `✅ Task Started: ${args.description}\n\n${project.message}${warningBlock}\n\n🎯 Be conscious about what you're coding!\n\nWorkflow Steps:\n1. ✓ Start task (current)\n2. ⏳ Describe feature flow with Mermaid\n3. ⏳ Fix/implement the feature\n4. ⏳ Create tests\n5. ⏳ Run tests (must pass!)\n6. ⏳ Create documentation\n7. ⏳ Run 'check_ready_to_commit'\n8. ⏳ Run 'commit_and_push' (commits and pushes)\n9. ⏳ Run 'perform_release' (handles versioning and tags) or 'skip_release' (when no release is needed)\n10. ⏳ Complete task\n\nReminder: Focus on writing clean, maintainable code!`
   );
 }
 

package/workflow-state.js

@@ -223,18 +223,55 @@ function getUserScopedDir(baseDir) {
   return path.join(baseDir, "users", userId);
 }
 
-function getCurrentUserId() {
+/**
+ * Identitas user untuk baris database milik state ini.
+ *
+ * MENGAPA TIDAK MEMBACA CACHE MODUL
+ * ---------------------------------
+ * Versi sebelumnya hanya memakai `cachedUserId`, yang terisi lewat
+ * `resolveUserId()` - dan itu hanya dipanggil dari `resolveStateFile()`.
+ * Pemanggil yang membuat `WorkflowState` dengan path EKSPLISIT (skrip
+ * perbaikan, CLI, tes) tidak pernah memicunya, sehingga `syncToDatabase()`
+ * diam-diam menulis baris dengan `user_id = "default"`.
+ *
+ * Akibat nyata 30 Oktober 2026: satu proyek punya riwayat di dua identitas
+ * (`user-…` dan `default`) dalam database yang sama, dan 150 baris duplikat
+ * harus dibersihkan manual.
+ *
+ * Membaca langsung dari direktori `.state` milik state ini membuat hasilnya
+ * tidak bergantung pada direktori kerja proses, tidak bergantung pada urutan
+ * pemanggilan, dan tidak bocor antar proyek dalam satu proses.
+ */
+function getCurrentUserId(stateFile = null) {
   const envUserId = (process.env.DEV_WORKFLOW_USER_ID || "").trim();
   if (envUserId) {
     return envUserId;
   }
 
-  if (cachedUserId) {
-    return cachedUserId;
+  if (stateFile) {
+    const stateDir = path.dirname(path.resolve(stateFile));
+    const userIdFile = path.join(stateDir, USER_ID_FILENAME);
+
+    try {
+      const stored = readFileSync(userIdFile, "utf-8").trim();
+      if (stored) {
+        return stored;
+      }
+    } catch {
+      // Berkas belum ada: jatuh ke pencarian di bawah.
+    }
+
+    // .state langsung (bukan .state/users/<id>): pakai resolveUserId, yang
+    // menangani migrasi id lama maupun pembuatan id baru.
+    try {
+      return resolveUserId(stateDir);
+    } catch {
+      // Biarkan jatuh ke nilai cadangan di bawah.
+    }
   }
 
-  if (cachedUserStateDir) {
-    return resolveUserId(cachedUserStateDir);
+  if (cachedUserId) {
+    return cachedUserId;
   }
 
   return "default";
@@ -587,6 +624,9 @@ export class WorkflowState {
       commitAndPushCompleted: false,
       lastCommitMessage: "",
       lastPushBranch: "",
+      // Repo proyek untuk sesi ini. Ditentukan saat start_task, dipakai semua
+      // operasi git berikutnya. Kosong berarti ikuti urutan resolusi di exec.js.
+      projectDir: "",
       featureFlowCreated: false,
       featureFlowDescription: "",
       history: [],
@@ -628,6 +668,9 @@ export class WorkflowState {
       commitAndPushCompleted: false,
       lastCommitMessage: "",
       lastPushBranch: "",
+      // Repo proyek untuk sesi ini. Ditentukan saat start_task, dipakai semua
+      // operasi git berikutnya. Kosong berarti ikuti urutan resolusi di exec.js.
+      projectDir: "",
       featureFlowCreated: false,
       featureFlowDescription: "",
       history: [],
@@ -687,6 +730,9 @@ export class WorkflowState {
       if (typeof this.state.lastPushBranch !== "string") {
         this.state.lastPushBranch = "";
       }
+      if (typeof this.state.projectDir !== "string") {
+        this.state.projectDir = "";
+      }
       if (typeof this.state.featureFlowCreated !== "boolean") {
         this.state.featureFlowCreated = false;
       }
@@ -1014,7 +1060,7 @@ export class WorkflowState {
   async syncToDatabase(options = {}) {
     assertSafeKnowledge(this.state);
     const db = options.db ?? (await import("./db/index.js"));
-    const userId = getCurrentUserId();
+    const userId = getCurrentUserId(this.stateFile);
     // projectRoot dipakai sebagai identitas proyek di database. Ditentukan
     // lewat resolveProjectRootForState, bukan dengan menghitung `dirname`
     // berkali-kali: jumlah itu hanya benar untuk satu kedalaman tertentu.
@@ -1137,6 +1183,9 @@ export class WorkflowState {
       commitAndPushCompleted: false,
       lastCommitMessage: "",
       lastPushBranch: "",
+      // Repo proyek untuk sesi ini. Ditentukan saat start_task, dipakai semua
+      // operasi git berikutnya. Kosong berarti ikuti urutan resolusi di exec.js.
+      projectDir: "",
       featureFlowCreated: false,
       featureFlowDescription: "",
       history,