@rse/ase 2.0.3 → 2.0.5

package/dst/man/ase-task.1

@@ -1,160 +0,0 @@
-.TH "ASE-TASK" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-task\fR - Manage Persisted Task Plans
-.SH "SYNOPSIS"
-.P
-\fBase task\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \fIcommand\fR \[lB]\fIoptions\fR \[lB]...\[rB]\[rB] \[lB]\fIargs\fR \[lB]...\[rB]\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase task\fR manages the persisted \fItask plans\fR of the current project. A task plan is a Markdown document in the textual \fIASE\fR task format (see \fBase util meta format-task\fR): a frontmatter block with the keys \fBType\fR, \fBId\fR, \fBCreated\fR, \fBModified\fR, \fBGroup\fR, \fBPhase\fR, \fBAfter\fR, \fBStatus\fR, \fBAssignee\fR, \fBKind\fR, \fBEffort\fR, \fBTags\fR, \fBSource\fR, \fBChangeset\fR, and \fBTarget\fR, followed by the plan body and optional attachment blocks.
-.P
-The optional \fBEffort\fR key carries the estimated effort of the task as \fIsize\fR \fIhash\fR, with \fIsize\fR one of the T-shirt sizes \fBXS\fR, \fBS\fR, \fBM\fR, \fBL\fR, or \fBXL\fR (see \fBproject.task.effort.scale\fR in \fBase-config\fR(1)) and \fIhash\fR the content hash of the plan body the size was given for. The task store drops a \fIstale\fR \fBEffort\fR (whose \fIhash\fR no longer matches the body, ignoring checkboxes, whitespace, and cancelled or deferred bullet-points) on load and save, and stamps an \fBEffort\fR given without \fIhash\fR with the content hash of the body on save.
-.P
-All commands are forwarded to the \fItask store\fR selected by the \fBproject.task.store.url\fR configuration (see \fBTASK STORES\fR below). The project is identified in the task store by \fBproject.id\fR (default: the sanitized basename of the project root, i.e., the Git top-level directory, or the current working directory outside a Git working tree).
-.P
-The \fBStatus\fR of the task plans follows the \fItask lifecycle model\fR of the project (see \fBTASK LIFECYCLE MODELS\fR below), and new task ids are generated after the \fItask id scheme\fR of the project (see \fBTASK ID SCHEMES\fR below).
-.P
-Without a \fIcommand\fR, 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 of \fBase task\fR, including the list of all sub-commands, and exit.
-.RE 0
-.SH "COMMANDS"
-.RS 0
-.IP \(bu 4
-\fBase task list\fR \[lB]\fB-v\fR|\fB--verbose\fR\[rB] \[lB]\fB-i\fR|\fB--include\fR \fIstates\fR\[rB] \[lB]\fB-e\fR|\fB--exclude\fR \fIstates\fR\[rB]: List the persisted task ids. See \fBase-task-list\fR(1).
-.IP \(bu 4
-\fBase task status\fR \[lB]\fIid\fR\[lB]\fB:\fR\[rB]\[rB] \[lB]\fIstatus\fR\[rB]: Get or set the lifecycle status of a task. See \fBase-task-status\fR(1).
-.IP \(bu 4
-\fBase task request\fR \fIid\fR \fIname\fR \[lB]\fIprompt\fR ...\[rB]: Request the processing of a task by a prompt. See \fBase-task-request\fR(1).
-.IP \(bu 4
-\fBase task assign\fR \[lB]\fB-s\fR|\fB--session\fR \fIid\fR\[rB] \[lB]\fIid\fR\[lB]\fB:\fR\[rB]\[rB] \fIassignee\fR: Assign a task (and handle the AI usage window of a session). See \fBase-task-assign\fR(1).
-.IP \(bu 4
-\fBase task load\fR \fIid\fR: Write a task plan to standard output. See \fBase-task-load\fR(1).
-.IP \(bu 4
-\fBase task view\fR \fIid\fR: Show a task plan in the pager. See \fBase-task-view\fR(1).
-.IP \(bu 4
-\fBase task edit\fR \fIid\fR: Edit a task plan in the editor. See \fBase-task-edit\fR(1).
-.IP \(bu 4
-\fBase task save\fR \[lB]\fB-c\fR|\fB--create\fR\[rB] \fIid\fR: Save a task plan read from standard input. See \fBase-task-save\fR(1).
-.IP \(bu 4
-\fBase task delete\fR \fIid\fR: Delete a task plan. See \fBase-task-delete\fR(1).
-.IP \(bu 4
-\fBase task rename\fR \fIold-id\fR \fInew-id\fR: Rename a task plan and its references. See \fBase-task-rename\fR(1).
-.IP \(bu 4
-\fBase task newid\fR \[lB]\fB-p\fR|\fB--proposal\fR \fIid\fR\[rB] \[lB]\fB-t\fR|\fB--taken\fR \fIids\fR\[rB] \[lB]\fB-v\fR|\fB--verbose\fR\[rB] \[lB]\fItitle\fR\[rB]: Print the next free task id. See \fBase-task-newid\fR(1).
-.IP \(bu 4
-\fBase task purge\fR \[lB]\fIage\fR\[rB]: Remove all task plans older than an age. See \fBase-task-purge\fR(1).
-.IP \(bu 4
-\fBase task lifecycle\fR \[lB]\fIname\fR\[rB]: Get or set the task lifecycle model of the project. See \fBase-task-lifecycle\fR(1).
-.IP \(bu 4
-\fBase task idscheme\fR \[lB]\fIscheme\fR\[rB]: Get or set the task id scheme of the project. See \fBase-task-idscheme\fR(1).
-.IP \(bu 4
-\fBase task store\fR \fIcommand\fR \[lB]...\[rB]: Manage the per-user task store REST API server. See \fBase-task-store\fR(1).
-.IP \(bu 4
-\fBase task board\fR \[lB]\fIoptions\fR\[rB]: Show the interactive task board in the terminal or the browser. See \fBase-task-board\fR(1).
-.RE 0
-.SH "TASK IDS"
-.P
-A task id consists of the characters \fBA-Z\fR, \fBa-z\fR, \fB0-9\fR, \fB#\fR, \fB_\fR, and \fB-\fR, where it has to start with a letter, a digit, or \fB#\fR, i.e., it has to match \fB\[lB]A-Za-z0-9#\[rB]\[lB]A-Za-z0-9#_-\[rB]*\fR. The id \fBdefault\fR is the reserved id of the default task of a session. As \fB#\fR starts a comment in the shell, an id containing \fB#\fR has to be quoted on the command line, e.g., \fBase task view "#7"\fR.
-.SH "TASK STORES"
-.P
-The task store is selected by the \fBproject.task.store.url\fR configuration URL (see \fBase-config\fR(1)):
-.RS 0
-.IP \(bu 4
-\fBase:\fR\fIpath\fR: The built-in file-based storage plugin, running in-process, storing each plan as a file \fBTASK-\fR\fIid\fR\fB.md\fR directly in the directory \fIpath\fR, which is resolved relative to the project root (default: \fBase:./.ase/task\fR).
-.sp
-On the \fBproject\fR and \fBtask:\fR\fIid\fR scopes, \fIpath\fR must not escape the project root (also not through symbolic links), as a cloned repository could otherwise direct task writes anywhere; a directory outside of it is accepted on the \fBuser\fR or \fBsession\fR scope only. The lifecycle model and task id scheme of a local task store always follow \fBproject.task.lifecycle\fR and \fBproject.task.idscheme\fR.
-.IP \(bu 4
-\fBase://\fR\fIaddr\fR\fB:\fR\fIport\fR\[lB]\fB/\fR\fItoken\fR\[rB]: A remote task store server (see \fBase-task-store\fR(1)), connected via HTTP. It requires an explicitly configured \fBproject.id\fR, as a basename-derived one likely collides on a shared server.
-.sp
-On first use, the project is registered in the task store under the configured \fBproject.task.lifecycle\fR and \fBproject.task.idscheme\fR; afterwards the registered model and scheme apply to all clients of the project, and a deviating configuration is warned about once per deviation only (see \fBase-task-lifecycle\fR(1)).
-.sp
-The bearer token is the embedded \fItoken\fR (warned about if the URL is configured on the \fBproject\fR or a \fBtask:\fR\fIid\fR scope, as it might be committed), else \fB$ASE_TASK_STORE_TOKEN\fR, else \fBproject.task.store.token\fR (warned about if not configured on the \fBuser\fR scope), else the \fBtoken\fR of the per-user \fBstore.yaml\fR of a locally started task store server (only if the URL addresses exactly this server). Sending a token to a non-loopback host selected on the \fBproject\fR or a \fBtask:\fR\fIid\fR scope is warned about.
-.IP \(bu 4
-\fBases://\fR\fIaddr\fR\fB:\fR\fIport\fR\[lB]\fB/\fR\fItoken\fR\[rB]\[lB]\fB?insecure\fR\[rB]: The same as \fBase://\fR, but connecting via HTTPS, verifying the server certificate against the Node.js CA store (extendable via \fB$NODE_EXTRA_CA_CERTS\fR). With the suffix \fB?insecure\fR, the verification of the server certificate is skipped.
-.IP \(bu 4
-\fBgithub:\fR\fIowner\fR\fB/\fR\fIrepo\fR, \fBgithub+https://\fR\fIhost\fR\fB/\fR\fIowner\fR\fB/\fR\fIrepo\fR, or \fBgithub+http://\fR\fIhost\fR\fB/\fR\fIowner\fR\fB/\fR\fIrepo\fR: The built-in GitHub storage plugin, running in-process, storing the plans as the issues of the repository \fIowner\fR\fB/\fR\fIrepo\fR on GitHub resp. on the GitHub (Enterprise) instance \fIhost\fR. It requires a \fBseq\fR task id scheme (e.g., \fBseq:#%d\fR), as the task ids are the issue numbers. The GitHub token is \fBproject.task.store.token\fR, else \fB$GITHUB_TOKEN\fR, else \fB$GH_TOKEN\fR.
-.IP \(bu 4
-\fBgitlab:\fR\fInamespace\fR\fB/\fR\fIproject\fR, \fBgitlab://\fR\fIhost\fR\fB/\fR\fInamespace\fR\fB/\fR\fIproject\fR, \fBgitlab+https://\fR\fIhost\fR\fB/\fR\fInamespace\fR\fB/\fR\fIproject\fR, or \fBgitlab+http://\fR\fIhost\fR\fB/\fR\fInamespace\fR\fB/\fR\fIproject\fR: The built-in GitLab storage plugin, running in-process, storing the plans as the issues of the GitLab project \fInamespace\fR\fB/\fR\fIproject\fR (with nested groups allowed) on the GitLab instance \fIhost\fR, else \fB$GITLAB_HOST\fR, else \fBgitlab.com\fR. It also requires a \fBseq\fR task id scheme. The GitLab token is \fBproject.task.store.token\fR, else \fB$GITLAB_TOKEN\fR.
-.IP \(bu 4
-\fBgitea+https://\fR\fIhost\fR\fB/\fR\fIowner\fR\fB/\fR\fIrepo\fR or \fBgitea+http://\fR\fIhost\fR\fB/\fR\fIowner\fR\fB/\fR\fIrepo\fR: The built-in Gitea storage plugin, running in-process, storing the plans as the issues of the repository \fIowner\fR\fB/\fR\fIrepo\fR on the Gitea instance \fIhost\fR. It also requires a \fBseq\fR task id scheme. The Gitea token is \fBproject.task.store.token\fR, else \fB$GITEA_TOKEN\fR.
-.RE 0
-.P
-For the GitHub, GitLab, and Gitea task stores, a repository selected on the \fBproject\fR or a \fBtask:\fR\fIid\fR scope is warned about once per project and repository only (remembered in the \fIper-user state directory\fR as \fBtask-github.json\fR, \fBtask-gitlab.json\fR, resp. \fBtask-gitea.json\fR), and a \fBproject.task.store.token\fR not configured on the \fBuser\fR scope is warned about.
-.SH "TASK LIFECYCLE MODELS"
-.P
-The \fBStatus\fR frontmatter key of a task plan holds a state of the task lifecycle model of the project, selected by \fBproject.task.lifecycle\fR for a local task store resp. registered in a remote task store (see \fBase-task-lifecycle\fR(1)). A plan without a \fBStatus\fR key reads as the \fIinitial\fR state of the model.
-.P
-A status change has to be reachable from the current state via one or more transitions of the model (a status foreign to the model can be changed to any state, to allow its correction). The \fIfinished\fR states end the lifecycle, and in the \fIactivity\fR states a task is actively worked on (by a human or an agent), so its plan must not be changed concurrently.
-.RS 0
-.IP \(bu 4
-\fBsolo\fR: The single-phase lifecycle for a local solo developer (default). States: \fBOPEN\fR (initial), \fBSHELVED\fR, \fBCLOSED\fR (finished), and \fBCANCELLED\fR (finished); no activity states. Transitions: \fBOPEN\fR to \fBSHELVED\fR, \fBCLOSED\fR, or \fBCANCELLED\fR; \fBSHELVED\fR to \fBOPEN\fR or \fBCANCELLED\fR.
-.IP \(bu 4
-\fBteam\fR: The two-phase lifecycle for a distributed small team. States: \fBPLANNING\fR (initial), \fBSHELVED\fR, \fBIMPLEMENTING\fR (activity), \fBSTALLED\fR, \fBIMPLEMENTED\fR (finished), and \fBCANCELLED\fR (finished). Transitions: \fBPLANNING\fR to \fBSHELVED\fR, \fBIMPLEMENTING\fR, or \fBCANCELLED\fR; \fBSHELVED\fR to \fBPLANNING\fR or \fBCANCELLED\fR; \fBIMPLEMENTING\fR to \fBPLANNING\fR, \fBSTALLED\fR, \fBIMPLEMENTED\fR, or \fBCANCELLED\fR; \fBSTALLED\fR to \fBIMPLEMENTING\fR or \fBCANCELLED\fR.
-.IP \(bu 4
-\fBenterprise\fR: The four-phase lifecycle (planning, implementation, qualification, and integration) for a gated enterprise pipeline, driven headless by the agents of \fBase-agent\fR(1). States: \fBDRAFTED\fR (initial), \fBSHELVED\fR, \fBPLANNING\fR (activity), \fBPLANNED\fR, \fBSTALLED\fR, \fBIMPLEMENTING\fR (activity), \fBIMPLEMENTED\fR, \fBDECLINED\fR, \fBQUALIFYING\fR (activity), \fBQUALIFIED\fR, \fBDEFERRED\fR, \fBINTEGRATING\fR (activity), \fBINTEGRATED\fR (finished), and \fBCANCELLED\fR (finished).
-.sp
-Transitions: \fBDRAFTED\fR to \fBSHELVED\fR, \fBPLANNING\fR, or \fBCANCELLED\fR; \fBSHELVED\fR to \fBDRAFTED\fR or \fBCANCELLED\fR; \fBPLANNING\fR to \fBDRAFTED\fR, \fBSHELVED\fR, \fBPLANNED\fR, or \fBCANCELLED\fR; \fBPLANNED\fR to \fBSTALLED\fR, \fBIMPLEMENTING\fR, or \fBCANCELLED\fR; \fBSTALLED\fR to \fBPLANNED\fR or \fBCANCELLED\fR; \fBIMPLEMENTING\fR to \fBDRAFTED\fR, \fBPLANNED\fR, \fBSTALLED\fR, \fBIMPLEMENTED\fR, or \fBCANCELLED\fR; \fBIMPLEMENTED\fR to \fBDECLINED\fR, \fBQUALIFYING\fR, or \fBCANCELLED\fR; \fBDECLINED\fR to \fBIMPLEMENTED\fR or \fBCANCELLED\fR; \fBQUALIFYING\fR to \fBDRAFTED\fR, \fBPLANNED\fR, \fBIMPLEMENTED\fR, \fBDECLINED\fR, \fBQUALIFIED\fR, or \fBCANCELLED\fR; \fBQUALIFIED\fR to \fBDEFERRED\fR, \fBINTEGRATING\fR, or \fBCANCELLED\fR; \fBDEFERRED\fR to \fBQUALIFIED\fR or \fBCANCELLED\fR; \fBINTEGRATING\fR to \fBDRAFTED\fR, \fBPLANNED\fR, \fBQUALIFIED\fR, \fBDEFERRED\fR, \fBINTEGRATED\fR, or \fBCANCELLED\fR.
-.RE 0
-.P
-In all models, no transition leaves a finished state.
-.SH "TASK ID SCHEMES"
-.P
-New task ids are generated by \fBase-task-newid\fR(1) after the task id scheme of the project, selected by \fBproject.task.idscheme\fR for a local task store resp. registered in a remote task store (see \fBase-task-idscheme\fR(1)):
-.RS 0
-.IP \(bu 4
-\fBslug\fR\[lB]\fB:\fR\fIwords\fR\[rB]: The slug of the first \fIwords\fR (\fB1\fR-\fB16\fR, default: \fB2\fR) words of the task title, starting with the first word beginning with a letter, with diacritics stripped, lower-cased, and joined with \fB-\fR, e.g., \fBjson-export\fR (default scheme). Conforming ids match \fB^\[lB]a-z\[rB]\[lB]a-z0-9\[rB]*(?:-\[lB]a-z0-9\[rB]+){0,\fR\fIwords-1\fR\fB}(?:-\[lB]0-9\[rB]+)?$\fR.
-.IP \(bu 4
-\fBseq\fR\[lB]\fB:\fR\fItemplate\fR\[rB]: A continuously increasing sequence number, rendered through the sprintf-style \fItemplate\fR (default: \fB%d\fR) with exactly one \fB%d\fR or \fB%0\fR\fIwidth\fR\fBd\fR (\fIwidth\fR \fB0\fR-\fB16\fR) and otherwise only the characters \fBA-Z\fR, \fBa-z\fR, \fB#\fR, \fB_\fR, and \fB-\fR (but not starting with \fB_\fR or \fB-\fR), e.g., \fBFOO-%03d\fR (\fBFOO-007\fR) or \fB#%d\fR (\fB#7\fR). Conforming ids match \fIprefix\fR\fB(\[lB]0-9\[rB]+)\fR\fIsuffix\fR (resp. with at least \fIwidth\fR digits).
-.IP \(bu 4
-\fBany\fR: An arbitrary id, as proposed by the caller. Conforming ids match \fB^\[lB]A-Za-z0-9#\[rB]\[lB]A-Za-z0-9#_-\[rB]*$\fR.
-.RE 0
-.P
-An id not conforming to the scheme is accepted, but warned about on \fBase task save\fR, \fBase task edit\fR, and \fBase task rename\fR (the reserved id \fBdefault\fR always conforms).
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TASK_ID\fR: The default task id of \fBase task status\fR and \fBase task assign\fR (default: \fBdefault\fR).
-.IP \(bu 4
-\fBASE_TASK_STORE_TOKEN\fR: The bearer token of a remote (\fBase://\fR or \fBases://\fR) task store.
-.IP \(bu 4
-\fBGITHUB_TOKEN\fR, \fBGH_TOKEN\fR, \fBGITLAB_TOKEN\fR, \fBGITLAB_HOST\fR, \fBGITEA_TOKEN\fR: The tokens resp. the default host of the GitHub, GitLab, and Gitea task stores (see \fBTASK STORES\fR).
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB.ase/task/TASK-\fR\fIid\fR\fB.md\fR: The persisted task plans of the default local task store \fBase:./.ase/task\fR, relative to the project root.
-.IP \(bu 4
-\fB.ase/config.yaml\fR: The \fBproject\fR scope configuration with the \fBproject.id\fR, \fBproject.task.store.url\fR, \fBproject.task.lifecycle\fR, and \fBproject.task.idscheme\fR keys.
-.IP \(bu 4
-\fIper-user state directory\fR\fB/task-lifecycle.json\fR: The deviations of the configured lifecycle model and task id scheme from the ones of a remote task store already warned about.
-.IP \(bu 4
-\fIper-user state directory\fR\fB/task-github.json\fR, \fBtask-gitlab.json\fR, \fBtask-gitea.json\fR: The repositories of the issue tracker task stores already warned about.
-.RE 0
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# list all unfinished tasks with their status, time, effort, and title
-$ ase task list -v
-
-# create a new task from a title and a plan file
-$ id=$(ase task newid "Export as JSON")
-$ ase task save --create "$id" <plan.md
-
-# move the task forward in the lifecycle
-$ ase task status "$id" CLOSED
-
-# use a shared remote task store
-$ ase config --scope project set project.id myproject
-$ ase config --scope project set project.task.store.url ase://127.0.0.1:4711
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-task-list\fR(1), \fBase-task-status\fR(1), \fBase-task-request\fR(1), \fBase-task-assign\fR(1), \fBase-task-load\fR(1), \fBase-task-view\fR(1), \fBase-task-edit\fR(1), \fBase-task-save\fR(1), \fBase-task-delete\fR(1), \fBase-task-rename\fR(1), \fBase-task-newid\fR(1), \fBase-task-purge\fR(1), \fBase-task-lifecycle\fR(1), \fBase-task-idscheme\fR(1), \fBase-task-store\fR(1), \fBase-task-board\fR(1), \fBase-config\fR(1), \fBase-agent\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-util-compat.1

@@ -1,25 +0,0 @@
-.TH "ASE-UTIL-COMPAT" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-util-compat\fR - Output Expected Probe Values of the Compatibility Self-Test
-.SH "SYNOPSIS"
-.P
-\fBase util compat\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase util compat\fR writes the canonical expected values of all probes of the \fBase-meta-compat\fR self-test skill to standard output, one probe per line as \fIid\fR\fB: \fR\fIvalue\fR, where \fIid\fR is \fIcategory\fR\fB/\fR\fIprobe-name\fR. The probe categories are \fBxml-placeholders\fR, \fBcontrol-flow\fR, \fBregex\fR, and \fBarithmetic\fR, which check whether the model of the agent tool correctly interprets the pseudo-code constructs the \fIASE\fR skills are written in.
-.P
-This command is intended to be invoked by the skill only after it has recorded all actual probe results (so the model cannot see the expected values beforehand), and not directly by end users. The MCP tool \fBase_compat\fR provides the same.
-.SH "OPTIONS"
-.RS 0
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR.
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-util\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-util-diagram.1

@@ -1,76 +0,0 @@
-.TH "ASE-UTIL-DIAGRAM" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-util-diagram\fR - Render Mermaid or D2 Diagrams as Unicode/ASCII Art or SVG
-.SH "SYNOPSIS"
-.P
-\fBase util diagram\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-i\fR|\fB--input\fR \fIfile\fR\[rB] \[lB]\fB-l\fR|\fB--lang\fR \fBmermaid\fR|\fBd2\fR\[rB] \[lB]\fB-f\fR|\fB--format\fR \fBascii\fR|\fBsvg\fR\[rB] \[lB]\fB-a\fR|\fB--ascii\fR\[rB] \[lB]\fB-c\fR|\fB--color-mode\fR \fBnone\fR|\fBansi16\fR|\fBansi256\fR\[rB] \[lB]\fB--node-margin-x\fR \fIn\fR\[rB] \[lB]\fB--node-margin-y\fR \fIn\fR\[rB] \[lB]\fB--node-padding\fR \fIn\fR\[rB] \[lB]\fB--diagram-clip-x\fR \fIn\fR\[rB] \[lB]\fB--diagram-clip-y\fR \fIn\fR\[rB] \[lB]\fB--terminal-width\fR \fIn\fR\[rB] \[lB]\fB--terminal-height\fR \fIn\fR\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase util diagram\fR renders a diagram specification, written in the \fIMermaid\fR or \fID2\fR diagram language and read from standard input or a file, as Unicode box-drawing (or plain ASCII) art for the terminal, or as a self-contained SVG document. The \fIMermaid\fR diagrams are rendered via \fIbeautiful-mermaid\fR (supporting, e.g., flowcharts, UML state, sequence, and class diagrams, ER diagrams, and XY-charts), and the \fID2\fR diagrams via the WebAssembly build of \fID2\fR.
-.P
-For the \fBascii\fR format, the rendering is optionally clipped to the terminal dimensions (reduced by the extra clipping amounts): lines wider than the width budget are truncated (preserving and properly terminating any ANSI color sequences), and lines beyond the height budget are dropped.
-.P
-A clipped rendering is followed by a warning paragraph which states the overflow and advises how to regenerate the diagram source to fit (e.g., by preferring a portrait orientation, reducing siblings per row, abbreviating node labels, or nesting). The output always ends with a newline.
-.P
-The MCP tool \fBase_diagram\fR provides the same to the skills.
-.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-i\fR|\fB--input\fR \fIfile\fR\[rB]: Read the diagram specification from \fIfile\fR instead of standard input. An empty (or whitespace-only) specification is an error.
-.IP \(bu 4
-\[lB]\fB-l\fR|\fB--lang\fR \fBmermaid\fR|\fBd2\fR\[rB]: The diagram language: \fBmermaid\fR for \fIMermaid\fR (default) or \fBd2\fR for \fID2\fR.
-.IP \(bu 4
-\[lB]\fB-f\fR|\fB--format\fR \fBascii\fR|\fBsvg\fR\[rB]: The output format: \fBascii\fR for Unicode/ASCII art (default) or \fBsvg\fR for an SVG document. The clipping options apply to \fBascii\fR only.
-.IP \(bu 4
-\[lB]\fB-a\fR|\fB--ascii\fR\[rB]: Emit plain ASCII characters (\fB+\fR, \fB-\fR, \fB|\fR) instead of the Unicode box-drawing characters (for both languages).
-.IP \(bu 4
-\[lB]\fB-c\fR|\fB--color-mode\fR \fBnone\fR|\fBansi16\fR|\fBansi256\fR\[rB]: The color mode of the ANSI escape sequences in the rendered art (\fIMermaid\fR and \fBascii\fR only): \fBnone\fR for no colors, \fBansi16\fR for 16 colors, or \fBansi256\fR for 256 colors, where colors render the diagram in gray shades. Default: \fB$ASE_TERM_COLORS\fR if set to one of these values, else derived from the color depth of standard output if it is a terminal (\fBansi256\fR for at least 8 bits, \fBansi16\fR for at least 4 bits), else \fBnone\fR.
-.IP \(bu 4
-\[lB]\fB--node-margin-x\fR \fIn\fR\[rB]: The horizontal margin between nodes in characters (\fIMermaid\fR only, default: \fB3\fR).
-.IP \(bu 4
-\[lB]\fB--node-margin-y\fR \fIn\fR\[rB]: The vertical margin between nodes in lines (\fIMermaid\fR only, default: \fB3\fR).
-.IP \(bu 4
-\[lB]\fB--node-padding\fR \fIn\fR\[rB]: The horizontal and vertical inner padding of each node in characters (\fIMermaid\fR only, default: \fB1\fR).
-.IP \(bu 4
-\[lB]\fB--diagram-clip-x\fR \fIn\fR\[rB]: The extra horizontal clipping: the width budget is the terminal width minus \fIn\fR characters (default: \fB0\fR).
-.IP \(bu 4
-\[lB]\fB--diagram-clip-y\fR \fIn\fR\[rB]: The extra vertical clipping: the height budget is the terminal height minus \fIn\fR lines (default: \fB0\fR).
-.IP \(bu 4
-\[lB]\fB--terminal-width\fR \fIn\fR\[rB]: The terminal width in characters for the clipping, where \fB0\fR disables the horizontal clipping. Default: \fB$ASE_TERM_WIDTH\fR if a positive integer, else the width of standard output if it is a terminal, else \fB0\fR.
-.IP \(bu 4
-\[lB]\fB--terminal-height\fR \fIn\fR\[rB]: The terminal height in lines for the clipping, where \fB0\fR disables the vertical clipping. Default: \fB$ASE_TERM_HEIGHT\fR if a positive integer, else the height of standard output if it is a terminal, else \fB0\fR.
-.RE 0
-.P
-All numeric values \fIn\fR have to be non-negative integers.
-.SH "ENVIRONMENT"
-.RS 0
-.IP \(bu 4
-\fBASE_TERM_COLORS\fR: The default of \fB--color-mode\fR (\fBnone\fR, \fBansi16\fR, or \fBansi256\fR).
-.IP \(bu 4
-\fBASE_TERM_WIDTH\fR, \fBASE_TERM_HEIGHT\fR: The defaults of \fB--terminal-width\fR and \fB--terminal-height\fR.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR on success, and with status \fB1\fR on an invalid option value, an unreadable input file, an empty specification, or a rendering failure (e.g., a syntax error in the specification).
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# render a Mermaid flowchart as Unicode art
-$ printf 'flowchart LR\[rs]n    A --> B --> C\[rs]n' | ase util diagram
-
-# render a D2 diagram from a file as plain ASCII art without colors
-$ ase util diagram -l d2 -i arch.d2 -a -c none
-
-# render a Mermaid diagram as an SVG document
-$ ase util diagram -i flow.mmd -f svg >flow.svg
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-util\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-util-meta.1

@@ -1,45 +0,0 @@
-.TH "ASE-UTIL-META" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-util-meta\fR - Output Plugin Meta Files
-.SH "SYNOPSIS"
-.P
-\fBase util meta\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \fIname\fR \[lB]...\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase util meta\fR writes the contents of one or more \fImeta files\fR of the \fIASE\fR plugin to standard output, concatenated in the given order and without any separator.
-.P
-The meta files are the shared instructions and format conventions of the \fIASE\fR skills, e.g., the constitution (\fBase-constitution.md\fR), the tenets (\fBase-tenets.md\fR), the persona (\fBase-persona.md\fR), the dialog conventions (\fBase-dialog.md\fR), the option parsing conventions (\fBase-getopt.md\fR), and the artifact format conventions (\fBase-format-*.md\fR, plus the standard \fISpecBook\fR schema configuration \fBase-format-specbook.yaml\fR).
-.P
-The meta files are read from the \fBplugin/meta/\fR directory bundled with the tool package itself, independent of any environment variables. All requested files are read before any output is written, so a failing name produces no output at all.
-.P
-This command is intended to be leveraged by the \fIASE\fR skills, and not typically invoked directly by end users.
-.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
-\fIname\fR \[lB]...\[rB]: One or more meta file names. Each \fIname\fR is reduced to its base name (so no directory traversal or absolute path is possible), the extension \fB.md\fR is appended if it has no extension, and the prefix \fBase-\fR is prepended if missing, so \fBtenets\fR, \fBase-tenets\fR, and \fBtenets.md\fR all select \fBase-tenets.md\fR, while \fBformat-specbook.yaml\fR selects \fBase-format-specbook.yaml\fR. An empty name, \fB.\fR, and \fB..\fR are invalid.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR on success, and with status \fB1\fR if a name is invalid or a meta file cannot be read.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# output the ASE constitution
-$ ase util meta constitution
-
-# output the tenets and the persona definition
-$ ase util meta tenets persona
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-util\fR(1), \fBase-spec\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-util-metric.1

@@ -1,54 +0,0 @@
-.TH "ASE-UTIL-METRIC" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-util-metric\fR - Measure the Length Metrics of a Text
-.SH "SYNOPSIS"
-.P
-\fBase util metric\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-f\fR|\fB--file\fR \fIfile\fR\[rB] \[lB]\fItext\fR \[lB]...\[rB]\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase util metric\fR measures the length metrics of a text, given either as the content of a \fIfile\fR or as the \fItext\fR formed by the remaining arguments (joined by single spaces), which are mutually exclusive and of which exactly one has to be given. The metrics are printed to standard output as a single-line JSON object with the fields:
-.RS 0
-.IP \(bu 4
-\fBwords\fR: The number of whitespace-separated tokens.
-.IP \(bu 4
-\fBlines\fR: The number of newline-separated lines, where a trailing line without a final newline still counts as one line (and an empty text has \fB0\fR lines).
-.IP \(bu 4
-\fBchars\fR: The number of Unicode characters, i.e., code points.
-.IP \(bu 4
-\fBbytes\fR: The number of octets: the raw file size for a \fIfile\fR (as its encoding is not necessarily UTF-8), resp. the UTF-8 length for a \fItext\fR.
-.RE 0
-.P
-A \fIfile\fR is decoded as UTF-8 for the other metrics. This backs the MCP tool \fBase_text_metric\fR, which the skills use instead of estimating a text length themselves.
-.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--file\fR \fIfile\fR\[rB]: Measure the content of \fIfile\fR instead of the \fItext\fR arguments.
-.RE 0
-.SH "ARGUMENTS"
-.RS 0
-.IP \(bu 4
-\[lB]\fItext\fR \[lB]...\[rB]\[rB]: The text to measure, formed by all arguments joined by single spaces (mutually exclusive with \fB--file\fR).
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR on success, and with status \fB1\fR if both or none of \fIfile\fR and \fItext\fR are given, or \fIfile\fR cannot be read.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# measure a document
-$ ase util metric -f README.md
-
-# measure a text
-$ ase util metric "Hello, World!"
-{"words":2,"lines":1,"chars":13,"bytes":13}
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-util\fR(1), \fBwc\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-util-mint.1

@@ -1,59 +0,0 @@
-.TH "ASE-UTIL-MINT" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-util-mint\fR - Mint Hash-Derived Identifiers
-.SH "SYNOPSIS"
-.P
-\fBase util mint\fR \[lB]\fB-h\fR|\fB--help\fR\[rB] \[lB]\fB-t\fR|\fB--type\fR \fBuuid\fR|\fBsha1\fR|\fBnanoid\fR\[rB] \[lB]\fB-c\fR|\fB--count\fR \fIcount\fR\[rB] \[lB]\fIhint\fR \[lB]...\[rB]\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase util mint\fR mints one or more hash-derived identifiers out of the \fIhint\fR formed by the remaining arguments (joined by single spaces), and prints them to standard output, one identifier per line:
-.RS 0
-.IP \(bu 4
-With type \fBuuid\fR, a non-empty \fIhint\fR yields a deterministic \fIUUID V5\fR over the \fIhint\fR within the fixed \fIASE\fR namespace (itself the \fIUUID V5\fR of the URL \fBhttps://ase.tools\fR within the standard URL namespace), so the same \fIhint\fR always yields the same UUID, disjoint from those of other applications. An empty \fIhint\fR yields random \fIUUID V4\fR values instead.
-.IP \(bu 4
-With type \fBsha1\fR, the \fIhint\fR yields its 40-character hexadecimal \fISHA-1\fR digest. This requires a non-empty \fIhint\fR.
-.IP \(bu 4
-With type \fBnanoid\fR, the \fIhint\fR yields its 10-character, \fINanoId\fR-style \fIbase62\fR hash (its \fISHA-1\fR digest, \fIbase62\fR-encoded and truncated), a short but still reproducible identifier, as used for the content binding of the \fBEffort\fR key of the task plans. This requires a non-empty \fIhint\fR, too.
-.RE 0
-.P
-This backs the \fBuuid\fR, \fBsha1\fR, and \fBnanoid\fR types of the \fBase-meta-mint\fR skill (and the MCP tool \fBase_mint\fR), while the language-level identifier types of that skill require the AI and hence exist in the skill only.
-.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--type\fR \fBuuid\fR|\fBsha1\fR|\fBnanoid\fR\[rB]: The identifier type (default: \fBuuid\fR).
-.IP \(bu 4
-\[lB]\fB-c\fR|\fB--count\fR \fIcount\fR\[rB]: The number of identifiers to mint, a positive integer (default: \fB1\fR). It is honored for an empty \fIhint\fR only, where random \fIUUID V4\fR values are minted. As hashing a non-empty \fIhint\fR always yields exactly one identifier, a larger \fIcount\fR is then reduced to \fB1\fR, and a warning is printed on standard error.
-.RE 0
-.SH "ARGUMENTS"
-.RS 0
-.IP \(bu 4
-\[lB]\fIhint\fR \[lB]...\[rB]\[rB]: The hint the identifiers are derived from, formed by all remaining arguments joined by single spaces (default: empty).
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR on success, and with status \fB1\fR on an invalid \fIcount\fR or type \fBsha1\fR or \fBnanoid\fR with an empty \fIhint\fR.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# mint the deterministic UUID of a hint
-$ ase util mint the user account entity
-
-# mint three random UUIDs
-$ ase util mint -c 3
-
-# mint the SHA-1 digest of a hint
-$ ase util mint -t sha1 the user account entity
-
-# mint the short NanoId-style hash of a hint
-$ ase util mint -t nanoid the user account entity
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-util\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-util-worktree.1

@@ -1,72 +0,0 @@
-.TH "ASE-UTIL-WORKTREE" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-util-worktree\fR - Resolve the ASE Worktree Directories
-.SH "SYNOPSIS"
-.P
-\fBase util worktree\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.P
-\fBase util worktree base\fR \[lB]\fB-c\fR|\fB--create\fR\[rB] \[lB]\fB-t\fR|\fB--temp\fR\[rB]
-.P
-\fBase util worktree path\fR \[lB]\fB-c\fR|\fB--create\fR\[rB] \[lB]\fB-t\fR|\fB--temp\fR\[rB] \fIid\fR
-.SH "DESCRIPTION"
-.P
-\fBase util worktree\fR safely resolves the directories of the Git worktrees managed by \fIASE\fR (e.g., the worktrees of the \fB--worktree\fR option of the skills and of the agents), which all reside below the base directory \fB<repo-root>/.ase/worktree\fR, where \fIrepo-root\fR is the fully resolved top-level directory of the Git working tree of the current working directory. The \fItemporary\fR worktrees reside below \fB<repo-root>/.ase/worktree/.temp\fR, a namespace disjoint from all regular worktree ids (as ids never contain a \fB.\fR).
-.P
-The resolution is \fIvalidated\fR: as \fBgit worktree add\fR silently follows a symbolic link, every already existing path component below the repository root (\fB.ase\fR, \fBworktree\fR, \fB.temp\fR, and the \fIid\fR leaf) has to be a real directory, neither a symbolic link, nor any other file, nor an aliased path, so a repository carrying a committed \fB.ase\fR symbolic link can never make a worktree be written outside of it. Not yet existing components are fine, as they are created later on.
-.P
-The resolved directory is printed to standard output. 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 and exit.
-.RE 0
-.SH "COMMANDS"
-.RS 0
-.IP \(bu 4
-\fBase util worktree base\fR \[lB]\fB-c\fR|\fB--create\fR\[rB] \[lB]\fB-t\fR|\fB--temp\fR\[rB]: Print the validated base directory \fB<repo-root>/.ase/worktree\fR holding all \fIASE\fR worktrees. The options are:
-.RS 4
-.IP \(bu 4
-\[lB]\fB-c\fR|\fB--create\fR\[rB]: Create the base directory (with all its missing parents) if it does not exist yet, and validate it again afterwards.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--temp\fR\[rB]: Print the base directory \fB<repo-root>/.ase/worktree/.temp\fR of the temporary worktrees instead.
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.RE 0
-.IP \(bu 4
-\fBase util worktree path\fR \[lB]\fB-c\fR|\fB--create\fR\[rB] \[lB]\fB-t\fR|\fB--temp\fR\[rB] \fIid\fR: Print the validated worktree directory \fB<repo-root>/.ase/worktree/<id>\fR of a single worktree \fIid\fR, which has to be non-empty and match \fB\[lB]A-Za-z0-9_-\[rB]+\fR, so it is safe both as a single path component and as the Git branch name derived from it. The worktree directory itself is not created, as this is done by \fBgit worktree add\fR. The options are:
-.RS 4
-.IP \(bu 4
-\[lB]\fB-c\fR|\fB--create\fR\[rB]: Create the base directory (not the worktree directory itself) if it does not exist yet.
-.IP \(bu 4
-\[lB]\fB-t\fR|\fB--temp\fR\[rB]: Resolve the \fIid\fR below the base directory \fB<repo-root>/.ase/worktree/.temp\fR of the temporary worktrees.
-.IP \(bu 4
-\[lB]\fB-h\fR|\fB--help\fR\[rB]: Show usage information and exit.
-.RE 0
-.RE 0
-.SH "FILES"
-.RS 0
-.IP \(bu 4
-\fB<repo-root>/.ase/worktree/\fR: The base directory of all \fIASE\fR worktrees, ignored by Git via the self-ignoring \fB.ase/.gitignore\fR.
-.IP \(bu 4
-\fB<repo-root>/.ase/worktree/.temp/\fR: The base directory of the temporary \fIASE\fR worktrees.
-.RE 0
-.SH "EXIT STATUS"
-.P
-Exits with status \fB0\fR on success, and with status \fB1\fR outside of a Git working tree, on an invalid \fIid\fR, or if a path component is a symbolic link, not a directory, or an aliased path. The group command without a sub-command exits with status \fB1\fR.
-.SH "EXAMPLES"
-.P
-.RS 2
-.nf
-# print the base directory of all ASE worktrees, creating it if needed
-$ ase util worktree base -c
-
-# create a worktree for the id "FOO-42" at its validated location
-$ git worktree add "$(ase util worktree path -c FOO-42)" -b FOO-42
-.fi
-.RE
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-util\fR(1), \fBgit-worktree\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR

package/dst/man/ase-util.1

@@ -1,50 +0,0 @@
-.TH "ASE-UTIL" "1" "October 2026" "2.0.3" "Agentic Software Engineering (ASE)"
-.SH "NAME"
-\fBase-util\fR - Utility Commands
-.SH "SYNOPSIS"
-.P
-\fBase util\fR \[lB]\fB-h\fR|\fB--help\fR\[rB]
-.P
-\fBase util meta\fR \fIname\fR \[lB]...\[rB]
-.P
-\fBase util compat\fR
-.P
-\fBase util diagram\fR \[lB]\fIoptions\fR\[rB]
-.P
-\fBase util worktree\fR \fBbase\fR|\fBpath\fR \[lB]\fIoptions\fR\[rB] \[lB]\fIid\fR\[rB]
-.P
-\fBase util mint\fR \[lB]\fB-t\fR|\fB--type\fR \fItype\fR\[rB] \[lB]\fB-c\fR|\fB--count\fR \fIcount\fR\[rB] \[lB]\fIhint\fR \[lB]...\[rB]\[rB]
-.P
-\fBase util metric\fR \[lB]\fB-f\fR|\fB--file\fR \fIfile\fR\[rB] \[lB]\fItext\fR \[lB]...\[rB]\[rB]
-.SH "DESCRIPTION"
-.P
-\fBase util\fR is the entry point group for miscellaneous utility commands. Most of them back the MCP tools of the per-project \fIASE\fR service and the \fIASE\fR skills, but can be used standalone, too. 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 and exit.
-.RE 0
-.SH "COMMANDS"
-.RS 0
-.IP \(bu 4
-\fBase util meta\fR \fIname\fR \[lB]...\[rB]: Output the contents of one or more plugin meta files. See \fBase-util-meta\fR(1).
-.IP \(bu 4
-\fBase util compat\fR: Output the expected probe values of the \fBase-meta-compat\fR self-test skill. See \fBase-util-compat\fR(1).
-.IP \(bu 4
-\fBase util diagram\fR \[lB]\fIoptions\fR\[rB]: Render a \fIMermaid\fR or \fID2\fR diagram specification as Unicode/ASCII art or SVG. See \fBase-util-diagram\fR(1).
-.IP \(bu 4
-\fBase util worktree\fR \fBbase\fR|\fBpath\fR \[lB]\fIoptions\fR\[rB] \[lB]\fIid\fR\[rB]: Safely resolve the \fIASE\fR worktree directories below \fB<repo-root>/.ase/worktree\fR. See \fBase-util-worktree\fR(1).
-.IP \(bu 4
-\fBase util mint\fR \[lB]\fIoptions\fR\[rB] \[lB]\fIhint\fR \[lB]...\[rB]\[rB]: Mint hash-derived identifiers (UUID, SHA-1) out of a hint. See \fBase-util-mint\fR(1).
-.IP \(bu 4
-\fBase util metric\fR \[lB]\fIoptions\fR\[rB] \[lB]\fItext\fR \[lB]...\[rB]\[rB]: Measure the words, lines, characters, and bytes of a file or a text. See \fBase-util-metric\fR(1).
-.RE 0
-.SH "EXIT STATUS"
-.P
-The group command without a sub-command exits with status \fB1\fR.
-.SH "SEE ALSO"
-.P
-\fBase\fR(1), \fBase-util-meta\fR(1), \fBase-util-compat\fR(1), \fBase-util-diagram\fR(1), \fBase-util-worktree\fR(1), \fBase-util-mint\fR(1), \fBase-util-metric\fR(1).
-.SH "AUTHOR"
-.P
-Dr. Ralf S. Engelschall \fI\(larse@engelschall.com\(ra\fR