@rse/ase 0.0.7 → 0.0.8

package/dst/ase.1

@@ -3,7 +3,7 @@
 \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-d\fR|\fB--debug\fR\[rB] \[lB]\fIcommand\fR \[lB]\fIoptions\fR \[lB]...\[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 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.
@@ -16,37 +16,48 @@ The following top-level command-line options exist:
 .IP \(bu 4
 \[lB]\fB-V\fR|\fB--version\fR\[rB]: Show program version information only.
 .IP \(bu 4
-\[lB]\fB-d\fR|\fB--debug\fR\[rB]: Enable debug output. The flag is inherited by all subcommands and can be inspected inside handlers via \fBcmd.optsWithGlobals()\fR.
+\[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:
+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 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.
+\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 set\fR \fIkey\fR \fIvalue\fR: Set the value at the given dotted \fIkey\fR (creating intermediate maps as needed) and persist the file.
+\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 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.
+\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 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.
+\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 key: \fBproject.id\fR (non-empty string).
+\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

package/dst/ase.js

@@ -4,29 +4,46 @@
 **  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 { Command, CommanderError } from "commander";
-import registerConfigCommand from "./ase-config.js";
-import registerServiceCommand from "./ase-service.js";
-/*  parse CLI arguments  */
-try {
+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]")
-        .option("-d, --debug", "enable debug output", false)
+        .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  */
-    registerConfigCommand(program);
-    registerServiceCommand(program);
+    new ConfigCommand(log).register(program);
+    new ServiceCommand(log).register(program);
     /*  parse program arguments  */
     await program.parseAsync(process.argv);
     /*  gracefully terminate  */
     process.exit(0);
-}
-catch (err) {
+};
+main().catch((err) => {
     if (err instanceof CommanderError) {
         if (err.exitCode !== 0)
             process.exit(err.exitCode);
@@ -34,6 +51,6 @@ catch (err) {
             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.7",
+    "version":                              "0.0.8",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -34,7 +34,8 @@
         "remark":                           "15.0.1",
         "remark-man":                       "9.0.0",
 
-        "@types/node":                      "25.6.0"
+        "@types/node":                      "25.6.0",
+        "@types/luxon":                     "3.7.1"
     },
     "dependencies": {
         "commander":                        "14.0.3",
@@ -43,8 +44,11 @@
         "execa":                            "9.6.1",
         "mkdirp":                           "3.0.1",
         "@hapi/hapi":                       "21.4.8",
-        "axios":                            "1.15.0",
-        "cli-table3":                       "0.6.5"
+        "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
-