@fenglimg/fabric-shared 2.1.0-rc.2 → 2.2.0-rc.10

package/dist/chunk-2GLIAZ5M.js

@@ -0,0 +1,251 @@
+// src/i18n/normalize-locale.ts
+function normalizeLocale(raw) {
+  if (typeof raw !== "string") {
+    return "en";
+  }
+  const normalized = raw.trim().toLowerCase().replace(/\..*$/, "").replace(/_/g, "-");
+  if (normalized.length === 0) {
+    return "en";
+  }
+  if (normalized === "zh" || normalized.startsWith("zh-")) {
+    return "zh-CN";
+  }
+  return "en";
+}
+
+// src/i18n/detect-node-locale.ts
+function detectNodeLocale() {
+  const fromFabricEnv = process.env.FAB_LANG;
+  if (typeof fromFabricEnv === "string" && fromFabricEnv.trim().length > 0) {
+    return normalizeLocale(fromFabricEnv);
+  }
+  const fromLangEnv = process.env.LANG;
+  if (typeof fromLangEnv === "string" && fromLangEnv.trim().length > 0) {
+    return normalizeLocale(fromLangEnv);
+  }
+  return "en";
+}
+
+// src/schemas/store.ts
+import { z } from "zod";
+var STORE_UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u;
+var storeUuidSchema = z.string().regex(STORE_UUID_PATTERN, "store_uuid must be a canonical lowercase UUID");
+var STORE_ALIAS_PATTERN = /^(?!\.{1,2}$)[A-Za-z0-9._-]{1,80}$/u;
+var storeAliasSchema = z.string().regex(
+  STORE_ALIAS_PATTERN,
+  "store alias must be a single [A-Za-z0-9._-] path segment, max 80 chars"
+);
+var PERSONAL_STORE_SENTINEL = "$personal";
+var storeIdentitySchema = z.object({
+  // Intrinsic, immutable once minted. Read from store.json, never recomputed.
+  store_uuid: storeUuidSchema,
+  // ISO-8601. When the store was first initialized.
+  created_at: z.string(),
+  // Optional human-facing canonical alias baked into the store (e.g. the
+  // team picks "platform-kb"). Local per-machine aliases are resolved by the
+  // StoreResolver from config and may differ; this is the suggested default.
+  canonical_alias: storeAliasSchema.optional(),
+  // Optional one-line description surfaced in `store list` / onboarding.
+  description: z.string().optional(),
+  // The semantic scopes this store is *allowed* to hold. A shared (team)
+  // store MUST NOT list "personal" (R5#3 privacy boundary, enforced at write
+  // time in P2). Open coordinate strings — see schemas/scope.ts.
+  allowed_scopes: z.array(z.string()).optional()
+}).strict();
+var STORE_PROJECT_ID_PATTERN = /^[a-z0-9_-]+$/u;
+var STORE_MOUNT_NAME_PATTERN = /^[a-z0-9][a-z0-9._-]{0,78}[a-z0-9]$/u;
+var storeMountNameSchema = z.string().regex(
+  STORE_MOUNT_NAME_PATTERN,
+  "mount_name must be lowercase [a-z0-9._-], start/end with alnum, max 80 chars"
+).refine((value) => value !== "." && value !== "..", "mount_name cannot be . or ..");
+var storeProjectSchema = z.object({
+  // Single scope segment forming the `project:<id>` coordinate. Immutable.
+  id: z.string().regex(STORE_PROJECT_ID_PATTERN, "project id must be a single lowercase [a-z0-9_-] segment"),
+  // Optional human-facing label surfaced in `store project list`.
+  name: z.string().optional(),
+  // ISO-8601. When the project was first registered in this store.
+  created_at: z.string()
+}).strict();
+var storeProjectsFileSchema = z.object({
+  projects: z.array(storeProjectSchema).default([])
+}).strict();
+var requiredStoreEntrySchema = z.object({
+  id: z.string().min(1),
+  suggested_remote: z.union([z.string().min(1), z.literal(PERSONAL_STORE_SENTINEL)]).optional()
+}).strict();
+var STORE_KNOWLEDGE_TYPE_DIRS = [
+  "models",
+  "decisions",
+  "guidelines",
+  "pitfalls",
+  "processes"
+];
+var STORE_LAYOUT = {
+  identityFile: "store.json",
+  // Store-internal project registry (W1/A2). Committed parallel to store.json.
+  projectsFile: "projects.json",
+  // v2.2 W4 (agents.meta decolo) — per-store monotonic stable_id counters.
+  // COMMITTED parallel to store.json/projects.json (NOT gitignored like the
+  // derived agents.meta) because the counter ledger is non-derivable state that
+  // must travel with the store on clone: a fresh clone rebuilding from disk-max
+  // would re-mint a deleted entry's id and corrupt cite history (KT-DEC-0004
+  // monotonic invariant). Replaces the retired co-location
+  // <projectRoot>/.fabric/agents.meta.json#counters.
+  countersFile: "counters.json",
+  knowledgeDir: "knowledge",
+  bindingsDir: "bindings",
+  stateDir: "state"
+};
+var STORES_ROOT_DIR = "stores";
+var GLOBAL_STATE_DIR = "state";
+var GLOBAL_BINDINGS_DIR = "bindings";
+function storeKnowledgeTypeDir(type) {
+  return `${STORE_LAYOUT.knowledgeDir}/${type}`;
+}
+function storeRelativePath(storeUuid) {
+  return `${STORES_ROOT_DIR}/${storeUuid}`;
+}
+var STORE_MOUNT_GROUPS = ["personal", "team"];
+function storeMountGroup(store) {
+  return store.personal === true ? "personal" : "team";
+}
+function storeMountSubPath(store) {
+  return `${storeMountGroup(store)}/${store.mount_name ?? store.store_uuid}`;
+}
+function storeRelativePathForMount(store) {
+  return `${STORES_ROOT_DIR}/${storeMountSubPath(store)}`;
+}
+function sanitizeMountLabel(raw) {
+  const slug = raw.toLowerCase().replace(/[^a-z0-9._-]+/gu, "-").replace(/[-._]{2,}/gu, "-").replace(/^[^a-z0-9]+/u, "").replace(/[^a-z0-9]+$/u, "").slice(0, 80).replace(/[^a-z0-9]+$/u, "");
+  return STORE_MOUNT_NAME_PATTERN.test(slug) ? slug : void 0;
+}
+function mountLabelFromRemote(remote) {
+  const withoutGit = remote.trim().replace(/\.git$/iu, "").replace(/\/+$/u, "");
+  const lastSegment = withoutGit.split(/[\\/:]/u).filter(Boolean).at(-1);
+  return lastSegment === void 0 ? void 0 : sanitizeMountLabel(lastSegment);
+}
+function deriveMountLabel(input) {
+  const fromRemote = input.remote === void 0 ? void 0 : mountLabelFromRemote(input.remote);
+  if (fromRemote !== void 0) {
+    return fromRemote;
+  }
+  if (input.alias !== void 0) {
+    const fromAlias = sanitizeMountLabel(input.alias);
+    if (fromAlias !== void 0) {
+      return fromAlias;
+    }
+  }
+  return input.store_uuid.replace(/-/gu, "").slice(0, 8);
+}
+var mountedStoreSchema = z.object({
+  // Intrinsic identity of the mounted store (matches its store.json).
+  store_uuid: storeUuidSchema,
+  // Stable human-readable local directory under ~/.fabric/stores/. When absent,
+  // older uuid-named mounts stay valid and resolve to stores/<store_uuid>.
+  mount_name: storeMountNameSchema.optional(),
+  // Local per-machine alias the user references this store by (resolver maps
+  // alias → uuid). May differ from the store's canonical_alias.
+  alias: storeAliasSchema,
+  // Optional user-facing label. Does not participate in resolution.
+  display_name: z.string().optional(),
+  // Git remote locator for this clone, if any. Absent = local-only store
+  // (valid; doctor nudges to add a remote for backup — R5#5, P6).
+  remote: z.string().min(1).optional(),
+  // v2.1.0-rc.1 P3: marks the implicit personal store (the one minted by
+  // `install --global`). Exactly one mounted store carries personal=true; it
+  // is the write target for personal-scope entries (R5#3) and always in the
+  // read-set (S11). Optional (no default) so the output type stays a plain
+  // optional — consumers coalesce `?? false` when building resolver input.
+  personal: z.boolean().optional(),
+  // Whether writes are accepted into this store from this machine. Optional;
+  // consumers coalesce `?? true`. Shared stores cloned read-only set false.
+  writable: z.boolean().optional()
+}).strict();
+var globalConfigSchema = z.object({
+  // Machine/account identity. Personal-knowledge id namespace (S33/S27).
+  uid: z.string().min(1),
+  // grill-6fixes (D1): the single machine-wide language base tone. Governs
+  // BOTH the CLI display locale AND the knowledge-authoring language — there
+  // is no per-project override (the old project `fabric_language` +
+  // README-detection path was removed). Picked once via the install
+  // language selector; changeable via `fabric config`. Absent ⇒ resolvers
+  // fall back to env detection (FAB_LANG → LANG → en).
+  language: z.enum(["zh-CN", "en"]).optional(),
+  // All stores mounted on this machine. The implicit personal store is
+  // included here once initialized. Default empty so a fresh global config
+  // (before `install --global`) parses cleanly.
+  stores: z.array(mountedStoreSchema).optional().default([])
+}).passthrough();
+
+// src/store/global-config-io.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+function resolveGlobalRoot() {
+  return join(process.env.FABRIC_HOME ?? homedir(), ".fabric");
+}
+function globalConfigPath(globalRoot = resolveGlobalRoot()) {
+  return join(globalRoot, "fabric-global.json");
+}
+function loadGlobalConfig(globalRoot = resolveGlobalRoot()) {
+  const path = globalConfigPath(globalRoot);
+  if (!existsSync(path)) {
+    return null;
+  }
+  return globalConfigSchema.parse(JSON.parse(readFileSync(path, "utf8")));
+}
+function saveGlobalConfig(config, globalRoot = resolveGlobalRoot()) {
+  const validated = globalConfigSchema.parse(config);
+  mkdirSync(globalRoot, { recursive: true });
+  writeFileSync(globalConfigPath(globalRoot), `${JSON.stringify(validated, null, 2)}
+`, "utf8");
+}
+
+// src/i18n/resolve-global-locale.ts
+function resolveGlobalLocale(globalRoot) {
+  try {
+    const config = globalRoot === void 0 ? loadGlobalConfig() : loadGlobalConfig(globalRoot);
+    const language = config?.language;
+    if (language === "zh-CN" || language === "en") {
+      return language;
+    }
+  } catch {
+  }
+  return detectNodeLocale();
+}
+
+export {
+  normalizeLocale,
+  detectNodeLocale,
+  STORE_UUID_PATTERN,
+  storeUuidSchema,
+  STORE_ALIAS_PATTERN,
+  storeAliasSchema,
+  PERSONAL_STORE_SENTINEL,
+  storeIdentitySchema,
+  STORE_PROJECT_ID_PATTERN,
+  STORE_MOUNT_NAME_PATTERN,
+  storeMountNameSchema,
+  storeProjectSchema,
+  storeProjectsFileSchema,
+  requiredStoreEntrySchema,
+  STORE_KNOWLEDGE_TYPE_DIRS,
+  STORE_LAYOUT,
+  STORES_ROOT_DIR,
+  GLOBAL_STATE_DIR,
+  GLOBAL_BINDINGS_DIR,
+  storeKnowledgeTypeDir,
+  storeRelativePath,
+  STORE_MOUNT_GROUPS,
+  storeMountGroup,
+  storeMountSubPath,
+  storeRelativePathForMount,
+  deriveMountLabel,
+  mountedStoreSchema,
+  globalConfigSchema,
+  resolveGlobalRoot,
+  globalConfigPath,
+  loadGlobalConfig,
+  saveGlobalConfig,
+  resolveGlobalLocale
+};