@taskless/cli 0.10.0 → 0.10.1

package/dist/index.js

@@ -888,7 +888,7 @@ function ps() {
   const e = em();
   return e?.apiUrl ? e.apiUrl : Qp;
 }
-const jt = "0.10.0", ms = "x-taskless-cli-version", Jo = "taskless-cli";
+const jt = "0.10.1", ms = "x-taskless-cli-version", Jo = "taskless-cli";
 class tm {
   async requestDeviceCode(t) {
     const n = ps(), s = { client_id: Jo };
@@ -15759,7 +15759,7 @@ description: |
   \`taskless help route\`; it does NOT suppress the skill.
 metadata:
   author: taskless
-  version: 0.10.0
+  version: 0.10.1
   commandName: tskl
 compatibility: Designed for Agents implementing the Agent Skills specification.
 ---
@@ -17291,7 +17291,71 @@ Show:
 
 - \`taskless help check\` — the command being wired into CI
 - \`taskless help rule create\` — required if no rules exist yet
-`, t1 = `# Topic: existing     (CLI v%(CLI_VERSION)s / topic v1)
+`, t1 = `# Topic: detect     (CLI v%(CLI_VERSION)s / topic v1)
+
+## Goal
+Scan the working directory for the linters it configures, the
+languages it uses, and the styles of any rules the repo already
+authors. Offline and deterministic — no network, no auth, no state
+change. This is the discovery step that feeds rule-authoring: the
+routing flow reads \`detect\` to decide where a new rule should live.
+
+## Preconditions
+- None. Works in any directory; doesn't require \`.taskless/\`.
+
+## Steps
+
+1. **Invoke the CLI** with JSON output:
+   \`\`\`
+   npx @taskless/cli detect --json
+   \`\`\`
+
+2. **Parse the response.** Shape:
+   \`\`\`json
+   {
+     "success": true,
+     "linters": [
+       {
+         "name": "eslint",
+         "evidence": ["eslint.config.js", "dependency eslint (package.json)"]
+       }
+     ],
+     "languages": ["typescript", "javascript"],
+     "ruleStyles": [
+       {
+         "source": ".taskless/rules",
+         "description": "ast-grep rules with YAML metadata sidecars"
+       }
+     ]
+   }
+   \`\`\`
+   - \`linters\` — each has a \`name\` and \`evidence\` (config-file paths,
+     a pyproject table marker, or a dependency marker from the
+     language's package file; not every entry is a path).
+   - \`languages\` — inferred from manifests and the detected linters.
+   - \`ruleStyles\` — how the repo authors its own rules, surfaced for
+     downstream reuse.
+
+3. **Use the signals to route.** Feed the output into rule authoring:
+   - A detected linter the repo already uses → author the rule there
+     (\`taskless help existing\`).
+   - No suitable linter, local-only → \`taskless help static\`.
+   - See \`taskless help route\` for the full decision.
+
+## Errors
+
+When \`--json\` is set, failures emit \`{ ok: false, code, message }\`:
+
+| code              | meaning                          | fix                       |
+|-------------------|----------------------------------|---------------------------|
+| \`INTERNAL_ERROR\`  | Internal schema validation       | Report; likely a CLI bug  |
+
+## See Also
+
+- \`taskless help route\` — decide where to author a rule from these signals
+- \`taskless help existing\` — author a rule in a linter the repo already uses
+- \`taskless help check\` — run rules against the codebase
+`, n1 = `# Topic: existing     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Author a rule in a linter the repository ALREADY uses, expressed in that
@@ -17348,7 +17412,7 @@ then write the rule where that tool expects it.
 - \`taskless help route\` — re-decide the destination if this no longer fits
 - \`taskless help static\` — author a local ast-grep rule instead
 - \`taskless help remote\` — generate via the Taskless service (login)
-`, n1 = `# Topic: info     (CLI v%(CLI_VERSION)s / topic v1)
+`, s1 = `# Topic: info     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Report local Taskless state: CLI version, installed skill versions
@@ -17415,7 +17479,7 @@ failing.)
 
 - \`taskless help auth\` — log in / log out / status detail
 - \`taskless help check\` — run rules against the codebase
-`, s1 = `# Topic: init     (CLI v%(CLI_VERSION)s / topic v1)
+`, r1 = `# Topic: init     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Install or update the Taskless skill into the user's coding-agent
@@ -17469,7 +17533,7 @@ what was removed.
 
 - \`taskless help info\` — verify what's installed and check staleness
 - \`taskless help auth\` — authenticate after installing
-`, r1 = `# Topic: onboard     (CLI v%(CLI_VERSION)s / topic v1)
+`, i1 = `# Topic: onboard     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Help a user who has just installed Taskless go from zero rules to a
@@ -17591,7 +17655,7 @@ rules as a bullet list the user can choose to materialize via the
 - \`taskless help rule create\` — materialize an accepted bullet into a real rule
 - \`taskless help check\` — validate newly created rules against the codebase
 - \`taskless help info\` — inspect the current \`.taskless/taskless.json\` state
-`, i1 = `# Topic: remote     (CLI v%(CLI_VERSION)s / topic v1)
+`, o1 = `# Topic: remote     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Generate a rule using the Taskless service. Your job on this path is to
@@ -17651,7 +17715,7 @@ confirmed.
 - \`taskless help rule create\` — the generation backend this path uses
 - \`taskless help auth\` — log in before generating
 - \`taskless help check\` — validate the generated rule
-`, o1 = `# Topic: route     (CLI v%(CLI_VERSION)s / topic v1)
+`, a1 = `# Topic: route     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Decide where a rule-authoring request should be built: in a linter the
@@ -17746,7 +17810,7 @@ failed and the user confirms.
 - \`taskless help existing\` — author in a linter the repo already uses
 - \`taskless help static\` — author a local ast-grep rule (no login)
 - \`taskless help remote\` — generate via the Taskless service (login)
-`, a1 = "# Topic: rule create (anonymous)     (CLI v%(CLI_VERSION)s / topic v1)\n\n## Goal\nCreate a new ast-grep rule **locally** without contacting the Taskless\nAPI. You (the agent) derive the rule yourself using the ast-grep\nschema as a guide, write the rule and test files, then validate them\nusing `rule verify` in a feedback loop.\n\n## Preconditions\n- `.taskless/` directory exists.\n- The agent can read/write files and run shell commands.\n- No auth required.\n\n## Steps\n\n1. **Learn the ast-grep rule format.** Before writing a rule, consult\n   the ast-grep rule reference at https://ast-grep.github.io/guide/rule-config.html\n   for valid fields, operators (`pattern`, `kind`, `regex`,\n   `any`/`all`/`has`/`inside`/`not`), and meta-variable syntax. The\n   Taskless-required fields you'll add on top are listed in step 5.\n\n2. **Gather the rule description.** Even if the user already provided\n   one, ask clarifying questions:\n   - What specific code pattern should be flagged? (concrete examples)\n   - What language is it in?\n   - Are there exceptions or edge cases where the pattern is OK?\n   - Can they show valid and invalid examples?\n\n3. **Check for similar existing rules.** Scan `.taskless/rules/`. If\n   anything overlaps, point it out and ask whether the user wants to\n   improve an existing rule via `taskless help rule improve --anonymous`.\n\n4. **Search the codebase for real instances.** Show the user what you\n   found and confirm any exclusions.\n\n5. **Derive the rule.** Write a YAML file at `.taskless/rules/<id>.yml`\n   with at minimum:\n   - `id`: kebab-case identifier (e.g. `no-eval`, `prefer-const`)\n   - `language`: target language\n   - `severity`: `error`, `warning`, `info`, or `hint`\n   - `message`: concise single-line explanation\n   - `rule`: the ast-grep rule object\n\n   Optional but useful: `note` (multi-line guidance, supports markdown),\n   `fix` (auto-fix pattern), `ignores` (file patterns to skip).\n\n6. **Write test cases.** Create `.taskless/rule-tests/<id>-YYYYMMDD-test.yml`\n   with `id`, `valid: [...]`, and `invalid: [...]` arrays. Include at\n   least 2 valid and 2 invalid cases. Use real patterns from the\n   codebase where possible.\n\n7. **Run the verify feedback loop.** Run:\n   ```\n   npx @taskless/cli rule verify <id> --json\n   ```\n   - If `success: true`: the rule passes. Report success to the user.\n   - If `success: false`: read the per-layer errors (`schema`,\n     `requirements`, `tests`). Fix the rule or tests. Re-run verify.\n     Repeat up to 3 times. If still failing after 3 iterations, report\n     to the user with the latest errors.\n\n   Common fixes:\n   - Schema errors → check field types against the ast-grep schema.\n   - Missing required fields → add what the requirements list demands.\n   - Regex without kind → add a `kind` field alongside any `regex`.\n   - Test failures → adjust pattern or test cases so valid cases pass\n     and invalid cases trigger.\n\n8. **Report results.** Show the rule file path, test file path, and a\n   one-line summary of what the rule detects. Suggest fetching\n   `taskless help check` to validate against the broader codebase.\n\n## Important Notes\n\n- Do NOT write files to `.taskless/rule-metadata/`. Anonymous rules\n  have no metadata sidecar (the API path uses metadata for\n  iteration; anonymous rules iterate directly via file edits).\n- Do NOT make any HTTP requests to taskless.io.\n- The verify feedback loop is the quality gate — always run it before\n  reporting success.\n\n## ast-grep schema\n\nThis recipe does not embed the full ast-grep schema. Read it from the\nupstream docs at https://ast-grep.github.io/guide/rule-config.html\nbefore authoring a rule. The Taskless-specific required fields layered\non top of the ast-grep rule are listed in step 5.\n\n## Errors\n\n`rule verify --json` has two output shapes depending on whether the\n`<id>` argument is supplied:\n\n- When `<id>` is missing, the command emits the standardized\n  `{ ok:false, code:\"INVALID_INPUT\", message }` envelope on stdout\n  and exits non-zero.\n- When `<id>` is supplied, the command emits the layered result\n  `{ success, schema, requirements, tests, ... }` on stdout (success\n  or failure exit code depending on the layers).\n\n| where               | code / shape    | meaning                                  | fix                                        |\n|---------------------|-----------------|------------------------------------------|--------------------------------------------|\n| envelope (no `<id>`)| `INVALID_INPUT` | Rule ID missing                          | Pass a valid rule ID positionally          |\n| layered: schema     | (schema layer)  | YAML didn't match ast-grep schema        | Fix the rule structure                     |\n| layered: req        | (req layer)     | Missing Taskless-required field          | Add `id`/`language`/`severity`/etc.        |\n| layered: tests      | (tests layer)   | A test case didn't behave as expected    | Fix the rule pattern OR the test case      |\n\n## See Also\n\n- `taskless help rule create` — API-backed flow (auth required)\n- `taskless help rule improve --anonymous` — iterate locally\n- `taskless help check` — validate the new rule against the codebase\n", l1 = `# Topic: rule create     (CLI v%(CLI_VERSION)s / topic v1)
+`, l1 = "# Topic: rule create (anonymous)     (CLI v%(CLI_VERSION)s / topic v1)\n\n## Goal\nCreate a new ast-grep rule **locally** without contacting the Taskless\nAPI. You (the agent) derive the rule yourself using the ast-grep\nschema as a guide, write the rule and test files, then validate them\nusing `rule verify` in a feedback loop.\n\n## Preconditions\n- `.taskless/` directory exists.\n- The agent can read/write files and run shell commands.\n- No auth required.\n\n## Steps\n\n1. **Learn the ast-grep rule format.** Before writing a rule, consult\n   the ast-grep rule reference at https://ast-grep.github.io/guide/rule-config.html\n   for valid fields, operators (`pattern`, `kind`, `regex`,\n   `any`/`all`/`has`/`inside`/`not`), and meta-variable syntax. The\n   Taskless-required fields you'll add on top are listed in step 5.\n\n2. **Gather the rule description.** Even if the user already provided\n   one, ask clarifying questions:\n   - What specific code pattern should be flagged? (concrete examples)\n   - What language is it in?\n   - Are there exceptions or edge cases where the pattern is OK?\n   - Can they show valid and invalid examples?\n\n3. **Check for similar existing rules.** Scan `.taskless/rules/`. If\n   anything overlaps, point it out and ask whether the user wants to\n   improve an existing rule via `taskless help rule improve --anonymous`.\n\n4. **Search the codebase for real instances.** Show the user what you\n   found and confirm any exclusions.\n\n5. **Derive the rule.** Write a YAML file at `.taskless/rules/<id>.yml`\n   with at minimum:\n   - `id`: kebab-case identifier (e.g. `no-eval`, `prefer-const`)\n   - `language`: target language\n   - `severity`: `error`, `warning`, `info`, or `hint`\n   - `message`: concise single-line explanation\n   - `rule`: the ast-grep rule object\n\n   Optional but useful: `note` (multi-line guidance, supports markdown),\n   `fix` (auto-fix pattern), `ignores` (file patterns to skip).\n\n6. **Write test cases.** Create `.taskless/rule-tests/<id>-YYYYMMDD-test.yml`\n   with `id`, `valid: [...]`, and `invalid: [...]` arrays. Include at\n   least 2 valid and 2 invalid cases. Use real patterns from the\n   codebase where possible.\n\n7. **Run the verify feedback loop.** Run:\n   ```\n   npx @taskless/cli rule verify <id> --json\n   ```\n   - If `success: true`: the rule passes. Report success to the user.\n   - If `success: false`: read the per-layer errors (`schema`,\n     `requirements`, `tests`). Fix the rule or tests. Re-run verify.\n     Repeat up to 3 times. If still failing after 3 iterations, report\n     to the user with the latest errors.\n\n   Common fixes:\n   - Schema errors → check field types against the ast-grep schema.\n   - Missing required fields → add what the requirements list demands.\n   - Regex without kind → add a `kind` field alongside any `regex`.\n   - Test failures → adjust pattern or test cases so valid cases pass\n     and invalid cases trigger.\n\n8. **Report results.** Show the rule file path, test file path, and a\n   one-line summary of what the rule detects. Suggest fetching\n   `taskless help check` to validate against the broader codebase.\n\n## Important Notes\n\n- Do NOT write files to `.taskless/rule-metadata/`. Anonymous rules\n  have no metadata sidecar (the API path uses metadata for\n  iteration; anonymous rules iterate directly via file edits).\n- Do NOT make any HTTP requests to taskless.io.\n- The verify feedback loop is the quality gate — always run it before\n  reporting success.\n\n## ast-grep schema\n\nThis recipe does not embed the full ast-grep schema. Read it from the\nupstream docs at https://ast-grep.github.io/guide/rule-config.html\nbefore authoring a rule. The Taskless-specific required fields layered\non top of the ast-grep rule are listed in step 5.\n\n## Errors\n\n`rule verify --json` has two output shapes depending on whether the\n`<id>` argument is supplied:\n\n- When `<id>` is missing, the command emits the standardized\n  `{ ok:false, code:\"INVALID_INPUT\", message }` envelope on stdout\n  and exits non-zero.\n- When `<id>` is supplied, the command emits the layered result\n  `{ success, schema, requirements, tests, ... }` on stdout (success\n  or failure exit code depending on the layers).\n\n| where               | code / shape    | meaning                                  | fix                                        |\n|---------------------|-----------------|------------------------------------------|--------------------------------------------|\n| envelope (no `<id>`)| `INVALID_INPUT` | Rule ID missing                          | Pass a valid rule ID positionally          |\n| layered: schema     | (schema layer)  | YAML didn't match ast-grep schema        | Fix the rule structure                     |\n| layered: req        | (req layer)     | Missing Taskless-required field          | Add `id`/`language`/`severity`/etc.        |\n| layered: tests      | (tests layer)   | A test case didn't behave as expected    | Fix the rule pattern OR the test case      |\n\n## See Also\n\n- `taskless help rule create` — API-backed flow (auth required)\n- `taskless help rule improve --anonymous` — iterate locally\n- `taskless help check` — validate the new rule against the codebase\n", c1 = `# Topic: rule create     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Generate a new ast-grep rule from a description and write the rule and
@@ -17847,7 +17911,7 @@ When \`--json\` is set, failures emit \`{ ok: false, code, message }\`:
 - \`taskless help rule create --anonymous\` — local-only flow (no API)
 - \`taskless help rule improve\` — iterate on an existing rule
 - \`taskless help check\` — validate the new rule against the codebase
-`, c1 = `# Topic: rule delete     (CLI v%(CLI_VERSION)s / topic v1)
+`, u1 = `# Topic: rule delete     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Remove a rule and its associated test files from \`.taskless/\`. Does
@@ -17895,7 +17959,7 @@ emitted from this command.
 
 - \`taskless help rule create\` — make a new rule
 - \`taskless help check\` — run remaining rules to confirm nothing broke
-`, u1 = `# Topic: rule improve (anonymous)     (CLI v%(CLI_VERSION)s / topic v1)
+`, f1 = `# Topic: rule improve (anonymous)     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Iterate on an existing ast-grep rule **locally** without contacting
@@ -17983,7 +18047,7 @@ The verify primitive returns structured errors per layer:
 - \`taskless help rule improve\` — API-backed flow (auth required)
 - \`taskless help rule create --anonymous\` — make a new rule locally
 - \`taskless help check\` — validate the updated rule
-`, f1 = `# Topic: rule improve     (CLI v%(CLI_VERSION)s / topic v1)
+`, d1 = `# Topic: rule improve     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Iterate on an existing Taskless rule. The CLI submits the user's
@@ -18087,7 +18151,7 @@ When \`--json\` is set, failures emit \`{ ok: false, code, message }\`:
 - \`taskless help rule improve --anonymous\` — local-only flow
 - \`taskless help rule create\` — make a new rule from scratch
 - \`taskless help check\` — validate the updated rule
-`, d1 = `# Topic: rule meta     (CLI v%(CLI_VERSION)s / topic v1)
+`, h1 = `# Topic: rule meta     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Read sidecar metadata for an API-generated rule. Used internally by
@@ -18117,7 +18181,7 @@ version, etc.
 ## See Also
 
 - \`taskless help rule improve\` — the primary consumer of this command
-`, h1 = `# Topic: rule verify     (CLI v%(CLI_VERSION)s / topic v1)
+`, p1 = `# Topic: rule verify     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Validate a rule against the ast-grep schema and run its test cases.
@@ -18175,7 +18239,7 @@ attempts and report to the user if still failing.
 
 - \`taskless help rule create --anonymous\` — primary consumer (loop)
 - \`taskless help rule improve --anonymous\` — primary consumer (loop)
-`, p1 = `# Topic: rule     (CLI v%(CLI_VERSION)s / topic v1)
+`, m1 = `# Topic: rule     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Umbrella for rule operations. Use the specific subcommand for the
@@ -18197,7 +18261,7 @@ help fetch.
 ## See Also
 
 - \`taskless help check\` — run all configured rules
-`, m1 = "# Topic: static     (CLI v%(CLI_VERSION)s / topic v1)\n\n## Goal\nAuthor a Taskless ast-grep rule **locally**, on this machine, without\ncontacting the Taskless service. You derive the rule yourself, write it\nin the canonical on-disk shape, and validate it with `rule verify` in a\nfeedback loop. The files you produce match exactly what the service\nwrites, so `check`, `improve`, and `verify` treat them identically.\n\n## Preconditions\n- `.taskless/` directory exists.\n- The agent can read/write files and run shell commands.\n- No auth required.\n\n## Steps\n\n1. **Learn the ast-grep rule format.** Consult the ast-grep rule\n   reference at https://ast-grep.github.io/guide/rule-config.html for\n   valid fields and operators (`pattern`, `kind`, `regex`,\n   `any`/`all`/`has`/`inside`/`not`) and meta-variable syntax.\n\n2. **Gather and confirm the pattern.** Make sure you have concrete\n   success cases (code that should pass) and failure cases (code that\n   should be flagged), the target language, and any exceptions. Search\n   the codebase for real instances and confirm exclusions with the user.\n\n3. **Author the rule in the canonical shape.** Write the rule to\n   `.taskless/rules/<id>.yml` with at minimum `id` (kebab-case),\n   `language`, `severity` (`error`/`warning`/`info`/`hint`), `message`,\n   and the `rule` object. Write tests to\n   `.taskless/rule-tests/<id>-YYYYMMDD-test.yml` with the matching `id`\n   field plus `valid` and `invalid` arrays (at least two of each). The\n   `id` must match the rule's `id` so ast-grep test filtering pairs them.\n   These paths and shape are the same ones the service writes — do not\n   invent a different layout.\n\n4. **Run the verify feedback loop.** Run:\n   ```\n   npx @taskless/cli rule verify <id> --json\n   ```\n   - `success: true` → the rule passes. Go to step 5.\n   - `success: false` → read the per-layer errors (`schema`,\n     `requirements`, `tests`), fix the rule or tests, and re-run. Repeat\n     up to 3 times.\n\n5. **On success, report.** Show the rule and test file paths and a\n   one-line summary of what the rule detects. Suggest `taskless help\n   check` to validate against the broader codebase.\n\n6. **On failure, escalate via the route fallback — with confirmation.**\n   If after the feedback loop the rule still cannot capture the user's\n   cases, this is the try-verify-escalate fallback:\n   - Delete the candidate `.taskless/rules/<id>.yml` and its test file so\n     the repo is not left with a broken rule (guaranteed cleanup of the\n     abandoned candidate).\n   - Tell the user the local rule could not capture the cases, and that\n     generating via the Taskless service uses a generation and requires\n     login.\n   - Only after the user confirms, fetch `taskless help remote` and\n     follow it. Do not call the service silently.\n\n## Important Notes\n\n- Do NOT make any HTTP requests to taskless.io on this path.\n- Do NOT write to `.taskless/rule-metadata/` — local rules have no\n  metadata sidecar; they iterate via file edits.\n- The verify loop is the quality gate. A clean failure is a legitimate\n  reason to escalate, but only with the user's confirmation (step 6).\n\n## See Also\n\n- `taskless help route` — re-decide the destination\n- `taskless help remote` — generate via the Taskless service (login)\n- `taskless help check` — validate the new rule against the codebase\n", g1 = `# Topic: update     (CLI v%(CLI_VERSION)s / topic v1)
+`, g1 = "# Topic: static     (CLI v%(CLI_VERSION)s / topic v1)\n\n## Goal\nAuthor a Taskless ast-grep rule **locally**, on this machine, without\ncontacting the Taskless service. You derive the rule yourself, write it\nin the canonical on-disk shape, and validate it with `rule verify` in a\nfeedback loop. The files you produce match exactly what the service\nwrites, so `check`, `improve`, and `verify` treat them identically.\n\n## Preconditions\n- `.taskless/` directory exists.\n- The agent can read/write files and run shell commands.\n- No auth required.\n\n## Steps\n\n1. **Learn the ast-grep rule format.** Consult the ast-grep rule\n   reference at https://ast-grep.github.io/guide/rule-config.html for\n   valid fields and operators (`pattern`, `kind`, `regex`,\n   `any`/`all`/`has`/`inside`/`not`) and meta-variable syntax.\n\n2. **Gather and confirm the pattern.** Make sure you have concrete\n   success cases (code that should pass) and failure cases (code that\n   should be flagged), the target language, and any exceptions. Search\n   the codebase for real instances and confirm exclusions with the user.\n\n3. **Author the rule in the canonical shape.** Write the rule to\n   `.taskless/rules/<id>.yml` with at minimum `id` (kebab-case),\n   `language`, `severity` (`error`/`warning`/`info`/`hint`), `message`,\n   and the `rule` object. Write tests to\n   `.taskless/rule-tests/<id>-YYYYMMDD-test.yml` with the matching `id`\n   field plus `valid` and `invalid` arrays (at least two of each). The\n   `id` must match the rule's `id` so ast-grep test filtering pairs them.\n   These paths and shape are the same ones the service writes — do not\n   invent a different layout.\n\n4. **Run the verify feedback loop.** Run:\n   ```\n   npx @taskless/cli rule verify <id> --json\n   ```\n   - `success: true` → the rule passes. Go to step 5.\n   - `success: false` → read the per-layer errors (`schema`,\n     `requirements`, `tests`), fix the rule or tests, and re-run. Repeat\n     up to 3 times.\n\n5. **On success, report.** Show the rule and test file paths and a\n   one-line summary of what the rule detects. Suggest `taskless help\n   check` to validate against the broader codebase.\n\n6. **On failure, escalate via the route fallback — with confirmation.**\n   If after the feedback loop the rule still cannot capture the user's\n   cases, this is the try-verify-escalate fallback:\n   - Delete the candidate `.taskless/rules/<id>.yml` and its test file so\n     the repo is not left with a broken rule (guaranteed cleanup of the\n     abandoned candidate).\n   - Tell the user the local rule could not capture the cases, and that\n     generating via the Taskless service uses a generation and requires\n     login.\n   - Only after the user confirms, fetch `taskless help remote` and\n     follow it. Do not call the service silently.\n\n## Important Notes\n\n- Do NOT make any HTTP requests to taskless.io on this path.\n- Do NOT write to `.taskless/rule-metadata/` — local rules have no\n  metadata sidecar; they iterate via file edits.\n- The verify loop is the quality gate. A clean failure is a legitimate\n  reason to escalate, but only with the user's confirmation (step 6).\n\n## See Also\n\n- `taskless help route` — re-decide the destination\n- `taskless help remote` — generate via the Taskless service (login)\n- `taskless help check` — validate the new rule against the codebase\n", y1 = `# Topic: update     (CLI v%(CLI_VERSION)s / topic v1)
 
 ## Goal
 Update Taskless skills in the user's coding-agent tools to the
@@ -18247,7 +18311,7 @@ non-zero with the error message on stderr.
 - \`taskless help info\` — verify what's installed and check staleness
 `;
 var Rr = {}, ul;
-function y1() {
+function b1() {
   return ul || (ul = 1, (function(e) {
     (function() {
       var t = {
@@ -18388,7 +18452,7 @@ function y1() {
     })();
   })(Rr)), Rr;
 }
-var b1 = y1();
+var w1 = b1();
 const Nh = M({
   prompt: C().trim().min(1, "prompt must be a non-empty string").describe("Description of the rule to generate"),
   successCases: J(C()).optional().describe("Examples of correct code that should pass the rule"),
@@ -18420,30 +18484,31 @@ const Ph = M({
 M({
   error: C().describe("Error message")
 });
-const w1 = /* @__PURE__ */ Object.assign({
+const v1 = /* @__PURE__ */ Object.assign({
   "../help/auth.txt": Q$,
   "../help/check.txt": X$,
   "../help/ci.txt": e1,
-  "../help/existing.txt": t1,
-  "../help/info.txt": n1,
-  "../help/init.txt": s1,
-  "../help/onboard.txt": r1,
-  "../help/remote.txt": i1,
-  "../help/route.txt": o1,
-  "../help/rule-create.anonymous.txt": a1,
-  "../help/rule-create.txt": l1,
-  "../help/rule-delete.txt": c1,
-  "../help/rule-improve.anonymous.txt": u1,
-  "../help/rule-improve.txt": f1,
-  "../help/rule-meta.txt": d1,
-  "../help/rule-verify.txt": h1,
-  "../help/rule.txt": p1,
-  "../help/static.txt": m1,
-  "../help/update.txt": g1
+  "../help/detect.txt": t1,
+  "../help/existing.txt": n1,
+  "../help/info.txt": s1,
+  "../help/init.txt": r1,
+  "../help/onboard.txt": i1,
+  "../help/remote.txt": o1,
+  "../help/route.txt": a1,
+  "../help/rule-create.anonymous.txt": l1,
+  "../help/rule-create.txt": c1,
+  "../help/rule-delete.txt": u1,
+  "../help/rule-improve.anonymous.txt": f1,
+  "../help/rule-improve.txt": d1,
+  "../help/rule-meta.txt": h1,
+  "../help/rule-verify.txt": p1,
+  "../help/rule.txt": m1,
+  "../help/static.txt": g1,
+  "../help/update.txt": y1
 });
-function v1() {
+function k1() {
   const e = /* @__PURE__ */ new Map(), t = /* @__PURE__ */ new Map();
-  for (const [n, s] of Object.entries(w1)) {
+  for (const [n, s] of Object.entries(v1)) {
     const r = n.split("/").pop()?.replace(/\.txt$/, "");
     if (r)
       if (r.endsWith(".anonymous")) {
@@ -18454,27 +18519,27 @@ function v1() {
   }
   return { helpMap: e, anonymousMap: t };
 }
-const { helpMap: Ns, anonymousMap: Rh } = v1(), hl = [
+const { helpMap: Ns, anonymousMap: Rh } = k1(), hl = [
   ["route", "Decide where to author a rule (existing/static/remote)"],
   ["existing", "Author a rule in a linter the repo already uses"],
   ["static", "Author a local ast-grep rule on this machine (no login)"],
   ["remote", "Generate a rule via the Taskless service (login)"]
-], k1 = {
+], _1 = {
   "rule-create": Nh,
   "rule-improve": Ph
 };
 function jh(e, t) {
   const n = {
-    CLI_VERSION: "0.10.0",
+    CLI_VERSION: "0.10.1",
     PACKAGE_MANAGER_DLX: "<package-manager-dlx>"
   };
   if (e.includes("%(INPUT_SCHEMA)s")) {
-    const s = k1[t];
+    const s = _1[t];
     n.INPUT_SCHEMA = s ? JSON.stringify(J0(s), null, 2) : "(no input schema for this topic)";
   }
-  return b1.sprintf(e, n);
+  return w1.sprintf(e, n);
 }
-function _1(e, t = {}) {
+function S1(e, t = {}) {
   const n = t.anonymous ? Rh.get(e) ?? Ns.get(e) : Ns.get(e);
   if (n !== void 0)
     return jh(n, e);
@@ -18482,11 +18547,11 @@ function _1(e, t = {}) {
 async function pl(e) {
   return typeof e == "function" ? e() : e;
 }
-async function S1(e) {
+async function $1(e) {
   const t = await pl(e);
   return (t.meta ? await pl(t.meta) : void 0)?.description ?? "";
 }
-function $1(e) {
+function I1(e) {
   return {
     meta: {
       name: "help",
@@ -18527,7 +18592,7 @@ function $1(e) {
         const c = [];
         for (const [u, d] of Object.entries(e)) {
           if (u === "help") continue;
-          const h = await S1(d);
+          const h = await $1(d);
           c.push([u, h]);
         }
         const f = Math.max(
@@ -18555,7 +18620,7 @@ Authoring recipes:`);
 function Lh(e) {
   return e.commandsInstalled ? "Next: in your AI tool, run /tskl onboard or ask it to use the Taskless skill (or run `taskless onboard` from your terminal) to discover rule candidates from your codebase." : "Next: in your AI tool, ask it to use the Taskless skill (or run `taskless onboard` from your terminal) to discover rule candidates from your codebase.";
 }
-const I1 = {
+const E1 = {
   meta: {
     name: "onboard",
     description: "Discover rule candidates from your codebase and history (post-install flow)"
@@ -18599,7 +18664,7 @@ const I1 = {
       );
       return;
     }
-    const o = _1("onboard");
+    const o = S1("onboard");
     if (o === void 0)
       throw console.error("Internal error: onboard recipe is not available."), process.exitCode = 1, new mt("recipe missing");
     console.log(o.trimEnd());
@@ -18677,9 +18742,9 @@ const jr = 10, ml = (e = 0) => (t) => `\x1B[${t + e}m`, gl = (e = 0) => (t) => `
   }
 };
 Object.keys(V.modifier);
-const E1 = Object.keys(V.color), T1 = Object.keys(V.bgColor);
-[...E1, ...T1];
-function A1() {
+const T1 = Object.keys(V.color), A1 = Object.keys(V.bgColor);
+[...T1, ...A1];
+function O1() {
   const e = /* @__PURE__ */ new Map();
   for (const [t, n] of Object.entries(V)) {
     for (const [s, r] of Object.entries(n))
@@ -18756,7 +18821,7 @@ function A1() {
     }
   }), V;
 }
-const xe = A1(), bl = (() => {
+const xe = O1(), bl = (() => {
   if (!("navigator" in globalThis))
     return 0;
   if (globalThis.navigator.userAgentData) {
@@ -18767,11 +18832,11 @@ const xe = A1(), bl = (() => {
   return /\b(Chrome|Chromium)\//.test(globalThis.navigator.userAgent) ? 1 : 0;
 })(), wl = bl !== 0 && {
   level: bl
-}, O1 = {
+}, C1 = {
   stdout: wl,
   stderr: wl
 };
-function C1(e, t, n) {
+function x1(e, t, n) {
   let s = e.indexOf(t);
   if (s === -1)
     return e;
@@ -18782,7 +18847,7 @@ function C1(e, t, n) {
   while (s !== -1);
   return o += e.slice(i), o;
 }
-function x1(e, t, n, s) {
+function F1(e, t, n, s) {
   let r = 0, i = "";
   do {
     const o = e[s - 1] === "\r";
@@ -18793,22 +18858,22 @@ function x1(e, t, n, s) {
   } while (s !== -1);
   return i += e.slice(r), i;
 }
-const { stdout: vl, stderr: kl } = O1, si = /* @__PURE__ */ Symbol("GENERATOR"), Gt = /* @__PURE__ */ Symbol("STYLER"), yn = /* @__PURE__ */ Symbol("IS_EMPTY"), _l = [
+const { stdout: vl, stderr: kl } = C1, si = /* @__PURE__ */ Symbol("GENERATOR"), Gt = /* @__PURE__ */ Symbol("STYLER"), yn = /* @__PURE__ */ Symbol("IS_EMPTY"), _l = [
   "ansi",
   "ansi",
   "ansi256",
   "ansi16m"
-], Jt = /* @__PURE__ */ Object.create(null), F1 = (e, t = {}) => {
+], Jt = /* @__PURE__ */ Object.create(null), N1 = (e, t = {}) => {
   if (t.level && !(Number.isInteger(t.level) && t.level >= 0 && t.level <= 3))
     throw new Error("The `level` option should be an integer from 0 to 3");
   const n = vl ? vl.level : 0;
   e.level = t.level === void 0 ? n : t.level;
-}, N1 = (e) => {
+}, P1 = (e) => {
   const t = (...n) => n.join(" ");
-  return F1(t, e), Object.setPrototypeOf(t, Cn.prototype), t;
+  return N1(t, e), Object.setPrototypeOf(t, Cn.prototype), t;
 };
 function Cn(e) {
-  return N1(e);
+  return P1(e);
 }
 Object.setPrototypeOf(Cn.prototype, Function.prototype);
 for (const [e, t] of Object.entries(xe))
@@ -18824,8 +18889,8 @@ Jt.visible = {
     return Object.defineProperty(this, "visible", { value: e }), e;
   }
 };
-const ri = (e, t, n, ...s) => e === "rgb" ? t === "ansi16m" ? xe[n].ansi16m(...s) : t === "ansi256" ? xe[n].ansi256(xe.rgbToAnsi256(...s)) : xe[n].ansi(xe.rgbToAnsi(...s)) : e === "hex" ? ri("rgb", t, n, ...xe.hexToRgb(...s)) : xe[n][e](...s), P1 = ["rgb", "hex", "ansi256"];
-for (const e of P1) {
+const ri = (e, t, n, ...s) => e === "rgb" ? t === "ansi16m" ? xe[n].ansi16m(...s) : t === "ansi256" ? xe[n].ansi256(xe.rgbToAnsi256(...s)) : xe[n].ansi(xe.rgbToAnsi(...s)) : e === "hex" ? ri("rgb", t, n, ...xe.hexToRgb(...s)) : xe[n][e](...s), R1 = ["rgb", "hex", "ansi256"];
+for (const e of R1) {
   Jt[e] = {
     get() {
       const { level: n } = this;
@@ -18846,7 +18911,7 @@ for (const e of P1) {
     }
   };
 }
-const R1 = Object.defineProperties(() => {
+const j1 = Object.defineProperties(() => {
 }, {
   ...Jt,
   level: {
@@ -18868,9 +18933,9 @@ const R1 = Object.defineProperties(() => {
     parent: n
   };
 }, Ps = (e, t, n) => {
-  const s = (...r) => j1(s, r.length === 1 ? "" + r[0] : r.join(" "));
-  return Object.setPrototypeOf(s, R1), s[si] = e, s[Gt] = t, s[yn] = n, s;
-}, j1 = (e, t) => {
+  const s = (...r) => L1(s, r.length === 1 ? "" + r[0] : r.join(" "));
+  return Object.setPrototypeOf(s, j1), s[si] = e, s[Gt] = t, s[yn] = n, s;
+}, L1 = (e, t) => {
   if (e.level <= 0 || !t)
     return e[yn] ? "" : t;
   let n = e[Gt];
@@ -18879,16 +18944,16 @@ const R1 = Object.defineProperties(() => {
   const { openAll: s, closeAll: r } = n;
   if (t.includes("\x1B"))
     for (; n !== void 0; )
-      t = C1(t, n.close, n.open), n = n.parent;
+      t = x1(t, n.close, n.open), n = n.parent;
   const i = t.indexOf(`
 `);
-  return i !== -1 && (t = x1(t, r, s, i)), s + t + r;
+  return i !== -1 && (t = F1(t, r, s, i)), s + t + r;
 };
 Object.defineProperties(Cn.prototype, Jt);
 const oi = Cn();
 Cn({ level: kl ? kl.level : 0 });
-const Dh = "0.10.0";
-function L1() {
+const Dh = "0.10.1";
+function z1() {
   if (process.env.NO_COLOR) return 0;
   const e = process.env.FORCE_COLOR;
   if (e === "0") return 0;
@@ -18899,23 +18964,23 @@ function L1() {
   const n = process.env.TERM ?? "", s = process.env.COLORTERM ?? "";
   return s === "truecolor" || s === "24bit" ? 3 : /-256(color)?$/i.test(n) ? 2 : n === "" || n === "dumb" ? 0 : 1;
 }
-oi.level = L1();
-const z1 = `
+oi.level = z1();
+const D1 = `
 ██████████
 ▄▄▄▄   ▗▄▄  ▗▄█▙▄▖ ▗▄▄▖   ▄▄▄ ▐█  ▄▖ ▀▀█    ▄▄▖   ▄▄▄   ▄▄▄
 ██▛▘▗▟████  ▝▀█▛▀▘ ▀ ▝█▖ █▙ ▝▘▐█▗▟▀    █  ▗█▘ ▜▙ █▙ ▝▘ █▙ ▝▘
 █▛ ▗██████    █▌  ▐█▀▀█▌  ▀▀▜▙▐█▀▜▙    █  ▐█▀▀▀▀  ▀▀▜▙  ▀▀▜▙
 █▘ ███████    ▀▀▀▘▝▀▀▀▀▀ ▀▀▀▀▘▝▀  ▀▘ ▀▀▀▀▀ ▝▀▀▀▘ ▀▀▀▀▘ ▀▀▀▀▘
 `.trim();
-function D1() {
-  const e = oi.hex("#2B7384")(z1), t = oi.dim(`v${Dh}`);
+function M1() {
+  const e = oi.hex("#2B7384")(D1), t = oi.dim(`v${Dh}`);
   return `${e}
 ${t}`;
 }
 function Mh() {
   return Dh;
 }
-function M1(e, t = []) {
+function U1(e, t = []) {
   const n = new Set(e.map((a) => a.installDir)), s = new Set(
     t.filter((a) => a !== Co)
   ), r = Cs.map((a) => a.dir).filter(
@@ -18927,8 +18992,8 @@ function M1(e, t = []) {
     hint: s.has(a.dir) ? "installed" : n.has(a.dir) ? "detected" : a.dir === xs ? "generic agent skills" : "not detected"
   })), initialValues: i };
 }
-async function U1(e) {
-  const t = await fr(e), n = await Oo(e), s = Object.keys(n.targets), { options: r, initialValues: i } = M1(
+async function B1(e) {
+  const t = await fr(e), n = await Oo(e), s = Object.keys(n.targets), { options: r, initialValues: i } = U1(
     t,
     s
   );
@@ -18949,7 +19014,7 @@ async function U1(e) {
     return o;
   }
 }
-async function B1(e) {
+async function Z1(e) {
   if (await st(e, { silent: !0 }))
     return { prompted: !1, loggedIn: !0 };
   if (Y$(
@@ -18977,7 +19042,7 @@ async function B1(e) {
   };
 }
 var es = { exports: {} }, Sl;
-function Z1() {
+function q1() {
   if (Sl) return es.exports;
   Sl = 1;
   var e = String, t = function() {
@@ -18985,9 +19050,9 @@ function Z1() {
   };
   return es.exports = t(), es.exports.createColors = t, es.exports;
 }
-var q1 = /* @__PURE__ */ Z1();
-const lt = /* @__PURE__ */ S$(q1);
-async function G1(e) {
+var G1 = /* @__PURE__ */ q1();
+const lt = /* @__PURE__ */ S$(G1);
+async function J1(e) {
   const t = [];
   for (const n of e.entries)
     if (!(!(n.additions.skills.length > 0 || n.additions.commands.length > 0 || n.removals.skills.length > 0 || n.removals.commands.length > 0) && n.unchanged.skills.length === 0)) {
@@ -19010,12 +19075,12 @@ async function G1(e) {
 `) || "No changes."), e.hasRemovals ? Lo(
     "summary",
     () => Fh({
-      message: J1(e),
+      message: V1(e),
       initialValue: !0
     })
   ) : !0;
 }
-function J1(e) {
+function V1(e) {
   const t = [];
   for (const n of e.entries) {
     if (n.mode === "canonical") continue;
@@ -19026,15 +19091,15 @@ function J1(e) {
   }
   return t.length === 0 ? "Some files recorded in the previous install will be removed. Proceed?" : `Remove Taskless from ${t.join(", ")}?`;
 }
-async function V1(e) {
+async function W1(e) {
   const t = Date.now(), n = await _e(e.cwd);
   let s, r = [];
   const i = [];
   let o = !1, a = !1;
-  console.error(D1()), J$(" Taskless setup ");
+  console.error(M1()), J$(" Taskless setup ");
   try {
-    r = await U1(e.cwd);
-    const c = await B1(e.cwd);
+    r = await B1(e.cwd);
+    const c = await Z1(e.cwd);
     o = c.prompted, a = c.loggedIn;
     const f = wh(
       r,
@@ -19044,7 +19109,7 @@ async function V1(e) {
       cliVersion: u.cliVersion,
       targets: vh(f)
     });
-    if (!await G1(d))
+    if (!await J1(d))
       return cl("Install cancelled. Run `taskless init` to try again."), s = "summary", l({ status: "cancelled" });
     await Vt(e.cwd, {
       onNotice: (p) => Fe.info(p)
@@ -19075,7 +19140,7 @@ async function V1(e) {
     };
   }
 }
-function W1(e) {
+function K1(e) {
   return e || process.env.CI === "true" || process.env.CI === "1" ? !1 : process.stdout.isTTY === !0 && process.stdin.isTTY === !0;
 }
 const Uh = {
@@ -19102,8 +19167,8 @@ const Uh = {
   },
   async run({ args: e }) {
     const t = D(e.dir ?? process.cwd()), n = await _e(t);
-    if (W1(e["no-interactive"])) {
-      (await V1({ cwd: t })).status === "cancelled" && (process.exitCode = 1);
+    if (K1(e["no-interactive"])) {
+      (await W1({ cwd: t })).status === "cancelled" && (process.exitCode = 1);
       return;
     }
     !e["no-interactive"] && process.stdout.isTTY !== !0 && console.error(
@@ -19114,7 +19179,7 @@ const Uh = {
       Lh({ commandsInstalled: r.commandsInstalled })
     ), n.capture("cli_installed");
   }
-}, K1 = {
+}, H1 = {
   meta: {
     name: "update",
     description: "Update Taskless skills in detected tools (non-interactive install)"
@@ -19206,30 +19271,30 @@ function ts(e) {
   }
   return t;
 }
-const H1 = M({
+const Y1 = M({
   name: C(),
   installedVersion: C().optional(),
   currentVersion: C(),
   current: bt()
-}), Y1 = M({
-  name: C(),
-  skills: J(H1)
 }), Q1 = M({
+  name: C(),
+  skills: J(Y1)
+}), X1 = M({
   user: C(),
   email: C(),
   orgs: J(C())
-}), X1 = M({
+}), eI = M({
   success: it(!0),
   version: C().describe("CLI version"),
-  tools: J(Y1).describe("Detected tools and skill status"),
+  tools: J(Q1).describe("Detected tools and skill status"),
   loggedIn: bt().describe("Whether the user is authenticated"),
-  auth: Q1.optional().describe("User identity if logged in")
+  auth: X1.optional().describe("User identity if logged in")
 });
 M({
   success: it(!1),
   error: C().describe("Error message")
 });
-const eI = {
+const tI = {
   meta: {
     name: "info",
     description: "Show Taskless CLI information"
@@ -19267,13 +19332,13 @@ const eI = {
     }
     const i = {
       success: !0,
-      version: "0.10.0",
+      version: "0.10.1",
       tools: n,
       loggedIn: s !== void 0,
       auth: r
     };
     if (e.json) {
-      const o = X1.safeParse(i);
+      const o = eI.safeParse(i);
       if (!o.success) {
         console.log(
           JSON.stringify(
@@ -19288,7 +19353,7 @@ const eI = {
       console.log(JSON.stringify(o.data));
       return;
     }
-    if (console.log(`Taskless CLI v0.10.0
+    if (console.log(`Taskless CLI v0.10.1
 `), n.length === 0)
       console.log("Tools: none detected");
     else {
@@ -19330,22 +19395,22 @@ async function Zh(e) {
     );
   return { token: t, orgSubject: s, repositoryUrl: n };
 }
-const tI = "https://json-schema.org/draft/2020-12/schema", nI = "ast-grep rule", sI = "Used for global rules, rewriters, and pyo3/napi", rI = "object", iI = { rule: { description: "A rule object to find matching AST nodes", $ref: "#/$defs/SerializableRule" }, constraints: { description: "Additional meta variables pattern to filter matching", type: ["object", "null"], additionalProperties: { $ref: "#/$defs/SerializableRule" } }, utils: { description: "Utility rules that can be used in `matches`", type: ["object", "null"], additionalProperties: { $ref: "#/$defs/SerializableRule" } }, transform: { description: `A dictionary for metavariable manipulation. Dict key is the new variable name.
+const nI = "https://json-schema.org/draft/2020-12/schema", sI = "ast-grep rule", rI = "Used for global rules, rewriters, and pyo3/napi", iI = "object", oI = { rule: { description: "A rule object to find matching AST nodes", $ref: "#/$defs/SerializableRule" }, constraints: { description: "Additional meta variables pattern to filter matching", type: ["object", "null"], additionalProperties: { $ref: "#/$defs/SerializableRule" } }, utils: { description: "Utility rules that can be used in `matches`", type: ["object", "null"], additionalProperties: { $ref: "#/$defs/SerializableRule" } }, transform: { description: `A dictionary for metavariable manipulation. Dict key is the new variable name.
 Dict value is a [transformation] that specifies how meta var is processed.
 See [transformation doc](https://ast-grep.github.io/reference/yaml/transformation.html).`, type: ["object", "null"], additionalProperties: { $ref: "#/$defs/Transformation" } }, fix: { description: `A pattern string or a FixConfig object to auto fix the issue.
 It can reference metavariables appeared in rule.
 See details in fix [object reference](https://ast-grep.github.io/reference/yaml/fix.html#fixconfig).`, anyOf: [{ $ref: "#/$defs/SerializableFixer" }, { type: "null" }] }, id: { description: "Unique, descriptive identifier, e.g., no-unused-variable", type: "string", default: "" }, language: { description: "Specify the language to parse and the file extension to include in matching.", $ref: "#/$defs/Language" }, rewriters: { description: "Rewrite rules for `rewrite` transformation", type: ["array", "null"], items: { $ref: "#/$defs/SerializableRewriter" } }, message: { description: `Main message highlighting why this rule fired. It should be single line and concise,
 but specific enough to be understood without additional context.`, type: "string", default: "" }, note: { description: "Additional notes to elaborate the message and provide potential fix to the issue.\n`notes` can contain markdown syntax, but it cannot reference meta-variables.", type: ["string", "null"] }, severity: { description: "One of: hint, info, warning, or error", $ref: "#/$defs/Severity", default: "hint" }, labels: { description: `Custom label dictionary to configure reporting. Key is the meta-variable name and
-value is the label message and label style.`, type: ["object", "null"], additionalProperties: { $ref: "#/$defs/LabelConfig" } }, files: { description: "Glob patterns to specify that the rule only applies to matching files", type: ["array", "null"], items: { $ref: "#/$defs/RuleFileGlob" } }, ignores: { description: "Glob patterns that exclude rules from applying to files", type: ["array", "null"], items: { $ref: "#/$defs/RuleFileGlob" } }, url: { description: "Documentation link to this rule", type: ["string", "null"] }, metadata: { description: "Extra information for the rule", anyOf: [{ $ref: "#/$defs/Metadata" }, { type: "null" }] } }, oI = ["rule", "language"], aI = /* @__PURE__ */ JSON.parse('{"SerializableRule":{"description":"A rule object to find matching AST nodes. We have three categories of rules in ast-grep.\\n\\n* Atomic: the most basic rule to match AST. We have two variants: Pattern and Kind.\\n\\n* Relational: filter matched target according to their position relative to other nodes.\\n\\n* Composite: use logic operation all/any/not to compose the above rules to larger rules.\\n\\nEvery rule has it\'s unique name so we can combine several rules in one object.","type":"object","properties":{"pattern":{"description":"A pattern string or a pattern object.","$ref":"#/$defs/PatternStyle"},"kind":{"description":"The kind name of the node to match. You can look up code\'s kind names in playground.","type":"string"},"regex":{"description":"A Rust regular expression to match the node\'s text. https://docs.rs/regex/latest/regex/#syntax","type":"string"},"nthChild":{"description":"`nth_child` accepts number, string or object.\\nIt specifies the position in nodes\' sibling list.","$ref":"#/$defs/SerializableNthChild"},"range":{"description":"`range` accepts a range object.\\nthe target node must exactly appear in the range.","$ref":"#/$defs/SerializableRange"},"inside":{"description":"`inside` accepts a relational rule object.\\nthe target node must appear inside of another node matching the `inside` sub-rule.","$ref":"#/$defs/Relation"},"has":{"description":"`has` accepts a relational rule object.\\nthe target node must has a descendant node matching the `has` sub-rule.","$ref":"#/$defs/Relation"},"precedes":{"description":"`precedes` accepts a relational rule object.\\nthe target node must appear before another node matching the `precedes` sub-rule.","$ref":"#/$defs/Relation"},"follows":{"description":"`follows` accepts a relational rule object.\\nthe target node must appear after another node matching the `follows` sub-rule.","$ref":"#/$defs/Relation"},"all":{"description":"A list of sub rules and matches a node if all of sub rules match.\\nThe meta variables of the matched node contain all variables from the sub-rules.","type":"array","items":{"$ref":"#/$defs/SerializableRule"}},"any":{"description":"A list of sub rules and matches a node if any of sub rules match.\\nThe meta variables of the matched node only contain those of the matched sub-rule.","type":"array","items":{"$ref":"#/$defs/SerializableRule"}},"not":{"description":"A single sub-rule and matches a node if the sub rule does not match.","$ref":"#/$defs/SerializableRule"},"matches":{"description":"A utility rule id and matches a node if the utility rule matches.","type":"string"}},"additionalProperties":false},"PatternStyle":{"description":"A String pattern will match one single AST node according to pattern syntax.\\nOr an object with field `context`, `selector` and optionally `strictness`.","anyOf":[{"type":"string"},{"type":"object","properties":{"context":{"description":"The surrounding code that helps to resolve any ambiguity in the syntax.","type":"string"},"selector":{"description":"The sub-syntax node kind that is the actual matcher of the pattern.","type":["string","null"]},"strictness":{"description":"Strictness of the pattern. More strict pattern matches fewer nodes.","anyOf":[{"$ref":"#/$defs/Strictness"},{"type":"null"}]}},"additionalProperties":false,"required":["context"]}]},"Strictness":{"oneOf":[{"description":"all nodes are matched","type":"string","const":"cst"},{"description":"all nodes except source trivial nodes are matched.","type":"string","const":"smart"},{"description":"only ast nodes are matched","type":"string","const":"ast"},{"description":"ast-nodes excluding comments are matched","type":"string","const":"relaxed"},{"description":"ast-nodes excluding comments, without text","type":"string","const":"signature"},{"description":"similar to smart, but node kinds are ignored, only text is matched.","type":"string","const":"template"}]},"SerializableNthChild":{"description":"`nthChild` accepts either a number, a string or an object.","anyOf":[{"description":"Simple syntax","$ref":"#/$defs/NthChildSimple"},{"description":"Object style syntax","type":"object","properties":{"position":{"description":"nth-child syntax","$ref":"#/$defs/NthChildSimple"},"ofRule":{"description":"select the nth node that matches the rule, like CSS\'s of syntax","anyOf":[{"$ref":"#/$defs/SerializableRule"},{"type":"null"}]},"reverse":{"description":"matches from the end instead like CSS\'s nth-last-child","type":"boolean","default":false}},"required":["position"]}]},"NthChildSimple":{"description":"A string or number describing the indices of matching nodes in a list of siblings.","anyOf":[{"description":"A number indicating the precise element index","type":"integer","format":"uint","minimum":0},{"description":"Functional notation like CSS\'s An + B","type":"string"}]},"SerializableRange":{"description":"Represents a position in source code using 0-based line and column numbers","type":"object","properties":{"start":{"description":"start position in the source code","$ref":"#/$defs/SerializablePosition"},"end":{"description":"end position in the source code","$ref":"#/$defs/SerializablePosition"}},"required":["start","end"]},"SerializablePosition":{"description":"Represents a zero-based character-wise position in a document","type":"object","properties":{"line":{"description":"0-based line number in the source code","type":"integer","format":"uint","minimum":0},"column":{"description":"0-based column number in the source code","type":["integer","null"],"format":"uint","minimum":0}},"required":["line"]},"Relation":{"description":"A relational rule object, which is a Rule object with two additional fields stopBy and field.","type":"object","properties":{"pattern":{"description":"A pattern string or a pattern object.","$ref":"#/$defs/PatternStyle"},"kind":{"description":"The kind name of the node to match. You can look up code\'s kind names in playground.","type":"string"},"regex":{"description":"A Rust regular expression to match the node\'s text. https://docs.rs/regex/latest/regex/#syntax","type":"string"},"nthChild":{"description":"`nth_child` accepts number, string or object.\\nIt specifies the position in nodes\' sibling list.","$ref":"#/$defs/SerializableNthChild"},"range":{"description":"`range` accepts a range object.\\nthe target node must exactly appear in the range.","$ref":"#/$defs/SerializableRange"},"inside":{"description":"`inside` accepts a relational rule object.\\nthe target node must appear inside of another node matching the `inside` sub-rule.","$ref":"#/$defs/Relation"},"has":{"description":"`has` accepts a relational rule object.\\nthe target node must has a descendant node matching the `has` sub-rule.","$ref":"#/$defs/Relation"},"precedes":{"description":"`precedes` accepts a relational rule object.\\nthe target node must appear before another node matching the `precedes` sub-rule.","$ref":"#/$defs/Relation"},"follows":{"description":"`follows` accepts a relational rule object.\\nthe target node must appear after another node matching the `follows` sub-rule.","$ref":"#/$defs/Relation"},"all":{"description":"A list of sub rules and matches a node if all of sub rules match.\\nThe meta variables of the matched node contain all variables from the sub-rules.","type":"array","items":{"$ref":"#/$defs/SerializableRule"}},"any":{"description":"A list of sub rules and matches a node if any of sub rules match.\\nThe meta variables of the matched node only contain those of the matched sub-rule.","type":"array","items":{"$ref":"#/$defs/SerializableRule"}},"not":{"description":"A single sub-rule and matches a node if the sub rule does not match.","$ref":"#/$defs/SerializableRule"},"matches":{"description":"A utility rule id and matches a node if the utility rule matches.","type":"string"},"stopBy":{"$ref":"#/$defs/SerializableStopBy","default":"neighbor"},"field":{"type":["string","null"]}}},"SerializableStopBy":{"description":"Control how the relational rule search should stop","oneOf":[{"type":"string","enum":["neighbor","end"]},{"$ref":"#/$defs/SerializableRule"}]},"Transformation":{"anyOf":[{"type":"string"},{"$ref":"#/$defs/Trans"}]},"Trans":{"description":"Represents a transformation that can be applied to a matched AST node.\\nAvailable transformations are `substring`, `replace` and `convert`.","oneOf":[{"type":"object","properties":{"substring":{"$ref":"#/$defs/Substring"}},"required":["substring"],"additionalProperties":false},{"type":"object","properties":{"replace":{"$ref":"#/$defs/Replace"}},"required":["replace"],"additionalProperties":false},{"type":"object","properties":{"convert":{"$ref":"#/$defs/Convert"}},"required":["convert"],"additionalProperties":false},{"type":"object","properties":{"rewrite":{"$ref":"#/$defs/Rewrite"}},"required":["rewrite"],"additionalProperties":false}]},"Substring":{"description":"Extracts a substring from the meta variable\'s text content.\\n\\nBoth `start_char` and `end_char` support negative indexing,\\nwhich counts character from the end of an array, moving backwards.","type":"object","properties":{"source":{"description":"source meta variable to be transformed","type":"string"},"startChar":{"description":"optional starting character index of the substring, defaults to 0.","type":["integer","null"],"format":"int32"},"endChar":{"description":"optional ending character index of the substring, defaults to the end of the string.","type":["integer","null"],"format":"int32"}},"required":["source"]},"Replace":{"description":"Replaces a substring in the meta variable\'s text content with another string.","type":"object","properties":{"source":{"description":"source meta variable to be transformed","type":"string"},"replace":{"description":"a regex to find substring to be replaced","type":"string"},"by":{"description":"the replacement string","type":"string"}},"required":["source","replace","by"]},"Convert":{"description":"Converts the source meta variable\'s text content to a specified case format.","type":"object","properties":{"source":{"description":"source meta variable to be transformed","type":"string"},"toCase":{"description":"the target case format to convert the text content to","$ref":"#/$defs/StringCase"},"separatedBy":{"description":"optional separators to specify how to separate word","type":["array","null"],"items":{"$ref":"#/$defs/Separator"}}},"required":["source","toCase"]},"StringCase":{"description":"An enumeration representing different cases for strings.","type":"string","enum":["lowerCase","upperCase","capitalize","camelCase","snakeCase","kebabCase","pascalCase"]},"Separator":{"description":"Separator to split string. e.g. `user_accountName` -> `user`, `accountName`\\nIt will be rejoin according to `StringCase`.","type":"string","enum":["caseChange","dash","dot","slash","space","underscore"]},"Rewrite":{"type":"object","properties":{"source":{"type":"string"},"rewriters":{"type":"array","items":{"type":"string"}},"joinBy":{"type":["string","null"]}},"required":["source","rewriters"]},"SerializableFixer":{"description":"A pattern string or fix object to auto fix the issue.\\nIt can reference metavariables appeared in rule.","anyOf":[{"type":"string"},{"$ref":"#/$defs/SerializableFixConfig"},{"type":"array","items":{"$ref":"#/$defs/SerializableFixConfig"}}]},"SerializableFixConfig":{"type":"object","properties":{"template":{"type":"string"},"expandEnd":{"$ref":"#/$defs/Relation"},"expandStart":{"$ref":"#/$defs/Relation"},"title":{"type":["string","null"]}},"required":["template"]},"Language":{"description":"Placeholder for language, used in JSON schema only.","type":"string","example":"typescript"},"SerializableRewriter":{"description":"Used for global rules, rewriters, and pyo3/napi","type":"object","properties":{"rule":{"description":"A rule object to find matching AST nodes","$ref":"#/$defs/SerializableRule"},"constraints":{"description":"Additional meta variables pattern to filter matching","type":["object","null"],"additionalProperties":{"$ref":"#/$defs/SerializableRule"}},"utils":{"description":"Utility rules that can be used in `matches`","type":["object","null"],"additionalProperties":{"$ref":"#/$defs/SerializableRule"}},"transform":{"description":"A dictionary for metavariable manipulation. Dict key is the new variable name.\\nDict value is a [transformation] that specifies how meta var is processed.\\nSee [transformation doc](https://ast-grep.github.io/reference/yaml/transformation.html).","type":["object","null"],"additionalProperties":{"$ref":"#/$defs/Transformation"}},"fix":{"description":"A pattern string or a FixConfig object to auto fix the issue.\\nIt can reference metavariables appeared in rule.\\nSee details in fix [object reference](https://ast-grep.github.io/reference/yaml/fix.html#fixconfig).","anyOf":[{"$ref":"#/$defs/SerializableFixer"},{"type":"null"}]},"id":{"description":"Unique, descriptive identifier, e.g., no-unused-variable","type":"string"}},"required":["rule","id"]},"Severity":{"oneOf":[{"description":"A kind reminder for code with potential improvement.","type":"string","const":"hint"},{"description":"A suggestion that code can be improved or optimized.","type":"string","const":"info"},{"description":"A warning that code might produce bugs or does not follow best practice.","type":"string","const":"warning"},{"description":"An error that code produces bugs or has logic errors.","type":"string","const":"error"},{"description":"Turns off the rule.","type":"string","const":"off"}]},"LabelConfig":{"type":"object","properties":{"style":{"$ref":"#/$defs/LabelStyle"},"message":{"type":["string","null"]}},"required":["style"]},"LabelStyle":{"oneOf":[{"description":"Labels that describe the primary cause of a diagnostic.","type":"string","const":"primary"},{"description":"Labels that provide additional context for a diagnostic.","type":"string","const":"secondary"}]},"RuleFileGlob":{"anyOf":[{"description":"A glob pattern string","type":"string"},{"type":"object","properties":{"glob":{"description":"A glob pattern string","type":"string"},"caseInsensitive":{"description":"Whether the glob matching is case insensitive","type":"boolean","default":false}},"required":["glob"]}]},"Metadata":{"description":"Additional metadata for the rule, can be used to store extra information.","type":"object","additionalProperties":true}}'), lI = "Generated by fetch-ast-grep-schema.ts at 2026-03-31T02:04:24.481Z from ast-grep v0.41.0 (https://raw.githubusercontent.com/ast-grep/ast-grep/0.41.0/schemas/rule.json)", cI = {
-  $schema: tI,
-  title: nI,
-  description: sI,
-  type: rI,
-  properties: iI,
-  required: oI,
-  $defs: aI,
-  $comment: lI
-}, uI = _k(cI), fI = [
+value is the label message and label style.`, type: ["object", "null"], additionalProperties: { $ref: "#/$defs/LabelConfig" } }, files: { description: "Glob patterns to specify that the rule only applies to matching files", type: ["array", "null"], items: { $ref: "#/$defs/RuleFileGlob" } }, ignores: { description: "Glob patterns that exclude rules from applying to files", type: ["array", "null"], items: { $ref: "#/$defs/RuleFileGlob" } }, url: { description: "Documentation link to this rule", type: ["string", "null"] }, metadata: { description: "Extra information for the rule", anyOf: [{ $ref: "#/$defs/Metadata" }, { type: "null" }] } }, aI = ["rule", "language"], lI = /* @__PURE__ */ JSON.parse('{"SerializableRule":{"description":"A rule object to find matching AST nodes. We have three categories of rules in ast-grep.\\n\\n* Atomic: the most basic rule to match AST. We have two variants: Pattern and Kind.\\n\\n* Relational: filter matched target according to their position relative to other nodes.\\n\\n* Composite: use logic operation all/any/not to compose the above rules to larger rules.\\n\\nEvery rule has it\'s unique name so we can combine several rules in one object.","type":"object","properties":{"pattern":{"description":"A pattern string or a pattern object.","$ref":"#/$defs/PatternStyle"},"kind":{"description":"The kind name of the node to match. You can look up code\'s kind names in playground.","type":"string"},"regex":{"description":"A Rust regular expression to match the node\'s text. https://docs.rs/regex/latest/regex/#syntax","type":"string"},"nthChild":{"description":"`nth_child` accepts number, string or object.\\nIt specifies the position in nodes\' sibling list.","$ref":"#/$defs/SerializableNthChild"},"range":{"description":"`range` accepts a range object.\\nthe target node must exactly appear in the range.","$ref":"#/$defs/SerializableRange"},"inside":{"description":"`inside` accepts a relational rule object.\\nthe target node must appear inside of another node matching the `inside` sub-rule.","$ref":"#/$defs/Relation"},"has":{"description":"`has` accepts a relational rule object.\\nthe target node must has a descendant node matching the `has` sub-rule.","$ref":"#/$defs/Relation"},"precedes":{"description":"`precedes` accepts a relational rule object.\\nthe target node must appear before another node matching the `precedes` sub-rule.","$ref":"#/$defs/Relation"},"follows":{"description":"`follows` accepts a relational rule object.\\nthe target node must appear after another node matching the `follows` sub-rule.","$ref":"#/$defs/Relation"},"all":{"description":"A list of sub rules and matches a node if all of sub rules match.\\nThe meta variables of the matched node contain all variables from the sub-rules.","type":"array","items":{"$ref":"#/$defs/SerializableRule"}},"any":{"description":"A list of sub rules and matches a node if any of sub rules match.\\nThe meta variables of the matched node only contain those of the matched sub-rule.","type":"array","items":{"$ref":"#/$defs/SerializableRule"}},"not":{"description":"A single sub-rule and matches a node if the sub rule does not match.","$ref":"#/$defs/SerializableRule"},"matches":{"description":"A utility rule id and matches a node if the utility rule matches.","type":"string"}},"additionalProperties":false},"PatternStyle":{"description":"A String pattern will match one single AST node according to pattern syntax.\\nOr an object with field `context`, `selector` and optionally `strictness`.","anyOf":[{"type":"string"},{"type":"object","properties":{"context":{"description":"The surrounding code that helps to resolve any ambiguity in the syntax.","type":"string"},"selector":{"description":"The sub-syntax node kind that is the actual matcher of the pattern.","type":["string","null"]},"strictness":{"description":"Strictness of the pattern. More strict pattern matches fewer nodes.","anyOf":[{"$ref":"#/$defs/Strictness"},{"type":"null"}]}},"additionalProperties":false,"required":["context"]}]},"Strictness":{"oneOf":[{"description":"all nodes are matched","type":"string","const":"cst"},{"description":"all nodes except source trivial nodes are matched.","type":"string","const":"smart"},{"description":"only ast nodes are matched","type":"string","const":"ast"},{"description":"ast-nodes excluding comments are matched","type":"string","const":"relaxed"},{"description":"ast-nodes excluding comments, without text","type":"string","const":"signature"},{"description":"similar to smart, but node kinds are ignored, only text is matched.","type":"string","const":"template"}]},"SerializableNthChild":{"description":"`nthChild` accepts either a number, a string or an object.","anyOf":[{"description":"Simple syntax","$ref":"#/$defs/NthChildSimple"},{"description":"Object style syntax","type":"object","properties":{"position":{"description":"nth-child syntax","$ref":"#/$defs/NthChildSimple"},"ofRule":{"description":"select the nth node that matches the rule, like CSS\'s of syntax","anyOf":[{"$ref":"#/$defs/SerializableRule"},{"type":"null"}]},"reverse":{"description":"matches from the end instead like CSS\'s nth-last-child","type":"boolean","default":false}},"required":["position"]}]},"NthChildSimple":{"description":"A string or number describing the indices of matching nodes in a list of siblings.","anyOf":[{"description":"A number indicating the precise element index","type":"integer","format":"uint","minimum":0},{"description":"Functional notation like CSS\'s An + B","type":"string"}]},"SerializableRange":{"description":"Represents a position in source code using 0-based line and column numbers","type":"object","properties":{"start":{"description":"start position in the source code","$ref":"#/$defs/SerializablePosition"},"end":{"description":"end position in the source code","$ref":"#/$defs/SerializablePosition"}},"required":["start","end"]},"SerializablePosition":{"description":"Represents a zero-based character-wise position in a document","type":"object","properties":{"line":{"description":"0-based line number in the source code","type":"integer","format":"uint","minimum":0},"column":{"description":"0-based column number in the source code","type":["integer","null"],"format":"uint","minimum":0}},"required":["line"]},"Relation":{"description":"A relational rule object, which is a Rule object with two additional fields stopBy and field.","type":"object","properties":{"pattern":{"description":"A pattern string or a pattern object.","$ref":"#/$defs/PatternStyle"},"kind":{"description":"The kind name of the node to match. You can look up code\'s kind names in playground.","type":"string"},"regex":{"description":"A Rust regular expression to match the node\'s text. https://docs.rs/regex/latest/regex/#syntax","type":"string"},"nthChild":{"description":"`nth_child` accepts number, string or object.\\nIt specifies the position in nodes\' sibling list.","$ref":"#/$defs/SerializableNthChild"},"range":{"description":"`range` accepts a range object.\\nthe target node must exactly appear in the range.","$ref":"#/$defs/SerializableRange"},"inside":{"description":"`inside` accepts a relational rule object.\\nthe target node must appear inside of another node matching the `inside` sub-rule.","$ref":"#/$defs/Relation"},"has":{"description":"`has` accepts a relational rule object.\\nthe target node must has a descendant node matching the `has` sub-rule.","$ref":"#/$defs/Relation"},"precedes":{"description":"`precedes` accepts a relational rule object.\\nthe target node must appear before another node matching the `precedes` sub-rule.","$ref":"#/$defs/Relation"},"follows":{"description":"`follows` accepts a relational rule object.\\nthe target node must appear after another node matching the `follows` sub-rule.","$ref":"#/$defs/Relation"},"all":{"description":"A list of sub rules and matches a node if all of sub rules match.\\nThe meta variables of the matched node contain all variables from the sub-rules.","type":"array","items":{"$ref":"#/$defs/SerializableRule"}},"any":{"description":"A list of sub rules and matches a node if any of sub rules match.\\nThe meta variables of the matched node only contain those of the matched sub-rule.","type":"array","items":{"$ref":"#/$defs/SerializableRule"}},"not":{"description":"A single sub-rule and matches a node if the sub rule does not match.","$ref":"#/$defs/SerializableRule"},"matches":{"description":"A utility rule id and matches a node if the utility rule matches.","type":"string"},"stopBy":{"$ref":"#/$defs/SerializableStopBy","default":"neighbor"},"field":{"type":["string","null"]}}},"SerializableStopBy":{"description":"Control how the relational rule search should stop","oneOf":[{"type":"string","enum":["neighbor","end"]},{"$ref":"#/$defs/SerializableRule"}]},"Transformation":{"anyOf":[{"type":"string"},{"$ref":"#/$defs/Trans"}]},"Trans":{"description":"Represents a transformation that can be applied to a matched AST node.\\nAvailable transformations are `substring`, `replace` and `convert`.","oneOf":[{"type":"object","properties":{"substring":{"$ref":"#/$defs/Substring"}},"required":["substring"],"additionalProperties":false},{"type":"object","properties":{"replace":{"$ref":"#/$defs/Replace"}},"required":["replace"],"additionalProperties":false},{"type":"object","properties":{"convert":{"$ref":"#/$defs/Convert"}},"required":["convert"],"additionalProperties":false},{"type":"object","properties":{"rewrite":{"$ref":"#/$defs/Rewrite"}},"required":["rewrite"],"additionalProperties":false}]},"Substring":{"description":"Extracts a substring from the meta variable\'s text content.\\n\\nBoth `start_char` and `end_char` support negative indexing,\\nwhich counts character from the end of an array, moving backwards.","type":"object","properties":{"source":{"description":"source meta variable to be transformed","type":"string"},"startChar":{"description":"optional starting character index of the substring, defaults to 0.","type":["integer","null"],"format":"int32"},"endChar":{"description":"optional ending character index of the substring, defaults to the end of the string.","type":["integer","null"],"format":"int32"}},"required":["source"]},"Replace":{"description":"Replaces a substring in the meta variable\'s text content with another string.","type":"object","properties":{"source":{"description":"source meta variable to be transformed","type":"string"},"replace":{"description":"a regex to find substring to be replaced","type":"string"},"by":{"description":"the replacement string","type":"string"}},"required":["source","replace","by"]},"Convert":{"description":"Converts the source meta variable\'s text content to a specified case format.","type":"object","properties":{"source":{"description":"source meta variable to be transformed","type":"string"},"toCase":{"description":"the target case format to convert the text content to","$ref":"#/$defs/StringCase"},"separatedBy":{"description":"optional separators to specify how to separate word","type":["array","null"],"items":{"$ref":"#/$defs/Separator"}}},"required":["source","toCase"]},"StringCase":{"description":"An enumeration representing different cases for strings.","type":"string","enum":["lowerCase","upperCase","capitalize","camelCase","snakeCase","kebabCase","pascalCase"]},"Separator":{"description":"Separator to split string. e.g. `user_accountName` -> `user`, `accountName`\\nIt will be rejoin according to `StringCase`.","type":"string","enum":["caseChange","dash","dot","slash","space","underscore"]},"Rewrite":{"type":"object","properties":{"source":{"type":"string"},"rewriters":{"type":"array","items":{"type":"string"}},"joinBy":{"type":["string","null"]}},"required":["source","rewriters"]},"SerializableFixer":{"description":"A pattern string or fix object to auto fix the issue.\\nIt can reference metavariables appeared in rule.","anyOf":[{"type":"string"},{"$ref":"#/$defs/SerializableFixConfig"},{"type":"array","items":{"$ref":"#/$defs/SerializableFixConfig"}}]},"SerializableFixConfig":{"type":"object","properties":{"template":{"type":"string"},"expandEnd":{"$ref":"#/$defs/Relation"},"expandStart":{"$ref":"#/$defs/Relation"},"title":{"type":["string","null"]}},"required":["template"]},"Language":{"description":"Placeholder for language, used in JSON schema only.","type":"string","example":"typescript"},"SerializableRewriter":{"description":"Used for global rules, rewriters, and pyo3/napi","type":"object","properties":{"rule":{"description":"A rule object to find matching AST nodes","$ref":"#/$defs/SerializableRule"},"constraints":{"description":"Additional meta variables pattern to filter matching","type":["object","null"],"additionalProperties":{"$ref":"#/$defs/SerializableRule"}},"utils":{"description":"Utility rules that can be used in `matches`","type":["object","null"],"additionalProperties":{"$ref":"#/$defs/SerializableRule"}},"transform":{"description":"A dictionary for metavariable manipulation. Dict key is the new variable name.\\nDict value is a [transformation] that specifies how meta var is processed.\\nSee [transformation doc](https://ast-grep.github.io/reference/yaml/transformation.html).","type":["object","null"],"additionalProperties":{"$ref":"#/$defs/Transformation"}},"fix":{"description":"A pattern string or a FixConfig object to auto fix the issue.\\nIt can reference metavariables appeared in rule.\\nSee details in fix [object reference](https://ast-grep.github.io/reference/yaml/fix.html#fixconfig).","anyOf":[{"$ref":"#/$defs/SerializableFixer"},{"type":"null"}]},"id":{"description":"Unique, descriptive identifier, e.g., no-unused-variable","type":"string"}},"required":["rule","id"]},"Severity":{"oneOf":[{"description":"A kind reminder for code with potential improvement.","type":"string","const":"hint"},{"description":"A suggestion that code can be improved or optimized.","type":"string","const":"info"},{"description":"A warning that code might produce bugs or does not follow best practice.","type":"string","const":"warning"},{"description":"An error that code produces bugs or has logic errors.","type":"string","const":"error"},{"description":"Turns off the rule.","type":"string","const":"off"}]},"LabelConfig":{"type":"object","properties":{"style":{"$ref":"#/$defs/LabelStyle"},"message":{"type":["string","null"]}},"required":["style"]},"LabelStyle":{"oneOf":[{"description":"Labels that describe the primary cause of a diagnostic.","type":"string","const":"primary"},{"description":"Labels that provide additional context for a diagnostic.","type":"string","const":"secondary"}]},"RuleFileGlob":{"anyOf":[{"description":"A glob pattern string","type":"string"},{"type":"object","properties":{"glob":{"description":"A glob pattern string","type":"string"},"caseInsensitive":{"description":"Whether the glob matching is case insensitive","type":"boolean","default":false}},"required":["glob"]}]},"Metadata":{"description":"Additional metadata for the rule, can be used to store extra information.","type":"object","additionalProperties":true}}'), cI = "Generated by fetch-ast-grep-schema.ts at 2026-03-31T02:04:24.481Z from ast-grep v0.41.0 (https://raw.githubusercontent.com/ast-grep/ast-grep/0.41.0/schemas/rule.json)", uI = {
+  $schema: nI,
+  title: sI,
+  description: rI,
+  type: iI,
+  properties: oI,
+  required: aI,
+  $defs: lI,
+  $comment: cI
+}, fI = _k(uI), dI = [
   "id",
   "language",
   "severity",
@@ -19384,22 +19449,22 @@ function Rs(e, t = "") {
   }
   return n;
 }
-const dI = /^[a-z0-9][a-z0-9-]*$/;
+const hI = /^[a-z0-9][a-z0-9-]*$/;
 function xn(e) {
-  return dI.test(e);
+  return hI.test(e);
 }
-function hI(e) {
+function pI(e) {
   return e.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
 }
-function pI(e) {
-  const t = uI.safeParse(e);
+function mI(e) {
+  const t = fI.safeParse(e);
   return t.success ? { valid: !0, errors: [] } : { valid: !1, errors: t.error.issues.map(
     (s) => `${s.path.join(".")}: ${s.message}`
   ) };
 }
-async function mI(e, t, n) {
+async function gI(e, t, n) {
   const s = [];
-  for (const o of fI)
+  for (const o of dI)
     (!(o in n) || n[o] === void 0 || n[o] === null || n[o] === "") && s.push(`Missing required field: ${o}`);
   for (const o of ["rule", "constraints", "utils"]) {
     const a = n[o];
@@ -19431,7 +19496,7 @@ async function mI(e, t, n) {
     `No test file found for rule "${t}" in .taskless/rule-tests/`
   ), { valid: s.length === 0, errors: s, hasTestFile: i };
 }
-async function gI(e, t) {
+async function yI(e, t) {
   await lc(e);
   const n = _i();
   return new Promise((s) => {
@@ -19443,7 +19508,7 @@ async function gI(e, t) {
         ".taskless/sgconfig.yml",
         "--skip-snapshot-tests",
         "--filter",
-        `^${hI(t)}$`
+        `^${pI(t)}$`
       ],
       {
         cwd: e,
@@ -19481,7 +19546,7 @@ async function gI(e, t) {
     });
   });
 }
-async function yI(e, t) {
+async function bI(e, t) {
   if (!xn(t)) {
     const l = `Invalid rule ID "${t}". Rule IDs must be lowercase alphanumeric with hyphens.`;
     return {
@@ -19537,11 +19602,11 @@ async function yI(e, t) {
       }
     };
   }
-  const i = pI(r), o = await mI(
+  const i = mI(r), o = await gI(
     e,
     t,
     r && typeof r == "object" ? r : {}
-  ), a = o.hasTestFile ? await gI(e, t) : {
+  ), a = o.hasTestFile ? await yI(e, t) : {
     valid: !1,
     errors: ["Skipped: no test file found"],
     passed: 0,
@@ -19569,7 +19634,7 @@ function qh() {
   ].join(`
 `);
 }
-async function bI(e, t) {
+async function wI(e, t) {
   const n = Ls(e), { data: s, error: r, response: i } = await n.POST("/cli/api/rule", {
     body: t
   });
@@ -19604,7 +19669,7 @@ async function Gh(e, t) {
   }
   return s;
 }
-async function wI(e, t, n) {
+async function vI(e, t, n) {
   const s = Ls(e), { data: r, error: i, response: o } = await s.POST(
     "/cli/api/rule/{ruleId}/iterate",
     {
@@ -19650,7 +19715,7 @@ async function Wh(e, t) {
   }
   return s;
 }
-async function vI(e, t) {
+async function kI(e, t) {
   if (!xn(t))
     return null;
   const n = O(e, ".taskless", "rule-metadata", `${t}.yml`);
@@ -19663,7 +19728,7 @@ async function vI(e, t) {
     throw s;
   }
 }
-async function kI(e, t) {
+async function _I(e, t) {
   if (!xn(t))
     return !1;
   const n = O(e, ".taskless", "rules"), s = O(n, `${t}.yml`);
@@ -19702,7 +19767,7 @@ async function kI(e, t) {
   }
   return r;
 }
-const _I = M({
+const SI = M({
   id: C().describe("Rule ID"),
   ticketId: C().describe("Ticket ID that produced this rule"),
   installationId: C().optional().describe("GitHub App installation ID (absent for public repos)"),
@@ -19733,17 +19798,17 @@ M({
 const ai = M({
   valid: bt(),
   errors: J(C()).describe("Human-readable error messages")
-}), SI = ai.extend({
+}), $I = ai.extend({
   passed: Qe().describe("Number of test cases that passed"),
   failed: Qe().describe("Number of test cases that failed")
-}), $I = M({
+}), II = M({
   success: bt().describe("True if all layers passed"),
   ruleId: C(),
   schema: ai.describe("Layer 1: Zod schema validation"),
   requirements: ai.describe(
     "Layer 2: Taskless requirement checks"
   ),
-  tests: SI.describe("Layer 3: sg test execution")
+  tests: $I.describe("Layer 3: sg test execution")
 });
 M({
   success: it(!1),
@@ -19762,7 +19827,7 @@ function Yh() {
   ].join(`
 `);
 }
-const II = {
+const EI = {
   meta: {
     name: "create",
     description: "Create a new rule from a JSON file (use --from to specify the input file)"
@@ -19841,7 +19906,7 @@ const II = {
       }
       let f;
       try {
-        f = (await bI(c.token, {
+        f = (await wI(c.token, {
           orgId: c.orgSubject,
           repositoryUrl: c.repositoryUrl,
           prompt: l.prompt,
@@ -19940,7 +20005,7 @@ const II = {
       r !== void 0 && n.capture("cli_rule_created", { ruleCount: r });
     }
   }
-}, EI = {
+}, TI = {
   meta: {
     name: "improve",
     description: "Improve an existing rule with guidance (use --from to specify the input file)"
@@ -20019,7 +20084,7 @@ const II = {
       }
       let f;
       try {
-        f = (await wI(c.token, l.ruleId, {
+        f = (await vI(c.token, l.ruleId, {
           orgId: c.orgSubject,
           guidance: l.guidance,
           references: l.references
@@ -20122,7 +20187,7 @@ const II = {
       });
     }
   }
-}, TI = {
+}, AI = {
   meta: {
     name: "meta",
     description: "Show sidecar metadata for a rule"
@@ -20154,14 +20219,14 @@ const II = {
     function n(r, i = "INTERNAL_ERROR") {
       throw e.json ? console.log(JSON.stringify(Te(i, r))) : console.error(`Error: ${r}`), process.exitCode = 1, new mt(r);
     }
-    const s = await vI(t, e.id);
+    const s = await kI(t, e.id);
     if (s || n(
       `No metadata found for rule "${e.id}". Expected .taskless/rule-metadata/${e.id}.yml`,
       "RULE_NOT_FOUND"
     ), e.json) {
       let r;
       try {
-        r = _I.parse({ id: e.id, ...s });
+        r = SI.parse({ id: e.id, ...s });
       } catch (i) {
         i instanceof ji && n(
           `Invalid metadata for rule "${e.id}": ${i.issues.map((o) => o.message).join(", ")}`,
@@ -20176,7 +20241,7 @@ const II = {
         console.log(`  ${r}: ${String(i)}`);
     }
   }
-}, AI = {
+}, OI = {
   meta: {
     name: "delete",
     description: "Delete a rule and its test files"
@@ -20207,7 +20272,7 @@ const II = {
     const t = D(e.dir ?? process.cwd()), n = await _e(t), s = e.id;
     let r = !1;
     try {
-      if (await kI(t, s))
+      if (await _I(t, s))
         e.json || console.log(`Deleted rule "${s}" and associated test files.`), r = !0;
       else {
         const o = `Rule "${s}" not found in .taskless/rules/${s}.yml`;
@@ -20219,7 +20284,7 @@ const II = {
       r && n.capture("cli_rule_deleted");
     }
   }
-}, OI = {
+}, CI = {
   meta: {
     name: "verify",
     description: "Validate a rule against the ast-grep schema and run tests"
@@ -20259,9 +20324,9 @@ const II = {
       ), process.exitCode = 1;
       return;
     }
-    const n = await yI(t, e.id);
+    const n = await bI(t, e.id);
     if (e.json)
-      console.log(JSON.stringify($I.parse(n)));
+      console.log(JSON.stringify(II.parse(n)));
     else {
       console.log(`Verifying rule: ${n.ruleId}
 `), console.log(
@@ -20286,20 +20351,20 @@ Result: ${n.success ? "✓ All checks passed" : "✗ Verification failed"}`
     }
     n.success || (process.exitCode = 1);
   }
-}, CI = {
+}, xI = {
   meta: {
     name: "rule",
     description: "Manage Taskless rules"
   },
   subCommands: {
-    create: II,
-    improve: EI,
-    meta: TI,
-    delete: AI,
-    verify: OI
+    create: EI,
+    improve: TI,
+    meta: AI,
+    delete: OI,
+    verify: CI
   }
 };
-function xI(e) {
+function FI(e) {
   const t = /* @__PURE__ */ new Set(["-d", "--dir"]), n = [];
   for (let r = 0; r < e.length; r++) {
     const i = e[r];
@@ -20313,7 +20378,7 @@ function xI(e) {
   const s = n[0];
   return s === "rule" && n[1] ? `rule ${n[1]}` : s;
 }
-function FI(e) {
+function NI(e) {
   for (let t = 0; t < e.length; t++) {
     const n = e[t];
     if ((n === "-d" || n === "--dir") && e[t + 1])
@@ -20323,7 +20388,7 @@ function FI(e) {
   }
   return process.cwd();
 }
-function NI(e, t) {
+function PI(e, t) {
   if (t.error !== void 0) {
     const n = t.error instanceof mt && t.error.code ? t.error.code : "INTERNAL_ERROR";
     e.capture("cli_error", { command: t.command, code: n });
@@ -20338,17 +20403,17 @@ function NI(e, t) {
 }
 const Qh = {
   init: Uh,
-  update: K1,
-  info: eI,
+  update: H1,
+  info: tI,
   detect: MS,
   check: cS,
   auth: hy,
-  onboard: I1,
-  rule: CI
-}, $l = $1(Qh), PI = {
+  onboard: E1,
+  rule: xI
+}, $l = I1(Qh), RI = {
   meta: {
     name: "taskless",
-    version: "0.10.0",
+    version: "0.10.1",
     description: "Taskless CLI"
   },
   args: {
@@ -20392,19 +20457,19 @@ const Qh = {
       "Taskless CLI — non-interactive context detected.\n  For interactive install, run from a terminal.\n  For scripted install, run `taskless init --no-interactive`.\n  For agent recipes, run `taskless help` (no args) for the topic index.\n"
     ), await hs($l, { rawArgs: ["help", ...e] });
   }
-}, li = process.argv.slice(2), Xh = FI(li), RI = Date.now(), Il = await iy(Xh);
+}, li = process.argv.slice(2), Xh = NI(li), jI = Date.now(), Il = await iy(Xh);
 let Lr;
 try {
-  await hs(PI, { rawArgs: li });
+  await hs(RI, { rawArgs: li });
 } catch (e) {
   Lr = e, e instanceof mt || (process.exitCode = 1, console.error(e instanceof Error ? e.message : String(e)));
 } finally {
   try {
     const e = await _e(Xh), t = Lr === void 0 && (process.exitCode === void 0 || process.exitCode === 0);
-    NI(e, {
-      command: xI(li),
+    PI(e, {
+      command: FI(li),
       success: t,
-      durationMs: Date.now() - RI,
+      durationMs: Date.now() - jI,
       anonymous: Il.anonymous,
       loggedIn: Il.loggedIn,
       error: Lr

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskless/cli",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "license": "MIT",
   "repository": {
     "type": "git",