agentplane 0.3.24 → 0.3.27

package/dist/commands/task/verify-rework.command.js

@@ -1,54 +0,0 @@
-import { cmdTaskVerifyRework } from "./verify-record.js";
-import { parseVerifyCommonOptions, validateVerifyDetailsFileExclusive, validateVerifyFindingSource, validateVerifyNonEmptyInput, validateVerifyNoteSource, verifyCommonOptions, } from "./verify-command-shared.js";
-export const taskVerifyReworkSpec = {
-    id: ["task", "verify", "rework"],
-    group: "Task",
-    summary: "Record verification as needs rework (resets commit, sets status to DOING, updates Verification).",
-    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
-    options: verifyCommonOptions,
-    examples: [
-        {
-            cmd: 'agentplane task verify rework 202602030608-F1Q8AB --by REVIEWER --note "Needs changes"',
-            why: "Record a needs-rework verification.",
-        },
-    ],
-    validateRaw: (raw) => {
-        validateVerifyDetailsFileExclusive(raw, taskVerifyReworkSpec, {
-            message: "Provide at most one of --details or --file.",
-        });
-        validateVerifyNonEmptyInput(raw, taskVerifyReworkSpec, "by");
-        validateVerifyNoteSource(raw, taskVerifyReworkSpec);
-        validateVerifyFindingSource(raw, taskVerifyReworkSpec);
-    },
-    parse: (raw) => ({
-        taskId: String(raw.args["task-id"]),
-        ...parseVerifyCommonOptions(raw),
-    }),
-};
-export function makeRunTaskVerifyReworkHandler(getCtx) {
-    return async (ctx, p) => {
-        return await cmdTaskVerifyRework({
-            ctx: await getCtx("task verify rework"),
-            cwd: ctx.cwd,
-            rootOverride: ctx.rootOverride,
-            taskId: p.taskId,
-            by: p.by,
-            note: p.note,
-            noteFile: p.noteFile,
-            details: p.details,
-            file: p.file,
-            collectIncidents: p.collectIncidents,
-            quiet: p.quiet,
-            observation: p.observation,
-            impact: p.impact,
-            resolution: p.resolution,
-            localOnly: p.localOnly,
-            repoFixable: p.repoFixable,
-            incidentScope: p.incidentScope,
-            incidentTags: p.incidentTags,
-            incidentMatch: p.incidentMatch,
-            incidentAdvice: p.incidentAdvice,
-            incidentRule: p.incidentRule,
-        });
-    };
-}

package/dist/commands/task/verify-show.command.d.ts

@@ -1,9 +0,0 @@
-import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
-import { type CommandContext } from "../shared/task-backend.js";
-export type TaskVerifyShowParsed = {
-    taskId: string;
-    quiet: boolean;
-};
-export declare const taskVerifyShowSpec: CommandSpec<TaskVerifyShowParsed>;
-export declare function makeRunTaskVerifyShowHandler(getCtx: (cmd: string) => Promise<CommandContext>): (ctx: CommandCtx, p: TaskVerifyShowParsed) => Promise<number>;
-//# sourceMappingURL=verify-show.command.d.ts.map

package/dist/commands/task/verify-show.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"verify-show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKrF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,oBAAoB,CA6BhE,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAC7E,KAAK,UAAU,EAAE,GAAG,oBAAoB,KAAG,OAAO,CAAC,MAAM,CAAC,CAkCzE"}

package/dist/commands/task/verify-show.command.js

