@rse/ase 2.0.2 → 2.0.4

package/dst/man/ase-hook-pre-tool-use.1

@@ -1,59 +0,0 @@
-.TH "ASE-HOOK-PRE-TOOL-USE" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-hook-pre-tool-use\fR - Handle the PreToolUse Hook Event
-.SH "SYNOPSIS"
-.P
-\fBase hook pre-tool-use\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase hook pre-tool-use\fR handles the \fBPreToolUse\fR hook event of \fIAnthropic Claude Code CLI\fR and \fIOpenAI Codex CLI\fR, resp. the \fBpreToolUse\fR hook event of \fIGitHub Copilot CLI\fR, which the agent tool fires before each tool invocation. It is intended to be invoked by the agent tool internally as a configured hook handler only, and not directly by end users.
-.P
-The handler reads the event payload from standard input, a JSON object with the tool name (field \fBtool_name\fR, resp. \fBtoolName\fR for \fIGitHub Copilot CLI\fR), the tool input (field \fBtool_input\fR, resp. \fBtoolArgs\fR, either an object or a JSON-encoded string), and the session id (field \fBsession_id\fR, resp. \fBsessionId\fR). It auto-approves the invocation, so the user is not prompted for it, if it is one of the following:
-.RS 0
-.IP \(bu 4
-a shell command (tool \fBBash\fR, resp. \fBbash\fR) starting with the word \fBase\fR and not containing any of the characters \fB;\fR, \fB&\fR, \fB|\fR, \fB<\fR, \fB>\fR, backtick, or newline, or a \fB$(\fR command substitution;
-.IP \(bu 4
-a skill invocation (tool \fBSkill\fR) of an \fIASE\fR skill (\fBase-\fR\fIname\fR, optionally namespaced as \fBase:ase-\fR\fIname\fR);
-.IP \(bu 4
-an \fIASE\fR MCP tool (\fBmcp__plugin_ase_ase__\fR\fItool\fR for \fBclaude\fR, \fBase-\fR\fItool\fR for \fBcopilot\fR, and \fBmcp__ase__\fR\fItool\fR for \fBcodex\fR);
-.IP \(bu 4
-a tool of one of the pre-defined foreign MCP servers of \fBase setup
-mcp\fR (\fBchat-alibaba-qwen\fR, \fBchat-deepseek\fR, \fBchat-google-gemini\fR, \fBchat-openai-chatgpt\fR, \fBchat-xai-grok\fR, \fBchat-zai-glm\fR, \fBsearch-brave\fR, \fBsearch-exa\fR, and \fBsearch-perplexity\fR, named \fBmcp__\fR\fIserver\fR\fB__\fR\fItool\fR resp. \fIserver\fR\fB-\fR\fItool\fR for \fBcopilot\fR);
-.IP \(bu 4
-a file read (tool \fBRead\fR) of a file located below the plugin root directory (e.g., the meta files included by the skills);
-.IP \(bu 4
-a file edit (tool \fBEdit\fR) while one of the edit-capable skills \fBase-code-lint\fR, \fBase-docs-shorten\fR, \fBase-docs-refine\fR, or \fBase-docs-proofread\fR is recorded as active in the internal session state of the session.
-.RE 0
-.P
-On approval, the handler writes the decision \fBpermissionDecision:
-allow\fR with a human-readable \fBpermissionDecisionReason\fR to standard output, nested in \fBhookSpecificOutput\fR (\fBclaude\fR), resp. as top-level fields (\fBcopilot\fR). Otherwise, it stays silent and hence defers to the regular permission flow of the agent tool.
-.P
-For \fB--tool codex\fR, the handler only drains its standard input and stays silent, as \fIOpenAI Codex CLI\fR rejects an approval in \fBPreToolUse\fR; the approval is granted by \fBase hook permission-request\fR instead.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: The agent tool whose event payload is read and whose decision format is written: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR. Default: \fB$ASE_TOOL\fR, else \fBclaude\fR.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBCLAUDE_PLUGIN_ROOT\fR, \fBCOPILOT_PLUGIN_ROOT\fR, \fBPLUGIN_ROOT\fR: The plugin root directory for the auto-approval of plugin file reads. If unset, such reads are not auto-approved.
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fIper-user state directory\fR\fB/session/\fR\fIid\fR\fB/state.yaml\fR: The internal session state, whose \fBskill\fR field records the active edit-capable skill.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR, unless \fB--tool\fR is invalid (status \fB1\fR).
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-hook\fR(1), \fBase-hook-permission-request\fR(1), \fBase-setup-mcp\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-hook-session-end.1

@@ -1,47 +0,0 @@
-.TH "ASE-HOOK-SESSION-END" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-hook-session-end\fR - Handle the SessionEnd Hook Event
-.SH "SYNOPSIS"
-.P
-\fBase hook session-end\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase hook session-end\fR handles the \fBSessionEnd\fR hook event of \fIAnthropic Claude Code CLI\fR and \fIOpenAI Codex CLI\fR, resp. the \fBsessionEnd\fR hook event of \fIGitHub Copilot CLI\fR. It is intended to be invoked by the agent tool internally as a configured hook handler only, and not directly by end users.
-.P
-The handler reads the event payload from standard input, a JSON object with the session id (field \fBsession_id\fR, resp. \fBsessionId\fR). For a valid session id (matching \fB\[lB]A-Za-z0-9._-\[rB]+\fR), it:
-.RS 0
-.IP 1. 4
-removes the session directory \fIper-user state directory\fR\fB/session/\fR\fIid\fR with the session-scoped configuration (scope \fBsession:\fR\fIid\fR) and the internal session state, and
-.IP 2. 4
-detaches the session from its AI usage window (if any, see \fBase-task-assign\fR(1)) through the \fBase service\fR of the owning project, which closes and books the window once no other session remains attached to it. If the owning project service is not reachable in time, the session end is noted in the session registry (\fIper-user state directory\fR\fB/telemetry.json\fR) instead, and the service is started in the background, which then detaches the session as of its noted end. A failure is only warned about.
-.RE 0
-.P
-An empty, malformed, or invalid payload is silently ignored. The handler writes nothing to standard output.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: The agent tool whose event payload is read: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR. Default: \fB$ASE_TOOL\fR, else \fBclaude\fR.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fIper-user state directory\fR\fB/session/\fR\fIid\fR\fB/\fR: The per-session directory, removed by this handler.
-.IP \(bu 4
-\fIper-user state directory\fR\fB/telemetry.json\fR: The telemetry state, whose session registry routes the session to the service of its project.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR, unless \fB--tool\fR is invalid (status \fB1\fR).
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-hook\fR(1), \fBase-hook-session-start\fR(1), \fBase-task-assign\fR(1), \fBase-service\fR(1), \fBase-setup-telemetry\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-hook-session-persona.1

@@ -1,37 +0,0 @@
-.TH "ASE-HOOK-SESSION-PERSONA" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-hook-session-persona\fR - Handle the SessionStart Hook Event for the Persona
-.SH "SYNOPSIS"
-.P
-\fBase hook session-persona\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase hook session-persona\fR handles the \fBSessionStart\fR hook event of \fIAnthropic Claude Code CLI\fR and \fIOpenAI Codex CLI\fR, resp. the \fBsessionStart\fR hook event of \fIGitHub Copilot CLI\fR, in addition to \fBase hook session-start\fR. It is intended to be invoked by the agent tool internally as a configured hook handler only, and not directly by end users.
-.P
-The handler determines the plugin root directory (see \fBase-hook-session-start\fR(1)), reads the persona rules \fBmeta/ase-persona.md\fR from it, and writes them as the hook output payload to standard output, as \fBhookSpecificOutput.additionalContext\fR (\fBclaude\fR and \fBcodex\fR), resp. as the top-level field \fBadditionalContext\fR (\fBcopilot\fR).
-.P
-The persona rules are injected by this separate handler, as agent tools like \fIAnthropic Claude Code CLI\fR show only a preview of a hook output beyond 10,000 characters, which otherwise would cut off the persona rules from the output of \fBase hook session-start\fR. The rules refer to the persona style \fB<ase-persona-style>\fR injected by \fBase hook
-session-start\fR, but only by name, so both handlers are independent of each other and their execution order does not matter.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: The agent tool whose hook output format is written: \fBclaude\fR (\fIAnthropic Claude Code CLI\fR), \fBcopilot\fR (\fIGitHub Copilot CLI\fR), or \fBcodex\fR (\fIOpenAI Codex CLI\fR). Default: \fB$ASE_TOOL\fR, else \fBclaude\fR.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBCLAUDE_PLUGIN_ROOT\fR, \fBCOPILOT_PLUGIN_ROOT\fR, \fBPLUGIN_ROOT\fR: The plugin root directory, provided by the agent tool. The handler fails if the variable of the selected tool is unset or empty.
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR on success, and with status \fB1\fR if the plugin root directory cannot be determined, the persona file cannot be read, or \fB--tool\fR is invalid.
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-hook\fR(1), \fBase-hook-session-start\fR(1), \fBase-config\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-hook-session-start.1

@@ -1,81 +0,0 @@
-.TH "ASE-HOOK-SESSION-START" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-hook-session-start\fR - Handle the SessionStart Hook Event
-.SH "SYNOPSIS"
-.P
-\fBase hook session-start\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase hook session-start\fR handles the \fBSessionStart\fR hook event of \fIAnthropic Claude Code CLI\fR and \fIOpenAI Codex CLI\fR, resp. the \fBsessionStart\fR hook event of \fIGitHub Copilot CLI\fR. It is intended to be invoked by the agent tool internally as a configured hook handler only, and not directly by end users.
-.P
-The handler reads the event payload from standard input, a JSON object with the session id (field \fBsession_id\fR, resp. \fBsessionId\fR for \fIGitHub Copilot CLI\fR) and the working directory (field \fBcwd\fR), and performs the following steps:
-.RS 0
-.IP 1. 4
-It determines the plugin root directory from the environment variable \fBCLAUDE_PLUGIN_ROOT\fR (\fBclaude\fR), \fBCOPILOT_PLUGIN_ROOT\fR (\fBcopilot\fR), resp. \fBPLUGIN_ROOT\fR or \fBCLAUDE_PLUGIN_ROOT\fR (\fBcodex\fR), and reads the plugin manifest \fB.claude-plugin/plugin.json\fR (for the plugin version), the constitution \fBmeta/ase-constitution.md\fR, and the output style \fBoutput-styles/ase-terse.md\fR from it.
-.IP 2. 4
-It determines a version hint: a warning on a version mismatch between the tool and the plugin, a notice on a newer tool version available in the NPM registry (checked in the background at most once per hour), and a notice on a development setup (environment variable \fBASE_SETUP_DEV\fR set).
-.IP 3. 4
-For \fB--tool copilot\fR only, it changes into the project directory \fBcwd\fR of the payload, as \fIGitHub Copilot CLI\fR runs its hooks in the plugin installation directory.
-.IP 4. 4
-It removes all session state directories below the \fIper-user state directory\fR\fB/session/\fR (except the one of the current session) which were not modified for more than 7 days, i.e., the leftovers of agent tool sessions which ended without running \fBase hook session-end\fR.
-.IP 5. 4
-It determines the project directory (the Git top-level directory of \fBcwd\fR, else \fBcwd\fR itself) and, for a valid session id (matching \fB\[lB]A-Za-z0-9._-\[rB]+\fR), persists the active task id (\fB$ASE_TASK_ID\fR, else \fBdefault\fR) and the project directory into the internal session state \fIper-user state directory\fR\fB/session/\fR\fIid\fR\fB/state.yaml\fR.
-.IP 6. 4
-Inside a \fItmux\fR pane, it sets the per-pane user option \fB@ase_agent_status\fR to \fB⏸\fR (ready).
-.IP 7. 4
-It resolves the session information from the configuration cascade (with the scope \fBsession:\fR\fIid\fR for a valid session id): the project id (a valid configured \fBproject.id\fR, else derived from the project directory), the user id (\fB$USER\fR, else \fB$LOGNAME\fR, else \fBunknown\fR), the persona style \fBagent.persona\fR, the guidance level \fBagent.guidance\fR, the boxing transparency \fBproject.boxing\fR, the task lifecycle model \fBproject.task.lifecycle\fR, the defaults \fBproject.task.default.source\fR, \fBproject.task.default.changeset\fR, and \fBproject.task.default.target\fR, the specification base directory \fBproject.artifact.spec.basedir\fR, and the schema configuration \fBproject.artifact.spec.schema\fR.
-.sp
-A setting not explicitly configured in any scope falls back to the environment variables \fBASE_PERSONA_STYLE\fR, \fBASE_GUIDANCE_LEVEL\fR, \fBASE_PROJECT_BOXING\fR, \fBASE_PROJECT_TASK_LIFECYCLE\fR, \fBASE_PROJECT_TASK_DEFAULT_SOURCE\fR, \fBASE_PROJECT_TASK_DEFAULT_CHANGESET\fR, and \fBASE_PROJECT_TASK_DEFAULT_TARGET\fR, and finally to the defaults \fBengineer\fR, \fBnormal\fR, \fBwhite\fR, \fBsolo\fR, \fBworktree\fR, \fBworktree\fR, and \fBsource\fR.
-.IP 8. 4
-For \fB--tool claude\fR only, it appends \fBexport\fR statements of the variables \fBASE_VERSION\fR, \fBASE_PLUGIN_ROOT\fR, \fBASE_USER_ID\fR, \fBASE_PROJECT_ID\fR, \fBASE_PROJECT_BOXING\fR, \fBASE_PROJECT_TASK_LIFECYCLE\fR, \fBASE_PROJECT_TASK_DEFAULT_SOURCE\fR, \fBASE_PROJECT_TASK_DEFAULT_CHANGESET\fR, \fBASE_PROJECT_TASK_DEFAULT_TARGET\fR, \fBASE_SPEC_BASEDIR\fR, \fBASE_SPEC_SCHEMA\fR, \fBASE_TASK_ID\fR, \fBASE_SESSION_ID\fR, \fBASE_HEADLESS\fR, and \fBASE_AGENT_TOOL\fR to the file of the environment variable \fBCLAUDE_ENV_FILE\fR (if set), so they are available to all shell commands of the session.
-.IP 9. 4
-It writes the hook output payload to standard output: the session information as XML-style tags (\fB<ase-version>\fR, \fB<ase-version-hint>\fR, \fB<ase-plugin-root>\fR, \fB<ase-persona-style>\fR, \fB<ase-guidance-level>\fR, \fB<ase-user-id>\fR, \fB<ase-project-id>\fR, \fB<ase-project-boxing>\fR, \fB<ase-project-task-lifecycle>\fR, \fB<ase-project-task-default-source>\fR, \fB<ase-project-task-default-changeset>\fR, \fB<ase-project-task-default-target>\fR, \fB<ase-spec-basedir>\fR, \fB<ase-spec-schema>\fR, \fB<ase-task-id>\fR, \fB<ase-session-id>\fR, \fB<ase-headless>\fR, and \fB<ase-agent-tool>\fR), followed by the constitution, with all \fB@\fR\fIfile\fR references expanded recursively (relative to the referencing file, \fB~/\fR denoting the home directory).
-.sp
-The persona rules are not part of this output, but are injected separately by \fBase hook session-persona\fR, as agent tools like \fIAnthropic Claude Code CLI\fR show only a preview of a hook output beyond 10,000 characters.
-.sp
-For \fB--tool copilot\fR and \fB--tool codex\fR only, the instructions of the output style \fBase-terse\fR (with its YAML frontmatter stripped) are appended, as these agent tools have no output style concept, whereas \fIAnthropic Claude Code CLI\fR applies the plugin output style natively. The context is emitted as \fBhookSpecificOutput.additionalContext\fR (\fBclaude\fR and \fBcodex\fR), resp. as the top-level field \fBadditionalContext\fR (\fBcopilot\fR).
-.sp
-Additionally, for \fBclaude\fR and \fBcodex\fR, unless running headless (\fBASE_HEADLESS\fR is \fBtrue\fR) or with guidance level \fBnone\fR, a deterministic \fIASE\fR banner (version, user, project, task, session, persona, guidance, and boxing, plus usage hints for guidance level \fBnormal\fR and \fBverbose\fR) is emitted as the top-level field \fBsystemMessage\fR.
-.RE 0
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: The agent tool whose event payload is read and whose hook output format is written: \fBclaude\fR (\fIAnthropic Claude Code CLI\fR), \fBcopilot\fR (\fIGitHub Copilot CLI\fR), or \fBcodex\fR (\fIOpenAI Codex CLI\fR). Default: \fB$ASE_TOOL\fR, else \fBclaude\fR.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBCLAUDE_PLUGIN_ROOT\fR, \fBCOPILOT_PLUGIN_ROOT\fR, \fBPLUGIN_ROOT\fR: The plugin root directory, provided by the agent tool. The handler fails if the variable of the selected tool is unset or empty.
-.IP \(bu 4
-\fBCLAUDE_ENV_FILE\fR: The environment file of \fIAnthropic Claude Code CLI\fR, receiving the exported session information.
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.IP \(bu 4
-\fBASE_TASK_ID\fR: The active task id of the session (default: \fBdefault\fR).
-.IP \(bu 4
-\fBASE_HEADLESS\fR: If \fBtrue\fR, the session runs headless, and no banner is emitted.
-.IP \(bu 4
-\fBASE_SETUP_DEV\fR: If set, the version hint notes a development setup.
-.IP \(bu 4
-\fBASE_PERSONA_STYLE\fR, \fBASE_GUIDANCE_LEVEL\fR, \fBASE_PROJECT_BOXING\fR, \fBASE_PROJECT_TASK_LIFECYCLE\fR, \fBASE_PROJECT_TASK_DEFAULT_SOURCE\fR, \fBASE_PROJECT_TASK_DEFAULT_CHANGESET\fR, \fBASE_PROJECT_TASK_DEFAULT_TARGET\fR: The fallbacks of the settings not explicitly configured.
-.IP \(bu 4
-\fBUSER\fR, \fBLOGNAME\fR: The user id.
-.IP \(bu 4
-\fBTMUX\fR, \fBTMUX_PANE\fR: The \fItmux\fR pane whose user option \fB@ase_agent_status\fR is set.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fIper-user state directory\fR\fB/session/\fR\fIid\fR\fB/state.yaml\fR: The internal session state, holding the active task id and the project directory of the session.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR on success, and with status \fB1\fR if the plugin root directory cannot be determined, a plugin file cannot be read, or \fB--tool\fR is invalid.
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-hook\fR(1), \fBase-hook-session-persona\fR(1), \fBase-hook-session-end\fR(1), \fBase-config\fR(1), \fBase-statusline\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-hook-stop.1

@@ -1,34 +0,0 @@
-.TH "ASE-HOOK-STOP" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-hook-stop\fR - Handle the Stop Hook Event
-.SH "SYNOPSIS"
-.P
-\fBase hook stop\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase hook stop\fR handles the \fBStop\fR hook event of \fIAnthropic Claude Code CLI\fR and \fIOpenAI Codex CLI\fR, resp. the \fBagentStop\fR hook event of \fIGitHub Copilot CLI\fR, which the agent tool fires when the agent finished responding. It is intended to be invoked by the agent tool internally as a configured hook handler only, and not directly by end users.
-.P
-The handler reads and discards the event payload on standard input and, when running inside a \fItmux\fR pane, sets the per-pane user option \fB@ase_agent_status\fR to \fB⏸\fR (ready), so a \fItmux\fR status line can render the live activity of the agent via \fB#{@ase_agent_status}\fR. It writes nothing to standard output.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: The agent tool which fires the event: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR. Default: \fB$ASE_TOOL\fR, else \fBclaude\fR.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBTMUX\fR, \fBTMUX_PANE\fR: The \fItmux\fR pane whose user option \fB@ase_agent_status\fR is set (only if both are set and non-empty).
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR, unless \fB--tool\fR is invalid (status \fB1\fR).
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-hook\fR(1), \fBase-hook-user-prompt-submit\fR(1), \fBtmux\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-hook-user-prompt-submit.1

@@ -1,34 +0,0 @@
-.TH "ASE-HOOK-USER-PROMPT-SUBMIT" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-hook-user-prompt-submit\fR - Handle the UserPromptSubmit Hook Event
-.SH "SYNOPSIS"
-.P
-\fBase hook user-prompt-submit\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase hook user-prompt-submit\fR handles the \fBUserPromptSubmit\fR hook event of \fIAnthropic Claude Code CLI\fR and \fIOpenAI Codex CLI\fR, resp. the \fBuserPromptSubmitted\fR hook event of \fIGitHub Copilot CLI\fR, which the agent tool fires when the user submits a prompt. It is intended to be invoked by the agent tool internally as a configured hook handler only, and not directly by end users.
-.P
-The handler reads and discards the event payload on standard input and, when running inside a \fItmux\fR pane, sets the per-pane user option \fB@ase_agent_status\fR to \fB▶\fR (busy), so a \fItmux\fR status line can render the live activity of the agent via \fB#{@ase_agent_status}\fR (independent of the statusline of the agent tool, which is not repainted during the agent processing). It writes nothing to standard output.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]: The agent tool which fires the event: \fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR. Default: \fB$ASE_TOOL\fR, else \fBclaude\fR.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBTMUX\fR, \fBTMUX_PANE\fR: The \fItmux\fR pane whose user option \fB@ase_agent_status\fR is set (only if both are set and non-empty).
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of \fB--tool\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR, unless \fB--tool\fR is invalid (status \fB1\fR).
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-hook\fR(1), \fBase-hook-stop\fR(1), \fBtmux\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-hook.1

@@ -1,51 +0,0 @@
-.TH "ASE-HOOK" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-hook\fR - Handle the Hook Events of the Agent Tool
-.SH "SYNOPSIS"
-.P
-\fBase hook\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.P
-\fBase hook\fR \fIevent\fR \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase hook\fR is the entry point group of the hook handlers which the \fIASE\fR plugin configures in the agent tool: in \fBhooks/hooks.json\fR for \fIAnthropic Claude Code CLI\fR, in \fBhooks/hooks-copilot.json\fR for \fIGitHub Copilot CLI\fR (with \fB--tool copilot\fR), and in \fBhooks/hooks-codex.json\fR for \fIOpenAI Codex CLI\fR (with \fB--tool codex\fR). The agent tool invokes a handler on the corresponding event, passes the event payload as a JSON object on standard input, and interprets the JSON object a handler optionally writes to standard output.
-.P
-The handlers are intended to be invoked by the agent tool internally only, and not directly by end users. Without a sub-command, the usage information is shown and the command exits with status \fB1\fR.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information, including the list of all event handlers, and exit.
-.RE 0
-.SH "COMMANDS"
-.P
-The following event handlers exist, each accepting the option \[lB]\fB-t\fR|\fB--tool\fR \fItool\fR\[rB] (\fBclaude\fR, \fBcopilot\fR, or \fBcodex\fR, default: \fB$ASE_TOOL\fR, else \fBclaude\fR) to select the agent tool whose payload format is read and written:
-.RS 0
-.IP \(bu 4
-\fBase hook session-start\fR: Handle the \fBSessionStart\fR (resp. \fBsessionStart\fR) event: inject the \fIASE\fR constitution and session information into the session context. See \fBase-hook-session-start\fR(1).
-.IP \(bu 4
-\fBase hook session-persona\fR: Handle the \fBSessionStart\fR (resp. \fBsessionStart\fR) event a second time: inject the \fIASE\fR persona rules into the session context. See \fBase-hook-session-persona\fR(1).
-.IP \(bu 4
-\fBase hook session-end\fR: Handle the \fBSessionEnd\fR (resp. \fBsessionEnd\fR) event: remove the session state and detach the session from its AI usage window. See \fBase-hook-session-end\fR(1).
-.IP \(bu 4
-\fBase hook pre-tool-use\fR: Handle the \fBPreToolUse\fR (resp. \fBpreToolUse\fR) event: auto-approve the invocations of \fIASE\fR tools. See \fBase-hook-pre-tool-use\fR(1).
-.IP \(bu 4
-\fBase hook permission-request\fR: Handle the \fBPermissionRequest\fR event of \fIOpenAI Codex CLI\fR: auto-approve the invocations of \fIASE\fR tools. See \fBase-hook-permission-request\fR(1).
-.IP \(bu 4
-\fBase hook user-prompt-submit\fR: Handle the \fBUserPromptSubmit\fR (resp. \fBuserPromptSubmitted\fR) event: mark the agent as busy. See \fBase-hook-user-prompt-submit\fR(1).
-.IP \(bu 4
-\fBase hook stop\fR: Handle the \fBStop\fR (resp. \fBagentStop\fR) event: mark the agent as ready. See \fBase-hook-stop\fR(1).
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TOOL\fR: The default of the \fB--tool\fR option of all event handlers. An invalid value is reported only once a handler actually runs.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Each event handler exits with status \fB0\fR on success, and with status \fB1\fR on an invalid \fB--tool\fR value or a fatal error. The group command without a sub-command exits with status \fB1\fR.
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-hook-session-start\fR(1), \fBase-hook-session-persona\fR(1), \fBase-hook-session-end\fR(1), \fBase-hook-pre-tool-use\fR(1), \fBase-hook-permission-request\fR(1), \fBase-hook-user-prompt-submit\fR(1), \fBase-hook-stop\fR(1), \fBase-setup\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-man.1

@@ -1,67 +0,0 @@
-.TH "ASE-MAN" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-man\fR - Show an internally shipped manual page
-.SH "SYNOPSIS"
-.P
-\fBase man\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-l\fR|\fB--list\fR\[rB] \[lB]\fB-p\fR|\fB--path\fR\[rB] \[lB]\fIpage\fR \[lB]...\[rB]\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase man\fR shows one of the Unix manual pages shipped internally with the \fBase\fR tool with \fBman\fR(1), independent of whether the manual pages are installed into the \fBMANPATH\fR of the system (as npm does only for a global installation of the \fB@rse/ase\fR package).
-.P
-The manual pages are rendered at build-time from Markdown into the Unix manual page format and shipped in the directory \fBdst/man/\fR of the tool package. There is one manual page per command and command group, named after the command path with dashes, e.g., \fBase-task\fR(1) for \fBase task\fR and \fBase-agent-fleet\fR(1) for \fBase agent fleet\fR. The commands of the third level (e.g. \fBase task store start\fR) are covered by the manual page of their group (e.g. \fBase-task-store\fR(1)).
-.P
-The manual page file is passed to \fBman\fR(1) by its path, so \fBman\fR(1) formats and pages it as usual (honoring \fBMANPAGER\fR, \fBPAGER\fR, and \fBMANWIDTH\fR).
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show program usage information only.
-.IP \(bu 4
-\[lB]\fB-l\fR|\fB--list\fR\[rB]: Instead of showing a manual page, list the names of all shipped manual pages, one per line, in natural order. Any \fIpage\fR is ignored.
-.IP \(bu 4
-\[lB]\fB-p\fR|\fB--path\fR\[rB]: Instead of showing the manual page, print the absolute path of its file, e.g., for passing it to another formatter.
-.RE 0
-.SH "ARGUMENTS"
-.RS 0
-.IP \(bu 4
-\[lB]\fIpage\fR \[lB]...\[rB]\[rB]: The manual page to show (default: \fBase\fR). It is given either by its name (e.g. \fBase-agent-fleet\fR) or by the words of the command path (e.g. \fBagent fleet\fR), which are joined with dashes, where the leading \fBase\fR is optional and the name is case-insensitive.
-.sp
-A command path deeper than the shipped manual pages (e.g. \fBtask store start\fR) falls back to the manual page of its nearest parent group (e.g. \fBase-task-store\fR), but never to the top-level page \fBase\fR(1). A \fIpage\fR consisting of anything other than letters, digits, and dashes is refused.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBMANPAGER\fR, \fBPAGER\fR, \fBMANWIDTH\fR: Honored by \fBman\fR(1) for paging and formatting the manual page.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fIpackage directory\fR\fB/dst/man/ase{,-\fR\fIcommand\fR\fB{,-\fR\fIsub-command\fR\fB}}.1\fR: The internally shipped manual pages.
-.RE 0
-.SH "EXIT STATUS"
-.P
-The exit status of \fBman\fR(1), resp. \fB0\fR for \fB--list\fR and \fB--path\fR. The command exits with status \fB1\fR if no manual page is found for \fIpage\fR, or if \fBman\fR(1) cannot be run at all (e.g. on a system without it, where the error message names the manual page file).
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# show the manual page of the "ase" command itself
-$ ase man
-
-# show the manual page of "ase agent fleet" (all equivalent)
-$ ase man ase-agent-fleet
-$ ase man agent-fleet
-$ ase man agent fleet
-
-# show the manual page covering "ase task store start"
-$ ase man task store start
-
-# list all shipped manual pages
-$ ase man --list
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBman\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-mcp.1

@@ -1,61 +0,0 @@
-.TH "ASE-MCP" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-mcp\fR - Bridge Stdio MCP to the Per-Project Service
-.SH "SYNOPSIS"
-.P
-\fBase mcp\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase mcp\fR is a Model-Context-Protocol (MCP) server speaking the stdio transport: it accepts MCP messages on standard input, forwards them to the per-project background service of \fBase-service\fR(1) via the Streamable HTTP transport (\fBhttp://127.0.0.1:\fR\fIport\fR\fB/mcp\fR), and writes the responses to standard output.
-.P
-It is configured as the stdio MCP server \fBase\fR of the \fIASE\fR plugin in the agent tool and is not intended to be invoked directly by end users. All log messages go to standard error (or to the file of the global \fB--log-file\fR option), as standard output carries the MCP protocol.
-.P
-On start, the service of the project is probed and auto-started (via \fBase service start\fR) if it is not running yet. The bridge then lives as long as its standard input is open, and is robust against a vanishing service:
-.RS 0
-.IP \(bu 4
-Messages arriving while no service connection exists are buffered (up to 100 messages, dropping the oldest ones on overflow) and sent once the connection is (re-)established.
-.IP \(bu 4
-On a lost or refused connection, the service is auto-started again and the connection is re-established, with a delay growing from 0.5 up to 10 seconds between the attempts.
-.IP \(bu 4
-Every 30 seconds, the service is probed, and a vanished service triggers the same reconnect.
-.RE 0
-.P
-Under \fIGitHub Copilot CLI\fR (detected by the environment variable \fBCOPILOT_PLUGIN_ROOT\fR), the MCP server is started in the plugin installation directory instead of the project. Hence, the bridge first answers all MCP messages in-process through the same set of MCP tools the service provides (covering the MCP handshake and the tool listing), holds back all tool calls, and waits until the \fBSessionStart\fR hook (see \fBase-hook\fR(1)) recorded the project directory of the session (with id \fBCOPILOT_AGENT_SESSION_ID\fR).
-.P
-It then switches into this directory, starts or connects the service of the project there, and forwards the held tool calls. If no project directory is recorded within 30 seconds of the first held tool call, it falls back to the current directory.
-.P
-The service provides the \fBase_*\fR MCP tools of the skills, e.g., \fBase_ping\fR, \fBase_config_get\fR, \fBase_config_set\fR, \fBase_config_delete\fR, \fBase_config_list\fR, \fBase_state_get\fR, \fBase_state_set\fR, \fBase_state_delete\fR, \fBase_kv_get\fR, \fBase_kv_set\fR, \fBase_kv_delete\fR, \fBase_kv_clear\fR, \fBase_kv_batch\fR, the \fBase_task_*\fR tools, \fBase_artifact_list\fR, \fBase_artifact_name\fR, \fBase_specbook_lint\fR, \fBase_specbook_export\fR, \fBase_diagram\fR, \fBase_worktree_path\fR, \fBase_mint\fR, \fBase_text_metric\fR, \fBase_getopt\fR, \fBase_markdown_prepare\fR, \fBase_timestamp\fR, \fBase_sleep\fR, \fBase_compat\fR, \fBase_component_info\fR, and \fBase_decision_matrix\fR.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.RE 0
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBCOPILOT_PLUGIN_ROOT\fR, \fBCOPILOT_AGENT_SESSION_ID\fR: Exported by \fIGitHub Copilot CLI\fR to its MCP servers. When both are set (and the session id matches \fB\[lB]A-Za-z0-9._-\[rB]+\fR), the service is deferred until the project directory of the session is known (see \fBDESCRIPTION\fR).
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB.ase/service.yaml\fR: The persisted port of the per-project service.
-.IP \(bu 4
-\fIper-user state directory\fR\fB/session/\fR\fIid\fR\fB/state.yaml\fR: The internal session state, from which the project directory (\fBbasedir\fR) recorded by the \fBSessionStart\fR hook is read under \fIGitHub Copilot CLI\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR once standard input is closed, \fB1\fR if the service cannot be started initially.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# register the bridge manually as an MCP server in Claude Code
-$ claude mcp add ase -- ase mcp
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-service\fR(1), \fBase-hook\fR(1), \fBase-setup\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-service-log.1

@@ -1,43 +0,0 @@
-.TH "ASE-SERVICE-LOG" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-service-log\fR - Show the Log of the Background Service
-.SH "SYNOPSIS"
-.P
-\fBase service log\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-f\fR|\fB--follow\fR\[rB] \[lB]\fB-n\fR|\fB--lines\fR \fIn\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase service log\fR shows the log file \fB.ase/service.log\fR of the per-project background service of \fIASE\fR (see \fBase-service\fR(1)) on standard output: by default the entire file, else its last lines only. If no log file exists, nothing is shown and the command exits with status \fB0\fR.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-f\fR|\fB--follow\fR\[rB]: After showing the last \fIn\fR lines (default: \fB10\fR), keep following the file in the style of \fBtail -f\fR and show all newly appended lines, until interrupted (e.g., via \fBCTRL+C\fR), even once the service has stopped. When the log is trimmed on a service start, following continues at the new end of the file.
-.IP \(bu 4
-\[lB]\fB-n\fR|\fB--lines\fR \fIn\fR\[rB]: Show the last \fIn\fR non-empty lines only, where \fIn\fR has to be a positive integer (default: all lines, or \fB10\fR with \fB--follow\fR).
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB.ase/service.log\fR: The log of the detached service.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR on success, \fB1\fR on an invalid \fIn\fR or an unreadable log file.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# show the last 50 log lines
-$ ase service log -n 50
-
-# follow the log
-$ ase service log -f
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-service\fR(1), \fBase-service-start\fR(1), \fBtail\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-service-send.1

@@ -1,47 +0,0 @@
-.TH "ASE-SERVICE-SEND" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-service-send\fR - Send a Command to the Background Service
-.SH "SYNOPSIS"
-.P
-\fBase service send\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \fIcmd\fR
-.SH "DESCRIPTION"
-.P
-\fBase service send\fR dispatches the command token \fIcmd\fR to the per-project background service of \fIASE\fR (see \fBase-service\fR(1)) via an HTTP \fBPOST /command\fR request with the JSON body \fB{ "command":\fR \fIcmd\fR \fB}\fR, and prints the raw response body (a JSON object) on standard output. If the service is not running, it is auto-started first (like \fBase service start\fR).
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.RE 0
-.SH "ARGUMENTS"
-.RS 0
-.IP \(bu 4
-\fIcmd\fR: The command token to dispatch. The service currently understands:
-.RS 4
-.IP \(bu 4
-\fBping\fR: Answer with \fB{"ok":true,"pong":true}\fR.
-.IP \(bu 4
-\fBstatus\fR: Answer with the service identity, i.e., \fBok\fR, the project id \fBprojectId\fR, the \fBport\fR, and the uptime \fBuptimeMs\fR in milliseconds.
-.RE 0
-.IP "" 4
-Any other token is answered with an \fBunknown command\fR error (HTTP status \fB400\fR).
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR if the service answered with a success status, \fB1\fR if it answered with an error status (e.g., for an unknown \fIcmd\fR), or if it could not be started or reached.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-$ ase service send ping
-{"ok":true,"pong":true}
-
-$ ase service send status
-{"ok":true,"projectId":"ase","port":42817,"uptimeMs":723456}
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-service\fR(1), \fBase-service-status\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-service-start.1

@@ -1,54 +0,0 @@
-.TH "ASE-SERVICE-START" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-service-start\fR - Start the Per-Project Background Service
-.SH "SYNOPSIS"
-.P
-\fBase service start\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-f\fR|\fB--foreground\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase service start\fR starts the per-project background HTTP service of \fIASE\fR (see \fBase-service\fR(1)) for the project of the current working directory.
-.P
-If a service of this project already answers on the port persisted in \fB.ase/service.yaml\fR, the command just reports \fBservice: already running
-on port\fR \fIport\fR and exits with status \fB0\fR. Otherwise, it allocates the preferred port \fBproject.service.port\fR (see \fBase-config\fR(1)), if configured and free, else (with a warning, if configured) a fresh random free port out of the range \fB42000\fR..\fB44000\fR (trying up to 20 candidates), spawns the service as a detached background process (with its standard output and standard error appended to \fB.ase/service.log\fR, trimmed to its last 2000 lines beforehand if larger than 1 MB), and probes its readiness for up to 5 seconds.
-.P
-Once ready, the service persists its port into \fB.ase/service.yaml\fR, and the command reports \fBservice: started on port\fR \fIport\fR. If the spawned service exits during its startup, does not become ready in time, or loses its port to a foreign listener, the attempt is aborted (killing the process) and retried with a new port, up to three attempts in total, after which the command fails with the reason and the last 20 lines of the log.
-.P
-The detached service adopts the log level of the global \fB--log-level\fR option of this command, e.g., \fBase --log-level debug service start\fR logs the full MCP traffic. It stops itself after 30 minutes without any request (but never while a request is in flight or while it holds open AI usage windows), on \fBase service stop\fR, and removes its port from \fB.ase/service.yaml\fR again.
-.P
-Usually, the service does not have to be started explicitly, as the MCP bridge \fBase mcp\fR, \fBase service send\fR, and the hooks start it on demand.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.IP \(bu 4
-\[lB]\fB-f\fR|\fB--foreground\fR\[rB]: Run the service in the current process instead, on a port allocated as above, logging to the terminal (resp. the global \fB--log-file\fR) instead of \fB.ase/service.log\fR and without the idle timeout, until it is interrupted (via \fBSIGINT\fR, e.g., \fBCTRL+C\fR, \fBSIGTERM\fR, \fBSIGHUP\fR, or \fBSIGQUIT\fR) or stopped via \fBase service stop\fR. A service of this project already running is an error in this mode.
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB.ase/service.yaml\fR: The persisted port of the running service.
-.IP \(bu 4
-\fB.ase/service.log\fR: The log of the detached service.
-.IP \(bu 4
-\fB.ase/.gitignore\fR: The self-ignoring Git ignore file covering the machine-local runtime files, created if missing.
-.RE 0
-.SH "EXIT STATUS"
-.P
-\fB0\fR if the service was started or is already running (resp., in the foreground, once it was stopped), \fB1\fR if it could not be started, or, with \fB--foreground\fR, if it is already running.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# start the service in the background
-$ ase service start
-
-# run the service in the foreground for debugging
-$ ase --log-level debug service start --foreground
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-service\fR(1), \fBase-service-status\fR(1), \fBase-service-stop\fR(1), \fBase-service-log\fR(1), \fBase-config\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR