@rse/ase 2.0.5 → 2.0.6

package/dst/man/ase-artifact.md

@@ -21,7 +21,7 @@ which provide the same) to locate the files of a kind. The recognized
 kinds are:
 
 - `spec`: the specification (by default below `docs/specbook`,
-  the files `*.{md,txt,svg,png,jpg}`).
+  the files `**/*.{md,txt,svg,png,jpg}`).
 - `code`: the source code (by default below `src`, all files
   except `**/etc/**` and `**/{.gitignore,.npmignore,package.json}`).
 - `docs`: the documentation (by default below `doc`, all files plus

package/dst/man/ase-config.md

@@ -259,12 +259,14 @@ glob). See `ase-artifact`(1):
 
 - `project.artifact.spec.basedir`, `project.artifact.spec.files`:
   The specification files (default: `docs/specbook` and
-  `*.{md,txt,svg,png,jpg}`).
+  `**/*.{md,txt,svg,png,jpg}`).
 
 - `project.artifact.spec.schema` (*string*):
   The whitespace-separated list of *SpecBook* schema configuration
-  files, where `std` names the bundled standard one and every other
-  entry is a file relative to the project root (default: empty, i.e.,
+  files, where `std`, `meta`, and `pm` name the bundled standard, meta,
+  and project management ones, `npm:`, `github:`, `http:`, and
+  `https:` references name remote ones, and every other entry is a file
+  or glob pattern relative to the project root (default: empty, i.e.,
   `std`). See `ase-spec`(1).
 
 - `project.artifact.code.basedir`, `project.artifact.code.files`:

package/dst/man/ase-mcp.md

@@ -53,7 +53,7 @@ The service provides the `ase_*` MCP tools of the skills, e.g.,
 `ase_config_list`, `ase_state_get`, `ase_state_set`,
 `ase_state_delete`, `ase_kv_get`, `ase_kv_set`, `ase_kv_delete`,
 `ase_kv_clear`, `ase_kv_batch`, the `ase_task_*` tools, `ase_artifact_list`,
-`ase_artifact_name`, `ase_specbook_lint`, `ase_specbook_export`,
+`ase_artifact_name`, `ase_specbook_lint`, `ase_specbook_export`, `ase_specbook_query`,
 `ase_diagram`, `ase_worktree_path`, `ase_mint`, `ase_text_metric`,
 `ase_getopt`, `ase_markdown_prepare`, `ase_timestamp`, `ase_sleep`,
 `ase_compat`, `ase_component_info`, and `ase_decision_matrix`.

package/dst/man/ase-setup-install.md

@@ -34,6 +34,14 @@ and `--tool codex`, which have no output style concept, the `ase hook
 session-start` handler injects the identical style instructions into
 the session context instead (see `ase-hook`(1)).
 
+For `--tool claude`, the function hooks of the plugin-shipped
+*Claude Code* mods (e.g., the clickable grilling table and the help
+bands above the prompt) are additionally enabled by writing
+`"CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1"` into the `env` of the
+`settings.json` of the installation scope, unless the variable is
+already present there: an *ASE* one (value `1`) is left as is, and a
+foreign one (any other value) is preserved with a warning.
+
 The *ASE* tool itself is not installed by this command, as it is
 already installed when running it (e.g., via `npm install -g
 @rse/ase`).
@@ -82,7 +90,8 @@ already installed when running it (e.g., via `npm install -g
 
 - `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`:
   The settings file of the `user`, `project`, resp. `local` scope,
-  receiving the `outputStyle` selection for `--tool claude`.
+  receiving the `outputStyle` selection and the
+  `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` variable for `--tool claude`.
 
 ## EXIT STATUS
 

package/dst/man/ase-setup-status.md

@@ -33,6 +33,12 @@ the agent tool to be found in `$PATH`. The rows are:
   (the *ASE* output style `ase:ase-terse`) or `foreign`
   (hand-selected).
 
+- `FUNCTIONHOOKS` (`--tool claude` only):
+  One row per settings file (of the scopes `user`, `project`, and
+  `local`) carrying a `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` variable in
+  its `env`, with the status `enabled` (value `1`) or `foreign` (any
+  other value).
+
 - `STATUSLINE` (`--tool claude` and `--tool copilot` only):
   One row per settings file carrying a `statusLine` entry, with the
   status `activated` (its command starts with `ase statusline`, i.e.,

package/dst/man/ase-setup-uninstall.md

@@ -20,7 +20,9 @@ steps are:
 2. For `--tool claude`, the selection of the output style
    `ase:ase-terse` is removed from the `settings.json` of the
    installation scope, while a foreign `outputStyle` is preserved with
-   a warning.
+   a warning. Likewise, the variable `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS`
+   (value `1`) is removed from its `env` (together with an `env` which
+   became empty), while a foreign value is preserved with a warning.
 3. The plugin `ase@ase` is uninstalled (`<cli> plugin uninstall
    ase@ase`, resp. `codex plugin remove ase@ase`) and the plugin
    marketplace `ase` is removed (`<cli> plugin marketplace remove

package/dst/man/ase-setup-update.md

@@ -42,6 +42,9 @@ carry no version change in the plugin manifest.
 Like `ase setup install`, for `--tool claude`, the output style
 `ase:ase-terse` is finally selected in the `settings.json` of the
 installation scope, unless a foreign `outputStyle` is already selected
+there, which is preserved with a warning, and the function hooks are
+enabled through `"CLAUDE_CODE_ENABLE_FUNCTION_HOOKS": "1"` in its
+`env`, unless a foreign value of the variable is already present
 there, which is preserved with a warning.
 
 ## OPTIONS

package/dst/man/ase-setup.md

@@ -23,8 +23,8 @@ The target agent tool is either *Anthropic Claude Code CLI*
 (`codex`). All operations are performed through the plugin and MCP
 commands of the respective agent tool CLI (e.g., `claude plugin
 install`), which hence has to be found in `$PATH`, and through direct
-edits of its settings files (for the output style, the statusline,
-and the telemetry). Every sub-process command is logged (with API keys
+edits of its settings files (for the output style, the function
+hooks, the statusline, and the telemetry). Every sub-process command is logged (with API keys
 masked) and its output is shown only on failure.
 
 ## OPTIONS
@@ -79,8 +79,8 @@ individual manual pages for the exact applicability):
   `ase-setup-disable`(1).
 
 - `ase setup status` \[`-t`|`--tool` *tool*\]:
-  Report the plugin, MCP server, output style, statusline, and
-  telemetry registrations of all scopes. See `ase-setup-status`(1).
+  Report the plugin, MCP server, output style, function hooks,
+  statusline, and telemetry registrations of all scopes. See `ase-setup-status`(1).
 
 - `ase setup mcp` `list`|`activate`|`deactivate` \[...\]:
   List, activate, or deactivate the pre-defined foreign MCP servers.

package/dst/man/ase-spec-export.md

@@ -6,6 +6,7 @@
 \[`-h`|`--help`\]
 \[`-o`|`--output` \[*format*`:`\]*file*\] \[...\]
 \[`-w`|`--watch`\]
+\[`-S`|`--schema`\]
 
 ## DESCRIPTION
 
@@ -55,8 +56,10 @@ The MCP tool `ase_specbook_export` provides the same to the skills.
   mixes into the export on standard output. An unknown format prefix and
   a not inferable format are errors. A relative *file* is relative to the
   current working directory. Default: the HTML rendering into
-  `index.html` inside the specification base directory (e.g.,
-  `docs/specbook/index.html`).
+  `index.html` (resp. `schema.html` under `--schema`) inside the
+  specification base directory (e.g., `docs/specbook/index.html`).
+  A `md` output inside the specification base directory is refused,
+  as it would be parsed as a specification file itself.
 
 - \[`-w`|`--watch`\]:
   Do not terminate after the initial export, but keep the outputs in
@@ -67,6 +70,10 @@ The MCP tool `ase_specbook_export` provides the same to the skills.
   `--watch` rejects the `-` standard output. The command then runs
   until it is interrupted (e.g., via `CTRL+C`).
 
+- \[`-S`|`--schema`\]:
+  Export the effective schema configuration `project.artifact.spec.schema`
+  itself, rendered as a *SpecBook* document, instead of the specification.
+
 ## EXIT STATUS
 
 Exits with status `0` on success, and with status `1` on any lint
@@ -88,11 +95,15 @@ $ ase spec export -o md:-
 
 # keep an HTML export in sync with the sources
 $ ase spec export -o /tmp/spec.html -w
+
+# export the schema configuration as PDF
+$ ase spec export -S -o schema.pdf
 ```
 
 ## SEE ALSO
 
-`ase`(1), `ase-spec`(1), `ase-spec-lint`(1), `ase-spec-preview`(1).
+`ase`(1), `ase-spec`(1), `ase-spec-lint`(1), `ase-spec-query`(1),
+`ase-spec-preview`(1).
 
 ## AUTHOR
 

package/dst/man/ase-spec-init.md

@@ -4,6 +4,7 @@
 
 `ase spec init`
 \[`-h`|`--help`\]
+\[`-s`|`--sample`\]
 
 ## DESCRIPTION
 
@@ -31,6 +32,11 @@ configuration are taken from the *ASE* configuration (see
 - \[`-h`|`--help`\]:
   Show usage information and exit.
 
+- \[`-s`|`--sample`\]:
+  Additionally scaffold one lint-clean sample object per allowed object
+  kind into the created files, with placeholder values satisfying the
+  schema configuration, so the format is learnable from them.
+
 ## EXIT STATUS
 
 Exits with status `0` on success, and with status `1` if the
@@ -44,12 +50,15 @@ $ ase spec init
 
 # initialize and then lint the specification
 $ ase spec init && ase spec lint
+
+# initialize the specification with sample objects
+$ ase spec init -s
 ```
 
 ## SEE ALSO
 
 `ase`(1), `ase-spec`(1), `ase-spec-lint`(1), `ase-spec-export`(1),
-`ase-spec-preview`(1), `ase-config`(1).
+`ase-spec-query`(1), `ase-spec-preview`(1), `ase-config`(1).
 
 ## AUTHOR
 

package/dst/man/ase-spec-lint.md

@@ -67,7 +67,8 @@ $ ase spec lint -m
 
 ## SEE ALSO
 
-`ase`(1), `ase-spec`(1), `ase-spec-export`(1), `ase-spec-preview`(1).
+`ase`(1), `ase-spec`(1), `ase-spec-export`(1), `ase-spec-query`(1),
+`ase-spec-preview`(1).
 
 ## AUTHOR
 

package/dst/man/ase-spec-preview.md

@@ -6,6 +6,7 @@
 \[`-h`|`--help`\]
 \[`-a`|`--addr` *ip-addr*\]
 \[`-p`|`--port` *tcp-port*\]
+\[`-S`|`--schema`\]
 
 ## DESCRIPTION
 
@@ -33,6 +34,10 @@ interrupted (e.g., via `CTRL+C`).
   The TCP port to listen on, an integer in the range `1`..`65535`
   (default: `12345`).
 
+- \[`-S`|`--schema`\]:
+  Preview the effective schema configuration `project.artifact.spec.schema`
+  itself, rendered as a *SpecBook* document, instead of the specification.
+
 ## EXIT STATUS
 
 Runs until interrupted. Exits with status `1` on an invalid TCP port
@@ -46,11 +51,15 @@ $ ase spec preview
 
 # serve the live preview on all interfaces on port 8080
 $ ase spec preview -a 0.0.0.0 -p 8080
+
+# serve the live preview of the schema configuration
+$ ase spec preview -S
 ```
 
 ## SEE ALSO
 
-`ase`(1), `ase-spec`(1), `ase-spec-export`(1), `ase-spec-lint`(1).
+`ase`(1), `ase-spec`(1), `ase-spec-export`(1), `ase-spec-lint`(1),
+`ase-spec-query`(1).
 
 ## AUTHOR
 

package/dst/man/ase-spec-query.md

@@ -0,0 +1,96 @@
+# ase-spec-query(1) -- Query the Project Specification
+
+## SYNOPSIS
+
+`ase spec query`
+\[`-h`|`--help`\]
+\[`-P`|`--param` *name*`=`*value*\] \[...\]
+\[`-f`|`--format` *format*\]
+\[`-o`|`--output` \[*format*`:`\]*file*\]
+\[`-S`|`--schema`\]
+*selector*
+
+## DESCRIPTION
+
+**ase spec query** loads the *SpecBook*-based specification Markdown
+files below `project.artifact.spec.basedir` (see `ase-spec`(1)),
+strictly validated like for `ase spec export` (see `ase-spec-export`(1)),
+and queries its Abstract Syntax Tree (AST) with the XPath-like *ASTq*
+*selector*, e.g., `// USE-CASE [ @STATUS == 'Done' ]`. The matched
+nodes are written as a JSON, JSON5, YAML, or TOON array, their subtrees
+included and the embedded file contents dropped.
+
+The queried tree consists of:
+
+- the root node of type `specification`,
+- its children of type `artifact`, with the attributes `created`,
+  `modified`, and `file`, and
+- the objects below, typed by their kind (with whitespace dashed),
+  with the attributes `kind`, `id`, `anchor`, `paren`, `name`,
+  `primary`, `description`, `rationale`, `elaboration`, and one per
+  property key.
+
+The query function `refs()` yields the objects the references of the
+current object resolve to, e.g., `// USE-CASE [ count(refs()) == 0 ]`.
+
+The query fails on any lint diagnostic of `error` severity (see
+`ase-spec-lint`(1)), while warnings are only logged, so a partial or
+invalid specification is never queried.
+
+The MCP tool `ase_specbook_query` provides the same to the skills.
+
+## OPTIONS
+
+- \[`-h`|`--help`\]:
+  Show usage information and exit.
+
+- \[`-P`|`--param` *name*`=`*value*\]:
+  Substitute the value *value* for the parameter `{`*name*`}` of the
+  *selector*. The option is repeatable, one per parameter.
+
+- \[`-f`|`--format` *format*\]:
+  The output format `json`, `json5`, `yaml`, or `toon` (default:
+  inferred from the *file* of `--output` like for `ase spec export`,
+  else `json`).
+
+- \[`-o`|`--output` \[*format*`:`\]*file*\]:
+  Write the result into *file*, or to standard output for `-`
+  (default: `-`). A relative *file* is relative to the current working
+  directory.
+
+- \[`-S`|`--schema`\]:
+  Query the effective schema configuration `project.artifact.spec.schema`
+  itself, described as a *SpecBook* document of the bundled meta schema
+  configuration, instead of the specification.
+
+## EXIT STATUS
+
+Exits with status `0` on success, and with status `1` on any lint
+diagnostic of `error` severity, an invalid *selector* or parameter, an
+unsupported output format, or an unwritable output file.
+
+## EXAMPLES
+
+```sh
+# list all use cases as JSON
+$ ase spec query "// USE-CASE"
+
+# list the finished use cases as YAML
+$ ase spec query -f yaml "// USE-CASE [ @STATUS == 'Done' ]"
+
+# list the objects of a given kind into a TOON file
+$ ase spec query -P kind=ROLE -o roles.toon "// * [ @kind == {kind} ]"
+
+# list the artifacts of the schema configuration itself
+$ ase spec query -S "/ artifact"
+```
+
+## SEE ALSO
+
+`ase`(1), `ase-spec`(1), `ase-spec-lint`(1), `ase-spec-export`(1),
+`ase-spec-preview`(1).
+
+## AUTHOR
+
+Dr. Ralf S. Engelschall <rse@engelschall.com>
+

package/dst/man/ase-spec.md

@@ -1,4 +1,4 @@
-# ase-spec(1) -- Initialize, Lint, Export, and Preview the Project Specification
+# ase-spec(1) -- Initialize, Lint, Export, Query, and Preview the Project Specification
 
 ## SYNOPSIS
 
@@ -6,6 +6,7 @@
 \[`-h`|`--help`\]
 
 `ase spec init`
+\[`-s`|`--sample`\]
 
 `ase spec lint`
 \[`-m`|`--markdown`\]
@@ -14,27 +15,42 @@
 `ase spec export`
 \[`-o`|`--output` \[*format*`:`\]*file*\] \[...\]
 \[`-w`|`--watch`\]
+\[`-S`|`--schema`\]
+
+`ase spec query`
+\[`-P`|`--param` *name*`=`*value*\] \[...\]
+\[`-f`|`--format` *format*\]
+\[`-o`|`--output` \[*format*`:`\]*file*\]
+\[`-S`|`--schema`\]
+*selector*
 
 `ase spec preview`
 \[`-a`|`--addr` *ip-addr*\]
 \[`-p`|`--port` *tcp-port*\]
+\[`-S`|`--schema`\]
 
 ## DESCRIPTION
 
 **ase spec** is the entry point group for initializing, linting,
-exporting, and previewing the *SpecBook*-based project specification
-(SPEC), i.e., the Markdown files (plus their embedded assets) of the
-artifact kind `spec` below the base directory
+exporting, querying, and previewing the *SpecBook*-based project
+specification (SPEC), i.e., the Markdown files (plus their embedded
+assets) of the artifact kind `spec` below the base directory
 `project.artifact.spec.basedir` (default: `docs/specbook`, relative to
-the project root).
+the project root). Every `.md` file below the base directory
+(recursively, except below `.`-prefixed entries), whatever its name,
+is taken as a specification file.
 
 The specification is governed by the *SpecBook* YAML schema
 configuration `project.artifact.spec.schema`: a whitespace-separated
 list of schema files, merged in the given order, where the entry `std`
 names the full standard schema bundled with *SpecBook* (not its
 compressed variant `ase-format-specbook.yaml` bundled with the plugin
-for the agents, see `ase-util-meta`(1)) and every other entry is a file
-path relative to the project root. An unset or empty value means `std`.
+for the agents, see `ase-util-meta`(1)), the entries `meta` and `pm`
+name the meta and project management schemas bundled with *SpecBook*,
+the entries prefixed with `npm:`, `github:`, `http://`, or `https://`
+name remote schemas (fetched and cached by *SpecBook*), and every other
+entry is a file path or glob pattern relative to the project root. An
+unset or empty value means `std`.
 
 All reading specification commands honor the Git exclude rules exactly
 like `ase artifact list` does (see `ase-artifact`(1)): an artifact file
@@ -55,7 +71,7 @@ exits with status `1`.
 
 ## COMMANDS
 
-- `ase spec init`:
+- `ase spec init` \[`-s`|`--sample`\]:
   Initialize the absent specification Markdown files of the schema
   configuration. See `ase-spec-init`(1).
 
@@ -63,11 +79,15 @@ exits with status `1`.
   Lint the specification against the schema configuration, and
   optionally for its generic Markdown formatting. See `ase-spec-lint`(1).
 
-- `ase spec export` \[`-o`|`--output` \[*format*`:`\]*file*\] \[...\] \[`-w`|`--watch`\]:
+- `ase spec export` \[`-o`|`--output` \[*format*`:`\]*file*\] \[...\] \[`-w`|`--watch`\] \[`-S`|`--schema`\]:
   Export the specification as JSON, JSON5, YAML, TOON, HTML, PDF, or
   normalized Markdown. See `ase-spec-export`(1).
 
-- `ase spec preview` \[`-a`|`--addr` *ip-addr*\] \[`-p`|`--port` *tcp-port*\]:
+- `ase spec query` \[`-P`|`--param` *name*`=`*value*\] \[...\] \[`-f`|`--format` *format*\] \[`-o`|`--output` \[*format*`:`\]*file*\] \[`-S`|`--schema`\] *selector*:
+  Query the specification with an *ASTq* selector, writing the matched
+  nodes as JSON, JSON5, YAML, or TOON. See `ase-spec-query`(1).
+
+- `ase spec preview` \[`-a`|`--addr` *ip-addr*\] \[`-p`|`--port` *tcp-port*\] \[`-S`|`--schema`\]:
   Serve the HTML export of the specification as a live preview. See
   `ase-spec-preview`(1).
 
@@ -78,7 +98,8 @@ The group command without a sub-command exits with status `1`.
 ## SEE ALSO
 
 `ase`(1), `ase-spec-init`(1), `ase-spec-lint`(1), `ase-spec-export`(1),
-`ase-spec-preview`(1), `ase-artifact`(1), `ase-config`(1).
+`ase-spec-query`(1), `ase-spec-preview`(1), `ase-artifact`(1),
+`ase-config`(1).
 
 ## AUTHOR
 

package/dst/man/ase.md

@@ -25,8 +25,8 @@ hook handlers, the statusline rendering, the persisted task plan
 management (including a task store server and an interactive task
 board), the autonomous task lifecycle agents (plus their agent relay
 and fleet supervisor), the project artifact resolution, the
-*SpecBook*-based specification initializing, linting, exporting and
-previewing, and miscellaneous utilities like diagram rendering,
+*SpecBook*-based specification initializing, linting, exporting,
+querying, and previewing, and miscellaneous utilities like diagram rendering,
 identifier minting, and text measuring.
 
 Most commands are sub-command groups. Each group and each command has
@@ -100,7 +100,7 @@ The following top-level commands exist:
   `ase-artifact`(1).
 
 - `ase spec` *command* \[...\]:
-  Initialize, lint, export, and preview the *SpecBook*-based project
+  Initialize, lint, export, query, and preview the *SpecBook*-based project
   specification. See `ase-spec`(1).
 
 - `ase util` *command* \[...\]:

package/package.json

@@ -6,7 +6,7 @@
     "homepage":                             "https://ase.tools",
     "repository":                           { "url": "git+https://github.com/rse/ase.git", "type": "git" },
     "bugs":                                 { "url": "https://github.com/rse/ase/issues" },
-    "version":                              "2.0.5",
+    "version":                              "2.0.6",
     "license":                              "Apache-2.0",
     "author": {
         "name":                             "Dr. Ralf S. Engelschall",
@@ -21,22 +21,23 @@
         "./package.json":                   "./package.json"
     },
     "devDependencies": {
-        "eslint":                           "10.13.0",
+        "eslint":                           "10.14.0",
         "@eslint/js":                       "10.0.1",
-        "@typescript-eslint/parser":        "8.72.0",
-        "@typescript-eslint/eslint-plugin": "8.72.0",
-        "typescript-eslint":                "8.72.0",
+        "@typescript-eslint/parser":        "8.72.1",
+        "@typescript-eslint/eslint-plugin": "8.72.1",
+        "typescript-eslint":                "8.72.1",
         "eslint-plugin-promise":            "7.3.0",
         "neostandard":                      "0.14.1",
-        "globals":                          "17.13.0",
+        "globals":                          "17.14.0",
         "typescript":                       "6.0.3",
-        "eslint-plugin-vue":                "10.11.1",
+        "eslint-plugin-vue":                "10.12.0",
         "vue-eslint-parser":                "10.4.1",
-        "vue-tsc":                          "3.3.13",
+        "vue-tsc":                          "3.3.14",
 
         "@rse/stx":                         "1.1.7",
         "nodemon":                          "3.1.14",
         "shx":                              "0.4.0",
+        "sync-directory":                   "6.0.6",
         "stylus":                           "0.64.0",
         "vite":                             "8.3.5",
         "@vitejs/plugin-vue":               "6.0.10",
@@ -55,10 +56,10 @@
         "source-sans":                      "3.52.0",
         "@fontsource/dejavu-mono":          "5.3.0",
 
-        "@types/node":                      "26.6.5",
+        "@types/node":                      "26.6.6",
         "@types/luxon":                     "3.7.6",
         "@types/which":                     "3.0.4",
-        "@types/update-notifier":           "6.0.8",
+        "@types/update-notifier":           "6.0.9",
         "@types/semver":                    "7.8.0",
         "@types/shell-quote":               "1.7.5",
         "@types/proper-lockfile":           "4.1.4",
@@ -77,14 +78,15 @@
         "valibot":                          "1.5.0",
         "execa":                            "10.2.1",
         "mkdirp":                           "3.0.1",
-        "@hapi/hapi":                       "21.4.11",
+        "@hapi/hapi":                       "21.4.12",
         "beautiful-mermaid":                "1.1.3",
         "@d2lang/d2":                       "0.1.34",
-        "elkjs":                            "0.12.0",
+        "elkjs":                            "0.12.1",
         "ink":                              "8.0.0",
+        "string-width":                     "8.3.0",
         "react":                            "19.3.1",
         "chokidar":                         "6.0.0",
-        "marked":                           "18.1.1",
+        "marked":                           "18.1.2",
         "shiki":                            "4.5.0",
         "cli-table3":                       "0.6.5",
         "chalk":                            "6.0.1",
@@ -106,12 +108,12 @@
         "undici":                           "8.12.3",
         "picomatch":                        "4.0.7",
         "lru-cache":                        "11.5.3",
-        "@rse/specbook":                    "1.5.2",
+        "@rse/specbook":                    "1.6.1",
         "markdownlint":                     "0.42.0",
         "tail":                             "2.2.6",
         "source-code-error":                "1.2.0",
         "pure-uuid":                        "2.0.0",
-        "ws":                               "8.22.0",
+        "ws":                               "8.22.1",
         "@rse/mrcs":                        "0.9.2",
         "@octokit/core":                    "7.0.8",
         "@octokit/plugin-rest-endpoint-methods": "18.0.0",
@@ -142,6 +144,7 @@
         "!plugin/node_modules/**",
         "!plugin/package.json",
         "!plugin/etc/**",
+        "!plugin/mods/claude-code.d.ts",
         ".claude-plugin/**/*",
         "README.md"
     ],

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

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

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

@@ -20,16 +20,40 @@ SpecBook Project Instantiation
         with **ASE** in the file `meta/ase-format-specbook.yaml`
         (relative to the plugin root).
 
+    -   For each entry `meta`, `pm`, or `npm:...`, `github:...`,
+        `http://...`, or `https://...` in the list:
+
+        The entry names a YAML schema configuration bundled with or
+        fetched by **SpecBook** itself (the meta, the project
+        management, or a remote one), which has no file to read.
+        Instead, obtain the *effective* (merged) schema configuration
+        once via the `ase_specbook_query(schema: true, selector: "/
+        artifact", format: "yaml")` tool of the `ase` MCP server, which
+        describes it as a **SpecBook** document.
+
     -   For each *other* entry in the list:
 
-        The entry names a custom YAML schema configuration file of the
-        project (relative to the project root).
+        The entry names a custom YAML schema configuration file (or
+        glob pattern of files) of the project (relative to the project
+        root).
 
     You *MUST* read all resulting schema configuration files via the
     `Read` tool before working on the specification of the **SpecBook
     SPEC Model**.
 
 -   The **SpecBook SPEC Model** of this project is the set of specification
-    Markdown files in the directory <ase-spec-basedir/> (relative
-    to the project root), whose files are resolved via the
-    `ase_artifact_list(kind: [ "spec" ])` tool of the `ase` MCP server.
+    Markdown files below the directory <ase-spec-basedir/> (relative
+    to the project root, recursively, where every `.md` file is a
+    specification file, whatever its name), whose files are resolved
+    via the `ase_artifact_list(kind: [ "spec" ])` tool of the `ase` MCP
+    server.
+
+-   The **SpecBook SPEC Model** of this project can be queried
+    *structurally* via the `ase_specbook_query(selector: "<selector/>")`
+    tool of the `ase` MCP server, with an XPath-like *ASTq* selector
+    like `// USE-CASE [ @STATUS == 'Done' ]` (object nodes typed by
+    their kind with whitespace dashed, attributes `id`, `name`,
+    `description`, `rationale`, and one per property key, and the
+    function `refs()` yielding the objects referenced by an object).
+    Prefer it over reading many artifact files when a question spans
+    objects of entire kinds, property values, or reference relations.