@@ -1,69 +0,0 @@
-import { backendNotSupportedMessage } from "../../cli/output.js";
-import { CliError } from "../../shared/errors.js";
-import { loadTaskFromContext } from "../shared/task-backend.js";
-import { cmdTaskDocShow } from "./doc.js";
-import { assertVerifyStepsFilled, extractDocSection, isVerifyStepsFilled } from "./shared.js";
-export const taskVerifyShowSpec = {
-    id: ["task", "verify-show"],
-    group: "Task",
-    summary: 'Print the task Verify Steps acceptance contract (alias for task doc show --section "Verify Steps").',
-    args: [{ name: "task-id", required: true, valueHint: "<task-id>" }],
-    options: [
-        {
-            kind: "boolean",
-            name: "quiet",
-            default: false,
-            description: "Suppress errors when the section is missing.",
-        },
-    ],
-    examples: [
-        { cmd: "agentplane task verify-show 202602030608-F1Q8AB", why: "Print Verify Steps." },
-        {
-            cmd: "agentplane task verify-show 202602030608-F1Q8AB --quiet",
-            why: "Print Verify Steps without erroring when missing.",
-        },
-    ],
-    notes: [
-        "`## Verify Steps` is the ex-ante acceptance contract for the verifier.",
-        "Verification results are recorded later in `## Verification` via `agentplane verify ...`.",
-    ],
-    parse: (raw) => ({
-        taskId: String(raw.args["task-id"]),
-        quiet: raw.opts.quiet === true,
-    }),
-};
-export function makeRunTaskVerifyShowHandler(getCtx) {
-    return async (ctx, p) => {
-        const commandCtx = await getCtx("task verify-show");
-        const backend = commandCtx.taskBackend;
-        if (!backend.getTaskDoc) {
-            throw new CliError({
-                exitCode: 2,
-                code: "E_USAGE",
-                message: backendNotSupportedMessage("task docs"),
-            });
-        }
-        const task = await loadTaskFromContext({ ctx: commandCtx, taskId: p.taskId });
-        const doc = typeof task.doc === "string" ? task.doc : ((await backend.getTaskDoc(p.taskId)) ?? "");
-        const verifySteps = extractDocSection(doc, "Verify Steps");
-        if (!p.quiet) {
-            assertVerifyStepsFilled({
-                taskId: p.taskId,
-                sectionText: verifySteps,
-                action: "show Verify Steps",
-                guidance: "fill it before verification",
-            });
-        }
-        else if (!isVerifyStepsFilled(verifySteps)) {
-            return 0;
-        }
-        return await cmdTaskDocShow({
-            ctx: commandCtx,
-            cwd: ctx.cwd,
-            rootOverride: ctx.rootOverride,
-            taskId: p.taskId,
-            section: "Verify Steps",
-            quiet: p.quiet,
-        });
-    };
-}

package/dist/commands/task/verify.command.d.ts

@@ -1,7 +0,0 @@
-import type { CommandCtx, CommandSpec } from "../../cli/spec/spec.js";
-export type TaskVerifyParsed = {
-    subcommand?: string;
-};
-export declare const taskVerifySpec: CommandSpec<TaskVerifyParsed>;
-export declare function runTaskVerify(_ctx: CommandCtx, p: TaskVerifyParsed): Promise<number>;
-//# sourceMappingURL=verify.command.d.ts.map

package/dist/commands/task/verify.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"verify.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAYxD,CAAC;AAEF,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM1F"}

package/dist/commands/task/verify.command.js

@@ -1,21 +0,0 @@
-import { loadDirectSubcommandNames, throwGroupCommandUsage } from "../../cli/group-command.js";
-export const taskVerifySpec = {
-    id: ["task", "verify"],
-    group: "Task",
-    summary: "Record verification results (ok/rework).",
-    synopsis: [
-        "agentplane task verify ok <task-id> --by <id> --note <text> [--details <text> | --file <path>] [--quiet]",
-        "agentplane task verify rework <task-id> --by <id> --note <text> [--details <text> | --file <path>] [--quiet]",
-    ],
-    args: [{ name: "subcommand", required: false, valueHint: "<ok|rework>" }],
-    parse: (raw) => ({
-        subcommand: typeof raw.args.subcommand === "string" ? raw.args.subcommand : undefined,
-    }),
-};
-export async function runTaskVerify(_ctx, p) {
-    throwGroupCommandUsage({
-        spec: taskVerifySpec,
-        cmd: p.subcommand ? [p.subcommand] : [],
-        subcommands: await loadDirectSubcommandNames(["task", "verify"]),
-    });
-}

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

@@ -1,46 +0,0 @@
-import type { UpgradeReviewRecord } from "./types.js";
-export declare function cleanupAutoUpgradeArtifacts(opts: {
-    upgradeStateDir: string;
-    createdBackups: string[];
-}): Promise<void>;
-export declare function ensureCleanTrackedTreeForUpgrade(gitRoot: string): Promise<void>;
-export declare function createUpgradeCommit(opts: {
-    gitRoot: string;
-    paths: string[];
-    tasksPath: string;
-    workflowDir: string;
-    versionLabel: string;
-    source: "local_assets" | "upgrade_bundle" | "repo_tarball";
-    additions: number;
-    updates: number;
-    unchanged: number;
-    incidentsAppendedCount: number;
-}): Promise<{
-    hash: string;
-    subject: string;
-} | null>;
-export declare function applyManagedFiles(opts: {
-    gitRoot: string;
-    additions: string[];
-    updates: string[];
-    backup: boolean;
-    fileContents: Map<string, Buffer>;
-    baselineDir: string;
-    createdBackups: string[];
-    toBaselineKey: (rel: string) => string | null;
-}): Promise<void>;
-export declare function persistUpgradeState(opts: {
-    agentplaneDir: string;
-    rawConfig: Record<string, unknown>;
-    normalizedSourceToPersist: string | null;
-    expectedCliVersionToPersist: string | null;
-    hasManagedMutations: boolean;
-    statePath: string;
-    upgradeStateDir: string;
-    source: "local_assets" | "upgrade_bundle" | "repo_tarball";
-    reviewRecords: UpgradeReviewRecord[];
-    additions: number;
-    updates: number;
-    skipped: number;
-}): Promise<boolean>;
-//# sourceMappingURL=apply.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/commands/upgrade/apply.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAUtD,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB;AAED,wBAAsB,gCAAgC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BrF;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAC;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA8FpD;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAC/C,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ChB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAC;IAC3D,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,OAAO,CAAC,CA4CnB"}

package/dist/commands/upgrade/apply.js

@@ -1,213 +0,0 @@
-import { setByDottedKey, saveConfig } from "@agentplaneorg/core/config";
-import { lstat, mkdir, readlink, rm, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { backupPath, fileExists } from "../../cli/fs-utils.js";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { withDiagnosticContext } from "../shared/diagnostics.js";
-import { CliError } from "../../shared/errors.js";
-import { protectedPathKindForFile } from "../../shared/protected-paths.js";
-import { execFileAsync } from "@agentplaneorg/core/process";
-import { gitEnv } from "@agentplaneorg/core/git";
-async function safeRemovePath(targetPath) {
-    try {
-        await rm(targetPath, { recursive: true, force: true });
-    }
-    catch {
-        // best-effort cleanup
-    }
-}
-export async function cleanupAutoUpgradeArtifacts(opts) {
-    for (const backupPath of opts.createdBackups) {
-        await safeRemovePath(backupPath);
-    }
-    await safeRemovePath(path.join(opts.upgradeStateDir, "agent"));
-}
-export async function ensureCleanTrackedTreeForUpgrade(gitRoot) {
-    const { stdout } = await execFileAsync("git", ["status", "--short", "--untracked-files=no"], {
-        cwd: gitRoot,
-        env: gitEnv(),
-        maxBuffer: 10 * 1024 * 1024,
-    });
-    const dirty = String(stdout ?? "")
-        .split(/\r?\n/u)
-        .map((line) => line.trimEnd())
-        .filter((line) => line.length > 0);
-    if (dirty.length === 0)
-        return;
-    throw new CliError({
-        exitCode: exitCodeForError("E_GIT"),
-        code: "E_GIT",
-        message: "Upgrade --auto requires a clean tracked working tree.\n" +
-            `Found tracked changes:\n${dirty.map((line) => `  ${line}`).join("\n")}`,
-        context: withDiagnosticContext({ command: "upgrade" }, {
-            state: "managed upgrade cannot apply over tracked local edits",
-            likelyCause: "auto-apply upgrade is about to replace framework-managed files, but the repository already has tracked modifications",
-            nextAction: {
-                command: "git status --short --untracked-files=no",
-                reason: "inspect or clear tracked changes before rerunning `agentplane upgrade --yes`",
-                reasonCode: "upgrade_dirty_tree",
-            },
-        }),
-    });
-}
-export async function createUpgradeCommit(opts) {
-    const uniquePaths = [...new Set(opts.paths.filter(Boolean))];
-    if (uniquePaths.length === 0)
-        return null;
-    await execFileAsync("git", ["add", "--", ...uniquePaths], {
-        cwd: opts.gitRoot,
-        env: gitEnv(),
-        maxBuffer: 10 * 1024 * 1024,
-    });
-    const { stdout: stagedOut } = await execFileAsync("git", ["diff", "--cached", "--name-only", "-z"], {
-        cwd: opts.gitRoot,
-        env: gitEnv(),
-        encoding: "buffer",
-        maxBuffer: 10 * 1024 * 1024,
-    });
-    const staged = (Buffer.isBuffer(stagedOut) ? stagedOut.toString("utf8") : String(stagedOut ?? ""))
-        .split("\0")
-        .map((entry) => entry.trim())
-        .some(Boolean);
-    if (!staged)
-        return null;
-    const subject = `⬆️ upgrade: apply framework ${opts.versionLabel}`;
-    const body = `Upgrade-Version: ${opts.versionLabel}\n` +
-        `Source: ${opts.source}\n` +
-        `Managed-Changes: add=${opts.additions}, update=${opts.updates}, unchanged=${opts.unchanged}\n` +
-        `Incidents-Appended: ${opts.incidentsAppendedCount}\n`;
-    const allow = {
-        allowTasks: false,
-        allowPolicy: false,
-        allowConfig: false,
-        allowHooks: false,
-        allowCI: false,
-    };
-    for (const filePath of uniquePaths) {
-        const kind = protectedPathKindForFile({
-            filePath,
-            tasksPath: opts.tasksPath,
-            workflowDir: opts.workflowDir,
-        });
-        if (kind === "tasks")
-            allow.allowTasks = true;
-        if (kind === "policy")
-            allow.allowPolicy = true;
-        if (kind === "config")
-            allow.allowConfig = true;
-        if (kind === "hooks")
-            allow.allowHooks = true;
-        if (kind === "ci")
-            allow.allowCI = true;
-    }
-    try {
-        await execFileAsync("git", ["commit", "-m", subject, "-m", body], {
-            cwd: opts.gitRoot,
-            env: {
-                ...gitEnv(),
-                AGENTPLANE_ALLOW_TASKS: allow.allowTasks ? "1" : "0",
-                AGENTPLANE_ALLOW_POLICY: allow.allowPolicy ? "1" : "0",
-                AGENTPLANE_ALLOW_CONFIG: allow.allowConfig ? "1" : "0",
-                AGENTPLANE_ALLOW_HOOKS: allow.allowHooks ? "1" : "0",
-                AGENTPLANE_ALLOW_CI: allow.allowCI ? "1" : "0",
-            },
-            maxBuffer: 10 * 1024 * 1024,
-        });
-    }
-    catch (err) {
-        const details = err?.stderr ?? "";
-        throw new CliError({
-            exitCode: exitCodeForError("E_GIT"),
-            code: "E_GIT",
-            message: "Upgrade applied but failed to create the upgrade commit.\n" +
-                "Fix commit policy/hook issues and commit the staged upgrade files as a dedicated upgrade commit.\n" +
-                (String(details).trim() ? `Details:\n${String(details).trim()}` : ""),
-            context: withDiagnosticContext({ command: "upgrade" }, {
-                state: "managed files were updated, but the upgrade commit was blocked",
-                likelyCause: "the generated upgrade commit hit a git hook or commit policy failure after the framework files were already staged",
-                nextAction: {
-                    command: `git commit -m "⬆️ upgrade: apply framework ${opts.versionLabel}"`,
-                    reason: "record the already-staged framework changes as one dedicated upgrade commit after fixing the blocking hook or policy",
-                    reasonCode: "upgrade_commit_blocked",
-                },
-            }),
-        });
-    }
-    const { stdout: hashOut } = await execFileAsync("git", ["rev-parse", "HEAD"], {
-        cwd: opts.gitRoot,
-        env: gitEnv(),
-    });
-    return { hash: String(hashOut ?? "").trim(), subject };
-}
-export async function applyManagedFiles(opts) {
-    for (const rel of [...opts.additions, ...opts.updates]) {
-        const destPath = path.join(opts.gitRoot, rel);
-        if (opts.backup && (await fileExists(destPath))) {
-            const backup = await backupPath(destPath);
-            opts.createdBackups.push(backup);
-        }
-        await mkdir(path.dirname(destPath), { recursive: true });
-        const data = opts.fileContents.get(rel);
-        if (data) {
-            if (rel === "AGENTS.md" || rel === "CLAUDE.md") {
-                try {
-                    const st = await lstat(destPath);
-                    if (st.isSymbolicLink()) {
-                        const linkTarget = await readlink(destPath);
-                        const targetAbs = path.resolve(path.dirname(destPath), linkTarget);
-                        const relFromRoot = path.relative(opts.gitRoot, targetAbs);
-                        if (relFromRoot.startsWith("..") || path.isAbsolute(relFromRoot)) {
-                            throw new CliError({
-                                exitCode: exitCodeForError("E_VALIDATION"),
-                                code: "E_VALIDATION",
-                                message: `Refusing to overwrite symlinked ${rel} target outside repo: ${linkTarget}. ` +
-                                    "Replace the symlink with a regular file and retry.",
-                            });
-                        }
-                    }
-                }
-                catch (err) {
-                    const code = err?.code;
-                    if (code !== "ENOENT")
-                        throw err;
-                }
-            }
-            await writeFile(destPath, data);
-        }
-        const baselineKey = opts.toBaselineKey(rel);
-        if (baselineKey && data) {
-            const baselinePath = path.join(opts.baselineDir, baselineKey);
-            await mkdir(path.dirname(baselinePath), { recursive: true });
-            await writeFile(baselinePath, data);
-        }
-    }
-}
-export async function persistUpgradeState(opts) {
-    const hasSourceMigration = opts.normalizedSourceToPersist !== null;
-    const shouldMutateConfig = opts.hasManagedMutations || hasSourceMigration;
-    if (shouldMutateConfig) {
-        const raw = { ...opts.rawConfig };
-        if (opts.normalizedSourceToPersist) {
-            setByDottedKey(raw, "framework.source", opts.normalizedSourceToPersist);
-        }
-        setByDottedKey(raw, "framework.last_update", new Date().toISOString());
-        if (opts.expectedCliVersionToPersist) {
-            setByDottedKey(raw, "framework.cli.expected_version", opts.expectedCliVersionToPersist);
-        }
-        await saveConfig(opts.agentplaneDir, raw);
-    }
-    await writeFile(opts.statePath, JSON.stringify({
-        applied_at: new Date().toISOString(),
-        source: opts.source,
-        updated: { add: opts.additions, update: opts.updates, unchanged: opts.skipped },
-    }, null, 2) + "\n", "utf8");
-    await writeFile(path.join(opts.upgradeStateDir, "last-review.json"), JSON.stringify({
-        generated_at: new Date().toISOString(),
-        counts: {
-            total: opts.reviewRecords.length,
-            needsSemanticReview: opts.reviewRecords.filter((r) => r.needsSemanticReview).length,
-        },
-        files: opts.reviewRecords,
-    }, null, 2) + "\n", "utf8");
-    return shouldMutateConfig;
-}

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

@@ -1,28 +0,0 @@
-import type { FrameworkManifest } from "./types.js";
-type MaterializeFlags = {
-    source?: string;
-    tag?: string;
-    bundle?: string;
-    checksum?: string;
-    asset?: string;
-    checksumAsset?: string;
-    remote: boolean;
-    allowTarball: boolean;
-};
-export type MaterializedUpgrade = {
-    tempRoot: string;
-    extractRoot: string | null;
-    bundleLayout: "local_assets" | "upgrade_bundle" | "repo_tarball";
-    bundleRoot: string;
-    manifest: FrameworkManifest;
-    normalizedSourceToPersist: string | null;
-    upgradeVersionLabel: string;
-};
-export declare function materializeUpgradeSource(opts: {
-    flags: MaterializeFlags;
-    frameworkSource: string;
-    assetsDirUrl: URL;
-    ensureApproved: (reason: string) => Promise<void>;
-}): Promise<MaterializedUpgrade>;
-export {};
-//# sourceMappingURL=materialize.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../../src/commands/upgrade/materialize.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,YAAY,CAAC;AAOnE,KAAK,gBAAgB,GAAG;IACtB,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,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,KAAK,EAAE,gBAAgB,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,GAAG,CAAC;IAClB,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqJ/B"}

package/dist/commands/upgrade/materialize.js

@@ -1,147 +0,0 @@
-import { mkdtemp, readFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { downloadToFile, fetchJson } from "../../cli/http.js";
-import { parseSha256Text, sha256File } from "../../cli/checksum.js";
-import { extractArchive } from "../../cli/archive.js";
-import { exitCodeForError } from "../../cli/exit-codes.js";
-import { warnMessage } from "../../cli/output.js";
-import { getVersion } from "../../meta/version.js";
-import { CliError } from "../../shared/errors.js";
-import { normalizeUpgradeVersionLabel } from "./policy.js";
-import { loadFrameworkManifestFromPath, normalizeFrameworkSourceForUpgrade, resolveRepoTarballUrl, resolveUpgradeDownloadFromRelease, resolveUpgradeRoot, } from "./source.js";
-const DEFAULT_UPGRADE_ASSET = "agentplane-upgrade.tar.gz";
-const DEFAULT_UPGRADE_CHECKSUM_ASSET = "agentplane-upgrade.tar.gz.sha256";
-const UPGRADE_DOWNLOAD_TIMEOUT_MS = 60_000;
-const UPGRADE_RELEASE_METADATA_TIMEOUT_MS = 15_000;
-export async function materializeUpgradeSource(opts) {
-    const { flags } = opts;
-    const hasBundle = Boolean(flags.bundle);
-    const hasRemoteHints = Boolean(flags.source) ||
-        Boolean(flags.tag) ||
-        Boolean(flags.asset) ||
-        Boolean(flags.checksumAsset);
-    const useRemote = flags.remote === true || hasRemoteHints;
-    const tempRoot = await mkdtemp(path.join(os.tmpdir(), "agentplane-upgrade-"));
-    let extractRoot = null;
-    let bundleLayout = "upgrade_bundle";
-    let bundleRoot = "";
-    let normalizedSourceToPersist = null;
-    let upgradeVersionLabel = normalizeUpgradeVersionLabel(getVersion());
-    let manifestPath = "";
-    if (!hasBundle && !useRemote) {
-        bundleLayout = "local_assets";
-        bundleRoot = fileURLToPath(opts.assetsDirUrl);
-        manifestPath = fileURLToPath(new URL("framework.manifest.json", opts.assetsDirUrl));
-    }
-    else {
-        let bundlePath = "";
-        let checksumPath = "";
-        if (flags.bundle) {
-            const bundleIsUrl = flags.bundle.startsWith("http://") || flags.bundle.startsWith("https://");
-            bundlePath = bundleIsUrl ? path.join(tempRoot, "bundle.tar.gz") : path.resolve(flags.bundle);
-            if (bundleIsUrl) {
-                await opts.ensureApproved("upgrade downloads the bundle/checksum from the network");
-                await downloadToFile(flags.bundle, bundlePath, UPGRADE_DOWNLOAD_TIMEOUT_MS);
-            }
-            const checksumValue = flags.checksum ?? "";
-            const checksumIsUrl = checksumValue.startsWith("http://") || checksumValue.startsWith("https://");
-            checksumPath = checksumIsUrl
-                ? path.join(tempRoot, "bundle.tar.gz.sha256")
-                : path.resolve(checksumValue);
-            if (checksumIsUrl) {
-                await opts.ensureApproved("upgrade downloads the bundle/checksum from the network");
-                await downloadToFile(checksumValue, checksumPath, UPGRADE_DOWNLOAD_TIMEOUT_MS);
-            }
-        }
-        else {
-            const originalSource = flags.source ?? opts.frameworkSource;
-            const normalized = normalizeFrameworkSourceForUpgrade(originalSource);
-            const releaseUrl = flags.tag
-                ? `https://api.github.com/repos/${normalized.owner}/${normalized.repo}/releases/tags/${flags.tag}`
-                : `https://api.github.com/repos/${normalized.owner}/${normalized.repo}/releases/latest`;
-            await opts.ensureApproved("upgrade fetches release metadata and downloads assets from the network");
-            const release = (await fetchJson(releaseUrl, UPGRADE_RELEASE_METADATA_TIMEOUT_MS));
-            const releaseTag = (typeof release.tag_name === "string" && release.tag_name.trim()) ||
-                (typeof flags.tag === "string" && flags.tag.trim()) ||
-                "";
-            if (releaseTag) {
-                upgradeVersionLabel = normalizeUpgradeVersionLabel(releaseTag);
-            }
-            const download = resolveUpgradeDownloadFromRelease({
-                release,
-                owner: normalized.owner,
-                repo: normalized.repo,
-                assetName: flags.asset ?? DEFAULT_UPGRADE_ASSET,
-                checksumName: flags.checksumAsset ?? DEFAULT_UPGRADE_CHECKSUM_ASSET,
-            });
-            if (download.kind === "assets") {
-                bundlePath = path.join(tempRoot, flags.asset ?? DEFAULT_UPGRADE_ASSET);
-                checksumPath = path.join(tempRoot, flags.checksumAsset ?? DEFAULT_UPGRADE_CHECKSUM_ASSET);
-                await downloadToFile(download.bundleUrl, bundlePath, UPGRADE_DOWNLOAD_TIMEOUT_MS);
-                await downloadToFile(download.checksumUrl, checksumPath, UPGRADE_DOWNLOAD_TIMEOUT_MS);
-            }
-            else {
-                if (!flags.allowTarball) {
-                    throw new CliError({
-                        exitCode: exitCodeForError("E_NETWORK"),
-                        code: "E_NETWORK",
-                        message: `Upgrade assets ${flags.asset ?? DEFAULT_UPGRADE_ASSET}/${flags.checksumAsset ?? DEFAULT_UPGRADE_CHECKSUM_ASSET} not found in ${normalized.owner}/${normalized.repo} release. ` +
-                            "Publish the upgrade bundle assets, or re-run with --allow-tarball to download a repo tarball (no checksum verification).",
-                    });
-                }
-                process.stderr.write(`${warnMessage(`upgrade release does not include ${flags.asset ?? DEFAULT_UPGRADE_ASSET}/${flags.checksumAsset ?? DEFAULT_UPGRADE_CHECKSUM_ASSET}; falling back to repo tarball without checksum verification`)}\n`);
-                bundleLayout = "repo_tarball";
-                bundlePath = path.join(tempRoot, "source.tar.gz");
-                const tarballUrl = resolveRepoTarballUrl({
-                    release,
-                    owner: normalized.owner,
-                    repo: normalized.repo,
-                    explicitTag: flags.tag,
-                });
-                await downloadToFile(tarballUrl, bundlePath, UPGRADE_DOWNLOAD_TIMEOUT_MS);
-                checksumPath = "";
-            }
-        }
-        if (checksumPath) {
-            const expected = parseSha256Text(await readFile(checksumPath, "utf8"));
-            if (!expected) {
-                throw new CliError({
-                    exitCode: 3,
-                    code: "E_VALIDATION",
-                    message: "Upgrade checksum file is empty or invalid",
-                });
-            }
-            const actual = await sha256File(bundlePath);
-            if (actual !== expected) {
-                throw new CliError({
-                    exitCode: 3,
-                    code: "E_VALIDATION",
-                    message: `Upgrade checksum mismatch (expected ${expected}, got ${actual})`,
-                });
-            }
-        }
-        extractRoot = await mkdtemp(path.join(os.tmpdir(), "agentplane-upgrade-extract-"));
-        await extractArchive({
-            archivePath: bundlePath,
-            destDir: extractRoot,
-        });
-        const extractedRoot = await resolveUpgradeRoot(extractRoot);
-        bundleRoot =
-            bundleLayout === "repo_tarball"
-                ? path.join(extractedRoot, "packages", "agentplane", "assets")
-                : extractedRoot;
-        manifestPath = path.join(bundleRoot, "framework.manifest.json");
-    }
-    const manifest = await loadFrameworkManifestFromPath(manifestPath);
-    return {
-        tempRoot,
-        extractRoot,
-        bundleLayout,
-        bundleRoot,
-        manifest,
-        normalizedSourceToPersist,
-        upgradeVersionLabel,
-    };
-}

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

@@ -1,18 +0,0 @@
-import type { FrameworkManifest, UpgradeReviewRecord } from "./types.js";
-export type ManagedUpgradePlan = {
-    additions: string[];
-    updates: string[];
-    skipped: string[];
-    merged: string[];
-    fileContents: Map<string, Buffer>;
-    reviewRecords: UpgradeReviewRecord[];
-    incidentsAppendedCount: number;
-};
-export declare function planManagedUpgrade(opts: {
-    gitRoot: string;
-    manifest: FrameworkManifest;
-    bundleRoot: string;
-    baselineDirNew: string;
-    baselineDirLegacy: string;
-}): Promise<ManagedUpgradePlan>;
-//# sourceMappingURL=plan.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/commands/upgrade/plan.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AAwBF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6M9B"}