safeword 0.57.0 → 0.59.0

package/dist/{architecture-3QIZFW3W.js → architecture-32CAOL4P.js}

@@ -2,34 +2,32 @@ import {
   GENERATED_ARCHITECTURE_FILENAME,
   isArchitectureDocumentEnforcementEnabled,
   resolveGeneratedArchitecturePath
-} from "./chunk-P2IC575P.js";
-import {
-  detectWorkspaces
-} from "./chunk-TTFKJM7Q.js";
+} from "./chunk-HI7ANNQI.js";
 import {
   error,
-  success
+  success,
+  warn
 } from "./chunk-NWCBLTIE.js";
 import {
   exists,
   isDirectory,
   readFileSafe,
   readJson
-} from "./chunk-KIZYVSME.js";
+} from "./chunk-2KELQTLE.js";
 
 // src/commands/architecture.ts
 import { execFileSync } from "child_process";
-import nodePath5 from "path";
+import nodePath6 from "path";
 import process from "process";
 
 // src/utils/architecture-document.ts
 import { mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
-import nodePath4 from "path";
+import nodePath5 from "path";
 
 // src/utils/architecture-fingerprint.ts
 import { createHash } from "crypto";
 import { readdirSync as readdirSync2, readFileSync } from "fs";
-import nodePath2 from "path";
+import nodePath3 from "path";
 
 // src/utils/architecture-skeleton.ts
 import { readdirSync } from "fs";
@@ -37,7 +35,19 @@ import nodePath from "path";
 var PURPOSE_PLACEHOLDER = "No description yet \u2014 awaiting prose.";
 var GO_LAYOUT_DIRECTORIES = ["cmd", "internal", "pkg"];
 var RUST_ROOT_FILES = /* @__PURE__ */ new Set(["lib.rs", "main.rs"]);
+var PYTHON_EXCLUDED_FILES = /* @__PURE__ */ new Set([
+  "setup.py",
+  "conftest.py",
+  "noxfile.py",
+  "__init__.py",
+  "__main__.py"
+]);
+var byNodeName = (a, b) => a.name.localeCompare(b.name);
 function extractSkeleton(projectDirectory) {
+  if (exists(nodePath.join(projectDirectory, "pyproject.toml"))) {
+    const pythonNodes = pythonModuleNodes(projectDirectory);
+    if (pythonNodes.length > 0) return { nodes: pythonNodes };
+  }
   if (exists(nodePath.join(projectDirectory, "Cargo.toml"))) {
     return { nodes: rustModuleNodes(projectDirectory) };
   }
@@ -58,10 +68,10 @@ function enumerateModuleDirectories(directory, pathFor) {
   } catch {
     return [];
   }
-  return entries.filter((entry) => entry.isDirectory()).map((entry) => ({ name: entry.name, path: pathFor(entry.name), purpose: PURPOSE_PLACEHOLDER })).toSorted((a, b) => a.name.localeCompare(b.name));
+  return entries.filter((entry) => entry.isDirectory()).map((entry) => ({ name: entry.name, path: pathFor(entry.name), purpose: PURPOSE_PLACEHOLDER })).toSorted(byNodeName);
 }
 function goLayoutNodes(projectDirectory) {
-  return GO_LAYOUT_DIRECTORIES.filter((name) => isDirectory(nodePath.join(projectDirectory, name))).map((name) => ({ name, path: name, purpose: PURPOSE_PLACEHOLDER })).toSorted((a, b) => a.name.localeCompare(b.name));
+  return GO_LAYOUT_DIRECTORIES.filter((name) => isDirectory(nodePath.join(projectDirectory, name))).map((name) => ({ name, path: name, purpose: PURPOSE_PLACEHOLDER })).toSorted(byNodeName);
 }
 function rustModuleNodes(projectDirectory) {
   let entries;
@@ -89,72 +99,194 @@ function rustModuleNodes(projectDirectory) {
       byName.set(name, { name, path: `src/${entry.name}`, purpose: PURPOSE_PLACEHOLDER });
     }
   }
-  return byName.values().toArray().toSorted((a, b) => a.name.localeCompare(b.name));
+  return byName.values().toArray().toSorted(byNodeName);
+}
+function pythonModuleNodes(projectDirectory) {
+  const sourceDirectory = nodePath.join(projectDirectory, "src");
+  if (isDirectory(sourceDirectory)) {
+    return pythonModulesFrom(
+      sourceDirectory,
+      (name) => `src/${name}`,
+      () => true
+    );
+  }
+  return pythonModulesFrom(
+    projectDirectory,
+    (name) => name,
+    (directory) => exists(nodePath.join(directory, "__init__.py"))
+  );
+}
+function pythonModulesFrom(directory, pathFor, keepPackageDirectory) {
+  let entries;
+  try {
+    entries = readdirSync(directory, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const byName = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (entry.isDirectory() && keepPackageDirectory(nodePath.join(directory, entry.name))) {
+      byName.set(entry.name, {
+        name: entry.name,
+        path: pathFor(entry.name),
+        purpose: PURPOSE_PLACEHOLDER
+      });
+    }
+  }
+  for (const entry of entries) {
+    if (entry.isDirectory() || !entry.name.endsWith(".py") || PYTHON_EXCLUDED_FILES.has(entry.name)) {
+      continue;
+    }
+    const name = entry.name.slice(0, -".py".length);
+    if (!byName.has(name)) {
+      byName.set(name, { name, path: pathFor(entry.name), purpose: PURPOSE_PLACEHOLDER });
+    }
+  }
+  return byName.values().toArray().toSorted(byNodeName);
+}
+
+// src/utils/boundary-config.ts
+import nodePath2 from "path";
+var DEPENDENCY_CRUISER_CONFIG_NAMES = [
+  ".dependency-cruiser.cjs",
+  ".dependency-cruiser.js",
+  ".dependency-cruiser.mjs",
+  ".dependency-cruiser.json"
+];
+function readBoundaryConfig(projectDirectory) {
+  for (const name of DEPENDENCY_CRUISER_CONFIG_NAMES) {
+    const content = readFileSafe(nodePath2.join(projectDirectory, name));
+    if (content !== void 0) return content;
+  }
+  return "";
+}
+
+// src/utils/toml.ts
+function readTomlTableArray(content, table, key) {
+  const found = tableArrayBody(content.split(/\r?\n/), table, key);
+  if (found === void 0) return void 0;
+  const values = found.body.matchAll(/"([^"]*)"|'([^']*)'/g).map((match) => match[1] ?? match[2] ?? "").filter((value) => value.length > 0).toArray();
+  return values.length > 0 ? values : void 0;
+}
+function isTomlTableEmptyArray(content, table, key) {
+  const found = tableArrayBody(content.split(/\r?\n/), table, key);
+  return found !== void 0 && found.closed && found.body.replaceAll(/[\s,]/g, "") === "";
+}
+function hasTomlTable(content, table) {
+  return content.split(/\r?\n/).some((line) => tableHeader(stripTomlComment(line).trim()) === table);
+}
+function* linesInTable(content, table) {
+  let inTable = false;
+  for (const rawLine of content.split(/\r?\n/)) {
+    const line = stripTomlComment(rawLine).trim();
+    if (line === "") continue;
+    const header = tableHeader(line);
+    if (header !== void 0) {
+      inTable = header === table;
+      continue;
+    }
+    if (inTable) yield line;
+  }
+}
+function hasTomlTableKey(content, table, key) {
+  for (const line of linesInTable(content, table)) {
+    if (tableValue(line, key) !== void 0) return true;
+  }
+  return false;
+}
+function readTomlTableString(content, table, key) {
+  for (const line of linesInTable(content, table)) {
+    const value = tableValue(line, key);
+    if (value?.startsWith('"')) {
+      const end = value.indexOf('"', 1);
+      if (end !== -1) return value.slice(1, end);
+    }
+  }
+  return void 0;
+}
+function tableArrayBody(lines, table, key) {
+  const opened = findTableArrayOpen(lines, table, key);
+  if (opened === void 0) return void 0;
+  let body = opened.initial;
+  for (let index = opened.line; index < lines.length; index += 1) {
+    if (index > opened.line) body += `
+${stripTomlComment(lines[index] ?? "")}`;
+    const close = indexOfOutsideQuotes(body, "]");
+    if (close !== -1) return { body: body.slice(0, close), closed: true };
+  }
+  return { body, closed: false };
+}
+function findTableArrayOpen(lines, table, key) {
+  let inTable = false;
+  for (const [index, rawLine] of lines.entries()) {
+    const trimmed = stripTomlComment(rawLine).trim();
+    const header = tableHeader(trimmed);
+    if (header !== void 0) {
+      inTable = header === table;
+      continue;
+    }
+    if (!inTable) continue;
+    const value = tableValue(trimmed, key);
+    if (value?.startsWith("[") === true) return { line: index, initial: value.slice(1) };
+  }
+  return void 0;
+}
+function indexOfOutsideQuotes(text, target) {
+  let quote = "";
+  let index = 0;
+  while (index < text.length) {
+    const character = text[index];
+    if (quote === "") {
+      if (character === '"' || character === "'") quote = character;
+      else if (character === target) return index;
+    } else if (character === quote) {
+      quote = "";
+    }
+    index += 1;
+  }
+  return -1;
+}
+function tableValue(line, key) {
+  const equals = line.indexOf("=");
+  if (equals === -1 || line.slice(0, equals).trim() !== key) return void 0;
+  return line.slice(equals + 1).trim();
+}
+function tableHeader(line) {
+  const match = /^\[\[?([^[\]]+)\]\]?\s*$/.exec(line);
+  return match?.[1] === void 0 ? void 0 : match[1].trim();
+}
+function stripTomlComment(line) {
+  const hash = indexOfOutsideQuotes(line, "#");
+  return hash === -1 ? line : line.slice(0, hash);
 }
 
 // src/utils/cargo-manifest.ts
 var DEPENDENCY_TABLES = ["dependencies", "dev-dependencies", "build-dependencies"];
 function readCargoWorkspaceMembers(content) {
-  const body = workspaceMembersArrayBody(content.split(/\r?\n/));
-  if (body === void 0) return void 0;
-  const globs = body.matchAll(/"([^"]*)"|'([^']*)'/g).map((match) => match[1] ?? match[2] ?? "").filter((glob) => glob.length > 0).toArray();
-  return globs.length > 0 ? globs : void 0;
-}
-function workspaceMembersArrayBody(lines) {
-  let inWorkspace = false;
-  let body;
-  for (const rawLine of lines) {
-    const line = stripComment(rawLine);
-    const trimmed = line.trim();
-    if (body === void 0) {
-      const header = /^\[\[?([^[\]]+)\]\]?\s*$/.exec(trimmed);
-      if (header?.[1] !== void 0) {
-        inWorkspace = header[1].trim() === "workspace";
-        continue;
-      }
-      const opening = inWorkspace ? /members\s*=\s*\[(.*)$/.exec(trimmed) : void 0;
-      if (opening?.[1] === void 0) continue;
-      body = opening[1];
-    } else {
-      body += `
-${line}`;
-    }
-    const close = body.indexOf("]");
-    if (close !== -1) return body.slice(0, close);
-  }
-  return body;
+  return readTomlTableArray(content, "workspace", "members");
 }
 function readCargoPackageName(content) {
-  return scanTables(content).packageName;
+  return readTomlTableString(content, "package", "name");
 }
 function readCargoDependencyNames(content) {
-  return [...scanTables(content).dependencyNames];
-}
-function scanTables(content) {
-  const scan = { packageName: void 0, dependencyNames: /* @__PURE__ */ new Set() };
+  const names = /* @__PURE__ */ new Set();
   let currentTable = "";
   for (const rawLine of content.split(/\r?\n/)) {
-    const line = stripComment(rawLine).trim();
+    const line = stripTomlComment(rawLine).trim();
     if (line === "") continue;
     const header = /^\[\[?([^\]]+)\]\]?$/.exec(line);
     if (header?.[1] !== void 0) {
       currentTable = header[1].trim();
       const subTableDependency = dependencySubTableName(currentTable);
-      if (subTableDependency !== void 0) scan.dependencyNames.add(subTableDependency);
+      if (subTableDependency !== void 0) names.add(subTableDependency);
       continue;
     }
-    collectKey(line, currentTable, scan);
-  }
-  return scan;
-}
-function collectKey(line, currentTable, scan) {
-  const key = leadingKey(line);
-  if (key === void 0) return;
-  if (currentTable === "package" && key === "name") {
-    scan.packageName ??= stringValue(line);
-  } else if (DEPENDENCY_TABLES.includes(currentTable)) {
-    scan.dependencyNames.add(key);
+    if (DEPENDENCY_TABLES.includes(currentTable)) {
+      const key = leadingKey(line);
+      if (key !== void 0) names.add(key);
+    }
   }
+  return [...names];
 }
 function dependencySubTableName(table) {
   for (const dependencyTable of DEPENDENCY_TABLES) {
@@ -168,13 +300,6 @@ function leadingKey(line) {
   const match = /^("[^"]+"|'[^']+'|[\w-]+)\s*=/.exec(line);
   return match?.[1] === void 0 ? void 0 : unquote(match[1]);
 }
-function stringValue(line) {
-  return /=\s*"([^"]*)"/.exec(line)?.[1];
-}
-function stripComment(line) {
-  const hash = line.indexOf("#");
-  return hash === -1 ? line : line.slice(0, hash);
-}
 function unquote(value) {
   return value.replaceAll(/^["']|["']$/g, "");
 }
@@ -213,13 +338,22 @@ function dependencySectionNames(manifest) {
   return [...names];
 }
 
+// src/utils/pyproject-manifest.ts
+function readPyprojectName(content) {
+  return readTomlTableString(content, "project", "name");
+}
+function readUvWorkspaceMembers(content) {
+  return readTomlTableArray(content, "tool.uv.workspace", "members");
+}
+function readPyprojectDependencies(content) {
+  const specifiers = readTomlTableArray(content, "project", "dependencies") ?? [];
+  return specifiers.map((specifier) => distributionName(specifier)).filter((name) => name.length > 0);
+}
+function distributionName(specifier) {
+  return /^[\w.-]+/.exec(specifier.trim())?.[0] ?? "";
+}
+
 // src/utils/architecture-fingerprint.ts
-var DEPENDENCY_CRUISER_CONFIG_NAMES = [
-  ".dependency-cruiser.cjs",
-  ".dependency-cruiser.js",
-  ".dependency-cruiser.mjs",
-  ".dependency-cruiser.json"
-];
 var SCHEMA_EXTENSIONS = /* @__PURE__ */ new Set([".sql", ".prisma"]);
 var SHAPE_SCAN_EXCLUDED_DIRECTORIES = /* @__PURE__ */ new Set([
   ".git",
@@ -246,16 +380,27 @@ function readDependencyNames(projectDirectory) {
   const names = new Set(readPackageJsonDependencyNames(projectDirectory));
   for (const goModule of readGoModuleRequires(projectDirectory)) names.add(goModule);
   for (const crate of readCargoDependencies(projectDirectory)) names.add(crate);
+  for (const distribution of readPyprojectDependencyNames(projectDirectory))
+    names.add(distribution);
   return [...names].toSorted(byString);
 }
 function readPackageJsonDependencyNames(projectDirectory) {
-  const manifest = readJson2(nodePath2.join(projectDirectory, "package.json"));
+  const manifest = readJson(nodePath3.join(projectDirectory, "package.json"));
   return manifest === void 0 ? [] : dependencySectionNames(manifest);
 }
 function readCargoDependencies(projectDirectory) {
   try {
     return readCargoDependencyNames(
-      readFileSync(nodePath2.join(projectDirectory, "Cargo.toml"), "utf8")
+      readFileSync(nodePath3.join(projectDirectory, "Cargo.toml"), "utf8")
+    );
+  } catch {
+    return [];
+  }
+}
+function readPyprojectDependencyNames(projectDirectory) {
+  try {
+    return readPyprojectDependencies(
+      readFileSync(nodePath3.join(projectDirectory, "pyproject.toml"), "utf8")
     );
   } catch {
     return [];
@@ -264,7 +409,7 @@ function readCargoDependencies(projectDirectory) {
 function readGoModuleRequires(projectDirectory) {
   let content;
   try {
-    content = readFileSync(nodePath2.join(projectDirectory, "go.mod"), "utf8");
+    content = readFileSync(nodePath3.join(projectDirectory, "go.mod"), "utf8");
   } catch {
     return [];
   }
@@ -286,15 +431,6 @@ function collectGoRequireLines(lines, modules) {
     if (match?.[1] !== void 0) modules.add(match[1]);
   }
 }
-function readBoundaryConfig(projectDirectory) {
-  for (const name of DEPENDENCY_CRUISER_CONFIG_NAMES) {
-    try {
-      return readFileSync(nodePath2.join(projectDirectory, name), "utf8");
-    } catch {
-    }
-  }
-  return "";
-}
 function collectSchemaFiles(projectDirectory) {
   const schemaFiles = [];
   const pending = [projectDirectory];
@@ -316,42 +452,56 @@ function scanDirectoryForSchema(projectDirectory, directory, schemaFiles, pendin
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (!SHAPE_SCAN_EXCLUDED_DIRECTORIES.has(entry.name)) {
-        pending.push(nodePath2.join(directory, entry.name));
+        pending.push(nodePath3.join(directory, entry.name));
       }
-    } else if (SCHEMA_EXTENSIONS.has(nodePath2.extname(entry.name))) {
-      const absolutePath = nodePath2.join(directory, entry.name);
-      schemaFiles.push(nodePath2.relative(projectDirectory, absolutePath).replaceAll("\\", "/"));
+    } else if (SCHEMA_EXTENSIONS.has(nodePath3.extname(entry.name))) {
+      const absolutePath = nodePath3.join(directory, entry.name);
+      schemaFiles.push(nodePath3.relative(projectDirectory, absolutePath).replaceAll("\\", "/"));
     }
   }
 }
-function readJson2(filePath) {
-  try {
-    return JSON.parse(readFileSync(filePath, "utf8"));
-  } catch {
-    return void 0;
-  }
-}
 
 // src/utils/architecture-monorepo.ts
 import { createHash as createHash2 } from "crypto";
 import { globSync } from "fs";
-import nodePath3 from "path";
-var PURPOSE_PLACEHOLDER2 = "No description yet \u2014 awaiting prose.";
-var DEPENDENCY_CRUISER_CONFIG_NAMES2 = [
-  ".dependency-cruiser.cjs",
-  ".dependency-cruiser.js",
-  ".dependency-cruiser.mjs",
-  ".dependency-cruiser.json"
-];
+import nodePath4 from "path";
 var byString2 = (a, b) => a.localeCompare(b);
+var ABSENT = { status: "absent" };
+var parsed = (patterns) => ({ status: "parsed", patterns });
+var unreadable = (manager, config) => ({
+  status: "unreadable",
+  manager,
+  config
+});
+function discoverWorkspaces(projectDirectory) {
+  const detections = [
+    detectJsWorkspaces(projectDirectory),
+    detectGoWork(projectDirectory),
+    detectCargoWorkspace(projectDirectory),
+    detectUvWorkspace(projectDirectory)
+  ];
+  return {
+    patterns: detections.flatMap(
+      (detection) => detection.status === "parsed" ? detection.patterns : []
+    ),
+    unreadable: detections.flatMap(
+      (detection) => detection.status === "unreadable" ? [{ manager: detection.manager, config: detection.config }] : []
+    )
+  };
+}
 function discoverLeafDirectories(projectDirectory) {
-  const patterns = detectWorkspaces(projectDirectory) ?? detectPnpmWorkspaces(projectDirectory) ?? detectGoWork(projectDirectory) ?? detectCargoWorkspace(projectDirectory);
-  if (patterns === void 0) return [];
+  return resolveLeafDirectories(projectDirectory, discoverWorkspaces(projectDirectory).patterns);
+}
+function discoverUnreadableWorkspaces(projectDirectory) {
+  return discoverWorkspaces(projectDirectory).unreadable;
+}
+function resolveLeafDirectories(projectDirectory, patterns) {
+  if (patterns.length === 0) return [];
   const matches = /* @__PURE__ */ new Set();
   for (const pattern of patterns) {
     const globMatches = globSync(pattern, { cwd: projectDirectory });
     for (const match of globMatches) {
-      const absolute = nodePath3.join(projectDirectory, match);
+      const absolute = nodePath4.join(projectDirectory, match);
       if (isDirectory(absolute) && hasRecognizedManifest(absolute)) {
         matches.add(absolute);
       }
@@ -359,14 +509,35 @@ function discoverLeafDirectories(projectDirectory) {
   }
   return [...matches].toSorted(byString2);
 }
+function detectJsWorkspaces(projectDirectory) {
+  const packageJson = detectPackageJsonWorkspaces(projectDirectory);
+  return packageJson.status === "absent" ? detectPnpmWorkspaces(projectDirectory) : packageJson;
+}
+function detectPackageJsonWorkspaces(projectDirectory) {
+  const workspaces = readManifest(projectDirectory)?.workspaces;
+  if (workspaces === void 0) return ABSENT;
+  const list = workspaceList(workspaces);
+  if (list === void 0) return unreadable("package.json workspaces", "package.json");
+  const patterns = list.filter((entry) => typeof entry === "string");
+  return patterns.length > 0 ? parsed(patterns) : ABSENT;
+}
+function workspaceList(workspaces) {
+  if (Array.isArray(workspaces)) return workspaces;
+  if (isObjectRecord(workspaces) && Array.isArray(workspaces.packages)) return workspaces.packages;
+  return void 0;
+}
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null;
+}
 function hasRecognizedManifest(directory) {
-  return readJson(nodePath3.join(directory, "package.json")) !== void 0 || readFileSafe(nodePath3.join(directory, "go.mod")) !== void 0 || readFileSafe(nodePath3.join(directory, "Cargo.toml")) !== void 0;
+  return readJson(nodePath4.join(directory, "package.json")) !== void 0 || readFileSafe(nodePath4.join(directory, "go.mod")) !== void 0 || readFileSafe(nodePath4.join(directory, "Cargo.toml")) !== void 0 || readFileSafe(nodePath4.join(directory, "pyproject.toml")) !== void 0;
 }
 function extractMonorepoModel(projectDirectory) {
-  const packages = discoverLeafDirectories(projectDirectory).map((dir) => ({
+  const { patterns, unreadable: unreadableWorkspaces } = discoverWorkspaces(projectDirectory);
+  const packages = resolveLeafDirectories(projectDirectory, patterns).map((dir) => ({
     name: packageName(dir),
     dir,
-    purpose: PURPOSE_PLACEHOLDER2,
+    purpose: PURPOSE_PLACEHOLDER,
     introspected: extractSkeleton(dir).nodes.length > 0
   })).toSorted((a, b) => byString2(a.name, b.name));
   const names = new Set(packages.map((node) => node.name));
@@ -379,7 +550,7 @@ function extractMonorepoModel(projectDirectory) {
     }
   }
   edges.sort((a, b) => byString2(a.from, b.from) || byString2(a.to, b.to));
-  return { packages, edges };
+  return { packages, edges, unreadableWorkspaces };
 }
 function monorepoFingerprint(projectDirectory) {
   const model = extractMonorepoModel(projectDirectory);
@@ -389,47 +560,68 @@ function monorepoFingerprint(projectDirectory) {
     // index must re-render — otherwise the "not introspected" marker goes stale.
     packages: model.packages.map((node) => `${node.name}:${node.introspected}`),
     edges: model.edges.map((edge) => `${edge.from}->${edge.to}`),
-    boundaryConfig: readBoundaryConfig2(projectDirectory)
+    boundaryConfig: readBoundaryConfig(projectDirectory),
+    // The unreadable-workspace advisory is root shape too: it must re-render when an
+    // unparseable config appears or is fixed. Contributed ONLY when non-empty, so a
+    // repo with no unreadable config keeps its existing fingerprint — no churn (UWP4XK).
+    ...model.unreadableWorkspaces.length > 0 && {
+      unreadable: model.unreadableWorkspaces.map((entry) => `${entry.manager}:${entry.config}`)
+    }
   };
   return createHash2("sha256").update(JSON.stringify(inputs)).digest("hex");
 }
 function readManifest(packageDirectory) {
-  const manifest = readJson(nodePath3.join(packageDirectory, "package.json"));
+  const manifest = readJson(nodePath4.join(packageDirectory, "package.json"));
   return manifest !== null && typeof manifest === "object" ? manifest : void 0;
 }
 function packageName(packageDirectory) {
   const name = readManifest(packageDirectory)?.name;
   if (typeof name === "string" && name.length > 0) return name;
-  return readGoModuleName(packageDirectory) ?? readCargoCrateName(packageDirectory) ?? nodePath3.basename(packageDirectory);
+  return readGoModuleName(packageDirectory) ?? readCargoCrateName(packageDirectory) ?? readPyprojectCrateName(packageDirectory) ?? nodePath4.basename(packageDirectory);
 }
 function readGoModuleName(packageDirectory) {
-  const content = readFileSafe(nodePath3.join(packageDirectory, "go.mod"));
+  const content = readFileSafe(nodePath4.join(packageDirectory, "go.mod"));
   if (content === void 0) return void 0;
   return /^module\s+(\S+)/m.exec(content)?.[1];
 }
 function readCargoCrateName(packageDirectory) {
-  const content = readFileSafe(nodePath3.join(packageDirectory, "Cargo.toml"));
+  const content = readFileSafe(nodePath4.join(packageDirectory, "Cargo.toml"));
   return content === void 0 ? void 0 : readCargoPackageName(content);
 }
+function readPyprojectCrateName(packageDirectory) {
+  const content = readFileSafe(nodePath4.join(packageDirectory, "pyproject.toml"));
+  return content === void 0 ? void 0 : readPyprojectName(content);
+}
+function resolveTomlWorkspaceMembers(content, readMembers, table, label, configFile) {
+  const members = readMembers(content);
+  if (members !== void 0) return parsed(members);
+  if (isTomlTableEmptyArray(content, table, "members")) return ABSENT;
+  return unreadable(label, configFile);
+}
+function detectUvWorkspace(projectDirectory) {
+  const content = readFileSafe(nodePath4.join(projectDirectory, "pyproject.toml"));
+  if (content === void 0) return ABSENT;
+  if (!hasTomlTable(content, "tool.uv.workspace")) return ABSENT;
+  return resolveTomlWorkspaceMembers(
+    content,
+    readUvWorkspaceMembers,
+    "tool.uv.workspace",
+    "uv workspace",
+    "pyproject.toml"
+  );
+}
 function manifestDependencyNames(packageDirectory) {
   const manifest = readManifest(packageDirectory);
   return manifest === void 0 ? [] : dependencySectionNames(manifest);
 }
-function readBoundaryConfig2(projectDirectory) {
-  for (const name of DEPENDENCY_CRUISER_CONFIG_NAMES2) {
-    const content = readFileSafe(nodePath3.join(projectDirectory, name));
-    if (content !== void 0) return content;
-  }
-  return "";
-}
 function detectPnpmWorkspaces(projectDirectory) {
-  const content = readFileSafe(nodePath3.join(projectDirectory, "pnpm-workspace.yaml"));
-  if (content === void 0) return void 0;
+  const content = readFileSafe(nodePath4.join(projectDirectory, "pnpm-workspace.yaml"));
+  if (content === void 0) return ABSENT;
   const lines = content.split(/\r?\n/);
+  if (lines.every((line) => !line.startsWith("packages:"))) return ABSENT;
   const start = lines.findIndex((line) => /^packages:\s*$/.test(line));
-  if (start === -1) return void 0;
-  const globs = collectPnpmGlobs(lines.slice(start + 1));
-  return globs.length > 0 ? globs : void 0;
+  const globs = start === -1 ? [] : collectPnpmGlobs(lines.slice(start + 1));
+  return globs.length > 0 ? parsed(globs) : unreadable("pnpm workspaces", "pnpm-workspace.yaml");
 }
 function collectPnpmGlobs(blockLines) {
   const globs = [];
@@ -444,13 +636,14 @@ function collectPnpmGlobs(blockLines) {
   return globs;
 }
 function detectGoWork(projectDirectory) {
-  const content = readFileSafe(nodePath3.join(projectDirectory, "go.work"));
-  if (content === void 0) return void 0;
+  const content = readFileSafe(nodePath4.join(projectDirectory, "go.work"));
+  if (content === void 0) return ABSENT;
   const lines = content.split(/\r?\n/);
   const directories = [];
   collectGoWorkBlock(lines, directories);
   collectGoWorkSingleLines(lines, directories);
-  return directories.length > 0 ? directories : void 0;
+  if (directories.length > 0) return parsed(directories);
+  return lines.some((line) => /^\s*use\b/.test(line)) ? unreadable("go.work", "go.work") : ABSENT;
 }
 function collectGoWorkBlock(lines, directories) {
   for (const entry of readDelimitedBlock(lines, /^use\s*\(\s*$/)) {
@@ -474,8 +667,17 @@ function normalizeUseTarget(raw) {
   return unquoted.replace(/^\.\//, "");
 }
 function detectCargoWorkspace(projectDirectory) {
-  const content = readFileSafe(nodePath3.join(projectDirectory, "Cargo.toml"));
-  return content === void 0 ? void 0 : readCargoWorkspaceMembers(content);
+  const content = readFileSafe(nodePath4.join(projectDirectory, "Cargo.toml"));
+  if (content === void 0) return ABSENT;
+  if (!hasTomlTable(content, "workspace")) return ABSENT;
+  if (!hasTomlTableKey(content, "workspace", "members")) return ABSENT;
+  return resolveTomlWorkspaceMembers(
+    content,
+    readCargoWorkspaceMembers,
+    "workspace",
+    "Cargo [workspace]",
+    "Cargo.toml"
+  );
 }
 
 // src/utils/architecture-reconcile.ts
@@ -521,7 +723,7 @@ function healTarget(target) {
   const existing = readExisting(target.path);
   const action = decideAction(existing, target.fingerprint, target.hasContent);
   if (isWouldChangeAction(action)) {
-    mkdirSync(nodePath4.dirname(target.path), { recursive: true });
+    mkdirSync(nodePath5.dirname(target.path), { recursive: true });
     const priorStamps = existing === void 0 ? /* @__PURE__ */ new Map() : parseSectionStamps(existing);
     const priorProse = existing === void 0 ? /* @__PURE__ */ new Map() : parseSectionProse(existing);
     writeFileSync(target.path, target.render(priorStamps, priorProse));
@@ -531,25 +733,24 @@ function healTarget(target) {
 function planTarget(target) {
   return decideAction(readExisting(target.path), target.fingerprint, target.hasContent);
 }
-function singleRepoTarget(projectDirectory) {
-  const fingerprint = shapeFingerprint(projectDirectory);
-  const nodes = extractSkeleton(projectDirectory).nodes;
+function skeletonTarget(directory, path) {
+  const fingerprint = shapeFingerprint(directory);
+  const nodes = extractSkeleton(directory).nodes;
   return {
-    path: resolveGeneratedArchitecturePath(projectDirectory),
+    path,
     fingerprint,
     hasContent: nodes.length > 0,
     render: (priorStamps, priorProse) => renderDocument(nodes, fingerprint, priorStamps, priorProse)
   };
 }
+function singleRepoTarget(projectDirectory) {
+  return skeletonTarget(projectDirectory, resolveGeneratedArchitecturePath(projectDirectory));
+}
 function leafTarget(packageDirectory) {
-  const fingerprint = shapeFingerprint(packageDirectory);
-  const nodes = extractSkeleton(packageDirectory).nodes;
-  return {
-    path: nodePath4.join(packageDirectory, GENERATED_ARCHITECTURE_FILENAME),
-    fingerprint,
-    hasContent: nodes.length > 0,
-    render: (priorStamps, priorProse) => renderDocument(nodes, fingerprint, priorStamps, priorProse)
-  };
+  return skeletonTarget(
+    packageDirectory,
+    nodePath5.join(packageDirectory, GENERATED_ARCHITECTURE_FILENAME)
+  );
 }
 function rootIndexTarget(projectDirectory) {
   const fingerprint = monorepoFingerprint(projectDirectory);
@@ -557,13 +758,18 @@ function rootIndexTarget(projectDirectory) {
   return {
     path: resolveGeneratedArchitecturePath(projectDirectory),
     fingerprint,
-    hasContent: model.packages.length > 0,
+    // An unreadable workspace is content too: a root index that exists only to carry the
+    // "config unreadable" advisory is still worth writing — silence would read as "no
+    // monorepo here" when in fact one is present but unreadable (UWP4XK).
+    hasContent: model.packages.length > 0 || model.unreadableWorkspaces.length > 0,
     render: () => renderRootIndex(model, fingerprint)
   };
 }
 function projectTargets(projectDirectory) {
   const leaves = discoverLeafDirectories(projectDirectory);
-  if (leaves.length === 0) return [singleRepoTarget(projectDirectory)];
+  if (leaves.length === 0 && discoverUnreadableWorkspaces(projectDirectory).length === 0) {
+    return [singleRepoTarget(projectDirectory)];
+  }
   return [rootIndexTarget(projectDirectory), ...leaves.map((leaf) => leafTarget(leaf))];
 }
 function selfHealProject(projectDirectory) {
@@ -630,6 +836,16 @@ function accumulateProseLine(line, inProse, buffer) {
   buffer.push(line);
   return true;
 }
+function architectureFrontmatter(fingerprint) {
+  return `---
+${GENERATOR_KEY}: ${GENERATOR_VALUE}
+${FINGERPRINT_KEY}: ${fingerprint}
+---
+
+# Architecture
+
+`;
+}
 function renderDocument(nodes, fingerprint, priorStamps, priorProse) {
   const verdicts = reconcileSections({
     priorStamps: Object.fromEntries(priorStamps),
@@ -643,14 +859,7 @@ function renderDocument(nodes, fingerprint, priorStamps, priorProse) {
     const prose = priorProse.get(verdict.node) ?? node?.purpose ?? "";
     return node === void 0 ? renderOrphanSection(verdict.node) : renderSection(node, stamp, verdict.status, prose);
   }).join("\n");
-  return `---
-${GENERATOR_KEY}: ${GENERATOR_VALUE}
-${FINGERPRINT_KEY}: ${fingerprint}
----
-
-# Architecture
-
-## Modules
+  return `${architectureFrontmatter(fingerprint)}## Modules
 
 ${sections}`;
 }
@@ -676,19 +885,21 @@ function renderRootIndex(model, fingerprint) {
   const edgeLines = model.edges.map((edge) => `- \`${edge.from}\` \u2192 \`${edge.to}\``).join("\n");
   const dependencies = model.edges.length === 0 ? "_No inter-package dependencies._\n" : `${edgeLines}
 `;
-  return `---
-${GENERATOR_KEY}: ${GENERATOR_VALUE}
-${FINGERPRINT_KEY}: ${fingerprint}
----
-
-# Architecture
-
-## Packages
+  return `${architectureFrontmatter(fingerprint)}## Packages
 
 ${sections}
 ## Dependencies
 
-${dependencies}`;
+${dependencies}${renderCoverageGaps(model.unreadableWorkspaces)}`;
+}
+function renderCoverageGaps(unreadable2) {
+  if (unreadable2.length === 0) return "";
+  const items = unreadable2.map((entry) => `> - \`${entry.config}\` (${entry.manager})`).join("\n");
+  return `## Coverage gaps
+
+> \u26A0 not introspected \u2014 workspace config unreadable. A present workspace manager's member list could not be parsed, so its packages may be missing above. Fix the config and re-run \`safeword architecture\`:
+${items}
+`;
 }
 function renderPackageSection(node, stamp) {
   const body = node.introspected ? node.purpose : "> \u26A0 not introspected \u2014 no recognized source layout";
@@ -712,9 +923,18 @@ function architecture(cwd = process.cwd(), options = {}) {
   for (const result of results) {
     success(`Architecture state document ${result.action}: ${result.path}`);
   }
+  warnUnreadableWorkspaces(cwd);
   return Promise.resolve();
 }
+function warnUnreadableWorkspaces(cwd) {
+  for (const workspace of discoverUnreadableWorkspaces(cwd)) {
+    warn(
+      `Workspace config present but unreadable: ${workspace.config} (${workspace.manager}). Its packages may be missing from the architecture doc \u2014 fix the config and re-run \`safeword architecture\`. (Advisory; nothing is blocked.)`
+    );
+  }
+}
 function architectureStage(cwd) {
+  warnUnreadableWorkspaces(cwd);
   if (!isArchitectureDocumentEnforcementEnabled(cwd)) {
     success("Architecture doc enforcement is opted out (architectureDocEnforcement: false).");
     return Promise.resolve();
@@ -732,12 +952,13 @@ function architectureStage(cwd) {
 }
 function stageDocument(cwd, result) {
   try {
-    const relativePath = nodePath5.relative(cwd, result.path);
+    const relativePath = nodePath6.relative(cwd, result.path);
     execFileSync("git", ["add", "--", relativePath], { cwd, stdio: "ignore" });
   } catch {
   }
 }
 function architectureCheck(cwd) {
+  warnUnreadableWorkspaces(cwd);
   if (!isArchitectureDocumentEnforcementEnabled(cwd)) {
     success("Architecture doc enforcement is opted out (architectureDocEnforcement: false).");
     return Promise.resolve();
@@ -755,4 +976,4 @@ function architectureCheck(cwd) {
 export {
   architecture
 };
-//# sourceMappingURL=architecture-3QIZFW3W.js.map
+//# sourceMappingURL=architecture-32CAOL4P.js.map