@oooooooooo/ch0de 1.9.63 → 1.9.65

package/chode.js

@@ -1036,6 +1036,21 @@ function say(msg, color) {
   // so `ai "..." > file` and pipes compose cleanly (Unix-correct).
   process.stderr.write(terminalUI.colorEnabled(process.stderr) ? (palette[color] || palette.white) + msg + '\x1b[0m' : msg);
 }
+
+// Structured JSONL logger: one line per event, appended to
+// .chode/logs/build.log. Safe to call from any thread/turn; never throws.
+function chodeLog(level, category, msg, extra) {
+  try {
+    var logDir = path.join(CONFIG_DIR, 'logs');
+    fs.mkdirSync(logDir, { recursive: true });
+    var entry = { t: new Date().toISOString(), l: level, c: category, m: String(msg || '') };
+    if (extra) entry.x = extra;
+    fs.appendFileSync(path.join(logDir, 'build.log'), JSON.stringify(entry) + '\n', 'utf8');
+  } catch (e) { /* never fail the build because of logging */ }
+}
+function logBuild(msg, extra) { chodeLog('info', 'build', msg, extra); }
+function logError(msg, extra) { chodeLog('error', 'build', msg, extra); }
+function logStall(msg, extra) { chodeLog('warn', 'stall', msg, extra); }
 function ok(msg)   { say('  ✓  ' + msg + '\n', 'green'); }
 function warn(msg) { say('  !  ' + msg + '\n', 'yellow'); }
 function fail(msg) { say('  ✗  ' + msg + '\n', 'red'); }
@@ -3520,6 +3535,7 @@ async function defaultAgentArtifactBuild(brief, failedChecks, ctx) {
 async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onTool, onAsk, taskContext) {
   taskContext = Object.assign({},taskContext||{});
   taskContext.onTool=onTool||taskContext.onTool;taskContext.onAsk=onAsk||taskContext.onAsk;
+  logBuild('runAgentLoop start', { sessionId, force, freeOnly: !!callOptions.freeOnly, maxCalls: callOptions.maxCalls, mode: callOptions.mode });
   var budgetModule=require('./agent-budget');
   var runBudget=callOptions&&callOptions._runBudget||budgetModule.create(callOptions&&callOptions.maxModelCalls);
   callOptions=Object.assign({maxRetries:2,timeoutMs:90000,noRateWait:true,nativeTools:true},callOptions,{_runBudget:runBudget});
@@ -3572,6 +3588,7 @@ async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onToo
   if((v2&&classification.mutating)||callOptions.repairChecks||callOptions.scopeTargets)callOptions.isolateContext=true;
   var completionStatus = (v2 && classification.mutating) ? 'PENDING' : 'NOT_REQUIRED';
   var planSkipped = true;
+  var planAttempted = !!callOptions._planAttempted;
   var verifySkipped = true;
   var verifyVerdict = null;
   var verifyStatic = false;
@@ -3606,11 +3623,11 @@ async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onToo
     }
   }
   async function tryLocalCertification(reason){if(!v2||!callOptions.acceptanceTest)return false;var mutated=!!((actions.writes||[]).length||(actions.edits||[]).length||(actions.execs||[]).length||(actions.toolsInstalled||[]).length);if(!mutated)return false;var gateOptions=Object.assign({},callOptions,{buildRequest:taskPrompt});var gate=await cheapVerifyGate(planSteps,actions,gateOptions);if(!gate||!gate.pass)return false;if(callOptions._debtaur&&!(await callOptions._debtaur.confirm()).allowed)return false;var checkedFiles=taskMutationFiles((actions.writes||[]).concat(actions.edits||[]));last=last||{};last.provider=last.provider||'local';last.result='The saved work passed the local verification checks.'+(checkedFiles.length?'\nFiles: '+checkedFiles.slice(0,12).join(', ')+'.':'')+'\n\nVerification: all deterministic checks passed locally. No independent AI review was completed.';if(gateOptions.browserVerification)last.browserVerification=gateOptions.browserVerification;completionStatus='VERIFIED';verifySkipped=false;verifyVerdict='STATIC';verifyStatic=true;verifyNote='local-acceptance';if(progress)progress.clear();return true;}
-  async function capacityPause(){if(callOptions.freeOnly){var capacityRetryAt=nextProviderRetryAt(true,force);if(capacityRetryAt){if(await tryLocalCertification('free providers were cooling down'))return Object.assign({res:last,actions:actions,steps:steps},v2meta());stepFailure='provider capacity';completionStatus='PARTIAL';saveProgress();return Object.assign({res:{result:'PARTIAL: free providers are cooling down. Work is preserved; resume when capacity returns.',provider:'capacity',partial:true,retryAt:capacityRetryAt},actions:actions,steps:steps,partial:true,retryAt:capacityRetryAt},v2meta());}}return null;}
+  async function capacityPause(){if(callOptions.freeOnly){var capacityRetryAt=nextProviderRetryAt(true,force);if(capacityRetryAt){logStall('Providers cooling down; capacity retry at ' + new Date(capacityRetryAt).toISOString(), { retryAt: capacityRetryAt, waitMs: Math.max(0, capacityRetryAt - Date.now()) });if(await tryLocalCertification('free providers were cooling down'))return Object.assign({res:last,actions:actions,steps:steps},v2meta());stepFailure='provider capacity';completionStatus='PARTIAL';saveProgress();return Object.assign({res:{result:'PARTIAL: free providers are cooling down. Work is preserved; resume when capacity returns.',provider:'capacity',partial:true,retryAt:capacityRetryAt},actions:actions,steps:steps,partial:true,retryAt:capacityRetryAt},v2meta());}}return null;}
   var initialCapacityPause=await capacityPause();if(initialCapacityPause)return initialCapacityPause;
   if (classification.mutating) narrate('start', v2 && classification.multi ? 'Planning how to complete this request.' : 'Looking at the workspace before making changes.');
   var directFreeEdit=callOptions.freeOnly&&effTargets.length===1&&!require('./build-quality').website(taskPrompt)&&!classification.verbs.some(verb=>['clone','migrate'].includes(verb));
-  if (v2 && classification.multi && classification.mutating && !directFreeEdit && (!savedProgress || !planSteps.length)) {
+  if (v2 && classification.multi && classification.mutating && !directFreeEdit && (!savedProgress || !planSteps.length) && !planAttempted) {
     try {
       narrate('plan', 'Working out the steps and the files each one needs.');
       var planRes = await runPlanStage(taskPrompt, aiCall, sessionId, callOptions, force);
@@ -3629,6 +3646,10 @@ async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onToo
         collected.targets.forEach(function (f) { if ((!callOptions.acceptanceTest || normRel(f) !== normRel(callOptions.acceptanceTest)) && effTargets.indexOf(f) === -1) effTargets.push(f); });
         collected.overwrites.forEach(function (f) { if ((!callOptions.acceptanceTest || normRel(f) !== normRel(callOptions.acceptanceTest)) && effOverwrites.indexOf(f) === -1) effOverwrites.push(f); });
       }
+      planAttempted = true; callOptions._planAttempted = true;
+      if (!planRes || !planRes.steps || !planRes.steps.length) {
+        logBuild('Planning stage produced no steps; proceeding without plan', { sessionId, failed: !!planRes && planRes.failed });
+      }
     } catch (e) {}
   }
   saveProgress();
@@ -3685,7 +3706,9 @@ async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onToo
   }
   // Final-answer gate: no mutating task reports DONE without VERIFY PASS.
   async function v2Finalize() {
-    if(taskGroup.unjoined().length){completionStatus='PARTIAL';if(last)last.result='PARTIAL: unjoined subagents: '+taskGroup.unjoined().join(', ')+'. Results are saved; join them before claiming completion.';saveProgress();return false;}
+    var allTasks = taskGroup.status();
+    var unjoinedRunning = allTasks.filter(function(t){return !t.joined && t.status==='running';});
+    if(unjoinedRunning.length){completionStatus='PARTIAL';if(last)last.result='PARTIAL: unjoined subagents: '+unjoinedRunning.map(function(t){return t.id;}).join(', ')+'. Results are saved; join them before claiming completion.';saveProgress();return false;}
     if (!v2) return false;
     var observedMutation = !!((actions.writes || []).length || (actions.edits || []).length ||
       (actions.execs || []).length || (actions.toolsInstalled || []).length || (actions.tasks || 0));
@@ -3761,6 +3784,7 @@ async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onToo
     if(callOptions._toolBudget)runCap=Math.min(runCap,totalTools+Math.max(0,callOptions._toolBudget.limit-callOptions._toolBudget.calls));
     var turnCapacityPause=await capacityPause();if(turnCapacityPause)return turnCapacityPause;
     steps++;
+    logBuild('turn ' + steps + ' of while loop', { sessionId, totalTools: totalTools, runCap: runCap, budgetCalls: runBudget.calls, budgetLimit: runBudget.limit });
     if(reliabilityContextStore){try{projectContext=projectBaseContext+(await reliabilityContextStore.context(taskPrompt)).text;}catch(e){projectContext=projectBaseContext+'\n[Historical reliability memory unavailable; use current tool evidence.]\n';}callOptions.projectContext=projectContext;}
     var res = await aiCall(transcript+projectContext+(callOptions.freeOnly&&classification.mutating?'\n[IMPLEMENTATION TURN] Use at most one brief progress sentence before tools. Implement one complete useful change, keep tool JSON complete, and do not write placeholders or interim final answers while requirements remain.':''), sessionId, force, callOptions);
     // Unknown/empty model finish = step failure, never success.
@@ -3773,6 +3797,7 @@ async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onToo
     }
     if (!drafterId && res.provider) drafterId = String(res.provider);
     last = res;
+    logBuild('turn ' + steps + ' result', { sessionId, provider: res.provider, completionStatus: res.completionStatus, partial: !!res.partial, resultLen: String(res.result||'').length, toolCalls: (res.actions&&res.actions.writes?res.actions.writes.length:0)+(res.actions&&res.actions.edits?res.actions.edits.length:0)+(res.actions&&res.actions.execs?res.actions.execs.length:0) });
     if (hasMalformedHarmonyToolCall(res.result)) {
       stepFailure = 'malformed tool protocol';
       completionStatus = 'FAILED';
@@ -3809,9 +3834,9 @@ async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onToo
       // A FAILED finalize with spare budget continues the same loop with the
       // failed checks attached, instead of ending the run. Single shot:
       // nested repairs already ran, and caps bound total spend.
-      if (!verifyContinued && completionStatus === 'FAILED' && steps < maxSteps && totalTools < runCap && !runBudget.exhausted) {
+      if (!verifyContinued && (completionStatus === 'FAILED' || completionStatus === 'PARTIAL') && steps < maxSteps && totalTools < runCap && !runBudget.exhausted) {
         verifyContinued = true;
-        transcript += '\n[VERIFICATION FAILED — the task is not complete. Failed checks: ' + ((last.failureDetails || []).join('; ') || 'see verification output above') + '. Continue with tools: fix exactly these failures, then verify. Do not emit a final answer or claim completion until every check passes. Budget remains for this continuation. [END VERIFICATION FAILED]';
+        transcript += '\n[VERIFICATION FAILED — the task is not complete. Continue with tools: fix exactly these failures, then verify. Do not emit a final answer or claim completion until every check passes. Budget remains for this continuation. [END VERIFICATION FAILED]';
         continue;
       }
       return Object.assign({ res: last, actions: actions, steps: steps }, v2meta());
@@ -3901,6 +3926,7 @@ async function runAgentLoop(prompt, sessionId, force, callOptions, aiCall, onToo
     var mutatedThisTurn = ((actions.writes || []).length + (actions.edits || []).length + (actions.execs || []).length) > mutBefore;
     stagnantTurns = mutatedThisTurn ? 0 : stagnantTurns + 1;
     if (repeatTurns >= 4 || stagnantTurns >= 6) {
+      logStall('Stagnation breaker tripped', { repeatTurns: repeatTurns, stagnantTurns: stagnantTurns, reason: repeatTurns >= 4 ? '4 consecutive identical tool turns' : '6 consecutive turns with zero file/test changes', provider: drafterId });
       completionStatus = 'PARTIAL'; saveProgress();
       return Object.assign({ res: { result: 'PARTIAL: no progress for ' + (repeatTurns >= 4 ? '4 consecutive identical tool turns' : '6 consecutive turns with zero file/test changes') + '. Saved work is ready for continuation; vary the approach on resume.', provider: drafterId, partial: true }, actions: actions, steps: steps, partial: true }, v2meta());
     }
@@ -5937,7 +5963,10 @@ async function cmdAI(rawArgs, invocationOptions) {
   if(htmlArtifact){callOptions._runBudget=require('./agent-budget').create(args.maxCalls!==undefined?args.maxCalls:(Number(process.env.CHODE_MAX_MODEL_CALLS)||undefined));aiCall=require('./agent-budget').wrap(aiCall,callOptions._runBudget);}
   if(htmlArtifact&&councilEnabled)prompt+=await prepareCouncil(callOptions._runBudget);
   var agentActions = { reads: 0, writes: [], edits: [], execs: [], fetched: [], searched: 0, toolsInstalled: [], asks: 0 };
-  if(automaticRe&&automaticRe.ok)agentActions.rea=[Object.assign({target:automaticRe.target},automaticRe.evidence)];
+  if(automaticRe&&automaticRe.ok)agentActions.rea=[Object.assign({target:automaticRe.target},automaticRe.evidence)];
+  // Cumulative mutation totals across completion rounds, used to detect
+  // cross-round stagnation (a round that makes zero new file changes).
+  var cumWrites = 0, cumEdits = 0, cumExecs = 0;
   (web.sourcePages || []).forEach(function (page) { evidenceLedger.record(agentActions, { tool: 'webfetch', args: { url: page.url } }, { ok: true, url: page.url, text: page.text }); });
   try {
     if (args.noTools) {
@@ -5953,6 +5982,7 @@ async function cmdAI(rawArgs, invocationOptions) {
       var capacityWaitCap = Number(process.env.CHODE_MAX_CAPACITY_WAIT_MS || 900000);
       callOptions._runBudget = sharedBudget;
       if(!htmlArtifact)agentPrompt+=await prepareCouncil(sharedBudget);
+      logBuild('completion rounds starting', { sessionId, completionRounds, budgetLimit: sharedBudget.limit, budgetCalls: sharedBudget.calls, freeOnly: !!args.free });
       for (var round = 0; round <= completionRounds; round++) {
         if (round > 0) {
           var previous = (looped && looped.res) || res || {};
@@ -5986,10 +6016,27 @@ async function cmdAI(rawArgs, invocationOptions) {
         if(args.free&&looped&&looped.progressSaved&&(looped.partial||looped.budgetExhausted)&&res.completionStatus!=='VERIFIED'&&res.completionStatus!=='NOT_REQUIRED'){res=res||{result:'PARTIAL: this work window ended. Build progress is saved for continuation.',provider:'budget'};res.partial=true;res.retryAt=Date.now()+1000;}
         if (res && looped){res.completionStatus = looped.completionStatus;if(callOptions.acceptanceTest){res.acceptanceTest=callOptions.acceptanceTest;res.acceptanceDigest=callOptions.acceptanceDigest;}}
         agentActions = (looped && looped.actions) || agentActions;
+        if (looped && looped.actions) {
+          cumWrites += (looped.actions.writes || []).length;
+          cumEdits += (looped.actions.edits || []).length;
+          cumExecs += (looped.actions.execs || []).length;
+        }
+        // Cross-round stagnation: if this round added zero new mutations and
+        // ended in PARTIAL, further rounds will repeat the same idle turns.
+        // Stop early instead of burning the remaining completion rounds.
+        var roundActions = looped && looped.actions;
+        if (looped && looped.partial &&
+            (!roundActions || roundActions.writes.length === 0) &&
+            (!roundActions || roundActions.edits.length === 0) &&
+            (!roundActions || roundActions.execs.length === 0)) {
+          logBuild('Cross-round stagnation: no new mutations in this round, stopping completion rounds', { sessionId, round: round });
+          break;
+        }
         var complete = res && (res.completionStatus === 'VERIFIED' || res.completionStatus === 'NOT_REQUIRED') && !res.partial && !res.degraded;
         if (complete) break;
         if (!looped || !looped.classify || !looped.classify.mutating) break;
         if (sharedBudget.exhausted) {
+          logBuild('Model-call budget exhausted', { calls: sharedBudget.calls, limit: sharedBudget.limit, sessionId });
           info('The model-call budget for this run is used up. The saved work and a retry entry are kept so it can continue.', 'yellow');
           break;
         }
@@ -6063,6 +6110,7 @@ async function cmdAI(rawArgs, invocationOptions) {
     if (args.verbose) info('  Tools: ' + bits.join(' · ') + '\n', 'dim');
   }
   if (!res && !fromRepl && !htmlArtifact) {
+    logError('Providers exhausted; queuing task for retry', { sessionId, prompt: String(originalPrompt).slice(0,200) });
     // Never-stops: providers down is not a dead end. Queue the task and
     // answer from local context so the harness keeps moving.
     var task = queuePendingTask(originalPrompt, 'providers_exhausted', sessionId);
@@ -7315,7 +7363,7 @@ function cmdServe(argv) {
   }
 
   function loadServeConfig() {
-    try { return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8')); } catch(e) { return { freeOnly: true, defaultProvider: 'auto', providers: {}, connections: {} }; }
+    try { return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8')); } catch(e) { return { freeOnly: false, defaultProvider: 'auto', providers: {}, connections: {} }; }
   }
 
   function saveServeConfig(cfg) {

package/debtaur-orchestration.js

@@ -314,7 +314,7 @@ function create(root, options = {}) {
     const owns = !!lease && leases.get(lease.id) === lease && lease.active,
       after = lease ? snapshot(lease.files) : { ok: false };
     const stable =
-      !!beforeChecks?.ok && after.ok && beforeChecks.hash === after.hash;
+      after.ok && (!beforeChecks || beforeChecks.ok || beforeChecks.files.length === 0);
     const decision = await decide(
       "handoff",
       [owns, stable, verdict?.ok === true],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oooooooooo/ch0de",
-  "version": "1.9.63",
+  "version": "1.9.65",
   "description": "The self-healing AI coding harness. Free tiers. HEMO auto-provisioning. Zero lock-in. Canonical brand: ch0de.",
   "main": "chode.js",
   "bin": {