@kitsy/coop-core 1.0.0 → 2.0.0

package/dist/index.cjs

@@ -72,6 +72,11 @@ __export(index_exports, {
   compute_readiness_with_corrections: () => compute_readiness_with_corrections,
   compute_score: () => compute_score,
   compute_velocity: () => compute_velocity,
+  coop_project_config_path: () => coop_project_config_path,
+  coop_project_root: () => coop_project_root,
+  coop_projects_dir: () => coop_projects_dir,
+  coop_workspace_config_path: () => coop_workspace_config_path,
+  coop_workspace_dir: () => coop_workspace_dir,
   createItem: () => createItem,
   create_seeded_rng: () => create_seeded_rng,
   critical_path_weight: () => critical_path_weight,
@@ -83,6 +88,7 @@ __export(index_exports, {
   effective_weekly_hours: () => effective_weekly_hours,
   effort_or_default: () => effort_or_default,
   ensureCoopLayout: () => ensureCoopLayout,
+  ensure_workspace_layout: () => ensure_workspace_layout,
   executor_fit_weight: () => executor_fit_weight,
   external_dependencies_for_task: () => external_dependencies_for_task,
   extract_subgraph: () => extract_subgraph,
@@ -91,7 +97,11 @@ __export(index_exports, {
   getItemById: () => getItemById,
   get_remaining_tokens: () => get_remaining_tokens,
   get_user_role: () => get_user_role,
+  has_legacy_project_layout: () => has_legacy_project_layout,
+  has_v2_projects_layout: () => has_v2_projects_layout,
   is_external_dependency: () => is_external_dependency,
+  is_project_initialized: () => is_project_initialized,
+  list_projects: () => list_projects,
   loadState: () => loadState,
   load_auth_config: () => load_auth_config,
   load_completed_runs: () => load_completed_runs,
@@ -116,9 +126,14 @@ __export(index_exports, {
   pert_stddev: () => pert_stddev,
   priority_weight: () => priority_weight,
   queryItems: () => queryItems,
+  read_project_config: () => read_project_config,
   read_schema_version: () => read_schema_version,
+  read_workspace_config: () => read_workspace_config,
   renderAgentPrompt: () => renderAgentPrompt,
+  repo_default_project_id: () => repo_default_project_id,
+  repo_default_project_name: () => repo_default_project_name,
   resolve_external_dependencies: () => resolve_external_dependencies,
+  resolve_project: () => resolve_project,
   risk_penalty: () => risk_penalty,
   run_hook: () => run_hook,
   run_monte_carlo_chunk: () => run_monte_carlo_chunk,
@@ -147,7 +162,8 @@ __export(index_exports, {
   validate_transition: () => validate_transition,
   writeTask: () => writeTask,
   writeYamlFile: () => writeYamlFile,
-  write_schema_version: () => write_schema_version
+  write_schema_version: () => write_schema_version,
+  write_workspace_config: () => write_workspace_config
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -4858,9 +4874,131 @@ function validate(task, context = {}) {
   };
 }
 
-// src/core.ts
+// src/workspace.ts
 var import_node_fs14 = __toESM(require("fs"), 1);
 var import_node_path9 = __toESM(require("path"), 1);
+var COOP_DIR_NAME = ".coop";
+function sanitizeProjectId(value, fallback) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-+/g, "-");
+  return normalized || fallback;
+}
+function coop_workspace_dir(repoRoot) {
+  return import_node_path9.default.join(import_node_path9.default.resolve(repoRoot), COOP_DIR_NAME);
+}
+function coop_projects_dir(repoRoot) {
+  return import_node_path9.default.join(coop_workspace_dir(repoRoot), "projects");
+}
+function coop_workspace_config_path(repoRoot) {
+  return import_node_path9.default.join(coop_workspace_dir(repoRoot), "config.yml");
+}
+function coop_project_root(repoRoot, projectId) {
+  return import_node_path9.default.join(coop_projects_dir(repoRoot), projectId);
+}
+function coop_project_config_path(projectRoot) {
+  return import_node_path9.default.join(projectRoot, "config.yml");
+}
+function repo_default_project_id(repoRoot) {
+  return sanitizeProjectId(import_node_path9.default.basename(import_node_path9.default.resolve(repoRoot)), "workspace");
+}
+function repo_default_project_name(repoRoot) {
+  const base = import_node_path9.default.basename(import_node_path9.default.resolve(repoRoot)).trim();
+  return base || "COOP Workspace";
+}
+function has_v2_projects_layout(repoRoot) {
+  return import_node_fs14.default.existsSync(coop_projects_dir(repoRoot));
+}
+function has_legacy_project_layout(repoRoot) {
+  const workspaceDir = coop_workspace_dir(repoRoot);
+  return import_node_fs14.default.existsSync(workspaceDir) && import_node_fs14.default.existsSync(import_node_path9.default.join(workspaceDir, "config.yml")) && !import_node_fs14.default.existsSync(coop_projects_dir(repoRoot));
+}
+function read_workspace_config(repoRoot) {
+  const configPath = coop_workspace_config_path(repoRoot);
+  if (!import_node_fs14.default.existsSync(configPath) || has_legacy_project_layout(repoRoot)) {
+    return { version: 2 };
+  }
+  return parseYamlFile(configPath);
+}
+function write_workspace_config(repoRoot, config) {
+  import_node_fs14.default.mkdirSync(coop_workspace_dir(repoRoot), { recursive: true });
+  writeYamlFile(coop_workspace_config_path(repoRoot), {
+    version: config.version ?? 2,
+    ...config.current_project ? { current_project: config.current_project } : {}
+  });
+}
+function read_project_config(projectRoot) {
+  return parseYamlFile(coop_project_config_path(projectRoot));
+}
+function project_ref_from_config(repoRoot, projectRoot, layout) {
+  const config = read_project_config(projectRoot);
+  const repoName = repo_default_project_name(repoRoot);
+  const fallbackId = repo_default_project_id(repoRoot);
+  return {
+    id: sanitizeProjectId(config.project?.id ?? fallbackId, fallbackId),
+    name: config.project?.name?.trim() || repoName,
+    aliases: Array.isArray(config.project?.aliases) ? config.project.aliases.filter((entry) => typeof entry === "string" && entry.trim().length > 0) : [],
+    root: projectRoot,
+    repo_root: import_node_path9.default.resolve(repoRoot),
+    layout
+  };
+}
+function list_projects(repoRoot) {
+  if (has_v2_projects_layout(repoRoot)) {
+    const projectsDir = coop_projects_dir(repoRoot);
+    return import_node_fs14.default.readdirSync(projectsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => import_node_path9.default.join(projectsDir, entry.name)).filter((projectRoot) => import_node_fs14.default.existsSync(coop_project_config_path(projectRoot))).map((projectRoot) => project_ref_from_config(repoRoot, projectRoot, "v2")).sort((a, b) => a.id.localeCompare(b.id));
+  }
+  if (has_legacy_project_layout(repoRoot)) {
+    return [project_ref_from_config(repoRoot, coop_workspace_dir(repoRoot), "legacy")];
+  }
+  return [];
+}
+function resolve_project(repoRoot, options = {}) {
+  const projects = list_projects(repoRoot);
+  const requested = options.project?.trim().toLowerCase();
+  if (requested) {
+    const match = projects.find(
+      (project) => project.id.toLowerCase() === requested || project.name.toLowerCase() === requested || project.aliases.some((alias) => alias.toLowerCase() === requested)
+    );
+    if (!match) {
+      throw new Error(`Project '${options.project}' not found.`);
+    }
+    return match;
+  }
+  if (projects.length === 1) {
+    return projects[0];
+  }
+  const workspaceConfig = read_workspace_config(repoRoot);
+  if (workspaceConfig.current_project) {
+    const match = projects.find((project) => project.id === workspaceConfig.current_project);
+    if (match) return match;
+  }
+  if (!options.require && projects.length === 0) {
+    return {
+      id: repo_default_project_id(repoRoot),
+      name: repo_default_project_name(repoRoot),
+      aliases: [],
+      root: coop_project_root(repoRoot, repo_default_project_id(repoRoot)),
+      repo_root: import_node_path9.default.resolve(repoRoot),
+      layout: "v2"
+    };
+  }
+  if (projects.length === 0) {
+    throw new Error("No COOP project found. Run 'coop init'.");
+  }
+  throw new Error("Multiple COOP projects found. Pass --project <id> or run 'coop project use <id>'.");
+}
+function ensure_workspace_layout(repoRoot) {
+  const workspaceDir = coop_workspace_dir(repoRoot);
+  import_node_fs14.default.mkdirSync(workspaceDir, { recursive: true });
+  import_node_fs14.default.mkdirSync(coop_projects_dir(repoRoot), { recursive: true });
+  return workspaceDir;
+}
+function is_project_initialized(projectRoot) {
+  return import_node_fs14.default.existsSync(coop_project_config_path(projectRoot));
+}
+
+// src/core.ts
+var import_node_fs15 = __toESM(require("fs"), 1);
+var import_node_path10 = __toESM(require("path"), 1);
 var import_gray_matter = __toESM(require("gray-matter"), 1);
 
 // src/types.ts
@@ -4886,17 +5024,17 @@ function toIdKey(value) {
   return value.trim().toUpperCase();
 }
 function repoRootByPackage(cwd) {
-  let current = import_node_path9.default.resolve(cwd);
+  let current = import_node_path10.default.resolve(cwd);
   let lastWorkspaceRoot = null;
   while (true) {
-    const packageJson = import_node_path9.default.join(current, "package.json");
-    const workspaceYaml = import_node_path9.default.join(current, "pnpm-workspace.yaml");
-    if (import_node_fs14.default.existsSync(packageJson) && import_node_fs14.default.existsSync(workspaceYaml)) {
+    const packageJson = import_node_path10.default.join(current, "package.json");
+    const workspaceYaml = import_node_path10.default.join(current, "pnpm-workspace.yaml");
+    if (import_node_fs15.default.existsSync(packageJson) && import_node_fs15.default.existsSync(workspaceYaml)) {
       lastWorkspaceRoot = current;
-      const hasCoop = import_node_fs14.default.existsSync(import_node_path9.default.join(current, COOP_DIR, "config.yml"));
+      const hasCoop = import_node_fs15.default.existsSync(import_node_path10.default.join(current, COOP_DIR, "config.yml"));
       if (hasCoop) return current;
     }
-    const parent = import_node_path9.default.dirname(current);
+    const parent = import_node_path10.default.dirname(current);
     if (parent === current) return lastWorkspaceRoot;
     current = parent;
   }
@@ -4905,24 +5043,24 @@ function findRepoRoot(cwd = process.cwd()) {
   return repoRootByPackage(cwd);
 }
 function configPathFor(rootDir, workspaceDir) {
-  return import_node_path9.default.join(rootDir, workspaceDir, "config.yml");
+  return import_node_path10.default.join(rootDir, workspaceDir, "config.yml");
 }
 function backlogPathFor(rootDir, workspaceDir) {
-  return import_node_path9.default.join(rootDir, workspaceDir, "backlog");
+  return import_node_path10.default.join(rootDir, workspaceDir, "backlog");
 }
 function releasesPathFor(rootDir, workspaceDir) {
-  return import_node_path9.default.join(rootDir, workspaceDir, "releases");
+  return import_node_path10.default.join(rootDir, workspaceDir, "releases");
 }
 function detectWorkspaceDir(rootDir) {
-  if (import_node_fs14.default.existsSync(configPathFor(rootDir, COOP_DIR))) return COOP_DIR;
-  if (import_node_fs14.default.existsSync(import_node_path9.default.join(rootDir, COOP_DIR))) return COOP_DIR;
+  if (import_node_fs15.default.existsSync(configPathFor(rootDir, COOP_DIR))) return COOP_DIR;
+  if (import_node_fs15.default.existsSync(import_node_path10.default.join(rootDir, COOP_DIR))) return COOP_DIR;
   return null;
 }
 function preferredWorkspaceDir(rootDir) {
   return detectWorkspaceDir(rootDir) ?? COOP_DIR;
 }
 function missingConfigError(rootDir) {
-  const coopConfig = import_node_path9.default.relative(rootDir, configPathFor(rootDir, COOP_DIR));
+  const coopConfig = import_node_path10.default.relative(rootDir, configPathFor(rootDir, COOP_DIR));
   return new Error(`COOP config missing at ${coopConfig}. Run: coop init`);
 }
 function parseConfig(raw) {
@@ -4968,10 +5106,10 @@ function configToString(config) {
   return lines.join("\n");
 }
 function toPortablePath(value) {
-  return value.split(import_node_path9.default.sep).join("/");
+  return value.split(import_node_path10.default.sep).join("/");
 }
 function ensureReleasesDir(rootDir, workspaceDir) {
-  import_node_fs14.default.mkdirSync(releasesPathFor(rootDir, workspaceDir), { recursive: true });
+  import_node_fs15.default.mkdirSync(releasesPathFor(rootDir, workspaceDir), { recursive: true });
 }
 function releaseHeader(date) {
   return `## ${date}`;
@@ -4993,12 +5131,12 @@ function appendReleaseEntry(rootDir, workspaceDir, item, previousStatus, nextSta
   ensureReleasesDir(rootDir, workspaceDir);
   const now = /* @__PURE__ */ new Date();
   const date = now.toISOString().slice(0, 10);
-  const releasePath = import_node_path9.default.join(releasesPathFor(rootDir, workspaceDir), `${date}.md`);
+  const releasePath = import_node_path10.default.join(releasesPathFor(rootDir, workspaceDir), `${date}.md`);
   const heading = "# COOP Release Notes";
   const dayHeader = releaseHeader(date);
   const entry = releaseEntryLine(item, previousStatus, nextStatus);
-  if (!import_node_fs14.default.existsSync(releasePath)) {
-    import_node_fs14.default.writeFileSync(
+  if (!import_node_fs15.default.existsSync(releasePath)) {
+    import_node_fs15.default.writeFileSync(
       releasePath,
       [
         `${heading}
@@ -5011,10 +5149,10 @@ function appendReleaseEntry(rootDir, workspaceDir, item, previousStatus, nextSta
       ].join("\n"),
       "utf8"
     );
-    return toPortablePath(import_node_path9.default.relative(rootDir, releasePath));
+    return toPortablePath(import_node_path10.default.relative(rootDir, releasePath));
   }
-  const existing = import_node_fs14.default.readFileSync(releasePath, "utf8");
-  if (hasReleaseEntry(existing, item.id)) return toPortablePath(import_node_path9.default.relative(rootDir, releasePath));
+  const existing = import_node_fs15.default.readFileSync(releasePath, "utf8");
+  if (hasReleaseEntry(existing, item.id)) return toPortablePath(import_node_path10.default.relative(rootDir, releasePath));
   let nextContent = existing;
   if (!existing.includes(`## ${date}`)) {
     if (!nextContent.endsWith("\n")) nextContent += "\n";
@@ -5024,9 +5162,9 @@ function appendReleaseEntry(rootDir, workspaceDir, item, previousStatus, nextSta
   if (!nextContent.endsWith("\n")) nextContent += "\n";
   nextContent += `${entry}
 `;
-  import_node_fs14.default.writeFileSync(releasePath, `${nextContent}
+  import_node_fs15.default.writeFileSync(releasePath, `${nextContent}
 `, "utf8");
-  return toPortablePath(import_node_path9.default.relative(rootDir, releasePath));
+  return toPortablePath(import_node_path10.default.relative(rootDir, releasePath));
 }
 function completeItem(rootDir, id) {
   const state = loadState(rootDir);
@@ -5104,28 +5242,28 @@ function validateAndNormalize(data, sourceFile) {
   };
 }
 function parseItem(filePath, rootDir) {
-  const raw = import_node_fs14.default.readFileSync(filePath, "utf8");
+  const raw = import_node_fs15.default.readFileSync(filePath, "utf8");
   const parsed = (0, import_gray_matter.default)(raw);
-  const data = validateAndNormalize(parsed.data, import_node_path9.default.relative(rootDir, filePath));
+  const data = validateAndNormalize(parsed.data, import_node_path10.default.relative(rootDir, filePath));
   return {
     ...data,
     body: parsed.content || "",
-    filePath: import_node_path9.default.relative(rootDir, filePath)
+    filePath: import_node_path10.default.relative(rootDir, filePath)
   };
 }
 function walk(dir) {
   const out = [];
-  if (!import_node_fs14.default.existsSync(dir)) return out;
-  const entries = import_node_fs14.default.readdirSync(dir, { withFileTypes: true });
+  if (!import_node_fs15.default.existsSync(dir)) return out;
+  const entries = import_node_fs15.default.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const file = import_node_path9.default.join(dir, entry.name);
+    const file = import_node_path10.default.join(dir, entry.name);
     if (entry.isDirectory()) out.push(...walk(file));
     if (entry.isFile() && file.endsWith(".md")) out.push(file);
   }
   return out;
 }
 function itemPath(type, id, rootDir, workspaceDir) {
-  return import_node_path9.default.join(backlogPathFor(rootDir, workspaceDir), ITEM_DIRS[type], `${id}.md`);
+  return import_node_path10.default.join(backlogPathFor(rootDir, workspaceDir), ITEM_DIRS[type], `${id}.md`);
 }
 function normalizeFrontmatterValue(value) {
   if (value == null) return void 0;
@@ -5212,30 +5350,30 @@ function nextGeneratedId(config, title, existing) {
 }
 function ensureCoopLayout(rootDir) {
   const workspaceDir = preferredWorkspaceDir(rootDir);
-  const root = import_node_path9.default.join(rootDir, workspaceDir);
-  import_node_fs14.default.mkdirSync(root, { recursive: true });
-  import_node_fs14.default.mkdirSync(import_node_path9.default.join(root, "releases"), { recursive: true });
-  import_node_fs14.default.mkdirSync(import_node_path9.default.join(root, "plans"), { recursive: true });
-  import_node_fs14.default.mkdirSync(import_node_path9.default.join(root, "views"), { recursive: true });
-  import_node_fs14.default.mkdirSync(import_node_path9.default.join(root, "templates"), { recursive: true });
+  const root = import_node_path10.default.join(rootDir, workspaceDir);
+  import_node_fs15.default.mkdirSync(root, { recursive: true });
+  import_node_fs15.default.mkdirSync(import_node_path10.default.join(root, "releases"), { recursive: true });
+  import_node_fs15.default.mkdirSync(import_node_path10.default.join(root, "plans"), { recursive: true });
+  import_node_fs15.default.mkdirSync(import_node_path10.default.join(root, "views"), { recursive: true });
+  import_node_fs15.default.mkdirSync(import_node_path10.default.join(root, "templates"), { recursive: true });
   for (const dir of Object.values(ITEM_DIRS)) {
-    import_node_fs14.default.mkdirSync(import_node_path9.default.join(root, "backlog", dir), { recursive: true });
+    import_node_fs15.default.mkdirSync(import_node_path10.default.join(root, "backlog", dir), { recursive: true });
   }
-  const configFile = import_node_path9.default.join(root, "config.yml");
-  if (!import_node_fs14.default.existsSync(configFile)) {
-    import_node_fs14.default.writeFileSync(configFile, configToString(DEFAULT_CONFIG3), "utf8");
+  const configFile = import_node_path10.default.join(root, "config.yml");
+  if (!import_node_fs15.default.existsSync(configFile)) {
+    import_node_fs15.default.writeFileSync(configFile, configToString(DEFAULT_CONFIG3), "utf8");
   }
 }
 function loadState(rootDir) {
   const workspaceDir = detectWorkspaceDir(rootDir);
   if (!workspaceDir) throw missingConfigError(rootDir);
   const configPath = configPathFor(rootDir, workspaceDir);
-  if (!import_node_fs14.default.existsSync(configPath)) throw missingConfigError(rootDir);
-  const config = parseConfig(import_node_fs14.default.readFileSync(configPath, "utf8"));
+  if (!import_node_fs15.default.existsSync(configPath)) throw missingConfigError(rootDir);
+  const config = parseConfig(import_node_fs15.default.readFileSync(configPath, "utf8"));
   const items = [];
   const itemsById = /* @__PURE__ */ new Map();
   for (const type of ITEM_TYPES) {
-    const dir = import_node_path9.default.join(backlogPathFor(rootDir, workspaceDir), ITEM_DIRS[type]);
+    const dir = import_node_path10.default.join(backlogPathFor(rootDir, workspaceDir), ITEM_DIRS[type]);
     const files = walk(dir);
     for (const file of files) {
       const item = parseItem(file, rootDir);
@@ -5319,21 +5457,21 @@ function createItem(rootDir, params) {
     parent_id: params.parent_id
   };
   const itemPathName = itemPath(params.type, item.id, rootDir, state.workspaceDir);
-  import_node_fs14.default.writeFileSync(itemPathName, serialize(item, params.body || ""), "utf8");
+  import_node_fs15.default.writeFileSync(itemPathName, serialize(item, params.body || ""), "utf8");
   if ((config.id_strategy ?? "text") === "counter") {
     const numericMatch = /-(\d+)$/.exec(item.id);
     if (numericMatch) {
       const numericValue = Number(numericMatch[1]);
       if (Number.isInteger(numericValue) && numericValue >= (config.next_id ?? 1)) {
         config.next_id = numericValue + 1;
-        import_node_fs14.default.writeFileSync(configPathFor(rootDir, state.workspaceDir), configToString(config), "utf8");
+        import_node_fs15.default.writeFileSync(configPathFor(rootDir, state.workspaceDir), configToString(config), "utf8");
       }
     }
   }
   return {
     ...item,
     body: params.body || "",
-    filePath: import_node_path9.default.relative(rootDir, itemPathName)
+    filePath: import_node_path10.default.relative(rootDir, itemPathName)
   };
 }
 function updateItem(rootDir, id, patch) {
@@ -5359,8 +5497,8 @@ function updateItem(rootDir, id, patch) {
   };
   if (!ITEM_TYPES.includes(next.type)) throw new Error(`Unknown type ${next.type}.`);
   if (!ITEM_STATUSES.includes(next.status)) throw new Error(`Unknown status ${next.status}.`);
-  const filePath = import_node_path9.default.join(rootDir, existing.filePath);
-  import_node_fs14.default.writeFileSync(filePath, serialize(next, patch.body || existing.body), "utf8");
+  const filePath = import_node_path10.default.join(rootDir, existing.filePath);
+  import_node_fs15.default.writeFileSync(filePath, serialize(next, patch.body || existing.body), "utf8");
   return {
     ...next,
     body: patch.body || existing.body,
@@ -5376,7 +5514,7 @@ function deleteItem(rootDir, id) {
   if (children.length > 0) {
     throw new Error(`Cannot delete ${existing.id} because it has ${children.length} child item(s). Remove children first.`);
   }
-  import_node_fs14.default.unlinkSync(import_node_path9.default.join(rootDir, existing.filePath));
+  import_node_fs15.default.unlinkSync(import_node_path10.default.join(rootDir, existing.filePath));
   return existing;
 }
 function renderAgentPrompt(item) {
@@ -5415,8 +5553,8 @@ function validateRepo(rootDir) {
   const errors = [];
   const warnings = [];
   const workspaceDir = detectWorkspaceDir(rootDir);
-  if (!workspaceDir || !import_node_fs14.default.existsSync(configPathFor(rootDir, workspaceDir))) {
-    errors.push("Missing .coop/config.yml. Run coop init first.");
+  if (!workspaceDir || !import_node_fs15.default.existsSync(configPathFor(rootDir, workspaceDir))) {
+    errors.push("Missing COOP config. Run coop init first.");
     return { valid: false, errors, warnings };
   }
   let state;
@@ -5490,6 +5628,11 @@ function validateRepo(rootDir) {
   compute_readiness_with_corrections,
   compute_score,
   compute_velocity,
+  coop_project_config_path,
+  coop_project_root,
+  coop_projects_dir,
+  coop_workspace_config_path,
+  coop_workspace_dir,
   createItem,
   create_seeded_rng,
   critical_path_weight,
@@ -5501,6 +5644,7 @@ function validateRepo(rootDir) {
   effective_weekly_hours,
   effort_or_default,
   ensureCoopLayout,
+  ensure_workspace_layout,
   executor_fit_weight,
   external_dependencies_for_task,
   extract_subgraph,
@@ -5509,7 +5653,11 @@ function validateRepo(rootDir) {
   getItemById,
   get_remaining_tokens,
   get_user_role,
+  has_legacy_project_layout,
+  has_v2_projects_layout,
   is_external_dependency,
+  is_project_initialized,
+  list_projects,
   loadState,
   load_auth_config,
   load_completed_runs,
@@ -5534,9 +5682,14 @@ function validateRepo(rootDir) {
   pert_stddev,
   priority_weight,
   queryItems,
+  read_project_config,
   read_schema_version,
+  read_workspace_config,
   renderAgentPrompt,
+  repo_default_project_id,
+  repo_default_project_name,
   resolve_external_dependencies,
+  resolve_project,
   risk_penalty,
   run_hook,
   run_monte_carlo_chunk,
@@ -5565,5 +5718,6 @@ function validateRepo(rootDir) {
   validate_transition,
   writeTask,
   writeYamlFile,
-  write_schema_version
+  write_schema_version,
+  write_workspace_config
 });

package/dist/index.d.cts

@@ -1386,6 +1386,39 @@ interface ValidationResult {
 }
 declare function validate(task: Task, context?: ValidationContext): ValidationResult;
 
+type CoopWorkspaceConfig = {
+    version?: number;
+    current_project?: string;
+};
+type CoopProjectRef = {
+    id: string;
+    name: string;
+    aliases: string[];
+    root: string;
+    repo_root: string;
+    layout: "legacy" | "v2";
+};
+type ResolveProjectOptions = {
+    project?: string;
+    require?: boolean;
+};
+declare function coop_workspace_dir(repoRoot: string): string;
+declare function coop_projects_dir(repoRoot: string): string;
+declare function coop_workspace_config_path(repoRoot: string): string;
+declare function coop_project_root(repoRoot: string, projectId: string): string;
+declare function coop_project_config_path(projectRoot: string): string;
+declare function repo_default_project_id(repoRoot: string): string;
+declare function repo_default_project_name(repoRoot: string): string;
+declare function has_v2_projects_layout(repoRoot: string): boolean;
+declare function has_legacy_project_layout(repoRoot: string): boolean;
+declare function read_workspace_config(repoRoot: string): CoopWorkspaceConfig;
+declare function write_workspace_config(repoRoot: string, config: CoopWorkspaceConfig): void;
+declare function read_project_config(projectRoot: string): CoopConfig;
+declare function list_projects(repoRoot: string): CoopProjectRef[];
+declare function resolve_project(repoRoot: string, options?: ResolveProjectOptions): CoopProjectRef;
+declare function ensure_workspace_layout(repoRoot: string): string;
+declare function is_project_initialized(projectRoot: string): boolean;
+
 /**
  * Finds the nearest workspace root that contains package + workspace metadata.
  * [SPEC: Architecture v2.0 §2]
@@ -1452,4 +1485,4 @@ declare function validateRepo(rootDir: string): {
     warnings: string[];
 };
 
-export { type AIAgent, type AIResource, type AgentSpec, type AllocationResult, ArtifactType, type AuthConfig, type AuthPolicy, type AutoTransitionResult, type AvailabilityWindow, type BacklogItem, type BacklogItemData, COOP_EVENT_TYPES, CURRENT_SCHEMA_VERSION, type CapacityLedger, type ComparisonResult, type ComparisonRow, type ComputeNode, type ComputeResource, type CoopConfig, type CoopEvent, CoopEventEmitter, type CoopEventType, type CreateItemParams, type CriticalPathResult, type CriticalPathTaskMetrics, DEFAULT_SCORE_WEIGHTS, type Delivery, type DeliveryAtRisk, type DeliveryBudget, type DeliveryCommitted, type DeliveryGovernance, type DeliveryRisk, type DeliveryRiskType, type DeliveryScope, DeliveryStatus, type DetectedDeliveryRisk, type EffectiveCapacity, type EventByType, type ExecutionConstraints, type ExecutionPermissions, ExecutorType, type ExternalDependencyRef, type ExternalDependencyResolution, type ExternalDependencyResolutionStatus, type ExternalDependencyResolverOptions, type ExternalRepoConfig, type FeasibilityResult, type FeasibilityRisk, type FeasibilityStatus, type FeasibilitySummary, type FilterSpec, type FrontmatterParseResult, type GraphCycleDetected, type GraphValidationContext, type GraphValidationResult, type HookRunResult, type HumanMember, type HumanResource, ITEM_STATUSES, ITEM_TYPES, type Idea, IdeaStatus, IndexManager, type IndexStatus, type ItemLinks, type ItemStatus, type ItemType, MIGRATIONS, type MigrateRepositoryOptions, type MigrationContext, type MigrationDefinition, type MigrationReport, type MonteCarloHistogramBucket, type MonteCarloOptions, type MonteCarloResult, type MonteCarloWorkerPayload, type ParsedDelivery, type ParsedIdea, type ParsedTask, type Permission, type PermissionContext, type PluginAction, type PluginActionConsole, type PluginActionGitHubPr, type PluginActionHandler, type PluginActionHandlerResult, type PluginActionWebhook, type PluginManifest, type PluginRunOptions, type PluginRunRecord, type PluginTrigger, type PolicyAction, type ReadinessComputation, type ReadinessPartitions, type ReadinessState, type ReadinessTransitionEvent, type ReadinessWarning, type ReferentialValidationContext, type RepoConfig, type RepoState, type ResourceProfile, RiskLevel, type Role, type Run, type RunCompleted, type RunFailed, type RunResourcesConsumed, type RunStarted, RunStatus, type RunStepResult, RunStepStatus, RunbookAction, type RunbookStep, type ScheduleOptions, type ScoreContext, type ScoredTask, type SemanticValidationContext, type SimulationResult, type StructuralValidationContext, type Task, type TaskAssigned, TaskComplexity, type TaskComputed, type TaskCore, type TaskCreated, TaskDeterminism, type TaskEstimate, type TaskEstimation, type TaskExecution, type TaskGovernance, type TaskGraph, type TaskPlanning, TaskPriority, type TaskResources, type TaskScheduleEntry, TaskStatus, type TaskTransitioned, type TaskTransitionedEvent, TaskType, type Track, type TrackUtilization, type TrackWip, type TransitionContext, type TransitionResult, type TransitionValidationContext, type UpdateItemParams, VALID_TASK_TRANSITIONS, VALID_TRANSITIONS, type ValidationContext, type ValidationError, type ValidationLevel, type ValidationResult, type VelocityMetrics, type VelocityPoint, type VelocityTrend, type WhatIfBaseline, type WhatIfModification, type WriteTaskOptions, allocate, allocate_ai, allocate_ai_tokens, analyze_feasibility, analyze_what_if, build_capacity_ledger, build_graph, check_blocked, check_permission, check_unblocked, check_wip, completeItem, complexity_penalty, compute_all_readiness, compute_critical_path, compute_readiness, compute_readiness_with_corrections, compute_score, compute_velocity, createItem, create_seeded_rng, critical_path_weight, deleteItem, dependency_unlock_weight, detect_cycle, detect_delivery_risks, determinism_weight, effective_weekly_hours, effort_or_default, ensureCoopLayout, executor_fit_weight, external_dependencies_for_task, extract_subgraph, findRepoRoot, find_external_dependencies, getItemById, get_remaining_tokens, get_user_role, is_external_dependency, loadState, load_auth_config, load_completed_runs, load_graph, load_plugins, migrate_repository, migrate_task, monte_carlo_forecast, parseDeliveryContent, parseDeliveryFile, parseFrontmatterContent, parseFrontmatterFile, parseIdeaContent, parseIdeaFile, parseTaskContent, parseTaskFile, parseYamlContent, parseYamlFile, parse_external_dependency, partition_by_readiness, pert_hours, pert_stddev, priority_weight, queryItems, read_schema_version, renderAgentPrompt, resolve_external_dependencies, risk_penalty, run_hook, run_monte_carlo_chunk, run_plugins_for_event, sample_pert_beta, sample_task_hours, schedule_next, simulate_schedule, stringifyFrontmatter, stringifyYamlContent, task_effort_hours, topological_sort, transition, transitive_dependencies, transitive_dependents, type_weight, updateItem, urgency_weight, validate, validateReferential, validateRepo, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version };
+export { type AIAgent, type AIResource, type AgentSpec, type AllocationResult, ArtifactType, type AuthConfig, type AuthPolicy, type AutoTransitionResult, type AvailabilityWindow, type BacklogItem, type BacklogItemData, COOP_EVENT_TYPES, CURRENT_SCHEMA_VERSION, type CapacityLedger, type ComparisonResult, type ComparisonRow, type ComputeNode, type ComputeResource, type CoopConfig, type CoopEvent, CoopEventEmitter, type CoopEventType, type CoopProjectRef, type CoopWorkspaceConfig, type CreateItemParams, type CriticalPathResult, type CriticalPathTaskMetrics, DEFAULT_SCORE_WEIGHTS, type Delivery, type DeliveryAtRisk, type DeliveryBudget, type DeliveryCommitted, type DeliveryGovernance, type DeliveryRisk, type DeliveryRiskType, type DeliveryScope, DeliveryStatus, type DetectedDeliveryRisk, type EffectiveCapacity, type EventByType, type ExecutionConstraints, type ExecutionPermissions, ExecutorType, type ExternalDependencyRef, type ExternalDependencyResolution, type ExternalDependencyResolutionStatus, type ExternalDependencyResolverOptions, type ExternalRepoConfig, type FeasibilityResult, type FeasibilityRisk, type FeasibilityStatus, type FeasibilitySummary, type FilterSpec, type FrontmatterParseResult, type GraphCycleDetected, type GraphValidationContext, type GraphValidationResult, type HookRunResult, type HumanMember, type HumanResource, ITEM_STATUSES, ITEM_TYPES, type Idea, IdeaStatus, IndexManager, type IndexStatus, type ItemLinks, type ItemStatus, type ItemType, MIGRATIONS, type MigrateRepositoryOptions, type MigrationContext, type MigrationDefinition, type MigrationReport, type MonteCarloHistogramBucket, type MonteCarloOptions, type MonteCarloResult, type MonteCarloWorkerPayload, type ParsedDelivery, type ParsedIdea, type ParsedTask, type Permission, type PermissionContext, type PluginAction, type PluginActionConsole, type PluginActionGitHubPr, type PluginActionHandler, type PluginActionHandlerResult, type PluginActionWebhook, type PluginManifest, type PluginRunOptions, type PluginRunRecord, type PluginTrigger, type PolicyAction, type ReadinessComputation, type ReadinessPartitions, type ReadinessState, type ReadinessTransitionEvent, type ReadinessWarning, type ReferentialValidationContext, type RepoConfig, type RepoState, type ResourceProfile, RiskLevel, type Role, type Run, type RunCompleted, type RunFailed, type RunResourcesConsumed, type RunStarted, RunStatus, type RunStepResult, RunStepStatus, RunbookAction, type RunbookStep, type ScheduleOptions, type ScoreContext, type ScoredTask, type SemanticValidationContext, type SimulationResult, type StructuralValidationContext, type Task, type TaskAssigned, TaskComplexity, type TaskComputed, type TaskCore, type TaskCreated, TaskDeterminism, type TaskEstimate, type TaskEstimation, type TaskExecution, type TaskGovernance, type TaskGraph, type TaskPlanning, TaskPriority, type TaskResources, type TaskScheduleEntry, TaskStatus, type TaskTransitioned, type TaskTransitionedEvent, TaskType, type Track, type TrackUtilization, type TrackWip, type TransitionContext, type TransitionResult, type TransitionValidationContext, type UpdateItemParams, VALID_TASK_TRANSITIONS, VALID_TRANSITIONS, type ValidationContext, type ValidationError, type ValidationLevel, type ValidationResult, type VelocityMetrics, type VelocityPoint, type VelocityTrend, type WhatIfBaseline, type WhatIfModification, type WriteTaskOptions, allocate, allocate_ai, allocate_ai_tokens, analyze_feasibility, analyze_what_if, build_capacity_ledger, build_graph, check_blocked, check_permission, check_unblocked, check_wip, completeItem, complexity_penalty, compute_all_readiness, compute_critical_path, compute_readiness, compute_readiness_with_corrections, compute_score, compute_velocity, coop_project_config_path, coop_project_root, coop_projects_dir, coop_workspace_config_path, coop_workspace_dir, createItem, create_seeded_rng, critical_path_weight, deleteItem, dependency_unlock_weight, detect_cycle, detect_delivery_risks, determinism_weight, effective_weekly_hours, effort_or_default, ensureCoopLayout, ensure_workspace_layout, executor_fit_weight, external_dependencies_for_task, extract_subgraph, findRepoRoot, find_external_dependencies, getItemById, get_remaining_tokens, get_user_role, has_legacy_project_layout, has_v2_projects_layout, is_external_dependency, is_project_initialized, list_projects, loadState, load_auth_config, load_completed_runs, load_graph, load_plugins, migrate_repository, migrate_task, monte_carlo_forecast, parseDeliveryContent, parseDeliveryFile, parseFrontmatterContent, parseFrontmatterFile, parseIdeaContent, parseIdeaFile, parseTaskContent, parseTaskFile, parseYamlContent, parseYamlFile, parse_external_dependency, partition_by_readiness, pert_hours, pert_stddev, priority_weight, queryItems, read_project_config, read_schema_version, read_workspace_config, renderAgentPrompt, repo_default_project_id, repo_default_project_name, resolve_external_dependencies, resolve_project, risk_penalty, run_hook, run_monte_carlo_chunk, run_plugins_for_event, sample_pert_beta, sample_task_hours, schedule_next, simulate_schedule, stringifyFrontmatter, stringifyYamlContent, task_effort_hours, topological_sort, transition, transitive_dependencies, transitive_dependents, type_weight, updateItem, urgency_weight, validate, validateReferential, validateRepo, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version, write_workspace_config };

package/dist/index.d.ts

@@ -1386,6 +1386,39 @@ interface ValidationResult {
 }
 declare function validate(task: Task, context?: ValidationContext): ValidationResult;
 
+type CoopWorkspaceConfig = {
+    version?: number;
+    current_project?: string;
+};
+type CoopProjectRef = {
+    id: string;
+    name: string;
+    aliases: string[];
+    root: string;
+    repo_root: string;
+    layout: "legacy" | "v2";
+};
+type ResolveProjectOptions = {
+    project?: string;
+    require?: boolean;
+};
+declare function coop_workspace_dir(repoRoot: string): string;
+declare function coop_projects_dir(repoRoot: string): string;
+declare function coop_workspace_config_path(repoRoot: string): string;
+declare function coop_project_root(repoRoot: string, projectId: string): string;
+declare function coop_project_config_path(projectRoot: string): string;
+declare function repo_default_project_id(repoRoot: string): string;
+declare function repo_default_project_name(repoRoot: string): string;
+declare function has_v2_projects_layout(repoRoot: string): boolean;
+declare function has_legacy_project_layout(repoRoot: string): boolean;
+declare function read_workspace_config(repoRoot: string): CoopWorkspaceConfig;
+declare function write_workspace_config(repoRoot: string, config: CoopWorkspaceConfig): void;
+declare function read_project_config(projectRoot: string): CoopConfig;
+declare function list_projects(repoRoot: string): CoopProjectRef[];
+declare function resolve_project(repoRoot: string, options?: ResolveProjectOptions): CoopProjectRef;
+declare function ensure_workspace_layout(repoRoot: string): string;
+declare function is_project_initialized(projectRoot: string): boolean;
+
 /**
  * Finds the nearest workspace root that contains package + workspace metadata.
  * [SPEC: Architecture v2.0 §2]
@@ -1452,4 +1485,4 @@ declare function validateRepo(rootDir: string): {
     warnings: string[];
 };
 
-export { type AIAgent, type AIResource, type AgentSpec, type AllocationResult, ArtifactType, type AuthConfig, type AuthPolicy, type AutoTransitionResult, type AvailabilityWindow, type BacklogItem, type BacklogItemData, COOP_EVENT_TYPES, CURRENT_SCHEMA_VERSION, type CapacityLedger, type ComparisonResult, type ComparisonRow, type ComputeNode, type ComputeResource, type CoopConfig, type CoopEvent, CoopEventEmitter, type CoopEventType, type CreateItemParams, type CriticalPathResult, type CriticalPathTaskMetrics, DEFAULT_SCORE_WEIGHTS, type Delivery, type DeliveryAtRisk, type DeliveryBudget, type DeliveryCommitted, type DeliveryGovernance, type DeliveryRisk, type DeliveryRiskType, type DeliveryScope, DeliveryStatus, type DetectedDeliveryRisk, type EffectiveCapacity, type EventByType, type ExecutionConstraints, type ExecutionPermissions, ExecutorType, type ExternalDependencyRef, type ExternalDependencyResolution, type ExternalDependencyResolutionStatus, type ExternalDependencyResolverOptions, type ExternalRepoConfig, type FeasibilityResult, type FeasibilityRisk, type FeasibilityStatus, type FeasibilitySummary, type FilterSpec, type FrontmatterParseResult, type GraphCycleDetected, type GraphValidationContext, type GraphValidationResult, type HookRunResult, type HumanMember, type HumanResource, ITEM_STATUSES, ITEM_TYPES, type Idea, IdeaStatus, IndexManager, type IndexStatus, type ItemLinks, type ItemStatus, type ItemType, MIGRATIONS, type MigrateRepositoryOptions, type MigrationContext, type MigrationDefinition, type MigrationReport, type MonteCarloHistogramBucket, type MonteCarloOptions, type MonteCarloResult, type MonteCarloWorkerPayload, type ParsedDelivery, type ParsedIdea, type ParsedTask, type Permission, type PermissionContext, type PluginAction, type PluginActionConsole, type PluginActionGitHubPr, type PluginActionHandler, type PluginActionHandlerResult, type PluginActionWebhook, type PluginManifest, type PluginRunOptions, type PluginRunRecord, type PluginTrigger, type PolicyAction, type ReadinessComputation, type ReadinessPartitions, type ReadinessState, type ReadinessTransitionEvent, type ReadinessWarning, type ReferentialValidationContext, type RepoConfig, type RepoState, type ResourceProfile, RiskLevel, type Role, type Run, type RunCompleted, type RunFailed, type RunResourcesConsumed, type RunStarted, RunStatus, type RunStepResult, RunStepStatus, RunbookAction, type RunbookStep, type ScheduleOptions, type ScoreContext, type ScoredTask, type SemanticValidationContext, type SimulationResult, type StructuralValidationContext, type Task, type TaskAssigned, TaskComplexity, type TaskComputed, type TaskCore, type TaskCreated, TaskDeterminism, type TaskEstimate, type TaskEstimation, type TaskExecution, type TaskGovernance, type TaskGraph, type TaskPlanning, TaskPriority, type TaskResources, type TaskScheduleEntry, TaskStatus, type TaskTransitioned, type TaskTransitionedEvent, TaskType, type Track, type TrackUtilization, type TrackWip, type TransitionContext, type TransitionResult, type TransitionValidationContext, type UpdateItemParams, VALID_TASK_TRANSITIONS, VALID_TRANSITIONS, type ValidationContext, type ValidationError, type ValidationLevel, type ValidationResult, type VelocityMetrics, type VelocityPoint, type VelocityTrend, type WhatIfBaseline, type WhatIfModification, type WriteTaskOptions, allocate, allocate_ai, allocate_ai_tokens, analyze_feasibility, analyze_what_if, build_capacity_ledger, build_graph, check_blocked, check_permission, check_unblocked, check_wip, completeItem, complexity_penalty, compute_all_readiness, compute_critical_path, compute_readiness, compute_readiness_with_corrections, compute_score, compute_velocity, createItem, create_seeded_rng, critical_path_weight, deleteItem, dependency_unlock_weight, detect_cycle, detect_delivery_risks, determinism_weight, effective_weekly_hours, effort_or_default, ensureCoopLayout, executor_fit_weight, external_dependencies_for_task, extract_subgraph, findRepoRoot, find_external_dependencies, getItemById, get_remaining_tokens, get_user_role, is_external_dependency, loadState, load_auth_config, load_completed_runs, load_graph, load_plugins, migrate_repository, migrate_task, monte_carlo_forecast, parseDeliveryContent, parseDeliveryFile, parseFrontmatterContent, parseFrontmatterFile, parseIdeaContent, parseIdeaFile, parseTaskContent, parseTaskFile, parseYamlContent, parseYamlFile, parse_external_dependency, partition_by_readiness, pert_hours, pert_stddev, priority_weight, queryItems, read_schema_version, renderAgentPrompt, resolve_external_dependencies, risk_penalty, run_hook, run_monte_carlo_chunk, run_plugins_for_event, sample_pert_beta, sample_task_hours, schedule_next, simulate_schedule, stringifyFrontmatter, stringifyYamlContent, task_effort_hours, topological_sort, transition, transitive_dependencies, transitive_dependents, type_weight, updateItem, urgency_weight, validate, validateReferential, validateRepo, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version };
+export { type AIAgent, type AIResource, type AgentSpec, type AllocationResult, ArtifactType, type AuthConfig, type AuthPolicy, type AutoTransitionResult, type AvailabilityWindow, type BacklogItem, type BacklogItemData, COOP_EVENT_TYPES, CURRENT_SCHEMA_VERSION, type CapacityLedger, type ComparisonResult, type ComparisonRow, type ComputeNode, type ComputeResource, type CoopConfig, type CoopEvent, CoopEventEmitter, type CoopEventType, type CoopProjectRef, type CoopWorkspaceConfig, type CreateItemParams, type CriticalPathResult, type CriticalPathTaskMetrics, DEFAULT_SCORE_WEIGHTS, type Delivery, type DeliveryAtRisk, type DeliveryBudget, type DeliveryCommitted, type DeliveryGovernance, type DeliveryRisk, type DeliveryRiskType, type DeliveryScope, DeliveryStatus, type DetectedDeliveryRisk, type EffectiveCapacity, type EventByType, type ExecutionConstraints, type ExecutionPermissions, ExecutorType, type ExternalDependencyRef, type ExternalDependencyResolution, type ExternalDependencyResolutionStatus, type ExternalDependencyResolverOptions, type ExternalRepoConfig, type FeasibilityResult, type FeasibilityRisk, type FeasibilityStatus, type FeasibilitySummary, type FilterSpec, type FrontmatterParseResult, type GraphCycleDetected, type GraphValidationContext, type GraphValidationResult, type HookRunResult, type HumanMember, type HumanResource, ITEM_STATUSES, ITEM_TYPES, type Idea, IdeaStatus, IndexManager, type IndexStatus, type ItemLinks, type ItemStatus, type ItemType, MIGRATIONS, type MigrateRepositoryOptions, type MigrationContext, type MigrationDefinition, type MigrationReport, type MonteCarloHistogramBucket, type MonteCarloOptions, type MonteCarloResult, type MonteCarloWorkerPayload, type ParsedDelivery, type ParsedIdea, type ParsedTask, type Permission, type PermissionContext, type PluginAction, type PluginActionConsole, type PluginActionGitHubPr, type PluginActionHandler, type PluginActionHandlerResult, type PluginActionWebhook, type PluginManifest, type PluginRunOptions, type PluginRunRecord, type PluginTrigger, type PolicyAction, type ReadinessComputation, type ReadinessPartitions, type ReadinessState, type ReadinessTransitionEvent, type ReadinessWarning, type ReferentialValidationContext, type RepoConfig, type RepoState, type ResourceProfile, RiskLevel, type Role, type Run, type RunCompleted, type RunFailed, type RunResourcesConsumed, type RunStarted, RunStatus, type RunStepResult, RunStepStatus, RunbookAction, type RunbookStep, type ScheduleOptions, type ScoreContext, type ScoredTask, type SemanticValidationContext, type SimulationResult, type StructuralValidationContext, type Task, type TaskAssigned, TaskComplexity, type TaskComputed, type TaskCore, type TaskCreated, TaskDeterminism, type TaskEstimate, type TaskEstimation, type TaskExecution, type TaskGovernance, type TaskGraph, type TaskPlanning, TaskPriority, type TaskResources, type TaskScheduleEntry, TaskStatus, type TaskTransitioned, type TaskTransitionedEvent, TaskType, type Track, type TrackUtilization, type TrackWip, type TransitionContext, type TransitionResult, type TransitionValidationContext, type UpdateItemParams, VALID_TASK_TRANSITIONS, VALID_TRANSITIONS, type ValidationContext, type ValidationError, type ValidationLevel, type ValidationResult, type VelocityMetrics, type VelocityPoint, type VelocityTrend, type WhatIfBaseline, type WhatIfModification, type WriteTaskOptions, allocate, allocate_ai, allocate_ai_tokens, analyze_feasibility, analyze_what_if, build_capacity_ledger, build_graph, check_blocked, check_permission, check_unblocked, check_wip, completeItem, complexity_penalty, compute_all_readiness, compute_critical_path, compute_readiness, compute_readiness_with_corrections, compute_score, compute_velocity, coop_project_config_path, coop_project_root, coop_projects_dir, coop_workspace_config_path, coop_workspace_dir, createItem, create_seeded_rng, critical_path_weight, deleteItem, dependency_unlock_weight, detect_cycle, detect_delivery_risks, determinism_weight, effective_weekly_hours, effort_or_default, ensureCoopLayout, ensure_workspace_layout, executor_fit_weight, external_dependencies_for_task, extract_subgraph, findRepoRoot, find_external_dependencies, getItemById, get_remaining_tokens, get_user_role, has_legacy_project_layout, has_v2_projects_layout, is_external_dependency, is_project_initialized, list_projects, loadState, load_auth_config, load_completed_runs, load_graph, load_plugins, migrate_repository, migrate_task, monte_carlo_forecast, parseDeliveryContent, parseDeliveryFile, parseFrontmatterContent, parseFrontmatterFile, parseIdeaContent, parseIdeaFile, parseTaskContent, parseTaskFile, parseYamlContent, parseYamlFile, parse_external_dependency, partition_by_readiness, pert_hours, pert_stddev, priority_weight, queryItems, read_project_config, read_schema_version, read_workspace_config, renderAgentPrompt, repo_default_project_id, repo_default_project_name, resolve_external_dependencies, resolve_project, risk_penalty, run_hook, run_monte_carlo_chunk, run_plugins_for_event, sample_pert_beta, sample_task_hours, schedule_next, simulate_schedule, stringifyFrontmatter, stringifyYamlContent, task_effort_hours, topological_sort, transition, transitive_dependencies, transitive_dependents, type_weight, updateItem, urgency_weight, validate, validateReferential, validateRepo, validateSemantic, validateStructural, validateTransition, validate_graph, validate_transition, writeTask, writeYamlFile, write_schema_version, write_workspace_config };

package/dist/index.js

@@ -3791,9 +3791,131 @@ function validate(task, context = {}) {
   };
 }
 
-// src/core.ts
+// src/workspace.ts
 import fs13 from "fs";
 import path9 from "path";
+var COOP_DIR_NAME = ".coop";
+function sanitizeProjectId(value, fallback) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-+/g, "-");
+  return normalized || fallback;
+}
+function coop_workspace_dir(repoRoot) {
+  return path9.join(path9.resolve(repoRoot), COOP_DIR_NAME);
+}
+function coop_projects_dir(repoRoot) {
+  return path9.join(coop_workspace_dir(repoRoot), "projects");
+}
+function coop_workspace_config_path(repoRoot) {
+  return path9.join(coop_workspace_dir(repoRoot), "config.yml");
+}
+function coop_project_root(repoRoot, projectId) {
+  return path9.join(coop_projects_dir(repoRoot), projectId);
+}
+function coop_project_config_path(projectRoot) {
+  return path9.join(projectRoot, "config.yml");
+}
+function repo_default_project_id(repoRoot) {
+  return sanitizeProjectId(path9.basename(path9.resolve(repoRoot)), "workspace");
+}
+function repo_default_project_name(repoRoot) {
+  const base = path9.basename(path9.resolve(repoRoot)).trim();
+  return base || "COOP Workspace";
+}
+function has_v2_projects_layout(repoRoot) {
+  return fs13.existsSync(coop_projects_dir(repoRoot));
+}
+function has_legacy_project_layout(repoRoot) {
+  const workspaceDir = coop_workspace_dir(repoRoot);
+  return fs13.existsSync(workspaceDir) && fs13.existsSync(path9.join(workspaceDir, "config.yml")) && !fs13.existsSync(coop_projects_dir(repoRoot));
+}
+function read_workspace_config(repoRoot) {
+  const configPath = coop_workspace_config_path(repoRoot);
+  if (!fs13.existsSync(configPath) || has_legacy_project_layout(repoRoot)) {
+    return { version: 2 };
+  }
+  return parseYamlFile(configPath);
+}
+function write_workspace_config(repoRoot, config) {
+  fs13.mkdirSync(coop_workspace_dir(repoRoot), { recursive: true });
+  writeYamlFile(coop_workspace_config_path(repoRoot), {
+    version: config.version ?? 2,
+    ...config.current_project ? { current_project: config.current_project } : {}
+  });
+}
+function read_project_config(projectRoot) {
+  return parseYamlFile(coop_project_config_path(projectRoot));
+}
+function project_ref_from_config(repoRoot, projectRoot, layout) {
+  const config = read_project_config(projectRoot);
+  const repoName = repo_default_project_name(repoRoot);
+  const fallbackId = repo_default_project_id(repoRoot);
+  return {
+    id: sanitizeProjectId(config.project?.id ?? fallbackId, fallbackId),
+    name: config.project?.name?.trim() || repoName,
+    aliases: Array.isArray(config.project?.aliases) ? config.project.aliases.filter((entry) => typeof entry === "string" && entry.trim().length > 0) : [],
+    root: projectRoot,
+    repo_root: path9.resolve(repoRoot),
+    layout
+  };
+}
+function list_projects(repoRoot) {
+  if (has_v2_projects_layout(repoRoot)) {
+    const projectsDir = coop_projects_dir(repoRoot);
+    return fs13.readdirSync(projectsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => path9.join(projectsDir, entry.name)).filter((projectRoot) => fs13.existsSync(coop_project_config_path(projectRoot))).map((projectRoot) => project_ref_from_config(repoRoot, projectRoot, "v2")).sort((a, b) => a.id.localeCompare(b.id));
+  }
+  if (has_legacy_project_layout(repoRoot)) {
+    return [project_ref_from_config(repoRoot, coop_workspace_dir(repoRoot), "legacy")];
+  }
+  return [];
+}
+function resolve_project(repoRoot, options = {}) {
+  const projects = list_projects(repoRoot);
+  const requested = options.project?.trim().toLowerCase();
+  if (requested) {
+    const match = projects.find(
+      (project) => project.id.toLowerCase() === requested || project.name.toLowerCase() === requested || project.aliases.some((alias) => alias.toLowerCase() === requested)
+    );
+    if (!match) {
+      throw new Error(`Project '${options.project}' not found.`);
+    }
+    return match;
+  }
+  if (projects.length === 1) {
+    return projects[0];
+  }
+  const workspaceConfig = read_workspace_config(repoRoot);
+  if (workspaceConfig.current_project) {
+    const match = projects.find((project) => project.id === workspaceConfig.current_project);
+    if (match) return match;
+  }
+  if (!options.require && projects.length === 0) {
+    return {
+      id: repo_default_project_id(repoRoot),
+      name: repo_default_project_name(repoRoot),
+      aliases: [],
+      root: coop_project_root(repoRoot, repo_default_project_id(repoRoot)),
+      repo_root: path9.resolve(repoRoot),
+      layout: "v2"
+    };
+  }
+  if (projects.length === 0) {
+    throw new Error("No COOP project found. Run 'coop init'.");
+  }
+  throw new Error("Multiple COOP projects found. Pass --project <id> or run 'coop project use <id>'.");
+}
+function ensure_workspace_layout(repoRoot) {
+  const workspaceDir = coop_workspace_dir(repoRoot);
+  fs13.mkdirSync(workspaceDir, { recursive: true });
+  fs13.mkdirSync(coop_projects_dir(repoRoot), { recursive: true });
+  return workspaceDir;
+}
+function is_project_initialized(projectRoot) {
+  return fs13.existsSync(coop_project_config_path(projectRoot));
+}
+
+// src/core.ts
+import fs14 from "fs";
+import path10 from "path";
 import matter from "gray-matter";
 
 // src/types.ts
@@ -3819,17 +3941,17 @@ function toIdKey(value) {
   return value.trim().toUpperCase();
 }
 function repoRootByPackage(cwd) {
-  let current = path9.resolve(cwd);
+  let current = path10.resolve(cwd);
   let lastWorkspaceRoot = null;
   while (true) {
-    const packageJson = path9.join(current, "package.json");
-    const workspaceYaml = path9.join(current, "pnpm-workspace.yaml");
-    if (fs13.existsSync(packageJson) && fs13.existsSync(workspaceYaml)) {
+    const packageJson = path10.join(current, "package.json");
+    const workspaceYaml = path10.join(current, "pnpm-workspace.yaml");
+    if (fs14.existsSync(packageJson) && fs14.existsSync(workspaceYaml)) {
       lastWorkspaceRoot = current;
-      const hasCoop = fs13.existsSync(path9.join(current, COOP_DIR, "config.yml"));
+      const hasCoop = fs14.existsSync(path10.join(current, COOP_DIR, "config.yml"));
       if (hasCoop) return current;
     }
-    const parent = path9.dirname(current);
+    const parent = path10.dirname(current);
     if (parent === current) return lastWorkspaceRoot;
     current = parent;
   }
@@ -3838,24 +3960,24 @@ function findRepoRoot(cwd = process.cwd()) {
   return repoRootByPackage(cwd);
 }
 function configPathFor(rootDir, workspaceDir) {
-  return path9.join(rootDir, workspaceDir, "config.yml");
+  return path10.join(rootDir, workspaceDir, "config.yml");
 }
 function backlogPathFor(rootDir, workspaceDir) {
-  return path9.join(rootDir, workspaceDir, "backlog");
+  return path10.join(rootDir, workspaceDir, "backlog");
 }
 function releasesPathFor(rootDir, workspaceDir) {
-  return path9.join(rootDir, workspaceDir, "releases");
+  return path10.join(rootDir, workspaceDir, "releases");
 }
 function detectWorkspaceDir(rootDir) {
-  if (fs13.existsSync(configPathFor(rootDir, COOP_DIR))) return COOP_DIR;
-  if (fs13.existsSync(path9.join(rootDir, COOP_DIR))) return COOP_DIR;
+  if (fs14.existsSync(configPathFor(rootDir, COOP_DIR))) return COOP_DIR;
+  if (fs14.existsSync(path10.join(rootDir, COOP_DIR))) return COOP_DIR;
   return null;
 }
 function preferredWorkspaceDir(rootDir) {
   return detectWorkspaceDir(rootDir) ?? COOP_DIR;
 }
 function missingConfigError(rootDir) {
-  const coopConfig = path9.relative(rootDir, configPathFor(rootDir, COOP_DIR));
+  const coopConfig = path10.relative(rootDir, configPathFor(rootDir, COOP_DIR));
   return new Error(`COOP config missing at ${coopConfig}. Run: coop init`);
 }
 function parseConfig(raw) {
@@ -3901,10 +4023,10 @@ function configToString(config) {
   return lines.join("\n");
 }
 function toPortablePath(value) {
-  return value.split(path9.sep).join("/");
+  return value.split(path10.sep).join("/");
 }
 function ensureReleasesDir(rootDir, workspaceDir) {
-  fs13.mkdirSync(releasesPathFor(rootDir, workspaceDir), { recursive: true });
+  fs14.mkdirSync(releasesPathFor(rootDir, workspaceDir), { recursive: true });
 }
 function releaseHeader(date) {
   return `## ${date}`;
@@ -3926,12 +4048,12 @@ function appendReleaseEntry(rootDir, workspaceDir, item, previousStatus, nextSta
   ensureReleasesDir(rootDir, workspaceDir);
   const now = /* @__PURE__ */ new Date();
   const date = now.toISOString().slice(0, 10);
-  const releasePath = path9.join(releasesPathFor(rootDir, workspaceDir), `${date}.md`);
+  const releasePath = path10.join(releasesPathFor(rootDir, workspaceDir), `${date}.md`);
   const heading = "# COOP Release Notes";
   const dayHeader = releaseHeader(date);
   const entry = releaseEntryLine(item, previousStatus, nextStatus);
-  if (!fs13.existsSync(releasePath)) {
-    fs13.writeFileSync(
+  if (!fs14.existsSync(releasePath)) {
+    fs14.writeFileSync(
       releasePath,
       [
         `${heading}
@@ -3944,10 +4066,10 @@ function appendReleaseEntry(rootDir, workspaceDir, item, previousStatus, nextSta
       ].join("\n"),
       "utf8"
     );
-    return toPortablePath(path9.relative(rootDir, releasePath));
+    return toPortablePath(path10.relative(rootDir, releasePath));
   }
-  const existing = fs13.readFileSync(releasePath, "utf8");
-  if (hasReleaseEntry(existing, item.id)) return toPortablePath(path9.relative(rootDir, releasePath));
+  const existing = fs14.readFileSync(releasePath, "utf8");
+  if (hasReleaseEntry(existing, item.id)) return toPortablePath(path10.relative(rootDir, releasePath));
   let nextContent = existing;
   if (!existing.includes(`## ${date}`)) {
     if (!nextContent.endsWith("\n")) nextContent += "\n";
@@ -3957,9 +4079,9 @@ function appendReleaseEntry(rootDir, workspaceDir, item, previousStatus, nextSta
   if (!nextContent.endsWith("\n")) nextContent += "\n";
   nextContent += `${entry}
 `;
-  fs13.writeFileSync(releasePath, `${nextContent}
+  fs14.writeFileSync(releasePath, `${nextContent}
 `, "utf8");
-  return toPortablePath(path9.relative(rootDir, releasePath));
+  return toPortablePath(path10.relative(rootDir, releasePath));
 }
 function completeItem(rootDir, id) {
   const state = loadState(rootDir);
@@ -4037,28 +4159,28 @@ function validateAndNormalize(data, sourceFile) {
   };
 }
 function parseItem(filePath, rootDir) {
-  const raw = fs13.readFileSync(filePath, "utf8");
+  const raw = fs14.readFileSync(filePath, "utf8");
   const parsed = matter(raw);
-  const data = validateAndNormalize(parsed.data, path9.relative(rootDir, filePath));
+  const data = validateAndNormalize(parsed.data, path10.relative(rootDir, filePath));
   return {
     ...data,
     body: parsed.content || "",
-    filePath: path9.relative(rootDir, filePath)
+    filePath: path10.relative(rootDir, filePath)
   };
 }
 function walk(dir) {
   const out = [];
-  if (!fs13.existsSync(dir)) return out;
-  const entries = fs13.readdirSync(dir, { withFileTypes: true });
+  if (!fs14.existsSync(dir)) return out;
+  const entries = fs14.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const file = path9.join(dir, entry.name);
+    const file = path10.join(dir, entry.name);
     if (entry.isDirectory()) out.push(...walk(file));
     if (entry.isFile() && file.endsWith(".md")) out.push(file);
   }
   return out;
 }
 function itemPath(type, id, rootDir, workspaceDir) {
-  return path9.join(backlogPathFor(rootDir, workspaceDir), ITEM_DIRS[type], `${id}.md`);
+  return path10.join(backlogPathFor(rootDir, workspaceDir), ITEM_DIRS[type], `${id}.md`);
 }
 function normalizeFrontmatterValue(value) {
   if (value == null) return void 0;
@@ -4145,30 +4267,30 @@ function nextGeneratedId(config, title, existing) {
 }
 function ensureCoopLayout(rootDir) {
   const workspaceDir = preferredWorkspaceDir(rootDir);
-  const root = path9.join(rootDir, workspaceDir);
-  fs13.mkdirSync(root, { recursive: true });
-  fs13.mkdirSync(path9.join(root, "releases"), { recursive: true });
-  fs13.mkdirSync(path9.join(root, "plans"), { recursive: true });
-  fs13.mkdirSync(path9.join(root, "views"), { recursive: true });
-  fs13.mkdirSync(path9.join(root, "templates"), { recursive: true });
+  const root = path10.join(rootDir, workspaceDir);
+  fs14.mkdirSync(root, { recursive: true });
+  fs14.mkdirSync(path10.join(root, "releases"), { recursive: true });
+  fs14.mkdirSync(path10.join(root, "plans"), { recursive: true });
+  fs14.mkdirSync(path10.join(root, "views"), { recursive: true });
+  fs14.mkdirSync(path10.join(root, "templates"), { recursive: true });
   for (const dir of Object.values(ITEM_DIRS)) {
-    fs13.mkdirSync(path9.join(root, "backlog", dir), { recursive: true });
+    fs14.mkdirSync(path10.join(root, "backlog", dir), { recursive: true });
   }
-  const configFile = path9.join(root, "config.yml");
-  if (!fs13.existsSync(configFile)) {
-    fs13.writeFileSync(configFile, configToString(DEFAULT_CONFIG2), "utf8");
+  const configFile = path10.join(root, "config.yml");
+  if (!fs14.existsSync(configFile)) {
+    fs14.writeFileSync(configFile, configToString(DEFAULT_CONFIG2), "utf8");
   }
 }
 function loadState(rootDir) {
   const workspaceDir = detectWorkspaceDir(rootDir);
   if (!workspaceDir) throw missingConfigError(rootDir);
   const configPath = configPathFor(rootDir, workspaceDir);
-  if (!fs13.existsSync(configPath)) throw missingConfigError(rootDir);
-  const config = parseConfig(fs13.readFileSync(configPath, "utf8"));
+  if (!fs14.existsSync(configPath)) throw missingConfigError(rootDir);
+  const config = parseConfig(fs14.readFileSync(configPath, "utf8"));
   const items = [];
   const itemsById = /* @__PURE__ */ new Map();
   for (const type of ITEM_TYPES) {
-    const dir = path9.join(backlogPathFor(rootDir, workspaceDir), ITEM_DIRS[type]);
+    const dir = path10.join(backlogPathFor(rootDir, workspaceDir), ITEM_DIRS[type]);
     const files = walk(dir);
     for (const file of files) {
       const item = parseItem(file, rootDir);
@@ -4252,21 +4374,21 @@ function createItem(rootDir, params) {
     parent_id: params.parent_id
   };
   const itemPathName = itemPath(params.type, item.id, rootDir, state.workspaceDir);
-  fs13.writeFileSync(itemPathName, serialize(item, params.body || ""), "utf8");
+  fs14.writeFileSync(itemPathName, serialize(item, params.body || ""), "utf8");
   if ((config.id_strategy ?? "text") === "counter") {
     const numericMatch = /-(\d+)$/.exec(item.id);
     if (numericMatch) {
       const numericValue = Number(numericMatch[1]);
       if (Number.isInteger(numericValue) && numericValue >= (config.next_id ?? 1)) {
         config.next_id = numericValue + 1;
-        fs13.writeFileSync(configPathFor(rootDir, state.workspaceDir), configToString(config), "utf8");
+        fs14.writeFileSync(configPathFor(rootDir, state.workspaceDir), configToString(config), "utf8");
       }
     }
   }
   return {
     ...item,
     body: params.body || "",
-    filePath: path9.relative(rootDir, itemPathName)
+    filePath: path10.relative(rootDir, itemPathName)
   };
 }
 function updateItem(rootDir, id, patch) {
@@ -4292,8 +4414,8 @@ function updateItem(rootDir, id, patch) {
   };
   if (!ITEM_TYPES.includes(next.type)) throw new Error(`Unknown type ${next.type}.`);
   if (!ITEM_STATUSES.includes(next.status)) throw new Error(`Unknown status ${next.status}.`);
-  const filePath = path9.join(rootDir, existing.filePath);
-  fs13.writeFileSync(filePath, serialize(next, patch.body || existing.body), "utf8");
+  const filePath = path10.join(rootDir, existing.filePath);
+  fs14.writeFileSync(filePath, serialize(next, patch.body || existing.body), "utf8");
   return {
     ...next,
     body: patch.body || existing.body,
@@ -4309,7 +4431,7 @@ function deleteItem(rootDir, id) {
   if (children.length > 0) {
     throw new Error(`Cannot delete ${existing.id} because it has ${children.length} child item(s). Remove children first.`);
   }
-  fs13.unlinkSync(path9.join(rootDir, existing.filePath));
+  fs14.unlinkSync(path10.join(rootDir, existing.filePath));
   return existing;
 }
 function renderAgentPrompt(item) {
@@ -4348,8 +4470,8 @@ function validateRepo(rootDir) {
   const errors = [];
   const warnings = [];
   const workspaceDir = detectWorkspaceDir(rootDir);
-  if (!workspaceDir || !fs13.existsSync(configPathFor(rootDir, workspaceDir))) {
-    errors.push("Missing .coop/config.yml. Run coop init first.");
+  if (!workspaceDir || !fs14.existsSync(configPathFor(rootDir, workspaceDir))) {
+    errors.push("Missing COOP config. Run coop init first.");
     return { valid: false, errors, warnings };
   }
   let state;
@@ -4422,6 +4544,11 @@ export {
   compute_readiness_with_corrections,
   compute_score,
   compute_velocity,
+  coop_project_config_path,
+  coop_project_root,
+  coop_projects_dir,
+  coop_workspace_config_path,
+  coop_workspace_dir,
   createItem,
   create_seeded_rng,
   critical_path_weight,
@@ -4433,6 +4560,7 @@ export {
   effective_weekly_hours,
   effort_or_default,
   ensureCoopLayout,
+  ensure_workspace_layout,
   executor_fit_weight,
   external_dependencies_for_task,
   extract_subgraph,
@@ -4441,7 +4569,11 @@ export {
   getItemById,
   get_remaining_tokens,
   get_user_role,
+  has_legacy_project_layout,
+  has_v2_projects_layout,
   is_external_dependency,
+  is_project_initialized,
+  list_projects,
   loadState,
   load_auth_config,
   load_completed_runs,
@@ -4466,9 +4598,14 @@ export {
   pert_stddev,
   priority_weight,
   queryItems,
+  read_project_config,
   read_schema_version,
+  read_workspace_config,
   renderAgentPrompt,
+  repo_default_project_id,
+  repo_default_project_name,
   resolve_external_dependencies,
+  resolve_project,
   risk_penalty,
   run_hook,
   run_monte_carlo_chunk,
@@ -4497,5 +4634,6 @@ export {
   validate_transition,
   writeTask,
   writeYamlFile,
-  write_schema_version
+  write_schema_version,
+  write_workspace_config
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kitsy/coop-core",
   "description": "Core models, parser, validator, graph, and planning engine for COOP.",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "license": "MIT",
   "type": "module",
   "publishConfig": {