@link-assistant/hive-mind 1.56.0 → 1.56.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @link-assistant/hive-mind
 
+## 1.56.1
+
+### Patch Changes
+
+- 32035a2: Issue #1651: When fork-parent auto-recovery tries to delete the mismatched
+  fork and the GitHub CLI token is missing the `delete_repo` scope, `solve`
+  now prints the real remediation (`gh auth refresh -h github.com -s delete_repo`)
+  plus a non-destructive alternative (rename/archive + `--prefix-fork-name-with-owner-name`)
+  instead of re-recommending the same `gh repo delete` command that just failed.
+  In `--verbose` mode the full `gh` output is also printed so future root-cause
+  analyses have the diagnostic lines GitHub already provides.
+
+  Pre-PR failures that are posted back to GitHub issues now use user-facing
+  guidance: they ask the issue reporter to fix repository/account state when
+  possible or ask a Hive Mind administrator to handle the affected repository,
+  while keeping administrator CLI details in the terminal log instead of the
+  public issue comment.
+
 ## 1.56.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.56.0",
+  "version": "1.56.1",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",

package/src/github.lib.mjs

@@ -21,6 +21,18 @@ export { buildCostInfoString };
 import { SOLUTION_DRAFT_LOG_MARKER, SOLUTION_DRAFT_FAILED_MARKER, SOLUTION_DRAFT_FINISHED_WITH_ERRORS_MARKER, USAGE_LIMIT_REACHED_MARKER, NOW_WORKING_SESSION_IS_ENDED_MARKER, postTrackedComment, postTrackedCommentFromFile } from './tool-comments.lib.mjs';
 export const maskGitHubToken = maskToken; // Alias for backward compatibility
 export const escapeCodeBlocksInLog = logContent => logContent.replace(/```/g, '\\`\\`\\`'); // Escape ``` in logs
+const buildIssueFailureActionSection = targetType => {
+  if (targetType !== 'issue') return '';
+
+  return `
+
+### What you can do
+- Resolve the repository, account, permissions, or environment problem described above, then rerun the solver.
+- If this requires elevated Hive Mind access, ask a Hive Mind administrator to handle the specific failure described above.
+- Repository deletion can require a separate GitHub account or token with repository deletion permission; Hive Mind does not rely on that permission by default.
+
+Administrator-only CLI details, if any, are printed in the solver terminal log rather than in this issue comment.`;
+};
 export const checkFileInBranch = async (owner, repo, fileName, branchName) => {
   const { $ } = await use('command-stream');
 
@@ -486,7 +498,7 @@ ${footerNote}`;
 The automated solution draft encountered an error:
 \`\`\`
 ${errorMessage}
-\`\`\`${modelInfoString}
+\`\`\`${buildIssueFailureActionSection(targetType)}${modelInfoString}
 
 <details>
 <summary>Click to expand failure log (${Math.round(logStats.size / 1024)}KB)</summary>
@@ -675,7 +687,7 @@ ${uploadFooterNote}`;
 The automated solution draft encountered an error:
 \`\`\`
 ${errorMessage}
-\`\`\`${modelInfoString}
+\`\`\`${buildIssueFailureActionSection(targetType)}${modelInfoString}
 
 ### 📎 **Failure log uploaded as ${uploadTypeLabel}${chunkInfo}** (${Math.round(logStats.size / 1024)}KB)
 - [View complete failure log](${logUrl})

package/src/solve.pre-pr-failure-notifier.lib.mjs

@@ -8,6 +8,26 @@ const truncate = (value, maxLength = 2000) => {
 
 const fence = value => truncate(value || 'Unknown error').replaceAll('```', '` ` `');
 
+export function buildPrePullRequestFailureActionSection(reason = '') {
+  const normalizedReason = String(reason || '').toLowerCase();
+  const isForkOrRecoveryFailure = normalizedReason.includes('fork') || normalizedReason.includes('auto-recovery') || normalizedReason.includes('repository setup');
+
+  if (isForkOrRecoveryFailure) {
+    return `### What you can do
+- If the affected fork or repository belongs to you, remove, rename, archive, initialize, or otherwise repair it in GitHub, then rerun the solver.
+- If the action requires elevated Hive Mind access, ask a Hive Mind administrator to handle the affected fork or repository and rerun the solver.
+- Repository deletion can require a separate GitHub account or token with repository deletion permission; Hive Mind does not rely on that permission by default.
+
+Administrator-only CLI details, if any, are printed in the solver terminal log rather than in this issue comment.`;
+  }
+
+  return `### What you can do
+- Resolve the repository, account, permissions, or environment problem described above, then rerun the solver.
+- If this requires elevated Hive Mind access, ask a Hive Mind administrator to handle the specific failure described above.
+
+Administrator-only CLI details, if any, are printed in the solver terminal log rather than in this issue comment.`;
+}
+
 export function shouldNotifyIssueAboutPrePullRequestFailure({ code, globalState }) {
   if (code === 0) return false;
   if (!globalState?.issueNumber || !globalState?.owner || !globalState?.repo) return false;
@@ -16,18 +36,11 @@ export function shouldNotifyIssueAboutPrePullRequestFailure({ code, globalState
   return getTrackedToolCommentIds().size === 0;
 }
 
-export function buildPrePullRequestFailureComment({ reason, owner, repo, issueNumber, argv = {}, rawCommand = null, logAttachmentAttempted = false }) {
+export function buildPrePullRequestFailureComment({ reason, owner, repo, issueNumber, argv = {}, logAttachmentAttempted = false }) {
   const tool = argv.tool || 'claude';
   const modelLine = argv.model ? `\n- **Requested model**: \`${argv.model}\`` : '';
-  const commandBlock = rawCommand
-    ? `
-
-### Command
-\`\`\`bash
-${fence(rawCommand)}
-\`\`\``
-    : '';
   const logLine = logAttachmentAttempted ? 'Log attachment was attempted but failed. Check the solver terminal log for the complete failure output.' : 'Logs were not attached because `--attach-logs` was not enabled.';
+  const actionSection = buildPrePullRequestFailureActionSection(reason);
 
   return `## 🚨 ${SOLUTION_DRAFT_FAILED_MARKER}
 
@@ -41,11 +54,12 @@ The automated solver stopped before creating a pull request, so no PR was opened
 **Reason**
 \`\`\`text
 ${fence(reason)}
-\`\`\`${commandBlock}
+\`\`\`
 
-${logLine}
+${actionSection}
 
-Please resolve the reported problem and rerun the solve command.`;
+${logLine}
+`;
 }
 
 export async function notifyIssueAboutPrePullRequestFailure(options) {

package/src/solve.repository.lib.mjs

@@ -553,8 +553,9 @@ export const setupRepository = async (argv, owner, repo, forkOwner = null, issue
         if (deleteResult.code !== 0) {
           const delOut = (deleteResult.stderr?.toString() || '') + (deleteResult.stdout?.toString() || '');
           await log(`${formatAligned('❌', 'Delete failed:', delOut.split('\n')[0])}`, { level: 'error' });
-          await log(`  💡 Manual fix: gh repo delete ${existingForkName} --yes, then re-run`);
-          await safeExit(1, 'Auto-recovery failed - could not delete problematic repository');
+          await log(/delete_repo/i.test(delOut) || (/HTTP 403/.test(delOut) && /admin rights/i.test(delOut)) ? `  💡 Token missing "delete_repo" scope. Hive Mind does not request it by default. Admin fix: gh auth refresh -h github.com -s delete_repo\n  🔧 Or no-scope alternative: gh repo rename ${existingForkName} ${existingForkName.split('/')[1]}-old (or gh repo archive ${existingForkName} --yes), then re-run with --prefix-fork-name-with-owner-name` : `  💡 Manual fix: gh repo delete ${existingForkName} --yes, then re-run`); // Issue #1651
+          if (argv.verbose) await log(`${formatAligned('🔧', 'Full delete output:', delOut.trim())}`);
+          await safeExit(1, `Auto-recovery failed - ask the fork owner or Hive Mind administrator to delete, rename, or archive ${existingForkName}`);
         }
         await log(`${formatAligned('✅', 'Deleted:', existingForkName)}`);
         existingForkName = null; // Fall through to fork creation below