@tea-agent/loop-agent 0.43.0-next.8 → 0.43.0

package/README.md

@@ -126,6 +126,13 @@ agent-worker console doctor --repo .
 
 ```
 
+Console Chat 支持直接用自然语言预约工作流，例如：“请预约3分钟后检查当前项目的Git状态，汇总修改文件，不修改业务文件，结果发回当前对话。”服务在当前项目目录准备任务，生成真实预约卡；核对时间、范围和验收后点击“确认预约”，后台执行并把结果关联回原对话。相对延时从准备完成起算，以卡片显示的准确时间为准。预约要求当前目录与已提交 HEAD 一致，确认后若基线或文件变化则停止启动；执行产生的改动留在当前目录，无需另行合并。测试类报告交付可以包含业务失败，不等同于全部用例通过。取消停止后续启动，已执行事实与报告保留。
+
+预约任务的完整列表与验收详情位于 **Console → 观测 → 定时任务**；Chat保留简洁确认卡和「查看执行」入口。
+
+预约由 Console 进程持有，关闭浏览器不停止后台工作；退出 Console、系统休眠或断电不能保证准点执行。需要夜间运行时，由当前用户的 OS 服务管理器保持 Console 可用，使用固定版本和明确的工作目录/环境，避免运行期间升级。恢复后按冻结的最晚启动、授权到期和错过时间策略处理；未知运行不会自动重发。目标项目 `init` 不安装服务，也不复制凭据。
+
+
 裸 `agent-worker console` 不在终端询问升级。操作 → 设置提供非阻塞的「更新并初始化」入口，默认选择 npm `latest` 稳定版，也可由操作者显式选择 `next` 预发布版；更新前会先检查活跃运行和全局安装来源。`console doctor`、帮助和版本命令均不触发更新检查。
 
 访问 Console <http://127.0.0.1:8790/>；**Operator Chat Official** 是 Console 内的主引导交互，默认打开「对话」工作区。构建时设置 `VITE_OPERATOR_CHAT_DEFAULT_LANDING=tasks` 可改回 Tasks；URL hash（`#/tasks`）与 localStorage 仍优先于默认值。顶部「检视」以及 `/inspect/` 提供只读 Dashboard、DAG、时间线与 artifacts；`loop-agent …` / `agent-worker …` CLI direct path 仍是受治理 fallback。当前状态为 **code ready, dogfood pending/unmet**，不宣称已替代 openCode 或其他外部主会话。

package/dist/application/dag/args.js

@@ -34,6 +34,8 @@ export function parseDagRunTaskArgs(args, defaultCwd) {
     let profileExplicit = false;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--output" || arg === "-o") {
             outputPath = args[++i];
             if (!outputPath) {
@@ -165,6 +167,8 @@ export function parseDagValidateArgs(args) {
     let spineTaskId;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--dag") {
             dagPath = args[++i];
             if (!dagPath) {
@@ -264,6 +268,8 @@ export function parseRunDagArgs(args, defaultCwd) {
     let workerAssociation;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--dag") {
             dagPath = args[++i];
         }
@@ -398,6 +404,8 @@ export function parseDagReportArgs(args) {
     let action;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--run-id") {
             runId = args[++i];
             continue;

package/dist/application/task-lifecycle/advance.js

@@ -271,6 +271,17 @@ function nextMutationAction(actions) {
     }
     return actions[0] ?? null;
 }
+/**
+ * True when a create-task step lost a create race: `createTask` refuses an id
+ * that another writer created between our lifecycle snapshot and the create
+ * call. That is not a failure of intent (the id exists), so the advance
+ * re-observes instead of aborting — Console issues `newTask` and `importPrd`
+ * back to back and used to lose the whole intake when newTask landed first.
+ */
+export function isConcurrentTaskCreateError(taskId, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.startsWith(`task already exists: ${taskId}`);
+}
 export async function advanceTaskLifecycle(input) {
     const completed = [];
     const blockers = [];
@@ -507,13 +518,24 @@ export async function advanceTaskLifecycle(input) {
         }
         if (action.type === "create-task") {
             if (!snapshot.exists) {
-                await createTask(input.repoRoot, input.taskId, input.title, {
-                    taskKind: input.taskKind,
-                    taskKindExplicit: input.taskKindExplicit,
-                });
-                record = appendTransition(record, "task-created");
-                completed.push("task-created");
-                await saveLifecycleRecord(input.repoRoot, record);
+                try {
+                    await createTask(input.repoRoot, input.taskId, input.title, {
+                        taskKind: input.taskKind,
+                        taskKindExplicit: input.taskKindExplicit,
+                    });
+                    record = appendTransition(record, "task-created");
+                    completed.push("task-created");
+                    await saveLifecycleRecord(input.repoRoot, record);
+                }
+                catch (error) {
+                    // Lost create race: a concurrent writer (Console `newTask`
+                    // issued alongside `importPrd`) created the same id between
+                    // our snapshot and this call. The intent — this id exists and
+                    // carries this PRD — is already satisfied, so fall through to
+                    // the re-observe below instead of failing the advance.
+                    if (!isConcurrentTaskCreateError(input.taskId, error))
+                        throw error;
+                }
             }
             snapshot = await observeTaskLifecycle(input.repoRoot, input.taskId);
             continue;
@@ -663,6 +685,9 @@ export async function advanceTaskLifecycle(input) {
                     allowedPaths: effectiveInput.allowedPaths,
                     forbiddenPaths: input.forbiddenPaths,
                     verifyCommands: effectiveInput.verifyCommands,
+                    requirementOwnership: effectiveInput.requirementOwnership,
+                    capabilityBoundary: effectiveInput.capabilityBoundary,
+                    interactionIds: effectiveInput.interactionIds,
                     backendTest: input.backendTest,
                 },
                 ...(sourceFidelity ? { sourceFidelity } : {}),
@@ -720,6 +745,9 @@ export async function advanceTaskLifecycle(input) {
                                 allowedPaths: effectiveInput.allowedPaths,
                                 forbiddenPaths: input.forbiddenPaths,
                                 verifyCommands: effectiveInput.verifyCommands,
+                                requirementOwnership: effectiveInput.requirementOwnership,
+                                capabilityBoundary: effectiveInput.capabilityBoundary,
+                                interactionIds: effectiveInput.interactionIds,
                                 backendTest: input.backendTest,
                             },
                         });
@@ -741,6 +769,9 @@ export async function advanceTaskLifecycle(input) {
                                     allowedPaths: effectiveInput.allowedPaths,
                                     forbiddenPaths: input.forbiddenPaths,
                                     verifyCommands: effectiveInput.verifyCommands,
+                                    requirementOwnership: effectiveInput.requirementOwnership,
+                                    capabilityBoundary: effectiveInput.capabilityBoundary,
+                                    interactionIds: effectiveInput.interactionIds,
                                     backendTest: input.backendTest,
                                 },
                                 ...(sourceFidelity ? { sourceFidelity } : {}),

package/dist/build-stamp.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.43.0-next.8",
-  "gitSha": "83a946a1ce0daefa0f6c24796930dd9c96d69cba",
-  "builtAt": "2026-09-09T11:34:05.307Z"
+  "version": "0.43.0",
+  "gitSha": "0765d0a560eacc5719265999838fc71826f233a0",
+  "builtAt": "2026-09-14T01:41:52.345Z"
 }

package/dist/cli/command-definitions.js

@@ -67,6 +67,8 @@ export function formatSubcommandUsageError(name, subcommands) {
 export function parseSummaryFlag(tokens) {
     for (let i = 0; i < tokens.length; i += 1) {
         const token = tokens[i];
+        if (token === undefined)
+            continue;
         if (token === "--summary") {
             return tokens[i + 1];
         }

package/dist/cli/program.js

@@ -96,7 +96,7 @@ function commandChain(command) {
 async function dispatchRegisteredCommand(commandObject, defaultRepoRoot, rawArgs) {
     const chain = commandChain(commandObject);
     const command = chain[0] ?? "";
-    const [subcommand, ...rest] = chain.length <= 1 ? rawArgs : [chain[1], ...chain.slice(2), ...rawArgs];
+    const [subcommand, ...rest] = chain.length <= 1 ? rawArgs : [chain[1] ?? "", ...chain.slice(2), ...rawArgs];
     const options = collectGlobalOptions(commandObject);
     const quiet = (command === "doctor" &&
         [...rest, ...rawArgs].some((token) => token === "--json")) ||
@@ -397,6 +397,8 @@ function compactArgs(args) {
 function parsePlanSummaryFlag(tokens) {
     for (let i = 0; i < tokens.length; i += 1) {
         const token = tokens[i];
+        if (token === undefined)
+            continue;
         if (token === "--summary") {
             return tokens[i + 1];
         }

package/dist/cli/update/init-surface-notifier.js

@@ -136,6 +136,8 @@ export function resolveInitSurfaceRepoRoot(argv, defaultRepoRoot) {
     let selected = defaultRepoRoot;
     for (let index = 0; index < argv.length; index += 1) {
         const arg = argv[index];
+        if (arg === undefined)
+            break;
         if (arg === "--repo-root") {
             const value = argv[index + 1];
             if (value && !value.startsWith("-"))

package/dist/cli/update/policy.js

@@ -81,6 +81,8 @@ export function evaluateLatestVersion(input) {
 function firstCommand(argv) {
     for (let index = 0; index < argv.length; index += 1) {
         const arg = argv[index];
+        if (arg === undefined)
+            break;
         if (GLOBAL_VALUE_FLAGS.has(arg)) {
             index += 1;
             continue;

package/dist/commands/client-recovery.js

@@ -18,6 +18,7 @@ export const BACKOFF_MS = [2000, 4000, 8000, 16000, 30000];
 export const MAX_SESSION_RETRIES = 5;
 /** Hard cap for OpenCode overflow compact+resume recoveries (≤ 2). */
 export const MAX_OVERFLOW_RECOVERIES = 1;
+import { buildGeneratedTransientProviderClassifierSource, classifyTransientProviderError, } from "../shared/pi-provider-recovery.js";
 import { PI_RECOMMENDED_COMPACTION, PI_RECOMMENDED_RETRY, } from "../shared/pi-retry-settings.js";
 import { CONTEXT_OVERFLOW_PHRASES, buildGeneratedOverflowClassifierSource, isContextOverflow as classifySharedOverflow, } from "../shared/pi-context-pressure/overflow.js";
 export { PI_RECOMMENDED_COMPACTION, PI_RECOMMENDED_RETRY };
@@ -51,17 +52,6 @@ const PERMANENT_MESSAGE_PATTERNS = [
         pattern: /\b(business validation|invalid task|schema validation)\b/i,
     },
 ];
-const TRANSIENT_MESSAGE_PATTERNS = [
-    /\bcode[:\s]*502\b/i,
-    /\b502\b/,
-    /\bLLMRequestError\b/i,
-    /\bnetwork fluctuation\b/i,
-    /\btimeout\b/i,
-    /\btransient provider failure\b/i,
-    /\bnon-standard (payload|response)\b/i,
-    /\bupstream returned\b/i,
-    /\bmodel processing timeout\b/i,
-];
 export function isClientRecoveryMode(value) {
     return (typeof value === "string" &&
         CLIENT_RECOVERY_MODES.includes(value));
@@ -172,30 +162,16 @@ export function isContextOverflow(error) {
     return classifySharedOverflow(error);
 }
 function looksTransient(error) {
-    const text = collectErrorText(error);
-    if (TRANSIENT_MESSAGE_PATTERNS.some((pattern) => pattern.test(text)))
-        return true;
-    if (error && typeof error === "object") {
-        const record = error;
-        if (record.code === 502 || record.status === 502)
-            return true;
-        if (record.data && typeof record.data === "object") {
-            const data = record.data;
-            if (data.code === 502 || data.status === 502)
-                return true;
-        }
-    }
-    return false;
+    return classifyTransientProviderError(error).retryable;
 }
 /**
  * Decide whether an OpenCode error should be resumed by the project plugin.
- * Only compensates transient UnknownError paths that built-in APIError retry misses.
+ * Compensates wrapped UnknownError / TypeValidation failures and known stripped
+ * internal-provider fluctuation messages that built-in APIError retry misses.
  *
- * TypeValidation bypass: a bare TypeValidationError (provider/SDK surfaces
- * zod invalid_union directly, without the UnknownError wrapper) is treated as
- * a retryable transient-unknown-error ONLY when it also carries a transient
- * signal (502 / LLMRequestError / timeout / etc.). A pure schema mismatch
- * without a transient signal is still rejected (resumable: false).
+ * The historical success reason remains `transient-unknown-error` for report
+ * compatibility. A pure schema mismatch without a transient signal is still
+ * rejected (resumable: false).
  */
 export function classifyTransientUnknownError(error) {
     const permanent = permanentReason(error);
@@ -208,6 +184,9 @@ export function classifyTransientUnknownError(error) {
     }
     const isUnknownShape = hasUnknownErrorShape(error);
     const isTypeValidationShape = hasTypeValidationShape(error);
+    if (looksTransient(error)) {
+        return { resumable: true, reason: "transient-unknown-error" };
+    }
     if (!isUnknownShape && !isTypeValidationShape) {
         return {
             resumable: false,
@@ -215,14 +194,11 @@ export function classifyTransientUnknownError(error) {
             interaction: PERMANENT_ERROR_INTERACTION,
         };
     }
-    if (!looksTransient(error)) {
-        return {
-            resumable: false,
-            reason: "unknown-non-transient",
-            interaction: PERMANENT_ERROR_INTERACTION,
-        };
-    }
-    return { resumable: true, reason: "transient-unknown-error" };
+    return {
+        resumable: false,
+        reason: "unknown-non-transient",
+        interaction: PERMANENT_ERROR_INTERACTION,
+    };
 }
 export function nextBackoffMs(attempt) {
     if (!Number.isInteger(attempt) ||
@@ -478,8 +454,9 @@ export function buildOpenCodeTransientRetryPluginSource() {
  * loop-agent OpenCode transient recovery plugin
  * Path: ${OPENCODE_TRANSIENT_RETRY_PLUGIN_PATH}
  *
- * Compensates transient UnknownError cases that OpenCode built-in APIError
- * retry does not cover. Never runs concurrently with session.status === "retry".
+ * Compensates wrapped UnknownError / TypeValidation failures and known
+ * stripped internal-provider fluctuation messages that OpenCode built-in
+ * APIError retry does not cover. Never runs concurrently with session.status === "retry".
  * Permanent failures use interaction "${PERMANENT_ERROR_INTERACTION}".
  * User aborts (MessageAbortedError / cancel words) are silently cleared.
  * Best-effort file log: ${OPENCODE_TRANSIENT_RETRY_LOG_PATH}.
@@ -502,7 +479,7 @@ const LOG_PATH = (() => {
 const PERMANENT_INTERACTION = ${JSON.stringify(PERMANENT_ERROR_INTERACTION)};
 const BACKOFF_MS = ${JSON.stringify([...BACKOFF_MS])};
 const MAX_RETRIES = ${MAX_SESSION_RETRIES};
-${buildGeneratedContextOverflowPatternSource()}
+${buildGeneratedTransientProviderClassifierSource()}
 void logToFile("load ok");
 
 const sessionState = new Map();
@@ -563,19 +540,7 @@ function isPermanent(error) {
 
 function isTransientUnknown(error) {
   if (isPermanent(error)) return false;
-  const text = textOf(error);
-  const hasUnknown = /UnknownError/i.test(text) || (error && /UnknownError/i.test(String(error.name || "")));
-  const hasTypeValidation =
-    /\\bTypeValidationError\\b/i.test(text) ||
-    /Type validation failed/i.test(text) ||
-    (error && /TypeValidationError/i.test(String(error.name || "")));
-  if (!hasUnknown && !hasTypeValidation) return false;
-  return (
-    /\\b(code[:\\s]*502|502|LLMRequestError|network fluctuation|timeout|transient provider failure|non-standard)\\b/i.test(
-      text,
-    ) ||
-    (error && (error.code === 502 || error.status === 502))
-  );
+  return isKnownTransientProviderError(error);
 }
 
 function buildResumePrompt(sessionId, error, attempt) {

package/dist/commands/cursor-prompt.js

@@ -64,6 +64,8 @@ export function parseCursorPromptArgs(args) {
             continue;
         }
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--stream") {
             stream = true;
         }

package/dist/commands/dag-approve.js

@@ -11,6 +11,8 @@ export function parseDagApproveArgs(args) {
     let notes;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--run-id") {
             runId = args[++i];
             continue;

package/dist/commands/dag-final-verification.js

@@ -10,6 +10,8 @@ export function parseDagFinalVerificationArgs(args) {
     let closeoutPath;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === '--output' || arg === '-o') {
             outputPath = requiredValue(args[++i], '--output');
         }

package/dist/commands/dag-init-hybrid.js

@@ -9,6 +9,8 @@ export function parseDagInitHybridArgs(args) {
     let outputPath;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--output" || arg === "-o") {
             outputPath = args[++i];
             if (!outputPath) {

package/dist/commands/dag-reconcile-tasks.js

@@ -20,6 +20,8 @@ export function parseDagReconcileTasksArgs(args) {
     let markdown = false;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === '--glob') {
             glob = requiredValue(args[++i], '--glob');
         }

package/dist/commands/dag-reject.js

@@ -8,6 +8,8 @@ export function parseDagRejectArgs(args) {
     let reason;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--run-id") {
             runId = args[++i];
             continue;

package/dist/commands/dag-report.js

@@ -29,6 +29,8 @@ export function parseDagCloseoutDraftArgs(args) {
     let outputPath;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         const requireValue = (flag) => {
             const value = args[++i];
             if (!value || value.startsWith("-")) {

package/dist/commands/dag-rerun.js

@@ -22,6 +22,8 @@ export function parseDagRerunArgs(args) {
     const promptOverrideAppendSpecs = [];
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
+        if (arg === undefined)
+            break;
         if (arg === "--run-id")
             parentRunId = args[++index];
         else if (arg.startsWith("--run-id="))

package/dist/commands/dag-resume.js

@@ -6,6 +6,8 @@ export function parseDagResumeArgs(args) {
     let runId;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--run-id") {
             runId = args[++i];
             continue;

package/dist/commands/dag-workflow-compile.js

@@ -12,6 +12,8 @@ export function parseDagWorkflowCompileArgs(args) {
     let manifestPath;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--workflow") {
             workflowPath = args[++i];
             if (!workflowPath) {

package/dist/commands/dag-workflow-plan.js

@@ -21,6 +21,8 @@ export function parseDagWorkflowPlanArgs(args) {
     const changedFiles = [];
     for (let i = 0; i < rest.length; i += 1) {
         const arg = rest[i];
+        if (arg === undefined)
+            break;
         if (arg === "--profile") {
             const value = rest[++i];
             if (!value)

package/dist/commands/dag-workflow-validate.js

@@ -11,6 +11,8 @@ export function parseDagWorkflowValidateArgs(args) {
     let strictGovernance = false;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--workflow") {
             workflowPath = args[++i];
             if (!workflowPath) {

package/dist/commands/delegate.js

@@ -16,6 +16,8 @@ export function parseDelegateArgs(args) {
     let autoRun = false;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--base") {
             base = args[i + 1];
             if (!base)

package/dist/commands/examples.js

@@ -57,6 +57,8 @@ function parseExamplesArgs(args) {
     let output;
     for (let i = 0; i < rest.length; i += 1) {
         const arg = rest[i];
+        if (arg === undefined)
+            break;
         if (arg === "--output" || arg === "-o") {
             output = rest[++i];
             continue;

package/dist/commands/import-prd.js

@@ -5,6 +5,8 @@ export function parseImportPrdArgs(args) {
     const positional = [];
     for (let index = 0; index < args.length; index += 1) {
         const token = args[index];
+        if (token === undefined)
+            continue;
         if (token === "--file" || token === "-f") {
             options.file = args[index + 1];
             index += 1;

package/dist/commands/init-model-catalog.js

@@ -252,6 +252,8 @@ export function parseOpenCodeModelReferences(value, credentialProviders = new Se
         if (!match)
             continue;
         const [, provider, modelId] = match;
+        if (provider === undefined || modelId === undefined)
+            continue;
         const model = createCatalogEntry({
             source: "opencode",
             provider,

package/dist/commands/init.js

@@ -861,19 +861,23 @@ function mergeGitignoreManagedBlock(existing, block) {
     return `${existing.trimEnd()}\n\n${block}\n`;
 }
 /**
- * Shared ignore rules for loop-agent runtime facts. The four directories are
- * local, rebuildable runtime surface: every developer runs loop-agent init
- * after cloning, so nothing inside them is team-shareable by default.
- * `scripts/` and `ai_workspace/loop-agent/` stay on the shared commit surface.
+ * Shared ignore rules for loop-agent init surface: everything init regenerates
+ * in the target project is local and rebuildable, so none of it is
+ * team-shareable by default. `AGENTS.md` and `README.md` stay on the shared
+ * commit surface (they carry the governance handoff and are not ignored);
+ * `.opencode/` and `.pi/` project adapters are left to the user's discretion.
  */
-export function buildManagedGitignoreBlock() {
+export function buildManagedGitignoreBlock(governanceRoot = DEFAULT_GOVERNANCE_ROOT) {
     return [
         GITIGNORE_BLOCK_START,
-        "# loop-agent runtime: local, rebuildable facts; do not ignore scripts/ or ai_workspace/loop-agent/",
+        "# loop-agent init surface: rebuildable outputs; AGENTS.md and README.md stay shared",
         ".harness/",
         ".agents/",
         ".task-pool/",
         ".worktrees/",
+        `${governanceRoot}/`,
+        "scripts/",
+        "harness.json",
         GITIGNORE_BLOCK_END,
     ].join("\n");
 }
@@ -1312,7 +1316,7 @@ async function buildDesiredSurfaceContent(input) {
         };
     }
     if (manifestPath === ".gitignore") {
-        return { content: buildManagedGitignoreBlock() };
+        return { content: buildManagedGitignoreBlock(input.governanceRoot) };
     }
     if (manifestPath === "harness.json") {
         const template = await readJsonIfExists(path.join(input.assetRoot, "harness.json"));
@@ -2554,7 +2558,7 @@ export function buildInitInstructions(input) {
         "- Enrich the root `README.md`: keep the deterministic project title and the loop-agent managed block intact, and fill the human-authored sections (项目概览, 技术栈与目录结构, 开发与验证) from the target project's actual files. The root README must serve both as a human-first project entry and as an agent work entry; replace the initialization-model supplement comments when the project files provide the information.",
         `- Populate \`${governanceRoot}/verification-matrix.md\` with the target project's actual quick, standard, and full verification commands derived from its real language and toolchain, keeping the governance rows intact.`,
         "- Project repo-local skills live in `.agents/skills/`. Do not create a root `skills/` directory in the target project; the package's bundled `skills/` remains the built-in fallback.",
-        "- Merge a loop-agent managed block into `.gitignore` that ignores exactly the four local, rebuildable runtime directories (`.harness/`, `.agents/`, `.task-pool/`, `.worktrees/`) while keeping `scripts/` and `ai_workspace/loop-agent/` on the shared commit surface; keep all user rules outside the block untouched.",
+        "- Merge a loop-agent managed block into `.gitignore` that ignores the full rebuildable init surface (`.harness/`, `.agents/`, `.task-pool/`, `.worktrees/`, `ai_workspace/loop-agent/`, `scripts/`, `harness.json`); keep `AGENTS.md` and `README.md` on the shared commit surface and keep all user rules outside the block untouched.",
         "- Do not copy examples by default; examples stay bundled in the tool and are available through `loop-agent examples`.",
         "- Add or update a loop-agent managed block in AGENTS.md.",
         "- The generated AGENTS.md must include documentation convergence and structured DAG write-boundary rules so target projects keep the same working discipline as this repository.",
@@ -2676,7 +2680,7 @@ export async function initializeLoopAgentProject(options) {
     await writeText({
         repoRoot,
         relativePath: ".gitignore",
-        content: mergeGitignoreManagedBlock(existingGitignore, buildManagedGitignoreBlock()),
+        content: mergeGitignoreManagedBlock(existingGitignore, buildManagedGitignoreBlock(governanceRoot)),
         merge: true,
         written,
         skipped,
@@ -2842,7 +2846,7 @@ function modelMergeTaskFor(pathName, state, allPaths, recordedState) {
         taskId: `init-merge-${sha256Text(pathName).slice(0, 12)}`,
         path: pathName,
         reason: "target file exists but does not match the current loop-agent initialization surface",
-        sourcePath: state.sourcePath,
+        sourcePath: state?.sourcePath,
         allowedPaths: [pathName],
         forbiddenPaths: [
             ...allPaths.filter((candidate) => candidate !== pathName),
@@ -2861,9 +2865,9 @@ function modelMergeTaskFor(pathName, state, allPaths, recordedState) {
         ],
         evidence: {
             baseSha256: recordedState?.files[pathName]?.currentSha256,
-            currentSha256: state.currentSha256,
-            desiredSha256: state.sourceSha256,
-            sourceAnchorSha256: state.sourceAnchorSha256,
+            currentSha256: state?.currentSha256,
+            desiredSha256: state?.sourceSha256,
+            sourceAnchorSha256: state?.sourceAnchorSha256,
         },
     };
 }
@@ -3743,6 +3747,8 @@ function parseInitArgs(repoRoot, args) {
     let versionChoice;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if ((arg === "instructions" ||
             arg === "doctor" ||
             arg === "model-catalog" ||

package/dist/commands/instructions.js

@@ -18,6 +18,8 @@ export function parseInstructionsArgs(args) {
     let json = false;
     for (let i = 0; i < rest.length; i += 1) {
         const arg = rest[i];
+        if (arg === undefined)
+            break;
         if (arg === "--task") {
             taskId = rest[++i];
             if (!taskId)

package/dist/commands/knowledge.js

@@ -68,6 +68,8 @@ export function parseKnowledgeArgs(args) {
         let markdown = false;
         for (let i = 0; i < rest.length; i += 1) {
             const arg = rest[i];
+            if (arg === undefined)
+                break;
             if (arg === "--json") {
                 json = true;
                 continue;

package/dist/commands/loop-benchmark.js

@@ -6,6 +6,8 @@ export function parseLoopBenchmarkArgs(args) {
     let outputPath;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--json") {
             json = true;
             continue;

package/dist/commands/pi-prompt.js

@@ -66,6 +66,8 @@ export function parsePiPromptArgs(args) {
             continue;
         }
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--provider") {
             provider = args[i + 1];
             if (!provider)

package/dist/commands/pi-reuse-benchmark.js

@@ -11,6 +11,8 @@ export function parsePiReuseBenchmarkArgs(args) {
     let markdown = false;
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
+        if (arg === undefined)
+            break;
         if (arg === "--json") {
             json = true;
             continue;

package/dist/commands/promote-run.js

@@ -6,6 +6,8 @@ export function parsePromoteRunArgs(args) {
     let runId;
     for (let i = 0; i < rest.length; i += 1) {
         const arg = rest[i];
+        if (arg === undefined)
+            break;
         if (arg === '--run-id') {
             runId = rest[++i];
             if (!runId)