@rse/ase 0.0.15 → 0.0.16

package/dst/ase-setup.js

@@ -3,16 +3,129 @@
 **  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
-const registerSetupCommand = (program) => {
-    program
-        .command("setup")
-        .description("Setup ASE")
-        .action((_opts, cmd) => {
-        const debug = Boolean(cmd.optsWithGlobals().debug);
-        if (debug)
-            console.log("DEBUG: setup command");
-        console.log("Setup ASE...");
-        /*  TODO: implement setup logic  */
-    });
-};
-export default registerSetupCommand;
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { execa } from "execa";
+import pkg from "../package.json" with { type: "json" };
+/*  CLI command "ase setup"  */
+export default class SetupCommand {
+    log;
+    constructor(log) {
+        this.log = log;
+    }
+    /*  run a sub-process with inherited stdio so users see live output  */
+    async run(cmd, args, cwd) {
+        this.log.write("info", `setup: running: $ ${cmd} ${args.join(" ")}` +
+            (cwd !== undefined ? ` (cwd: ${cwd})` : ""));
+        await execa(cmd, args, { stdio: "inherit", cwd });
+    }
+    /*  capture stdout of a sub-process  */
+    async capture(cmd, args, cwd) {
+        this.log.write("info", `setup: running: $ ${cmd} ${args.join(" ")}` +
+            (cwd !== undefined ? ` (cwd: ${cwd})` : ""));
+        const r = await execa(cmd, args, { stdio: ["ignore", "pipe", "pipe"], cwd });
+        return r.stdout.trim();
+    }
+    /*  handler for "ase setup install"  */
+    async doInstall(dev) {
+        this.log.write("info", `setup: install${dev ? "[dev]" : ""}: ` +
+            `installing ASE Claude Code plugin (origin: ${dev ? "local" : "remote"})`);
+        const source = dev ? process.cwd() : "rse/ase";
+        await this.run("claude", ["plugin", "marketplace", "add", source]);
+        await this.run("claude", ["plugin", "install", "ase@ase"]);
+        return 0;
+    }
+    /*  handler for "ase setup update"  */
+    async doUpdate(force, dev) {
+        if (dev) {
+            /*  update ASE CLI Tool  */
+            this.log.write("info", "setup: update[dev]: re-build ASE CLI tool (origin: local)");
+            const tooldir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+            await this.run("npm", ["install"], tooldir);
+            await this.run("npm", ["start", "build"], tooldir);
+            /*  in development mode the local plugin files are already current
+                but there is no version change in the plugin manifest,
+                so just re-install the plugin to let Claude Code update its copy  */
+            this.log.write("info", "setup: update[dev]: re-install ASE Claude Code plugin (origin: local)");
+            await this.run("claude", ["plugin", "uninstall", "ase@ase"]);
+            await this.run("claude", ["plugin", "install", "ase@ase"]);
+        }
+        else {
+            /*  perform NPM version check  */
+            const current = pkg.version;
+            let latest = "";
+            try {
+                latest = await this.capture("npm", ["view", "@rse/ase", "version"]);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                this.log.write("warning", `setup: update: failed to query latest ASE version: ${message}`);
+            }
+            if (!force && latest !== "" && latest === current) {
+                this.log.write("info", `setup: update: ASE already at latest version ${current}`);
+                return 0;
+            }
+            /*  update ASE CLI tool  */
+            this.log.write("info", `setup: update: updating ASE CLI tool: ${current} -> ${latest}`);
+            await this.run("npm", ["update", "-g", "@rse/ase"]);
+            /*  update ASE Claude Code plugin  */
+            this.log.write("info", "setup: update: updating ASE Claude Code plugin");
+            await this.run("claude", ["plugin", "marketplace", "update", "ase"]);
+            await this.run("claude", ["plugin", "update", "ase@ase"]);
+        }
+        return 0;
+    }
+    /*  handler for "ase setup uninstall"  */
+    async doUninstall(dev) {
+        /*  uninstall ASE Claude Code plugin  */
+        this.log.write("info", `setup: uninstall${dev ? "[dev]" : ""}: ` +
+            `uninstalling ASE Claude Code plugin (origin: ${dev ? "local" : "remote"})`);
+        await this.run("claude", ["plugin", "uninstall", "ase@ase"]);
+        await this.run("claude", ["plugin", "marketplace", "remove", "ase"]);
+        /*  uninstall ASE CLI tool (non-development only)  */
+        if (!dev) {
+            this.log.write("info", "setup: uninstall: uninstalling ASE CLI tool (origin: remote)");
+            await this.run("npm", ["uninstall", "-g", "@rse/ase"]);
+        }
+        return 0;
+    }
+    /*  register commands  */
+    register(program) {
+        /*  default for --dev derived from ASE_SETUP_DEV environment variable  */
+        const envDev = process.env.ASE_SETUP_DEV ?? "";
+        const devDflt = envDev !== "" && envDev !== "0" && envDev.toLowerCase() !== "false";
+        /*  register CLI top-level command "ase setup"  */
+        const setupCmd = program
+            .command("setup")
+            .description("install, update, or uninstall the ASE tool and plugin")
+            .action(() => {
+            setupCmd.outputHelp();
+            process.exit(1);
+        });
+        /*  register CLI sub-command "ase setup install"  */
+        setupCmd
+            .command("install")
+            .description("install the ASE Claude Code plugin")
+            .option("-d, --dev", "use local working copy instead of remote repository", devDflt)
+            .action(async (opts) => {
+            process.exit(await this.doInstall(opts.dev));
+        });
+        /*  register CLI sub-command "ase setup update"  */
+        setupCmd
+            .command("update")
+            .description("update the ASE tool and the ASE Claude Code plugin")
+            .option("-f, --force", "always perform the update, even if already at latest version", false)
+            .option("-d, --dev", "use local working copy instead of remote repository", devDflt)
+            .action(async (opts) => {
+            process.exit(await this.doUpdate(opts.force, opts.dev));
+        });
+        /*  register CLI sub-command "ase setup uninstall"  */
+        setupCmd
+            .command("uninstall")
+            .description("uninstall the ASE Claude Code plugin and the ASE tool")
+            .option("-d, --dev", "use local working copy instead of remote repository", devDflt)
+            .action(async (opts) => {
+            process.exit(await this.doUninstall(opts.dev));
+        });
+    }
+}

package/dst/ase.js

@@ -11,6 +11,7 @@ import ServiceCommand from "./ase-service.js";
 import MCPCommand from "./ase-mcp.js";
 import HookCommand from "./ase-hook.js";
 import DiagramCommand from "./ase-diagram.js";
+import SetupCommand from "./ase-setup.js";
 import pkg from "../package.json" with { type: "json" };
 /*  globally initialize logger  */
 const log = new Log("ase", "warning", "-");
@@ -26,7 +27,7 @@ const main = async () => {
         .usage("<command> [options]")
         .version(`ASE ${pkg.version}`, "-V, --version", "show version information")
         .addOption(new Option("-l, --log-level <level>", "log level")
-        .choices(["error", "warning", "info", "debug"]).default("warning"))
+        .choices(["error", "warning", "info", "debug"]).default("info"))
         .option("-L, --log-file  <file>", "log file path, or \"-\" for stdout", "-")
         .showHelpAfterError()
         .enablePositionalOptions()
@@ -44,6 +45,7 @@ const main = async () => {
     new MCPCommand(log).register(program);
     new HookCommand(log).register(program);
     new DiagramCommand(log).register(program);
+    new SetupCommand(log).register(program);
     /*  parse program arguments  */
     await program.parseAsync(process.argv);
     /*  gracefully terminate  */

package/package.json

@@ -6,7 +6,7 @@
     "homepage":                             "http://github.com/rse/ase",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
     "bugs":                                 { "url": "http://github.com/rse/ase/issues" },
-    "version":                              "0.0.15",
+    "version":                              "0.0.16",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -36,7 +36,7 @@
     },
     "dependencies": {
         "commander":                        "14.0.3",
-        "yaml":                             "2.8.3",
+        "yaml":                             "2.8.4",
         "valibot":                          "1.3.1",
         "execa":                            "9.6.1",
         "mkdirp":                           "3.0.1",

package/dst/ase-agent-base.js

@@ -1,34 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-/*  create agent command module  */
-export const createAgentCommandModule = (category, description, subCommands) => {
-    /*  create sub-command handler  */
-    const createSubCommandHandler = (subCommand) => {
-        return (_opts, cmd) => {
-            const opts = cmd.optsWithGlobals();
-            if (opts.debug)
-                console.log(`DEBUG: agent ${category} ${subCommand} command`);
-            if (opts.verbose)
-                console.log(`VERBOSE: executing agent ${category} ${subCommand}...`);
-            console.log(`Executing agent ${category} ${subCommand}...`);
-            /*  TODO: implement agent ${category} sub-command logic  */
-        };
-    };
-    return (parent) => {
-        const agent = parent
-            .command(`${category}`)
-            .description(`Execute ${description} agent operations`)
-            .option("-v, --verbose", "Enable verbose output", false);
-        /*  register all sub-commands  */
-        for (const subCmd of subCommands) {
-            agent
-                .command(subCmd)
-                .description(`Execute agent ${category} ${subCmd} operation`)
-                .action(createSubCommandHandler(subCmd));
-        }
-        return agent;
-    };
-};

package/dst/ase-agent-biz.js

@@ -1,40 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-/*  biz sub-commands  */
-const bizSubCommands = [
-    "understand",
-    "ideate",
-    "explore",
-    "specify"
-];
-/*  create sub-command handler  */
-const createSubCommandHandler = (subCommand) => {
-    return (_opts, cmd) => {
-        const opts = cmd.optsWithGlobals();
-        if (opts.debug)
-            console.log(`DEBUG: agent biz ${subCommand} command`);
-        if (opts.verbose)
-            console.log(`VERBOSE: executing agent biz ${subCommand}...`);
-        console.log(`Executing agent biz ${subCommand}...`);
-        /*  TODO: implement agent biz sub-command logic  */
-    };
-};
-/*  register biz command on the given parent  */
-const registerBizCommand = (parent) => {
-    const biz = parent
-        .command("biz")
-        .description("Execute business agent operations")
-        .option("-v, --verbose", "Enable verbose output", false);
-    /*  register all sub-commands  */
-    for (const subCmd of bizSubCommands) {
-        biz
-            .command(subCmd)
-            .description(`Execute agent biz ${subCmd} operation`)
-            .action(createSubCommandHandler(subCmd));
-    }
-    return biz;
-};
-export default registerBizCommand;

package/dst/ase-agent-dev.js

@@ -1,40 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-/*  dev sub-commands  */
-const devSubCommands = [
-    "design",
-    "implement",
-    "build",
-    "verify"
-];
-/*  create sub-command handler  */
-const createSubCommandHandler = (subCommand) => {
-    return (_opts, cmd) => {
-        const opts = cmd.optsWithGlobals();
-        if (opts.debug)
-            console.log(`DEBUG: agent dev ${subCommand} command`);
-        if (opts.verbose)
-            console.log(`VERBOSE: executing agent dev ${subCommand}...`);
-        console.log(`Executing agent dev ${subCommand}...`);
-        /*  TODO: implement agent dev sub-command logic  */
-    };
-};
-/*  register dev command on the given parent  */
-const registerDevCommand = (parent) => {
-    const dev = parent
-        .command("dev")
-        .description("Execute development agent operations")
-        .option("-v, --verbose", "Enable verbose output", false);
-    /*  register all sub-commands  */
-    for (const subCmd of devSubCommands) {
-        dev
-            .command(subCmd)
-            .description(`Execute agent dev ${subCmd} operation`)
-            .action(createSubCommandHandler(subCmd));
-    }
-    return dev;
-};
-export default registerDevCommand;

package/dst/ase-agent-ops.js

@@ -1,40 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-/*  ops sub-commands  */
-const opsSubCommands = [
-    "deploy",
-    "integrate",
-    "operate",
-    "monitor"
-];
-/*  create sub-command handler  */
-const createSubCommandHandler = (subCommand) => {
-    return (_opts, cmd) => {
-        const opts = cmd.optsWithGlobals();
-        if (opts.debug)
-            console.log(`DEBUG: agent ops ${subCommand} command`);
-        if (opts.verbose)
-            console.log(`VERBOSE: executing agent ops ${subCommand}...`);
-        console.log(`Executing agent ops ${subCommand}...`);
-        /*  TODO: implement agent ops sub-command logic  */
-    };
-};
-/*  register ops command on the given parent  */
-const registerOpsCommand = (parent) => {
-    const ops = parent
-        .command("ops")
-        .description("Execute operations agent operations")
-        .option("-v, --verbose", "Enable verbose output", false);
-    /*  register all sub-commands  */
-    for (const subCmd of opsSubCommands) {
-        ops
-            .command(subCmd)
-            .description(`Execute agent ops ${subCmd} operation`)
-            .action(createSubCommandHandler(subCmd));
-    }
-    return ops;
-};
-export default registerOpsCommand;

package/dst/ase-agent-prd.js

@@ -1,40 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-/*  prd sub-commands  */
-const prdSubCommands = [
-    "envision",
-    "configure",
-    "release",
-    "rollout"
-];
-/*  create sub-command handler  */
-const createSubCommandHandler = (subCommand) => {
-    return (_opts, cmd) => {
-        const opts = cmd.optsWithGlobals();
-        if (opts.debug)
-            console.log(`DEBUG: agent prd ${subCommand} command`);
-        if (opts.verbose)
-            console.log(`VERBOSE: executing agent prd ${subCommand}...`);
-        console.log(`Executing agent prd ${subCommand}...`);
-        /*  TODO: implement agent prd sub-command logic  */
-    };
-};
-/*  register prd command on the given parent  */
-const registerPrdCommand = (parent) => {
-    const prd = parent
-        .command("prd")
-        .description("Execute production agent operations")
-        .option("-v, --verbose", "Enable verbose output", false);
-    /*  register all sub-commands  */
-    for (const subCmd of prdSubCommands) {
-        prd
-            .command(subCmd)
-            .description(`Execute agent prd ${subCmd} operation`)
-            .action(createSubCommandHandler(subCmd));
-    }
-    return prd;
-};
-export default registerPrdCommand;

package/dst/ase-agent-prj.js

@@ -1,40 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-/*  prj sub-commands  */
-const prjSubCommands = [
-    "initiate",
-    "define",
-    "plan",
-    "steer"
-];
-/*  create sub-command handler  */
-const createSubCommandHandler = (subCommand) => {
-    return (_opts, cmd) => {
-        const opts = cmd.optsWithGlobals();
-        if (opts.debug)
-            console.log(`DEBUG: agent prj ${subCommand} command`);
-        if (opts.verbose)
-            console.log(`VERBOSE: executing agent prj ${subCommand}...`);
-        console.log(`Executing agent prj ${subCommand}...`);
-        /*  TODO: implement agent prj sub-command logic  */
-    };
-};
-/*  register prj command on the given parent  */
-const registerPrjCommand = (parent) => {
-    const prj = parent
-        .command("prj")
-        .description("Execute project agent operations")
-        .option("-v, --verbose", "Enable verbose output", false);
-    /*  register all sub-commands  */
-    for (const subCmd of prjSubCommands) {
-        prj
-            .command(subCmd)
-            .description(`Execute agent prj ${subCmd} operation`)
-            .action(createSubCommandHandler(subCmd));
-    }
-    return prj;
-};
-export default registerPrjCommand;

package/dst/ase-agent.js

@@ -1,25 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-import registerBizCommand from "./ase-agent-biz.js";
-import registerDevCommand from "./ase-agent-dev.js";
-import registerOpsCommand from "./ase-agent-ops.js";
-import registerPrdCommand from "./ase-agent-prd.js";
-import registerPrjCommand from "./ase-agent-prj.js";
-/*  register agent command on the given program  */
-const registerAgentCommand = (program) => {
-    const agent = program
-        .command("agent")
-        .description("Execute agent operations")
-        .option("-v, --verbose", "Enable verbose output", false);
-    /*  register all agent sub-commands  */
-    registerBizCommand(agent);
-    registerDevCommand(agent);
-    registerOpsCommand(agent);
-    registerPrdCommand(agent);
-    registerPrjCommand(agent);
-    return agent;
-};
-export default registerAgentCommand;

package/dst/ase-init.js

@@ -1,19 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-const initCommand = {
-    command: "init",
-    describe: "Initialize ASE configuration",
-    builder: (yargs) => {
-        return yargs;
-    },
-    handler: (argv) => {
-        if (argv.debug)
-            console.log("DEBUG: init command");
-        console.log("Initializing ASE configuration...");
-        /*  TODO: implement initialization logic  */
-    }
-};
-export default initCommand;

package/dst/ase-meta-plan.js

@@ -1,78 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-import path from "node:path";
-import fs from "node:fs";
-import { execa } from "execa";
-import { mkdirp } from "mkdirp";
-const configCommand = {
-    command: "meta-plan <subcommand>",
-    describe: "Manage plans",
-    builder: (yargs) => {
-        return yargs
-            .command({
-            command: "init",
-            describe: "ensure plan directory exists",
-            handler: async () => {
-                const { stdout: root } = await execa("git", ["rev-parse", "--show-toplevel"]);
-                const planDir = `${root}/.plan/`;
-                if (!fs.existsSync(planDir))
-                    await mkdirp(planDir);
-            }
-        })
-            .command({
-            command: "load <id>",
-            describe: "load a plan",
-            builder: (yargs) => yargs.positional("id", {
-                type: "string",
-                describe: "plan identifier"
-            }),
-            handler: async (argv) => {
-                const { stdout: root } = await execa("git", ["rev-parse", "--show-toplevel"]);
-                const planDir = `${root}/.plan/`;
-                const planFile = path.join(planDir, `${argv.id}.md`);
-                const text = fs.existsSync(planFile) ? fs.readFileSync(planFile, "utf8") : "";
-                process.stdout.write(text);
-            }
-        })
-            .command({
-            command: "save <id>",
-            describe: "save a plan",
-            builder: (yargs) => yargs.positional("id", {
-                type: "string",
-                describe: "plan identifier"
-            }),
-            handler: async (argv) => {
-                const { stdout: root } = await execa("git", ["rev-parse", "--show-toplevel"]);
-                const planDir = `${root}/.plan/`;
-                if (!fs.existsSync(planDir))
-                    await mkdirp(planDir);
-                const planFile = path.join(planDir, `${argv.id}.md`);
-                const text = fs.readFileSync(0, "utf8");
-                fs.writeFileSync(planFile, text);
-            }
-        })
-            .command({
-            command: "edit <id>",
-            describe: "edit a plan interactively with $EDITOR",
-            builder: (yargs) => yargs.positional("id", {
-                type: "string",
-                describe: "plan identifier"
-            }),
-            handler: async (argv) => {
-                const { stdout: root } = await execa("git", ["rev-parse", "--show-toplevel"]);
-                const planDir = `${root}/.plan/`;
-                const planFile = path.join(planDir, `${argv.id}.md`);
-                if (!fs.existsSync(planDir))
-                    await mkdirp(planDir);
-                const editor = process.env.EDITOR ?? "vi";
-                await execa(editor, [planFile], { stdio: "inherit" });
-            }
-        })
-            .demandCommand(1, "You need to specify a sub-command");
-    },
-    handler: () => { }
-};
-export default configCommand;

package/dst/ase-plan.js

@@ -1,82 +0,0 @@
-/*
-**  Agentic Software Engineering (ASE)
-**  Copyright (c) 2025-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
-**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
-*/
-import path from "node:path";
-import fs from "node:fs";
-import { execa } from "execa";
-import { mkdirp } from "mkdirp";
-const planCommand = {
-    command: "plan <subcommand>",
-    describe: "Manage plans",
-    builder: (yargs) => {
-        return yargs
-            .command({
-            command: "ensure",
-            describe: "ensure plan directory exists",
-            handler: async () => {
-                const { stdout: root } = await execa("git", ["rev-parse", "--show-toplevel"]);
-                const planDir = `${root}/.ase/plan/`;
-                if (!fs.existsSync(planDir))
-                    await mkdirp(planDir);
-                process.stdout.write(planDir);
-            }
-        })
-            .command({
-            command: "load <id>",
-            describe: "load a plan",
-            builder: (yargs) => yargs.positional("id", {
-                type: "string",
-                describe: "plan identifier"
-            }),
-            handler: async (argv) => {
-                const { stdout: root } = await execa("git", ["rev-parse", "--show-toplevel"]);
-                const planDir = `${root}/.ase/plan/`;
-                const planFile = path.join(planDir, `${argv.id}.md`);
-                const text = fs.existsSync(planFile) ? fs.readFileSync(planFile, "utf8") : "";
-                process.stdout.write(text);
-            }
-        })
-            .command({
-            command: "save <id>",
-            describe: "save a plan",
-            builder: (yargs) => yargs.positional("id", {
-                type: "string",
-                describe: "plan identifier"
-            }),
-            handler: async (argv) => {
-                const { stdout: root } = await execa("git", ["rev-parse", "--show-toplevel"]);
-                const planDir = `${root}/.ase/plan/`;
-                if (!fs.existsSync(planDir))
-                    await mkdirp(planDir);
-                const planFile = path.join(planDir, `${argv.id}.md`);
-                const chunks = [];
-                for await (const chunk of process.stdin)
-                    chunks.push(chunk);
-                const text = Buffer.concat(chunks).toString("utf8");
-                fs.writeFileSync(planFile, text);
-            }
-        })
-            .command({
-            command: "edit <id>",
-            describe: "edit a plan interactively with $EDITOR",
-            builder: (yargs) => yargs.positional("id", {
-                type: "string",
-                describe: "plan identifier"
-            }),
-            handler: async (argv) => {
-                const { stdout: root } = await execa("git", ["rev-parse", "--show-toplevel"]);
-                const planDir = `${root}/.ase/plan/`;
-                const planFile = path.join(planDir, `${argv.id}.md`);
-                if (!fs.existsSync(planDir))
-                    await mkdirp(planDir);
-                const editor = process.env.EDITOR ?? "vi";
-                await execa(editor, [planFile], { stdio: "inherit" });
-            }
-        })
-            .demandCommand(1, "You need to specify a sub-command");
-    },
-    handler: () => { }
-};
-export default planCommand;

package/dst/ase.1

@@ -1,91 +0,0 @@
-.TH "ASE" "1" "April 2026" "" ""
-.SH "NAME"
-\fBase\fR - Agentic Software Engineering (ASE)
-.SH "SYNOPSIS"
-.P
-\fBase\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-V\fR|\fB--version\fR\[rB] \[lB]\fB-l\fR|\fB--log-level\fR \fIlevel\fR\[rB] \[lB]\fB-L\fR|\fB--log-file\fR \fIfile\fR\[rB] \[lB]\fIcommand\fR \[lB]\fIoptions\fR \[lB]...\[rB]\[rB] \[lB]\fIargs\fR \[lB]...\[rB]\[rB]\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase\fR, \fIAgentic Software Engineering (ASE)\fR, is the command-line companion tool to the \fIASE\fR Claude Code plugin. It provides project-level configuration management and a small per-project background HTTP service for dispatching commands.
-.SH "OPTIONS"
-.P
-The following top-level command-line options exist:
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show program usage information only.
-.IP \(bu 4
-\[lB]\fB-V\fR|\fB--version\fR\[rB]: Show program version information only.
-.IP \(bu 4
-\[lB]\fB-l\fR|\fB--log-level\fR \fIlevel\fR\[rB]: Set the logging verbosity. Supported \fIlevel\fR values are \fBerror\fR, \fBwarning\fR (default), \fBinfo\fR, and \fBdebug\fR.
-.IP \(bu 4
-\[lB]\fB-L\fR|\fB--log-file\fR \fIfile\fR\[rB]: Redirect log output to \fIfile\fR (appended). Use \fB-\fR (default) to write log messages to standard output. If \fIfile\fR is connected to a TTY, colors are used in the output.
-.RE 0
-
-.SH "COMMANDS"
-.P
-The following top-level commands exist for configuration handling:
-.RS 0
-.IP \(bu 4
-\fBase config\fR: Manage \fIASE\fR configuration stored in \fB.ase/config.yaml\fR. Without a subcommand, prints usage information. The file is validated against a schema: on read, unknown or invalid entries are warned about and silently dropped from the in-memory view; on set/write, they cause a fatal error. Recognized keys are grouped under three top-level sections: \fBproject.*\fR (project identity, classification, and artifact globs), \fBagent.*\fR (agent persona and process), and \fBtask.*\fR (currently \fBtask.id\fR, the active task identifier). All \fBase config\fR subcommands accept a \fB--scope\fR \fIscope\fR option that selects the scope chain. The \fIscope\fR value is a comma-separated list of scope terms, in any order; each term is one of \fBuser\fR, \fBproject\fR, \fBtask:\fR\fIid\fR, or \fBsession:\fR\fIid\fR (where \fIid\fR matches \fB\[lB]A-Za-z0-9._-\[rB]+\fR). At most one term per kind is allowed. The chain is canonicalized into the fixed inheritance order \fBuser\fR < \fBproject\fR < \fBtask\fR < \fBsession\fR. \fBuser\fR is always implicitly added at the bottom of the chain. \fBproject\fR is implicitly added only when a \fIproject context\fR exists -- i.e. when the current working directory is inside a Git repository, or a \fB.ase\fR directory is found at or above it. Specifying \fBproject\fR explicitly without a project context is an error. Without an explicit \fB--scope\fR, the target defaults to \fBproject\fR when a project context exists, otherwise to \fBuser\fR. Reads cascade from the strongest (rightmost) scope down to the weakest and return the first value that is defined. Writes (\fBset\fR, \fBdelete\fR, \fBedit\fR, \fBinit\fR) are always confined to the strongest (target) scope's own file -- intermediate and weaker scopes are never modified. See \fIFILES\fR below for the resulting paths. Example: \fB--scope task:T1,session:S1\fR yields the chain \fBuser\fR -> \fBproject\fR -> \fBtask:T1\fR -> \fBsession:S1\fR, with \fBsession:S1\fR as the write target.
-.IP \(bu 4
-\fBase config init\fR \fItype\fR: Initialize \fB.ase/config.yaml\fR with preset values for all recognized keys. The \fItype\fR argument selects the preset: \fBvibe\fR (solo rookie: small black-box prototype, bare code, fully agent-driven, spec-driven, engineer ambition), \fBpro\fR (solo expert: medium white-box product, framework-based, human-controlled, code-driven, artist ambition), or \fBindustry\fR (team crew: large grey-box MVP, framework-based, human-in-the-loop, code-driven, craftsman ambition).
-.IP \(bu 4
-\fBase config edit\fR: Open \fB.ase/config.yaml\fR in the editor defined by the \fB$EDITOR\fR or \fB$VISUAL\fR environment variable (falling back to \fBvi\fR). The file and its parent directory are created if missing. After the editor exits, the file is re-read and schema warnings are reported.
-.IP \(bu 4
-\fBase config list\fR: List all effective configured values across the scope inheritance chain, rendered as a three-column table of \fBkey\fR, \fBvalue\fR, and \fBorigin\fR. The \fBorigin\fR column identifies the scope (\fBuser\fR, \fBproject\fR, \fBtask:\fR\fIid\fR, or \fBsession:\fR\fIid\fR) that supplied each value. For overlapping keys only the value from the strongest scope is shown.
-.IP \(bu 4
-\fBase config get\fR \fIkey\fR: Print the value at the given dotted \fIkey\fR. Fails with an error if \fIkey\fR does not resolve to a leaf value.
-.IP \(bu 4
-\fBase config set\fR \fIkey\fR \fIvalue\fR: Set the value at the given dotted \fIkey\fR (creating intermediate maps as needed) and persist the file.
-.RE 0
-
-.P
-The following top-level commands exist for service management:
-.RS 0
-.IP \(bu 4
-\fBase service\fR: Manage the per-project background HTTP service. The service is bound to \fB127.0.0.1\fR on a port persisted in \fB.ase/service.yaml\fR and stops itself after 30 minutes of idle time. Without a subcommand, the help text is shown.
-.IP \(bu 4
-\fBase service start\fR: Start the background service (detached). Allocates a random port in the range \fB42000\fR..\fB44000\fR if none is persisted yet, writes it to \fB.ase/service.yaml\fR, and probes readiness. Exits silently with status 0 if the service is already running; prints \fBase: service: started on port <port>\fR on a fresh start.
-.IP \(bu 4
-\fBase service status\fR: Report whether the background service is running. Probes the persisted port via HTTP \fBGET /ping\fR and verifies that the responding service belongs to the current project. Prints \fBase: service: running on port <port>\fR and exits with status 0 if a matching service is reachable; otherwise prints a diagnostic message (no port configured, port not responding, or port in use by a foreign service) and exits with status 1.
-.IP \(bu 4
-\fBase service send\fR \fIcmd\fR: Dispatch the \fIcmd\fR token as a passthrough command to the running service via HTTP \fBPOST /command\fR; if the service is not running, it is auto-started first.
-.IP \(bu 4
-\fBase service stop\fR: Stop the background service via HTTP \fBGET /stop\fR. Exits silently with status 0 on successful stop. If no port is configured or the port is not responding, prints an informational message and exits with status 0.
-.RE 0
-
-.P
-The following top-level commands exist for \fIClaude Code\fR hook integration:
-.RS 0
-.IP \(bu 4
-\fBase hook\fR: Entry point group for \fIClaude Code\fR hook events. Without a subcommand, the help text is shown and the command exits with status 1.
-.IP \(bu 4
-\fBase hook session-start\fR: Handle the \fIClaude Code\fR \fBSessionStart\fR hook event. This subcommand is intended to be invoked by \fIClaude Code\fR internally as a configured hook handler only, not directly by end users.
-.RE 0
-
-.SH "CONFIGURATION FILES"
-.RS 0
-.IP \(bu 4
-\fBuser\fR: \fIper-user configuration directory\fR\fB/config.yaml\fR: Per-user \fIASE\fR configuration (scope \fBuser\fR). The per-user configuration directory is \fB~/Library/Application Support/ase\fR on macOS, \fB%APPDATA%\[rs]ase\fR on Windows, and \fB$XDG_CONFIG_HOME/ase\fR (falling back to \fB~/.config/ase\fR) on Linux and other Unix systems.
-.IP \(bu 4
-\fBproject\fR: \fB.ase/config.yaml\fR: Per-project \fIASE\fR configuration (scope \fBproject\fR). Read upward from the current working directory.
-.IP \(bu 4
-\fBtask\fR: \fB.ase/task/\fR\fIid\fR\fB/config.yaml\fR: Per-task \fIASE\fR configuration (scope \fBtask:\fR\fIid\fR), located relative to the Git top-level directory. Outside a Git repository, the file is placed relative to the current working directory.
-.IP \(bu 4
-\fBsession\fR: \fB~/.ase/session/\fR\fIid\fR\fB/config.yaml\fR: Per-session \fIASE\fR configuration (scope \fBsession:\fR\fIid\fR), located under the user's home directory (independent of any project context).
-.RE 0
-
-.SH "STATE FILES"
-.RS 0
-.IP \(bu 4
-\fB.ase/service.yaml\fR: Per-project service state.
-.IP \(bu 4
-\fB.ase/service.log\fR: Stdout/stderr log of the detached background service.
-.RE 0
-
-.SH "HISTORY"
-.P
-\fBase\fR was started to be developed in October 2025.
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR