@rse/ase 2.0.0 → 2.0.2

package/dst/ase-task-board-web-server.js

@@ -18,7 +18,7 @@ import { flowOf, layoutFlow, drawFlowSVG } from "./ase-task-board-flow.js";
 import { filterBoard, dropStandalone } from "./ase-task-board-filter.js";
 import { statsOf, statsRanges, effortScale } from "./ase-task-board-stats.js";
 import * as TaskFormat from "./ase-task-format.js";
-import { editProbe, editRefused, requestEdit, requestsOf, RequestError } from "./ase-task-request.js";
+import { editProbe, editRefused, requestsOf, RequestError } from "./ase-task-request.js";
 import pkg from "../package.json" with { type: "json" };
 /*  the build stamp of the loaded code (version and content hash of the board modules
     and page assets), reported by the ping route to let the CLI detect a stale running service
@@ -26,7 +26,7 @@ import pkg from "../package.json" with { type: "json" };
 export const BOARD_BUILD = (() => {
     const dir = path.dirname(fileURLToPath(import.meta.url));
     const hash = crypto.createHash("sha1");
-    for (const f of ["core.js", "filter.js", "graph.js", "stats.js", "web-server.js", "web-client.html", "web-client.css", "web-client.js"])
+    for (const f of ["core.js", "filter.js", "flow.js", "graph.js", "stats.js", "web-server.js", "web-client.html", "web-client.css", "web-client.js"])
         hash.update(fs.readFileSync(path.join(dir, `ase-task-board-${f}`)));
     return `${pkg.version}:${hash.digest("hex")}`;
 })();
@@ -637,29 +637,6 @@ const registerUpdateRoutes = (server, log) => {
             return h.response({ prompt: probe.prompt });
         })
     });
-    /*  request the edit of a task by a prompt (processed by "ase agent editor"), answering
-        400 if the prompt is empty, 404 if the task is missing, and 409 if it is finished or
-        an edit of it is in progress (as checked atomically with the request)  */
-    server.route({
-        method: "POST",
-        path: "/task-board/api/task/{id}/edit",
-        options: { payload: { parse: true, allow: "application/json" } },
-        handler: guarded(async (request, h) => {
-            const id = String(request.params.id);
-            const p = request.payload;
-            if (!TaskFormat.TASK_ID_RE.test(id) || p === null || typeof p.prompt !== "string")
-                return h.response({ error: "invalid edit request" }).code(400);
-            try {
-                await requestEdit(log, id, p.prompt);
-            }
-            catch (err) {
-                const code = !(err instanceof RequestError) || err.reason === "empty" ? 400 :
-                    err.reason === "missing" ? 404 : 409;
-                return h.response({ error: err instanceof Error ? err.message : String(err) }).code(code);
-            }
-            return h.response({ ok: true });
-        })
-    });
     /*  request a task by a prompt under a request name (processed by a request agent of
         a definition, resp. by "ase agent editor" for "edit"), answering 400 if the
         request name is invalid or the prompt of an "edit" request is empty (as the prompts

package/dst/ase-task-store-issues.js

@@ -235,3 +235,79 @@ export const attachmentSync = (current, wanted) => {
     }
     return ops;
 };
+/*  the common base of the issue tracker storage plugins: the projects mapped onto
+    their locations, the storage lifecycle polling for changes while opened and
+    observed (without keeping the process alive), and the project listing  */
+export class IssueTaskStoragePlugin {
+    ctx;
+    unit;
+    now;
+    url = "";
+    poll = 0;
+    repos = new Map();
+    listener = null;
+    timer = null;
+    opened;
+    polling = false;
+    polls = new Map();
+    constructor(ctx, unit, now) {
+        this.ctx = ctx;
+        this.unit = unit;
+        this.now = now;
+        this.opened = now();
+    }
+    /*  the storage lifecycle  */
+    async open() {
+        this.opened = this.now();
+        if (this.poll > 0 && this.listener !== null) {
+            this.timer = setInterval(() => {
+                this.pollAll().catch(() => { });
+            }, this.poll * 1000);
+            this.timer.unref();
+        }
+        this.ctx.log("debug", `opened ${this.repos.size} ${this.unit} on ${this.url} (polling every ${this.poll}s)`);
+    }
+    async close() {
+        if (this.timer !== null)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /*  observe the changes of the issues made outside of this plugin instance  */
+    watch(listener) {
+        this.listener = listener;
+    }
+    /*  list the registered ones of the mapped projects  */
+    async projectList() {
+        const out = [];
+        for (const prjId of this.repos.keys()) {
+            const entry = await this.projectGet(prjId);
+            if (entry !== null)
+                out.push(entry);
+        }
+        return out;
+    }
+    /*  the change detection state of a project (starting at the opening time)  */
+    pollState(prjId) {
+        let state = this.polls.get(prjId);
+        if (state === undefined) {
+            state = { since: this.opened, seen: new Map() };
+            this.polls.set(prjId, state);
+        }
+        return state;
+    }
+    /*  poll all mapped projects, never overlapping itself  */
+    async pollAll() {
+        if (this.polling)
+            return;
+        this.polling = true;
+        try {
+            for (const prjId of this.repos.keys())
+                await this.pollProject(prjId).catch((err) => {
+                    this.ctx.log("warning", `polling project "${prjId}" failed: ${err instanceof Error ? err.message : String(err)}`);
+                });
+        }
+        finally {
+            this.polling = false;
+        }
+    }
+}

package/dst/ase-task-store-plugin-gitea.js

@@ -50,19 +50,10 @@ const inRepo = (loc, issue) => issue.repository === undefined || issue.repositor
     "After" onto the dependencies (the blocking issues), "Created"/"Modified" onto the
     issue timestamps, any other key (including "Group", as Gitea has no parent issues)
     onto "ase:<key>:<value>" labels, and the attachments onto the issue comments  */
-class GiteaTaskStoragePlugin {
-    ctx;
+class GiteaTaskStoragePlugin extends TaskIssues.IssueTaskStoragePlugin {
     name = "gitea";
-    url;
     source;
     gt;
-    repos = new Map();
-    poll;
-    listener = null;
-    timer = null;
-    polling = false;
-    opened = now();
-    polls = new Map();
     registry = new LRUCache({ max: 64, ttl: 60 * 1000 });
     latest = new Map();
     labels = new Map();
@@ -71,7 +62,7 @@ class GiteaTaskStoragePlugin {
     depends = new LRUCache({ max: 1024, ttl: 60 * 1000 });
     loads = new LRUCache({ max: 256, ttl: 2 * 1000 });
     constructor(ctx) {
-        this.ctx = ctx;
+        super(ctx, "repositories", now);
         const options = ctx.options;
         const token = options.token ?? process.env.GITEA_TOKEN ?? "";
         if (typeof token !== "string" || token === "")
@@ -147,27 +138,6 @@ class GiteaTaskStoragePlugin {
                 return out;
         }
     }
-    /*  the storage lifecycle: polling for changes while opened and observed
-        (without keeping the process alive)  */
-    async open() {
-        this.opened = now();
-        if (this.poll > 0 && this.listener !== null) {
-            this.timer = setInterval(() => {
-                this.pollAll().catch(() => { });
-            }, this.poll * 1000);
-            this.timer.unref();
-        }
-        this.ctx.log("debug", `opened ${this.repos.size} repositories on ${this.url} (polling every ${this.poll}s)`);
-    }
-    async close() {
-        if (this.timer !== null)
-            clearInterval(this.timer);
-        this.timer = null;
-    }
-    /*  observe the changes of the issues made outside of this plugin instance  */
-    watch(listener) {
-        this.listener = listener;
-    }
     /*  ==== project registry ====  */
     /*  the repository of a project  */
     repo(prjId) {
@@ -240,15 +210,6 @@ class GiteaTaskStoragePlugin {
     async seqmark(loc, entry, fresh = false) {
         return Math.max(await this.latestNumber(loc, fresh), entry?.seqmark ?? 0);
     }
-    async projectList() {
-        const out = [];
-        for (const prjId of this.repos.keys()) {
-            const entry = await this.projectGet(prjId);
-            if (entry !== null)
-                out.push(entry);
-        }
-        return out;
-    }
     /*  get a project, with the sequence number high-water mark as the next
         allocated task id is the one of the next created issue  */
     async projectGet(prjId) {
@@ -606,30 +567,6 @@ class GiteaTaskStoragePlugin {
         throw new Error(`task "${oldId}" cannot be renamed to "${newId}", as task ids are Gitea issue numbers`);
     }
     /*  ==== change detection ====  */
-    /*  the change detection state of a project (starting at the opening time)  */
-    pollState(prjId) {
-        let state = this.polls.get(prjId);
-        if (state === undefined) {
-            state = { since: this.opened, seen: new Map() };
-            this.polls.set(prjId, state);
-        }
-        return state;
-    }
-    /*  poll all registered projects, never overlapping itself  */
-    async pollAll() {
-        if (this.polling)
-            return;
-        this.polling = true;
-        try {
-            for (const prjId of this.repos.keys())
-                await this.pollProject(prjId).catch((err) => {
-                    this.ctx.log("warning", `polling project "${prjId}" failed: ${err instanceof Error ? err.message : String(err)}`);
-                });
-        }
-        finally {
-            this.polling = false;
-        }
-    }
     /*  poll the issues of a project updated since the last poll (Gitea supports no
         conditional requests), and report the issues not seen at their update time yet:
         as added if created after the opening, else as updated (issues deleted on Gitea

package/dst/ase-task-store-plugin-github.js

@@ -60,18 +60,9 @@ const inRepo = (loc, issue) => {
     the attachments onto the issue comments (where "Group" and "After" fall back
     onto "ase:Group:<id>" resp. "ase:After:<ids>" labels on instances without
     sub-issues resp. issue dependencies)  */
-class GitHubTaskStoragePlugin {
-    ctx;
+class GitHubTaskStoragePlugin extends TaskIssues.IssueTaskStoragePlugin {
     name = "github";
-    url;
     gh;
-    repos = new Map();
-    poll;
-    listener = null;
-    timer = null;
-    polling = false;
-    opened = now();
-    polls = new Map();
     registry = new LRUCache({ max: 64, ttl: 60 * 1000 });
     latest = new Map();
     labels = new Map();
@@ -80,7 +71,7 @@ class GitHubTaskStoragePlugin {
     recent = new Map();
     loads = new LRUCache({ max: 256, ttl: 2 * 1000 });
     constructor(ctx) {
-        this.ctx = ctx;
+        super(ctx, "repositories", now);
         const options = ctx.options;
         const token = options.token ?? process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN ?? "";
         if (typeof token !== "string" || token === "")
@@ -144,27 +135,6 @@ class GitHubTaskStoragePlugin {
             throw err;
         });
     }
-    /*  the storage lifecycle: polling for changes while opened and observed
-        (without keeping the process alive)  */
-    async open() {
-        this.opened = now();
-        if (this.poll > 0 && this.listener !== null) {
-            this.timer = setInterval(() => {
-                this.pollAll().catch(() => { });
-            }, this.poll * 1000);
-            this.timer.unref();
-        }
-        this.ctx.log("debug", `opened ${this.repos.size} repositories on ${this.url} (polling every ${this.poll}s)`);
-    }
-    async close() {
-        if (this.timer !== null)
-            clearInterval(this.timer);
-        this.timer = null;
-    }
-    /*  observe the changes of the issues made outside of this plugin instance  */
-    watch(listener) {
-        this.listener = listener;
-    }
     /*  ==== project registry ====  */
     /*  the repository of a project  */
     repo(prjId) {
@@ -222,15 +192,6 @@ class GitHubTaskStoragePlugin {
             throw err;
         }
     }
-    async projectList() {
-        const out = [];
-        for (const prjId of this.repos.keys()) {
-            const entry = await this.projectGet(prjId);
-            if (entry !== null)
-                out.push(entry);
-        }
-        return out;
-    }
     /*  get a project, with the highest issue number as the sequence number high-water
         mark, so the next allocated task id is the one of the next created issue  */
     async projectGet(prjId) {
@@ -618,30 +579,6 @@ class GitHubTaskStoragePlugin {
         throw new Error(`task "${oldId}" cannot be renamed to "${newId}", as task ids are GitHub issue numbers`);
     }
     /*  ==== change detection ====  */
-    /*  the change detection state of a project (starting at the opening time)  */
-    pollState(prjId) {
-        let state = this.polls.get(prjId);
-        if (state === undefined) {
-            state = { since: this.opened, seen: new Map() };
-            this.polls.set(prjId, state);
-        }
-        return state;
-    }
-    /*  poll all registered projects, never overlapping itself  */
-    async pollAll() {
-        if (this.polling)
-            return;
-        this.polling = true;
-        try {
-            for (const prjId of this.repos.keys())
-                await this.pollProject(prjId).catch((err) => {
-                    this.ctx.log("warning", `polling project "${prjId}" failed: ${err instanceof Error ? err.message : String(err)}`);
-                });
-        }
-        finally {
-            this.polling = false;
-        }
-    }
     /*  poll the issues of a project updated since the last poll, conditionally
         via the entity tag of the last poll (a "304" answer is free of rate limit),
         and report the issues not seen at their update time yet: as added if created

package/dst/ase-task-store-plugin-gitlab.js

@@ -38,10 +38,8 @@ const live = (issue) => (issue.issue_type ?? "issue") === "issue" && !issue.labe
     "Created"/"Modified" onto the issue timestamps, any other key (including "Group",
     as GitLab has no parent issues) onto "ase:<key>:<value>" labels, and the attachments
     onto the issue notes  */
-class GitLabTaskStoragePlugin {
-    ctx;
+class GitLabTaskStoragePlugin extends TaskIssues.IssueTaskStoragePlugin {
     name = "gitlab";
-    url;
     token;
     source;
     issues;
@@ -51,13 +49,6 @@ class GitLabTaskStoragePlugin {
     milestones;
     members;
     users;
-    repos = new Map();
-    poll;
-    listener = null;
-    timer = null;
-    polling = false;
-    opened = now();
-    polls = new Map();
     registry = new LRUCache({ max: 64, ttl: 60 * 1000 });
     latest = new Map();
     titles = new Map();
@@ -67,7 +58,7 @@ class GitLabTaskStoragePlugin {
     recent = new Map();
     loads = new LRUCache({ max: 256, ttl: 2 * 1000 });
     constructor(ctx) {
-        this.ctx = ctx;
+        super(ctx, "projects", now);
         const options = ctx.options;
         const token = options.token ?? process.env.GITLAB_TOKEN ?? "";
         if (typeof token !== "string" || token === "")
@@ -132,27 +123,6 @@ class GitLabTaskStoragePlugin {
             }
         });
     }
-    /*  the storage lifecycle: polling for changes while opened and observed
-        (without keeping the process alive)  */
-    async open() {
-        this.opened = now();
-        if (this.poll > 0 && this.listener !== null) {
-            this.timer = setInterval(() => {
-                this.pollAll().catch(() => { });
-            }, this.poll * 1000);
-            this.timer.unref();
-        }
-        this.ctx.log("debug", `opened ${this.repos.size} projects on ${this.url} (polling every ${this.poll}s)`);
-    }
-    async close() {
-        if (this.timer !== null)
-            clearInterval(this.timer);
-        this.timer = null;
-    }
-    /*  observe the changes of the issues made outside of this plugin instance  */
-    watch(listener) {
-        this.listener = listener;
-    }
     /*  ==== project registry ====  */
     /*  the GitLab project path of a project  */
     repo(prjId) {
@@ -224,15 +194,6 @@ class GitLabTaskStoragePlugin {
             this.latest.set(path, { etag: r.etag, number, at: Date.now() });
         return number;
     }
-    async projectList() {
-        const out = [];
-        for (const prjId of this.repos.keys()) {
-            const entry = await this.projectGet(prjId);
-            if (entry !== null)
-                out.push(entry);
-        }
-        return out;
-    }
     /*  get a project, with the highest issue number as the sequence number high-water
         mark, so the next allocated task id is the one of the next created issue  */
     async projectGet(prjId) {
@@ -596,30 +557,6 @@ class GitLabTaskStoragePlugin {
         throw new Error(`task "${oldId}" cannot be renamed to "${newId}", as task ids are GitLab issue numbers`);
     }
     /*  ==== change detection ====  */
-    /*  the change detection state of a project (starting at the opening time)  */
-    pollState(prjId) {
-        let state = this.polls.get(prjId);
-        if (state === undefined) {
-            state = { since: this.opened, seen: new Map() };
-            this.polls.set(prjId, state);
-        }
-        return state;
-    }
-    /*  poll all registered projects, never overlapping itself  */
-    async pollAll() {
-        if (this.polling)
-            return;
-        this.polling = true;
-        try {
-            for (const prjId of this.repos.keys())
-                await this.pollProject(prjId).catch((err) => {
-                    this.ctx.log("warning", `polling project "${prjId}" failed: ${err instanceof Error ? err.message : String(err)}`);
-                });
-        }
-        finally {
-            this.polling = false;
-        }
-    }
     /*  poll the issues of a project updated since the last poll, conditionally via
         the entity tag of the last poll (a "304" answer still counts against the rate
         limit of GitLab), and report the issues not seen at their update time yet: as

package/dst/ase-util-diagram.js

@@ -6,7 +6,7 @@
 import fs from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { z } from "zod";
-import { readStdin } from "./ase-lib-stdio.js";
+import { readStdin, writeStdout } from "./ase-lib-stdio.js";
 /*  custom argument parser for Commander: non-negative integer  */
 const parseInteger = (name) => (value) => {
     const n = Number.parseInt(value, 10);
@@ -115,7 +115,7 @@ const visibleWidth = (line) => {
     }
     return visible;
 };
-/*  reusable functionality: Mermaid diagram rendering as Unicode/ASCII art  */
+/*  reusable functionality: Mermaid and D2 diagram rendering as Unicode/ASCII art or SVG  */
 export class Diagram {
     static detectTermDimension(envVar, stdoutProp) {
         let value = 0;
@@ -331,9 +331,7 @@ export default class DiagramCommand {
                 await Diagram.dispose();
             }
             /*  output diagram rendering  */
-            process.stdout.write(out);
-            if (!out.endsWith("\n"))
-                process.stdout.write("\n");
+            await writeStdout(out.endsWith("\n") ? out : `${out}\n`);
         });
     }
 }

package/dst/man/ase-agent-adhoc.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-ADHOC" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-ADHOC" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-adhoc\fR - Run an Ad-Hoc Agent of a Definition Given by Options
 .SH "SYNOPSIS"

package/dst/man/ase-agent-condenser.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-CONDENSER" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-CONDENSER" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-condenser\fR - Plan Condensing Agent
 .SH "SYNOPSIS"

package/dst/man/ase-agent-editor.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-EDITOR" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-EDITOR" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-editor\fR - Edit Request Agent
 .SH "SYNOPSIS"

package/dst/man/ase-agent-estimator.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-ESTIMATOR" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-ESTIMATOR" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-estimator\fR - Effort Estimation Agent
 .SH "SYNOPSIS"

package/dst/man/ase-agent-fleet.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-FLEET" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-FLEET" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-fleet\fR - Manage a Fleet of Agents
 .SH "SYNOPSIS"

package/dst/man/ase-agent-implementer.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-IMPLEMENTER" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-IMPLEMENTER" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-implementer\fR - Implementation Phase Agent
 .SH "SYNOPSIS"

package/dst/man/ase-agent-integrator.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-INTEGRATOR" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-INTEGRATOR" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-integrator\fR - Integration Phase Agent
 .SH "SYNOPSIS"

package/dst/man/ase-agent-qualifier.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-QUALIFIER" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-QUALIFIER" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-qualifier\fR - Qualification Phase Agent
 .SH "SYNOPSIS"

package/dst/man/ase-agent-rebooter.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-REBOOTER" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-REBOOTER" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-rebooter\fR - Plan Rebooting Agent
 .SH "SYNOPSIS"

package/dst/man/ase-agent-relay.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-RELAY" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-RELAY" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-relay\fR - Manage the Agent Relay Server
 .SH "SYNOPSIS"

package/dst/man/ase-agent-researcher.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT-RESEARCHER" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT-RESEARCHER" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent-researcher\fR - Research Agent
 .SH "SYNOPSIS"

package/dst/man/ase-agent.1

@@ -1,4 +1,4 @@
-.TH "ASE-AGENT" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-AGENT" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-agent\fR - Autonomous Task Lifecycle Agents
 .SH "SYNOPSIS"

package/dst/man/ase-artifact-list.1

@@ -1,4 +1,4 @@
-.TH "ASE-ARTIFACT-LIST" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-ARTIFACT-LIST" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-artifact-list\fR - Resolve Artifact Kinds to Project-Relative File Paths
 .SH "SYNOPSIS"

package/dst/man/ase-artifact-name.1

@@ -1,4 +1,4 @@
-.TH "ASE-ARTIFACT-NAME" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-ARTIFACT-NAME" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-artifact-name\fR - Resolve a Filename within an Artifact Kind
 .SH "SYNOPSIS"

package/dst/man/ase-artifact.1

@@ -1,4 +1,4 @@
-.TH "ASE-ARTIFACT" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-ARTIFACT" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-artifact\fR - Resolve Project Artifact Kinds to File Lists
 .SH "SYNOPSIS"

package/dst/man/ase-config-delete.1

@@ -1,4 +1,4 @@
-.TH "ASE-CONFIG-DELETE" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-CONFIG-DELETE" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-config-delete\fR - Delete a Configuration Value
 .SH "SYNOPSIS"

package/dst/man/ase-config-edit.1

@@ -1,4 +1,4 @@
-.TH "ASE-CONFIG-EDIT" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-CONFIG-EDIT" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-config-edit\fR - Edit the Configuration File with an Editor
 .SH "SYNOPSIS"

package/dst/man/ase-config-get.1

@@ -1,4 +1,4 @@
-.TH "ASE-CONFIG-GET" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-CONFIG-GET" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-config-get\fR - Print a Configuration Value
 .SH "SYNOPSIS"

package/dst/man/ase-config-init.1

@@ -1,4 +1,4 @@
-.TH "ASE-CONFIG-INIT" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-CONFIG-INIT" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-config-init\fR - Initialize Configuration with Preset Values
 .SH "SYNOPSIS"

package/dst/man/ase-config-list.1

@@ -1,4 +1,4 @@
-.TH "ASE-CONFIG-LIST" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-CONFIG-LIST" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-config-list\fR - List the Effective Configuration
 .SH "SYNOPSIS"

package/dst/man/ase-config-set.1

@@ -1,4 +1,4 @@
-.TH "ASE-CONFIG-SET" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-CONFIG-SET" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-config-set\fR - Set a Configuration Value
 .SH "SYNOPSIS"

package/dst/man/ase-config.1

@@ -1,4 +1,4 @@
-.TH "ASE-CONFIG" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-CONFIG" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-config\fR - Manage the Layered ASE Configuration
 .SH "SYNOPSIS"
@@ -120,6 +120,12 @@ list\fR.
 \fBproject.relay.crt\fR, \fBproject.relay.key\fR (\fIstring\fR): The PEM certificate (chain) and private key files of the agent relay server, relative to the directory of the configuration file defining them.
 .RE 0
 .P
+Per-project service:
+.RS 0
+.IP \(bu 4
+\fBproject.service.port\fR (\fIport\fR \fB1024\fR..\fB65535\fR, \fBproject\fR scope only): The preferred port of the per-project background service on \fB127.0.0.1\fR, falling back to a random port out of the range \fB42000\fR..\fB44000\fR if unavailable (default: none). See \fBase-service-start\fR(1).
+.RE 0
+.P
 Project artifacts (all writable on the \fBuser\fR and \fBproject\fR scopes only), each kind defined by a \fBbasedir\fR directory (relative to the project root, empty for the root itself) and a whitespace-separated \fBfiles\fR glob specification (relative to \fBbasedir\fR, with \fB!\fR negating a glob). See \fBase-artifact\fR(1):
 .RS 0
 .IP \(bu 4

package/dst/man/ase-hook-permission-request.1

@@ -1,4 +1,4 @@
-.TH "ASE-HOOK-PERMISSION-REQUEST" "1" "October 2026" "2.0.0" "Agentic Software Engineering (ASE)"
+.TH "ASE-HOOK-PERMISSION-REQUEST" "1" "October 2026" "2.0.2" "Agentic Software Engineering (ASE)"
 .SH "NAME"
 \fBase-hook-permission-request\fR - Handle the PermissionRequest Hook Event
 .SH "SYNOPSIS"