@rse/ase 2.0.2 → 2.0.4

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

@@ -0,0 +1,85 @@
+# ase-util-mint(1) -- Mint Hash-Derived Identifiers
+
+## SYNOPSIS
+
+`ase util mint`
+\[`-h`|`--help`\]
+\[`-t`|`--type` `uuid`|`sha1`|`nanoid`\]
+\[`-c`|`--count` *count*\]
+\[*hint* \[...\]\]
+
+## DESCRIPTION
+
+**ase util mint** mints one or more hash-derived identifiers out of the
+*hint* formed by the remaining arguments (joined by single spaces), and
+prints them to standard output, one identifier per line:
+
+- With type `uuid`, a non-empty *hint* yields a deterministic *UUID
+  V5* over the *hint* within the fixed *ASE* namespace (itself the
+  *UUID V5* of the URL `https://ase.tools` within the standard URL
+  namespace), so the same *hint* always yields the same UUID, disjoint
+  from those of other applications. An empty *hint* yields random
+  *UUID V4* values instead.
+
+- With type `sha1`, the *hint* yields its 40-character hexadecimal
+  *SHA-1* digest. This requires a non-empty *hint*.
+
+- With type `nanoid`, the *hint* yields its 10-character, *NanoId*-style
+  *base62* hash (its *SHA-1* digest, *base62*-encoded and truncated),
+  a short but still reproducible identifier, as used for the content
+  binding of the `Effort` key of the task plans. This requires a
+  non-empty *hint*, too.
+
+This backs the `uuid`, `sha1`, and `nanoid` types of the `ase-meta-mint` skill
+(and the MCP tool `ase_mint`), while the language-level identifier
+types of that skill require the AI and hence exist in the skill only.
+
+## OPTIONS
+
+- \[`-h`|`--help`\]:
+  Show usage information and exit.
+
+- \[`-t`|`--type` `uuid`|`sha1`|`nanoid`\]:
+  The identifier type (default: `uuid`).
+
+- \[`-c`|`--count` *count*\]:
+  The number of identifiers to mint, a positive integer (default:
+  `1`). It is honored for an empty *hint* only, where random *UUID V4*
+  values are minted. As hashing a non-empty *hint* always yields
+  exactly one identifier, a larger *count* is then reduced to `1`, and a
+  warning is printed on standard error.
+
+## ARGUMENTS
+
+- \[*hint* \[...\]\]:
+  The hint the identifiers are derived from, formed by all remaining
+  arguments joined by single spaces (default: empty).
+
+## EXIT STATUS
+
+Exits with status `0` on success, and with status `1` on an invalid
+*count* or type `sha1` or `nanoid` with an empty *hint*.
+
+## EXAMPLES
+
+```sh
+# 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
+```
+
+## SEE ALSO
+
+`ase`(1), `ase-util`(1).
+
+## AUTHOR
+
+Dr. Ralf S. Engelschall <rse@engelschall.com>

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

