agentplane 0.2.21 → 0.2.23

package/assets/AGENTS.md

@@ -137,7 +137,7 @@ Precedence:
 
 ## Framework Upgrade / Prompt Merge
 
-`agentplane upgrade` is responsible for mechanical upgrades and safe merges. When an upgrade run indicates a potential semantic conflict (for example, both local and incoming changes exist relative to a baseline, or a baseline is missing but files differ), treat the result as requiring a meaning-level review.
+`agentplane upgrade` is responsible for mechanical upgrades and safe merges. Treat prompt-merge as required only for unresolved semantic conflicts (for example, both local and incoming changes exist relative to a baseline and cannot be safely reconciled automatically, or merge parsing fails). If local files did not change relative to baseline, the upgrade may apply incoming framework updates without semantic review.
 
 Trigger:
 
@@ -145,6 +145,7 @@ Trigger:
   - Agent mode: `.agentplane/.upgrade/agent/<runId>/review.json`
   - Auto mode: `.agentplane/.upgrade/last-review.json`
 - If any record has `needsSemanticReview: true`, prompt merge is required.
+- `needsSemanticReview: false` means the change was mechanically safe (including cases where local files were unchanged vs baseline and incoming updates were applied directly).
 
 Protocol:
 

package/dist/backends/task-backend/local-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/local-backend.ts"],"names":[],"mappings":"AAqBA,OAAO,EAiBL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB,qBAAa,YAAa,YAAW,WAAW;IAC9C,EAAE,SAAW;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;gBAEN,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAKrD,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB3E,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IA2FhC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAoBjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;IAKzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyExC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB1E,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,cAAc,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoF/D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD"}
+{"version":3,"file":"local-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/local-backend.ts"],"names":[],"mappings":"AAqBA,OAAO,EAiBL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB,qBAAa,YAAa,YAAW,WAAW;IAC9C,EAAE,SAAW;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;gBAEN,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAKrD,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB3E,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgHhC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAoBjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;IAKzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyExC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB1E,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,cAAc,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoF/D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD"}

package/dist/backends/task-backend/local-backend.js

