@basou/cli 0.33.0 → 0.35.0

package/dist/index.js

@@ -3616,11 +3616,104 @@ async function assertWorkspaceInitialized7(basouRoot) {
   }
 }
 
+// src/commands/portfolio.ts
+import { existsSync, statSync } from "fs";
+import { join as join9 } from "path";
+function registerPortfolioCommand(program2) {
+  program2.command("portfolio").description(
+    "List the workspaces you orient across (read-only): every planning master registered in ~/.basou/portfolio.yaml, with its path and whether it exists / is initialized. The headless text/JSON counterpart to the `basou view --portfolio` GUI \u2014 for discovering where a sibling project lives without opening a browser"
+  ).argument("[action]", "optional literal `list` (the only, and default, action)").option("--json", "Output the result as JSON").option(
+    "--check",
+    "moved: the redundancy/footprint safety preflight is `basou view --portfolio --check` (this prints that pointer and exits)"
+  ).option("-v, --verbose", "Show error causes").action(async (action, opts) => {
+    await runPortfolioCommand(action, opts);
+  });
+}
+function isDirectory(path) {
+  try {
+    return statSync(path).isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function runPortfolioCommand(action, options, ctx = {}) {
+  if (options.check === true) {
+    console.error(
+      "`basou portfolio` is a read-only listing; it has no safety preflight.\nRun `basou view --portfolio --check` for the redundancy/footprint check."
+    );
+    process.exitCode = 1;
+    return;
+  }
+  if (action !== void 0 && action !== "list") {
+    console.error(
+      `Unknown portfolio action '${action}'. Run \`basou portfolio\` or \`basou portfolio list\` to list the registered workspaces.`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  await runPortfolioList(options, ctx);
+}
+async function runPortfolioList(options, ctx = {}) {
+  try {
+    await doRunPortfolioList(options, ctx);
+  } catch (error) {
+    renderCliError(error, { verbose: isVerbose(options) });
+    process.exitCode = 1;
+  }
+}
+async function doRunPortfolioList(options, ctx) {
+  const configPath = ctx.configPath ?? DEFAULT_PORTFOLIO_CONFIG_PATH;
+  const pathExists2 = ctx.pathExists ?? ((p) => existsSync(p));
+  const isInitialized = ctx.isInitialized ?? ((p) => isDirectory(join9(p, ".basou")));
+  const workspaces = await loadPortfolioConfig(configPath);
+  const result = {
+    configPath,
+    workspaces: workspaces.map((w) => {
+      const exists = pathExists2(w.path);
+      return {
+        label: w.label ?? null,
+        path: w.path,
+        exists,
+        initialized: exists && isInitialized(w.path)
+      };
+    })
+  };
+  if (options.json === true) {
+    console.log(JSON.stringify(result));
+  } else {
+    console.log(renderPortfolioList(result));
+  }
+  return result;
+}
+var LABEL_COLUMN_CAP = 24;
+function renderPortfolioList(result) {
+  const lines = [];
+  const n = result.workspaces.length;
+  lines.push("# Portfolio (workspaces you orient across)");
+  lines.push("");
+  lines.push(`${n} workspace${n === 1 ? "" : "s"} registered in ~/.basou/portfolio.yaml:`);
+  lines.push("");
+  const labelWidth = Math.min(
+    LABEL_COLUMN_CAP,
+    Math.max(0, ...result.workspaces.map((w) => (w.label ?? "(no label)").length))
+  );
+  for (const w of result.workspaces) {
+    const label = (w.label ?? "(no label)").padEnd(labelWidth);
+    const status = !w.exists ? "\u26A0 path not found" : w.initialized ? "\u2713 initialized" : "\u26A0 no .basou (not a planning master?)";
+    lines.push(`- ${label}  ${w.path}  ${status}`);
+  }
+  lines.push("");
+  lines.push(
+    "Note: read-only listing of ~/.basou/portfolio.yaml. Run `basou view --portfolio` for the cross-workspace GUI, or `basou view --portfolio --check` for the redundancy/footprint safety preflight."
+  );
+  return lines.join("\n");
+}
+
 // src/commands/project.ts
 import {
   closeSync,
   copyFileSync,
-  existsSync,
+  existsSync as existsSync2,
   constants as fsConstants,
   ftruncateSync,
   lstatSync,
@@ -3630,13 +3723,13 @@ import {
   readFileSync,
   readlinkSync,
   realpathSync,
-  statSync,
+  statSync as statSync2,
   symlinkSync,
   unlinkSync,
   writeFileSync,
   writeSync
 } from "fs";
-import { basename as basename5, dirname as dirname3, isAbsolute as isAbsolute3, join as join9, relative as relative2, resolve as resolve7 } from "path";
+import { basename as basename5, dirname as dirname3, isAbsolute as isAbsolute3, join as join10, relative as relative2, resolve as resolve7 } from "path";
 import {
   appendBasouGitignore as appendBasouGitignore2,
   basouPaths as basouPaths10,
@@ -4018,7 +4111,7 @@ function classifySourceRoot(repositoryRoot, declaredPath) {
   } catch {
     return { path: declaredPath, kind: "unresolved" };
   }
-  return { path: declaredPath, kind: existsSync(join9(real, ".git")) ? "repo" : "non-repo" };
+  return { path: declaredPath, kind: existsSync2(join10(real, ".git")) ? "repo" : "non-repo" };
 }
 async function doRunProjectAdopt(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
@@ -4122,7 +4215,7 @@ async function gatherRepoWiring(repositoryRoot, entry) {
   } catch {
     return { ...base, reachable: false, instructionFiles: [] };
   }
-  if (!existsSync(join9(real, ".git"))) {
+  if (!existsSync2(join10(real, ".git"))) {
     return { ...base, reachable: false, instructionFiles: [] };
   }
   try {
@@ -4130,7 +4223,7 @@ async function gatherRepoWiring(repositoryRoot, entry) {
     for (const name of INSTRUCTION_FILES) {
       let present = true;
       try {
-        lstatSync(join9(real, name));
+        lstatSync(join10(real, name));
       } catch {
         present = false;
       }
@@ -4241,10 +4334,10 @@ function gatherRepoGitignore(repositoryRoot, entry) {
   } catch {
     return { ...base, reachable: false, currentLines: [] };
   }
-  if (!existsSync(join9(real, ".git"))) {
+  if (!existsSync2(join10(real, ".git"))) {
     return { ...base, reachable: false, currentLines: [] };
   }
-  return { ...base, reachable: true, currentLines: readGitignoreLines(join9(real, ".gitignore")) };
+  return { ...base, reachable: true, currentLines: readGitignoreLines(join10(real, ".gitignore")) };
 }
 function hasErrorCode(error) {
   return error instanceof Error && typeof error.code === "string";
@@ -4258,7 +4351,7 @@ function readGitignoreLines(file) {
   }
 }
 function applyGitignorePlan(repositoryRoot, plan) {
-  const file = join9(realpathSync(resolve7(repositoryRoot, plan.path)), ".gitignore");
+  const file = join10(realpathSync(resolve7(repositoryRoot, plan.path)), ".gitignore");
   let existing = "";
   try {
     existing = readFileSync(file, "utf8");
@@ -4384,7 +4477,7 @@ function anchorCanonicalState(filePath) {
     if (hasErrorCode(error) && error.code === "ENOENT") return "absent";
     return "broken";
   }
-  if (st.isSymbolicLink()) return existsSync(filePath) ? "usable" : "broken";
+  if (st.isSymbolicLink()) return existsSync2(filePath) ? "usable" : "broken";
   return st.isFile() ? "usable" : "broken";
 }
 function gatherRepoSymlinks(repositoryRoot, anchorReal, entry) {
@@ -4398,7 +4491,7 @@ function gatherRepoSymlinks(repositoryRoot, anchorReal, entry) {
     return { ...base, isAnchor: false, reachable: false, canonicalPresent: false, files: [] };
   }
   if (real === anchorReal) {
-    const anchorCanonical = join9(real, CANONICAL_FILE);
+    const anchorCanonical = join10(real, CANONICAL_FILE);
     const anchorState = anchorCanonicalState(anchorCanonical);
     if (anchorState === "absent") {
       return { ...base, isAnchor: true, reachable: true, canonicalPresent: false, files: [] };
@@ -4418,7 +4511,7 @@ function gatherRepoSymlinks(repositoryRoot, anchorReal, entry) {
       anchorCanonical,
       "self"
     ).map((spec) => {
-      const { state, actualTarget } = inspectSymlink(join9(real, spec.name), spec.target);
+      const { state, actualTarget } = inspectSymlink(join10(real, spec.name), spec.target);
       return {
         name: spec.name,
         expectedTarget: spec.target,
@@ -4435,16 +4528,16 @@ function gatherRepoSymlinks(repositoryRoot, anchorReal, entry) {
       files: anchorFiles
     };
   }
-  if (!existsSync(join9(real, ".git"))) {
+  if (!existsSync2(join10(real, ".git"))) {
     return { ...base, isAnchor: false, reachable: false, canonicalPresent: false, files: [] };
   }
-  const canonicalFile = isSelf ? join9(real, CANONICAL_FILE) : join9(anchorReal, "agents", basename5(real), CANONICAL_FILE);
-  if (!existsSync(canonicalFile)) {
+  const canonicalFile = isSelf ? join10(real, CANONICAL_FILE) : join10(anchorReal, "agents", basename5(real), CANONICAL_FILE);
+  if (!existsSync2(canonicalFile)) {
     return { ...base, isAnchor: false, reachable: true, canonicalPresent: false, files: [] };
   }
   const files = expectedSymlinkTargets(real, canonicalFile, mode).map(
     (spec) => {
-      const { state, actualTarget } = inspectSymlink(join9(real, spec.name), spec.target);
+      const { state, actualTarget } = inspectSymlink(join10(real, spec.name), spec.target);
       return {
         name: spec.name,
         expectedTarget: spec.target,
@@ -4473,7 +4566,7 @@ function applySymlinkPlan(repositoryRoot, plan) {
   const created = [];
   const failed = [];
   for (const { name, target } of plan.toCreate) {
-    const filePath = join9(real, name);
+    const filePath = join10(real, name);
     try {
       mkdirSync(dirname3(filePath), { recursive: true });
       symlinkSync(target, filePath);
@@ -4504,10 +4597,10 @@ function gatherViewSymlinks(repositoryRoot, anchorReal, roster, viewDir) {
   const collision = viewCanonicalCollision(repositoryRoot, roster, viewName);
   if (collision !== void 0) return { kind: "collision", viewName, repoPath: collision };
   const canonicalFile = canonicalFileFor(anchorReal, viewName);
-  if (!existsSync(canonicalFile)) return { kind: "missing-canonical", viewName };
+  if (!existsSync2(canonicalFile)) return { kind: "missing-canonical", viewName };
   const files = expectedSymlinkTargets(viewDir, canonicalFile, "hub").map(
     (spec) => {
-      const { state, actualTarget } = inspectSymlink(join9(viewDir, spec.name), spec.target);
+      const { state, actualTarget } = inspectSymlink(join10(viewDir, spec.name), spec.target);
       return {
         name: spec.name,
         expectedTarget: spec.target,
@@ -4523,7 +4616,7 @@ function applyViewSymlinks(viewDir, files) {
   const failed = [];
   for (const f of files) {
     if (f.state !== "missing") continue;
-    const filePath = join9(viewDir, f.name);
+    const filePath = join10(viewDir, f.name);
     try {
       mkdirSync(dirname3(filePath), { recursive: true });
       symlinkSync(f.expectedTarget, filePath);
@@ -4745,7 +4838,7 @@ function resolveViewDir(repositoryRoot, viewPath) {
     return realpathSync(abs);
   } catch {
     try {
-      return join9(realpathSync(dirname3(abs)), basename5(abs));
+      return join10(realpathSync(dirname3(abs)), basename5(abs));
     } catch {
       return abs;
     }
@@ -4763,7 +4856,7 @@ function gatherViewRepo(repositoryRoot, viewDir, entry) {
     return { path: entry.path, reachable: false };
   }
   const linkName = basename5(repoReal);
-  const { state, actualTarget } = inspectSymlink(join9(viewDir, linkName), expectedTarget);
+  const { state, actualTarget } = inspectSymlink(join10(viewDir, linkName), expectedTarget);
   return {
     path: entry.path,
     reachable: true,
@@ -4777,7 +4870,7 @@ function applyViewPlan(viewDir, toCreate) {
   const created = [];
   const failed = [];
   for (const { name, target } of toCreate) {
-    const filePath = join9(viewDir, name);
+    const filePath = join10(viewDir, name);
     try {
       mkdirSync(dirname3(filePath), { recursive: true });
       symlinkSync(target, filePath);
@@ -4792,7 +4885,7 @@ var TOP_LEVEL_INSTRUCTION_FILES_LOWER = new Set(
   INSTRUCTION_FILES.filter((f) => !f.includes("/")).map((f) => f.toLowerCase())
 );
 function classifyViewLink(viewDir, name, rosterRealpaths) {
-  const filePath = join9(viewDir, name);
+  const filePath = join10(viewDir, name);
   let isLink;
   try {
     isLink = lstatSync(filePath).isSymbolicLink();
@@ -4814,14 +4907,14 @@ function classifyViewLink(viewDir, name, rosterRealpaths) {
   if (isAbsolute3(target)) return { target, kind: "absolute" };
   let isDir = false;
   try {
-    isDir = statSync(resolved).isDirectory();
+    isDir = statSync2(resolved).isDirectory();
   } catch {
     isDir = false;
   }
   if (!isDir) {
-    return { target, kind: existsSync(resolved) ? "non-repo" : "broken" };
+    return { target, kind: existsSync2(resolved) ? "non-repo" : "broken" };
   }
-  return { target, kind: existsSync(join9(resolved, ".git")) ? "repo" : "non-repo" };
+  return { target, kind: existsSync2(join10(resolved, ".git")) ? "repo" : "non-repo" };
 }
 function gatherExistingViewLinks(viewDir, rosterRealpaths) {
   let names;
@@ -4846,7 +4939,7 @@ function pruneViewLinks(viewDir, toPrune, rosterRealpaths) {
   const pruned = [];
   const failed = [];
   for (const { name } of toPrune) {
-    const filePath = join9(viewDir, name);
+    const filePath = join10(viewDir, name);
     const c = classifyViewLink(viewDir, name, rosterRealpaths);
     if (c === null || c.kind !== "repo") {
       failed.push({
@@ -5059,10 +5152,10 @@ async function runProjectPreset(options, ctx = {}) {
   }
 }
 function canonicalFileFor(anchorReal, canonicalName) {
-  return join9(anchorReal, "agents", canonicalName, CANONICAL_FILE);
+  return join10(anchorReal, "agents", canonicalName, CANONICAL_FILE);
 }
 function canonicalLabelFor(canonicalName) {
-  return join9("agents", canonicalName, CANONICAL_FILE);
+  return join10("agents", canonicalName, CANONICAL_FILE);
 }
 async function gatherRepoPreset(repositoryRoot, anchorReal, entry) {
   const declared = {
@@ -5083,7 +5176,7 @@ async function gatherRepoPreset(repositoryRoot, anchorReal, entry) {
   if (real === anchorReal) {
     return { ...declared, isAnchor: true, reachable: true, canonicalPresent: false };
   }
-  if (!existsSync(join9(real, ".git"))) {
+  if (!existsSync2(join10(real, ".git"))) {
     return { ...declared, isAnchor: false, reachable: false, canonicalPresent: false };
   }
   const canonicalName = basename5(real);
@@ -5465,24 +5558,24 @@ function gatherArchiveTeardown(repositoryRoot, manifest, target) {
   const instructionFiles = [];
   for (const name of INSTRUCTION_FILES) {
     try {
-      lstatSync(join9(real, name));
+      lstatSync(join10(real, name));
       instructionFiles.push(name);
     } catch {
     }
   }
   let ignored;
   try {
-    ignored = new Set(readGitignoreLines(join9(real, ".gitignore")).map((l) => l.trim()));
+    ignored = new Set(readGitignoreLines(join10(real, ".gitignore")).map((l) => l.trim()));
   } catch {
     ignored = /* @__PURE__ */ new Set();
   }
   const gitignorePatterns = INSTRUCTION_FILES.filter((p) => ignored.has(p) || ignored.has(`/${p}`));
-  const canonical2 = existsSync(join9(anchorReal, "agents", canonicalName, CANONICAL_FILE));
+  const canonical2 = existsSync2(join10(anchorReal, "agents", canonicalName, CANONICAL_FILE));
   let viewLink = false;
   const viewPath = manifest.workspace.view;
   if (viewPath !== void 0) {
     try {
-      lstatSync(join9(resolveViewDir(repositoryRoot, viewPath), canonicalName));
+      lstatSync(join10(resolveViewDir(repositoryRoot, viewPath), canonicalName));
       viewLink = true;
     } catch {
     }
@@ -5496,11 +5589,11 @@ function gatherArchiveTeardown(repositoryRoot, manifest, target) {
   };
 }
 function teardownExpectedTargets(repoReal, anchorReal, canonicalName) {
-  const canonicalFile = join9(anchorReal, "agents", canonicalName, CANONICAL_FILE);
+  const canonicalFile = join10(anchorReal, "agents", canonicalName, CANONICAL_FILE);
   return expectedSymlinkTargets(repoReal, canonicalFile);
 }
 function viewLinkPointsAt(viewDir, name, repoReal) {
-  const filePath = join9(viewDir, name);
+  const filePath = join10(viewDir, name);
   try {
     if (!lstatSync(filePath).isSymbolicLink()) return false;
     const target = readlinkSync(filePath);
@@ -5511,7 +5604,7 @@ function viewLinkPointsAt(viewDir, name, repoReal) {
   }
 }
 function viewLinkPointsAtPath(viewDir, name, expectedRepoPath) {
-  const filePath = join9(viewDir, name);
+  const filePath = join10(viewDir, name);
   try {
     if (!lstatSync(filePath).isSymbolicLink()) return false;
     const target = readlinkSync(filePath);
@@ -5562,7 +5655,7 @@ function gatherRepoTeardown(repositoryRoot, manifest, target) {
   if (!isAnchor) {
     if (repoReal !== void 0) {
       for (const spec of teardownExpectedTargets(repoReal, anchorReal, canonicalName)) {
-        const { state, actualTarget } = inspectSymlink(join9(repoReal, spec.name), spec.target);
+        const { state, actualTarget } = inspectSymlink(join10(repoReal, spec.name), spec.target);
         if (isSelf) {
           if (state !== "missing")
             items.push({
@@ -5599,7 +5692,7 @@ function gatherRepoTeardown(repositoryRoot, manifest, target) {
       }
       let ignored;
       try {
-        ignored = new Set(readGitignoreLines(join9(repoReal, ".gitignore")).map((l) => l.trim()));
+        ignored = new Set(readGitignoreLines(join10(repoReal, ".gitignore")).map((l) => l.trim()));
         for (const p of INSTRUCTION_FILES) {
           if (ignored.has(p) || ignored.has(`/${p}`)) {
             items.push({
@@ -5622,7 +5715,7 @@ function gatherRepoTeardown(repositoryRoot, manifest, target) {
     const viewPath = manifest.workspace.view;
     if (viewPath !== void 0) {
       const viewDir = resolveViewDir(repositoryRoot, viewPath);
-      const linkPath = join9(viewDir, canonicalName);
+      const linkPath = join10(viewDir, canonicalName);
       let isLink = false;
       try {
         isLink = lstatSync(linkPath).isSymbolicLink();
@@ -5648,8 +5741,8 @@ function gatherRepoTeardown(repositoryRoot, manifest, target) {
         else items.push({ kind: "view-symlink", label: canonicalName, state: "removable" });
       }
     }
-    const canonicalFile = join9(anchorReal, "agents", canonicalName, CANONICAL_FILE);
-    const canonicalLabel = join9("agents", canonicalName, CANONICAL_FILE);
+    const canonicalFile = join10(anchorReal, "agents", canonicalName, CANONICAL_FILE);
+    const canonicalLabel = join10("agents", canonicalName, CANONICAL_FILE);
     let canonicalIsLink = false;
     try {
       canonicalIsLink = lstatSync(canonicalFile).isSymbolicLink();
@@ -5663,7 +5756,7 @@ function gatherRepoTeardown(repositoryRoot, manifest, target) {
         state: "foreign",
         note: "the canonical is a symlink (not generated)"
       });
-    } else if (existsSync(canonicalFile)) {
+    } else if (existsSync2(canonicalFile)) {
       let content;
       try {
         content = readFileSync(canonicalFile, "utf8");
@@ -5753,12 +5846,12 @@ function applyRepoTeardown(repositoryRoot, manifest, plan) {
   );
   for (const item of removable.filter((i) => i.kind === "instruction-symlink")) {
     const expected = expectedByName.get(item.label);
-    if (repoReal === null || expected === void 0 || inspectSymlink(join9(repoReal, item.label), expected).state !== "correct") {
+    if (repoReal === null || expected === void 0 || inspectSymlink(join10(repoReal, item.label), expected).state !== "correct") {
       changed(item.label);
       continue;
     }
     try {
-      unlinkSync(join9(repoReal, item.label));
+      unlinkSync(join10(repoReal, item.label));
       removed.push(item.label);
     } catch (error) {
       failed.push({ label: item.label, message: failureReason(error) });
@@ -5777,7 +5870,7 @@ function applyRepoTeardown(repositoryRoot, manifest, plan) {
       continue;
     }
     try {
-      unlinkSync(join9(viewDir, item.label));
+      unlinkSync(join10(viewDir, item.label));
       removed.push(`view/${item.label}`);
     } catch (error) {
       failed.push({ label: `view/${item.label}`, message: failureReason(error) });
@@ -5785,7 +5878,7 @@ function applyRepoTeardown(repositoryRoot, manifest, plan) {
   }
   const NOFOLLOW = fsConstants.O_NOFOLLOW ?? 0;
   for (const item of removable.filter((i) => i.kind === "canonical-block")) {
-    const canonicalFile = join9(anchorReal, "agents", canonicalName, CANONICAL_FILE);
+    const canonicalFile = join10(anchorReal, "agents", canonicalName, CANONICAL_FILE);
     try {
       if (lstatSync(canonicalFile).isSymbolicLink()) {
         changed(item.label);
@@ -6059,12 +6152,12 @@ function gatherRenameWiring(repositoryRoot, manifest, oldBasename) {
   } catch {
     return { canonicalDirOld: false, viewLinkOld: false };
   }
-  const canonicalDirOld = existsSync(join9(anchorReal, "agents", oldBasename));
+  const canonicalDirOld = existsSync2(join10(anchorReal, "agents", oldBasename));
   let viewLinkOld = false;
   const viewPath = manifest.workspace.view;
   if (viewPath !== void 0) {
     try {
-      lstatSync(join9(resolveViewDir(repositoryRoot, viewPath), oldBasename));
+      lstatSync(join10(resolveViewDir(repositoryRoot, viewPath), oldBasename));
       viewLinkOld = true;
     } catch {
     }
@@ -6262,7 +6355,7 @@ async function doRunProjectNew(repos, options, ctx) {
   const viewPath = options.view === false ? null : options.view ?? `../${viewStem}-workspace`;
   const sourceRoots = [...rosterPaths, ...viewPath !== null ? [viewPath] : []];
   const paths = basouPaths10(repositoryRoot);
-  const existed = existsSync(paths.files.manifest);
+  const existed = existsSync2(paths.files.manifest);
   const manifest = createManifest2({
     workspaceName,
     sourceRoots,
@@ -6422,7 +6515,7 @@ async function doRunProjectSeedAnchor(options, ctx) {
     console.log("\u2139\uFE0F No repo roster declared \u2014 nothing to seed.");
     return;
   }
-  const anchorDoc = join9(repositoryRoot, CANONICAL_FILE);
+  const anchorDoc = join10(repositoryRoot, CANONICAL_FILE);
   if (pathPresent(anchorDoc)) {
     console.log(
       `\u2705 The anchor's own \`${CANONICAL_FILE}\` already exists \u2014 hand-maintained, left untouched.`
@@ -6484,7 +6577,7 @@ function regularFileSpokes(repoReal) {
   const out = [];
   for (const spoke of ["CLAUDE.md", ".github/copilot-instructions.md"]) {
     try {
-      const st = lstatSync(join9(repoReal, spoke));
+      const st = lstatSync(join10(repoReal, spoke));
       if (!st.isSymbolicLink() && st.isFile()) out.push(spoke);
     } catch {
     }
@@ -6530,8 +6623,8 @@ function gatherRetrofit(repositoryRoot, anchorReal, roster, argPath, argAbs, arg
     };
   }
   const isAnchor = argReal === anchorReal;
-  const reachable = existsSync(join9(argReal, ".git"));
-  const canonicalFile = join9(anchorReal, "agents", canonicalName, CANONICAL_FILE);
+  const reachable = existsSync2(join10(argReal, ".git"));
+  const canonicalFile = join10(anchorReal, "agents", canonicalName, CANONICAL_FILE);
   return {
     path,
     declared,
@@ -6540,13 +6633,13 @@ function gatherRetrofit(repositoryRoot, anchorReal, roster, argPath, argAbs, arg
     reachable,
     canonicalName,
     ...viewCanonicalName !== void 0 ? { viewCanonicalName } : {},
-    agentsState: inspectAgentsState(join9(argReal, CANONICAL_FILE)),
+    agentsState: inspectAgentsState(join10(argReal, CANONICAL_FILE)),
     canonicalExists: pathPresent(canonicalFile),
     regularSpokes: regularFileSpokes(argReal)
   };
 }
 function relocateAgentsFile(repoReal, canonicalFile) {
-  const agentsFile = join9(repoReal, CANONICAL_FILE);
+  const agentsFile = join10(repoReal, CANONICAL_FILE);
   try {
     mkdirSync(dirname3(canonicalFile), { recursive: true });
   } catch (error) {
@@ -6663,7 +6756,7 @@ async function doRunProjectRetrofit(repo, options, ctx) {
   let failure;
   let partial = false;
   if (options.apply === true && plan.action === "relocate" && argReal !== void 0) {
-    const canonicalFile = join9(anchorReal, "agents", plan.canonicalName, CANONICAL_FILE);
+    const canonicalFile = join10(anchorReal, "agents", plan.canonicalName, CANONICAL_FILE);
     const res = relocateAgentsFile(argReal, canonicalFile);
     if (res.ok) {
       applied = true;
@@ -6868,7 +6961,7 @@ import { PROTOCOL_END, PROTOCOL_START, parseMarkers as parseMarkers3, readMarkdo
 
 // src/lib/context-channel.ts
 import { homedir as homedir7 } from "os";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 import {
   ORIENTATION_END,
   ORIENTATION_START,
@@ -6876,7 +6969,7 @@ import {
   readMarkdownFile as readMarkdownFile5,
   removeMarkerSection as removeMarkerSection2
 } from "@basou/core";
-var CODEX_TARGET_PATH = join10(homedir7(), ".codex", "AGENTS.md");
+var CODEX_TARGET_PATH = join11(homedir7(), ".codex", "AGENTS.md");
 var ORIENTATION_MARKERS = { start: ORIENTATION_START, end: ORIENTATION_END };
 var ORIENTATION_MANAGED_NOTE = "<!-- Managed by basou: 'basou refresh' regenerates everything between the BASOU:ORIENTATION markers with the workspace's current position. This block is transient \u2014 it changes every refresh; do not edit it. -->";
 function buildTargetBody(existing, block, markers) {
@@ -6980,15 +7073,15 @@ async function renderOrientationToCodexChannel(opts) {
 
 // src/lib/protocols-config.ts
 import { homedir as homedir8 } from "os";
-import { isAbsolute as isAbsolute4, join as join11, resolve as resolve8 } from "path";
+import { isAbsolute as isAbsolute4, join as join12, resolve as resolve8 } from "path";
 import { readYamlFile as readYamlFile5 } from "@basou/core";
-var DEFAULT_PROTOCOLS_CONFIG_PATH = join11(homedir8(), ".basou", "protocols.yaml");
-var DEFAULT_TARGET_PATH = join11(homedir8(), ".claude", "CLAUDE.md");
+var DEFAULT_PROTOCOLS_CONFIG_PATH = join12(homedir8(), ".basou", "protocols.yaml");
+var DEFAULT_TARGET_PATH = join12(homedir8(), ".claude", "CLAUDE.md");
 var ALLOWED_TOP_KEYS = /* @__PURE__ */ new Set(["version", "protocols"]);
 var ALLOWED_ENTRY_KEYS = /* @__PURE__ */ new Set(["source", "title"]);
 function expandTilde3(p) {
   if (p === "~") return homedir8();
-  if (p.startsWith("~/")) return join11(homedir8(), p.slice(2));
+  if (p.startsWith("~/")) return join12(homedir8(), p.slice(2));
   return p;
 }
 function isRecord3(value) {
@@ -7193,15 +7286,15 @@ import { InvalidArgumentError as InvalidArgumentError3 } from "commander";
 // src/commands/refresh-watch.ts
 import { readdir as readdir2, stat as stat5 } from "fs/promises";
 import { homedir as homedir9 } from "os";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 import { findErrorCode as findErrorCode8 } from "@basou/core";
 var DEFAULT_WATCH_INTERVAL_SEC = 30;
 var MIN_WATCH_INTERVAL_SEC = 5;
 var MAX_WATCH_INTERVAL_SEC = 86400;
 function watchedRoots(ctx) {
   return [
-    ctx.codexSessionsDir ?? join12(homedir9(), ".codex", "sessions"),
-    ctx.claudeProjectsDir ?? join12(homedir9(), ".claude", "projects")
+    ctx.codexSessionsDir ?? join13(homedir9(), ".codex", "sessions"),
+    ctx.claudeProjectsDir ?? join13(homedir9(), ".claude", "projects")
   ];
 }
 async function scanSourceLogs(roots) {
@@ -7215,7 +7308,7 @@ async function scanSourceLogs(roots) {
       throw new Error("Failed to read a source log directory", { cause: error });
     }
     for (const entry of entries) {
-      const full = join12(dir, entry.name);
+      const full = join13(dir, entry.name);
       if (entry.isDirectory()) {
         await walk(full);
       } else if (entry.isFile() && entry.name.endsWith(".jsonl")) {
@@ -7937,7 +8030,7 @@ function renderReviewGaps(summary) {
 // src/commands/run.ts
 import { mkdir as mkdir2 } from "fs/promises";
 import { homedir as homedir11 } from "os";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 import {
   acquireLock as acquireLock5,
   assertBasouRootSafe as assertBasouRootSafe12,
@@ -8013,13 +8106,13 @@ async function runTrackedTool(args, options, ctx, adapter) {
   await assertBasouRootSafe12(paths.root);
   const manifest = await readManifest8(paths);
   const sessionId = prefixedUlid4("ses");
-  const sessionDir = join13(paths.sessions, sessionId);
+  const sessionDir = join14(paths.sessions, sessionId);
   await mkdir2(sessionDir, { recursive: true });
   const appendEvent = ctx.appendEvent ?? (async (_sessionDir, event) => {
     await coreAppendChainedEvent2(paths, sessionId, event);
   });
   const startedAt = now().toISOString();
-  const sessionYamlPath = join13(sessionDir, "session.yaml");
+  const sessionYamlPath = join14(sessionDir, "session.yaml");
   const session = buildInitialSession2({
     id: sessionId,
     command,
@@ -8381,7 +8474,7 @@ async function syncCodexOrientationChannelPreSpawn(cwd, ctx) {
 
 // src/commands/session.ts
 import { readFile as readFile6 } from "fs/promises";
-import { basename as basename6, isAbsolute as isAbsolute6, join as join14, relative as relative3 } from "path";
+import { basename as basename6, isAbsolute as isAbsolute6, join as join15, relative as relative3 } from "path";
 import {
   acquireLock as acquireLock6,
   appendEventToExistingSession as appendEventToExistingSession3,
@@ -8506,8 +8599,8 @@ async function doRunSessionShow(idInput, options, ctx) {
   const paths = basouPaths16(repositoryRoot);
   await assertWorkspaceInitialized11(paths.root);
   const sessionId = await resolveSessionId3(paths, idInput);
-  const sessionDir = join14(paths.sessions, sessionId);
-  const sessionYamlPath = join14(sessionDir, "session.yaml");
+  const sessionDir = join15(paths.sessions, sessionId);
+  const sessionYamlPath = join15(sessionDir, "session.yaml");
   let session;
   try {
     const raw = await readYamlFile7(sessionYamlPath);
@@ -9269,7 +9362,7 @@ function formatVersionGateMessage(error) {
 
 // src/commands/task.ts
 import { readFile as readFile7 } from "fs/promises";
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 import {
   archiveTask,
   assertBasouRootSafe as assertBasouRootSafe16,
@@ -9595,7 +9688,7 @@ async function doRunTaskShow(idInput, options, ctx) {
   const events = [];
   const linkedSessionIds = new Set(doc.task.task.linked_sessions);
   for (const s of sessions) {
-    const sessionDir = join15(paths.sessions, s.sessionId);
+    const sessionDir = join16(paths.sessions, s.sessionId);
     try {
       for await (const ev of replayEvents3(sessionDir, {
         onWarning: (w) => printReplayWarning(w, s.sessionId)
@@ -10501,7 +10594,7 @@ import { InvalidArgumentError as InvalidArgumentError7 } from "commander";
 // src/lib/portfolio-safety.ts
 import { execFile } from "child_process";
 import { lstat as lstat2, realpath as realpath2 } from "fs/promises";
-import { isAbsolute as isAbsolute7, join as join16, relative as relative4, resolve as resolve11 } from "path";
+import { isAbsolute as isAbsolute7, join as join17, relative as relative4, resolve as resolve11 } from "path";
 import { promisify } from "util";
 import { readManifest as readManifest12 } from "@basou/core";
 var execFileAsync = promisify(execFile);
@@ -10525,7 +10618,7 @@ function isBasouPath(p) {
 async function inspectRepo(repoPath) {
   let hasEntry = false;
   try {
-    await lstat2(join16(repoPath, ".basou"));
+    await lstat2(join17(repoPath, ".basou"));
     hasEntry = true;
   } catch (error) {
     if (errorCode(error) !== "ENOENT") {
@@ -10679,7 +10772,7 @@ function formatSafetyReport(result) {
 
 // src/lib/view-server.ts
 import { createServer } from "http";
-import { basename as basename7, join as join17, resolve as resolve12 } from "path";
+import { basename as basename7, join as join18, resolve as resolve12 } from "path";
 import {
   computeWorkStats as computeWorkStats2,
   enumerateApprovals as enumerateApprovals2,
@@ -11719,7 +11812,7 @@ async function sessionDetail(ws, sessionId) {
     throw error;
   }
   try {
-    const events = await readAllEvents2(join17(ws.paths.sessions, sessionId));
+    const events = await readAllEvents2(join18(ws.paths.sessions, sessionId));
     return { session, events };
   } catch {
     return { session, events: [], degraded: true };
@@ -12100,6 +12193,7 @@ function buildProgram() {
   registerDecisionsCommand(program2);
   registerReportCommand(program2);
   registerOrientCommand(program2);
+  registerPortfolioCommand(program2);
   registerReviewCommand(program2);
   registerReviewGapsCommand(program2);
   registerProjectCommand(program2);