@fenglimg/fabric-cli 2.2.0-rc.4 → 2.2.0-rc.8

package/dist/{store-ZEZMQVG7.js → store-HOCORVL3.js}

@@ -1,11 +1,8 @@
 #!/usr/bin/env node
 import {
   regenerateBindingsSnapshot
-} from "./chunk-H3FE6VIK.js";
+} from "./chunk-PTGQAZEW.js";
 import "./chunk-EOT63RDH.js";
-import {
-  getProjectTranslator
-} from "./chunk-2CY4BMTH.js";
 import {
   assertStoreMountable,
   resolveStoreDir,
@@ -18,16 +15,20 @@ import {
   storeProjectCreate,
   storeProjectList,
   storeRemove,
+  storeSetWriteRoute,
   storeSwitchWrite
-} from "./chunk-5SSNE5GM.js";
+} from "./chunk-QPAW6IYT.js";
 import {
-  loadGlobalConfig,
   loadProjectConfig
-} from "./chunk-XCBVSGCS.js";
+} from "./chunk-QFIVFZRH.js";
+import "./chunk-FNHDQTPC.js";
+import {
+  getProjectTranslator
+} from "./chunk-HORSMSZL.js";
 
 // src/commands/store.ts
 import { defineCommand } from "citty";
-import { join as join4 } from "path";
+import { join as join3 } from "path";
 
 // src/store/scope-backfill.ts
 import { existsSync, readFileSync, readdirSync, writeFileSync } from "fs";
@@ -120,273 +121,18 @@ function backfillKnowledgeDir(knowledgeDir, options) {
   return report;
 }
 