@@ -41,14 +41,15 @@ export class LocalBackend {
         const entries = await readdir(this.root, { withFileTypes: true }).catch(() => []);
         const indexPath = resolveTaskIndexPath(this.root);
         const cachedIndex = await loadTaskIndex(indexPath);
-        const cachedByPath = new Map();
+        const cachedEntryByPath = new Map();
         if (cachedIndex) {
             for (const [readmePath, taskId] of Object.entries(cachedIndex.byPath)) {
                 const entry = cachedIndex.byId[taskId];
                 if (entry)
-                    cachedByPath.set(readmePath, entry);
+                    cachedEntryByPath.set(readmePath, entry);
             }
         }
+        let indexDirty = cachedIndex === null;
         const nextById = {};
         const nextByPath = {};
         const seen = new Set();
@@ -68,10 +69,11 @@ export class LocalBackend {
             }
             if (!stats.isFile())
                 return null;
-            const cached = cachedByPath.get(readme);
+            const cached = cachedEntryByPath.get(readme);
             if (cached?.mtimeMs === stats.mtimeMs) {
                 return { task: cached.task, index: cached, mtimeMs: stats.mtimeMs, readme };
             }
+            indexDirty = true;
             let text = "";
             try {
                 text = await readFile(readme, "utf8");
@@ -115,11 +117,29 @@ export class LocalBackend {
                 nextByPath[entry.readmePath] = taskId;
             }
         }
-        try {
-            await saveTaskIndex(indexPath, { schema_version: 2, byId: nextById, byPath: nextByPath });
+        if (cachedIndex && indexDirty === false) {
+            const cachedPaths = Object.keys(cachedIndex.byPath);
+            const nextPaths = Object.keys(nextByPath);
+            if (cachedPaths.length === nextPaths.length) {
+                for (const readmePath of nextPaths) {
+                    if (cachedIndex.byPath[readmePath] === nextByPath[readmePath]) {
+                        continue;
+                    }
+                    indexDirty = true;
+                    break;
+                }
+            }
+            else {
+                indexDirty = true;
+            }
         }
-        catch {
-            // Best-effort cache; ignore failures.
+        if (indexDirty) {
+            try {
+                await saveTaskIndex(indexPath, { schema_version: 2, byId: nextById, byPath: nextByPath });
+            }
+            catch {
+                // Best-effort cache; ignore failures.
+            }
         }
         return tasks;
     }

package/dist/cli/run-cli/command-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAoGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACjF,eAAe,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAgBF,eAAO,MAAM,QAAQ,iyCA2ZuB,CAAC"}
+{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAoGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACjF,eAAe,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAgBF,eAAO,MAAM,QAAQ,iyCAgeuB,CAAC"}

package/dist/cli/run-cli/command-catalog.js

@@ -173,7 +173,11 @@ export const COMMANDS = [
     entry(taskUpdateSpec, (deps) => import("../../commands/task/update.command.js").then((m) => m.makeRunTaskUpdateHandler(deps.getCtx))),
     entry(taskCommentSpec, (deps) => import("../../commands/task/comment.command.js").then((m) => m.makeRunTaskCommentHandler(deps.getCtx))),
     entry(taskSetStatusSpec, (deps) => import("../../commands/task/set-status.command.js").then((m) => m.makeRunTaskSetStatusHandler(deps.getCtx))),
-    entry(taskDocSpec, () => import("../../commands/task/doc.command.js").then((m) => m.runTaskDoc)),
+    entry(taskDocSpec, () => import("../../commands/task/doc.command.js").then((m) => m.runTaskDoc), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(taskDocShowSpec, (deps) => import("../../commands/task/doc-show.command.js").then((m) => m.makeRunTaskDocShowHandler(deps.getCtx))),
     entry(taskDocSetSpec, (deps) => import("../../commands/task/doc-set.command.js").then((m) => m.makeRunTaskDocSetHandler(deps.getCtx))),
     entry(taskScrubSpec, (deps) => import("../../commands/task/scrub.command.js").then((m) => m.makeRunTaskScrubHandler(deps.getCtx))),
@@ -186,14 +190,26 @@ export const COMMANDS = [
     entry(taskPlanSetSpec, (deps) => import("../../commands/task/plan-set.command.js").then((m) => m.makeRunTaskPlanSetHandler(deps.getCtx))),
     entry(taskPlanApproveSpec, (deps) => import("../../commands/task/plan-approve.command.js").then((m) => m.makeRunTaskPlanApproveHandler(deps.getCtx))),
     entry(taskPlanRejectSpec, (deps) => import("../../commands/task/plan-reject.command.js").then((m) => m.makeRunTaskPlanRejectHandler(deps.getCtx))),
-    entry(taskVerifySpec, () => import("../../commands/task/verify.command.js").then((m) => m.runTaskVerify)),
+    entry(taskVerifySpec, () => import("../../commands/task/verify.command.js").then((m) => m.runTaskVerify), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(taskVerifyOkSpec, (deps) => import("../../commands/task/verify-ok.command.js").then((m) => m.makeRunTaskVerifyOkHandler(deps.getCtx))),
     entry(taskVerifyReworkSpec, (deps) => import("../../commands/task/verify-rework.command.js").then((m) => m.makeRunTaskVerifyReworkHandler(deps.getCtx))),
     entry(taskVerifyShowSpec, (deps) => import("../../commands/task/verify-show.command.js").then((m) => m.makeRunTaskVerifyShowHandler(deps.getCtx))),
     entry(taskRebuildIndexSpec, (deps) => import("../../commands/task/rebuild-index.command.js").then((m) => m.makeRunTaskRebuildIndexHandler(deps.getCtx))),
     entry(workStartSpec, (deps) => import("../../commands/branch/work-start.command.js").then((m) => m.makeRunWorkStartHandler(deps.getCtx))),
-    entry(recipesSpec, () => import("../../commands/recipes/recipes.command.js").then((m) => m.runRecipes)),
-    entry(recipesCacheSpec, () => import("../../commands/recipes/cache.command.js").then((m) => m.runRecipesCache)),
+    entry(recipesSpec, () => import("../../commands/recipes/recipes.command.js").then((m) => m.runRecipes), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(recipesCacheSpec, () => import("../../commands/recipes/cache.command.js").then((m) => m.runRecipesCache), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(recipesListSpec, () => import("../../commands/recipes/list.command.js").then((m) => m.runRecipesList)),
     entry(recipesListRemoteSpec, () => import("../../commands/recipes/list-remote.command.js").then((m) => m.runRecipesListRemote)),
     entry(recipesInfoSpec, () => import("../../commands/recipes/info.command.js").then((m) => m.runRecipesInfo)),
@@ -201,21 +217,37 @@ export const COMMANDS = [
     entry(recipesRemoveSpec, () => import("../../commands/recipes/remove.command.js").then((m) => m.runRecipesRemove)),
     entry(recipesCachePruneSpec, () => import("../../commands/recipes/cache-prune.command.js").then((m) => m.runRecipesCachePrune)),
     entry(recipesInstallSpec, () => import("../../commands/recipes/install.run.js").then((m) => m.runRecipesInstall)),
-    entry(scenarioSpec, () => import("../../commands/scenario/scenario.command.js").then((m) => m.runScenario)),
+    entry(scenarioSpec, () => import("../../commands/scenario/scenario.command.js").then((m) => m.runScenario), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(scenarioListSpec, () => import("../../commands/scenario/list.command.js").then((m) => m.runScenarioList)),
     entry(scenarioInfoSpec, () => import("../../commands/scenario/info.command.js").then((m) => m.runScenarioInfo)),
     entry(scenarioRunSpec, () => import("../../commands/scenario/run.command.js").then((m) => m.runScenarioRun)),
-    entry(branchBaseSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBase)),
+    entry(branchBaseSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBase), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(branchBaseGetSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBaseGet)),
     entry(branchBaseSetSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBaseSet)),
     entry(branchBaseClearSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBaseClear)),
     entry(branchBaseExplainSpec, () => import("../../commands/branch/base.command.js").then((m) => m.runBranchBaseExplain)),
     entry(branchStatusSpec, () => import("../../commands/branch/status.command.js").then((m) => m.runBranchStatus)),
     entry(branchRemoveSpec, () => import("../../commands/branch/remove.command.js").then((m) => m.runBranchRemove)),
-    entry(backendSpec, (deps) => import("../../commands/backend/sync.command.js").then((m) => m.makeRunBackendHandler(deps.getCtx))),
+    entry(backendSpec, (deps) => import("../../commands/backend/sync.command.js").then((m) => m.makeRunBackendHandler(deps.getCtx)), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(backendSyncSpec, (deps) => import("../../commands/backend/sync.command.js").then((m) => m.makeRunBackendSyncHandler(deps.getCtx))),
     entry(syncSpec, (deps) => import("../../commands/sync.command.js").then((m) => m.makeRunSyncHandler(deps.getCtx))),
-    entry(prSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrHandler(deps.getCtx))),
+    entry(prSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrHandler(deps.getCtx)), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(prOpenSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrOpenHandler(deps.getCtx))),
     entry(prUpdateSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrUpdateHandler(deps.getCtx))),
     entry(prCheckSpec, (deps) => import("../../commands/pr/pr.command.js").then((m) => m.makeRunPrCheckHandler(deps.getCtx))),
@@ -227,14 +259,30 @@ export const COMMANDS = [
     entry(verifySpec, (deps) => import("../../commands/verify.run.js").then((m) => m.makeRunVerifyHandler(deps.getCtx))),
     entry(finishSpec, (deps) => import("../../commands/finish.run.js").then((m) => m.makeRunFinishHandler(deps.getCtx))),
     entry(readySpec, (deps) => import("../../commands/ready.command.js").then((m) => m.makeRunReadyHandler(deps.getCtx))),
-    entry(docsCliSpec, (deps) => import("../../commands/docs/cli.command.js").then((m) => m.makeRunDocsCliHandler(deps.getHelpJsonForDocs))),
-    entry(hooksSpec, () => import("../../commands/hooks/hooks.command.js").then((m) => m.runHooks)),
+    entry(docsCliSpec, (deps) => import("../../commands/docs/cli.command.js").then((m) => m.makeRunDocsCliHandler(deps.getHelpJsonForDocs)), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(hooksSpec, () => import("../../commands/hooks/hooks.command.js").then((m) => m.runHooks), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(hooksInstallSpec, () => import("../../commands/hooks/install.command.js").then((m) => m.runHooksInstall)),
     entry(hooksUninstallSpec, () => import("../../commands/hooks/uninstall.command.js").then((m) => m.runHooksUninstall)),
     entry(hooksRunSpec, () => import("../../commands/hooks/run.command.js").then((m) => m.runHooksRun)),
-    entry(cleanupSpec, () => import("../../commands/cleanup/merged.command.js").then((m) => m.runCleanup)),
+    entry(cleanupSpec, () => import("../../commands/cleanup/merged.command.js").then((m) => m.runCleanup), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(cleanupMergedSpec, (deps) => import("../../commands/cleanup/merged.command.js").then((m) => m.makeRunCleanupMergedHandler(deps.getCtx))),
-    entry(guardSpec, () => import("../../commands/guard/guard.command.js").then((m) => m.runGuard)),
+    entry(guardSpec, () => import("../../commands/guard/guard.command.js").then((m) => m.runGuard), {
+        needsProject: false,
+        needsConfig: false,
+        needsTaskContext: false,
+    }),
     entry(guardCleanSpec, () => import("../../commands/guard/clean.command.js").then((m) => m.runGuardClean)),
     entry(guardSuggestAllowSpec, () => import("../../commands/guard/suggest-allow.command.js").then((m) => m.runGuardSuggestAllow)),
     entry(guardCommitSpec, (deps) => import("../../commands/guard/commit.command.js").then((m) => m.makeRunGuardCommitHandler(deps.getCtx))),

package/dist/cli/run-cli/commands/core.d.ts

@@ -5,8 +5,10 @@ type QuickstartParsed = {
 };
 export declare const quickstartSpec: CommandSpec<QuickstartParsed>;
 export declare const runQuickstart: CommandHandler<QuickstartParsed>;
+type PreflightMode = "quick" | "full";
 type PreflightParsed = {
     json: boolean;
+    mode: PreflightMode;
 };
 export declare const preflightSpec: CommandSpec<PreflightParsed>;
 export declare const runPreflight: CommandHandler<PreflightParsed>;

package/dist/cli/run-cli/commands/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIrD,KAAK,gBAAgB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAcxD,CAAC;AA6BF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CAE1D,CAAC;AAEF,KAAK,eAAe,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AA0LzC,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAgBtD,CAAC;AAsCF,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,eAAe,CAExD,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAElD,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAe5C,CAAC;AAoOF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CAE9C,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAMhD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CA0FhF"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIrD,KAAK,gBAAgB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1C,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAcxD,CAAC;AA6BF,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,gBAAgB,CAE1D,CAAC;AAEF,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AACtC,KAAK,eAAe,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AA6L9D,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,eAAe,CAuCtD,CAAC;AA4CF,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,eAAe,CAExD,CAAC;AAEF,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAElD,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAe5C,CAAC;AAoOF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CAE9C,CAAC;AAEF,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAE1C,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,YAAY,CAMhD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CA0FhF"}

package/dist/cli/run-cli/commands/core.js

@@ -129,9 +129,9 @@ async function buildPreflightReport(opts) {
     }
     let taskListLoaded = {
         ok: false,
-        error: "project not resolved",
+        error: opts.mode === "quick" ? "skipped in quick mode" : "project not resolved",
     };
-    if (resolved) {
+    if (opts.mode === "full" && resolved) {
         try {
             const loaded = await loadTaskBackend({
                 cwd: opts.cwd,
@@ -189,6 +189,7 @@ async function buildPreflightReport(opts) {
         }
     }
     return {
+        mode: opts.mode,
         project_detected: resolved !== null,
         config_loaded: configLoaded,
         quickstart_loaded: quickstartLoaded,
@@ -206,6 +207,20 @@ export const preflightSpec = {
     group: "Core",
     summary: "Run aggregated preflight checks and print a deterministic readiness report.",
     options: [
+        {
+            kind: "string",
+            name: "mode",
+            valueHint: "<quick|full>",
+            choices: ["quick", "full"],
+            default: "quick",
+            description: "Preflight depth. quick skips backend task-list probe; full includes backend readiness.",
+        },
+        {
+            kind: "boolean",
+            name: "full",
+            default: false,
+            description: "Shortcut for --mode full.",
+        },
         {
             kind: "boolean",
             name: "json",
@@ -215,17 +230,29 @@ export const preflightSpec = {
     ],
     examples: [
         { cmd: "agentplane preflight --json", why: "Produce one-shot agent-readable preflight." },
+        {
+            cmd: "agentplane preflight --json --mode full",
+            why: "Run full preflight including backend task-list probe.",
+        },
     ],
-    parse: (raw) => ({ json: raw.opts.json === true }),
+    parse: (raw) => ({
+        json: raw.opts.json === true,
+        mode: raw.opts.full === true ? "full" : (raw.opts.mode ?? "quick"),
+    }),
 };
 async function cmdPreflight(opts) {
     return wrapCommand({ command: "preflight", rootOverride: opts.rootOverride }, async () => {
-        const report = await buildPreflightReport({ cwd: opts.cwd, rootOverride: opts.rootOverride });
+        const report = await buildPreflightReport({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride,
+            mode: opts.mode,
+        });
         if (opts.json) {
             process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
             return 0;
         }
         process.stdout.write("Preflight Summary\n");
+        process.stdout.write(`- mode: ${report.mode}\n`);
         process.stdout.write(`- project detected: ${report.project_detected ? "yes" : "no"}\n`);
         process.stdout.write(`- config loaded: ${probeYesNo(report.config_loaded)}\n`);
         process.stdout.write(`- quickstart loaded: ${probeYesNo(report.quickstart_loaded)}\n`);
@@ -248,7 +275,7 @@ async function cmdPreflight(opts) {
     });
 }
 export const runPreflight = (ctx, p) => {
-    return cmdPreflight({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, json: p.json });
+    return cmdPreflight({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, json: p.json, mode: p.mode });
 };
 export const roleSpec = {
     id: ["role"],

package/dist/cli/run-cli/commands/init/write-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-agents.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-agents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAQ1E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6BtC"}
+{"version":3,"file":"write-agents.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-agents.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAkC1E,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAuCtC"}

package/dist/cli/run-cli/commands/init/write-agents.js

@@ -1,13 +1,37 @@
+import { mkdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { atomicWriteFile } from "@agentplaneorg/core";
 import { filterAgentsByWorkflow, loadAgentTemplates, loadAgentsTemplate, } from "../../../../agents/agents-template.js";
 import { fileExists } from "../../../fs-utils.js";
+function toUpgradeBaselineKey(repoRelativePath) {
+    if (repoRelativePath === "AGENTS.md")
+        return "AGENTS.md";
+    if (repoRelativePath.startsWith(".agentplane/")) {
+        return repoRelativePath.slice(".agentplane/".length);
+    }
+    return null;
+}
+async function seedUpgradeBaselineForInstalledFiles(opts) {
+    const baselineDir = path.join(opts.agentplaneDir, ".upgrade", "baseline");
+    for (const relPath of opts.repoRelativePaths) {
+        const normalizedRel = relPath.replaceAll("\\", "/");
+        const baselineKey = toUpgradeBaselineKey(normalizedRel);
+        if (!baselineKey)
+            continue;
+        const srcPath = path.join(opts.gitRoot, normalizedRel);
+        const contents = await readFile(srcPath);
+        const baselinePath = path.join(baselineDir, baselineKey);
+        await mkdir(path.dirname(baselinePath), { recursive: true });
+        await atomicWriteFile(baselinePath, contents);
+    }
+}
 export async function ensureAgentsFiles(opts) {
     const agentsPath = path.join(opts.gitRoot, "AGENTS.md");
     const installPaths = [
         path.relative(opts.gitRoot, opts.configPathAbs),
         path.relative(opts.gitRoot, opts.backendPathAbs),
     ];
+    const installedManagedPaths = [];
     let wroteAgents = false;
     if (await fileExists(agentsPath)) {
         // nothing
@@ -20,6 +44,7 @@ export async function ensureAgentsFiles(opts) {
     }
     if (wroteAgents) {
         installPaths.push(path.relative(opts.gitRoot, agentsPath));
+        installedManagedPaths.push("AGENTS.md");
     }
     const agentTemplates = await loadAgentTemplates();
     for (const agent of agentTemplates) {
@@ -27,7 +52,14 @@ export async function ensureAgentsFiles(opts) {
         if (await fileExists(targetPath))
             continue;
         await atomicWriteFile(targetPath, agent.contents, "utf8");
-        installPaths.push(path.relative(opts.gitRoot, targetPath));
+        const relPath = path.relative(opts.gitRoot, targetPath);
+        installPaths.push(relPath);
+        installedManagedPaths.push(relPath);
     }
+    await seedUpgradeBaselineForInstalledFiles({
+        gitRoot: opts.gitRoot,
+        agentplaneDir: opts.agentplaneDir,
+        repoRelativePaths: installedManagedPaths,
+    });
     return { installPaths };
 }

package/dist/cli/run-cli/commands/init/write-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-config.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-config.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;IACpD,gBAAgB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yCAAyC,EAAE,MAAM,EAAE,CAAC;CACrD,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GAAG,SAAS,GAC3B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,mBAAmB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB"}
+{"version":3,"file":"write-config.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/write-config.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;IACpD,gBAAgB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yCAAyC,EAAE,MAAM,EAAE,CAAC;CACrD,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GAAG,SAAS,GAC3B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,mBAAmB,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBhB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB"}

package/dist/cli/run-cli/commands/init/write-config.js

@@ -14,7 +14,9 @@ export async function writeInitConfig(opts) {
     const rawConfig = defaultConfig();
     setByDottedKey(rawConfig, "workflow_mode", opts.workflow);
     setByDottedKey(rawConfig, "status_commit_policy", opts.workflow === "branch_pr" ? "confirm" : "warn");
-    setByDottedKey(rawConfig, "finish_auto_status_commit", String(opts.workflow === "branch_pr"));
+    setByDottedKey(rawConfig, "commit_automation", "finish_only");
+    // Keep status commits explicit by default in all modes to reduce commit noise.
+    setByDottedKey(rawConfig, "finish_auto_status_commit", "false");
     setByDottedKey(rawConfig, "tasks_backend.config_path", path.relative(opts.gitRoot, opts.backendConfigPathAbs));
     setByDottedKey(rawConfig, "agents.approvals.require_plan", String(opts.requirePlanApproval));
     setByDottedKey(rawConfig, "agents.approvals.require_network", String(opts.requireNetworkApproval));

package/dist/cli/run-cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAa7B,KAAK,SAAS,GAAG;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAsBF,KAAK,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAoL5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAa7B,KAAK,SAAS,GAAG;IACf,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AA6DF,KAAK,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAoL5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}

package/dist/cli/run-cli/commands/init.js

@@ -18,6 +18,32 @@ import { ensureAgentsFiles } from "./init/write-agents.js";
 import { ensureInitGitignore } from "./init/write-gitignore.js";
 import { ensureInitRedmineEnvTemplate } from "./init/write-env.js";
 import { renderInitSection, renderInitWelcome } from "./init/ui.js";
+const setupProfilePresets = {
+    prod: {
+        mode: "prod",
+        description: "Production bootstrap: compact flow with default managed-file and approval settings.",
+        defaultHooks: false,
+        defaultStrictUnsafeConfirm: false,
+    },
+    "prod-strict": {
+        mode: "prod",
+        description: "Production bootstrap + strict defaults for safer installs (hooks on, strict unsafe confirmations).",
+        defaultHooks: true,
+        defaultStrictUnsafeConfirm: true,
+    },
+    dev: {
+        mode: "dev",
+        description: "Developer bootstrap: full questionnaire for every init aspect.",
+        defaultHooks: false,
+        defaultStrictUnsafeConfirm: false,
+    },
+    "dev-safe": {
+        mode: "dev",
+        description: "Developer bootstrap with explicit unsafe-action confirmation by default.",
+        defaultHooks: false,
+        defaultStrictUnsafeConfirm: true,
+    },
+};
 function parseBooleanValueForInit(flag, value) {
     const normalized = value.trim().toLowerCase();
     if (["1", "true", "yes", "y", "on"].includes(normalized))
@@ -50,7 +76,7 @@ export const initSpec = {
             name: "setup-profile",
             valueHint: "<prod|dev>",
             choices: ["prod", "dev"],
-            description: "Interactive preset. prod asks only essential questions; dev asks the full setup questionnaire.",
+            description: "Interactive preset. prod is the default and asks only essential questions; dev asks the full setup questionnaire.",
         },
         {
             kind: "string",
@@ -235,6 +261,7 @@ async function cmdInit(opts) {
     let executionProfile = flags.executionProfile ?? defaults.executionProfile;
     let strictUnsafeConfirm = flags.strictUnsafeConfirm ?? defaults.strictUnsafeConfirm;
     let setupProfile = flags.setupProfile ?? "prod";
+    let setupProfilePreset = flags.setupProfile ?? "prod";
     const isInteractive = process.stdin.isTTY && !flags.yes;
     if (!process.stdin.isTTY &&
         !flags.yes &&
@@ -266,11 +293,24 @@ async function cmdInit(opts) {
             return result;
         };
         process.stdout.write(renderInitWelcome());
-        process.stdout.write(renderInitSection("Setup Profile", "Choose how much init should ask. prod keeps the flow compact; dev exposes full controls."));
-        if (!flags.setupProfile) {
-            setupProfile = (await askChoice("Setup profile", ["prod", "dev"], setupProfile));
+        const presetLines = Object.entries(setupProfilePresets).map(([id, preset]) => `- ${id}: ${preset.description}`);
+        process.stdout.write(renderInitSection("Setup Preset", "Choose a bootstrap preset. It controls what questions are shown and safe defaults used."));
+        process.stdout.write(`${presetLines.join("\n")}\n\n`);
+        if (flags.setupProfile) {
+            setupProfilePreset = flags.setupProfile;
+        }
+        else {
+            const selected = await askChoice("Setup preset", ["prod", "prod-strict", "dev", "dev-safe"], "prod");
+            setupProfilePreset = selected;
+        }
+        const selectedPreset = setupProfilePresets[setupProfilePreset];
+        setupProfile = selectedPreset.mode;
+        if (flags.hooks === undefined)
+            hooks = selectedPreset.defaultHooks;
+        if (flags.strictUnsafeConfirm === undefined) {
+            strictUnsafeConfirm = selectedPreset.defaultStrictUnsafeConfirm;
         }
-        process.stdout.write(renderInitSection("Workflow", "Choose how branches/backends/approvals should be initialized for this repository."));
+        process.stdout.write(renderInitSection("Workflow", "Choose how this repository will be orchestrated: direct means one branch, branch_pr means PR-first tasks."));
         ide = flags.ide ?? defaults.ide;
         if (!flags.workflow && setupProfile === "dev") {
             const choice = await askChoice("Workflow mode", ["direct", "branch_pr"], workflow);
@@ -314,13 +354,13 @@ async function cmdInit(opts) {
             }
         }
         else {
-            hooks = flags.hooks ?? defaults.hooks;
+            hooks = flags.hooks ?? selectedPreset.defaultHooks;
             recipes = flags.recipes ?? defaults.recipes;
             requirePlanApproval = flags.requirePlanApproval ?? defaults.requirePlanApproval;
             requireNetworkApproval = flags.requireNetworkApproval ?? defaults.requireNetworkApproval;
             requireVerifyApproval = flags.requireVerifyApproval ?? defaults.requireVerifyApproval;
             executionProfile = flags.executionProfile ?? defaults.executionProfile;
-            strictUnsafeConfirm = flags.strictUnsafeConfirm ?? defaults.strictUnsafeConfirm;
+            strictUnsafeConfirm = flags.strictUnsafeConfirm ?? selectedPreset.defaultStrictUnsafeConfirm;
             process.stdout.write(renderInitSection("Defaults Applied", "Using compact prod defaults for hooks, approvals, execution profile, and recipes."));
         }
     }

package/dist/cli/run-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":"AAibA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmL5D"}
+{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.ts"],"names":[],"mappings":"AAibA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiL5D"}

package/dist/cli/run-cli.js

@@ -404,9 +404,6 @@ export async function runCli(argv) {
         const resolved = matched?.entry.needsProject === false
             ? null
             : await maybeResolveProject({ cwd, rootOverride: globals.root });
-        if (resolved) {
-            await loadDotEnv(resolved.gitRoot);
-        }
         let projectPromise = resolved
             ? Promise.resolve(resolved)
             : null;
@@ -423,6 +420,7 @@ export async function runCli(argv) {
         const getLoadedConfig = async (commandForErrorContext) => {
             configPromise ??= (async () => {
                 const project = await getResolvedProject(commandForErrorContext);
+                await loadDotEnv(project.gitRoot);
                 return await loadConfig(project.agentplaneDir);
             })();
             try {

package/dist/cli/spec/docs-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-render.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/docs-render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA2BjD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAsGnE"}
+{"version":3,"file":"docs-render.d.ts","sourceRoot":"","sources":["../../../src/cli/spec/docs-render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAmCjD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAsGnE"}

package/dist/cli/spec/docs-render.js

@@ -1,6 +1,13 @@
-function escInline(text) {
+function escCode(text) {
     return text.replaceAll("`", "\\`");
 }
+function escText(text) {
+    return text
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll("`", "\\`");
+}
 function toAnchor(text) {
     return text
         .toLowerCase()
@@ -49,8 +56,8 @@ export function renderCliDocsMdx(specs) {
         const groupHeader = ["", `## ${group}`];
         const commandBlocks = specs.flatMap((s) => {
             const summaryLines = s.description
-                ? ["", escInline(s.summary), "", escInline(s.description)]
-                : ["", escInline(s.summary)];
+                ? ["", escText(s.summary), "", escText(s.description)]
+                : ["", escText(s.summary)];
             const usageLines = ["", "Usage:", "", "```text", ...(s.usage ?? []), "```"];
             const visibleOpts = (s.options ?? []).filter((o) => !o.hidden);
             const optionLines = visibleOpts.length === 0
@@ -73,11 +80,11 @@ export function renderCliDocsMdx(specs) {
                             o.deprecated ? `deprecated=${o.deprecated}` : null,
                         ].filter((x) => x !== null);
                         const suffix = meta.length > 0 ? ` (${meta.join(", ")})` : "";
-                        return `- \`${escInline(head)}\`: ${escInline(o.description)}${escInline(suffix)}`;
+                        return `- \`${escCode(head)}\`: ${escText(o.description)}${escText(suffix)}`;
                     }),
                 ];
             const notesLines = s.notes && s.notes.length > 0
-                ? ["", "Notes:", "", ...s.notes.map((n) => `- ${escInline(n)}`)]
+                ? ["", "Notes:", "", ...s.notes.map((n) => `- ${escText(n)}`)]
                 : [];
             const examplesLines = s.examples && s.examples.length > 0
                 ? [
@@ -85,7 +92,7 @@ export function renderCliDocsMdx(specs) {
                     "Examples:",
                     "",
                     ...s.examples.flatMap((ex) => {
-                        const why = ex.why ? [`- ${escInline(ex.why)}`] : [];
+                        const why = ex.why ? [`- ${escText(ex.why)}`] : [];
                         return ["```sh", ex.cmd, "```", ...why];
                     }),
                 ]

package/dist/commands/backend/sync.command.d.ts

@@ -1,4 +1,4 @@
-import type { CommandCtx, CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
+import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
 import type { CommandContext } from "../shared/task-backend.js";
 import { type BackendSyncParsed } from "../backend.js";
 type BackendRootParsed = {
@@ -6,7 +6,8 @@ type BackendRootParsed = {
 };
 export declare const backendSpec: CommandSpec<BackendRootParsed>;
 export declare const backendSyncSpec: CommandSpec<BackendSyncParsed>;
-export declare function makeRunBackendHandler(getCtx: (cmd: string) => Promise<CommandContext>): CommandHandler<BackendRootParsed>;
+declare function runBackendRootGroup(_ctx: CommandCtx, p: BackendRootParsed): Promise<number>;
+export declare function makeRunBackendHandler(_getCtx: (cmd: string) => Promise<CommandContext>): typeof runBackendRootGroup;
 export declare function makeRunBackendSyncHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: BackendSyncParsed) => Promise<number>;
 export {};
 //# sourceMappingURL=sync.command.d.ts.map

package/dist/commands/backend/sync.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.command.d.ts","sourceRoot":"","sources":["../../../src/commands/backend/sync.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7E,KAAK,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAQtD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAuC1D,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,qCAgBrF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC1E,KAAK,UAAU,EAAE,GAAG,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAStE"}
+{"version":3,"file":"sync.command.d.ts","sourceRoot":"","sources":["../../../src/commands/backend/sync.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE7E,KAAK,iBAAiB,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAQtD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,iBAAiB,CAuC1D,CAAC;AAEF,iBAAS,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,8BAEtF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC1E,KAAK,UAAU,EAAE,GAAG,iBAAiB,KAAG,OAAO,CAAC,MAAM,CAAC,CAStE"}