agentplane 0.3.6 → 0.3.8

package/dist/commands/upgrade/policy.js

@@ -0,0 +1,182 @@
+export const INCIDENTS_POLICY_PATH = ".agentplane/policy/incidents.md";
+export const INCIDENTS_APPEND_MARKER = "<!-- AGENTPLANE:UPGRADE-APPEND incidents.md -->";
+export const CONFIG_REL_PATH = ".agentplane/config.json";
+export function isDeniedUpgradePath(relPath) {
+    if (relPath === CONFIG_REL_PATH)
+        return true;
+    if (relPath === ".agentplane/tasks.json")
+        return true;
+    if (relPath.startsWith(".agentplane/backends/"))
+        return true;
+    if (relPath.startsWith(".agentplane/worktrees/"))
+        return true;
+    if (relPath.startsWith(".agentplane/recipes/"))
+        return true;
+    if (relPath.startsWith(".agentplane/tasks/"))
+        return true;
+    if (relPath.startsWith(".agentplane/.upgrade/"))
+        return true;
+    if (relPath === ".git" || relPath.startsWith(".git/"))
+        return true;
+    return false;
+}
+export function isAllowedUpgradePath(relPath) {
+    if (relPath === "AGENTS.md")
+        return true;
+    if (relPath === "CLAUDE.md")
+        return true;
+    if (relPath.startsWith(".agentplane/agents/") && relPath.endsWith(".json"))
+        return true;
+    if (relPath.startsWith(".agentplane/policy/") &&
+        (relPath.endsWith(".md") ||
+            relPath.endsWith(".ts") ||
+            relPath.endsWith(".js") ||
+            relPath.endsWith(".mjs"))) {
+        return true;
+    }
+    return false;
+}
+function isJsonRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function canonicalizeJson(value) {
+    if (Array.isArray(value))
+        return value.map((item) => canonicalizeJson(item));
+    if (isJsonRecord(value)) {
+        const out = {};
+        for (const key of Object.keys(value).toSorted()) {
+            out[key] = canonicalizeJson(value[key]);
+        }
+        return out;
+    }
+    return value;
+}
+function jsonEqual(a, b) {
+    const canonicalA = JSON.stringify(canonicalizeJson(a)) ?? "__undefined__";
+    const canonicalB = JSON.stringify(canonicalizeJson(b)) ?? "__undefined__";
+    return canonicalA === canonicalB;
+}
+export function textChangedForType(opts) {
+    if (opts.aText === null && opts.bText === null)
+        return false;
+    if (opts.aText === null || opts.bText === null)
+        return true;
+    if (opts.type === "json") {
+        try {
+            const a = JSON.parse(opts.aText);
+            const b = JSON.parse(opts.bText);
+            return !jsonEqual(a, b);
+        }
+        catch {
+            return opts.aText.trim() !== opts.bText.trim();
+        }
+    }
+    return opts.aText.trimEnd() !== opts.bText.trimEnd();
+}
+function parseIncidentEntryBlocks(entriesBody) {
+    const lines = entriesBody.replaceAll("\r\n", "\n").split("\n");
+    const starts = [];
+    for (const [index, line] of lines.entries()) {
+        if (/^\s*-\s*id:\s+/i.test(line ?? ""))
+            starts.push(index);
+    }
+    const blocks = [];
+    for (const [idx, start] of starts.entries()) {
+        const end = starts.at(idx + 1) ?? lines.length;
+        const slice = lines.slice(start, end);
+        while (slice.length > 0 && !(slice[0] ?? "").trim())
+            slice.shift();
+        while (slice.length > 0 && !(slice.at(-1) ?? "").trim())
+            slice.pop();
+        const block = slice.join("\n").trim();
+        if (block)
+            blocks.push(block);
+    }
+    return blocks;
+}
+function normalizeEntryBlock(block) {
+    return block
+        .replaceAll("\r\n", "\n")
+        .split("\n")
+        .map((line) => line.trimEnd())
+        .join("\n")
+        .trim();
+}
+function splitEntriesSection(text) {
+    const lines = text.replaceAll("\r\n", "\n").split("\n");
+    const headingIndex = lines.findIndex((line) => /^\s*##\s+Entries\s*$/i.test(line));
+    if (headingIndex === -1)
+        return null;
+    let nextHeadingIndex = lines.length;
+    for (let index = headingIndex + 1; index < lines.length; index++) {
+        if (/^\s*##\s+/.test(lines[index] ?? "")) {
+            nextHeadingIndex = index;
+            break;
+        }
+    }
+    return {
+        before: lines.slice(0, headingIndex + 1).join("\n"),
+        entriesBody: lines.slice(headingIndex + 1, nextHeadingIndex).join("\n"),
+        after: lines.slice(nextHeadingIndex).join("\n"),
+    };
+}
+export function mergeIncidentsPolicy(opts) {
+    const incomingTrimmed = opts.incomingText.trim();
+    if (!incomingTrimmed)
+        return { nextText: opts.currentText, appended: false, appendedCount: 0 };
+    const incomingSection = splitEntriesSection(opts.incomingText);
+    const currentSection = splitEntriesSection(opts.currentText);
+    if (!incomingSection || !currentSection) {
+        return { nextText: opts.incomingText, appended: false, appendedCount: 0 };
+    }
+    const incomingBlocks = parseIncidentEntryBlocks(incomingSection.entriesBody).map((block) => normalizeEntryBlock(block));
+    const currentBlocks = parseIncidentEntryBlocks(currentSection.entriesBody).map((block) => normalizeEntryBlock(block));
+    if (currentBlocks.length === 0) {
+        return { nextText: opts.incomingText, appended: false, appendedCount: 0 };
+    }
+    const baselineSection = opts.baselineText ? splitEntriesSection(opts.baselineText) : null;
+    const baselineBlocks = baselineSection
+        ? parseIncidentEntryBlocks(baselineSection.entriesBody).map((block) => normalizeEntryBlock(block))
+        : [];
+    const baselineSet = new Set(baselineBlocks);
+    const incomingSet = new Set(incomingBlocks);
+    const userAdded = currentBlocks.filter((block) => {
+        if (baselineSet.size > 0 && baselineSet.has(block))
+            return false;
+        return true;
+    });
+    const toAppend = userAdded.filter((block) => !incomingSet.has(block));
+    if (toAppend.length === 0) {
+        return { nextText: opts.incomingText, appended: false, appendedCount: 0 };
+    }
+    const mergedBlocks = [...incomingBlocks, ...toAppend];
+    const renderedEntries = mergedBlocks.length > 0 ? `\n\n${mergedBlocks.join("\n\n")}\n` : "\n\n- None yet.\n";
+    const afterSuffix = incomingSection.after ? `\n${incomingSection.after.trimStart()}` : "";
+    const nextText = `${incomingSection.before.trimEnd()}` +
+        `${renderedEntries}` +
+        `${INCIDENTS_APPEND_MARKER}\n` +
+        `${afterSuffix}` +
+        "\n";
+    return { nextText, appended: true, appendedCount: toAppend.length };
+}
+export function normalizeUpgradeVersionLabel(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return "unknown";
+    if (/^v\d/i.test(trimmed))
+        return trimmed;
+    return `v${trimmed}`;
+}
+export function normalizeVersionForConfig(input) {
+    const trimmed = input.trim().replace(/^v/i, "");
+    return trimmed.length > 0 ? trimmed : null;
+}
+export function toUpgradeBaselineKey(rel) {
+    if (rel === "AGENTS.md")
+        return "AGENTS.md";
+    if (rel === "CLAUDE.md")
+        return "CLAUDE.md";
+    if (rel.startsWith(".agentplane/"))
+        return rel.slice(".agentplane/".length);
+    return null;
+}

package/dist/commands/upgrade/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/commands/upgrade/report.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,IAAI,CAQP;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CA2F3D"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/commands/upgrade/report.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGzE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,IAAI,CAQP;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CA2F3D"}

package/dist/commands/upgrade/report.js

@@ -1,15 +1,17 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { createCliEmitter } from "../../cli/output.js";
+const output = createCliEmitter();
 export function printUpgradeDryRun(opts) {
-    process.stdout.write(`Upgrade dry-run: ${opts.additions.length} add, ${opts.updates.length} update, ${opts.skipped.length} unchanged\n`);
+    output.line(`Upgrade dry-run: ${opts.additions.length} add, ${opts.updates.length} update, ${opts.skipped.length} unchanged`);
     for (const rel of opts.additions)
-        process.stdout.write(`ADD ${rel}\n`);
+        output.line(`ADD ${rel}`);
     for (const rel of opts.updates)
-        process.stdout.write(`UPDATE ${rel}\n`);
+        output.line(`UPDATE ${rel}`);
     for (const rel of opts.skipped)
-        process.stdout.write(`SKIP ${rel}\n`);
+        output.line(`SKIP ${rel}`);
     for (const rel of opts.merged)
-        process.stdout.write(`MERGE ${rel}\n`);
+        output.line(`MERGE ${rel}`);
 }
 export async function writeUpgradeAgentReview(opts) {
     const runId = new Date().toISOString().replaceAll(":", "-").replaceAll(".", "-");

package/dist/commands/upgrade.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.command.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAEzC,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CA8JlD,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CACsB,CAAC"}
+{"version":3,"file":"upgrade.command.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AAEzC,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,aAAa,CAwLlD,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,aAAa,CACsB,CAAC"}

package/dist/commands/upgrade.command.js

@@ -72,6 +72,12 @@ export const upgradeSpec = {
             default: false,
             description: "Report changes without modifying files.",
         },
+        {
+            kind: "boolean",
+            name: "migrate-task-docs",
+            default: false,
+            description: "After applying the framework upgrade, migrate legacy task README docs in the same run.",
+        },
         {
             kind: "boolean",
             name: "no-backup",
@@ -115,6 +121,10 @@ export const upgradeSpec = {
             cmd: "agentplane upgrade --bundle ./agentplane-upgrade.tar.gz --checksum ./agentplane-upgrade.tar.gz.sha256",
             why: "Upgrade from local bundle files (no network).",
         },
+        {
+            cmd: "agentplane upgrade --yes --migrate-task-docs",
+            why: "Apply the framework upgrade and migrate legacy task README docs in one operator run.",
+        },
     ],
     parse: (raw) => {
         const noBackup = raw.opts["no-backup"] === true;
@@ -130,6 +140,7 @@ export const upgradeSpec = {
             checksumAsset: raw.opts["checksum-asset"],
             dryRun: raw.opts["dry-run"] === true,
             backup: !noBackup,
+            migrateTaskDocs: raw.opts["migrate-task-docs"] === true,
             yes: raw.opts.yes === true,
         };
     },
@@ -151,6 +162,20 @@ export const upgradeSpec = {
                 message: "Remote upgrade options (--tag/--source/--asset/--checksum-asset) require --remote.",
             });
         }
+        if (p.migrateTaskDocs && p.mode === "agent") {
+            throw usageError({
+                spec: upgradeSpec,
+                command: "upgrade",
+                message: "Option --migrate-task-docs cannot be used with --agent.",
+            });
+        }
+        if (p.migrateTaskDocs && p.dryRun) {
+            throw usageError({
+                spec: upgradeSpec,
+                command: "upgrade",
+                message: "Option --migrate-task-docs cannot be used with --dry-run.",
+            });
+        }
     },
 };
 export const runUpgrade = (ctx, flags) => cmdUpgradeParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride, flags });

package/dist/commands/upgrade.d.ts

@@ -10,6 +10,7 @@ export type UpgradeFlags = {
     allowTarball: boolean;
     dryRun: boolean;
     backup: boolean;
+    migrateTaskDocs: boolean;
     yes: boolean;
 };
 export declare function cmdUpgradeParsed(opts: {

package/dist/commands/upgrade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AA4CA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAuMF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsiBlB;AAED,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,iCAAiC,GAClC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAgCA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAIF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoQlB;AAED,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,iCAAiC,GAClC,MAAM,qBAAqB,CAAC"}