@basou/core 0.27.0 → 0.29.0

package/dist/index.js

@@ -21,6 +21,118 @@ function summarizeAdapterOutput(_stream, _raw) {
   throw new Error("adapter_output summary is not implemented in this release");
 }
 
+// src/adapters/claude-code/settings-hook.ts
+var STOP_HOOK_TIMEOUT_SECONDS = 20;
+var BASOU_STOP_HOOK = /(?:\bbasou|(?:@basou|packages)\/cli\/dist\/index\.js['"]?)\s+hook\s+stop\b/;
+function isBasouStopHookCommand(command) {
+  return BASOU_STOP_HOOK.test(command);
+}
+function shellQuote(value) {
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function buildStopHookCommand(options) {
+  const flags = [];
+  if (options.block === true) flags.push("--block");
+  if (options.minEdits !== void 0) flags.push(`--min-edits ${options.minEdits}`);
+  const suffix = flags.length > 0 ? ` ${flags.join(" ")}` : "";
+  return `node ${shellQuote(options.cliEntry)} hook stop${suffix} 2>/dev/null || true`;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cloneSettings(settings) {
+  if (settings === void 0 || settings === null) return {};
+  if (!isRecord(settings)) {
+    throw new Error("Claude settings is not a JSON object.");
+  }
+  return structuredClone(settings);
+}
+function upsertStopHook(settings, command) {
+  const root = cloneSettings(settings);
+  if (root.hooks === void 0) {
+    root.hooks = {};
+  } else if (!isRecord(root.hooks)) {
+    throw new Error("The 'hooks' key in Claude settings is not an object.");
+  }
+  const hooks = root.hooks;
+  if (hooks.Stop === void 0) {
+    hooks.Stop = [];
+  } else if (!Array.isArray(hooks.Stop)) {
+    throw new Error("The 'hooks.Stop' key in Claude settings is not an array.");
+  }
+  const stop = hooks.Stop;
+  for (const group of stop) {
+    if (!isRecord(group) || !Array.isArray(group.hooks)) continue;
+    for (const entry of group.hooks) {
+      if (!isRecord(entry)) continue;
+      if (typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
+        const unchanged = entry.type === "command" && entry.command === command && entry.timeout === STOP_HOOK_TIMEOUT_SECONDS;
+        entry.type = "command";
+        entry.command = command;
+        entry.timeout = STOP_HOOK_TIMEOUT_SECONDS;
+        return { settings: root, action: unchanged ? "unchanged" : "updated" };
+      }
+    }
+  }
+  stop.push({ hooks: [{ type: "command", command, timeout: STOP_HOOK_TIMEOUT_SECONDS }] });
+  return { settings: root, action: "installed" };
+}
+function removeStopHook(settings) {
+  const root = cloneSettings(settings);
+  if (!isRecord(root.hooks) || !Array.isArray(root.hooks.Stop)) {
+    return { settings: root, action: "absent" };
+  }
+  const hooks = root.hooks;
+  const stop = hooks.Stop;
+  let removed = false;
+  const newStop = [];
+  for (const group of stop) {
+    if (!isRecord(group) || !Array.isArray(group.hooks)) {
+      newStop.push(group);
+      continue;
+    }
+    const keptHooks = group.hooks.filter((entry) => {
+      if (isRecord(entry) && typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
+        removed = true;
+        return false;
+      }
+      return true;
+    });
+    if (keptHooks.length === group.hooks.length) {
+      newStop.push(group);
+    } else if (keptHooks.length > 0) {
+      group.hooks = keptHooks;
+      newStop.push(group);
+    }
+  }
+  if (!removed) {
+    return { settings: root, action: "absent" };
+  }
+  if (newStop.length === 0) {
+    delete hooks.Stop;
+  } else {
+    hooks.Stop = newStop;
+  }
+  if (Object.keys(hooks).length === 0) {
+    delete root.hooks;
+  }
+  return { settings: root, action: "removed" };
+}
+function findBasouStopHookCommand(settings) {
+  if (!isRecord(settings) || !isRecord(settings.hooks) || !Array.isArray(settings.hooks.Stop)) {
+    return null;
+  }
+  for (const group of settings.hooks.Stop) {
+    if (!isRecord(group) || !Array.isArray(group.hooks)) continue;
+    for (const entry of group.hooks) {
+      if (isRecord(entry) && typeof entry.command === "string" && isBasouStopHookCommand(entry.command)) {
+        return entry.command;
+      }
+    }
+  }
+  return null;
+}
+
 // src/adapters/claude-code/ask-user-question.ts
 function readString(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -4582,6 +4694,7 @@ var ImportConfigSchema = z9.looseObject({
 var RepoVisibilitySchema = z9.enum(["public", "private", "future-public"]);
 var RepoLanguageSchema = z9.enum(["en", "ja", "en+ja"]);
 var PublishKindSchema = z9.enum(["web", "npm"]);
+var RepoInstructionsSchema = z9.enum(["hub", "self"]);
 var PublishTargetSchema = z9.looseObject({
   kind: PublishKindSchema,
   visibility: RepoVisibilitySchema.optional(),
@@ -4591,7 +4704,8 @@ var RepoEntrySchema = z9.looseObject({
   path: SourceRootSchema,
   visibility: RepoVisibilitySchema.optional(),
   language: RepoLanguageSchema.optional(),
-  publishes: z9.array(PublishTargetSchema).optional()
+  publishes: z9.array(PublishTargetSchema).optional(),
+  instructions: RepoInstructionsSchema.optional()
 });
 var WorkspaceMetaSchema = z9.looseObject({
   id: WorkspaceIdSchema,
@@ -5365,12 +5479,17 @@ function isPublicFacing(v) {
 function planGitignore(input) {
   const plans = [];
   const unknown = [];
+  const self = [];
   const unreachable = [];
   for (const repo of input.repos) {
     if (!repo.reachable) {
       unreachable.push(repo.path);
       continue;
     }
+    if (repo.self === true) {
+      self.push(repo.path);
+      continue;
+    }
     if (repo.visibility === void 0) {
       unknown.push(repo.path);
       continue;
@@ -5388,6 +5507,7 @@ function planGitignore(input) {
   return {
     plans,
     unknown,
+    self,
     unreachable,
     ok: plans.length === 0 && unknown.length === 0 && unreachable.length === 0
   };
@@ -5476,7 +5596,8 @@ function summarizePresetPlan(facts) {
   }
   const byCanonical = /* @__PURE__ */ new Map();
   for (const f of deduped) {
-    if (f.isAnchor || !f.reachable || f.canonicalName === void 0 || !isRenderable(f)) continue;
+    if (f.isAnchor || f.self === true || !f.reachable || f.canonicalName === void 0 || !isRenderable(f))
+      continue;
     const repos = byCanonical.get(f.canonicalName) ?? [];
     repos.push(f.path);
     byCanonical.set(f.canonicalName, repos);
@@ -5495,12 +5616,17 @@ function summarizePresetPlan(facts) {
   const markerConflicts = [];
   const unreadable = [];
   const anchors = [];
+  const self = [];
   const unreachable = [];
   for (const f of deduped) {
     if (f.isAnchor) {
       anchors.push(f.path);
       continue;
     }
+    if (f.self === true) {
+      self.push(f.path);
+      continue;
+    }
     if (!f.reachable) {
       unreachable.push(f.path);
       continue;
@@ -5546,6 +5672,7 @@ function summarizePresetPlan(facts) {
     unreadable,
     collisions,
     anchors,
+    self,
     unreachable,
     ok: plans.length === 0 && markerConflicts.length === 0 && unreadable.length === 0 && collisions.length === 0 && unreachable.length === 0 && undeclared.length === 0
   };
@@ -5638,6 +5765,7 @@ function classifyRetrofit(facts) {
   };
   if (!facts.declared) return { ...base, action: "refuse", reason: "not-declared" };
   if (facts.isAnchor) return { ...base, action: "refuse", reason: "anchor" };
+  if (facts.self === true) return { ...base, action: "refuse", reason: "self" };
   if (!facts.reachable) return { ...base, action: "refuse", reason: "unreachable" };
   if (facts.agentsState === "blocked") return { ...base, action: "refuse", reason: "blocked" };
   if (facts.agentsState === "symlink")
@@ -5653,6 +5781,9 @@ function classifyRetrofit(facts) {
 }
 
 // src/project/roster.ts
+function instructionMode(entry) {
+  return entry.instructions ?? "hub";
+}
 function summarizeRosterDrift(input) {
   const captured = new Set((input.sourceRoots ?? []).map(normalizeRelativePath));
   const declared = /* @__PURE__ */ new Map();
@@ -5715,7 +5846,7 @@ function summarizeSymlinkPlan(facts) {
   }
   const byCanonical = /* @__PURE__ */ new Map();
   for (const f of deduped) {
-    if (f.isAnchor || !f.reachable || !f.canonicalPresent || f.canonicalName === void 0) {
+    if (f.isAnchor || f.self === true || !f.reachable || !f.canonicalPresent || f.canonicalName === void 0) {
       continue;
     }
     const repos = byCanonical.get(f.canonicalName) ?? [];
@@ -5733,6 +5864,7 @@ function summarizeSymlinkPlan(facts) {
   const plans = [];
   const conflicts = [];
   const missingCanonical = [];
+  const selfAgentsMissing = [];
   const unreachable = [];
   for (const f of deduped) {
     if (f.isAnchor) continue;
@@ -5741,7 +5873,8 @@ function summarizeSymlinkPlan(facts) {
       continue;
     }
     if (!f.canonicalPresent) {
-      missingCanonical.push(f.path);
+      if (f.self === true) selfAgentsMissing.push(f.path);
+      else missingCanonical.push(f.path);
       continue;
     }
     if (collidingPaths.has(f.path)) continue;
@@ -5768,9 +5901,10 @@ function summarizeSymlinkPlan(facts) {
     plans,
     conflicts,
     missingCanonical,
+    selfAgentsMissing,
     unreachable,
     collisions,
-    ok: plans.length === 0 && conflicts.length === 0 && missingCanonical.length === 0 && unreachable.length === 0 && collisions.length === 0
+    ok: plans.length === 0 && conflicts.length === 0 && missingCanonical.length === 0 && selfAgentsMissing.length === 0 && unreachable.length === 0 && collisions.length === 0
   };
 }
 
@@ -5781,6 +5915,7 @@ function isPublicFacing2(v) {
 function summarizeWiring(facts) {
   const risks = [];
   const unknown = [];
+  const self = [];
   const incomplete = [];
   const unreachable = [];
   for (const f of facts) {
@@ -5788,7 +5923,9 @@ function summarizeWiring(facts) {
       unreachable.push(f.path);
       continue;
     }
-    if (isPublicFacing2(f.visibility)) {
+    if (f.self === true) {
+      self.push(f.path);
+    } else if (isPublicFacing2(f.visibility)) {
       for (const file of f.instructionFiles) {
         if (file.tracked) risks.push({ repo: f.path, visibility: f.visibility, file: file.name });
       }
@@ -5802,6 +5939,7 @@ function summarizeWiring(facts) {
     repos: facts,
     risks,
     unknown,
+    self,
     incomplete,
     unreachable,
     ok: risks.length === 0 && unknown.length === 0 && unreachable.length === 0
@@ -7638,6 +7776,7 @@ export {
   PROTOCOL_END,
   PROTOCOL_START,
   RiskLevelSchema,
+  STOP_HOOK_TIMEOUT_SECONDS,
   STUCK_THRESHOLD_MS,
   SchemaVersionSchema,
   SessionIdSchema,
@@ -7665,6 +7804,7 @@ export {
   basouPaths,
   buildJsonSchemas,
   buildStatusSnapshot,
+  buildStopHookCommand,
   chainEvents,
   chainRawJsonLines,
   classifyFilesBySourceRoot,
@@ -7686,6 +7826,7 @@ export {
   enumerateTaskIds,
   evaluateStopHook,
   finalizeSessionYaml,
+  findBasouStopHookCommand,
   findErrorCode,
   findReviewGaps,
   formatDurationMs,
@@ -7694,6 +7835,8 @@ export {
   getSnapshot,
   importSessionFromJson,
   inspectChainTail,
+  instructionMode,
+  isBasouStopHookCommand,
   isGitNotFound,
   isImportDerivedSource,
   isLazyExpired,
@@ -7732,6 +7875,7 @@ export {
   refreshTaskLinkedSessions,
   reimportPreservingId,
   removeMarkerSection,
+  removeStopHook,
   renderDecisions,
   renderHandoff,
   renderOrientation,
@@ -7761,6 +7905,7 @@ export {
   ulid,
   unknownManifestKeys,
   updateTaskStatusWithEvent,
+  upsertStopHook,
   verifyEventsChain,
   writeEventsBulk,
   writeManifest,