@@ -0,0 +1,109 @@
+# ase-util-worktree(1) -- Resolve the ASE Worktree Directories
+
+## SYNOPSIS
+
+`ase util worktree`
+\[`-h`|`--help`\]
+
+`ase util worktree base`
+\[`-c`|`--create`\]
+\[`-t`|`--temp`\]
+
+`ase util worktree path`
+\[`-c`|`--create`\]
+\[`-t`|`--temp`\]
+*id*
+
+## DESCRIPTION
+
+**ase util worktree** safely resolves the directories of the Git
+worktrees managed by *ASE* (e.g., the worktrees of the
+`--worktree` option of the skills and of the agents), which all reside
+below the base directory `<repo-root>/.ase/worktree`, where
+*repo-root* is the fully resolved top-level directory of the Git
+working tree of the current working directory. The *temporary*
+worktrees reside below `<repo-root>/.ase/worktree/.temp`, a namespace
+disjoint from all regular worktree ids (as ids never contain a `.`).
+
+The resolution is *validated*: as `git worktree add` silently follows
+a symbolic link, every already existing path component below the
+repository root (`.ase`, `worktree`, `.temp`, and the *id* 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 `.ase`
+symbolic link can never make a worktree be written outside of it. Not
+yet existing components are fine, as they are created later on.
+
+The resolved directory is printed to standard output. Without a
+sub-command, the usage information is shown and the command exits
+with status `1`.
+
+## OPTIONS
+
+- \[`-h`|`--help`\]:
+  Show usage information and exit.
+
+## COMMANDS
+
+- `ase util worktree base` \[`-c`|`--create`\] \[`-t`|`--temp`\]:
+  Print the validated base directory `<repo-root>/.ase/worktree` holding
+  all *ASE* worktrees. The options are:
+
+    - \[`-c`|`--create`\]:
+      Create the base directory (with all its missing parents) if it
+      does not exist yet, and validate it again afterwards.
+    - \[`-t`|`--temp`\]:
+      Print the base directory `<repo-root>/.ase/worktree/.temp` of the
+      temporary worktrees instead.
+    - \[`-h`|`--help`\]:
+      Show usage information and exit.
+
+- `ase util worktree path` \[`-c`|`--create`\] \[`-t`|`--temp`\] *id*:
+  Print the validated worktree directory `<repo-root>/.ase/worktree/<id>`
+  of a single worktree *id*, which has to be non-empty and match
+  `[A-Za-z0-9_-]+`, 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 `git worktree add`. The
+  options are:
+
+    - \[`-c`|`--create`\]:
+      Create the base directory (not the worktree directory itself) if
+      it does not exist yet.
+    - \[`-t`|`--temp`\]:
+      Resolve the *id* below the base directory
+      `<repo-root>/.ase/worktree/.temp` of the temporary worktrees.
+    - \[`-h`|`--help`\]:
+      Show usage information and exit.
+
+## FILES
+
+- `<repo-root>/.ase/worktree/`:
+  The base directory of all *ASE* worktrees, ignored by Git via the
+  self-ignoring `.ase/.gitignore`.
+
+- `<repo-root>/.ase/worktree/.temp/`:
+  The base directory of the temporary *ASE* worktrees.
+
+## EXIT STATUS
+
+Exits with status `0` on success, and with status `1` outside of a Git
+working tree, on an invalid *id*, 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 `1`.
+
+## EXAMPLES
+
+```sh
+# 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
+```
+
+## SEE ALSO
+
+`ase`(1), `ase-util`(1), `git-worktree`(1).
+
+## AUTHOR
+
+Dr. Ralf S. Engelschall <rse@engelschall.com>

package/dst/man/ase-util.md

@@ -0,0 +1,81 @@
+# ase-util(1) -- Utility Commands
+
+## SYNOPSIS
+
+`ase util`
+\[`-h`|`--help`\]
+
+`ase util meta`
+*name* \[...\]
+
+`ase util compat`
+
+`ase util diagram`
+\[*options*\]
+
+`ase util worktree`
+`base`|`path`
+\[*options*\]
+\[*id*\]
+
+`ase util mint`
+\[`-t`|`--type` *type*\]
+\[`-c`|`--count` *count*\]
+\[*hint* \[...\]\]
+
+`ase util metric`
+\[`-f`|`--file` *file*\]
+\[*text* \[...\]\]
+
+## DESCRIPTION
+
+**ase util** is the entry point group for miscellaneous utility
+commands. Most of them back the MCP tools of the per-project *ASE*
+service and the *ASE* skills, but can be used standalone, too. Without
+a sub-command, the usage information is shown and the command exits
+with status `1`.
+
+## OPTIONS
+
+- \[`-h`|`--help`\]:
+  Show usage information and exit.
+
+## COMMANDS
+
+- `ase util meta` *name* \[...\]:
+  Output the contents of one or more plugin meta files. See
+  `ase-util-meta`(1).
+
+- `ase util compat`:
+  Output the expected probe values of the `ase-meta-compat` self-test
+  skill. See `ase-util-compat`(1).
+
+- `ase util diagram` \[*options*\]:
+  Render a *Mermaid* or *D2* diagram specification as Unicode/ASCII art
+  or SVG. See `ase-util-diagram`(1).
+
+- `ase util worktree` `base`|`path` \[*options*\] \[*id*\]:
+  Safely resolve the *ASE* worktree directories below
+  `<repo-root>/.ase/worktree`. See `ase-util-worktree`(1).
+
+- `ase util mint` \[*options*\] \[*hint* \[...\]\]:
+  Mint hash-derived identifiers (UUID, SHA-1) out of a hint. See
+  `ase-util-mint`(1).
+
+- `ase util metric` \[*options*\] \[*text* \[...\]\]:
+  Measure the words, lines, characters, and bytes of a file or a text.
+  See `ase-util-metric`(1).
+
+## EXIT STATUS
+
+The group command without a sub-command exits with status `1`.
+
+## SEE ALSO
+
+`ase`(1), `ase-util-meta`(1), `ase-util-compat`(1),
+`ase-util-diagram`(1), `ase-util-worktree`(1), `ase-util-mint`(1),
+`ase-util-metric`(1).
+
+## AUTHOR
+
+Dr. Ralf S. Engelschall <rse@engelschall.com>

package/dst/man/ase.md

@@ -0,0 +1,228 @@
+# ase(1) -- Agentic Software Engineering (ASE)
+
+## SYNOPSIS
+
+`ase`
+\[`-h`|`--help`\]
+\[`-V`|`--version`\]
+\[`-l`|`--log-level` *level*\]
+\[`-L`|`--log-file` *file*\]
+*command*
+\[*options* \[...\]\]
+\[*args* \[...\]\]
+
+## DESCRIPTION
+
+**ase**, *Agentic Software Engineering (ASE)*, is the command-line
+companion tool of the *ASE* agent tool plugin for
+*Anthropic Claude Code CLI* (primary target), *GitHub Copilot CLI*,
+and *OpenAI Codex CLI* (secondary targets).
+
+It provides the plugin and tool setup, the layered configuration
+management, a per-project background HTTP service (bridged into the
+agent tool as a Model-Context-Protocol (MCP) server), the agent tool
+hook handlers, the statusline rendering, the persisted task plan
+management (including a task store server and an interactive task
+board), the autonomous task lifecycle agents (plus their agent relay
+and fleet supervisor), the project artifact resolution, the
+*SpecBook*-based specification initializing, linting, exporting and
+previewing, and miscellaneous utilities like diagram rendering,
+identifier minting, and text measuring.
+
+Most commands are sub-command groups. Each group and each command has
+its own manual page, named after the command path with dashes, e.g.,
+`ase-task`(1) for `ase task` and `ase-task-board`(1) for `ase task
+board`. They are shipped with **ase** and shown via `ase man`, e.g.,
+`ase man task board`.
+
+## OPTIONS
+
+The following top-level (global) options exist. They have to be given
+*before* the *command*, as all options after the *command* belong to
+the command itself.
+
+- \[`-h`|`--help`\]:
+  Show program usage information, including the list of all top-level
+  commands, and exit. Every command and sub-command also accepts
+  `-h`|`--help` to show its own usage information. Alternatively, `ase
+  help` \[*command*\] shows the usage information of *command*.
+
+- \[`-V`|`--version`\]:
+  Show program version information (as `ASE` *version*) and exit.
+
+- \[`-l`|`--log-level` *level*\]:
+  Set the logging verbosity. Supported *level* values are `error`,
+  `warning`, `info` (default), and `debug`. Log messages of a level
+  above the selected one are suppressed. The level is passed on to all
+  background processes (like the service, the task store, the agent
+  relay, and the agents) started by the command.
+
+- \[`-L`|`--log-file` *file*\]:
+  Redirect log output to *file* (appended). Use `-` (default) to write
+  log messages to standard error. If the log output is connected to a
+  terminal, it is colored.
+
+## COMMANDS
+
+The following top-level commands exist:
+
+- `ase setup` *command* \[...\]:
+  Install, update, uninstall, enable, disable, and report the *ASE*
+  tool and plugin for an agent tool, and activate or deactivate the
+  pre-defined foreign MCP servers, the *ASE* statusline, and the *ASE*
+  telemetry export. See `ase-setup`(1).
+
+- `ase config` \[`--scope` *scope*\] *command* \[...\]:
+  Manage the layered *ASE* configuration of the scope chain `user` <
+  `project` < `task` < `session`. See `ase-config`(1).
+
+- `ase mcp`:
+  Bridge stdio MCP to the per-project background service. Configured
+  as an MCP server in the agent tool. See `ase-mcp`(1).
+
+- `ase service` *command* \[...\]:
+  Manage the per-project background HTTP service. See `ase-service`(1).
+
+- `ase hook` *command* \[...\]:
+  Handle the hook events of the agent tool. Configured as hook
+  handlers in the agent tool. See `ase-hook`(1).
+
+- `ase statusline` \[*options*\] \[*line* \[...\]\]:
+  Render the statusline of the agent tool. Configured as statusline
+  command in the agent tool. See `ase-statusline`(1).
+
+- `ase task` *command* \[...\]:
+  Manage the persisted task plans in the task store, show the task
+  board, and run the task store server. See `ase-task`(1).
+
+- `ase artifact` *command* \[...\]:
+  Resolve project artifact kinds to project-relative file lists. See
+  `ase-artifact`(1).
+
+- `ase spec` *command* \[...\]:
+  Initialize, lint, export, and preview the *SpecBook*-based project
+  specification. See `ase-spec`(1).
+
+- `ase util` *command* \[...\]:
+  Utility commands (meta files, compatibility probes, diagram rendering,
+  worktree resolution, identifier minting, and text measuring). See
+  `ase-util`(1).
+
+- `ase agent` *agent* *command* \[...\]:
+  Run the autonomous agents driving the task lifecycle phases,
+  processing the requests of tasks, estimating the effort of tasks,
+  researching topics for tasks, or configured by definitions, individually or as a fleet, optionally
+  reporting to the agent relay. See `ase-agent`(1).
+
+- `ase man` \[*page* \[...\]\]:
+  Browse the manual pages of all commands and skills interactively,
+  with *page* selected, e.g., `ase man agent fleet` for
+  `ase-agent-fleet`(1), or (outside a terminal) print one of them as
+  plain text. See `ase-man`(1).
+
+- `ase help` \[*command*\]:
+  Show the usage information of *command* (or of `ase` itself).
+
+## ENVIRONMENT
+
+The following environment variables are honored by multiple commands.
+The command-specific ones are described in their own manual pages.
+
+- `ASE_TOOL`:
+  The default target agent tool (`claude`, `copilot`, or `codex`) of
+  all commands accepting a `--tool` option (default: `claude`).
+
+- `ASE_TASK_ID`:
+  The default task id of the `ase task` commands accepting an optional
+  task id (default: `default`).
+
+- `ASE_HEADLESS`:
+  Set to `true` by the agents for the agent tool processes they spawn,
+  to signal the skills that they run without any user interaction.
+
+- `ASE_SETUP_DEV`:
+  The default of the `--dev` option of `ase setup install`, `ase setup
+  update`, and `ase setup uninstall`.
+
+- `EDITOR`, `VISUAL`:
+  The text editor used by `ase config edit`, `ase task edit`, and
+  `ase task board` (falling back to `vi`).
+
+- `PAGER`:
+  The pager used by `ase task view` (falling back to `more`).
+
+- `XDG_CONFIG_HOME`, `XDG_STATE_HOME`, `APPDATA`, `LOCALAPPDATA`:
+  The base directories of the *per-user configuration directory* and
+  the *per-user state directory* (see **FILES**).
+
+## FILES
+
+- *per-user configuration directory*:
+  The per-user *ASE* configuration directory: `~/Library/Application
+  Support/ase` on macOS, `%APPDATA%\ase` on Windows, and
+  `$XDG_CONFIG_HOME/ase` (falling back to `~/.config/ase`) on Linux
+  and other Unix systems. It holds the `user` scope configuration
+  `config.yaml`, the user agent definitions `agents/`, and the state
+  of the task store server (`store.yaml`, `store.log`, `tasks/`) and
+  agent relay server (`relay.yaml`, `relay.log`).
+
+- *per-user state directory*:
+  The machine-local per-user *ASE* state (session configurations, task
+  lifecycle deviation warnings, agent run records, and telemetry
+  state), never roamed or versioned: `~/Library/Application
+  Support/ase` on macOS, `%LOCALAPPDATA%\ase` on Windows, and
+  `$XDG_STATE_HOME/ase` (falling back to `~/.local/state/ase`) on Linux
+  and other Unix systems.
+
+- `.ase/`:
+  The per-project *ASE* directory in the project root, holding the
+  `project` scope configuration `config.yaml`, the agent definitions
+  `agents/`, the fleet configuration `fleet.yaml`, the task plans
+  `task/` of the default local task store, and the machine-local
+  runtime files (`service.yaml`, `service.log`, `board.yaml`, `agent/`,
+  and `worktree/`), the latter covered by the self-ignoring
+  `.ase/.gitignore`.
+
+## EXIT STATUS
+
+The **ase** command exits with status `0` on success and with status
+`1` on any error (with the error message logged at level `error`),
+unless a command documents otherwise. A usage error (an unknown
+command or option, or a missing argument) is reported together with
+the usage information and leads to exit status `1`.
+
+## EXAMPLES
+
+```sh
+# install the ASE tool and plugin for Anthropic Claude Code CLI
+$ ase setup install
+
+# show the effective configuration of the current project
+$ ase config list
+
+# list all open task plans with their status and title
+$ ase task list -v
+
+# show the interactive task board
+$ ase task board
+
+# start the fleet of agents of ".ase/fleet.yaml"
+$ ase agent fleet start
+```
+
+## SEE ALSO
+
+`ase-setup`(1), `ase-config`(1), `ase-mcp`(1), `ase-service`(1),
+`ase-hook`(1), `ase-statusline`(1), `ase-task`(1), `ase-artifact`(1),
+`ase-spec`(1), `ase-util`(1), `ase-agent`(1), `ase-man`(1),
+`claude`(1), `copilot`(1), `codex`(1), `git`(1).
+
+<https://ase.tools>
+
+## HISTORY
+
+Development of `ase`(1) started in October 2025.
+
+## AUTHOR
+
+Dr. Ralf S. Engelschall <rse@engelschall.com>

package/package.json

@@ -6,7 +6,7 @@
     "homepage":                             "https://ase.tools",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
     "bugs":                                 { "url": "https://github.com/rse/ase/issues" },
-    "version":                              "2.0.2",
+    "version":                              "2.0.4",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -15,7 +15,6 @@
     },
     "type":                                 "module",
     "bin":                                  { "ase": "bin/ase" },
