@rse/ase 2.0.5 → 2.0.6

package/plugin/mods/ase-mods-grill.ts

@@ -13,16 +13,12 @@
     "n" or "nX" into the prompt.  */
 
 import type { Elements, Frozen, MatchedEvent, RenderElement } from "claude-code"
-import { type Engine, type Char, PICKED, style, width, wrap, split, paint } from "./ase-mods-common.ts"
+import { type Engine, type Char, PICKED, ROW, RULE, cells, style, width, wrap, split, paint } from "./ase-mods-common.ts"
 
 /*  the marker line above a grilling table (single-round and multi-round,
     optionally labeled with the perspective and/or grounding)  */
 const MARKER = /⧉ \*{0,2}ASE\*{0,2}: GRILLING(?: ROUND \d+\/\d+)?(?: \([^)]*\))?:/
 
-/*  a row and the delimiter row of a Markdown table  */
-const ROW  = /^ *\|.*\| *$/
-const RULE = /^ *\|(?: *:?-+:? *\|)+ *$/
-
 /*  the separator between two answers, the letter of
     an answer, and the number of a question  */
 const ANSWER = /,\s+(?=\*{0,2}[A-Z]\*{0,2}\s+▶)/
@@ -48,31 +44,6 @@ type Table = {
     rows:   { number: number, question: string, answers: { letter: string, text: string }[] }[]
 }
 
-/*  split a Markdown table row into its cells  */
-const cells = (line: string): string[] => {
-    const result: string[] = []
-    const body = line.trim().replace(/^\|/, "").replace(/\|$/, "")
-    let cell = ""
-    let code = false
-    for (let i = 0; i < body.length; i++) {
-        const ch = body[i]!
-        if (ch === "`")
-            code = !code
-        if (!code && ch === "\\" && body[i + 1] === "|") {
-            cell += "|"
-            i++
-        }
-        else if (!code && ch === "|") {
-            result.push(cell.trim())
-            cell = ""
-        }
-        else
-            cell += ch
-    }
-    result.push(cell.trim())
-    return result
-}
-
 /*  parse the grilling table out of the text of a reply  */
 const parse = (text: string): Table | undefined => {
     const lines = text.split("\n")

package/plugin/mods/ase-mods-help-browse.ts

@@ -12,9 +12,10 @@
     where typed text edits the filter, LEFT/RIGHT (or the wheel over the
     skills) selects a skill, UP/DOWN (or the wheel over the manual page)
     scroll its manual page (with the matches of the filter marked), RETURN
-    takes over its command into the prompt, "!!" switches over to the
-    intent help for the filter, and "//" leaves the filter in the prompt
-    (which mirrors the filter while the browser is shown).  */
+    takes over its command into the prompt, SPACE takes it over into the
+    synopsis form, "!!" switches over to the intent help for the filter,
+    and "//" leaves the filter in the prompt (which mirrors the filter while
+    the browser is shown).  */
 
 import type { Elements, Frozen, PromptBox, PromptEditInput, RenderElement } from "claude-code"
 import { type Engine, type Char, type BandRender, type BandScroll, type View, PICKED,
@@ -228,24 +229,26 @@ export const modHelpBrowse = () => {
     const hold = (current: Browse): PromptBox => held(current.filter.trimEnd())
 
     /*  take over the command of the selected manual page into the prompt (closing
-        the browser), if any page matches, and determine the prompt to show  */
-    const take = (current: Browse): PromptBox => {
+        the browser), if any page matches, optionally suffixed with a trigger (to
+        switch over to its band), and determine the prompt to show  */
+    const take = (current: Browse, trigger = ""): PromptBox => {
         const doc = matching(current)[current.select]?.doc
         if (doc === undefined)
             return hold(current)
         reset()
-        const text = `/${doc.skill} `
+        const text = `/${doc.skill} ${trigger}`
         return { text, cursor: text.length }
     }
 
     /*  while the manpage browser is shown, every edit is a key of the browser:
         LEFT/RIGHT select a manual page, UP/DOWN scroll it by a line, RETURN takes
-        over the command of the selected page, "//" (two "/" in a row) closes the
-        browser and leaves the filter in the prompt, "!!" (two "!"
-        in a row, for a non-empty filter) closes the browser with the filter suffixed
-        with the trigger of the intent help (to switch over to it), a deletion (like
-        BACKSPACE) deletes the last character of the filter, and any other typed
-        text is appended to the filter  */
+        over the command of the selected page, SPACE takes it over suffixed with
+        the trigger of the synopsis form, "//" (two "/" in a row) closes the
+        browser and leaves the filter in the prompt, "!!" (two "!" in a row, for
+        a non-empty filter) closes the browser with the filter suffixed with the
+        trigger of the intent help (both to switch over to the other band), a
+        deletion (like BACKSPACE) deletes the last character of the filter, and
+        any other typed text is appended to the filter  */
     const edit = (e: Frozen<PromptEditInput>): PromptBox => {
         const current   = browse!
         const key       = decode(e)
@@ -272,6 +275,8 @@ export const modHelpBrowse = () => {
         current.filter += pending
         if (key.name === "return")
             return take(current)
+        if (key.text === " ")
+            return take(current, "!!")
         if (key.name === "up" || key.name === "down")
             current.scroll = Math.max(0, current.scroll + (key.name === "up" ? -1 : 1))
         else if (key.step !== 0) {
@@ -393,7 +398,7 @@ export const modHelpBrowse = () => {
             status: `[ ${list.length}/${docs?.length ?? 0} manpages ]`,
             hints:  `←/→${wheeled}: select · ` +
                 `${geometry.overflow ? "wheel or CTRL+x + TAB + ↑/↓/PgUp/PgDn" : "↑/↓"}: scroll · ` +
-                "//: cancel+close · ⏎: apply+close" +
+                "//: cancel+close · ⏎: apply+close · SPACE: compose" +
                 (current.filter.trim() !== "" ? " · !!: Find Skill Command" : "") + " · (type for filtering)",
             rows:   (i) => i === 0 ? field : entry(current.top + i - 2),
             rule:   (i) => i === 1,

package/plugin/mods/ase-mods-help-find.ts

@@ -10,9 +10,10 @@
     the skill "ase-help-intent", but over the session context), and showing
     the proposed skills in a master/detail view in the band above the
     prompt, where LEFT/RIGHT (or the wheel over the skills) selects a skill,
-    UP/DOWN and "b"/"f"/SPACE (or the wheel over the details) scroll its
-    details, RETURN picks its command into the prompt, and "!!", BACKSPACE, or
-    any other key restores the prompt as typed without the trigger.  */
+    UP/DOWN and "b"/"f" (or the wheel over the details) scroll its details,
+    RETURN picks its command into the prompt, SPACE picks it into the synopsis
+    form, and "!!", BACKSPACE, or any other key restores the prompt as typed
+    without the trigger.  */
 
 import type { Elements, Frozen, PromptBox, PromptEditInput, RenderElement } from "claude-code"
 import { type Engine, type Char, type BandRender, type BandScroll, type View, PICKED, CODE,
@@ -198,11 +199,13 @@ export const modHelpFind = () => {
 
     /*  while the intent band is shown, every edit is a key of the band (with the
         prompt held): LEFT/RIGHT select a proposal, UP/DOWN scroll its details by
-        a line and "b"/"f"/SPACE by a page (as the engine consumes PAGEUP/PAGEDOWN),
+        a line and "b"/"f" by a page (as the engine consumes PAGEUP/PAGEDOWN),
         RETURN (arriving as a typed newline in the held prompt) operates the band
-        as at the prompt, "//" (two "/" in a row) closes the band with the prompt
-        as typed suffixed with the trigger of the manpage browser (to switch over
-        to it), and "!!" (two "!" in a row), a deletion (like BACKSPACE), or any
+        as at the prompt, SPACE closes the band with the command of the selected
+        proposal suffixed with the trigger of the synopsis form, "//" (two "/"
+        in a row) closes the band with the prompt as typed suffixed with the
+        trigger of the manpage browser (both to switch over to the other band),
+        and "!!" (two "!" in a row), a deletion (like BACKSPACE), or any
         other key closes the band and restores the prompt as typed without the
         trigger (onto whose end the edit of a typed text is still to be applied)  */
     const edit = (e: Frozen<PromptEditInput>): PromptBox | string => {
@@ -222,8 +225,13 @@ export const modHelpFind = () => {
             const text = submit()
             return intent !== undefined ? held(draft) : { text, cursor: text.length }
         }
+        if (state === "done" && key.text === " ") {
+            reset()
+            const text = `${proposals[current.select]!.command} !!`
+            return { text, cursor: text.length }
+        }
         const roll = key.name === "up" ? -1 : key.name === "down" ? 1 :
-            key.text === "b" ? -current.page : key.text === "f" || key.text === " " ? current.page : 0
+            key.text === "b" ? -current.page : key.text === "f" ? current.page : 0
         const step = roll !== 0 ? 0 : key.step
         if (state === "done" && (roll !== 0 || step !== 0)) {
             if (step !== 0) {
@@ -406,7 +414,7 @@ export const modHelpFind = () => {
             (the intent itself stays visible in the prompt)  */
         return panel(ui, geometry, current, {
             title: TITLE,
-            hints: current.state === "done" ? "⌫/!!: cancel+close · ⏎: apply+close · ←/→: select · b/f/SPACE: scroll" +
+            hints: current.state === "done" ? "⌫/!!: cancel+close · ⏎: apply+close · SPACE: compose · ←/→: select · b/f: scroll" +
                 (geometry.overflow ? " · wheel: select/scroll" : "") + " · //: Browse Skill Manpages" :
                 "⌫/!!/any key: cancel+close · //: Browse Skill Manpages",
             rows:  (i) => {

package/plugin/mods/ase-mods.ts

@@ -6,8 +6,9 @@
 
 /*  Claude Code function hooks module ("mod", EARLY ACCESS):
     Hooking infrastructure, registering the function hooks and dispatching
-    them into the grill table ("ase-mods-grill.ts"), the intent help
-    ("ase-mods-help-find.ts"), the synopsis form ("ase-mods-help-compose.ts"),
+    them into the grill table ("ase-mods-grill.ts"), the decision matrix
+    ("ase-mods-evaluate.ts"), the intent help ("ase-mods-help-find.ts"),
+    the synopsis form ("ase-mods-help-compose.ts"),
     the manual band ("ase-mods-help-show.ts"), the manpage browser
     ("ase-mods-help-browse.ts"), and the hint band ("ase-mods-help-hint.ts").
     As the engine loads only a module spelling "on", "$", and "next" literally,
@@ -17,6 +18,7 @@
 import type { Register, PromptBox, Timer } from "claude-code"
 import { type Band, TRIGGER } from "./ase-mods-common.ts"
 import { modGrill }           from "./ase-mods-grill.ts"
+import { modEvaluate }        from "./ase-mods-evaluate.ts"
 import { modHelpFind }        from "./ase-mods-help-find.ts"
 import { modHelpCompose }     from "./ase-mods-help-compose.ts"
 import { modHelpShow }        from "./ase-mods-help-show.ts"
@@ -29,14 +31,15 @@ export const register: Register = (on, options) => {
     if (options.enabled === false)
         return
 
-    /*  the grill table, the intent help, the synopsis form, the manual band,
-        the manpage browser, and the hint band  */
-    const grill  = modGrill()
-    const intent = modHelpFind()
-    const skill  = modHelpCompose()
-    const manual = modHelpShow()
-    const browse = modHelpBrowse()
-    const hint   = modHelpHint()
+    /*  the grill table, the decision matrix, the intent help, the synopsis form,
+        the manual band, the manpage browser, and the hint band  */
+    const grill    = modGrill()
+    const evaluate = modEvaluate()
+    const intent   = modHelpFind()
+    const skill    = modHelpCompose()
+    const manual   = modHelpShow()
+    const browse   = modHelpBrowse()
+    const hint     = modHelpHint()
 
     /*  the bands above the prompt (the synopsis form, the intent band, and the
         manpage browser, opened in this order), the shown one (as at most one is
@@ -198,16 +201,19 @@ export const register: Register = (on, options) => {
         next.called || shown() === undefined ? next(e) :
             { drop: "intent band or synopsis form failed" })
 
-    /*  redraw the replies which contain a grilling table (terminal only), where
-        the chain beneath runs, although its drawing is replaced by us (but this
-        at least silences a warning in the debug output of Claude Code)  */
+    /*  redraw the replies which contain a grilling table or a decision matrix
+        (terminal only), where the chain beneath runs, although its drawing is
+        replaced by us (but this at least silences a warning in the debug output
+        of Claude Code)  */
     on("ui.render", { component: "AssistantMessage", surface: "terminal" }, async ($, e, next) => {
-        const drawn = await next(e)
-        return grill.render(e, $.ui.resolve(e), {
-            invalidate: () => $.ui.invalidate("ui.render"),
+        const drawn      = await next(e)
+        const ui         = $.ui.resolve(e)
+        const invalidate = () => $.ui.invalidate("ui.render")
+        return grill.render(e, ui, {
+            invalidate,
             prompt:     () => $.prompt.read(),
             fill:       (text) => $.prompt.fill({ text })
-        }) ?? drawn
+        }) ?? evaluate.render(e, ui, { invalidate }) ?? drawn
     })
 
     /*  draw the intent band resp. the synopsis form, else the manual page,

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*