@basou/cli 0.27.0 → 0.28.0

package/dist/program.js

@@ -3391,6 +3391,7 @@ import {
   ensureBasouDirectory as ensureBasouDirectory2,
   GENERATED_END,
   GENERATED_START,
+  instructionMode,
   isGitNotFound,
   parseMarkers,
   pathBasename,
@@ -3780,7 +3781,8 @@ async function isTrackedByGit(repoRoot, relPath) {
 async function gatherRepoWiring(repositoryRoot, entry) {
   const base = {
     path: entry.path,
-    ...entry.visibility !== void 0 ? { visibility: entry.visibility } : {}
+    ...entry.visibility !== void 0 ? { visibility: entry.visibility } : {},
+    ...instructionMode(entry) === "self" ? { self: true } : {}
   };
   let real;
   try {
@@ -3863,6 +3865,13 @@ function renderProjectWiring(result) {
     for (const p of result.unknown) lines.push(`- ${p}`);
     lines.push("");
   }
+  if (result.self.length > 0) {
+    lines.push(
+      `## instructions: self (${result.self.length}) \u2014 committed instruction files are intentional (no leak risk)`
+    );
+    for (const p of result.self) lines.push(`- ${p}`);
+    lines.push("");
+  }
   if (result.incomplete.length > 0) {
     lines.push(
       `## Missing instruction files (${result.incomplete.length}) \u2014 to be filled by a later generation slice`
@@ -3891,7 +3900,8 @@ async function runProjectGitignore(options, ctx = {}) {
 function gatherRepoGitignore(repositoryRoot, entry) {
   const base = {
     path: entry.path,
-    ...entry.visibility !== void 0 ? { visibility: entry.visibility } : {}
+    ...entry.visibility !== void 0 ? { visibility: entry.visibility } : {},
+    ...instructionMode(entry) === "self" ? { self: true } : {}
   };
   let real;
   try {
@@ -3986,6 +3996,13 @@ function renderProjectGitignore(result) {
     for (const p of result.unknown) lines.push(`- ${p}`);
     lines.push("");
   }
+  if (result.self.length > 0) {
+    lines.push(
+      `## instructions: self (${result.self.length}) \u2014 skipped by design; their committed instruction files are shared, never gitignored`
+    );
+    for (const p of result.self) lines.push(`- ${p}`);
+    lines.push("");
+  }
   if (result.unreachable.length > 0) {
     lines.push(`## Unreachable (${result.unreachable.length}) \u2014 path unresolved / not a git repo`);
     for (const p of result.unreachable) lines.push(`- ${p}`);
@@ -4007,12 +4024,13 @@ async function runProjectSymlinks(options, ctx = {}) {
     process.exitCode = 1;
   }
 }
-function expectedSymlinkTargets(repoDirReal, canonicalFile) {
-  return [
-    { name: "AGENTS.md", target: relative2(repoDirReal, canonicalFile) },
+function expectedSymlinkTargets(repoDirReal, canonicalFile, mode = "hub") {
+  const spokes = [
     { name: "CLAUDE.md", target: CANONICAL_FILE },
     { name: ".github/copilot-instructions.md", target: `../${CANONICAL_FILE}` }
   ];
+  if (mode === "self") return spokes;
+  return [{ name: "AGENTS.md", target: relative2(repoDirReal, canonicalFile) }, ...spokes];
 }
 function inspectSymlink(filePath, expectedTarget) {
   let isLink;
@@ -4027,7 +4045,9 @@ function inspectSymlink(filePath, expectedTarget) {
   return actual === expectedTarget ? { state: "correct" } : { state: "mismatch", actualTarget: actual };
 }
 function gatherRepoSymlinks(repositoryRoot, anchorReal, entry) {
-  const base = { path: entry.path };
+  const mode = instructionMode(entry);
+  const isSelf = mode === "self";
+  const base = { path: entry.path, ...isSelf ? { self: true } : {} };
   let real;
   try {
     real = realpathSync(resolve7(repositoryRoot, entry.path));
@@ -4040,11 +4060,11 @@ function gatherRepoSymlinks(repositoryRoot, anchorReal, entry) {
   if (!existsSync(join7(real, ".git"))) {
     return { ...base, isAnchor: false, reachable: false, canonicalPresent: false, files: [] };
   }
-  const canonicalFile = join7(anchorReal, "agents", basename4(real), CANONICAL_FILE);
+  const canonicalFile = isSelf ? join7(real, CANONICAL_FILE) : join7(anchorReal, "agents", basename4(real), CANONICAL_FILE);
   if (!existsSync(canonicalFile)) {
     return { ...base, isAnchor: false, reachable: true, canonicalPresent: false, files: [] };
   }
-  const files = expectedSymlinkTargets(real, canonicalFile).map(
+  const files = expectedSymlinkTargets(real, canonicalFile, mode).map(
     (spec) => {
       const { state, actualTarget } = inspectSymlink(join7(real, spec.name), spec.target);
       return {
@@ -4197,6 +4217,13 @@ function renderProjectSymlinks(result) {
     for (const p of result.missingCanonical) lines.push(`- ${p}`);
     lines.push("");
   }
+  if (result.selfAgentsMissing.length > 0) {
+    lines.push(
+      `## AGENTS.md missing (${result.selfAgentsMissing.length}) \u2014 these \`instructions: self\` repos have no committed AGENTS.md yet; author it, then re-run to wire the spokes`
+    );
+    for (const p of result.selfAgentsMissing) lines.push(`- ${p}`);
+    lines.push("");
+  }
   if (result.unreachable.length > 0) {
     lines.push(`## Unreachable (${result.unreachable.length}) \u2014 path unresolved / not a git repo`);
     for (const p of result.unreachable) lines.push(`- ${p}`);
@@ -4547,6 +4574,9 @@ async function gatherRepoPreset(repositoryRoot, anchorReal, entry) {
     ...entry.language !== void 0 ? { language: entry.language } : {},
     ...entry.publishes !== void 0 ? { publishes: entry.publishes } : {}
   };
+  if (instructionMode(entry) === "self") {
+    return { ...declared, self: true, isAnchor: false, reachable: true, canonicalPresent: false };
+  }
   let real;
   try {
     real = realpathSync(resolve7(repositoryRoot, entry.path));
@@ -4754,6 +4784,13 @@ function renderProjectPreset(result) {
     for (const p of result.anchors) lines.push(`- ${p}`);
     lines.push("");
   }
+  if (result.self.length > 0) {
+    lines.push(
+      `## instructions: self (${result.self.length}) \u2014 hands-off; their hand-authored AGENTS.md is never written by basou`
+    );
+    for (const p of result.self) lines.push(`- ${p}`);
+    lines.push("");
+  }
   if (result.unreachable.length > 0) {
     lines.push(`## Unreachable (${result.unreachable.length}) \u2014 path unresolved / not a git repo`);
     for (const p of result.unreachable) lines.push(`- ${p}`);
@@ -4859,13 +4896,15 @@ function gatherRepoTeardown(repositoryRoot, manifest, target) {
   const targetAbs = resolve7(repositoryRoot, target);
   const canonicalName = basename4(repoReal ?? targetAbs);
   const roster = manifest.repos ?? [];
-  const inRoster = roster.some((r) => {
+  const declaredEntry = roster.find((r) => {
     try {
       return realpathSync(resolve7(repositoryRoot, r.path)) === (repoReal ?? "\0");
     } catch {
       return resolve7(repositoryRoot, r.path) === targetAbs;
     }
   });
+  const inRoster = declaredEntry !== void 0;
+  const isSelf = declaredEntry !== void 0 && instructionMode(declaredEntry) === "self";
   const cnFold = canonicalName.toLowerCase();
   const canonicalShared = roster.some((r) => {
     let rReal = null;
@@ -4887,6 +4926,16 @@ function gatherRepoTeardown(repositoryRoot, manifest, target) {
     if (repoReal !== void 0) {
       for (const spec of teardownExpectedTargets(repoReal, anchorReal, canonicalName)) {
         const { state, actualTarget } = inspectSymlink(join7(repoReal, spec.name), spec.target);
+        if (isSelf) {
+          if (state !== "missing")
+            items.push({
+              kind: "instruction-symlink",
+              label: spec.name,
+              state: "foreign",
+              note: "instructions: self \u2014 committed, left untouched"
+            });
+          continue;
+        }
         if (state === "correct")
           items.push({ kind: "instruction-symlink", label: spec.name, state: "removable" });
         else if (state === "mismatch")
@@ -5735,7 +5784,7 @@ function pathPresent(p) {
   }
 }
 function gatherRetrofit(repositoryRoot, anchorReal, roster, argPath, argAbs, argReal) {
-  const declared = roster.some((entry) => {
+  const declaredEntry = roster.find((entry) => {
     const entryAbs = resolve7(repositoryRoot, entry.path);
     if (argReal !== void 0) {
       try {
@@ -5745,6 +5794,8 @@ function gatherRetrofit(repositoryRoot, anchorReal, roster, argPath, argAbs, arg
     }
     return entryAbs === argAbs;
   });
+  const declared = declaredEntry !== void 0;
+  const self = declaredEntry !== void 0 && instructionMode(declaredEntry) === "self";
   const displayRel = argReal !== void 0 ? relative2(anchorReal, argReal) : relative2(repositoryRoot, argAbs);
   const path = displayRel === "" ? "." : displayRel;
   const canonicalName = basename4(argReal ?? argAbs);
@@ -5752,6 +5803,7 @@ function gatherRetrofit(repositoryRoot, anchorReal, roster, argPath, argAbs, arg
     return {
       path,
       declared,
+      ...self ? { self: true } : {},
       isAnchor: false,
       reachable: false,
       canonicalName,
@@ -5766,6 +5818,7 @@ function gatherRetrofit(repositoryRoot, anchorReal, roster, argPath, argAbs, arg
   return {
     path,
     declared,
+    ...self ? { self: true } : {},
     isAnchor,
     reachable,
     canonicalName,
@@ -5868,6 +5921,10 @@ function renderProjectRetrofit(result) {
       lines.push(
         `\u2139\uFE0F \`${result.path}\` is not declared in the roster (manifest \`repos\`). Add it first with \`basou project new\` / \`basou project adopt\`, then re-run.`
       );
+    } else if (result.reason === "self") {
+      lines.push(
+        `\u2139\uFE0F \`${result.path}\` declares \`instructions: self\` \u2014 its \`${CANONICAL_FILE}\` is a hand-authored committed file that stays in the repo, so there is no anchor canonical to relocate it to. Retrofit does not apply (its CLAUDE.md / Copilot spokes are wired by \`basou project symlinks\`).`
+      );
     } else if (result.reason === "anchor") {
       lines.push(
         `\u26A0\uFE0F \`${result.path}\` is the anchor (the project root). It owns its canonical directly \u2014 there is nothing to relocate.`