@rse/ase 2.0.7 → 2.0.8

package/plugin/skills/ase-task-grill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-task-grill
-argument-hint: "[--help|-h] [--rounds|-r <n>] [--until|-u MUST|SHOULD|MAY] [--perspective|-p <perspective>] [--ground|-G] [--focus|-f <section>[,...]] [--force|-F] [--next|-n <option>[,...]] [<id>]"
+argument-hint: "[--help|-h] [--rounds|-r <n>] [--until|-u MUST|SHOULD|MAY] [--perspective|-p <perspective>] [--ground|-G] [--focus|-f <section>[,...]] [--force|-F] [--quiet|-q] [--next|-n <option>[,...]] [<id>]"
 description: >
     Interview the user relentlessly about the task plan until reaching a
     shared understanding, resolving each branch of the question decision
@@ -22,7 +22,7 @@ Iteratively Grill a Task Plan
 
 <expand name="getopt"
     arg1="ase-task-grill"
-    arg2="--rounds|-r=1 --until|-u=(MUST|SHOULD|MAY) --perspective|-p= --ground|-G --focus|-f=(all|SPECIFICATION|SPEC|DESIGN|DES|VERIFICATION|VER)... --force|-F --next|-n=(none|DONE|GRILL|EDIT|IMPLEMENT|DRAFT)... --int-reuse-task">
+    arg2="--rounds|-r=1 --until|-u=(MUST|SHOULD|MAY) --perspective|-p= --ground|-G --focus|-f=(all|SPECIFICATION|SPEC|WHAT|DESIGN|DES|HOW|VERIFICATION|VERIFY|VER|WHEN)... --force|-F --quiet|-q --next|-n=(none|DONE|GRILL|EDIT|IMPLEMENT|DRAFT)... --int-reuse-task --int-interactive">
     $ARGUMENTS
 </expand>
 
@@ -61,23 +61,9 @@ Set <args>--int-reuse-task</args>.
         ⧉ **ASE**: ☻ skill: **ase-task-grill**, ▶ ERROR: invalid `--rounds` value: **<getopt-option-rounds/>**
         </template>
 
-    3.  Treat <getopt-option-focus/> as a comma-separated list of
-        *section tokens*. Trim and upper-case every token, then expand
-        the abbreviations `SPEC`, `DES`, and `VER` to `SPECIFICATION`,
-        `DESIGN`, and `VERIFICATION`, and expand the sentinel `ALL`
-        (the default) to `SPECIFICATION,DESIGN,VERIFICATION`. Set
-        <sections/> to the resulting list, *keeping the given order*.
-        The getopt parser validates only the *first* token, so you
-        *MUST* validate each token yourself: if any token is *empty*,
-        *not* one of the recognized sections or abbreviations, or
-        results in a section already present in <sections/>, bind
-        <token/> to that offending token, then only output the
-        following <template/> and immediately *STOP* processing the
-        entire current skill:
+    3.  Resolve the plan sections under focus:
 
-        <template>
-        ⧉ **ASE**: ☻ skill: **ase-task-grill**, ▶ ERROR: invalid `--focus` token: **<token/>**
-        </template>
+        <expand name="task-focus" arg1="ase-task-grill"></expand>
 
         Each section in <sections/> selects its *focus areas* of the
         grilling: `SPECIFICATION` selects `DOMAIN` and `INTERFACE`,
@@ -277,7 +263,19 @@ Set <args>--int-reuse-task</args>.
                 can re-ask it.
 
             Set <changes/> to all bullet-points of <task-content/> which
-            were changed or added in this round. Do not output anything.
+            were changed or added in this round. Do not output anything,
+            except for the following warning:
+
+            <if condition="<getopt-option-focus/> is not equal `all` and <changes/> contains a bullet-point of a section *not* in <sections/>">
+            An answer required a *foreign change* outside of the focus,
+            which is applied nevertheless. Set <foreign/> to the
+            comma-separated names of these sections and only output the
+            following <template/>:
+
+            <template>
+            ⧉ **ASE**: ◉ task: **<ase-task-id/>**, ▶ WARNING: changed sections outside of focus: **<foreign/>**
+            </template>
+            </if>
 
         5.  SAVE PLAN:
 
@@ -298,6 +296,7 @@ Set <args>--int-reuse-task</args>.
 
         6.  SHOW PLAN CHANGES:
 
+            <if condition="<getopt-option-quiet/> is not equal `true`">
             Set <round-suffix/> to
             ` round <m/>/<getopt-option-rounds/>` if
             <getopt-option-rounds/> is greater than 1, or to empty
@@ -316,6 +315,7 @@ Set <args>--int-reuse-task</args>.
 
             <ase-tpl-foot title="PLAN CHANGES" subtitle="after grilling<round-suffix/>"/>
             </template>
+            </if>
 
 4.  **Decide Next Step:**
 
@@ -326,7 +326,7 @@ Set <args>--int-reuse-task</args>.
             arg2="DONE|GRILL|EDIT|IMPLEMENT|DRAFT">
             Next Step: How would you like to proceed with the plan?
             DONE: Stop processing.
-            GRILL: Re-grill the entire plan again.
+            GRILL: Re-grill the plan again.
             EDIT: Hand off plan to editing.
             DRAFT: Hand off plan to implementation drafting.
             IMPLEMENT: Hand off plan to implementation.
@@ -352,6 +352,12 @@ Set <args>--int-reuse-task</args>.
             <if condition="<getopt-option-ground/> is `true`">
                 Set <args><args/> --ground</args>.
             </if>
+            <if condition="<getopt-option-quiet/> is `true`">
+                Set <args><args/> --quiet</args>.
+            </if>
+            <if condition="<getopt-option-int-interactive/> is `true`">
+                Set <args><args/> --int-interactive</args>.
+            </if>
             Only output the following <template/> and then call the
             tool `Skill(skill: "ase:ase-task-grill", args: "<args/>")`
             to invoke the `ase:ase-task-grill` skill again in order to
@@ -365,6 +371,15 @@ Set <args>--int-reuse-task</args>.
 
         -   If <result/> is `EDIT`:
             <expand name="handoff-args"/>
+            <if condition="<getopt-option-quiet/> is `true`">
+                Set <args><args/> --quiet</args>.
+            </if>
+            <if condition="<getopt-option-int-interactive/> is `true`">
+                Set <args><args/> --interactive</args>.
+            </if>
+            <if condition="<getopt-option-focus/> is not equal `all`">
+                Set <args><args/> --focus <getopt-option-focus/></args>.
+            </if>
             Only output the following <template/> and then call the
             tool `Skill(skill: "ase:ase-task-edit", args: "<args/>")`
             to invoke the `ase:ase-task-edit` skill in order to *edit*

package/plugin/skills/ase-task-grill/help.md

@@ -13,6 +13,7 @@
     [`--ground`|`-G`]
     [`--focus`|`-f` *section*[,...]]
     [`--force`|`-F`]
+    [`--quiet`|`-q`]
     [`--next`|`-n` *option*[,...]]
     [*id*]
 
@@ -61,7 +62,7 @@ persisted, its `Tags:` frontmatter key records each grilled section as
 its own tag `grilled:`*section* (lower-case, kept alongside the tags of
 previously grilled sections, e.g. `grilled:specification,
 grilled:design`), and a `PLAN CHANGES` box shows the bullet-points
-changed by the round. Finally, the user is offered a complete
+changed by the round (unless `--quiet` is given). Finally, the user is offered a complete
 re-grilling (with the same grilling options), or a hand-off to editing,
 implementation, or draft.
 
@@ -123,19 +124,28 @@ in state `[-]` (cancelled) or `[>]` (deferred) are never questioned.
 
 -   `--focus`|`-f` *section*[,...]:
     Grill only the given plan *section*(s), in the given order. Each
-    *section* is one of `SPECIFICATION` (abbreviated `SPEC`), `DESIGN`
-    (abbreviated `DES`), or `VERIFICATION` (abbreviated `VER`), matched
-    case-insensitively, or the sentinel `all` (default), which expands
-    to `SPECIFICATION,DESIGN,VERIFICATION`. The questions are derived
-    from the themes of the focused sections only, while the entire plan
-    stays the context, and the answers may still update any section.
-    An unknown, empty, or duplicate *section* token aborts the skill.
+    *section* is one of `SPECIFICATION` (also `SPEC` or `WHAT`), `DESIGN`
+    (also `DES` or `HOW`), or `VERIFICATION` (also `VERIFY`, `VER`, or
+    `WHEN`), matched case-sensitively, or the sentinel `all` (default),
+    which expands to `SPECIFICATION,DESIGN,VERIFICATION`. The questions
+    are derived from the themes of the focused sections only, while the
+    entire plan stays the context, and an answer requiring a change
+    outside of the focus is applied nevertheless and reported by a
+    warning. An unknown, empty, or duplicate *section* token aborts the
+    skill. It is forwarded on a re-grilling and on a hand-off to
+    `ase-task-edit`, but not on a hand-off to another skill.
 
 -   `--force`|`-F`:
     Re-grill already grilled sections completely, i.e., ignore their
     `grilled:`*section* tags instead of skipping them resp. re-asking
     only their `[?]` bullet-points.
 
+-   `--quiet`|`-q`:
+    Do not print the `PLAN CHANGES` box of the bullet-points changed by
+    a round. The status lines and the dialogs stay. It is forwarded on a
+    re-grilling and on a hand-off to `ase-task-edit`, but not on a
+    hand-off to another skill.
+
 -   `--next`|`-n` *option*[,...]:
     Automatically answer the user dialog for the next step (at the end
     of this skill). *option* is a single token or a *comma-separated