@rse/ase 0.9.26 → 0.9.28

package/package.json

@@ -6,7 +6,7 @@
     "homepage":                             "http://github.com/rse/ase",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
     "bugs":                                 { "url": "http://github.com/rse/ase/issues" },
-    "version":                              "0.9.26",
+    "version":                              "0.9.28",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -18,20 +18,20 @@
     "devDependencies": {
         "eslint":                           "9.39.4",
         "@eslint/js":                       "9.39.4",
-        "@typescript-eslint/parser":        "8.61.1",
-        "@typescript-eslint/eslint-plugin": "8.61.1",
+        "@typescript-eslint/parser":        "8.62.0",
+        "@typescript-eslint/eslint-plugin": "8.62.0",
         "eslint-plugin-promise":            "7.3.0",
         "eslint-plugin-import":             "2.32.0",
         "neostandard":                      "0.13.0",
-        "globals":                          "17.6.0",
+        "globals":                          "17.7.0",
         "typescript":                       "6.0.3",
 
         "@rse/stx":                         "1.1.6",
         "nodemon":                          "3.1.14",
         "shx":                              "0.4.0",
 
-        "@types/node":                      "25.9.3",
-        "@types/luxon":                     "3.7.1",
+        "@types/node":                      "26.0.1",
+        "@types/luxon":                     "3.7.2",
         "@types/which":                     "3.0.4",
         "@types/update-notifier":           "6.0.8",
         "@types/shell-quote":               "1.7.5",
@@ -42,7 +42,7 @@
     },
     "dependencies": {
         "commander":                        "15.0.0",
-        "@dotenvx/dotenvx":                 "1.73.1",
+        "@dotenvx/dotenvx":                 "1.75.1",
         "yaml":                             "2.9.0",
         "valibot":                          "1.4.1",
         "execa":                            "9.6.1",
@@ -57,7 +57,7 @@
         "zod":                              "4.4.3",
         "which":                            "7.0.0",
         "update-notifier":                  "7.3.1",
-        "shell-quote":                      "1.8.4",
+        "shell-quote":                      "1.9.0",
         "get-stdin":                        "10.0.0",
         "proper-lockfile":                  "4.1.2",
         "write-file-atomic":                "8.0.0",

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

@@ -1,6 +1,6 @@
 {
     "name":        "ase",
-    "version":     "0.9.26",
+    "version":     "0.9.28",
     "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":     "0.9.26",
+    "version":     "0.9.28",
     "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":     "0.9.26",
+    "version":     "0.9.28",
     "description": "Agentic Software Engineering (ASE)",
     "keywords":    [ "agentic", "software", "engineering" ],
     "homepage":    "https://ase.tools",

package/plugin/etc/eslint.mjs

@@ -18,7 +18,8 @@ export default defineConfig([
         ],
         rules: {
             "md/no-double-space":     "off",
-            "md/code-lang-shorthand": "off"
+            "md/code-lang-shorthand": "off",
+            "md/no-irregular-dash":   "off"
         }
     }
 ])

package/plugin/meta/ase-control.md

@@ -87,3 +87,11 @@ Control Flow Constructs
     repetition of <for-body/>. A <break/> in <for-body/> can stop the
     repetition early. Do not output anything else.
 
+-   *IMPORTANT*: You *MUST* honor the following control flow construct:
+    <break/>:
+
+    This specifies an *early termination* of the innermost enclosing
+    <while/> or <for/> repetition: when reached, the current repetition
+    is finished and no further repetitions are performed. This construct
+    is expanded into nothing. Do not output anything else.
+

package/plugin/meta/ase-dialog.md

@@ -75,6 +75,10 @@ Let the *user interactively choose* an answer.
 
         3.  Check the tool result and dispatch accordingly:
 
+            -   If <result/> already starts with `ERROR:` (set by the
+                guard in step 2.1 above), keep <result/> unchanged and
+                *SKIP* all remaining dispatch in this step.
+
             -   If the tool result contains `user doesn't want to proceed`,
                 `tool use was rejected`, or `user declined to answer
                 questions`, or the result clearly indicates that the
@@ -124,17 +128,27 @@ Let the *user interactively choose* an answer.
 
         3.  Check the tool result and dispatch accordingly:
 
+            -   If <result/> already starts with `ERROR:` (set by the
+                guard in step 2.1 above), keep <result/> unchanged and
+                *SKIP* all remaining dispatch in this step.
+
             -   If the tool result contains `User skipped question`
                 or the result clearly indicates that the
                 dialog was cancelled, rejected or skipped, set
                 <result>CANCEL</result>.
 
-            -   Otherwise, extract the selected answer from the tool result
-                set <result/> accordingly. If <result/> is of the
-                expected format `<label/>: <description/>`, set
-                <result><label/></result> (set result to label). Else,
-                if <result/> is NOT of the expected format `<label/>:
-                <description/>`, set <result>OTHER: <result/></result>
+            -   Otherwise, extract the selected answer from the tool
+                result and set <result/> accordingly. The harness may
+                return either the full `<label/>: <description/>` line or
+                just the bare `<label/>`. Determine the selected
+                <label/> by mapping the <result/> to one of the answer
+                labels parsed from <spec/> (lines 2 and following): if
+                <result/> is of the format `<label/>: <description/>`,
+                take its `<label/>` part; otherwise, if <result/> already
+                equals one of the answer labels, take it as-is. Set
+                <result><label/></result>. If <result/> is then NOT one
+                of the answer labels parsed from <spec/>, set
+                <result>OTHER: <result/></result>
                 (prefix result with "OTHER").
 
             Do not output anything in this step!
@@ -219,11 +233,18 @@ following procedure:
             </else>
         </for>
 
+        <if condition="<keys/> is empty">
+            Set <keys>**CANCEL**</keys>.
+        </if>
+        <else>
+            Set <keys><keys/>/**CANCEL**</keys>.
+        </else>
+
         <if condition="<opts/> contains `--other`">
-            Set <hint>Please choose *one* option by typing <keys/>/**CANCEL**, or other free-text instruction.</hint>.
+            Set <hint>Please choose *one* option by typing <keys/>, or other free-text instruction.</hint>.
         </if>
         <else>
-            Set <hint>Please choose *one* option by typing <keys/>/**CANCEL**.</hint>.
+            Set <hint>Please choose *one* option by typing <keys/>.</hint>.
         </else>
 
         Set:
@@ -255,6 +276,10 @@ following procedure:
     3.  Do not output anything in this step!
         Check the <result/> and dispatch accordingly:
 
+        0.  If <result/> already starts with `ERROR:` (set by the
+            guard in step 2.1 above), keep <result/> unchanged and
+            *SKIP* all remaining sub-steps 3.1-3.3 of this dispatch.
+
         1.  If <result/> is `cancel`, `CANCEL`, `reject`, `REJECT`, or
             otherwise indicates that the user doesn't want to proceed,
             or the user declined to answer the question, or that
@@ -274,7 +299,9 @@ following procedure:
             </if>
             <else>
                 Output the following <template/> and then *START OVER*
-                by *GOING* to step 2.2 above.
+                by *GOING* to step 2.2 above, reusing the already-built
+                <text/> from step 2.1 unchanged (do *NOT* re-enter step 2.1
+                and do *NOT* rebuild <text/>, <keys/>, <n/>, or <width/>).
 
                 <template>
                 ⧉ **ASE**: ERROR: **Invalid option selected!**

package/plugin/meta/ase-format-meta.md

@@ -23,8 +23,15 @@ Artifact Meta Information
 
     -   `Tasks` (`TASK`), aka "Task Plans", "Issues", or "User Stories".
 
+    -   `Infrastructure` (`INFR`), aka "Infrastructure as Code (IaC)",
+        "Deployment", or "Operations".
+
+    -   `Other` (`OTHR`), the implicit catch-all for any artifacts not
+        covered by the other **Artifact Set**s.
+
     Each **Artifact Set** has a unique identifier <artifact-set-id/>,
-    which is one of `SPEC`, `ARCH`, `CODE`, `DOCS`, or `TASK`.
+    which is one of `SPEC`, `ARCH`, `CODE`, `DOCS`, `TASK`, `INFR`, or
+    `OTHR`.
 
 -   **Artifact**:
 
@@ -88,3 +95,9 @@ The exported file is stored *side-by-side* with the **Artifact** under
 the path:
 
 `<basedir/>/<artifact-set-id/>-<artifact-no/>-<artifact-id/>-<artifact-slug/>-<export-name/>.<export-ext/>`
+
+where <artifact-slug/> is the same slug used in the **Artifact**'s own
+file name -- derived from the **Artifact** name by Pascal-casing each
+word and joining the words with `-` characters (e.g. `Customer-Journey`)
+-- as defined by the **Artifact Set**'s own format definition (see
+`ase-format-spec.md` and `ase-format-arch.md`).

package/plugin/meta/ase-format-spec.md

@@ -662,7 +662,7 @@ manages, defining how information is organized and connected.
 
          -   `Attribute`     (`**<spec-dm-attribute-id/>**`)
          -   `Type`          (`<spec-dm-attribute-qualifier/><spec-dm-attribute-type/>`)
-         -   `Description`   (`<spec-dm-relation-description/>, **BECAUSE** <spec-dm-relation-rationale/>.`)
+         -   `Description`   (`<spec-dm-attribute-description/>, **BECAUSE** <spec-dm-attribute-rationale/>.`)
 
     -    <export-table-2/> is a Markdown table for the relation with one
          row per <spec-dm-relation-id/>, sorted by <spec-dm-relation-id/> --
@@ -672,6 +672,9 @@ manages, defining how information is organized and connected.
          -   `Target`        (`[<spec-dm-relation-target/>](#<spec-dm-relation-target-id/>) (<spec-dm-relation-cardinality/>)`)
          -   `Description`   (`<spec-dm-relation-description/>, **BECAUSE** <spec-dm-relation-rationale/>.`)
 
+    -    In case a <spec-dm-entity/> has no relations at all, the
+         entire `### RELATIONS` block (including <export-table-2/>) is omitted.
+
 -   Export: `export.svg`
 
     The entities, their attributes and their relations are
@@ -679,7 +682,7 @@ manages, defining how information is organized and connected.
     converted to SVG. For this, each <spec-dm-entity/> becomes
     a class whose members are the `<spec-dm-attribute-id/>:
     <spec-dm-attribute-qualifier/><spec-dm-attribute-type/>` attributes,
-    and each <spec-dm-relation/> becomes a directed association
+    and each <spec-dm-relation-id/> becomes a directed association
     labeled with its <spec-dm-relation-id/> and annotated with its
     <spec-dm-relation-cardinality/> at the target end.
 

package/plugin/meta/ase-persona.md

@@ -3,9 +3,13 @@ Persona Communication Style
 ---------------------------
 
 *IMPORTANT*: The communication style in your outputs *MUST* in all cases
-follow the following conditional rules. Re-evaluate and internalize them
-for each value change of <ase-persona-style/> in order to strictly honor
-the requested communication style at any time during a session.
+follow the following conditional rules. Re-evaluate and internalize
+them for each value change of <ase-persona-style/> in order to strictly
+honor the requested communication style at any time during a session.
+If <ase-persona-style/> is neither `writer`, `engineer`, `telegrapher`,
+nor `caveman`, treat it as `engineer`. In the ordered list of personas
+`writer`, `engineer`, `telegrapher`, and `caveman`, each following
+persona uses a more terse communication style than the previous one.
 
 -   If <ase-persona-style/> is `writer`:
     -   You *MUST* use the decorative, eloquent, and explaining communication style of a *writer*.
@@ -28,9 +32,10 @@ the requested communication style at any time during a session.
         ("sure", "certainly", "of course", "happy to", etc).
     -   You *MUST* *drop* hedging
         ("I think", "maybe", "perhaps", "it seems", "sort of",
-        "probably", "I'm not sure but...", "it might be", etc).
+        "probably", "I'm not sure but", "it might be", etc).
+-   If <ase-persona-style/> is `engineer` or `telegrapher`:
     -   You *MUST* *prefer* lists with bullet points, instead of long prose paragraphs.
-    -   You *MUST* *prefer* bullet points with one or two sentences.
+    -   You *MUST* *prefer* bullet points with just one or two sentences.
 
 -   If <ase-persona-style/> is `telegrapher` or `caveman`:
     -   You *MUST* *use* shorter synonyms
@@ -40,20 +45,21 @@ the requested communication style at any time during a session.
     -   You *MUST* *use* arrows for causality
         ("X → Y").
     -   You *MUST* *use* em-dashes for short subsequent facts
-        ("X - Y").
+        ("X — Y").
     -   You *MUST* *drop* articles
         ("a", "an", "the", etc).
     -   You *MUST* *use* short separate sentences instead of conjunctions
-        ("and", "but", "or", "so", "because", "however", "therefore", "although").
+        ("and", "but", "or", "so", "because", "however", "therefore", "although", etc).
     -   You *MUST* *drop* all fluff in wording.
 
 -   If <ase-persona-style/> is `caveman`:
-    -   You *MUST* *use* only one word, when one word is clear enough.
-    -   You *MUST* *use* only two words, when two words are clear enough.
-    -   You *MUST* *use* the three sentence patterns
+    -   You *MUST* *use* only one word, when one word is expressive enough.
+    -   You *MUST* *use* only two words, when two words are expressive enough.
+    -   You *MUST* *use* the following three sentence patterns
+        when one or two words are not expressive enough
         (depending on what information has to be expressed):
-        -   `<subject/> <action/> <object/>, <reason/>.` → e.g. "Cat eats fish, hungry."
-        -   `<subject/> <action/> <object/>.`            → e.g. "Dog chases ball."
-        -   `<subject/> <action/>.`                      → e.g. "Birds fly."
+        -   `<subject/> <action/> <object/>, <reason/>.` → e.g. `Cat eats fish, hungry.`
+        -   `<subject/> <action/> <object/>.`            → e.g. `Dog chases ball.`
+        -   `<subject/> <action/>.`                      → e.g. `Birds fly.`
     -   You *MUST* *drop* all lists and their bullet points and instead
         provide very short subsequent sentences only.

package/plugin/meta/ase-skill.md

@@ -130,8 +130,9 @@ Skill Sequential Processing
     no longer at hand.
 
     Then establish the strict order explicitly by chaining the created
-    tasks with `TaskUpdate`: for each <step/> after the first one,
-    resolve <this/> and <prev/> to the mapped `taskId` values and
+    tasks with `TaskUpdate`: for each <step/> after the first one, set
+    <this/> to the mapped taskId of this step and <prev/> to the mapped
+    taskId of the predecessor step from the reconstructed mapping, and
     call `TaskUpdate({ taskId: "<this/>", addBlockedBy: [ "<prev/>" ]
     })` so that every step (with `taskId` <this/>) is blocked by its
     predecessor step (with `taskId` <prev/>).
@@ -249,7 +250,7 @@ Template Patterns
 
     <template>
 
-    ╭──────────────────────────────────────────────────────────────────────┈┈┈┈┈┈┈┈┈┈
+    ╭────────────────────────────────────────────────────────────────────┈┈┈┈┈┈┈┈┈
 
     </template>
 
@@ -271,17 +272,16 @@ Template Patterns
 
     <template>
 
-    ╰──────────────────────────────────────────────────────────────────────┈┈┈┈┈┈┈┈┈┈
+    ╰───────────────────────────────────────────────────────────────────┈┈┈┈┈┈┈┈┈┈
 
     </template>
 
 -   When `<ase-tpl-foot title="<title/>"/>` should be expanded, use
     (where <raw-title/> is the visible un-styled text `⧉ ASE: <title/>`,
-    <raw-title-len/> is the number of characters in <raw-title/>, and
-    <bar/> is the `─` character repeated exactly max(0, 67 - <raw-title-len/>)
-    times -- clamped to zero so an over-long title never yields a negative
-    count -- the very same bar-width rule as `<ase-tpl-head/>` and
-    `<ase-tpl-boxed/>`, so equal visible text yields equal total width):
+    <raw-title-len/> is the number of characters in <raw-title/>,
+    and <bar/> is the `─` character repeated exactly max(0, 67 -
+    <raw-title-len/>) times -- clamped to zero so an over-long title
+    never yields a negative count.
 
     <template>
 
@@ -317,9 +317,7 @@ Template Patterns
     -   Set <raw-title-len/> to the number of characters in the visible
         un-styled text <raw-title/>.
     -   Set <bar/> to the `─` character repeated exactly max(0, 67 - <raw-title-len/>)
-        times -- clamped to zero so an over-long title never yields a negative
-        count -- the very same bar-width rule as `<ase-tpl-head/>` and
-        `<ase-tpl-foot/>`, so equal visible text yields equal total width.
+        times -- clamped to zero so an over-long title never yields a negative count.
     -   Set <body/> to <content/> with all line-starts prefixed with `│ `.
 
     <template>

package/plugin/meta/ase-tenets.md

@@ -121,7 +121,7 @@ RECONCILIATION TENETS
 ---------------------
 
 When *reconcile* a set of target artifacts to a set of source artifacts,
-you *MUST* honor the following so-called **ALIGNING TENETS**:
+you *MUST* honor the following so-called **RECONCILIATION TENETS**:
 
 -   **Directional Authority**:
     The *source* artifacts are the single source of truth; only the

package/plugin/package.json

@@ -6,7 +6,7 @@
     "homepage":                             "http://github.com/rse/ase",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
     "bugs":                                 { "url": "http://github.com/rse/ase/issues" },
-    "version":                              "0.9.26",
+    "version":                              "0.9.28",
     "license":                              "GPL-3.0-only",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",