@unbrained/pm-cli 2026.3.9

package/dist/cli/commands/health.js

@@ -0,0 +1,288 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getEnabledBuiltInExtensions } from "../../core/extensions/builtins.js";
+import { pathExists } from "../../core/fs/fs-utils.js";
+import { activateExtensions, loadExtensions, runActiveOnReadHooks } from "../../core/extensions/index.js";
+import { EXIT_CODE, PM_REQUIRED_SUBDIRS } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { nowIso } from "../../core/shared/time.js";
+import { listAllFrontMatter } from "../../core/store/item-store.js";
+import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+async function isDirectory(targetPath) {
+    try {
+        const stats = await fs.stat(targetPath);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function countHistoryStreams(pmRoot) {
+    const historyDir = path.join(pmRoot, "history");
+    if (!(await isDirectory(historyDir))) {
+        return {
+            count: 0,
+            warnings: [],
+        };
+    }
+    const historyFiles = (await fs.readdir(historyDir))
+        .filter((entry) => entry.endsWith(".jsonl"))
+        .sort((left, right) => left.localeCompare(right));
+    const warnings = [];
+    for (const fileName of historyFiles) {
+        warnings.push(...(await runActiveOnReadHooks({
+            path: path.join(historyDir, fileName),
+            scope: "project",
+        })));
+    }
+    return {
+        count: historyFiles.length,
+        warnings,
+    };
+}
+function hasActivateExport(moduleRecord) {
+    if (typeof moduleRecord.activate === "function") {
+        return true;
+    }
+    const defaultExport = moduleRecord.default;
+    if (typeof defaultExport !== "object" || defaultExport === null) {
+        return false;
+    }
+    return typeof defaultExport.activate === "function";
+}
+function summarizeLoadedExtension(extension) {
+    const summary = {
+        layer: extension.layer,
+        directory: extension.directory,
+        manifest_path: extension.manifest_path,
+        name: extension.name,
+        version: extension.version,
+        entry: extension.entry,
+        priority: extension.priority,
+        entry_path: extension.entry_path,
+        has_activate: hasActivateExport(extension.module),
+    };
+    if (Array.isArray(extension.capabilities)) {
+        summary.capabilities = [...extension.capabilities];
+    }
+    return summary;
+}
+function toNonEmptyString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function resolveMigrationId(definition, fallbackIndex) {
+    const explicitId = toNonEmptyString(definition.id);
+    if (explicitId) {
+        return explicitId;
+    }
+    return `migration-${String(fallbackIndex + 1).padStart(3, "0")}`;
+}
+function resolveMigrationStatus(definition) {
+    const rawStatus = toNonEmptyString(definition.status);
+    const normalized = rawStatus?.toLowerCase();
+    if (normalized === "failed") {
+        return "failed";
+    }
+    if (normalized === "applied") {
+        return "applied";
+    }
+    return "pending";
+}
+function resolveMigrationFailureReason(definition) {
+    return toNonEmptyString(definition.reason) ?? toNonEmptyString(definition.error) ?? toNonEmptyString(definition.message);
+}
+function compareMigrationEntries(left, right) {
+    const byLayer = left.layer.localeCompare(right.layer);
+    if (byLayer !== 0) {
+        return byLayer;
+    }
+    const byName = left.name.localeCompare(right.name);
+    if (byName !== 0) {
+        return byName;
+    }
+    return left.id.localeCompare(right.id);
+}
+function summarizeMigrationStatuses(migrations) {
+    const applied = [];
+    const pending = [];
+    const failed = [];
+    migrations.forEach((migration, index) => {
+        const id = resolveMigrationId(migration.definition, index);
+        const status = resolveMigrationStatus(migration.definition);
+        if (status === "applied") {
+            applied.push({
+                layer: migration.layer,
+                name: migration.name,
+                id,
+                status,
+            });
+            return;
+        }
+        if (status === "failed") {
+            failed.push({
+                layer: migration.layer,
+                name: migration.name,
+                id,
+                status,
+                reason: resolveMigrationFailureReason(migration.definition),
+            });
+            return;
+        }
+        pending.push({
+            layer: migration.layer,
+            name: migration.name,
+            id,
+            status,
+        });
+    });
+    applied.sort(compareMigrationEntries);
+    pending.sort(compareMigrationEntries);
+    failed.sort(compareMigrationEntries);
+    const warnings = [
+        ...failed.map((entry) => `extension_migration_failed:${entry.layer}:${entry.name}:${entry.id}`),
+        ...pending.map((entry) => `extension_migration_pending:${entry.layer}:${entry.name}:${entry.id}`),
+    ];
+    return {
+        summary: {
+            applied,
+            pending,
+            failed,
+            applied_count: applied.length,
+            pending_count: pending.length,
+            failed_count: failed.length,
+        },
+        warnings,
+    };
+}
+async function buildExtensionCheck(pmRoot, settings, noExtensionsFlag) {
+    const loadResult = await loadExtensions({
+        pmRoot,
+        settings,
+        cwd: process.cwd(),
+        noExtensions: noExtensionsFlag,
+    });
+    const loadedWithBuiltIns = noExtensionsFlag
+        ? loadResult.loaded
+        : [...getEnabledBuiltInExtensions(settings), ...loadResult.loaded];
+    const loadedSummaries = loadedWithBuiltIns.map((extension) => summarizeLoadedExtension(extension));
+    const activationResult = await activateExtensions({
+        ...loadResult,
+        loaded: loadedWithBuiltIns,
+    });
+    const migrationStatus = summarizeMigrationStatuses(activationResult.registrations.migrations);
+    const activationDetails = {
+        failed: activationResult.failed,
+        warnings: activationResult.warnings,
+        hook_counts: activationResult.hook_counts,
+        command_override_count: activationResult.command_override_count,
+        command_handler_count: activationResult.command_handler_count,
+        renderer_override_count: activationResult.renderer_override_count,
+        registration_counts: activationResult.registration_counts,
+        registrations: activationResult.registrations,
+        migration_status: migrationStatus.summary,
+    };
+    const extensionWarnings = [...loadResult.warnings, ...activationDetails.warnings, ...migrationStatus.warnings];
+    return {
+        check: {
+            name: "extensions",
+            status: extensionWarnings.length === 0 ? "ok" : "warn",
+            details: {
+                ...loadResult,
+                loaded: loadedSummaries,
+                warnings: extensionWarnings,
+                activation: activationDetails,
+            },
+        },
+        warnings: extensionWarnings,
+    };
+}
+function validateSettingsValues(settings) {
+    const warnings = [];
+    if (settings.id_prefix.trim().length === 0) {
+        warnings.push("settings:id_prefix_empty");
+    }
+    if (settings.locks.ttl_seconds <= 0) {
+        warnings.push("settings:locks_ttl_non_positive");
+    }
+    return warnings;
+}
+export async function runHealth(global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    const settingsPath = getSettingsPath(pmRoot);
+    if (!(await pathExists(settingsPath))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const settings = await readSettings(pmRoot);
+    const requiredDirs = PM_REQUIRED_SUBDIRS.filter((entry) => entry.length > 0);
+    const missingDirs = [];
+    const hookWarnings = [];
+    for (const relativeDir of requiredDirs) {
+        const directoryPath = path.join(pmRoot, relativeDir);
+        hookWarnings.push(...(await runActiveOnReadHooks({
+            path: directoryPath,
+            scope: "project",
+        })));
+        if (!(await isDirectory(directoryPath))) {
+            missingDirs.push(relativeDir);
+        }
+    }
+    const settingWarnings = validateSettingsValues(settings);
+    const extensionCheck = await buildExtensionCheck(pmRoot, settings, Boolean(global.noExtensions));
+    const items = await listAllFrontMatter(pmRoot);
+    const historySummary = await countHistoryStreams(pmRoot);
+    const checks = [
+        {
+            name: "settings",
+            status: "ok",
+            details: {
+                path: settingsPath,
+                version: settings.version,
+                id_prefix: settings.id_prefix,
+                locks_ttl_seconds: settings.locks.ttl_seconds,
+            },
+        },
+        {
+            name: "directories",
+            status: missingDirs.length === 0 ? "ok" : "warn",
+            details: {
+                required: requiredDirs,
+                missing: missingDirs,
+            },
+        },
+        {
+            name: "settings_values",
+            status: settingWarnings.length === 0 ? "ok" : "warn",
+            details: {
+                warnings: settingWarnings,
+            },
+        },
+        extensionCheck.check,
+        {
+            name: "storage",
+            status: "ok",
+            details: {
+                items: items.length,
+                history_streams: historySummary.count,
+            },
+        },
+    ];
+    const warnings = [
+        ...missingDirs.map((dir) => `missing_directory:${dir}`),
+        ...settingWarnings,
+        ...extensionCheck.warnings,
+        ...historySummary.warnings,
+        ...hookWarnings,
+    ];
+    return {
+        ok: warnings.length === 0,
+        checks,
+        warnings,
+        generated_at: nowIso(),
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/cli/commands/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/cli/commands/health.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/history.d.ts

@@ -0,0 +1,13 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { HistoryEntry } from "../../types/index.js";
+export interface HistoryCommandOptions {
+    limit?: string;
+}
+export interface HistoryResult {
+    id: string;
+    history: HistoryEntry[];
+    count: number;
+    limit: number | null;
+}
+export declare function readHistoryEntries(historyPath: string, itemId: string): Promise<HistoryEntry[]>;
+export declare function runHistory(id: string, options: HistoryCommandOptions, global: GlobalOptions): Promise<HistoryResult>;

package/dist/cli/commands/history.js

@@ -0,0 +1,72 @@
+import { pathExists, readFileIfExists } from "../../core/fs/fs-utils.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { runActiveOnReadHooks } from "../../core/extensions/index.js";
+import { normalizeItemId } from "../../core/item/id.js";
+import { locateItem } from "../../core/store/item-store.js";
+import { getHistoryPath, getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+function parseLimit(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new PmCliError("Invalid --limit value", EXIT_CODE.USAGE);
+    }
+    return Math.floor(parsed);
+}
+function limitEntries(values, limit) {
+    if (limit === undefined)
+        return values;
+    return values.slice(Math.max(0, values.length - limit));
+}
+export async function readHistoryEntries(historyPath, itemId) {
+    const raw = await readFileIfExists(historyPath);
+    if (raw === null) {
+        return [];
+    }
+    await runActiveOnReadHooks({
+        path: historyPath,
+        scope: "project",
+    });
+    if (raw.trim() === "") {
+        return [];
+    }
+    const entries = [];
+    const lines = raw.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index]?.trim();
+        if (!line)
+            continue;
+        try {
+            entries.push(JSON.parse(line));
+        }
+        catch {
+            throw new PmCliError(`History for ${itemId} contains invalid JSON at line ${index + 1}`, EXIT_CODE.GENERIC_FAILURE);
+        }
+    }
+    return entries;
+}
+export async function runHistory(id, options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const limit = parseLimit(options.limit);
+    const settings = await readSettings(pmRoot);
+    const normalizedId = normalizeItemId(id, settings.id_prefix);
+    const located = await locateItem(pmRoot, normalizedId, settings.id_prefix);
+    const resolvedId = located?.id ?? normalizedId;
+    const historyPath = getHistoryPath(pmRoot, resolvedId);
+    if (!located && !(await pathExists(historyPath))) {
+        throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);
+    }
+    const history = limitEntries(await readHistoryEntries(historyPath, resolvedId), limit);
+    return {
+        id: resolvedId,
+        history,
+        count: history.length,
+        limit: limit ?? null,
+    };
+}
+//# sourceMappingURL=history.js.map

package/dist/cli/commands/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/cli/commands/history.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,26 @@
+export { runAppend } from "./append.js";
+export { runCompletion, type CompletionResult, type CompletionShell } from "./completion.js";
+export { runActivity } from "./activity.js";
+export { runBeadsImport, type BeadsImportOptions, type BeadsImportResult } from "./beads.js";
+export { runClaim, runRelease } from "./claim.js";
+export { runClose, type CloseCommandOptions, type CloseResult } from "./close.js";
+export { runComments } from "./comments.js";
+export { runConfig, type ConfigCommandOptions, type ConfigResult } from "./config.js";
+export { runCreate, type CreateCommandOptions } from "./create.js";
+export { runDelete, type DeleteCommandOptions, type DeleteResult } from "./delete.js";
+export { runDocs } from "./docs.js";
+export { runFiles } from "./files.js";
+export { runGc } from "./gc.js";
+export { runGet } from "./get.js";
+export { runHealth } from "./health.js";
+export { runHistory } from "./history.js";
+export { runInit } from "./init.js";
+export { runInstall, type InstallCommandOptions, type InstallResult } from "./install.js";
+export { runList, type ListOptions } from "./list.js";
+export { runSearch } from "./search.js";
+export { runReindex, type ReindexOptions, type ReindexResult } from "./reindex.js";
+export { runRestore } from "./restore.js";
+export { runStats } from "./stats.js";
+export { runTest } from "./test.js";
+export { runTestAll } from "./test-all.js";
+export { runUpdate } from "./update.js";

package/dist/cli/commands/index.js

@@ -0,0 +1,27 @@
+export { runAppend } from "./append.js";
+export { runCompletion } from "./completion.js";
+export { runActivity } from "./activity.js";
+export { runBeadsImport } from "./beads.js";
+export { runClaim, runRelease } from "./claim.js";
+export { runClose } from "./close.js";
+export { runComments } from "./comments.js";
+export { runConfig } from "./config.js";
+export { runCreate } from "./create.js";
+export { runDelete } from "./delete.js";
+export { runDocs } from "./docs.js";
+export { runFiles } from "./files.js";
+export { runGc } from "./gc.js";
+export { runGet } from "./get.js";
+export { runHealth } from "./health.js";
+export { runHistory } from "./history.js";
+export { runInit } from "./init.js";
+export { runInstall } from "./install.js";
+export { runList } from "./list.js";
+export { runSearch } from "./search.js";
+export { runReindex } from "./reindex.js";
+export { runRestore } from "./restore.js";
+export { runStats } from "./stats.js";
+export { runTest } from "./test.js";
+export { runTestAll } from "./test-all.js";
+export { runUpdate } from "./update.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAA+C,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAmD,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAA8C,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAgD,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,SAAS,EAA6B,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAgD,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAkD,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAA2C,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,10 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { PmSettings } from "../../types/index.js";
+export interface InitResult {
+    ok: boolean;
+    path: string;
+    settings: PmSettings;
+    created_dirs: string[];
+    warnings: string[];
+}
+export declare function runInit(prefixArg: string | undefined, global: GlobalOptions): Promise<InitResult>;

package/dist/cli/commands/init.js

@@ -0,0 +1,59 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runActiveOnWriteHooks } from "../../core/extensions/index.js";
+import { pathExists } from "../../core/fs/fs-utils.js";
+import { normalizePrefix } from "../../core/item/id.js";
+import { PM_REQUIRED_SUBDIRS, SETTINGS_DEFAULTS } from "../../core/shared/constants.js";
+import { resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings, writeSettings } from "../../core/store/settings.js";
+function cloneDefaults() {
+    return structuredClone(SETTINGS_DEFAULTS);
+}
+export async function runInit(prefixArg, global) {
+    const cwd = process.cwd();
+    const pmRoot = resolvePmRoot(cwd, global.path);
+    const createdDirs = [];
+    const warnings = [];
+    for (const subdir of PM_REQUIRED_SUBDIRS) {
+        const target = subdir ? path.join(pmRoot, subdir) : pmRoot;
+        const existed = await pathExists(target);
+        await fs.mkdir(target, { recursive: true });
+        if (existed) {
+            warnings.push(`already_exists:${target}`);
+        }
+        else {
+            createdDirs.push(target);
+        }
+        warnings.push(...(await runActiveOnWriteHooks({
+            path: target,
+            scope: "project",
+            op: "init:ensure_dir",
+        })));
+    }
+    const settingsPath = path.join(pmRoot, "settings.json");
+    const settingsExists = await pathExists(settingsPath);
+    const normalizedPrefix = normalizePrefix(prefixArg);
+    let settings;
+    if (settingsExists) {
+        settings = await readSettings(pmRoot);
+        warnings.push(`already_exists:${settingsPath}`);
+        if (prefixArg !== undefined && settings.id_prefix !== normalizedPrefix) {
+            settings.id_prefix = normalizedPrefix;
+            await writeSettings(pmRoot, settings);
+            warnings.push(`updated:id_prefix:${normalizedPrefix}`);
+        }
+    }
+    else {
+        settings = cloneDefaults();
+        settings.id_prefix = normalizedPrefix;
+        await writeSettings(pmRoot, settings);
+    }
+    return {
+        ok: true,
+        path: pmRoot,
+        settings,
+        created_dirs: createdDirs,
+        warnings,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,18 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+export interface InstallCommandOptions {
+    project?: boolean;
+    global?: boolean;
+}
+export interface InstallResult {
+    ok: boolean;
+    target: "pi";
+    scope: "project" | "global";
+    source_path: string;
+    destination_path: string;
+    overwritten: boolean;
+    warnings: string[];
+}
+export interface InstallRuntime {
+    readFile?: (path: string, encoding: BufferEncoding) => Promise<string>;
+}
+export declare function runInstall(target: string, options: InstallCommandOptions, global: GlobalOptions, runtime?: InstallRuntime): Promise<InstallResult>;

package/dist/cli/commands/install.js

@@ -0,0 +1,87 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+function getPackageRootFromCommandModule() {
+    const commandModulePath = fileURLToPath(import.meta.url);
+    return path.resolve(path.dirname(commandModulePath), "../../../");
+}
+function resolvePiExtensionSourcePath(packageRoot) {
+    return path.resolve(packageRoot, ".pi/extensions/pm-cli/index.ts");
+}
+function resolvePiGlobalRoot() {
+    const configured = process.env.PI_CODING_AGENT_DIR;
+    if (typeof configured === "string" && configured.trim().length > 0) {
+        return path.resolve(configured.trim());
+    }
+    return path.join(os.homedir(), ".pi", "agent");
+}
+function resolveProjectRootFromPmRoot(pmRoot) {
+    const normalizedPmRoot = path.normalize(pmRoot);
+    const agentStoreSuffix = path.join(".agents", "pm");
+    if (normalizedPmRoot.endsWith(agentStoreSuffix)) {
+        return path.resolve(pmRoot, "..", "..");
+    }
+    return path.resolve(pmRoot, "..");
+}
+function resolveProjectInstallRoot(cwd, cliPath) {
+    const configuredPath = cliPath?.trim();
+    if (!configuredPath) {
+        return cwd;
+    }
+    const pmRoot = path.resolve(cwd, configuredPath);
+    return resolveProjectRootFromPmRoot(pmRoot);
+}
+export async function runInstall(target, options, global, runtime = {}) {
+    const normalizedTarget = target.trim().toLowerCase();
+    if (normalizedTarget !== "pi") {
+        throw new PmCliError(`Unsupported install target "${target}". Supported targets: pi.`, EXIT_CODE.USAGE);
+    }
+    const useProject = options.project === true;
+    const useGlobal = options.global === true;
+    if (useProject && useGlobal) {
+        throw new PmCliError('Options "--project" and "--global" are mutually exclusive.', EXIT_CODE.USAGE);
+    }
+    const scope = useGlobal ? "global" : "project";
+    const packageRoot = getPackageRootFromCommandModule();
+    const sourcePath = resolvePiExtensionSourcePath(packageRoot);
+    const readFileImpl = runtime.readFile ?? fs.readFile;
+    const projectRoot = resolveProjectInstallRoot(process.cwd(), global.path);
+    const destinationPath = scope === "project"
+        ? path.resolve(projectRoot, ".pi/extensions/pm-cli/index.ts")
+        : path.resolve(resolvePiGlobalRoot(), "extensions/pm-cli/index.ts");
+    let sourceContent;
+    try {
+        sourceContent = await readFileImpl(sourcePath, "utf8");
+    }
+    catch (error) {
+        const message = String(error);
+        throw new PmCliError(`Failed to read bundled Pi extension source at "${sourcePath}": ${message}`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    let existed = false;
+    try {
+        await fs.access(destinationPath);
+        existed = true;
+    }
+    catch {
+        existed = false;
+    }
+    await fs.mkdir(path.dirname(destinationPath), { recursive: true });
+    await fs.writeFile(destinationPath, sourceContent, "utf8");
+    const warnings = [];
+    if (existed) {
+        warnings.push(`overwritten:${destinationPath}`);
+    }
+    return {
+        ok: true,
+        target: "pi",
+        scope,
+        source_path: sourcePath,
+        destination_path: destinationPath,
+        overwritten: existed,
+        warnings,
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"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"}