agentplane 0.3.1 → 0.3.3

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;IAClB,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,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;IAwHtC,mBAAmB,IAAI,MAAM,EAAE;IAIzB,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;IAClB,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,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;IAwHtC,mBAAmB,IAAI,MAAM,EAAE;IAIzB,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;IAsB1E,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;IAuF/D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD"}

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

@@ -4,7 +4,7 @@ import { docChanged, parseTaskReadme, renderTaskReadme, taskReadmePath, } from "
 import { isRecord } from "../../shared/guards.js";
 import { writeTextIfChanged } from "../../shared/write-if-changed.js";
 import { buildTaskIndexEntry, loadTaskIndex, resolveTaskIndexPath, saveTaskIndex, } from "../task-index.js";
-import { DEFAULT_DOC_UPDATED_BY, DOC_VERSION, defaultPlanApproval, defaultVerificationResult, extractTaskDoc, generateTaskId, invalidLengthMessage, mapLimit, mergeTaskDoc, missingTaskIdMessage, nowIso, resolveDocUpdatedByFromFrontmatter, resolveDocUpdatedByFromTask, taskRecordToData, validateTaskId, writeTasksExportFromTasks, } from "./shared.js";
+import { DEFAULT_DOC_UPDATED_BY, defaultPlanApproval, defaultVerificationResult, extractTaskDoc, generateTaskId, invalidLengthMessage, mapLimit, mergeTaskDoc, missingTaskIdMessage, normalizeDocVersion, nowIso, resolveDocUpdatedByFromFrontmatter, resolveDocUpdatedByFromTask, taskRecordToData, validateTaskId, writeTasksExportFromTasks, } from "./shared.js";
 export class LocalBackend {
     id = "local";
     root;
@@ -229,18 +229,17 @@ export class LocalBackend {
         if (payload.verification === undefined) {
             payload.verification = defaultVerificationResult();
         }
+        const existingDocVersion = normalizeDocVersion(existingFrontmatter.doc_version);
         if (task.doc !== undefined) {
             const docText = String(task.doc ?? "");
             body = mergeTaskDoc(body, docText);
             if (docChanged(existingDoc, docText)) {
-                payload.doc_version = DOC_VERSION;
+                payload.doc_version = normalizeDocVersion(task.doc_version, existingDocVersion);
                 payload.doc_updated_at = nowIso();
                 payload.doc_updated_by = resolveDocUpdatedByFromTask(task, this.updatedBy);
             }
         }
-        if (payload.doc_version !== DOC_VERSION) {
-            payload.doc_version = DOC_VERSION;
-        }
+        payload.doc_version = normalizeDocVersion(payload.doc_version, existingDocVersion);
         if (payload.doc_updated_at === undefined || payload.doc_updated_at === "") {
             payload.doc_updated_at = nowIso();
         }
@@ -258,14 +257,13 @@ export class LocalBackend {
         const docText = String(doc ?? "");
         const body = mergeTaskDoc(parsed.body, docText);
         const frontmatter = { ...parsed.frontmatter };
+        const currentDocVersion = normalizeDocVersion(frontmatter.doc_version);
         if (docChanged(extractTaskDoc(parsed.body), docText) || !frontmatter.doc_updated_at) {
-            frontmatter.doc_version = DOC_VERSION;
+            frontmatter.doc_version = currentDocVersion;
             frontmatter.doc_updated_at = nowIso();
             frontmatter.doc_updated_by = resolveDocUpdatedByFromFrontmatter(frontmatter, updatedBy, this.updatedBy);
         }
-        if (frontmatter.doc_version !== DOC_VERSION) {
-            frontmatter.doc_version = DOC_VERSION;
-        }
+        frontmatter.doc_version = normalizeDocVersion(frontmatter.doc_version, currentDocVersion);
         const next = renderTaskReadme(frontmatter, body);
         await writeTextIfChanged(readme, next.endsWith("\n") ? next : `${next}\n`);
     }
@@ -274,7 +272,7 @@ export class LocalBackend {
         const text = await readFile(readme, "utf8");
         const parsed = parseTaskReadme(text);
         const frontmatter = { ...parsed.frontmatter };
-        frontmatter.doc_version = DOC_VERSION;
+        frontmatter.doc_version = normalizeDocVersion(frontmatter.doc_version);
         frontmatter.doc_updated_at = nowIso();
         frontmatter.doc_updated_by = resolveDocUpdatedByFromFrontmatter(frontmatter, updatedBy, this.updatedBy);
         const next = renderTaskReadme(frontmatter, parsed.body || "");
@@ -340,8 +338,7 @@ export class LocalBackend {
             }
             if (payload.verification === undefined)
                 payload.verification = defaultVerificationResult();
-            if (payload.doc_version !== DOC_VERSION)
-                payload.doc_version = DOC_VERSION;
+            payload.doc_version = normalizeDocVersion(payload.doc_version, normalizeDocVersion(fm.doc_version));
             if (payload.doc_updated_at === undefined || payload.doc_updated_at === "") {
                 payload.doc_updated_at = nowIso();
             }

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

@@ -1 +1 @@
-{"version":3,"file":"redmine-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/redmine-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"redmine-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/redmine-backend.ts"],"names":[],"mappings":"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"}

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

@@ -7,7 +7,7 @@ import { doneRatioForStatus, issueToTask as issueToTaskImpl, startDateFromTaskId
 import { coerceDocVersion as coerceRedmineDocVersion, maybeParseJson as maybeParseRedmineJson, } from "./redmine/parse.js";
 import { findIssueByTaskId as findIssueByTaskIdImpl, listTasksRemote as listTasksRemoteImpl, } from "./redmine/remote.js";
 import { readRedmineEnv } from "./redmine/env.js";
-import { BackendError, DEFAULT_DOC_UPDATED_BY, DOC_VERSION, RedmineUnavailable, ensureDocMetadata, firstNonEmptyString, generateTaskId, mapLimit, missingTaskIdMessage, nowIso, redmineConfigMissingEnvMessage, redmineIssueIdMissingMessage, sleep, toStringSafe, unknownTaskIdMessage, validateTaskId, writeTasksExportFromTasks, } from "./shared.js";
+import { BackendError, DEFAULT_DOC_UPDATED_BY, DOC_VERSION, RedmineUnavailable, ensureDocMetadata, firstNonEmptyString, generateTaskId, mapLimit, missingTaskIdMessage, normalizeDocVersion, nowIso, redmineConfigMissingEnvMessage, redmineIssueIdMissingMessage, sleep, toStringSafe, unknownTaskIdMessage, validateTaskId, writeTasksExportFromTasks, } from "./shared.js";
 export class RedmineBackend {
     id = "redmine";
     baseUrl;
@@ -151,7 +151,11 @@ export class RedmineBackend {
             const issueIdText = toStringSafe(issue.id);
             if (!issueIdText)
                 throw new Error(redmineIssueIdMissingMessage());
-            const taskDoc = { doc: String(doc ?? "") };
+            const cachedTask = this.issueToTask(issue, taskId);
+            const taskDoc = {
+                doc: String(doc ?? ""),
+                doc_version: cachedTask?.doc_version,
+            };
             ensureDocMetadata(taskDoc, updatedBy);
             const customFields = [];
             this.appendCustomField(customFields, "doc", taskDoc.doc);
@@ -161,13 +165,12 @@ export class RedmineBackend {
             await this.requestJson("PUT", `issues/${issueIdText}.json`, {
                 issue: { custom_fields: customFields },
             });
-            const task = this.issueToTask(issue, taskId);
-            if (task) {
-                task.doc = taskDoc.doc;
-                task.doc_version = taskDoc.doc_version;
-                task.doc_updated_at = taskDoc.doc_updated_at;
-                task.doc_updated_by = taskDoc.doc_updated_by;
-                await this.cacheTask(task, false);
+            if (cachedTask) {
+                cachedTask.doc = taskDoc.doc;
+                cachedTask.doc_version = taskDoc.doc_version;
+                cachedTask.doc_updated_at = taskDoc.doc_updated_at;
+                cachedTask.doc_updated_by = taskDoc.doc_updated_by;
+                await this.cacheTask(cachedTask, false);
             }
         }
         catch (err) {
@@ -195,7 +198,11 @@ export class RedmineBackend {
             if (!issueIdText)
                 throw new Error(redmineIssueIdMissingMessage());
             const docValue = this.customFieldValue(issue, this.customFields.doc);
-            const taskDoc = { doc: docValue ?? "" };
+            const cachedTask = this.issueToTask(issue, taskId);
+            const taskDoc = {
+                doc: docValue ?? "",
+                doc_version: cachedTask?.doc_version,
+            };
             ensureDocMetadata(taskDoc, updatedBy);
             const customFields = [];
             this.appendCustomField(customFields, "doc_version", taskDoc.doc_version);
@@ -205,12 +212,11 @@ export class RedmineBackend {
                 await this.requestJson("PUT", `issues/${issueIdText}.json`, {
                     issue: { custom_fields: customFields },
                 });
-                const task = this.issueToTask(issue, taskId);
-                if (task) {
-                    task.doc_version = taskDoc.doc_version;
-                    task.doc_updated_at = taskDoc.doc_updated_at;
-                    task.doc_updated_by = taskDoc.doc_updated_by;
-                    await this.cacheTask(task, false);
+                if (cachedTask) {
+                    cachedTask.doc_version = taskDoc.doc_version;
+                    cachedTask.doc_updated_at = taskDoc.doc_updated_at;
+                    cachedTask.doc_updated_by = taskDoc.doc_updated_by;
+                    await this.cacheTask(cachedTask, false);
                 }
             }
         }
@@ -311,8 +317,7 @@ export class RedmineBackend {
     ensureDocMetadata(task) {
         if (task.doc === undefined)
             return;
-        if (task.doc_version !== DOC_VERSION)
-            task.doc_version = DOC_VERSION;
+        task.doc_version = normalizeDocVersion(task.doc_version);
         task.doc_updated_at ??= nowIso();
         task.doc_updated_by ??= DEFAULT_DOC_UPDATED_BY;
     }

package/dist/backends/task-backend/shared/constants.d.ts

@@ -1,4 +1,5 @@
 export declare const TASK_ID_RE: RegExp;
 export declare const DEFAULT_DOC_UPDATED_BY = "agentplane";
 export declare const DOC_VERSION = 2;
+export declare const SUPPORTED_DOC_VERSIONS: readonly [2, 3];
 //# sourceMappingURL=constants.d.ts.map

package/dist/backends/task-backend/shared/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,QAA6D,CAAC;AACrF,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,WAAW,IAAI,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,QAA6D,CAAC;AACrF,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,sBAAsB,iBAAkB,CAAC"}

package/dist/backends/task-backend/shared/constants.js

@@ -2,3 +2,4 @@ import { TASK_ID_ALPHABET } from "@agentplaneorg/core";
 export const TASK_ID_RE = new RegExp(String.raw `^\d{12}-[${TASK_ID_ALPHABET}]{4,}$`);
 export const DEFAULT_DOC_UPDATED_BY = "agentplane";
 export const DOC_VERSION = 2;
+export const SUPPORTED_DOC_VERSIONS = [2, 3];

package/dist/backends/task-backend/shared/doc.d.ts

@@ -6,6 +6,7 @@ declare const mergeTaskDoc: MergeTaskDoc;
 export declare function nowIso(): string;
 export declare function resolveDocUpdatedByFromFrontmatter(frontmatter: Record<string, unknown>, updatedBy: string | undefined, fallback: string): string;
 export declare function resolveDocUpdatedByFromTask(task: TaskData, fallback: string): string;
+export declare function normalizeDocVersion(value: unknown, fallback?: 2 | 3): 2 | 3;
 export declare function ensureDocMetadata(task: TaskDocMeta & Partial<Pick<TaskData, "comments" | "owner">>, updatedBy?: string): void;
 export { extractTaskDoc, mergeTaskDoc };
 //# sourceMappingURL=doc.d.ts.map

package/dist/backends/task-backend/shared/doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/doc.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAC/C,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAE1D,QAAA,MAAM,cAAc,EAAE,cAAmC,CAAC;AAC1D,QAAA,MAAM,YAAY,EAAE,YAA+B,CAAC;AAEpD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAyBD,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAaR;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASpF;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,EACjE,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAUN;AAED,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/doc.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAC/C,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAE1D,QAAA,MAAM,cAAc,EAAE,cAAmC,CAAC;AAC1D,QAAA,MAAM,YAAY,EAAE,YAA+B,CAAC;AAEpD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAyBD,wBAAgB,kCAAkC,CAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAaR;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASpF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,CAAC,GAAG,CAAe,GAAG,CAAC,GAAG,CAAC,CAExF;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC,EACjE,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAUN;AAED,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC"}

package/dist/backends/task-backend/shared/doc.js

@@ -64,8 +64,11 @@ export function resolveDocUpdatedByFromTask(task, fallback) {
     const fallbackValue = normalizeUpdatedBy(fallback);
     return fallbackValue || fallback;
 }
+export function normalizeDocVersion(value, fallback = DOC_VERSION) {
+    return value === 3 ? 3 : value === 2 ? 2 : fallback;
+}
 export function ensureDocMetadata(task, updatedBy) {
-    task.doc_version = DOC_VERSION;
+    task.doc_version = normalizeDocVersion(task.doc_version);
     task.doc_updated_at = nowIso();
     const explicit = normalizeUpdatedBy(updatedBy);
     if (updatedBy !== undefined) {

package/dist/backends/task-backend/shared/export.js

@@ -3,8 +3,8 @@ import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import { canonicalizeJson } from "@agentplaneorg/core";
 import { writeJsonStableIfChanged } from "../../../shared/write-if-changed.js";
-import { DEFAULT_DOC_UPDATED_BY, DOC_VERSION } from "./constants.js";
-import { resolveDocUpdatedByFromTask } from "./doc.js";
+import { DEFAULT_DOC_UPDATED_BY } from "./constants.js";
+import { normalizeDocVersion, resolveDocUpdatedByFromTask } from "./doc.js";
 import { toStringArray } from "./strings.js";
 function taskDataToExport(task) {
     const base = {
@@ -22,7 +22,7 @@ function taskDataToExport(task) {
         comments: Array.isArray(task.comments)
             ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
             : [],
-        doc_version: task.doc_version ?? DOC_VERSION,
+        doc_version: normalizeDocVersion(task.doc_version),
         doc_updated_at: task.doc_updated_at ?? "",
         doc_updated_by: resolveDocUpdatedByFromTask(task, DEFAULT_DOC_UPDATED_BY),
         dirty: Boolean(task.dirty),

package/dist/cli/bootstrap-guide.d.ts

@@ -0,0 +1,16 @@
+export declare const AGENT_BOOTSTRAP_DOC_PATH = "docs/user/agent-bootstrap.generated.mdx";
+export type BootstrapSection = {
+    heading: string;
+    summary: string;
+    commands: readonly string[];
+    notes?: readonly string[];
+};
+export declare const BOOTSTRAP_PREFLIGHT_COMMANDS: readonly ["agentplane config show", "agentplane quickstart", "agentplane task list", "git status --short --untracked-files=no", "git rev-parse --abbrev-ref HEAD"];
+export declare const BOOTSTRAP_TASK_PREP_COMMANDS: string[];
+export declare const BOOTSTRAP_DIRECT_HAPPY_PATH_COMMANDS: readonly [...string[], "agentplane task start-ready <task-id> --author <ROLE> --body \"Start: ...\"", "agentplane task verify-show <task-id>", "agentplane verify <task-id> --ok|--rework --by <ROLE> --note \"...\"", "agentplane finish <task-id> --author <ROLE> --body \"Verified: ...\" --result \"...\" --commit <git-rev>"];
+export declare const BOOTSTRAP_RECOVERY_COMMANDS: readonly ["agentplane doctor", "agentplane upgrade --dry-run", "agentplane upgrade"];
+export declare const BOOTSTRAP_SECTIONS: readonly BootstrapSection[];
+export declare function renderBootstrapReferenceLine(): string;
+export declare function renderBootstrapSectionLines(sections: readonly BootstrapSection[]): string[];
+export declare function renderBootstrapDoc(): string;
+//# sourceMappingURL=bootstrap-guide.d.ts.map

package/dist/cli/bootstrap-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-guide.d.ts","sourceRoot":"","sources":["../../src/cli/bootstrap-guide.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,4CAA4C,CAAC;AAElF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,4BAA4B,oKAM/B,CAAC;AAEX,eAAO,MAAM,4BAA4B,UAIxC,CAAC;AAEF,eAAO,MAAM,oCAAoC,oUAMvC,CAAC;AAEX,eAAO,MAAM,2BAA2B,sFAI9B,CAAC;AAEX,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAmChD,CAAC;AAEX,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAiB3F;AAMD,wBAAgB,kBAAkB,IAAI,MAAM,CA2B3C"}

package/dist/cli/bootstrap-guide.js

@@ -0,0 +1,112 @@
+import { COMMAND_SNIPPETS } from "./command-snippets.js";
+export const AGENT_BOOTSTRAP_DOC_PATH = "docs/user/agent-bootstrap.generated.mdx";
+export const BOOTSTRAP_PREFLIGHT_COMMANDS = [
+    "agentplane config show",
+    "agentplane quickstart",
+    "agentplane task list",
+    "git status --short --untracked-files=no",
+    "git rev-parse --abbrev-ref HEAD",
+];
+export const BOOTSTRAP_TASK_PREP_COMMANDS = [
+    COMMAND_SNIPPETS.core.taskNew,
+    'agentplane task plan set <task-id> --text "..." --updated-by <ROLE>',
+    "agentplane task plan approve <task-id> --by ORCHESTRATOR",
+];
+export const BOOTSTRAP_DIRECT_HAPPY_PATH_COMMANDS = [
+    ...BOOTSTRAP_TASK_PREP_COMMANDS,
+    COMMAND_SNIPPETS.core.startTask,
+    "agentplane task verify-show <task-id>",
+    COMMAND_SNIPPETS.core.verifyTask,
+    'agentplane finish <task-id> --author <ROLE> --body "Verified: ..." --result "..." --commit <git-rev>',
+];
+export const BOOTSTRAP_RECOVERY_COMMANDS = [
+    "agentplane doctor",
+    "agentplane upgrade --dry-run",
+    "agentplane upgrade",
+];
+export const BOOTSTRAP_SECTIONS = [
+    {
+        heading: "1. Preflight",
+        summary: "Establish workflow mode, current branch, current task state, and tracked working-tree state.",
+        commands: BOOTSTRAP_PREFLIGHT_COMMANDS,
+        notes: [
+            "Run this before any mutation.",
+            "If the project is not initialized, stop and use `agentplane init` first.",
+        ],
+    },
+    {
+        heading: "2. Direct happy path",
+        summary: "Use one short direct-mode route: create the task, approve it, start it, verify it, and finish it.",
+        commands: BOOTSTRAP_DIRECT_HAPPY_PATH_COMMANDS,
+        notes: [
+            "Use `task doc set` to fill required README sections before approval.",
+            "For dependent tasks, wait until upstream tasks are DONE before `task start-ready`.",
+            "`task plan approve` and `task start-ready` must run sequentially, never in parallel.",
+            "In `direct`, `finish` creates the deterministic close commit by default.",
+            "Treat `task verify-show` as the verification contract right before `verify` and `finish`.",
+        ],
+    },
+    {
+        heading: "3. Fallbacks and recovery",
+        summary: "Keep exceptional paths out of the normal route: use these only for recovery, framework upgrades, or branch_pr work.",
+        commands: BOOTSTRAP_RECOVERY_COMMANDS,
+        notes: [
+            "Run `doctor` before touching managed policy files by hand.",
+            "`upgrade` applies the managed framework files from the installed CLI bundle.",
+            "Manual close handling (`--no-close-commit`, `--close-unstage-others`) belongs here, not in the default direct path.",
+        ],
+    },
+];
+export function renderBootstrapReferenceLine() {
+    return `Canonical bootstrap doc: \`${AGENT_BOOTSTRAP_DOC_PATH}\`.`;
+}
+export function renderBootstrapSectionLines(sections) {
+    const lines = [];
+    for (const section of sections) {
+        lines.push(`## ${section.heading}`, "", section.summary, "");
+        for (const command of section.commands) {
+            lines.push(`- \`${command}\``);
+        }
+        if (section.notes && section.notes.length > 0) {
+            lines.push("");
+            for (const note of section.notes) {
+                lines.push(`- ${note}`);
+            }
+        }
+        lines.push("");
+    }
+    if (lines.at(-1) === "")
+        lines.pop();
+    return lines;
+}
+function renderCommandBlock(commands) {
+    return ["```bash", ...commands, "```"];
+}
+export function renderBootstrapDoc() {
+    const lines = [
+        "---",
+        'title: "Agent bootstrap"',
+        'description: "The shortest canonical startup path for agent work in an Agent Plane repository."',
+        "---",
+        "",
+        "This page is generated from `packages/agentplane/src/cli/bootstrap-guide.ts`.",
+        "",
+        "Use it as the single startup path for agents. `AGENTS.md`, `agentplane quickstart`, and `agentplane role <ROLE>` should point here instead of restating lifecycle prose.",
+        "",
+        "## Copy-paste start block",
+        "",
+        ...renderCommandBlock(BOOTSTRAP_PREFLIGHT_COMMANDS),
+        "",
+        "After preflight, stay on the direct happy path unless the repository state is broken or you are explicitly in `branch_pr`.",
+        "",
+        ...renderBootstrapSectionLines(BOOTSTRAP_SECTIONS),
+        "",
+        "## Non-default paths",
+        "",
+        "- `direct`: the default route is `task new/plan approve/start-ready -> task verify-show -> verify -> finish`.",
+        "- `branch_pr`: start a task branch/worktree, maintain PR artifacts, and let INTEGRATOR close on base.",
+        "- Use manual close flags only when a specific policy or recovery situation requires them.",
+        "",
+    ];
+    return `${lines.join("\n")}\n`;
+}

package/dist/cli/command-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AA0MA,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CA6FzC"}
+{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AA4GA,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAoCzC"}