agentplane 0.3.2 → 0.3.3

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "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.3",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {