@rse/ase 0.0.6 → 0.0.8

package/dst/ase-setup.js

@@ -3,17 +3,16 @@
 **  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 setupCommand = {
-    command: "setup",
-    describe: "Setup ASE",
-    builder: (yargs) => {
-        return yargs;
-    },
-    handler: (argv) => {
-        if (argv.debug)
+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 setupCommand;
+export default registerSetupCommand;

package/dst/ase.1

@@ -3,23 +3,70 @@
 \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]\fIcommand\fR \[lB]\fIoptions\fR \[lB]...\[rB]\[rB]\[rB] \[lB]\fIargs\fR \[lB]...\[rB]\[rB]\[rB]
+\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 Engineeing (ASE)\fR, is a small command-line tool...
+\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 command-line options and arguments exist:
+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.
+.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 configured values as flat dotted keys, rendered as a two-column table of \fBkey\fR and \fBvalue\fR.
+.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
+
+.SH "FILES"
+.RS 0
+.IP \(bu 4
+\fB.ase/config.yaml\fR: Per-project \fIASE\fR configuration. Read upward from the current working directory. Recognized keys: \fBproject.id\fR (non-empty string, uniqued project id), \fBproject.name\fR (non-empty string, descriptive project name), \fBproject.source.ambition\fR (\fBartist\fR|\fBcraftsman\fR|\fBengineer\fR), \fBproject.source.boxing\fR (\fBwhite\fR|\fBgrey\fR|\fBblack\fR), \fBproject.source.size\fR (\fBsmall\fR|\fBmedium\fR|\fBlarge\fR), \fBproject.source.structure\fR (\fBbare\fR|\fBlibrary\fR|\fBframework\fR), \fBproject.process.actors\fR (\fBperson\fR|\fBteam\fR|\fBcrew\fR), \fBproject.process.control\fR (\fBhuman\fR|\fBhitl\fR|\fBagent\fR), \fBproject.process.drive\fR (\fBspec\fR|\fBcode\fR|\fBtest\fR), and \fBproject.result.target\fR (\fBprototype\fR|\fBmvp\fR|\fBproduct\fR).
+.IP \(bu 4
+\fB.ase/service.yaml\fR: Per-project service state. Recognized key: \fBport\fR (integer in \fB1024\fR..\fB65535\fR).
+.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...
+\fBase\fR was started to be developed in October 2025.
 .SH "AUTHOR"
 .P
 Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/ase.js

@@ -4,40 +4,53 @@
 **  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 yargs from "yargs";
-import { hideBin } from "yargs/helpers";
-import configCommand from "./ase-config.js";
-import setupCommand from "./ase-setup.js";
-import serviceCommand from "./ase-service.js";
-/*  parse CLI arguments  */
-try {
-    await yargs(hideBin(process.argv))
-        .scriptName("ase")
-        .usage("Usage: $0 <command> [options]")
-        .option("debug", {
-        alias: "d",
-        type: "boolean",
-        describe: "Enable debug output",
-        default: false
-    })
-        .command(configCommand)
-        .command(setupCommand)
-        .command(serviceCommand)
-        .demandCommand(1, "You need to specify a command")
-        .fail((msg, err, yargs) => {
-        if (err)
-            throw err;
-        yargs.showHelp();
-        process.stderr.write(`\nase: ${msg}\n`);
-        process.exit(1);
-    })
-        .help()
-        .version()
-        .strict()
-        .parseAsync();
-}
-catch (err) {
+import { Command, CommanderError, Option } from "commander";
+import Log from "./ase-log.js";
+import ConfigCommand from "./ase-config.js";
+import ServiceCommand from "./ase-service.js";
+import pkg from "../package.json" with { type: "json" };
+/*  globally initialize logger  */
+const log = new Log("ase", "warning", "-");
+/*  main entry point (wrapped in a regular async function to avoid
+    top-level await, which would be reported as "unsettled" by Node in
+    the long-running daemon process spawned by "ase service start")  */
+const main = async () => {
+    await log.init();
+    /*  establish top-level program  */
+    const program = new Command();
+    program
+        .name("ase")
+        .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"))
+        .option("-L, --log-file  <file>", "log file path, or \"-\" for stdout", "-")
+        .showHelpAfterError()
+        .enablePositionalOptions()
+        .exitOverride();
+    /*  establish shared logger with defaults and then apply parsed
+        global options to the logger before any subcommand action  */
+    program.hook("preAction", async () => {
+        const opts = program.opts();
+        log.logLevel(opts.logLevel);
+        log.logFile(opts.logFile);
+    });
+    /*  register top-level commands  */
+    new ConfigCommand(log).register(program);
+    new ServiceCommand(log).register(program);
+    /*  parse program arguments  */
+    await program.parseAsync(process.argv);
+    /*  gracefully terminate  */
+    process.exit(0);
+};
+main().catch((err) => {
+    if (err instanceof CommanderError) {
+        if (err.exitCode !== 0)
+            process.exit(err.exitCode);
+        else
+            process.exit(0);
+    }
     const message = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`ase: ERROR: ${message}\n`);
+    log.write("error", message);
     process.exit(1);
-}
+});

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.6",
+    "version":                              "0.0.8",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -35,15 +35,20 @@
         "remark-man":                       "9.0.0",
 
         "@types/node":                      "25.6.0",
-        "@types/yargs":                     "17.0.35"
+        "@types/luxon":                     "3.7.1"
     },
     "dependencies": {
-        "yargs":                            "18.0.0",
+        "commander":                        "14.0.3",
         "yaml":                             "2.8.3",
+        "valibot":                          "1.3.1",
         "execa":                            "9.6.1",
         "mkdirp":                           "3.0.1",
         "@hapi/hapi":                       "21.4.8",
-        "axios":                            "1.15.0"
+        "axios":                            "1.15.1",
+        "cli-table3":                       "0.6.5",
+        "chalk":                            "5.6.2",
+        "pretty-ms":                        "9.3.0",
+        "luxon":                            "3.7.2"
     },
     "engines": {
         "npm":                              ">=10.0.0",

package/README.md

@@ -1,42 +0,0 @@
-
-$ npx @rse/ase init
-$ npx @rse/ase config agent.dev.llm.type=anthropic-claude-sonnet-4.5
-$ npx @rse/ase config agent.dev.llm.key=<foo>
-$ npx @rse/ase agent dev start
-
-Agents
-------
-
-- PRJ (Project)
-  Objective: Project Steering
-  Input: time, cost, scope
-  Output: tasks
-
-- PRD (Product)
-  Objective: Product Life-Cycle
-  Input: vision
-  Output: product roadmap
-
-- BIZ (Business)
-  Objective: Product Specification
-  Input: product roadmap
-  Output: requirements specification
-
-- ARC (Architecture)
-  Objective: Product Development
-  Input: requirements specification
-  Output: architecture description
-
-- DEV (Development)
-  Objective: Product Development
-  Input: requirements specification, architecture description
-  Output: source code, deployment units
-
-- OPS (Operations)
-  Objective: Solution Operations
-
-- spec req
-- arch arc
-- code src
-- docs doc
-