agentplane 0.3.23 → 0.3.26

package/dist/commands/upgrade/plan.js

@@ -1,219 +0,0 @@
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { fileExists, getPathKind } from "../../cli/fs-utils.js";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { CliError } from "../../shared/errors.js";
-import { INCIDENTS_POLICY_PATH, isAllowedUpgradePath, isDeniedUpgradePath, mergeIncidentsPolicy, textChangedForType, toUpgradeBaselineKey, } from "./policy.js";
-async function readUpgradeBaseline(opts) {
-    try {
-        return await readFile(path.join(opts.baselineDirNew, opts.baselineKey), "utf8");
-    }
-    catch {
-        try {
-            return await readFile(path.join(opts.baselineDirLegacy, opts.baselineKey), "utf8");
-        }
-        catch {
-            return null;
-        }
-    }
-}
-async function resolvePolicyGatewayRel(gitRoot) {
-    if (await fileExists(path.join(gitRoot, "AGENTS.md")))
-        return "AGENTS.md";
-    if (await fileExists(path.join(gitRoot, "CLAUDE.md")))
-        return "CLAUDE.md";
-    return "AGENTS.md";
-}
-export async function planManagedUpgrade(opts) {
-    const additions = [];
-    const updates = [];
-    const skipped = [];
-    const merged = [];
-    const fileContents = new Map();
-    const missingRequired = [];
-    const reviewRecords = [];
-    let incidentsAppendedCount = 0;
-    const policyGatewayRel = await resolvePolicyGatewayRel(opts.gitRoot);
-    const remapManagedGatewayRel = (rel) => {
-        if (rel === "AGENTS.md" && policyGatewayRel === "CLAUDE.md")
-            return "CLAUDE.md";
-        return rel;
-    };
-    for (const entry of opts.manifest.files) {
-        const relRaw = entry.path.replaceAll("\\", "/").trim();
-        if (!relRaw || relRaw.startsWith("..") || path.isAbsolute(relRaw)) {
-            throw new CliError({
-                exitCode: 3,
-                code: "E_VALIDATION",
-                message: `Invalid manifest path: ${entry.path}`,
-            });
-        }
-        if (isDeniedUpgradePath(relRaw)) {
-            throw new CliError({
-                exitCode: 3,
-                code: "E_VALIDATION",
-                message: `Manifest includes a denied path: ${relRaw}`,
-            });
-        }
-        if (!isAllowedUpgradePath(relRaw)) {
-            throw new CliError({
-                exitCode: 3,
-                code: "E_VALIDATION",
-                message: `Manifest path not allowed: ${relRaw}`,
-            });
-        }
-        const rel = remapManagedGatewayRel(relRaw);
-        const destPath = path.join(opts.gitRoot, rel);
-        const kind = await getPathKind(destPath);
-        if (kind === "dir") {
-            throw new CliError({
-                exitCode: exitCodeForError("E_IO"),
-                code: "E_IO",
-                message: `Upgrade target is a directory: ${rel}`,
-            });
-        }
-        const sourceRelRaw = (entry.source_path ?? entry.path).replaceAll("\\", "/").trim();
-        const mappedSourceRel = rel === "CLAUDE.md" && sourceRelRaw === "AGENTS.md" ? "CLAUDE.md" : sourceRelRaw;
-        const sourceCandidates = [...new Set([mappedSourceRel, sourceRelRaw])];
-        let incomingData = null;
-        for (const candidate of sourceCandidates) {
-            try {
-                incomingData = await readFile(path.join(opts.bundleRoot, candidate));
-                break;
-            }
-            catch {
-                // try next candidate
-            }
-        }
-        if (!incomingData) {
-            if (entry.required)
-                missingRequired.push(rel);
-            continue;
-        }
-        let existingBuf = null;
-        if (kind !== null) {
-            existingBuf = await readFile(destPath);
-        }
-        const incomingTextOriginal = incomingData.toString("utf8");
-        const currentTextForReview = existingBuf ? existingBuf.toString("utf8") : null;
-        const baselineKey = toUpgradeBaselineKey(rel);
-        const baselineText = baselineKey
-            ? await readUpgradeBaseline({
-                baselineDirNew: opts.baselineDirNew,
-                baselineDirLegacy: opts.baselineDirLegacy,
-                baselineKey,
-            })
-            : null;
-        const hasBaseline = baselineText !== null;
-        const changedCurrentVsBaseline = hasBaseline && currentTextForReview !== null
-            ? textChangedForType({
-                type: entry.type,
-                aText: currentTextForReview,
-                bText: baselineText,
-            })
-            : null;
-        const changedIncomingVsBaseline = hasBaseline
-            ? textChangedForType({
-                type: entry.type,
-                aText: incomingTextOriginal,
-                bText: baselineText,
-            })
-            : null;
-        const currentAndIncomingEqual = currentTextForReview === null
-            ? false
-            : textChangedForType({
-                type: entry.type,
-                aText: currentTextForReview,
-                bText: incomingTextOriginal,
-            }) === false;
-        if (currentTextForReview !== null && currentAndIncomingEqual) {
-            skipped.push(rel);
-            reviewRecords.push({
-                relPath: rel,
-                mergeStrategy: entry.merge_strategy,
-                hasBaseline,
-                changedCurrentVsBaseline,
-                changedIncomingVsBaseline,
-                currentDiffersFromIncoming: false,
-                needsSemanticReview: false,
-                mergeApplied: false,
-                mergePath: "none",
-            });
-            continue;
-        }
-        if (currentTextForReview !== null && changedCurrentVsBaseline === false) {
-            updates.push(rel);
-            fileContents.set(rel, incomingData);
-            reviewRecords.push({
-                relPath: rel,
-                mergeStrategy: entry.merge_strategy,
-                hasBaseline,
-                changedCurrentVsBaseline,
-                changedIncomingVsBaseline,
-                currentDiffersFromIncoming: true,
-                needsSemanticReview: false,
-                mergeApplied: false,
-                mergePath: "none",
-            });
-            continue;
-        }
-        let mergeApplied = false;
-        let mergePath = "none";
-        let nextData = incomingData;
-        if (existingBuf && rel === INCIDENTS_POLICY_PATH) {
-            const mergedIncidents = mergeIncidentsPolicy({
-                incomingText: incomingData.toString("utf8"),
-                currentText: existingBuf.toString("utf8"),
-                baselineText,
-            });
-            nextData = Buffer.from(mergedIncidents.nextText, "utf8");
-            if (mergedIncidents.appended) {
-                merged.push(rel);
-                mergeApplied = true;
-                mergePath = "incidentsAppend";
-                incidentsAppendedCount += mergedIncidents.appendedCount;
-            }
-        }
-        const currentDiffersFromIncoming = currentTextForReview === null
-            ? false
-            : textChangedForType({
-                type: entry.type,
-                aText: currentTextForReview,
-                bText: incomingTextOriginal,
-            });
-        reviewRecords.push({
-            relPath: rel,
-            mergeStrategy: entry.merge_strategy,
-            hasBaseline,
-            changedCurrentVsBaseline,
-            changedIncomingVsBaseline,
-            currentDiffersFromIncoming,
-            needsSemanticReview: false,
-            mergeApplied,
-            mergePath,
-        });
-        fileContents.set(rel, nextData);
-        if (kind === null)
-            additions.push(rel);
-        else if (existingBuf && Buffer.compare(existingBuf, nextData) === 0)
-            skipped.push(rel);
-        else
-            updates.push(rel);
-    }
-    if (missingRequired.length > 0) {
-        throw new CliError({
-            exitCode: 3,
-            code: "E_VALIDATION",
-            message: `Upgrade bundle is missing required managed files: ${missingRequired.join(", ")}`,
-        });
-    }
-    return {
-        additions,
-        updates,
-        skipped,
-        merged,
-        fileContents,
-        reviewRecords,
-        incidentsAppendedCount,
-    };
-}

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

@@ -1,24 +0,0 @@
-import type { FrameworkManifestEntry } from "./types.js";
-export declare const INCIDENTS_POLICY_PATH = ".agentplane/policy/incidents.md";
-export declare const INCIDENTS_APPEND_MARKER = "<!-- AGENTPLANE:UPGRADE-APPEND incidents.md -->";
-export declare const CONFIG_REL_PATH = ".agentplane/config.json";
-export declare function isDeniedUpgradePath(relPath: string): boolean;
-export declare function isAllowedUpgradePath(relPath: string): boolean;
-export declare function textChangedForType(opts: {
-    type: FrameworkManifestEntry["type"];
-    aText: string | null;
-    bText: string | null;
-}): boolean;
-export declare function mergeIncidentsPolicy(opts: {
-    incomingText: string;
-    currentText: string;
-    baselineText: string | null;
-}): {
-    nextText: string;
-    appended: boolean;
-    appendedCount: number;
-};
-export declare function normalizeUpgradeVersionLabel(input: string): string;
-export declare function normalizeVersionForConfig(input: string): string | null;
-export declare function toUpgradeBaselineKey(rel: string): string | null;
-//# sourceMappingURL=policy.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/commands/upgrade/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,eAAO,MAAM,qBAAqB,oCAAoC,CAAC;AACvE,eAAO,MAAM,uBAAuB,oDAAoD,CAAC;AACzF,eAAO,MAAM,eAAe,4BAA4B,CAAC;AAEzD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU5D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAc7D;AAwBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GAAG,OAAO,CAaV;AAqDD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,CAiDA;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D"}

package/dist/commands/upgrade/policy.js

@@ -1,182 +0,0 @@
-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

@@ -1,21 +0,0 @@
-import type { FrameworkManifest, UpgradeReviewRecord } from "./types.js";
-export declare function printUpgradeDryRun(opts: {
-    additions: string[];
-    updates: string[];
-    skipped: string[];
-    merged: string[];
-}): void;
-export declare function writeUpgradeAgentReview(opts: {
-    gitRoot: string;
-    runRoot: string;
-    manifest: FrameworkManifest;
-    additions: string[];
-    updates: string[];
-    skipped: string[];
-    merged: string[];
-    reviewRecords: UpgradeReviewRecord[];
-}): Promise<{
-    relRunDir: string;
-    needsReviewCount: number;
-}>;
-//# sourceMappingURL=report.d.ts.map

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

@@ -1 +0,0 @@
-{"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,83 +0,0 @@
-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) {
-    output.line(`Upgrade dry-run: ${opts.additions.length} add, ${opts.updates.length} update, ${opts.skipped.length} unchanged`);
-    for (const rel of opts.additions)
-        output.line(`ADD ${rel}`);
-    for (const rel of opts.updates)
-        output.line(`UPDATE ${rel}`);
-    for (const rel of opts.skipped)
-        output.line(`SKIP ${rel}`);
-    for (const rel of opts.merged)
-        output.line(`MERGE ${rel}`);
-}
-export async function writeUpgradeAgentReview(opts) {
-    const runId = new Date().toISOString().replaceAll(":", "-").replaceAll(".", "-");
-    const runDir = path.join(opts.runRoot, runId);
-    await mkdir(runDir, { recursive: true });
-    const managedFiles = opts.manifest.files.map((f) => f.path.replaceAll("\\", "/").trim());
-    const needsReviewCount = opts.reviewRecords.filter((r) => r.needsSemanticReview).length;
-    const planMd = `# agentplane upgrade plan (${runId})\n\n` +
-        `Mode: agent-assisted review (no files modified)\n\n` +
-        `## Summary\n\n` +
-        `- additions: ${opts.additions.length}\n` +
-        `- updates: ${opts.updates.length}\n` +
-        `- unchanged: ${opts.skipped.length}\n` +
-        `- merged (auto-safe transforms already applied to incoming): ${opts.merged.length}\n\n` +
-        `## Managed files (manifest)\n\n` +
-        managedFiles.map((p) => `- ${p}`).join("\n") +
-        `\n\n` +
-        `## Proposed changes\n\n` +
-        opts.additions.map((p) => `- ADD ${p}`).join("\n") +
-        (opts.additions.length > 0 ? "\n" : "") +
-        opts.updates.map((p) => `- UPDATE ${p}`).join("\n") +
-        (opts.updates.length > 0 ? "\n" : "") +
-        opts.merged.map((p) => `- MERGE ${p}`).join("\n") +
-        (opts.merged.length > 0 ? "\n" : "") +
-        opts.skipped.map((p) => `- SKIP ${p}`).join("\n") +
-        (opts.skipped.length > 0 ? "\n" : "") +
-        `\n` +
-        `## Next steps\n\n` +
-        `1. Review the proposed changes list.\n` +
-        `2. Apply changes manually or re-run without \`--agent\` to apply managed files.\n` +
-        `3. Run \`agentplane doctor\` (or \`agentplane doctor --fix\`) and ensure checks pass.\n`;
-    const constraintsMd = `# Upgrade constraints\n\n` +
-        `This upgrade is restricted to framework-managed files only.\n\n` +
-        `## Must not touch\n\n` +
-        `- .agentplane/tasks/** (task data)\n` +
-        `- .agentplane/tasks.json (export snapshot)\n` +
-        `- .agentplane/backends/** (backend configuration)\n` +
-        `- .agentplane/config.json (project config)\n` +
-        `- .git/**\n\n` +
-        `## Notes\n\n` +
-        `- The upgrade bundle is validated against framework.manifest.json.\n` +
-        `- The policy gateway file at workspace root is AGENTS.md or CLAUDE.md.\n`;
-    const reportMd = `# Upgrade report (${runId})\n\n` +
-        `## Actions taken\n\n` +
-        `- [ ] Reviewed plan.md\n` +
-        `- [ ] Applied changes (manual or --auto)\n` +
-        `- [ ] Ran doctor\n` +
-        `- [ ] Ran tests / lint\n\n` +
-        `## Notes\n\n` +
-        `- \n`;
-    await writeFile(path.join(runDir, "plan.md"), planMd, "utf8");
-    await writeFile(path.join(runDir, "constraints.md"), constraintsMd, "utf8");
-    await writeFile(path.join(runDir, "report.md"), reportMd, "utf8");
-    await writeFile(path.join(runDir, "files.json"), JSON.stringify({
-        additions: opts.additions,
-        updates: opts.updates,
-        skipped: opts.skipped,
-        merged: opts.merged,
-    }, null, 2) + "\n", "utf8");
-    await writeFile(path.join(runDir, "review.json"), JSON.stringify({
-        generated_at: new Date().toISOString(),
-        counts: {
-            total: opts.reviewRecords.length,
-            needsSemanticReview: needsReviewCount,
-        },
-        files: opts.reviewRecords,
-    }, null, 2) + "\n", "utf8");
-    return { relRunDir: path.relative(opts.gitRoot, runDir), needsReviewCount };
-}

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

@@ -1,34 +0,0 @@
-import type { FrameworkManifest, GitHubRelease } from "./types.js";
-export declare function describeUpgradeSource(opts: {
-    bundleLayout: "local_assets" | "upgrade_bundle" | "repo_tarball";
-    hasExplicitBundle: boolean;
-    useRemote: boolean;
-}): string;
-export declare function loadFrameworkManifestFromPath(manifestPath: string): Promise<FrameworkManifest>;
-export declare function normalizeFrameworkSourceForUpgrade(source: string): {
-    source: string;
-    owner: string;
-    repo: string;
-};
-export declare function resolveUpgradeDownloadFromRelease(opts: {
-    release: GitHubRelease;
-    owner: string;
-    repo: string;
-    assetName: string;
-    checksumName: string;
-}): {
-    kind: "assets";
-    bundleUrl: string;
-    checksumUrl: string;
-} | {
-    kind: "tarball";
-    tarballUrl: string;
-};
-export declare function resolveRepoTarballUrl(opts: {
-    release: GitHubRelease;
-    owner: string;
-    repo: string;
-    explicitTag?: string;
-}): string;
-export declare function resolveUpgradeRoot(extractedDir: string): Promise<string>;
-//# sourceMappingURL=source.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/commands/upgrade/source.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,YAAY,EAAE,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACjE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,MAAM,CAMT;AAED,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAW5B;AAmBD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,GAAG;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAGA;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,GACG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAqB1C;AAQD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAgBT;AAED,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ9E"}

package/dist/commands/upgrade/source.js

