agentplane 0.3.2 → 0.3.4

package/dist/shared/errors.d.ts

@@ -11,6 +11,8 @@ export declare class CliError extends Error {
     });
 }
 export type JsonErrorGuidance = {
+    state?: string;
+    likelyCause?: string;
     hint?: string;
     nextAction?: {
         command: string;

package/dist/shared/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAMF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAenF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAMF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAiBnF"}

package/dist/shared/errors.js

@@ -15,6 +15,8 @@ export function formatJsonError(err, guidance) {
             code: err.code,
             message: err.message,
             context: err.context ?? undefined,
+            state: guidance?.state,
+            likely_cause: guidance?.likelyCause,
             hint: guidance?.hint,
             next_action: guidance?.nextAction,
             reason_decode: guidance?.reasonDecode,

package/dist/shared/repo-cli-version.d.ts

@@ -0,0 +1,13 @@
+import type { AgentplaneConfig } from "@agentplaneorg/core";
+import type { RuntimeSourceInfo } from "./runtime-source.js";
+export type RepoCliVersionState = "unconfigured" | "satisfied" | "older_than_expected" | "active_version_unresolved";
+export type RepoCliVersionExpectation = {
+    expectedVersion: string | null;
+    activeVersion: string | null;
+    state: RepoCliVersionState;
+    summary: string | null;
+    recovery: string | null;
+};
+export declare function getRepoExpectedCliVersion(config: AgentplaneConfig): string | null;
+export declare function evaluateRepoCliVersionExpectation(config: AgentplaneConfig, runtime: RuntimeSourceInfo): RepoCliVersionExpectation;
+//# sourceMappingURL=repo-cli-version.d.ts.map

package/dist/shared/repo-cli-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-cli-version.d.ts","sourceRoot":"","sources":["../../src/shared/repo-cli-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,WAAW,GACX,qBAAqB,GACrB,2BAA2B,CAAC;AAEhC,MAAM,MAAM,yBAAyB,GAAG;IACtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAKjF;AAqBD,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB,GACzB,yBAAyB,CAuC3B"}

package/dist/shared/repo-cli-version.js

@@ -0,0 +1,63 @@
+import { compareVersions } from "./version-compare.js";
+export function getRepoExpectedCliVersion(config) {
+    const raw = config.framework.cli.expected_version;
+    if (typeof raw !== "string")
+        return null;
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function buildRecovery(runtime, expectedVersion) {
+    switch (runtime.mode) {
+        case "global-installed": {
+            return `Run: npm i -g agentplane@${expectedVersion}`;
+        }
+        case "global-in-framework":
+        case "global-forced-in-framework": {
+            return "Run: scripts/reinstall-global-agentplane.sh";
+        }
+        case "repo-local":
+        case "repo-local-handoff": {
+            return (`Sync this framework checkout to agentplane ${expectedVersion} or lower ` +
+                "framework.cli.expected_version if the repository intentionally targets an older CLI.");
+        }
+    }
+}
+export function evaluateRepoCliVersionExpectation(config, runtime) {
+    const expectedVersion = getRepoExpectedCliVersion(config);
+    const activeVersion = runtime.agentplane.version?.trim() ?? null;
+    if (!expectedVersion) {
+        return {
+            expectedVersion: null,
+            activeVersion,
+            state: "unconfigured",
+            summary: null,
+            recovery: null,
+        };
+    }
+    if (!activeVersion) {
+        return {
+            expectedVersion,
+            activeVersion: null,
+            state: "active_version_unresolved",
+            summary: `Repository expects agentplane ${expectedVersion}, but the active runtime version could not be resolved.`,
+            recovery: buildRecovery(runtime, expectedVersion),
+        };
+    }
+    if (compareVersions(activeVersion, expectedVersion) < 0) {
+        return {
+            expectedVersion,
+            activeVersion,
+            state: "older_than_expected",
+            summary: `Repository expects agentplane ${expectedVersion}, but the active runtime resolves ${activeVersion}.`,
+            recovery: buildRecovery(runtime, expectedVersion),
+        };
+    }
+    const relation = compareVersions(activeVersion, expectedVersion) === 0 ? "matches" : "is newer than";
+    return {
+        expectedVersion,
+        activeVersion,
+        state: "satisfied",
+        summary: `Active runtime ${activeVersion} ${relation} the repository expectation ${expectedVersion}.`,
+        recovery: null,
+    };
+}

package/dist/shared/runtime-source.d.ts

@@ -0,0 +1,33 @@
+import { type FrameworkBinaryContext } from "../../bin/runtime-context.js";
+export type RuntimeMode = "global-installed" | "global-in-framework" | "global-forced-in-framework" | "repo-local" | "repo-local-handoff";
+export type ResolvedPackageInfo = {
+    name: string;
+    version: string | null;
+    packageRoot: string | null;
+    packageJsonPath: string | null;
+};
+export type RuntimeSourceInfo = {
+    cwd: string;
+    activeBinaryPath: string | null;
+    handoffFromBinaryPath: string | null;
+    mode: RuntimeMode;
+    framework: FrameworkBinaryContext;
+    frameworkSources: {
+        repoRoot: string | null;
+        agentplaneRoot: string | null;
+        coreRoot: string | null;
+    };
+    agentplane: ResolvedPackageInfo;
+    core: ResolvedPackageInfo;
+};
+export type ResolveRuntimeSourceInfoOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    activeBinaryPath?: string | null;
+    entryModuleUrl?: string;
+    agentplanePackageRoot?: string | null;
+    corePackageJsonPath?: string | null;
+};
+export declare function describeRuntimeMode(mode: RuntimeMode): string;
+export declare function resolveRuntimeSourceInfo(options?: ResolveRuntimeSourceInfoOptions): RuntimeSourceInfo;
+//# sourceMappingURL=runtime-source.d.ts.map

package/dist/shared/runtime-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-source.d.ts","sourceRoot":"","sources":["../../src/shared/runtime-source.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AAOtC,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,qBAAqB,GACrB,4BAA4B,GAC5B,YAAY,GACZ,oBAAoB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,sBAAsB,CAAC;IAClC,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,CAAC;AAuHF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAQ7D;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,iBAAiB,CAiCnB"}

package/dist/shared/runtime-source.js

@@ -0,0 +1,156 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { resolveFrameworkBinaryContext, } from "../../bin/runtime-context.js";
+const ACTIVE_BIN_ENV = "AGENTPLANE_RUNTIME_ACTIVE_BIN";
+const HANDOFF_FROM_ENV = "AGENTPLANE_RUNTIME_HANDOFF_FROM";
+const HANDOFF_FLAG_ENV = "AGENTPLANE_REPO_LOCAL_HANDOFF";
+const FORCE_GLOBAL_ENV = "AGENTPLANE_USE_GLOBAL_IN_FRAMEWORK";
+function pathExists(absPath) {
+    try {
+        fs.accessSync(absPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readJsonFile(absPath) {
+    try {
+        return JSON.parse(fs.readFileSync(absPath, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function resolvePackageInfo(packageJsonPath) {
+    if (!packageJsonPath) {
+        return {
+            name: "unknown",
+            version: null,
+            packageRoot: null,
+            packageJsonPath: null,
+        };
+    }
+    const parsed = readJsonFile(packageJsonPath);
+    return {
+        name: typeof parsed?.name === "string" ? parsed.name : path.basename(path.dirname(packageJsonPath)),
+        version: typeof parsed?.version === "string" ? parsed.version : null,
+        packageRoot: path.dirname(packageJsonPath),
+        packageJsonPath,
+    };
+}
+function findPackageRoot(startPath, expectedName) {
+    let dir = path.resolve(startPath);
+    if (path.extname(dir))
+        dir = path.dirname(dir);
+    for (;;) {
+        const packageJsonPath = path.join(dir, "package.json");
+        if (pathExists(packageJsonPath)) {
+            if (!expectedName)
+                return dir;
+            const parsed = readJsonFile(packageJsonPath);
+            if (parsed?.name === expectedName)
+                return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function resolveAgentplanePackageInfo(options) {
+    const explicitRoot = options.agentplanePackageRoot
+        ? path.resolve(options.agentplanePackageRoot)
+        : null;
+    const entryModuleUrl = options.entryModuleUrl ?? import.meta.url;
+    const inferredRoot = explicitRoot ??
+        findPackageRoot(fileURLToPath(entryModuleUrl), "agentplane") ??
+        findPackageRoot(fileURLToPath(entryModuleUrl));
+    if (!inferredRoot) {
+        return { name: "agentplane", version: null, packageRoot: null, packageJsonPath: null };
+    }
+    return resolvePackageInfo(path.join(inferredRoot, "package.json"));
+}
+function resolveCorePackageInfo(options) {
+    if (options.corePackageJsonPath) {
+        return resolvePackageInfo(path.resolve(options.corePackageJsonPath));
+    }
+    try {
+        const req = createRequire(options.entryModuleUrl ?? import.meta.url);
+        const entryPath = req.resolve("@agentplaneorg/core");
+        const packageRoot = findPackageRoot(entryPath, "@agentplaneorg/core");
+        return resolvePackageInfo(packageRoot ? path.join(packageRoot, "package.json") : null);
+    }
+    catch {
+        return { name: "@agentplaneorg/core", version: null, packageRoot: null, packageJsonPath: null };
+    }
+}
+function normalizePath(value) {
+    const trimmed = String(value ?? "").trim();
+    return trimmed.length > 0 ? path.resolve(trimmed) : null;
+}
+function inferRuntimeMode(context, env) {
+    const handoff = (env[HANDOFF_FLAG_ENV] ?? "").trim() === "1";
+    const handoffFrom = normalizePath(env[HANDOFF_FROM_ENV]);
+    if (handoff && handoffFrom && context.inFrameworkCheckout && context.isRepoLocalRuntime) {
+        return "repo-local-handoff";
+    }
+    if (context.inFrameworkCheckout && context.isRepoLocalRuntime) {
+        return "repo-local";
+    }
+    if (context.inFrameworkCheckout && (env[FORCE_GLOBAL_ENV] ?? "").trim() === "1") {
+        return "global-forced-in-framework";
+    }
+    if (context.inFrameworkCheckout) {
+        return "global-in-framework";
+    }
+    return "global-installed";
+}
+function resolveFrameworkCoreRoot(repoRoot) {
+    if (!repoRoot)
+        return null;
+    const coreRoot = path.join(repoRoot, "packages", "core");
+    return pathExists(path.join(coreRoot, "package.json")) ? coreRoot : null;
+}
+export function describeRuntimeMode(mode) {
+    return {
+        "repo-local-handoff": "repo-local binary reached via handoff from a global install",
+        "repo-local": "repo-local framework binary",
+        "global-forced-in-framework": "global installed binary forced inside a framework checkout",
+        "global-in-framework": "global installed binary running inside a framework checkout",
+        "global-installed": "global installed binary",
+    }[mode];
+}
+export function resolveRuntimeSourceInfo(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const env = options.env ?? process.env;
+    const agentplane = resolveAgentplanePackageInfo(options);
+    const core = resolveCorePackageInfo(options);
+    const fallbackBin = agentplane.packageRoot === null
+        ? null
+        : path.join(agentplane.packageRoot, "bin", "agentplane.js");
+    const activeBinaryPath = normalizePath(options.activeBinaryPath) ??
+        normalizePath(env[ACTIVE_BIN_ENV]) ??
+        normalizePath(process.argv[1]) ??
+        normalizePath(fallbackBin);
+    const framework = resolveFrameworkBinaryContext({
+        cwd,
+        thisBin: activeBinaryPath ?? fallbackBin ?? cwd,
+    });
+    return {
+        cwd,
+        activeBinaryPath,
+        handoffFromBinaryPath: normalizePath(env[HANDOFF_FROM_ENV]),
+        mode: inferRuntimeMode(framework, env),
+        framework,
+        frameworkSources: {
+            repoRoot: framework.checkout?.repoRoot ?? null,
+            agentplaneRoot: framework.checkout?.packageRoot ?? agentplane.packageRoot,
+            coreRoot: resolveFrameworkCoreRoot(framework.checkout?.repoRoot ?? null),
+        },
+        agentplane,
+        core,
+    };
+}

package/dist/shared/version-compare.d.ts

@@ -0,0 +1,7 @@
+export type ParsedVersionParts = {
+    main: number[];
+    prerelease: string | null;
+};
+export declare function parseVersionParts(version: string): ParsedVersionParts;
+export declare function compareVersions(left: string, right: string): number;
+//# sourceMappingURL=version-compare.d.ts.map

package/dist/shared/version-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.d.ts","sourceRoot":"","sources":["../../src/shared/version-compare.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAWrE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAanE"}

package/dist/shared/version-compare.js

@@ -0,0 +1,30 @@
+export function parseVersionParts(version) {
+    const cleaned = version.trim().replace(/^v/i, "").split("+")[0] ?? "";
+    const [mainRaw, prereleaseRaw] = cleaned.split("-", 2);
+    const main = (mainRaw ?? "")
+        .split(".")
+        .filter((part) => part.length > 0)
+        .map((part) => {
+        const parsed = Number.parseInt(part, 10);
+        return Number.isFinite(parsed) ? parsed : 0;
+    });
+    return { main, prerelease: prereleaseRaw ? prereleaseRaw.trim() : null };
+}
+export function compareVersions(left, right) {
+    const a = parseVersionParts(left);
+    const b = parseVersionParts(right);
+    const length = Math.max(a.main.length, b.main.length);
+    for (let i = 0; i < length; i++) {
+        const partA = a.main[i] ?? 0;
+        const partB = b.main[i] ?? 0;
+        if (partA !== partB)
+            return partA > partB ? 1 : -1;
+    }
+    if (a.prerelease === b.prerelease)
+        return 0;
+    if (a.prerelease === null)
+        return 1;
+    if (b.prerelease === null)
+        return -1;
+    return a.prerelease.localeCompare(b.prerelease);
+}

package/dist/shared/workflow-artifacts.d.ts

@@ -0,0 +1,37 @@
+export type WorkflowArtifactApprovals = {
+    requirePlanApproval: boolean;
+    requireVerifyApproval: boolean;
+    requireNetworkApproval: boolean;
+};
+export declare function buildWorkflowRuntimeContext(opts: {
+    gitRoot: string;
+    workflowMode: "direct" | "branch_pr";
+    approvals: WorkflowArtifactApprovals;
+    timestamp?: string;
+}): {
+    workflow: {
+        mode: "direct" | "branch_pr";
+        version: number;
+        approvals: {
+            require_plan: boolean;
+            require_verify: boolean;
+            require_network: boolean;
+        };
+    };
+    runtime: {
+        repo_name: string;
+        repo_root: string;
+        timestamp: string;
+    };
+};
+export declare function ensureWorkflowArtifacts(opts: {
+    gitRoot: string;
+    workflowMode: "direct" | "branch_pr";
+    approvals: WorkflowArtifactApprovals;
+    projectOverrideTemplate?: string;
+}): Promise<{
+    installPaths: string[];
+    commitPaths: string[];
+    changedPaths: string[];
+}>;
+//# sourceMappingURL=workflow-artifacts.d.ts.map

package/dist/shared/workflow-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-artifacts.d.ts","sourceRoot":"","sources":["../../src/shared/workflow-artifacts.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,yBAAyB,GAAG;IACtC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC;IACrC,SAAS,EAAE,yBAAyB,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;EAiBA;AAUD,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC;IACrC,SAAS,EAAE,yBAAyB,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwErF"}

package/dist/shared/workflow-artifacts.js

@@ -0,0 +1,97 @@
+import path from "node:path";
+import { readFile } from "node:fs/promises";
+import { DEFAULT_WORKFLOW_TEMPLATE, buildWorkflowFromTemplates, diagnosticsSummary, publishWorkflowCandidate, resolveWorkflowPaths, } from "../workflow-runtime/index.js";
+import { CliError } from "./errors.js";
+export function buildWorkflowRuntimeContext(opts) {
+    return {
+        workflow: {
+            mode: opts.workflowMode,
+            version: 1,
+            approvals: {
+                require_plan: opts.approvals.requirePlanApproval,
+                require_verify: opts.approvals.requireVerifyApproval,
+                require_network: opts.approvals.requireNetworkApproval,
+            },
+        },
+        runtime: {
+            repo_name: path.basename(opts.gitRoot) || "repo",
+            repo_root: opts.gitRoot,
+            timestamp: opts.timestamp ?? new Date().toISOString(),
+        },
+    };
+}
+async function readIfPresent(absPath) {
+    try {
+        return await readFile(absPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+export async function ensureWorkflowArtifacts(opts) {
+    const workflowPaths = resolveWorkflowPaths(opts.gitRoot);
+    const [beforeWorkflow, beforeLastKnownGood, beforeLegacyWorkflow] = await Promise.all([
+        readIfPresent(workflowPaths.workflowPath),
+        readIfPresent(workflowPaths.lastKnownGoodPath),
+        workflowPaths.legacyWorkflowPath === workflowPaths.workflowPath
+            ? Promise.resolve(null)
+            : readIfPresent(workflowPaths.legacyWorkflowPath),
+    ]);
+    const built = buildWorkflowFromTemplates({
+        baseTemplate: DEFAULT_WORKFLOW_TEMPLATE,
+        projectOverrideTemplate: opts.projectOverrideTemplate,
+        runtimeContext: buildWorkflowRuntimeContext({
+            gitRoot: opts.gitRoot,
+            workflowMode: opts.workflowMode,
+            approvals: opts.approvals,
+        }),
+    });
+    if (built.diagnostics.some((diagnostic) => diagnostic.severity === "ERROR")) {
+        throw new CliError({
+            exitCode: 3,
+            code: "E_VALIDATION",
+            message: `Failed to generate WORKFLOW.md: ${diagnosticsSummary(built.diagnostics)}`,
+            context: {
+                diagnostics: built.diagnostics.map((diagnostic) => ({
+                    severity: diagnostic.severity,
+                    code: diagnostic.code,
+                    path: diagnostic.path,
+                    message: diagnostic.message,
+                })),
+            },
+        });
+    }
+    const published = await publishWorkflowCandidate(opts.gitRoot, built.text);
+    if (!published.ok) {
+        throw new CliError({
+            exitCode: 3,
+            code: "E_VALIDATION",
+            message: `Failed to publish WORKFLOW.md: ${diagnosticsSummary(published.diagnostics)}`,
+            context: {
+                diagnostics: published.diagnostics.map((diagnostic) => ({
+                    severity: diagnostic.severity,
+                    code: diagnostic.code,
+                    path: diagnostic.path,
+                    message: diagnostic.message,
+                })),
+            },
+        });
+    }
+    const changedPaths = [];
+    if (beforeWorkflow !== built.text)
+        changedPaths.push(workflowPaths.workflowPath);
+    if (beforeLastKnownGood !== built.text)
+        changedPaths.push(workflowPaths.lastKnownGoodPath);
+    if (workflowPaths.legacyWorkflowPath !== workflowPaths.workflowPath &&
+        beforeLegacyWorkflow !== null) {
+        changedPaths.push(workflowPaths.legacyWorkflowPath);
+    }
+    const commitPaths = [
+        ...new Set(changedPaths.map((absPath) => path.relative(opts.gitRoot, absPath))),
+    ];
+    return {
+        installPaths: [workflowPaths.workflowPath, workflowPaths.lastKnownGoodPath],
+        commitPaths,
+        changedPaths,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",
@@ -55,7 +55,7 @@
     "prepublishOnly": "node ../../scripts/enforce-github-publish.mjs && npm run prepack"
   },
   "dependencies": {
-    "@agentplaneorg/core": "0.3.2",
+    "@agentplaneorg/core": "0.3.4",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {