@rse/ase 2.0.4 → 2.0.6

package/plugin/skills/ase-code-lint/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-code-lint
-argument-hint: "[--help|-h] [--auto|-a] [--severity|-S=(AUTO|LOW|MEDIUM|HIGH)] [--include|-i=<aspect>[,...]] [--exclude|-e=<aspect>[,...]] [--staged] [--unstaged] [<source-reference>]"
+argument-hint: "[--help|-h] [--auto|-a] [--severity|-S=(AUTO|LOW|MEDIUM|HIGH)] [--force|-f] [--include|-i=<aspect>[,...]] [--exclude|-e=<aspect>[,...]] [--staged] [--unstaged] [<source-reference>]"
 description: >
     Lint source code for potential code quality problems.
     Use when the user wants to "lint" or "check" source code.
@@ -23,7 +23,7 @@ Lint Source Code
 
 <expand name="getopt"
     arg1="ase-code-lint"
-    arg2="--auto|-a --severity|-S=(AUTO|LOW|MEDIUM|HIGH) --include|-i=(none|A01|A02|A03|A04|A05|A06|A07|A08|A09|A10|A11|A12|A13|A14|A15|A16|A17|A18|A19|A20|A21)... --exclude|-e=(none|A01|A02|A03|A04|A05|A06|A07|A08|A09|A10|A11|A12|A13|A14|A15|A16|A17|A18|A19|A20|A21)... --staged --unstaged">
+    arg2="--auto|-a --severity|-S=(AUTO|LOW|MEDIUM|HIGH) --force|-f --include|-i=(none|A01|A02|A03|A04|A05|A06|A07|A08|A09|A10|A11|A12|A13|A14|A15|A16|A17|A18|A19|A20|A21)... --exclude|-e=(none|A01|A02|A03|A04|A05|A06|A07|A08|A09|A10|A11|A12|A13|A14|A15|A16|A17|A18|A19|A20|A21)... --staged --unstaged">
     $ARGUMENTS
 </expand>
 
@@ -36,11 +36,11 @@ related to a set of code quality aspects.
 
 1.  <step id="STEP 1: Investigation">
 
-    <if condition="<ase-project-boxing/> is equal `black` and <getopt-option-severity/> is equal `AUTO`">
+    <if condition="<ase-project-boxing/> is equal `black` and <getopt-option-force/> is not equal `true`">
 
     The project source artifacts are classified as a *black box*, so
     the user does *not* want them inspected or their problems surfaced
-    (an *explicitly* given severity floor lifts this skip).
+    (the `--force` option lifts this skip).
     *Skip* the entire investigation and reporting: do *not* invoke any
     `Bash`, `Glob`, or `Agent` tool and do *not* read any source, only
     output the following <template/> and then *SKIP* the remaining steps
@@ -53,9 +53,9 @@ related to a set of code quality aspects.
     </if>
 
     Set <condensed>true</condensed> if <ase-project-boxing/> is equal
-    `grey` or `black` (the latter reached only under an explicitly given
-    severity floor), and <condensed>false</condensed> otherwise: a
-    *condensed* report suppresses the full unified diffs of STEP 3.
+    `grey` and <getopt-option-force/> is not equal `true`, and
+    <condensed>false</condensed> otherwise: a *condensed* report
+    suppresses the full unified diffs of STEP 3.
 
     First, determine the *effective aspect set* <aspects/>, i.e., the
     code quality aspects which are checked at all. For this, parse
@@ -189,13 +189,13 @@ related to a set of code quality aspects.
 
     <if condition="<getopt-option-severity/> is equal `AUTO`">
     Set <floor>MEDIUM</floor> if <ase-project-boxing/> is equal `grey`
-    (grey boxing surfaces only *material* findings of severity `MEDIUM`
-    and above), and <floor>LOW</floor> otherwise.
+    and <getopt-option-force/> is not equal `true` (grey boxing surfaces
+    only *material* findings of severity `MEDIUM` and above), and
+    <floor>LOW</floor> otherwise.
     </if>
     <else>
     Set <floor><getopt-option-severity/></floor>: an *explicitly* given
-    severity floor always *wins* over the boxing, both over the `grey`
-    floor and over the `black` skip.
+    severity floor always *wins* over the `grey` boxing floor.
     </else>
 
     Then *apply the effective severity floor* <floor/>: *Keep* a problem
@@ -448,9 +448,9 @@ related to a set of code quality aspects.
 
             <if condition="<condensed/> is equal `true`">
 
-            The project source artifacts are classified as a *grey box* (or
-            *black box*), so the user does *not* want the full artifact
-            internals surfaced:
+            The project source artifacts are classified as a *grey box*,
+            so the user does *not* want the full artifact internals
+            surfaced:
             *suppress* the full unified diff and instead show only the
             *condensed* one-line-per-hunk representation. Report the
             solution with the following <template/>:
@@ -578,7 +578,7 @@ related to a set of code quality aspects.
 
         <if condition="<getopt-option-auto/> is not equal `true`">
         <ase-tpl-hint level="verbose">
-        Use `/ase-code-lint --auto` to apply all corrections unattended, `--severity` to raise the reporting floor, `--include`/`--exclude` to narrow the checked aspects, and `--staged`/`--unstaged` to lint only the changed files.
+        Use `/ase-code-lint --auto` to apply all corrections unattended, `--severity` to raise the reporting floor, `--force` to ignore the project boxing, `--include`/`--exclude` to narrow the checked aspects, and `--staged`/`--unstaged` to lint only the changed files.
         </ase-tpl-hint>
         </if>
 

package/plugin/skills/ase-code-lint/help.md

@@ -9,6 +9,7 @@
     [`--help`|`-h`]
     [`--auto`|`-a`]
     [`--severity`|`-S`=(`AUTO`|`LOW`|`MEDIUM`|`HIGH`)]
+    [`--force`|`-f`]
     [`--include`|`-i`=*aspect*[`,`...]]
     [`--exclude`|`-e`=*aspect*[`,`...]]
     [`--staged`]
@@ -64,14 +65,20 @@ the code, and comments contradicting the code.
     Set the *severity floor* (default `AUTO`): findings below the chosen
     threshold are silently suppressed, ordered `LOW` < `MEDIUM` <
     `HIGH`. The default `AUTO` means `MEDIUM` for a project with `grey`
-    boxing, no linting at all for a project with `black` boxing, and
-    `LOW` (keep all findings) otherwise; an explicitly given floor always
-    wins over the boxing, i.e. it also lints a project with `black`
-    boxing and, e.g. with `LOW`, acts on all findings of a project with
-    `grey` boxing. `ACCEPTED` findings are never suppressed. Surviving
-    findings are reported in *descending
-    severity* order `HIGH`, `MEDIUM`, `LOW`, `ACCEPTED`, keeping the
-    `file`/`line` order within the same severity.
+    boxing (unless `--force` is given) and `LOW` (keep all findings)
+    otherwise; an explicitly given floor always wins over the `grey`
+    boxing, i.e. e.g. with `LOW`, it acts on all findings of a project
+    with `grey` boxing. `ACCEPTED` findings are never suppressed.
+    Surviving findings are reported in *descending severity* order
+    `HIGH`, `MEDIUM`, `LOW`, `ACCEPTED`, keeping the `file`/`line` order
+    within the same severity.
+
+-   `--force`|`-f`:
+    Ignore the project boxing entirely: lint a project with `black`
+    boxing (which is otherwise not linted at all), and show the full
+    unified diffs and the default `LOW` severity floor for a project
+    with `grey` boxing (which otherwise shows only condensed one-line
+    diffs and defaults to the `MEDIUM` severity floor).
 
 -   `--include`|`-i`=*aspect*[`,`...]:
     Restrict the checked code quality aspects to the given
@@ -132,6 +139,12 @@ Lint a directory, reporting only `MEDIUM` and `HIGH` findings:
 ❯ /ase-code-lint -S MEDIUM src/handlers/
 ```
 
+Lint a directory regardless of the project boxing:
+
+```text
+❯ /ase-code-lint --force src/handlers/
+```
+
 Lint a source file for the formatting and spelling aspects only:
 
 ```text

package/plugin/skills/ase-help-intent/SKILL.md

@@ -72,7 +72,8 @@ catalog you match <intent/> against:
         Match the current <intent/> against the <corpus/> and select
         *every* skill that adequately fits it -- judging the fit
         primarily by each skill's `##  SCENARIOS` ("You want ...") and
-        `##  DESCRIPTION` sections. Order the selected skills from
+        `##  DESCRIPTION` sections, and secondarily by its `##  NAME`
+        and `##  SYNOPSIS` sections. Order the selected skills from
         best-fitting to worst-fitting and keep at most the *8* best
         ones, so the dispatch dialog of sub-step 4 stays addressable.
         Set <count/> to the number of kept skills. Then, for each kept

package/plugin/skills/ase-help-intent/data.md

@@ -633,6 +633,7 @@ Get insights into a specific subsystem:
     [`--help`|`-h`]
     [`--auto`|`-a`]
     [`--severity`|`-S`=(`AUTO`|`LOW`|`MEDIUM`|`HIGH`)]
+    [`--force`|`-f`]
     [`--include`|`-i`=*aspect*[`,`...]]
     [`--exclude`|`-e`=*aspect*[`,`...]]
     [`--staged`]
@@ -688,14 +689,20 @@ the code, and comments contradicting the code.
     Set the *severity floor* (default `AUTO`): findings below the chosen
     threshold are silently suppressed, ordered `LOW` < `MEDIUM` <
     `HIGH`. The default `AUTO` means `MEDIUM` for a project with `grey`
-    boxing, no linting at all for a project with `black` boxing, and
-    `LOW` (keep all findings) otherwise; an explicitly given floor always
-    wins over the boxing, i.e. it also lints a project with `black`
-    boxing and, e.g. with `LOW`, acts on all findings of a project with
-    `grey` boxing. `ACCEPTED` findings are never suppressed. Surviving
-    findings are reported in *descending
-    severity* order `HIGH`, `MEDIUM`, `LOW`, `ACCEPTED`, keeping the
-    `file`/`line` order within the same severity.
+    boxing (unless `--force` is given) and `LOW` (keep all findings)
+    otherwise; an explicitly given floor always wins over the `grey`
+    boxing, i.e. e.g. with `LOW`, it acts on all findings of a project
+    with `grey` boxing. `ACCEPTED` findings are never suppressed.
+    Surviving findings are reported in *descending severity* order
+    `HIGH`, `MEDIUM`, `LOW`, `ACCEPTED`, keeping the `file`/`line` order
+    within the same severity.
+
+-   `--force`|`-f`:
+    Ignore the project boxing entirely: lint a project with `black`
+    boxing (which is otherwise not linted at all), and show the full
+    unified diffs and the default `LOW` severity floor for a project
+    with `grey` boxing (which otherwise shows only condensed one-line
+    diffs and defaults to the `MEDIUM` severity floor).
 
 -   `--include`|`-i`=*aspect*[`,`...]:
     Restrict the checked code quality aspects to the given
@@ -756,6 +763,12 @@ Lint a directory, reporting only `MEDIUM` and `HIGH` findings:
 ❯ /ase-code-lint -S MEDIUM src/handlers/
 ```
 
+Lint a directory regardless of the project boxing:
+
+```text
+❯ /ase-code-lint --force src/handlers/
+```
+
 Lint a source file for the formatting and spelling aspects only:
 
 ```text
@@ -3587,6 +3600,7 @@ Loop over multiple specification edits inside a dedicated Git worktree:
     [`--help`|`-h`]
     [`--auto`|`-a`]
     [`--severity`|`-S`=(`AUTO`|`LOW`|`MEDIUM`|`HIGH`)]
+    [`--force`|`-f`]
     [`--include`|`-i`=*aspect*[`,`...]]
     [`--exclude`|`-e`=*aspect*[`,`...]]
     [`--staged`]
@@ -3658,14 +3672,20 @@ are *never* applied under `--auto`.
     Set the *severity floor* (default `AUTO`): findings below the chosen
     threshold are silently suppressed, ordered `LOW` < `MEDIUM` <
     `HIGH`. The default `AUTO` means `MEDIUM` for a project with `grey`
-    boxing, no linting at all for a project with `black` boxing, and
-    `LOW` (keep all findings) otherwise; an explicitly given floor always
-    wins over the boxing, i.e. it also lints a project with `black`
-    boxing and, e.g. with `LOW`, acts on all findings of a project with
-    `grey` boxing. `ACCEPTED` findings are never suppressed. Surviving
-    findings are reported in *descending severity* order `HIGH`,
-    `MEDIUM`, `LOW`, `ACCEPTED`, keeping the `file`/`line` order within
-    the same severity.
+    boxing (unless `--force` is given) and `LOW` (keep all findings)
+    otherwise; an explicitly given floor always wins over the `grey`
+    boxing, i.e. e.g. with `LOW`, it acts on all findings of a project
+    with `grey` boxing. `ACCEPTED` findings are never suppressed.
+    Surviving findings are reported in *descending severity* order
+    `HIGH`, `MEDIUM`, `LOW`, `ACCEPTED`, keeping the `file`/`line` order
+    within the same severity.
+
+-   `--force`|`-f`:
+    Ignore the project boxing entirely: lint a project with `black`
+    boxing (which is otherwise not linted at all), and show the full
+    unified diffs and the default `LOW` severity floor for a project
+    with `grey` boxing (which otherwise shows only condensed one-line
+    diffs and defaults to the `MEDIUM` severity floor).
 
 -   `--include`|`-i`=*aspect*[`,`...]:
     Restrict the checked specification quality aspects to the given
@@ -3737,6 +3757,12 @@ Lint the specification, reporting only `MEDIUM` and `HIGH` findings:
 ❯ /ase-spec-lint -S MEDIUM
 ```
 
+Lint the specification regardless of the project boxing:
+
+```text
+❯ /ase-spec-lint --force
+```
+
 Lint only the specification files with staged Git changes:
 
 ```text

package/plugin/skills/ase-spec-activate/SKILL.md

@@ -118,7 +118,10 @@ an ad-hoc change, and it *never* touches the artifact kinds `CODE`,
 
     Serve <query/> *ad-hoc* under the **Activated Behavior** below:
     read the `SPEC` artifacts of <artifact-files/> which are related to
-    <query/>, resolve their `[[xxx]]` references across artifacts, and
+    <query/> (or, for a question spanning entire object kinds, property
+    values, or reference relations, query them structurally via the
+    `ase_specbook_query(selector: "<selector/>")` tool of the `ase` MCP
+    server), resolve their `[[xxx]]` references across artifacts, and
     answer the query grounded in the specification content, citing the
     artifact file and object id of every statement you rely on. If
     <query/> asks for a change, apply it as an *ad-hoc modification*

package/plugin/skills/ase-spec-lint/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ase-spec-lint
-argument-hint: "[--help|-h] [--auto|-a] [--severity|-S=(AUTO|LOW|MEDIUM|HIGH)] [--include|-i=<aspect>[,...]] [--exclude|-e=<aspect>[,...]] [--staged] [--unstaged] [<spec-reference>]"
+argument-hint: "[--help|-h] [--auto|-a] [--severity|-S=(AUTO|LOW|MEDIUM|HIGH)] [--force|-f] [--include|-i=<aspect>[,...]] [--exclude|-e=<aspect>[,...]] [--staged] [--unstaged] [<spec-reference>]"
 description: >
     Lint the SpecBook-based specification (SPEC) for potential quality
     problems: its syntax, its formatting, its statements, the logical
@@ -26,7 +26,7 @@ Lint Specification
 
 <expand name="getopt"
     arg1="ase-spec-lint"
-    arg2="--auto|-a --severity|-S=(AUTO|LOW|MEDIUM|HIGH) --include|-i=(none|S01|S02|S03|S04|S05|S06|S07|S08|S09|S10)... --exclude|-e=(none|S01|S02|S03|S04|S05|S06|S07|S08|S09|S10)... --staged --unstaged">
+    arg2="--auto|-a --severity|-S=(AUTO|LOW|MEDIUM|HIGH) --force|-f --include|-i=(none|S01|S02|S03|S04|S05|S06|S07|S08|S09|S10)... --exclude|-e=(none|S01|S02|S03|S04|S05|S06|S07|S08|S09|S10)... --staged --unstaged">
     $ARGUMENTS
 </expand>
 
@@ -39,11 +39,11 @@ problems* related to a set of specification quality aspects.
 
 1.  <step id="STEP 1: Investigation">
 
-    <if condition="<ase-project-boxing/> is equal `black` and <getopt-option-severity/> is equal `AUTO`">
+    <if condition="<ase-project-boxing/> is equal `black` and <getopt-option-force/> is not equal `true`">
 
     The project source artifacts are classified as a *black box*, so
     the user does *not* want them inspected or their problems surfaced
-    (an *explicitly* given severity floor lifts this skip).
+    (the `--force` option lifts this skip).
     *Skip* the entire investigation and reporting: do *not* invoke any
     `Bash`, `Glob`, or `Agent` tool and do *not* read any source, only
     output the following <template/> and then *SKIP* the remaining steps
@@ -56,9 +56,9 @@ problems* related to a set of specification quality aspects.
     </if>
 
     Set <condensed>true</condensed> if <ase-project-boxing/> is equal
-    `grey` or `black` (the latter reached only under an explicitly given
-    severity floor), and <condensed>false</condensed> otherwise: a
-    *condensed* report suppresses the full unified diffs of STEP 3.
+    `grey` and <getopt-option-force/> is not equal `true`, and
+    <condensed>false</condensed> otherwise: a *condensed* report
+    suppresses the full unified diffs of STEP 3.
 
     First, determine the *effective aspect set* <aspects/>, i.e., the
     specification quality aspects which are checked at all. For this,
@@ -250,13 +250,13 @@ problems* related to a set of specification quality aspects.
 
     <if condition="<getopt-option-severity/> is equal `AUTO`">
     Set <floor>MEDIUM</floor> if <ase-project-boxing/> is equal `grey`
-    (grey boxing surfaces only *material* findings of severity `MEDIUM`
-    and above), and <floor>LOW</floor> otherwise.
+    and <getopt-option-force/> is not equal `true` (grey boxing surfaces
+    only *material* findings of severity `MEDIUM` and above), and
+    <floor>LOW</floor> otherwise.
     </if>
     <else>
     Set <floor><getopt-option-severity/></floor>: an *explicitly* given
-    severity floor always *wins* over the boxing, both over the `grey`
-    floor and over the `black` skip.
+    severity floor always *wins* over the `grey` boxing floor.
     </else>
 
     Then *apply the effective severity floor* <floor/>: *Keep* a problem
@@ -535,9 +535,9 @@ problems* related to a set of specification quality aspects.
 
             <if condition="<condensed/> is equal `true`">
 
-            The project source artifacts are classified as a *grey box* (or
-            *black box*), so the user does *not* want the full artifact
-            internals surfaced:
+            The project source artifacts are classified as a *grey box*,
+            so the user does *not* want the full artifact internals
+            surfaced:
             *suppress* the full unified diff and instead show only the
             *condensed* one-line-per-hunk representation. Report the
             solution with the following <template/>:
@@ -685,7 +685,7 @@ problems* related to a set of specification quality aspects.
 
         <if condition="<getopt-option-auto/> is not equal `true`">
         <ase-tpl-hint level="verbose">
-        Use `/ase-spec-lint --auto` to apply all non-gap corrections unattended, `--severity` to raise the reporting floor, `--include`/`--exclude` to narrow the checked aspects, and `--staged`/`--unstaged` to lint only the changed specification files.
+        Use `/ase-spec-lint --auto` to apply all non-gap corrections unattended, `--severity` to raise the reporting floor, `--force` to ignore the project boxing, `--include`/`--exclude` to narrow the checked aspects, and `--staged`/`--unstaged` to lint only the changed specification files.
         </ase-tpl-hint>
         </if>
 

package/plugin/skills/ase-spec-lint/help.md

@@ -9,6 +9,7 @@
     [`--help`|`-h`]
     [`--auto`|`-a`]
     [`--severity`|`-S`=(`AUTO`|`LOW`|`MEDIUM`|`HIGH`)]
+    [`--force`|`-f`]
     [`--include`|`-i`=*aspect*[`,`...]]
     [`--exclude`|`-e`=*aspect*[`,`...]]
     [`--staged`]
@@ -80,14 +81,20 @@ are *never* applied under `--auto`.
     Set the *severity floor* (default `AUTO`): findings below the chosen
     threshold are silently suppressed, ordered `LOW` < `MEDIUM` <
     `HIGH`. The default `AUTO` means `MEDIUM` for a project with `grey`
-    boxing, no linting at all for a project with `black` boxing, and
-    `LOW` (keep all findings) otherwise; an explicitly given floor always
-    wins over the boxing, i.e. it also lints a project with `black`
-    boxing and, e.g. with `LOW`, acts on all findings of a project with
-    `grey` boxing. `ACCEPTED` findings are never suppressed. Surviving
-    findings are reported in *descending severity* order `HIGH`,
-    `MEDIUM`, `LOW`, `ACCEPTED`, keeping the `file`/`line` order within
-    the same severity.
+    boxing (unless `--force` is given) and `LOW` (keep all findings)
+    otherwise; an explicitly given floor always wins over the `grey`
+    boxing, i.e. e.g. with `LOW`, it acts on all findings of a project
+    with `grey` boxing. `ACCEPTED` findings are never suppressed.
+    Surviving findings are reported in *descending severity* order
+    `HIGH`, `MEDIUM`, `LOW`, `ACCEPTED`, keeping the `file`/`line` order
+    within the same severity.
+
+-   `--force`|`-f`:
+    Ignore the project boxing entirely: lint a project with `black`
+    boxing (which is otherwise not linted at all), and show the full
+    unified diffs and the default `LOW` severity floor for a project
+    with `grey` boxing (which otherwise shows only condensed one-line
+    diffs and defaults to the `MEDIUM` severity floor).
 
 -   `--include`|`-i`=*aspect*[`,`...]:
     Restrict the checked specification quality aspects to the given
@@ -159,6 +166,12 @@ Lint the specification, reporting only `MEDIUM` and `HIGH` findings:
 ❯ /ase-spec-lint -S MEDIUM
 ```
 
+Lint the specification regardless of the project boxing:
+
+```text
+❯ /ase-spec-lint --force
+```
+
 Lint only the specification files with staged Git changes:
 
 ```text