-    "directories":                          { "man": "dst/man" },
     "types":                                "dst/ase-agent-definition-api.d.ts",
     "exports": {
         ".":                                { "types": "./dst/ase-agent-definition-api.d.ts" },
@@ -24,9 +23,9 @@
     "devDependencies": {
         "eslint":                           "10.13.0",
         "@eslint/js":                       "10.0.1",
-        "@typescript-eslint/parser":        "8.71.2",
-        "@typescript-eslint/eslint-plugin": "8.71.2",
-        "typescript-eslint":                "8.71.2",
+        "@typescript-eslint/parser":        "8.72.0",
+        "@typescript-eslint/eslint-plugin": "8.72.0",
+        "typescript-eslint":                "8.72.0",
         "eslint-plugin-promise":            "7.3.0",
         "neostandard":                      "0.14.1",
         "globals":                          "17.13.0",
@@ -38,21 +37,19 @@
         "@rse/stx":                         "1.1.7",
         "nodemon":                          "3.1.14",
         "shx":                              "0.4.0",
-        "remark-cli":                       "12.0.1",
-        "remark-man":                       "9.0.0",
         "stylus":                           "0.64.0",
-        "vite":                             "8.3.4",
+        "vite":                             "8.3.5",
         "@vitejs/plugin-vue":               "6.0.10",
         "vue":                              "3.5.44",
         "mousetrap":                        "1.6.5",
-        "@codemirror/view":                 "6.43.14",
+        "@codemirror/view":                 "6.43.15",
         "@codemirror/state":                "6.7.6",
         "@codemirror/commands":             "6.11.1",
         "@codemirror/language":             "6.13.1",
         "@codemirror/lang-markdown":        "6.5.2",
         "@lezer/highlight":                 "1.2.5",
         "@codemirror/search":               "6.7.2",
-        "@codemirror/autocomplete":         "6.20.3",
+        "@codemirror/autocomplete":         "6.20.4",
         "@replit/codemirror-vim":           "6.4.0",
         "@replit/codemirror-emacs":         "6.1.0",
         "source-sans":                      "3.52.0",
@@ -75,7 +72,7 @@
     },
     "dependencies": {
         "commander":                        "15.0.0",
-        "@dotenvx/dotenvx":                 "2.38.0",
+        "@dotenvx/dotenvx":                 "2.38.2",
         "yaml":                             "2.9.1",
         "valibot":                          "1.5.0",
         "execa":                            "10.2.0",
@@ -86,7 +83,7 @@
         "elkjs":                            "0.12.0",
         "ink":                              "8.0.0",
         "react":                            "19.3.1",
-        "chokidar":                         "5.0.0",
+        "chokidar":                         "6.0.0",
         "marked":                           "18.1.1",
         "shiki":                            "4.5.0",
         "cli-table3":                       "0.6.5",
@@ -106,10 +103,11 @@
         "p-queue":                          "10.0.0",
         "pacote":                           "22.0.0",
         "ofetch":                           "1.5.1",
-        "undici":                           "8.12.2",
+        "undici":                           "8.12.3",
         "picomatch":                        "4.0.7",
         "lru-cache":                        "11.5.3",
         "@rse/specbook":                    "1.5.2",
+        "markdownlint":                     "0.42.0",
         "tail":                             "2.2.6",
         "source-code-error":                "1.2.0",
         "pure-uuid":                        "2.0.0",
@@ -125,9 +123,6 @@
     "overrides": {
         "stylus": {
             "glob":                         "13.0.6"
-        },
-        "remark-cli": {
-            "glob":                         "13.0.6"
         }
     },
     "allowScripts": {
@@ -135,7 +130,7 @@
     },
     "engines": {
         "npm":                              ">=10.0.0",
-        "node":                             ">=22.18.0"
+        "node":                             ">=22.22.0"
     },
     "upd": [
         "!typescript"

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "2.0.2",
+    "version":     "2.0.4",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "2.0.2",
+    "version":     "2.0.4",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/.github/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "2.0.2",
+    "version":     "2.0.4",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/agents/ase-code-lint.md

@@ -394,9 +394,9 @@ Workflow
 
             4.  Set <context-after/> to exactly *up to two* lines of
                 *unchanged* code content which occurs in <file/>
-                directly *after* <old-text/>, i.e., the lines (<line/>
-                + <n/>) and (<line/> + <n/> + 1), where <n/> is the
-                number of lines in <old-text/>. Reduce to just one line
+                directly *after* <old-text/>, i.e., the lines
+                (<line/> + <n/>) and (<line/> + <n/> + 1), where <n/> is
+                the number of lines in <old-text/>. Reduce to just one line
                 (<line/> + <n/>) if <old-text/> is the second-last
                 line of the file. Set <context-after/> to empty if
                 <old-text/> is the last line in the file.

package/plugin/agents/ase-docs-proofread.md

@@ -81,9 +81,9 @@ Workflow
 
     6.  Set <context-after/> to exactly *up to two* lines of
         *unchanged* text content which occurs in the document
-        directly *after* <old-text/>, i.e., the lines (<line/>
-        + <n/>) and (<line/> + <n/> + 1), where <n/> is the
-        number of lines in <old-text/>. Reduce to just one line
+        directly *after* <old-text/>, i.e., the lines
+        (<line/> + <n/>) and (<line/> + <n/> + 1), where <n/> is
+        the number of lines in <old-text/>. Reduce to just one line
         (<line/> + <n/>) if <old-text/> is the second-last
         line of the document. Set <context-after/> to empty if
         <old-text/> is the last line in the document.

package/plugin/agents/ase-docs-refine.md

@@ -119,9 +119,9 @@ Workflow
 
     6.  Set <context-after/> to exactly *up to two* lines of
         *unchanged* text content which occurs in the document
-        directly *after* <old-text/>, i.e., the lines (<line/>
-        + <n/>) and (<line/> + <n/> + 1), where <n/> is the
-        number of lines in <old-text/>. Reduce to just one line
+        directly *after* <old-text/>, i.e., the lines
+        (<line/> + <n/>) and (<line/> + <n/> + 1), where <n/> is
+        the number of lines in <old-text/>. Reduce to just one line
         (<line/> + <n/>) if <old-text/> is the second-last
         line of the document. Set <context-after/> to empty if
         <old-text/> is the last line in the document.