pulseed 0.0.1 → 0.1.1

package/dist/cli/commands/plugin.js

@@ -0,0 +1,315 @@
+import * as fsp from "node:fs/promises";
+import * as fsSync from "node:fs";
+import * as path from "node:path";
+import * as cp from "node:child_process";
+import { promisify } from "node:util";
+import yaml from "js-yaml";
+import { PluginManifestSchema } from "../../types/plugin.js";
+import { formatOperationError } from "../utils.js";
+import { getCliLogger } from "../cli-logger.js";
+import { getPluginsDir } from "../../utils/paths.js";
+import { satisfiesRange } from "../../runtime/plugin-loader.js";
+const execFile = promisify(cp.execFile);
+function defaultPluginsDir() {
+    return getPluginsDir();
+}
+async function pathExists(p) {
+    try {
+        await fsp.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readManifest(pluginDir) {
+    const yamlPath = path.join(pluginDir, "plugin.yaml");
+    const jsonPath = path.join(pluginDir, "plugin.json");
+    let raw;
+    if (await pathExists(yamlPath)) {
+        const content = await fsp.readFile(yamlPath, "utf-8");
+        raw = yaml.load(content);
+    }
+    else if (await pathExists(jsonPath)) {
+        const content = await fsp.readFile(jsonPath, "utf-8");
+        raw = JSON.parse(content);
+    }
+    else {
+        return null;
+    }
+    return PluginManifestSchema.safeParse(raw);
+}
+export async function cmdPluginList(pluginsDir) {
+    const logger = getCliLogger();
+    const dir = pluginsDir ?? defaultPluginsDir();
+    if (!(await pathExists(dir))) {
+        console.log("No plugins installed. Use `pulseed plugin install <path>` to install one.");
+        return 0;
+    }
+    let entries;
+    try {
+        entries = await fsp.readdir(dir);
+    }
+    catch (err) {
+        logger.error(formatOperationError("read plugins directory", err));
+        return 1;
+    }
+    const rows = [];
+    for (const entry of entries) {
+        const pluginDir = path.join(dir, entry);
+        let stat;
+        try {
+            stat = await fsp.stat(pluginDir);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        const result = await readManifest(pluginDir);
+        if (!result || !result.success)
+            continue;
+        const m = result.data;
+        rows.push({
+            name: m.name,
+            version: m.version,
+            type: m.type,
+            description: m.description.length > 40 ? m.description.slice(0, 37) + "..." : m.description,
+        });
+    }
+    if (rows.length === 0) {
+        console.log("No plugins installed. Use `pulseed plugin install <path>` to install one.");
+        return 0;
+    }
+    console.log(`Found ${rows.length} plugin(s):\n`);
+    console.log(`${"NAME".padEnd(24)} ${"VERSION".padEnd(10)} ${"TYPE".padEnd(14)} DESCRIPTION`);
+    console.log("─".repeat(80));
+    for (const r of rows) {
+        console.log(`${r.name.padEnd(24)} ${r.version.padEnd(10)} ${r.type.padEnd(14)} ${r.description}`);
+    }
+    return 0;
+}
+/** Returns true when the argument looks like a local filesystem path. */
+function isLocalPath(arg) {
+    return arg.startsWith("/") || arg.startsWith("./") || arg.startsWith("../");
+}
+/** Returns true when the argument looks like an npm package name. */
+function isNpmPackage(arg) {
+    return arg.startsWith("@") || /^[a-zA-Z0-9]/.test(arg);
+}
+/** Read and validate plugin manifest from an npm-installed package directory. */
+async function readNpmManifest(pluginDir, packageName) {
+    // Resolve the package dir inside node_modules
+    const pkgName = packageName.startsWith("@")
+        ? packageName.split("/").slice(0, 2).join("/")
+        : packageName.split("/")[0];
+    const nodeModulesDir = path.join(pluginDir, "node_modules", pkgName);
+    return readManifest(nodeModulesDir);
+}
+/** Check PulSeed version compatibility, log a warning if incompatible, return false to abort. */
+function checkVersionCompat(manifest, pulseedVersion) {
+    const minVer = manifest.min_pulseed_version;
+    const maxVer = manifest.max_pulseed_version;
+    if (!satisfiesRange(pulseedVersion, minVer, maxVer)) {
+        const range = [
+            minVer ? `>=${minVer}` : "",
+            maxVer ? `<=${maxVer}` : "",
+        ]
+            .filter(Boolean)
+            .join(", ");
+        getCliLogger().warn(`Plugin "${manifest.name}" requires PulSeed ${range}, but current version is ${pulseedVersion}. Aborting install.`);
+        return false;
+    }
+    return true;
+}
+function getPulseedVersion() {
+    try {
+        const pkgPath = path.resolve(new URL(".", import.meta.url).pathname, "../../../package.json");
+        const pkg = JSON.parse(fsSync.readFileSync(pkgPath, "utf-8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+export async function cmdPluginInstall(pluginsDir, argv, _getPulseedVersion, _execFileFn) {
+    const logger = getCliLogger();
+    const dir = pluginsDir ?? defaultPluginsDir();
+    const source = argv[0];
+    const force = argv.includes("--force");
+    if (!source) {
+        logger.error("Error: source path or package name is required. Usage: pulseed plugin install <path|package> [--force]");
+        return 1;
+    }
+    // ── npm package install ──────────────────────────────────────────────────
+    if (!isLocalPath(source) && isNpmPackage(source)) {
+        const packageName = source;
+        const pluginDir = path.join(dir, packageName.replace(/\//g, "__").replace(/@/g, ""));
+        if ((await pathExists(pluginDir)) && !force) {
+            logger.error(`Error: plugin "${packageName}" is already installed. Use --force to overwrite.`);
+            return 1;
+        }
+        try {
+            await fsp.mkdir(pluginDir, { recursive: true });
+        }
+        catch (err) {
+            logger.error(formatOperationError("create plugin directory", err));
+            return 1;
+        }
+        const execFn = _execFileFn ?? execFile;
+        try {
+            await execFn("npm", ["install", "--prefix", pluginDir, packageName]);
+        }
+        catch (err) {
+            logger.error(formatOperationError("npm install", err));
+            return 1;
+        }
+        const result = await readNpmManifest(pluginDir, packageName);
+        if (!result) {
+            logger.error(`Error: plugin manifest not found after npm install of "${packageName}".`);
+            return 1;
+        }
+        if (!result.success) {
+            logger.error(`Error: invalid plugin manifest — ${result.error.message}`);
+            return 1;
+        }
+        const manifest = result.data;
+        const pulseedVer = _getPulseedVersion ? _getPulseedVersion() : getPulseedVersion();
+        if (!checkVersionCompat(manifest, pulseedVer))
+            return 1;
+        if (manifest.permissions.shell) {
+            logger.warn(`Plugin "${manifest.name}" requests shell execution permission.`);
+        }
+        console.log(`Plugin "${manifest.name}" v${manifest.version} installed from npm.`);
+        return 0;
+    }
+    // ── Local path install (existing flow) ───────────────────────────────────
+    const sourcePath = source;
+    if (!(await pathExists(sourcePath))) {
+        logger.error(`Error: source path "${sourcePath}" does not exist.`);
+        return 1;
+    }
+    const result = await readManifest(sourcePath);
+    if (!result) {
+        logger.error(`Error: plugin manifest not found in "${sourcePath}". Expected plugin.yaml or plugin.json.`);
+        return 1;
+    }
+    if (!result.success) {
+        logger.error(`Error: invalid plugin manifest — ${result.error.message}`);
+        return 1;
+    }
+    const manifest = result.data;
+    const destDir = path.join(dir, manifest.name);
+    if ((await pathExists(destDir)) && !force) {
+        logger.error(`Error: plugin "${manifest.name}" is already installed. Use --force to overwrite.`);
+        return 1;
+    }
+    try {
+        await fsp.mkdir(dir, { recursive: true });
+        await fsp.cp(sourcePath, destDir, { recursive: true });
+    }
+    catch (err) {
+        logger.error(formatOperationError("copy plugin", err));
+        return 1;
+    }
+    // Verify after copy
+    const verify = await readManifest(destDir);
+    if (!verify || !verify.success) {
+        logger.error(`Error: plugin copy failed — manifest unreadable after install.`);
+        return 1;
+    }
+    const pulseedVer = _getPulseedVersion ? _getPulseedVersion() : getPulseedVersion();
+    if (!checkVersionCompat(manifest, pulseedVer))
+        return 1;
+    if (manifest.permissions.shell) {
+        getCliLogger().warn(`Plugin "${manifest.name}" requests shell execution permission.`);
+    }
+    console.log(`Plugin "${manifest.name}" v${manifest.version} installed.`);
+    return 0;
+}
+export async function cmdPluginUpdate(pluginsDir, argv, _execFileFn) {
+    const logger = getCliLogger();
+    const dir = pluginsDir ?? defaultPluginsDir();
+    const name = argv[0];
+    if (!name) {
+        logger.error("Error: plugin name is required. Usage: pulseed plugin update <name>");
+        return 1;
+    }
+    const pluginDir = path.join(dir, name);
+    if (!(await pathExists(pluginDir))) {
+        logger.error(`Error: plugin "${name}" not found.`);
+        return 1;
+    }
+    const execFn = _execFileFn ?? execFile;
+    try {
+        await execFn("npm", ["update", "--prefix", pluginDir]);
+    }
+    catch (err) {
+        logger.error(formatOperationError("npm update", err));
+        return 1;
+    }
+    console.log(`Plugin "${name}" updated.`);
+    return 0;
+}
+export async function cmdPluginSearch(_pluginsDir, argv, _execFileFn) {
+    const logger = getCliLogger();
+    const keyword = argv[0];
+    if (!keyword) {
+        logger.error("Error: keyword is required. Usage: pulseed plugin search <keyword>");
+        return 1;
+    }
+    const execFn = _execFileFn ?? execFile;
+    let stdout;
+    try {
+        const result = await execFn("npm", ["search", `@pulseed-plugins/${keyword}`, "--json"]);
+        stdout = result.stdout;
+    }
+    catch (err) {
+        logger.error(formatOperationError("npm search", err));
+        return 1;
+    }
+    let packages = [];
+    try {
+        packages = JSON.parse(stdout);
+    }
+    catch {
+        logger.error("Error: failed to parse npm search results.");
+        return 1;
+    }
+    if (packages.length === 0) {
+        console.log(`No plugins found for keyword "${keyword}".`);
+        return 0;
+    }
+    console.log(`Found ${packages.length} plugin(s):\n`);
+    console.log(`${"NAME".padEnd(40)} ${"VERSION".padEnd(10)} DESCRIPTION`);
+    console.log("─".repeat(80));
+    for (const pkg of packages) {
+        const desc = pkg.description?.length > 28 ? pkg.description.slice(0, 25) + "..." : (pkg.description ?? "");
+        console.log(`${pkg.name.padEnd(40)} ${pkg.version.padEnd(10)} ${desc}`);
+    }
+    return 0;
+}
+export async function cmdPluginRemove(pluginsDir, argv) {
+    const logger = getCliLogger();
+    const dir = pluginsDir ?? defaultPluginsDir();
+    const name = argv[0];
+    if (!name) {
+        logger.error("Error: plugin name is required. Usage: pulseed plugin remove <name>");
+        return 1;
+    }
+    const pluginDir = path.join(dir, name);
+    if (!(await pathExists(pluginDir))) {
+        logger.error(`Error: plugin "${name}" not found.`);
+        return 1;
+    }
+    try {
+        await fsp.rm(pluginDir, { recursive: true });
+    }
+    catch (err) {
+        logger.error(formatOperationError("remove plugin", err));
+        return 1;
+    }
+    console.log(`Plugin "${name}" removed.`);
+    return 0;
+}
+//# sourceMappingURL=plugin.js.map

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

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

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

@@ -0,0 +1,3 @@
+import { StateManager } from "../../state-manager.js";
+export declare function cmdReport(stateManager: StateManager, goalId: string): Promise<number>;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD,wBAAsB,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC3F"}

package/dist/cli/commands/report.js

@@ -0,0 +1,29 @@
+// ─── pulseed report command ───
+import { ReportingEngine } from "../../reporting-engine.js";
+import { getCliLogger } from "../cli-logger.js";
+export async function cmdReport(stateManager, goalId) {
+    const logger = getCliLogger();
+    const reportingEngine = new ReportingEngine(stateManager);
+    const goal = await stateManager.loadGoal(goalId);
+    if (!goal) {
+        logger.error(`Error: Goal "${goalId}" not found.`);
+        return 1;
+    }
+    const reports = await reportingEngine.listReports(goalId);
+    if (reports.length === 0) {
+        console.log(`No reports found for goal "${goalId}".`);
+        console.log(`Run \`pulseed run --goal ${goalId}\` to generate reports.`);
+        return 0;
+    }
+    const sorted = [...reports].sort((a, b) => a.generated_at < b.generated_at ? 1 : -1);
+    const latest = sorted[0];
+    console.log(`# ${latest.title}`);
+    console.log(`\n**Report ID**: ${latest.id}`);
+    console.log(`**Type**: ${latest.report_type}`);
+    console.log(`**Generated**: ${latest.generated_at}`);
+    console.log(`**Goal**: ${goalId}`);
+    console.log(`\n---\n`);
+    console.log(latest.content);
+    return 0;
+}
+//# sourceMappingURL=report.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAGjC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,YAA0B,EAAE,MAAc;IACxE,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,YAAY,CAAC,CAAC;IAE1D,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,cAAc,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,8BAA8B,MAAM,IAAI,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,4BAA4B,MAAM,yBAAyB,CAAC,CAAC;QACzE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACxC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACzC,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAEzB,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE5B,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,7 @@
+import { StateManager } from "../../state-manager.js";
+import { CharacterConfigManager } from "../../traits/character-config.js";
+import type { LoopConfig } from "../../core-loop.js";
+export declare function cmdRun(stateManager: StateManager, characterConfigManager: CharacterConfigManager, goalId: string, loopConfig?: LoopConfig, autoApprove?: boolean, verbose?: boolean, activeCoreLoopRef?: {
+    value: import("../../core-loop.js").CoreLoop | null;
+}): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AA6BrD,wBAAsB,MAAM,CAC1B,YAAY,EAAE,YAAY,EAC1B,sBAAsB,EAAE,sBAAsB,EAC9C,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,UAAU,EACvB,WAAW,CAAC,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,OAAO,EACjB,iBAAiB,CAAC,EAAE;IAAE,KAAK,EAAE,OAAO,oBAAoB,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,GAC1E,OAAO,CAAC,MAAM,CAAC,CAuFjB"}

package/dist/cli/commands/run.js

@@ -0,0 +1,106 @@
+// ─── pulseed run command ───
+import * as readline from "node:readline";
+import { ensureProviderConfig } from "../ensure-api-key.js";
+import { buildDeps } from "../setup.js";
+import { formatOperationError } from "../utils.js";
+import { getCliLogger } from "../cli-logger.js";
+import { buildAutoApprovalFn, buildLoopLogger, buildProgressHandler, runLoopWithSignals, } from "../utils/loop-runner.js";
+function buildApprovalFn(rl) {
+    return (task) => {
+        return new Promise((resolve) => {
+            rl.pause();
+            process.stdout.write("\n--- Approval Required ---\n");
+            process.stdout.write(`Task: ${task.work_description}\n`);
+            process.stdout.write(`Rationale: ${task.rationale}\n`);
+            process.stdout.write(`Reversibility: ${task.reversibility}\n`);
+            rl.resume();
+            rl.question("Approve this task? [y/N] ", (answer) => {
+                process.stdout.write("\n");
+                resolve(answer.trim().toLowerCase() === "y");
+            });
+        });
+    };
+}
+export async function cmdRun(stateManager, characterConfigManager, goalId, loopConfig, autoApprove, verbose, activeCoreLoopRef) {
+    try {
+        await ensureProviderConfig();
+    }
+    catch (err) {
+        getCliLogger().error(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+    const rl = autoApprove
+        ? null
+        : readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+    const approvalFn = autoApprove ? buildAutoApprovalFn() : buildApprovalFn(rl);
+    const logger = buildLoopLogger();
+    const onProgress = buildProgressHandler();
+    let deps;
+    try {
+        deps = await buildDeps(stateManager, characterConfigManager, loopConfig, approvalFn, logger, onProgress);
+    }
+    catch (err) {
+        rl?.close();
+        logger.error(formatOperationError("initialise dependencies", err));
+        if (verbose || process.env.DEBUG) {
+            logger.error(err instanceof Error ? err.stack ?? String(err) : String(err));
+        }
+        return 1;
+    }
+    const { coreLoop } = deps;
+    const goal = await stateManager.loadGoal(goalId);
+    if (!goal) {
+        rl?.close();
+        logger.error(`Error: Goal "${goalId}" not found.`);
+        return 1;
+    }
+    console.log(`Running PulSeed loop for goal: ${goalId}`);
+    console.log(`Goal: ${goal.title}`);
+    if (loopConfig?.treeMode) {
+        console.log("Tree mode enabled — iterating across all tree nodes");
+    }
+    console.log("Press Ctrl+C to stop.\n");
+    if (activeCoreLoopRef) {
+        activeCoreLoopRef.value = coreLoop;
+    }
+    let result;
+    try {
+        result = await runLoopWithSignals(coreLoop, goalId);
+    }
+    catch (err) {
+        logger.error(formatOperationError(`run core loop for goal "${goalId}"`, err));
+        logger.error(`Hint: Check ~/.pulseed/logs/ for details or re-run with DEBUG=1 for stack traces.`);
+        if (verbose || process.env.DEBUG) {
+            logger.error(err instanceof Error ? err.stack ?? String(err) : String(err));
+        }
+        if (activeCoreLoopRef)
+            activeCoreLoopRef.value = null;
+        rl?.close();
+        return 1;
+    }
+    if (activeCoreLoopRef)
+        activeCoreLoopRef.value = null;
+    rl?.close();
+    console.log(`\n--- Loop Result ---`);
+    console.log(`Goal ID:          ${result.goalId}`);
+    console.log(`Final status:     ${result.finalStatus}`);
+    console.log(`Total iterations: ${result.totalIterations}`);
+    console.log(`Started at:       ${result.startedAt}`);
+    console.log(`Completed at:     ${result.completedAt}`);
+    switch (result.finalStatus) {
+        case "completed":
+            return 0;
+        case "stalled":
+            logger.error("Goal stalled — escalation level reached maximum.");
+            return 2;
+        case "error":
+            console.error(`Error: ${result.errorMessage || "Loop ended with error. Check ~/.pulseed/logs/ for details."}`);
+            return 1;
+        default:
+            return 0;
+    }
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function cmdSetup(argv: string[]): Promise<number>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAqWA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9D"}