@basou/core 0.31.0 → 0.32.0

package/dist/index.js

@@ -5481,6 +5481,65 @@ function shortId(id) {
   return id.slice(0, sep + 1) + id.slice(sep + 1, sep + 1 + 10);
 }
 
+// src/project/anchor-starter.ts
+function renderAnchorStarter(input) {
+  const lines = [];
+  const title = input.projectName ?? input.anchorName;
+  lines.push(`# AGENTS.md (${input.anchorName})`);
+  lines.push("");
+  lines.push(
+    `> \u3053\u306E\u30EA\u30DD\u30B8\u30C8\u30EA\u306F **${title} \u306E planning master(anchor)** \u3067\u3059\u3002\u3053\u3053\u3067\u4F5C\u696D\u3059\u308B AI \u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u306F\u3001\u307E\u305A\u3053\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u8AAD\u3093\u3067\u304F\u3060\u3055\u3044\u3002`
+  );
+  lines.push(">");
+  lines.push(
+    "> \u3053\u306E\u30D5\u30A1\u30A4\u30EB\u306F `basou project derive` \u304C greenfield \u7ACB\u3061\u4E0A\u3052\u6642\u306B **\u4E00\u5EA6\u3060\u3051\u751F\u6210\u3057\u305F starter** \u3067\u3059\u3002\u4EE5\u5F8C\u306F\u624B\u7BA1\u7406\u3057\u3066\u304F\u3060\u3055\u3044 \u2014 basou \u306F\u518D\u751F\u6210\u3082\u4E0A\u66F8\u304D\u3082\u3057\u307E\u305B\u3093(BASOU:GENERATED \u30DE\u30FC\u30AB\u30FC\u306F\u7121\u304F\u3001\u81EA\u7531\u306B\u7DE8\u96C6\u3067\u304D\u307E\u3059)\u3002"
+  );
+  lines.push("");
+  lines.push("## \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u57FA\u672C\u60C5\u5831");
+  lines.push("");
+  lines.push("<!-- TODO: manifest \u304B\u3089\u306F\u5C0E\u51FA\u3067\u304D\u306A\u3044\u9805\u76EE\u3067\u3059\u3002\u57CB\u3081\u3066\u304F\u3060\u3055\u3044\u3002 -->");
+  lines.push("");
+  lines.push("```text");
+  lines.push(`Product name:          ${input.projectName ?? "<!-- TODO -->"}`);
+  lines.push("Domain:                <!-- TODO -->");
+  lines.push("GitHub Organization:   <!-- TODO -->");
+  lines.push("Public repository:     <!-- TODO -->");
+  lines.push("Planning repository:   <!-- TODO -->");
+  lines.push("License:               <!-- TODO -->");
+  lines.push("```");
+  lines.push("");
+  lines.push("## \u3069\u3053\u3067 commit \u3059\u308B\u304B");
+  lines.push("");
+  lines.push("- **\u3053\u306E\u30EA\u30DD\u30B8\u30C8\u30EA(planning master)**: \u69CB\u60F3\u30FB\u8A08\u753B\u30FB\u8A2D\u8A08\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3002");
+  lines.push("- **\u5404\u5B9F\u88C5 repo**: \u5B9F\u88C5\u30B3\u30FC\u30C9\u3002\u5FC5\u305A\u5BFE\u8C61 repo \u306B `cd` \u3057\u3066\u304B\u3089 commit \u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+  lines.push("- **workspace view**: git \u7BA1\u7406\u5916\u3002view \u3067\u306F commit \u3067\u304D\u307E\u305B\u3093\u3002");
+  lines.push("");
+  lines.push("## \u5FC5\u305A\u8AAD\u3080\u3079\u304D\u898F\u7D04");
+  lines.push("");
+  lines.push("\u4F5C\u696D\u898F\u7D04\u306F\u5404 repo \u306E AGENTS.md \u306B\u3042\u308A\u307E\u3059\u3002\u4EE5\u4E0B\u3092\u8AAD\u3093\u3067\u304B\u3089\u4F5C\u696D\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+  lines.push("");
+  for (const r of input.repos) {
+    if (r.anchor === true) continue;
+    lines.push(`- ${r.name}/AGENTS.md`);
+  }
+  if (input.viewName !== void 0) {
+    lines.push(
+      `- ${input.viewName}/AGENTS.md(workspace view\u30FBbasou \u304C\u751F\u6210)\u2014 **\u6700\u65B0\u306E repo \u69CB\u6210(roster)\u306F\u3053\u3053\u3092\u6B63\u3068\u3059\u308B**`
+    );
+  }
+  lines.push("");
+  lines.push("## \u4F5C\u696D\u65B9\u91DD(\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u56FA\u6709\u4E8B\u9805)");
+  lines.push("");
+  lines.push("<!-- TODO: \u4EE5\u4E0B\u3092\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306B\u5408\u308F\u305B\u3066\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+  lines.push("  - \u73FE\u5728\u306E\u30D5\u30A7\u30FC\u30BA / \u91CD\u8981\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8");
+  lines.push("  - \u6A5F\u5BC6\u60C5\u5831\u306E\u6271\u3044(\u3069\u3053\u306B\u66F8\u304B\u306A\u3044\u304B)");
+  lines.push("  - \u8A00\u8A9E\u30DD\u30EA\u30B7\u30FC(commit / \u30B3\u30E1\u30F3\u30C8 / \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u306E\u8A00\u8A9E)");
+  lines.push("  - commit \u904B\u7528(\u6DF7\u5728\u30B3\u30DF\u30C3\u30C8\u3092\u907F\u3051\u308B \u7B49)");
+  lines.push("-->");
+  return `${lines.join("\n")}
+`;
+}
+
 // src/project/relative-path.ts
 function normalizeRelativePath(p) {
   const trimmed = p.trim();
@@ -5657,10 +5716,69 @@ function renderPresetBlock(repo) {
   }
   return lines.join("\n");
 }
+function visibilityShortLabel(v) {
+  return v ?? "\u672A\u8A2D\u5B9A";
+}
+function languageShortLabel(l) {
+  return l ?? "\u672A\u8A2D\u5B9A";
+}
+function instructionsLabel(repo) {
+  if (repo.anchor === true) return "anchor(\u624B\u7BA1\u7406)";
+  return repo.self === true ? "self(repo \u304C\u81EA\u5DF1\u7BA1\u7406)" : "hub(basou \u304C\u751F\u6210)";
+}
+function renderViewPresetBlock(input) {
+  const lines = [];
+  lines.push("## workspace view \u69CB\u6210(basou \u304C\u751F\u6210 \u2014 manifest \u304C\u6B63\u672C)");
+  lines.push("");
+  lines.push(
+    "\u3053\u306E\u30BB\u30AF\u30B7\u30E7\u30F3\u306F `.basou/manifest.yaml` \u306E\u5BA3\u8A00\u304B\u3089 `basou project preset` \u304C\u751F\u6210\u3057\u307E\u3059\u3002\u7DE8\u96C6\u306F manifest \u5074\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044(\u30DE\u30FC\u30AB\u30FC\u5916\u306E\u8A18\u8FF0\u306F\u4FDD\u6301\u3055\u308C\u307E\u3059)\u3002"
+  );
+  lines.push(
+    `\u3053\u306E AGENTS.md \u81EA\u8EAB\u3082 basou \u306E\u751F\u6210\u7269\u3067\u3059(\u5B9F\u4F53: \`agents/${input.viewName}/AGENTS.md\`\u3001\u30DE\u30FC\u30AB\u30FC\u5916\u306E\u8A18\u8FF0\u306F\u4FDD\u6301\u3055\u308C\u307E\u3059)\u3002`
+  );
+  lines.push("");
+  lines.push(
+    `\u3053\u306E\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u306F\u3001\u5BA3\u8A00\u3055\u308C\u305F ${input.repos.length} \u500B\u306E repo \u3092 symlink \u3067\u96C6\u7D04\u3059\u308B **view** \u3067\u3059\u3002\u5B9F\u4F53\u3092\u6301\u305F\u305A\u3001git \u7BA1\u7406\u5916\u3067\u3059\u3002`
+  );
+  lines.push("");
+  lines.push("### \u96C6\u7D04\u3057\u3066\u3044\u308B repo");
+  lines.push("");
+  lines.push("| repo | \u53EF\u8996\u6027 | \u8A00\u8A9E | \u6307\u793A\u66F8 |");
+  lines.push("|---|---|---|---|");
+  for (const r of input.repos) {
+    lines.push(
+      `| ${r.name} | ${visibilityShortLabel(r.visibility)} | ${languageShortLabel(r.language)} | ${instructionsLabel(r)} |`
+    );
+  }
+  lines.push("");
+  lines.push("### \u3069\u3053\u3067 commit \u3059\u308B\u304B");
+  lines.push("");
+  lines.push(
+    "view \u3067\u306F commit \u3067\u304D\u307E\u305B\u3093(git \u7BA1\u7406\u5916)\u3002\u5909\u66F4\u306F\u5FC5\u305A\u5B9F\u4F53\u306E repo \u306B `cd` \u3057\u3066\u304B\u3089 commit \u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+  );
+  lines.push("");
+  for (const r of input.repos) {
+    lines.push(`- ${r.name} \u2192 \`cd ${r.name}\``);
+  }
+  lines.push("");
+  lines.push("### \u5FC5\u305A\u8AAD\u3080\u3079\u304D\u898F\u7D04");
+  lines.push("");
+  lines.push("\u4F5C\u696D\u898F\u7D04\u306F\u5404 repo \u306E AGENTS.md \u306B\u3042\u308A\u307E\u3059\u3002\u4EE5\u4E0B\u3092\u8AAD\u3093\u3067\u304B\u3089\u4F5C\u696D\u3057\u3066\u304F\u3060\u3055\u3044\u3002");
+  lines.push("");
+  for (const r of input.repos) {
+    lines.push(`- ${r.name}/AGENTS.md`);
+  }
+  lines.push("");
+  lines.push("### \u91CD\u8981\u539F\u5247");
+  lines.push("");
+  lines.push("- \u3053\u306E\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u306F\u72B6\u614B\u3092\u6301\u305F\u306A\u3044(git \u7BA1\u7406\u5916)");
+  lines.push("- \u91CD\u8981\u306A\u30D5\u30A1\u30A4\u30EB\u3092\u3053\u3053\u306B\u76F4\u63A5\u7F6E\u304B\u306A\u3044(\u5B9F\u4F53\u306F\u5404 repo \u306B\u7F6E\u304F)");
+  return lines.join("\n");
+}
 function normalizeBlock(s) {
   return s.replace(/\r\n/g, "\n").replace(/\n+$/, "");
 }
-function summarizePresetPlan(facts) {
+function summarizePresetPlan(facts, opts) {
   const deduped = [];
   const seenPath = /* @__PURE__ */ new Set();
   for (const f of facts) {
@@ -5680,8 +5798,9 @@ function summarizePresetPlan(facts) {
   const collisions = [];
   const collidingPaths = /* @__PURE__ */ new Set();
   for (const [canonicalName, repos] of byCanonical) {
-    if (repos.length > 1) {
-      collisions.push({ canonicalName, repos });
+    const viewCollision = opts?.viewCanonicalName !== void 0 && canonicalName === opts.viewCanonicalName;
+    if (repos.length > 1 || viewCollision) {
+      collisions.push({ canonicalName, repos, ...viewCollision ? { view: true } : {} });
       for (const r of repos) collidingPaths.add(r);
     }
   }
@@ -5846,6 +5965,8 @@ function classifyRetrofit(facts) {
   if (facts.agentsState === "symlink")
     return { ...base, action: "skip", reason: "already-symlink" };
   if (facts.agentsState === "absent") return { ...base, action: "skip", reason: "absent" };
+  if (facts.viewCanonicalName !== void 0 && facts.canonicalName === facts.viewCanonicalName)
+    return { ...base, action: "refuse", reason: "view-collision" };
   if (facts.canonicalExists) return { ...base, action: "refuse", reason: "canonical-exists" };
   return {
     ...base,
@@ -5942,7 +6063,7 @@ function summarizeSymlinkPlan(facts) {
   const selfAgentsMissing = [];
   const unreachable = [];
   for (const f of deduped) {
-    if (f.isAnchor) continue;
+    if (f.isAnchor && !f.canonicalPresent) continue;
     if (!f.reachable) {
       unreachable.push(f.path);
       continue;
@@ -6021,6 +6142,68 @@ function summarizeWiring(facts) {
   };
 }
 
+// src/project/wiring-drift.ts
+function summarizeWiringDrift(input) {
+  const plan = summarizeSymlinkPlan(input.repos);
+  const missingCanonicals = [
+    ...plan.missingCanonical.map((path2) => ({ target: "repo-hub", name: path2 })),
+    ...plan.selfAgentsMissing.map(
+      (path2) => ({ target: "repo-self", name: path2 })
+    )
+  ];
+  const incompleteWiring = plan.plans.map((p) => ({
+    target: "repo",
+    path: p.path,
+    files: p.toCreate.map((c) => c.name)
+  }));
+  const conflicts = plan.conflicts.map((c) => ({
+    target: "repo",
+    path: c.repo,
+    file: c.file,
+    reason: c.reason,
+    ...c.actualTarget !== void 0 ? { actualTarget: c.actualTarget } : {}
+  }));
+  const collisions = plan.collisions.map((c) => ({
+    canonicalName: c.canonicalName,
+    repos: c.repos
+  }));
+  const view = input.view;
+  if (view.kind === "collision") {
+    collisions.push({ canonicalName: view.viewName, repos: [view.repoPath], view: true });
+  } else if (view.kind === "missing-canonical") {
+    missingCanonicals.push({ target: "view", name: view.viewName });
+  } else if (view.kind === "gathered") {
+    const missingSpokes = [];
+    for (const f of view.files) {
+      if (f.state === "missing") {
+        missingSpokes.push(f.name);
+      } else if (f.state === "mismatch" || f.state === "occupied" || f.state === "blocked") {
+        conflicts.push({
+          target: "view",
+          path: view.viewName,
+          file: f.name,
+          reason: f.state,
+          ...f.actualTarget !== void 0 ? { actualTarget: f.actualTarget } : {}
+        });
+      }
+    }
+    if (missingSpokes.length > 0) {
+      incompleteWiring.push({ target: "view", path: view.viewName, files: missingSpokes });
+    }
+  }
+  return {
+    missingCanonicals,
+    incompleteWiring,
+    conflicts,
+    collisions,
+    unreachable: plan.unreachable,
+    // `unreachable` is intentionally NOT part of `ok`: a declared repo that is not
+    // cloned on this machine is an advisory fact (partial checkout), not drift the
+    // operator must fix here. Only actionable drift denies `ok`.
+    ok: missingCanonicals.length === 0 && incompleteWiring.length === 0 && conflicts.length === 0 && collisions.length === 0
+  };
+}
+
 // src/project/workspace-view.ts
 function planWorkspaceView(facts, existing = [], rosterNames = []) {
   const deduped = [];
@@ -7545,6 +7728,33 @@ ${normalized}${markers.end}${section.after}`;
       throw new Error(`Markers mismatched in ${fileLabel}`);
   }
 }
+function seedMarkers(existing, generated, fileLabel, markers = DEFAULT_MARKERS) {
+  const normalized = generated.endsWith("\n") ? generated : `${generated}
+`;
+  if (existing === null) {
+    return `${markers.start}
+${normalized}${markers.end}
+`;
+  }
+  const section = parseMarkers(existing, markers);
+  switch (section.kind) {
+    case "ok":
+      return renderWithMarkers(existing, generated, fileLabel, markers);
+    case "no_markers": {
+      const bom = existing.charCodeAt(0) === 65279 ? "\uFEFF" : "";
+      const body = bom === "" ? existing : existing.slice(1);
+      return `${bom}${markers.start}
+${normalized}${markers.end}
+
+${body}`;
+    }
+    case "missing_start":
+    case "missing_end":
+    case "multiple_pairs":
+    case "wrong_order":
+      throw new Error(`Markers mismatched in ${fileLabel}`);
+  }
+}
 function removeMarkerSection(existing, fileLabel, markers = DEFAULT_MARKERS) {
   const section = parseMarkers(existing, markers);
   switch (section.kind) {
@@ -8113,11 +8323,13 @@ export {
   reimportPreservingId,
   removeMarkerSection,
   removeStopHook,
+  renderAnchorStarter,
   renderDecisions,
   renderHandoff,
   renderOrientation,
   renderPresetBlock,
   renderReport,
+  renderViewPresetBlock,
   renderWithMarkers,
   replayEvents,
   resolveBasouRepositoryRoot,
@@ -8130,6 +8342,7 @@ export {
   sanitizePath,
   sanitizeRelatedFiles,
   sanitizeWorkingDirectory,
+  seedMarkers,
   serializeEventLine,
   serializeJsonSchema,
   sessionWorkStatsFromEvents,
@@ -8139,6 +8352,7 @@ export {
   summarizeRosterDrift,
   summarizeSymlinkPlan,
   summarizeWiring,
+  summarizeWiringDrift,
   tryRemoteUrl,
   ulid,
   unknownManifestKeys,