@@ -1,101 +0,0 @@
-import { readdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import { invalidFieldMessage, invalidValueMessage, requiredFieldMessage, } from "../../cli/output.js";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { CliError } from "../../shared/errors.js";
-export function describeUpgradeSource(opts) {
-    if (opts.bundleLayout === "local_assets")
-        return "local installed agentplane CLI assets";
-    if (opts.bundleLayout === "repo_tarball")
-        return "GitHub repo tarball fallback";
-    if (opts.hasExplicitBundle)
-        return "explicit upgrade bundle";
-    if (opts.useRemote)
-        return "GitHub release bundle";
-    return "upgrade bundle";
-}
-export async function loadFrameworkManifestFromPath(manifestPath) {
-    const text = await readFile(manifestPath, "utf8");
-    const parsed = JSON.parse(text);
-    if (parsed?.schema_version !== 1 || !Array.isArray(parsed?.files)) {
-        throw new CliError({
-            exitCode: 3,
-            code: "E_VALIDATION",
-            message: "Invalid framework.manifest.json (expected schema_version=1 and files array).",
-        });
-    }
-    return parsed;
-}
-function parseGitHubRepo(source) {
-    const trimmed = source.trim();
-    if (!trimmed)
-        throw new Error(requiredFieldMessage("config.framework.source"));
-    if (!trimmed.includes("github.com")) {
-        throw new Error(invalidFieldMessage("config.framework.source", "GitHub URL"));
-    }
-    try {
-        const url = new URL(trimmed);
-        const parts = url.pathname.replaceAll(".git", "").split("/").filter(Boolean);
-        if (parts.length < 2)
-            throw new Error(invalidValueMessage("GitHub repo URL", trimmed, "owner/repo"));
-        return { owner: parts[0], repo: parts[1] };
-    }
-    catch {
-        throw new Error(invalidValueMessage("GitHub repo URL", trimmed, "owner/repo"));
-    }
-}
-export function normalizeFrameworkSourceForUpgrade(source) {
-    const { owner, repo } = parseGitHubRepo(source);
-    return { source: `https://github.com/${owner}/${repo}`, owner, repo };
-}
-export function resolveUpgradeDownloadFromRelease(opts) {
-    const assets = Array.isArray(opts.release.assets) ? opts.release.assets : [];
-    const asset = assets.find((a) => a?.name === opts.assetName);
-    const checksumAsset = assets.find((a) => a?.name === opts.checksumName);
-    if (asset?.browser_download_url && checksumAsset?.browser_download_url) {
-        return {
-            kind: "assets",
-            bundleUrl: asset.browser_download_url,
-            checksumUrl: checksumAsset.browser_download_url,
-        };
-    }
-    const tarballUrl = typeof opts.release.tarball_url === "string" ? opts.release.tarball_url : "";
-    if (!tarballUrl) {
-        throw new CliError({
-            exitCode: exitCodeForError("E_NETWORK"),
-            code: "E_NETWORK",
-            message: `Upgrade assets not found in ${opts.owner}/${opts.repo} release`,
-        });
-    }
-    return { kind: "tarball", tarballUrl };
-}
-function buildCodeloadTarGzUrl(opts) {
-    const tag = opts.tag.trim();
-    if (!tag)
-        throw new Error("tag is required");
-    return `https://codeload.github.com/${opts.owner}/${opts.repo}/tar.gz/${encodeURIComponent(tag)}`;
-}
-export function resolveRepoTarballUrl(opts) {
-    const tag = (typeof opts.explicitTag === "string" && opts.explicitTag.trim()) ||
-        (typeof opts.release.tag_name === "string" && opts.release.tag_name.trim()) ||
-        "";
-    if (tag)
-        return buildCodeloadTarGzUrl({ owner: opts.owner, repo: opts.repo, tag });
-    const tarballUrl = typeof opts.release.tarball_url === "string" ? opts.release.tarball_url : "";
-    if (tarballUrl)
-        return tarballUrl;
-    throw new CliError({
-        exitCode: exitCodeForError("E_NETWORK"),
-        code: "E_NETWORK",
-        message: "GitHub release did not provide tag_name or tarball_url; cannot fall back to repo tarball.",
-    });
-}
-export async function resolveUpgradeRoot(extractedDir) {
-    const entries = await readdir(extractedDir, { withFileTypes: true });
-    const dirs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
-    const files = entries.filter((entry) => entry.isFile()).map((entry) => entry.name);
-    if (files.length === 0 && dirs.length === 1) {
-        return path.join(extractedDir, dirs[0]);
-    }
-    return extractedDir;
-}