-// src/store/store-migrate.ts
-import { execFileSync } from "child_process";
-import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, readdirSync as readdirSync2, rmSync, writeFileSync as writeFileSync2 } from "fs";
-import { basename, join as join2 } from "path";
+// src/store/store-rescope.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync as readdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2 } from "path";
 import {
   STORE_KNOWLEDGE_TYPE_DIRS as STORE_KNOWLEDGE_TYPE_DIRS2,
   STORE_LAYOUT,
-  STORE_PENDING_DIR,
-  buildStoreResolveInput,
-  createStoreResolver,
-  formatKnowledgeId,
-  parseKnowledgeId as parseKnowledgeId2,
-  reconcileStoreCounters,
-  resolveGlobalRoot,
-  storeRelativePath
-} from "@fenglimg/fabric-shared";
-function resolveTargetStore(layer, projectRoot, globalRoot) {
-  const input = buildStoreResolveInput(projectRoot, globalRoot);
-  if (input === null) {
-    return null;
-  }
-  const scope = layer === "personal" ? "personal" : "team";
-  const { target } = createStoreResolver().resolveWriteTarget(input, scope);
-  if (target === null) {
-    return null;
-  }
-  const alias = loadGlobalConfig(globalRoot)?.stores.find((s) => s.store_uuid === target.store_uuid)?.alias ?? target.store_uuid;
-  return {
-    uuid: target.store_uuid,
-    alias,
-    dir: join2(globalRoot, storeRelativePath(target.store_uuid))
-  };
-}
-function listMd(dir) {
-  if (!existsSync2(dir)) {
-    return [];
-  }
-  return readdirSync2(dir).filter((name) => name.endsWith(".md")).sort();
-}
-function readId(content) {
-  const match = content.match(/^id:\s*(\S+)\s*$/mu);
-  return match ? match[1] : null;
-}
-function slugSuffix(fileName, oldId) {
-  const stem = fileName.replace(/\.md$/u, "");
-  if (oldId !== null && stem.startsWith(`${oldId}--`)) {
-    return stem.slice(oldId.length);
-  }
-  return "";
-}
-function buildStoreIdIndex(storeDir) {
-  const existing = /* @__PURE__ */ new Set();
-  const maxCounter = /* @__PURE__ */ new Map();
-  for (const type of STORE_KNOWLEDGE_TYPE_DIRS2) {
-    const dir = join2(storeDir, STORE_LAYOUT.knowledgeDir, type);
-    for (const file of listMd(dir)) {
-      const content = readFileSync2(join2(dir, file), "utf8");
-      const id = readId(content) ?? file.replace(/\.md$/u, "").split("--")[0];
-      const parsed = parseKnowledgeId2(id);
-      if (parsed === null) {
-        continue;
-      }
-      existing.add(id);
-      const key = id.slice(0, id.lastIndexOf("-"));
-      maxCounter.set(key, Math.max(maxCounter.get(key) ?? 0, parsed.counter));
-    }
-  }
-  return { existing, maxCounter };
-}
-function nextId(index, layer, type) {
-  const probe = formatKnowledgeId(layer, type, 1);
-  const key = probe.slice(0, probe.lastIndexOf("-"));
-  let counter = (index.maxCounter.get(key) ?? 0) + 1;
-  let id = formatKnowledgeId(layer, type, counter);
-  while (index.existing.has(id)) {
-    counter += 1;
-    id = formatKnowledgeId(layer, type, counter);
-  }
-  index.existing.add(id);
-  index.maxCounter.set(key, counter);
-  return id;
-}
-function typeDirToKnowledgeType(typeDir) {
-  return STORE_KNOWLEDGE_TYPE_DIRS2.includes(typeDir) ? typeDir : null;
-}
-function migrateProjectKnowledge(projectRoot, options = {}) {
-  const dryRun = options.dryRun ?? false;
-  const globalRoot = options.globalRoot ?? resolveGlobalRoot();
-  const runGit = options.git ?? true;
-  const items = [];
-  const skips = [];
-  const remap = {};
-  const targets = {};
-  const sourceRoots = {
-    team: join2(projectRoot, ".fabric", "knowledge"),
-    personal: join2(globalRoot, "knowledge")
-  };
-  const layerState = {};
-  for (const layer of ["team", "personal"]) {
-    if (!existsSync2(sourceRoots[layer])) {
-      continue;
-    }
-    const target = resolveTargetStore(layer, projectRoot, globalRoot);
-    if (target === null) {
-      continue;
-    }
-    targets[layer] = { uuid: target.uuid, dir: target.dir };
-    layerState[layer] = { target, index: buildStoreIdIndex(target.dir) };
-  }
-  for (const layer of ["team", "personal"]) {
-    const root = sourceRoots[layer];
-    if (!existsSync2(root)) {
-      continue;
-    }
-    const state = layerState[layer];
-    for (const typeDir of STORE_KNOWLEDGE_TYPE_DIRS2) {
-      const dir = join2(root, typeDir);
-      for (const file of listMd(dir)) {
-        const source = join2(dir, file);
-        if (state === void 0) {
-          skips.push({
-            source,
-            reason: `no ${layer} write-target store \u2014 run \`fabric install --global\` then \`fabric store bind <alias>\`${layer === "team" ? " + `fabric store switch-write <alias>`" : ""}`
-          });
-          continue;
-        }
-        const content = readFileSync2(source, "utf8");
-        const oldId = readId(content);
-        const knowledgeType = typeDirToKnowledgeType(typeDir);
-        let newId = null;
-        if (oldId !== null && state.index.existing.has(oldId) && knowledgeType !== null) {
-          const parsed = parseKnowledgeId2(oldId);
-          const idLayer = parsed?.layer ?? layer;
-          newId = nextId(state.index, idLayer, knowledgeType);
-          remap[oldId] = newId;
-        } else if (oldId !== null) {
-          state.index.existing.add(oldId);
-          const parsed = parseKnowledgeId2(oldId);
-          if (parsed !== null) {
-            const key = oldId.slice(0, oldId.lastIndexOf("-"));
-            state.index.maxCounter.set(
-              key,
-              Math.max(state.index.maxCounter.get(key) ?? 0, parsed.counter)
-            );
-          }
-        }
-        const effectiveId = newId ?? oldId;
-        const targetName = newId !== null && effectiveId !== null ? `${effectiveId}${slugSuffix(file, oldId)}.md` : file;
-        const targetFile = join2(state.target.dir, STORE_LAYOUT.knowledgeDir, typeDir, targetName);
-        items.push({
-          source,
-          layer,
-          type: typeDir,
-          oldId,
-          newId,
-          target: targetFile,
-          storeUuid: state.target.uuid,
-          alias: state.target.alias
-        });
-      }
-    }
-    const pendingRoot = join2(root, STORE_PENDING_DIR);
-    for (const sub of [".", "decisions", "guidelines", "pitfalls", "models", "processes"]) {
-      const dir = sub === "." ? pendingRoot : join2(pendingRoot, sub);
-      for (const file of listMd(dir)) {
-        const source = join2(dir, file);
-        if (state === void 0) {
-          skips.push({ source, reason: `no ${layer} write-target store` });
-          continue;
-        }
-        const rel = sub === "." ? file : join2(sub, file);
-        const targetFile = join2(
-          state.target.dir,
-          STORE_LAYOUT.knowledgeDir,
-          STORE_PENDING_DIR,
-          rel
-        );
-        if (existsSync2(targetFile)) {
-          skips.push({ source, reason: `pending already present in store: ${basename(targetFile)}` });
-          continue;
-        }
-        items.push({
-          source,
-          layer,
-          type: STORE_PENDING_DIR,
-          oldId: null,
-          newId: null,
-          target: targetFile,
-          storeUuid: state.target.uuid,
-          alias: state.target.alias
-        });
-      }
-    }
-  }
-  if (dryRun || items.length === 0) {
-    return { dryRun, committed: false, items, skips, remap, targets };
-  }
-  for (const item of items) {
-    let content = readFileSync2(item.source, "utf8");
-    if (item.newId !== null && item.oldId !== null) {
-      content = content.replace(/^id:\s*\S+\s*$/mu, `id: ${item.newId}`);
-    }
-    content = rewriteRelated(content, remap);
-    mkdirSync(join2(item.target, ".."), { recursive: true });
-    writeFileSync2(item.target, content, "utf8");
-  }
-  for (const item of items) {
-    rmSync(item.source, { force: true });
-  }
-  for (const info of Object.values(targets)) {
-    if (items.some((i) => i.storeUuid === info.uuid)) {
-      reconcileStoreCounters(info.dir);
-    }
-  }
-  let committed = false;
-  if (runGit) {
-    for (const [layer, info] of Object.entries(targets)) {
-      const moved = items.filter((i) => i.layer === layer).length;
-      if (moved === 0) {
-        continue;
-      }
-      committed = gitCommitStore(info.dir, moved) || committed;
-    }
-  }
-  return { dryRun, committed, items, skips, remap, targets };
-}
-function rewriteRelated(content, remap) {
-  if (Object.keys(remap).length === 0) {
-    return content;
-  }
-  return content.replace(/^related:\s*\[(.*)\]\s*$/mu, (line, inner) => {
-    const rewritten = inner.split(",").map((token) => {
-      const trimmed = token.trim();
-      return remap[trimmed] ?? trimmed;
-    }).join(", ");
-    return `related: [${rewritten}]`;
-  });
-}
-function gitCommitStore(storeDir, count) {
-  if (!existsSync2(join2(storeDir, ".git"))) {
-    return false;
-  }
-  try {
-    execFileSync("git", ["add", "-A"], { cwd: storeDir, stdio: ["ignore", "ignore", "pipe"] });
-    execFileSync(
-      "git",
-      ["commit", "-m", `chore(migrate): import ${count} entries from project dual-root`],
-      { cwd: storeDir, stdio: ["ignore", "ignore", "pipe"] }
-    );
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-// src/store/store-rescope.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join3 } from "path";
-import {
-  STORE_KNOWLEDGE_TYPE_DIRS as STORE_KNOWLEDGE_TYPE_DIRS3,
-  STORE_LAYOUT as STORE_LAYOUT2,
   isPersonalScope as isPersonalScope2,
   readStoreProjects,
   scopeCoordinateSchema,
   scopeRoot
 } from "@fenglimg/fabric-shared";
-function validateToScope(toScope, storeDir, storeVisibility) {
+async function validateToScope(toScope, storeDir, storeVisibility) {
   if (!scopeCoordinateSchema.safeParse(toScope).success) {
     return `invalid scope coordinate '${toScope}'`;
   }
@@ -395,7 +141,7 @@ function validateToScope(toScope, storeDir, storeVisibility) {
   }
   if (scopeRoot(toScope) === "project") {
     const projectId = toScope.split(":")[1] ?? "";
-    if (projectId.length === 0 || !readStoreProjects(storeDir).some((p) => p.id === projectId)) {
+    if (projectId.length === 0 || !(await readStoreProjects(storeDir)).some((p) => p.id === projectId)) {
       return `project '${projectId}' is not registered in this store (run \`fabric store project add ${projectId}\` first)`;
     }
   }
@@ -413,7 +159,7 @@ function matchesSelection(options, id, currentScope) {
   }
   return true;
 }
-function rescopeStore(storeDir, toScope, options) {
+async function rescopeStore(storeDir, toScope, options) {
   const report = {
     dryRun: options.dryRun === true,
     toScope,
@@ -422,15 +168,15 @@ function rescopeStore(storeDir, toScope, options) {
     unchanged: 0,
     skipped: []
   };
-  const toScopeError = validateToScope(toScope, storeDir, options.storeVisibility);
-  for (const type of STORE_KNOWLEDGE_TYPE_DIRS3) {
-    const dir = join3(storeDir, STORE_LAYOUT2.knowledgeDir, type);
-    if (!existsSync3(dir)) {
+  const toScopeError = await validateToScope(toScope, storeDir, options.storeVisibility);
+  for (const type of STORE_KNOWLEDGE_TYPE_DIRS2) {
+    const dir = join2(storeDir, STORE_LAYOUT.knowledgeDir, type);
+    if (!existsSync2(dir)) {
       continue;
     }
-    for (const name of readdirSync3(dir).filter((n) => n.endsWith(".md")).sort()) {
-      const file = join3(dir, name);
-      const content = readFileSync3(file, "utf8");
+    for (const name of readdirSync2(dir).filter((n) => n.endsWith(".md")).sort()) {
+      const file = join2(dir, name);
+      const content = readFileSync2(file, "utf8");
       const match = FRONTMATTER_RE.exec(content);
       if (match === null) {
         report.skipped.push(file);
@@ -455,7 +201,7 @@ function rescopeStore(storeDir, toScope, options) {
       const after = content.slice(match.index + match[0].length);
       report.changes.push({ file, id, fromScope: currentScope, toScope });
       if (options.dryRun !== true) {
-        writeFileSync3(file, `${before}---
+        writeFileSync2(file, `${before}---
 ${newBlock}
 ---${after}`, "utf8");
       }
@@ -463,16 +209,16 @@ ${newBlock}
   }
   return report;
 }
-function promoteProjectToTeam(storeDir, options) {
+async function promoteProjectToTeam(storeDir, options) {
   const selection = options.projectId !== void 0 ? { fromScope: `project:${options.projectId}`, storeVisibility: options.storeVisibility, dryRun: options.dryRun } : { fromScopeRoot: "project", storeVisibility: options.storeVisibility, dryRun: options.dryRun };
   return rescopeStore(storeDir, "team", selection);
 }
 
 // src/commands/store.ts
 import {
-  STORE_LAYOUT as STORE_LAYOUT3,
-  loadGlobalConfig as loadGlobalConfig2,
-  resolveGlobalRoot as resolveGlobalRoot2
+  STORE_LAYOUT as STORE_LAYOUT2,
+  loadGlobalConfig,
+  resolveGlobalRoot
 } from "@fenglimg/fabric-shared";
 var listCommand = defineCommand({
   meta: { name: "list", description: "List mounted knowledge stores" },
@@ -485,8 +231,10 @@ var listCommand = defineCommand({
     }
     const localOnly = t("cli.shared.local-only");
     for (const store of stores) {
-      const realRemote = storeGitRemote(store.store_uuid);
-      console.log(`${store.alias}	${store.store_uuid}	${realRemote ?? localOnly}`);
+      const realRemote = storeGitRemote(store.alias);
+      console.log(
+        `${store.alias}	${store.mount_name ?? store.store_uuid}	${store.store_uuid}	${realRemote ?? localOnly}`
+      );
     }
   }
 });
@@ -495,11 +243,21 @@ var addCommand = defineCommand({
   args: {
     uuid: { type: "string", required: true, description: "Intrinsic store UUID" },
     alias: { type: "string", required: true, description: "Local alias for this store" },
+    "mount-name": { type: "string", description: "Stable local directory under ~/.fabric/stores/" },
     remote: { type: "string", description: "Git remote locator (omit for local-only)" }
   },
-  run({ args }) {
-    assertStoreMountable(args.uuid);
-    const store = args.remote === void 0 ? { store_uuid: args.uuid, alias: args.alias } : { store_uuid: args.uuid, alias: args.alias, remote: args.remote };
+  async run({ args }) {
+    assertStoreMountable(args.uuid, void 0, args["mount-name"]);
+    const store = args.remote === void 0 ? {
+      store_uuid: args.uuid,
+      alias: args.alias,
+      ...args["mount-name"] === void 0 ? {} : { mount_name: args["mount-name"] }
+    } : {
+      store_uuid: args.uuid,
+      alias: args.alias,
+      ...args["mount-name"] === void 0 ? {} : { mount_name: args["mount-name"] },
+      remote: args.remote
+    };
     const next = storeAdd(store);
     const t = getProjectTranslator();
     console.log(
@@ -514,10 +272,12 @@ var createCommand = defineCommand({
   meta: { name: "create", description: "Create a brand-new local knowledge store and mount it" },
   args: {
     alias: { type: "string", required: true, description: "Local alias for the new store" },
+    "mount-name": { type: "string", description: "Stable local directory under ~/.fabric/stores/" },
     remote: { type: "string", description: "Git remote to associate (push target; optional)" }
   },
-  run({ args }) {
-    const result = storeCreate(args.alias, (/* @__PURE__ */ new Date()).toISOString(), {
+  async run({ args }) {
+    const result = await storeCreate(args.alias, (/* @__PURE__ */ new Date()).toISOString(), {
+      ...args["mount-name"] === void 0 ? {} : { mountName: args["mount-name"] },
       ...args.remote === void 0 ? {} : { remote: args.remote }
     });
     const t = getProjectTranslator();
@@ -532,9 +292,12 @@ var removeCommand = defineCommand({
   args: {
     alias: { type: "positional", required: true, description: "Alias to detach" }
   },
-  run({ args }) {
+  async run({ args }) {
     const { detached } = storeRemove(args.alias);
     const t = getProjectTranslator();
+    if (detached === null) {
+      process.exitCode = 1;
+    }
     console.log(
       detached === null ? t("cli.store.no-alias", { alias: args.alias }) : t("cli.store.detached", { alias: args.alias })
     );
@@ -547,6 +310,9 @@ var explainCommand = defineCommand({
   },
   run({ args }) {
     const explanation = storeExplain(args.alias);
+    if (explanation === null) {
+      process.exitCode = 1;
+    }
     console.log(
       explanation === null ? getProjectTranslator()("cli.store.no-alias", { alias: args.alias }) : JSON.stringify(explanation, null, 2)
     );
@@ -562,10 +328,10 @@ var bindCommand = defineCommand({
       description: "Bind this repo to a project:<id> in the store (must already exist)"
     }
   },
-  run({ args }) {
+  async run({ args }) {
     const entry = args.remote === void 0 ? { id: args.id } : { id: args.id, suggested_remote: args.remote };
     const projectRoot = process.cwd();
-    const next = storeBind(
+    const next = await storeBind(
       projectRoot,
       entry,
       args.project === void 0 ? {} : { project: args.project }
@@ -580,57 +346,27 @@ var bindCommand = defineCommand({
   }
 });
 var switchWriteCommand = defineCommand({
-  meta: { name: "switch-write", description: "Set the active write store for non-personal scopes" },
+  meta: { name: "switch-write", description: "Set the default write store for non-personal scopes" },
   args: {
     alias: { type: "positional", required: true, description: "Alias of the store to write to" }
   },
-  run({ args }) {
+  async run({ args }) {
     const projectRoot = process.cwd();
     storeSwitchWrite(projectRoot, args.alias);
+    regenerateBindingsSnapshot(projectRoot, { now: (/* @__PURE__ */ new Date()).toISOString() });
     console.log(getProjectTranslator(projectRoot)("cli.store.switch-write", { alias: args.alias }));
   }
 });
-var migrateCommand = defineCommand({
-  meta: {
-    name: "migrate",
-    description: "Move project-local (dual-root) knowledge into the resolved write-target stores"
-  },
+var routeWriteCommand = defineCommand({
+  meta: { name: "route-write", description: "Route a semantic scope to a writable shared store" },
   args: {
-    "dry-run": {
-      type: "boolean",
-      description: "Preview the move without writing anything"
-    }
+    scope: { type: "positional", required: true, description: "Semantic scope, e.g. team or project:fabric-v2" },
+    alias: { type: "positional", required: true, description: "Alias of the shared store to write to" }
   },
   run({ args }) {
     const projectRoot = process.cwd();
-    const t = getProjectTranslator(projectRoot);
-    const dryRun = args["dry-run"] === true;
-    const report = migrateProjectKnowledge(projectRoot, { dryRun });
-    if (report.items.length === 0 && report.skips.length === 0) {
-      console.log(t("cli.store.migrate.none"));
-      return;
-    }
-    console.log(
-      dryRun ? t("cli.store.migrate.dry-run-header") : t("cli.store.migrate.applied-header", { count: String(report.items.length) })
-    );
-    for (const item of report.items) {
-      const id = item.newId ?? item.oldId ?? "(draft)";
-      console.log(`  ${item.layer}/${item.type}  ${id}  \u2192  ${item.alias}`);
-      if (item.newId !== null && item.oldId !== null) {
-        console.log(
-          t("cli.store.migrate.remap-note", { oldId: item.oldId, newId: item.newId })
-        );
-      }
-    }
-    if (report.skips.length > 0) {
-      console.log(t("cli.store.migrate.skips-header", { count: String(report.skips.length) }));
-      for (const skip of report.skips) {
-        console.log(`  ${skip.source}: ${skip.reason}`);
-      }
-    }
-    if (report.committed) {
-      console.log(t("cli.store.migrate.committed"));
-    }
+    storeSetWriteRoute(projectRoot, args.scope, args.alias);
+    console.log(`write route: ${args.scope} -> ${args.alias}`);
   }
 });
 var projectListCommand = defineCommand({
@@ -638,8 +374,8 @@ var projectListCommand = defineCommand({
   args: {
     store: { type: "positional", required: true, description: "Store alias/UUID" }
   },
-  run({ args }) {
-    const projects = storeProjectList(args.store);
+  async run({ args }) {
+    const projects = await storeProjectList(args.store);
     if (projects.length === 0) {
       console.log(`store '${args.store}' has no registered projects.`);
       return;
@@ -656,8 +392,8 @@ var projectCreateCommand = defineCommand({
     id: { type: "positional", required: true, description: "Project id (single [a-z0-9_-] segment)" },
     name: { type: "string", description: "Optional human-facing label" }
   },
-  run({ args }) {
-    const project = storeProjectCreate(args.store, args.id, (/* @__PURE__ */ new Date()).toISOString(), {
+  async run({ args }) {
+    const project = await storeProjectCreate(args.store, args.id, (/* @__PURE__ */ new Date()).toISOString(), {
       ...args.name === void 0 ? {} : { name: args.name }
     });
     console.log(`registered project '${project.id}' in store '${args.store}'.`);
@@ -676,26 +412,30 @@ var backfillScopeCommand = defineCommand({
     description: "Backfill semantic_scope + visibility_store on existing knowledge (repairs dirty layer)"
   },
   args: {
-    store: { type: "string", description: "Backfill a mounted store's knowledge instead of the project" },
+    store: { type: "string", description: "Backfill a mounted store's knowledge" },
     "dry-run": { type: "boolean", description: "Preview changes without writing" }
   },
   run({ args }) {
     const dryRun = args["dry-run"] === true;
     let knowledgeDir;
     let visibilityStore;
-    if (typeof args.store === "string" && args.store.length > 0) {
-      const storeDir = resolveStoreDir(args.store);
+    const selectedStore = typeof args.store === "string" && args.store.length > 0 ? args.store : loadProjectConfig(process.cwd())?.active_write_store;
+    if (typeof selectedStore !== "string" || selectedStore.length === 0) {
+      console.error(
+        "no store selected for scope backfill; pass --store <alias> or run `fabric store switch-write <alias>`"
+      );
+      process.exitCode = 1;
+      return;
+    }
+    {
+      const storeDir = resolveStoreDir(selectedStore);
       if (storeDir === null) {
-        console.error(`no mounted store '${args.store}'`);
+        console.error(`no mounted store '${selectedStore}'`);
         process.exitCode = 1;
         return;
       }
-      knowledgeDir = join4(storeDir, STORE_LAYOUT3.knowledgeDir);
-      visibilityStore = args.store;
-    } else {
-      const projectRoot = process.cwd();
-      knowledgeDir = join4(projectRoot, ".fabric", "knowledge");
-      visibilityStore = loadProjectConfig(projectRoot)?.active_write_store ?? "team";
+      knowledgeDir = join3(storeDir, STORE_LAYOUT2.knowledgeDir);
+      visibilityStore = selectedStore;
     }
     const report = backfillKnowledgeDir(knowledgeDir, { visibilityStore, dryRun });
     if (report.changes.length === 0) {
@@ -708,6 +448,12 @@ var backfillScopeCommand = defineCommand({
     for (const c of report.changes) {
       console.log(`  ${c.id ?? "(no id)"}  [${c.changed.join(", ")}]`);
     }
+    const scopeAssigned = report.changes.filter((c) => c.changed.includes("semantic_scope")).length;
+    if (scopeAssigned > 0) {
+      console.error(
+        `${dryRun ? "[dry-run] " : ""}note: ${scopeAssigned} entr${scopeAssigned === 1 ? "y" : "ies"} defaulted to semantic_scope: team. Demote project-specific ones with \`fabric store re-scope <store> --to project:<id> --id <id>\`.`
+      );
+    }
   }
 });
 function resolveStoreDirAndVisibility(aliasOrUuid) {
@@ -715,7 +461,7 @@ function resolveStoreDirAndVisibility(aliasOrUuid) {
   if (dir === null) {
     return null;
   }
-  const store = loadGlobalConfig2(resolveGlobalRoot2())?.stores.find(
+  const store = loadGlobalConfig(resolveGlobalRoot())?.stores.find(
     (s) => s.alias === aliasOrUuid || s.store_uuid === aliasOrUuid
   );
   return { dir, visibility: store?.personal === true ? "personal" : "shared" };
@@ -752,7 +498,7 @@ var rescopeCommand = defineCommand({
     from: { type: "string", description: "Only entries currently at this semantic_scope" },
     "dry-run": { type: "boolean", description: "Preview changes without writing" }
   },
-  run({ args }) {
+  async run({ args }) {
     const resolved = resolveStoreDirAndVisibility(args.store);
     if (resolved === null) {
       console.error(`no mounted store '${args.store}'`);
@@ -760,7 +506,7 @@ var rescopeCommand = defineCommand({
       return;
     }
     printRescopeReport(
-      rescopeStore(resolved.dir, args.to, {
+      await rescopeStore(resolved.dir, args.to, {
         id: args.id,
         fromScope: args.from,
         storeVisibility: resolved.visibility,
@@ -779,7 +525,7 @@ var promoteCommand = defineCommand({
     project: { type: "string", description: "Only this project's entries (default: all project:*)" },
     "dry-run": { type: "boolean", description: "Preview changes without writing" }
   },
-  run({ args }) {
+  async run({ args }) {
     const resolved = resolveStoreDirAndVisibility(args.store);
     if (resolved === null) {
       console.error(`no mounted store '${args.store}'`);
@@ -787,7 +533,7 @@ var promoteCommand = defineCommand({
       return;
     }
     printRescopeReport(
-      promoteProjectToTeam(resolved.dir, {
+      await promoteProjectToTeam(resolved.dir, {
         projectId: args.project,
         storeVisibility: resolved.visibility,
         dryRun: args["dry-run"] === true
@@ -805,7 +551,7 @@ var store_default = defineCommand({
     explain: explainCommand,
     bind: bindCommand,
     "switch-write": switchWriteCommand,
-    migrate: migrateCommand,
+    "route-write": routeWriteCommand,
     "backfill-scope": backfillScopeCommand,
     "re-scope": rescopeCommand,
     promote: promoteCommand,