@visulima/vis-mcp 1.0.47 → 2.0.0

package/CHANGELOG.md

@@ -1,3 +1,500 @@
+## @visulima/vis-mcp [2.0.0](https://github.com/visulima/visulima/compare/@visulima/vis-mcp@1.0.47...@visulima/vis-mcp@2.0.0) (2026-10-14)
+
+### ⚠ BREAKING CHANGES
+
+* **vis:** vis run <target> now exits 1 when no project defines the
+target. Scripts that relied on the silent exit 0 must pass --if-present.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* feat(task-runner): add tracker kind to trace key
+
+The trace key now includes which mechanism observed the file accesses:
+seccomp, strace, interpose, iat or preload. The same workspace traced on
+Linux and macOS can no longer produce the same key for different
+observations.
+
+Upgrade notes:
+- Traced entries written after this change are keyed on the new digest.
+  Entries written before it stay reachable through the task index and
+  are validated against their files as before, so there is no forced
+  miss on upgrade.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* feat(task-runner): fall back to declared hash
+
+A traced task whose tracker observed no workspace access was never
+cached. That left targets which declare inputs uncached on hosts without
+a working tracker. When the target declares inputs, such a run is now
+keyed on its declared hash instead. Targets without inputs keep the
+previous behaviour: no cache entry and a warning.
+
+The declared hash is computed only when the tracker is empty, so traced
+runs that observe files do no extra hashing. A fallback entry is stored
+without a fingerprint, and the next run validates it by recomputing the
+declared hash. A changed hash is reported as declared-changed. The task
+result and the run summary record hashSource: "declared-fallback".
+
+Upgrade notes:
+- Existing entries are unchanged. Only runs that observe no workspace
+  access, for targets that declare inputs, gain a cache entry.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* feat(vis): show declared-fallback key in cache why
+
+cache why and cache hash now say when a traced run was keyed on its
+declared hash, and the JSON output carries hashSource. The vis config
+schema is regenerated for the updated autoFingerprint description.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(vis): describe declared fallback and trace key
+
+The caching guide and configuration reference now explain when an empty
+trace is keyed on the declared hash, how a trace key is built, and what
+cache why reports. The RFC marks G1-B and G4 done.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(task-runner): describe declared fallback for empty traces
+
+The empty-fingerprint section now explains both outcomes: a target that
+declares inputs is keyed on its declared hash, and one that does not is
+left uncached with a warning.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(vis): correct trace caching claim in why-vis
+
+A run the tracker cannot observe is keyed on its declared inputs when
+the target declares them. It is not cached otherwise.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* feat(task-runner): parse top-level && chains
+
+Add splitCompoundCommand, a quote-aware splitter that cuts a shell
+command on top-level && only. Anything it does not model (;, ||, a
+background &, subshells, command substitution, heredocs, comments,
+empty segments, cd/export/source/set/trap/exec and VAR=value prefixes)
+leaves the whole command unsplit and reports why.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* feat(task-runner): add splitCompound segment chains
+
+Add the splitCompound target option. A declared-mode target whose
+* **vis:** `vis run` with --filter, --query or --tag that selects no
+project now exits 1. Scripts that relied on the silent exit 0 must pass
+--if-present.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* test(vis): keep empty --affected results exit 0
+
+Pins the behaviour the empty-selection fix must not change: when a --tag
+selects a project that --affected then excludes, the run prints "No
+projects affected by the changes." and returns. A mutation that throws
+there fails the test.
+
+The fixture repo runs with GIT_* variables cleared, so it cannot act on
+the repository that a git hook is committing.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(vis): let ci and affected opt out of empty runs
+
+vis run now fails when a target, --query or tag selects no projects, and
+vis ci / vis affected hand their --query to it. A job whose query can
+legitimately match nothing had no way to say so. Add --if-present to both
+and forward it to vis run.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(task-runner): match excludes inside the workspace
+
+The tracker tested its exclude patterns (/dev/, /tmp/, /etc/, ...) against
+the absolute path before checking containment. A workspace under any of
+those directory names, such as ~/dev/project or a /tmp CI checkout,
+recorded no accesses at all on the strace, seccomp, interpose and IAT
+paths, so traced caching never engaged. The Windows IAT check was also a
+lowercase startsWith without a separator boundary, so a workspace /ws/app
+accepted /ws/app-other.
+
+Every path now goes through resolveAccessPath: containment first, then the
+patterns against the path inside the workspace.
+
+Upgrade notes: traced targets in a workspace under a dev, tmp or etc
+directory now cache where they previously never did. The IAT path no longer
+accepts sibling directories that share the workspace prefix.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(task-runner): key unset env names apart from empty ones
+
+A traced key recorded an unset name and an empty value the same way, so a
+name that went from unset to "" hit a stale entry. An unset name now keys
+differently from an empty one, using the same presence scheme as the
+declared hasher.
+
+validate takes the env to check against. It defaults to process.env, so
+existing callers see no change; the next commit passes the child env.
+
+Upgrade notes: traced entries that key an env name miss once after
+upgrading, because the stored env key format changed.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(task-runner): key traced runs on the child env
+
+A traced run keyed the parent's env values, so a value the child receives
+from another source (an envFile, service env, VIS_ARG_* or a per-target env)
+was not in the key, and changing it left a stale hit.
+
+The key now reads the names it covers from the resolved child env
+(TaskRunnerContext.resolveChildEnv). A name the clean policy hides hashes as
+unset. Validation reads the same env, so a hit needs the values the child
+will see. Untracked names stay out of the key, and the key does not cover
+the whole environment.
+
+The key also covers the command the run spawns. TaskRunnerContext.resolveCommand
+supplies it, so caller-side arguments and shell wrapping change the key.
+Without it the project target command is used, as before.
+
+TaskRunnerContext.preTraceCheck runs on a cache miss before tracking. A
+returned message fails the task with exit code 1; the child does not spawn
+and nothing is cached.
+
+Upgrade notes: a traced key changes when the spawned command differs from
+the configured one. Traced entries that key an env name also miss once,
+as in the previous commit.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(vis): traced targets run the executor command
+
+A traced target ran the raw project command. Forwarded arguments
+(`vis run build -- --flag`) and `affectedFiles: "args"` paths never reached
+the child, `${...}` tokens and a custom `shell` did not apply, and
+`strictEnv` was not checked.
+
+The executor and the traced run now share one resolver for the spawned
+command, and one strict-env check that reads the child env the spawn gets.
+Both spawn the same string, and the traced key hashes it, so the arguments
+and affected files change the key.
+
+Upgrade notes:
+- Traced targets now receive forwarded arguments and `affectedFiles: "args"`
+  paths. A traced run with these misses once, since the key includes them.
+- Traced targets now run their configured command, with tokens expanded and
+  any custom shell applied, as the executor does. They used to run the raw
+  project command.
+- `strictEnv` (flag or config) now fails a traced target that references an
+  unset variable, before the child starts. A traced target that passed with
+  an unset reference now fails.
+- Traced keys hash the env values the child receives (see the task-runner
+  commits), so traced targets with env names in the key miss once.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(vis): document the traced key and strict env
+
+The caching guide lists what a traced key covers: the spawned command and
+the env values the child receives for the names the key covers. The run
+guide says the strict-env check runs for traced targets too. The RFC
+records the resolution and the gaps that remain: the declared hasher still
+reads process.env for fingerprintEnv and envVars, and persistent targets and
+the TUI retry spawn the raw command, so forwarded arguments do not reach them.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(vis): persistent and retried tasks keep args
+
+Persistent targets and a TUI retry spawned the raw override command, so
+forwarded arguments, affectedFiles args and a custom shell were dropped
+while the first attempt of the same task had them. Both now spawn the
+command the executor and the traced run use.
+
+Upgrade notes: vis run <persistent> -- <args> now passes the arguments to
+the persistent command.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(task-runner): key declared env on the child env
+
+The declared hasher read fingerprintEnv, envVars, env:// inputs,
+autoEnvVars and framework names from the parent's process.env, but the
+child also gets values from envFile layering, service env, task arguments
+and per-target env. A cached target keyed on a variable only its env file
+defines kept serving a stale hit after the file changed, and fingerprintEnv
+wildcards never matched names the parent lacked.
+
+The hasher takes a childEnv resolver, supplied from resolveChildEnv, and
+keys and expands patterns against the environment the task will receive.
+globalEnv is workspace-wide and still reads the parent's.
+
+Upgrade notes: a declared target whose child sees a different value than
+the parent for a keyed name gets one new key, and so one cache miss. Keys
+for names with equal values are unchanged.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(vis): doctor no longer crashes without a lockfile
+
+vis doctor looked the package manager up twice with a strict resolver that
+throws when a workspace has no lockfile and no packageManager field, the
+state of every new project. It crashed with a stack trace instead of
+reporting. Reuse the tolerant detection the command already performed.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* docs(vis-mcp): fix lint and cache tool text
+
+The lint description listed the default adapters without the opt-in
+typecheck adapter. cache_why and cache_hash described hashDetails only,
+but trace-mode tasks have no hashDetails: their reasons are in
+task.cacheMissReasons and their tracked state is in trackedFingerprint.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(vis): cover run, cache and lint in the skill
+
+Add the tools the table left out, correct the tool count, and document
+the empty-selection exit code, the opt-in typecheck adapter, the trace
+miss reasons, and the doctor env coverage check. Replace the cache-miss
+flow's invented status and stderr fields with the real summary fields.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(vis): sync ai guide tool reference
+
+The guide listed eight tools and described a run_task tool that does
+not exist. Add the five missing tools and the trace-mode fields that
+cache_why and cache_hash return.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(vis-mcp): read the run summary vis really writes
+
+list_runs read runId, startedAt, status and tasks[].status, none of which
+the run summary has: it carries id, startTime, stats and per-task
+exitCode. Every run therefore showed as a success with no failures and no
+start time, including failed ones, and get_run_logs echoed an undefined
+run id. Read the real fields, fall back to the old spellings, and test
+against a summary shaped like the one vis writes.
+
+Upgrade notes: list_runs now reports failed runs as failures, with their
+start time and task counts.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* feat(task-runner): chain trace keys per segment
+
+A `splitCompound` target with `hashMode: "trace"` (or workspace
+`autoFingerprint`) was refused and ran whole. It now splits like a declared
+target. Each segment runs through the tracker on its own command, and its
+trace key folds in the trace key of the segment before it.
+
+- fingerprint: `TaskFingerprint.chainKey` holds the predecessor's trace key.
+  It joins `hashFingerprint` only when set, so keys of ordinary tasks do not
+  move (a test pins two of them). `validateChain` checks it on lookup, after
+  the command and tracker checks and before any file is hashed, and a moved
+  predecessor misses with `chain-changed`.
+- orchestrator: a segment after the first keys on its predecessor's trace key.
+  A segment whose predecessor has no key this run is neither served nor stored.
+  A traced segment publishes its key on a hit as well as on a store.
+- default resolver: reads a segment's command from `overrides`, so the tracker
+  and the tracker-kind prediction see that segment's command, not the chain.
+- Refusals kept: `{ auto: true }` outputs, `when`, `always`, custom shell and
+  unsupported shell syntax. The trace and auto-fingerprint refusals are removed.
+
+Upgrade notes:
+
+- Targets that set `splitCompound` together with `hashMode: "trace"` or
+  `taskRunner.autoFingerprint` now run as `target#n` segments. They used to run
+  whole. Their first run after upgrading misses, because the segment entries
+  are new.
+- Keys of targets that do not split are unchanged, both traced and declared.
+- `vis run --dry-run` lists the segments of these targets, each marked `(trace)`.
+- `SplitCompoundOptions` (exported from `@visulima/task-runner`) no longer has
+  `autoFingerprint`. Passing it is now a type error. It had no effect once the
+  split refusal was gone.
+- The `splitCompound` description in the vis config schemas is regenerated.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(vis): give segments their target's service env
+
+The service env of a run is keyed on the target's id, before a
+`splitCompound` target is split. A segment runs under its own id
+(`target#n`), so its spawn found no service env. A split target therefore
+lost the variables of the services it depends on, in declared mode as well
+as traced mode.
+
+`resolveTaskSpawn` now reads a segment's entry from the target it runs in
+place of. Every spawn path reads through that function, so the executor, the
+persistent launch and the retry get the same environment.
+
+Upgrade notes:
+
+- A `splitCompound` target's segments now receive the service env they used
+  to miss. A segment's key changes once after upgrading only when it names a
+  service variable, because keys cover the env values the child receives.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* test(vis): cover traced segments through vis run
+
+Runs a `hashMode: "trace"` target with `splitCompound` through the run
+handler. Covers the last-segment-only re-run, the re-run of every segment
+when the first segment's input changes, forwarded arguments on the last
+segment only, and the `(trace)` annotation on each segment in the dry-run
+plan.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(vis): document traced segment keys
+
+The `splitCompound` option no longer refuses trace hashing. The run option
+row and the caching guide now describe how a traced segment's key chains to
+its predecessor, and the cases where a segment is neither served nor stored.
+The RFC marks G3.3 done and records the chain, the kept refusals and the
+limits found while implementing it.
+
+Upgrade notes:
+
+- The caching guide and the run option table no longer list trace hashing as
+  a reason the split is refused. Targets that combine `splitCompound` with
+  `hashMode: "trace"` split as described in the previous commits.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(vis): annotate traced tasks under auto-fingerprint
+
+The dry-run plan marked a task `(trace)` only when its own `hashMode` was
+`"trace"`. Under `taskRunner.autoFingerprint` the engine traces every task,
+segments included, so their plan lines showed no trace mark.
+
+The annotation now follows the engine: `hashMode: "trace"` or the workspace
+switch.
+
+Tests cover the dry-run annotation under the workspace switch, and
+`vis cache why` on a segment that missed because the segment before it moved.
+
+Upgrade notes:
+
+- Under `taskRunner.autoFingerprint`, `vis run --dry-run` now marks every task
+  `(trace)`, including targets that do not split. Before, only per-target trace
+  targets were marked. The run itself is unchanged.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* test(task-runner): guard segment tests for win32
+
+Two segment tests use a bare `true` command as a segment whose tracker sees
+nothing. `true` is a POSIX builtin that cmd.exe lacks, so they now skip on
+win32. The clean-environment test passes the platform's essential names
+(SystemRoot on Windows) to the child, so node can start there.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* docs(vis): correct the chain miss reason in the RFC
+
+A moved predecessor misses with `chain-changed`, which `vis cache why` prints
+as `Previous segment changed`. The reason does not name the predecessor, so
+the RFC no longer says it does.
+
+Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
+
+* fix(vis): report target properties under options
+
+splitCompound, hashMode, fingerprintEnv and the other target-level
+properties are read from the target, not from its options bag. Written
+under options they parsed fine and did nothing, and the run.mdx options
+table listed splitCompound there. Warn when a run finds one under options,
+and move splitCompound out of the options table with a note on which keys
+are target-level.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(task-runner): key dependents on traced hits
+
+A traced task published its key only when it ran and stored, not when
+it was served from cache. A declared task that dependsOn it then folded
+the traced key on a cold run and nothing on a warm one, so its key
+flipped with whether the dependency ran. Worse, the key without the
+dependency was shared across dependency states, so after the dependency
+changed and then hit again the dependent was served output built from
+the older state.
+
+Publish the key on every traced hit, as segments already did.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(vis): replace every match in two rewrites
+
+CodeQL flagged two string replaces that rewrite only the first match.
+Neither input holds a second match today, but replaceAll states the
+intent and keeps the code scan green.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(vis): check referenced tsconfigs in build mode
+
+tsc -b rejects --noEmit once one project references another (TS6310),
+so a solution-style workspace whose projects import each other could
+never pass the type check. Drop the flag in build mode and document
+that it writes each project's own outDir and tsbuildinfo.
+
+Also decide config ownership with a relative path, so a root with
+Windows separators still finds its own tsconfig.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(vis): keep the GitLab token off self-hosted hosts
+
+GITLAB_TOKEN belongs to gitlab.com, but a gitlab://host source names a
+host the template author chose, so the token was sent wherever the URL
+pointed. Skip the environment token there; create.auth, a token in the
+URL and GIGET_AUTH still apply.
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* fix(vis): apply review fixes to create, doctor, run
+
+- resolve a create.defaultTemplate alias before the org preflight
+- pass the config to the task overlay loader in the env check
+- keep doctor running when the env coverage check throws
+- retry a split target by segment id
+- declare if-present with negatable() and drop the tag claim from ci
+- correct the clean-env note for traced targets and the splitCompound
+  and if-present wording in the docs
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+* test: fix windows paths, quoting and env names
+
+- pass a file path to node as an argument, not inside a JS string
+- quote only values that contain whitespace, as cmd drops the first
+  and last quote of a command that starts with one
+- match env names without regard to case and allow the names Windows
+  adds to every process
+- compare paths in the normalised form the code returns
+- expect cmd to leave $VAR unexpanded
+
+Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
+
+### Features
+
+* **vis:** git templates, clean env cache keys, trace segments ([#969](https://github.com/visulima/visulima/issues/969)) ([f16cf03](https://github.com/visulima/visulima/commit/f16cf038f9827abcf814fa1c2a5821c004d6d746)), closes [id#1](https://github.com/visulima/id/issues/1) [id#2](https://github.com/visulima/id/issues/2)
+
+
+### Dependencies
+
+* **@visulima/vis:** upgraded to 5.0.0
+
 ## @visulima/vis-mcp [1.0.47](https://github.com/visulima/visulima/compare/@visulima/vis-mcp@1.0.46...@visulima/vis-mcp@1.0.47) (2026-10-14)
 
 

package/dist/bin.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import{realpathSync as t}from"node:fs";import{argv as e}from"node:process";import{fileURLToPath as o}from"node:url";import{startMcpServer as a}from"./packem_shared/createMcpServer-C4LuWhpp.js";const i=async()=>{try{await a()}catch(r){process.stderr.write(`[vis-mcp] failed to start: ${r instanceof Error?r.message:String(r)}
+import{realpathSync as t}from"node:fs";import{argv as e}from"node:process";import{fileURLToPath as o}from"node:url";import{startMcpServer as a}from"./packem_shared/createMcpServer-DBbKrHaN.js";const i=async()=>{try{await a()}catch(r){process.stderr.write(`[vis-mcp] failed to start: ${r instanceof Error?r.message:String(r)}
 `),process.exit(1)}},s=(()=>{const r=e[1];if(r===void 0)return!1;try{return t(r)===t(o(import.meta.url))}catch{return!1}})();s&&await i();export{i as main};

package/dist/index.js

@@ -1 +1 @@
-import{execVis as t,execVisJson as o}from"./packem_shared/execVis-CInWWszP.js";import{clearListCache as i,listVisJson as p}from"./packem_shared/clearListCache-D-qeI660.js";import{errorResponse as f,okResponse as x,okStructuredResponse as a}from"./packem_shared/errorResponse-D1WOFYuT.js";import{createMcpServer as c,registerAllTools as l,startMcpServer as n}from"./packem_shared/createMcpServer-C4LuWhpp.js";import{registerAdvisoryStatus as d}from"./packem_shared/registerAdvisoryStatus-DnpRlAZ2.js";import{registerAudit as R}from"./packem_shared/registerAudit-ZskmQpJB.js";import{registerCacheHash as V}from"./packem_shared/registerCacheHash-CLFe-S23.js";import{registerCacheWhy as T}from"./packem_shared/registerCacheWhy-DBIgl8ww.js";import{registerDescribeProject as v}from"./packem_shared/registerDescribeProject-zZZrCz2G.js";import{registerDescribeTemplate as C}from"./packem_shared/registerDescribeTemplate-D1DYYNOB.js";import{registerFmt as b}from"./packem_shared/registerFmt-DYE0dqsx.js";import{registerGetRunLogs as y}from"./packem_shared/registerGetRunLogs-CukA12J7.js";import{registerLint as I}from"./packem_shared/registerLint-D_A4H5jb.js";import{registerListProjects as M}from"./packem_shared/registerListProjects-3dPVnYC9.js";import{registerListRuns as G}from"./packem_shared/registerListRuns-BoZ7DRKb.js";import{registerListTargets as O}from"./packem_shared/registerListTargets-95gAK_Bj.js";import{registerListTemplates as q}from"./packem_shared/registerListTemplates-LK8yLlVB.js";import{isSafeOptionValue as z,isSafePositional as B,isValidRunId as E,isValidTaskId as K}from"./packem_shared/isSafeOptionValue-BEUaZ7UP.js";export{i as clearListCache,c as createMcpServer,f as errorResponse,t as execVis,o as execVisJson,z as isSafeOptionValue,B as isSafePositional,E as isValidRunId,K as isValidTaskId,p as listVisJson,x as okResponse,a as okStructuredResponse,d as registerAdvisoryStatus,l as registerAllTools,R as registerAudit,V as registerCacheHash,T as registerCacheWhy,v as registerDescribeProject,C as registerDescribeTemplate,b as registerFmt,y as registerGetRunLogs,I as registerLint,M as registerListProjects,G as registerListRuns,O as registerListTargets,q as registerListTemplates,n as startMcpServer};
+import{execVis as t,execVisJson as o}from"./packem_shared/execVis-CInWWszP.js";import{clearListCache as i,listVisJson as p}from"./packem_shared/clearListCache-D-qeI660.js";import{errorResponse as f,okResponse as x,okStructuredResponse as a}from"./packem_shared/errorResponse-D1WOFYuT.js";import{createMcpServer as c,registerAllTools as l,startMcpServer as n}from"./packem_shared/createMcpServer-DBbKrHaN.js";import{registerAdvisoryStatus as d}from"./packem_shared/registerAdvisoryStatus-DnpRlAZ2.js";import{registerAudit as R}from"./packem_shared/registerAudit-ZskmQpJB.js";import{registerCacheHash as V}from"./packem_shared/registerCacheHash-BGyhpFep.js";import{registerCacheWhy as T}from"./packem_shared/registerCacheWhy-CGuHRmfC.js";import{registerDescribeProject as v}from"./packem_shared/registerDescribeProject-zZZrCz2G.js";import{registerDescribeTemplate as C}from"./packem_shared/registerDescribeTemplate-D1DYYNOB.js";import{registerFmt as b}from"./packem_shared/registerFmt-DYE0dqsx.js";import{registerGetRunLogs as y}from"./packem_shared/registerGetRunLogs-tcoMohKG.js";import{registerLint as I}from"./packem_shared/registerLint-D0jyTg8L.js";import{registerListProjects as M}from"./packem_shared/registerListProjects-3dPVnYC9.js";import{registerListRuns as G}from"./packem_shared/registerListRuns-DA-dMOsv.js";import{registerListTargets as O}from"./packem_shared/registerListTargets-95gAK_Bj.js";import{registerListTemplates as q}from"./packem_shared/registerListTemplates-LK8yLlVB.js";import{isSafeOptionValue as z,isSafePositional as B,isValidRunId as E,isValidTaskId as K}from"./packem_shared/isSafeOptionValue-BEUaZ7UP.js";export{i as clearListCache,c as createMcpServer,f as errorResponse,t as execVis,o as execVisJson,z as isSafeOptionValue,B as isSafePositional,E as isValidRunId,K as isValidTaskId,p as listVisJson,x as okResponse,a as okStructuredResponse,d as registerAdvisoryStatus,l as registerAllTools,R as registerAudit,V as registerCacheHash,T as registerCacheWhy,v as registerDescribeProject,C as registerDescribeTemplate,b as registerFmt,y as registerGetRunLogs,I as registerLint,M as registerListProjects,G as registerListRuns,O as registerListTargets,q as registerListTemplates,n as startMcpServer};

package/dist/packem_shared/{createMcpServer-C4LuWhpp.js → createMcpServer-DBbKrHaN.js}

@@ -1,4 +1,4 @@
-import"./execVis-CInWWszP.js";import"./clearListCache-D-qeI660.js";import"./errorResponse-D1WOFYuT.js";import{readFile as g}from"node:fs/promises";import{createRequire as l}from"node:module";import{resolve as u,dirname as v}from"node:path";import{pathToFileURL as d,fileURLToPath as h}from"node:url";import{McpServer as b}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as w}from"@modelcontextprotocol/sdk/server/stdio.js";import{findUp as N}from"@visulima/fs";import{registerAdvisoryStatus as I}from"./registerAdvisoryStatus-DnpRlAZ2.js";import{registerAudit as S}from"./registerAudit-ZskmQpJB.js";import{registerCacheHash as y}from"./registerCacheHash-CLFe-S23.js";import{registerCacheWhy as k}from"./registerCacheWhy-DBIgl8ww.js";import{registerDescribeProject as P}from"./registerDescribeProject-zZZrCz2G.js";import{registerDescribeTemplate as R}from"./registerDescribeTemplate-D1DYYNOB.js";import{registerFmt as V}from"./registerFmt-DYE0dqsx.js";import{registerGetRunLogs as _}from"./registerGetRunLogs-CukA12J7.js";import{registerLint as L}from"./registerLint-D_A4H5jb.js";import{registerListProjects as C}from"./registerListProjects-3dPVnYC9.js";import{registerListRuns as T}from"./registerListRuns-BoZ7DRKb.js";import{registerListTargets as j}from"./registerListTargets-95gAK_Bj.js";import{registerListTemplates as M}from"./registerListTemplates-LK8yLlVB.js";import"./isSafeOptionValue-BEUaZ7UP.js";const c="1.0.0-alpha.35",f=r=>{const[e,o=""]=r.split("-",2);return{core:(e??"").split(".").map(t=>Number.parseInt(t,10)||0),pre:o.length>0?o.split("."):[]}},q=(r,e)=>{if(r===void 0)return e===void 0?0:-1;if(e===void 0)return 1;const o=Number.parseInt(r,10),t=Number.parseInt(e,10);return!Number.isNaN(o)&&!Number.isNaN(t)?o-t:r.localeCompare(e)},E=(r,e)=>{if(r.length===0&&e.length>0)return 1;if(r.length>0&&e.length===0)return-1;const o=Math.max(r.length,e.length);for(let t=0;t<o;t+=1){const i=q(r[t],e[t]);if(i!==0)return i}return 0},$=(r,e)=>{const o=f(r),t=f(e);for(let i=0;i<3;i+=1){const s=(o.core[i]??0)-(t.core[i]??0);if(s!==0)return s}return E(o.pre,t.pre)},O=r=>{!r||$(r,c)>=0||process.stderr.write(`[vis-mcp] warning: @visulima/vis ${r} is older than the required ${c}; lint/fmt/audit tools may fail with opaque errors. Upgrade @visulima/vis to >= ${c}.
+import"./execVis-CInWWszP.js";import"./clearListCache-D-qeI660.js";import"./errorResponse-D1WOFYuT.js";import{readFile as g}from"node:fs/promises";import{createRequire as l}from"node:module";import{resolve as u,dirname as v}from"node:path";import{pathToFileURL as d,fileURLToPath as h}from"node:url";import{McpServer as b}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as w}from"@modelcontextprotocol/sdk/server/stdio.js";import{findUp as N}from"@visulima/fs";import{registerAdvisoryStatus as I}from"./registerAdvisoryStatus-DnpRlAZ2.js";import{registerAudit as S}from"./registerAudit-ZskmQpJB.js";import{registerCacheHash as y}from"./registerCacheHash-BGyhpFep.js";import{registerCacheWhy as k}from"./registerCacheWhy-CGuHRmfC.js";import{registerDescribeProject as P}from"./registerDescribeProject-zZZrCz2G.js";import{registerDescribeTemplate as R}from"./registerDescribeTemplate-D1DYYNOB.js";import{registerFmt as V}from"./registerFmt-DYE0dqsx.js";import{registerGetRunLogs as _}from"./registerGetRunLogs-tcoMohKG.js";import{registerLint as L}from"./registerLint-D0jyTg8L.js";import{registerListProjects as C}from"./registerListProjects-3dPVnYC9.js";import{registerListRuns as T}from"./registerListRuns-DA-dMOsv.js";import{registerListTargets as j}from"./registerListTargets-95gAK_Bj.js";import{registerListTemplates as M}from"./registerListTemplates-LK8yLlVB.js";import"./isSafeOptionValue-BEUaZ7UP.js";const c="1.0.0-alpha.35",f=r=>{const[e,o=""]=r.split("-",2);return{core:(e??"").split(".").map(t=>Number.parseInt(t,10)||0),pre:o.length>0?o.split("."):[]}},q=(r,e)=>{if(r===void 0)return e===void 0?0:-1;if(e===void 0)return 1;const o=Number.parseInt(r,10),t=Number.parseInt(e,10);return!Number.isNaN(o)&&!Number.isNaN(t)?o-t:r.localeCompare(e)},E=(r,e)=>{if(r.length===0&&e.length>0)return 1;if(r.length>0&&e.length===0)return-1;const o=Math.max(r.length,e.length);for(let t=0;t<o;t+=1){const i=q(r[t],e[t]);if(i!==0)return i}return 0},$=(r,e)=>{const o=f(r),t=f(e);for(let i=0;i<3;i+=1){const s=(o.core[i]??0)-(t.core[i]??0);if(s!==0)return s}return E(o.pre,t.pre)},O=r=>{!r||$(r,c)>=0||process.stderr.write(`[vis-mcp] warning: @visulima/vis ${r} is older than the required ${c}; lint/fmt/audit tools may fail with opaque errors. Upgrade @visulima/vis to >= ${c}.
 `)},A=r=>{const e=process.env.VIS_MCP_VIS_BIN;if(e)return{binPath:u(e)};const o=[{label:r,require:l(d(`${r}/package.json`))},{label:"vis-mcp install location",require:l(import.meta.url)}],t=[];let i,s;for(const{label:a,require:n}of o)try{i=n.resolve("@visulima/vis/package.json"),s=n("@visulima/vis/package.json");break}catch(m){t.push({error:m,label:a})}if(!i||!s){const a=t.at(-1)?.error,n=t.map(m=>m.label).join(", ");throw new Error(`Cannot resolve \`@visulima/vis\` (tried: ${n}). Install it as a workspace dependency, or set VIS_MCP_VIS_BIN to a vis CLI path.`,{cause:a})}const p=typeof s.bin=="string"?s.bin:s.bin?.vis;if(!p)throw new Error("`@visulima/vis` is installed but does not declare a `vis` bin entry — install a current version.");return{binPath:u(v(i),p),version:s.version}},B=async()=>{try{const r=await N("package.json",{cwd:v(h(import.meta.url))});return r?JSON.parse(await g(r,"utf8")).version??"0.0.0":"0.0.0"}catch(r){return process.stderr.write(`[vis-mcp] failed to read package.json: ${r instanceof Error?r.message:String(r)}
 `),"0.0.0"}},U=(r,e)=>{C(r,e),P(r,e),j(r,e),M(r,e),R(r,e),_(r,e),T(r,e),k(r,e),y(r,e),S(r,e),I(r,e),L(r,e),V(r,e)},F=async r=>{const e=new b({name:"vis",version:await B()}),o={server:e};return U(o,r),{deps:o,server:e}},ur=async()=>{const r=process.env.VIS_MCP_WORKSPACE_ROOT??process.cwd(),{binPath:e,version:o}=A(r);O(o);const t={visBin:e,workspaceRoot:r},{server:i}=await F(t);await i.connect(new w),process.stderr.write(`[vis-mcp] ready (workspace: ${t.workspaceRoot})
 `)};export{c as MIN_VIS_VERSION,$ as compareVersions,F as createMcpServer,U as registerAllTools,ur as startMcpServer,O as warnIfVisTooOld};

package/dist/packem_shared/registerCacheHash-BGyhpFep.js

@@ -0,0 +1 @@
+import*as a from"zod";import{execVisJson as c}from"./execVis-CInWWszP.js";import{errorResponse as s,okResponse as d}from"./errorResponse-D1WOFYuT.js";import{isValidTaskId as p,isValidRunId as h}from"./isSafeOptionValue-BEUaZ7UP.js";const f=({server:n},i)=>{n.registerTool("cache_hash",{annotations:{readOnlyHint:!0},description:"Print the recorded hash and per-input hash details for a task — the contributing inputs (command, nodes, runtime, implicitDeps) that produced it. A trace-mode task has no hashDetails; its result carries `trackedFingerprint` instead (the files, env names and missing paths the run tracked).",inputSchema:{runId:a.string().optional().describe("Run ID to inspect (default: latest)"),taskId:a.string().describe('Task ID like "@my/app:build"')}},async({runId:e,taskId:r})=>{if(!p(r))return s(new Error(`Invalid taskId "${r}". Expected "<project>:<target>".`));if(e!==void 0&&!h(e))return s(new Error(`Invalid runId "${e}". Expected filesystem-safe slug ([A-Za-z0-9_.-]).`));try{const t=["cache","hash",r,"--format=json"];e&&t.push("--run",e);const o=await c(i.visBin,t,{cwd:i.workspaceRoot});return d(o)}catch(t){return s(t)}})};export{f as registerCacheHash};

package/dist/packem_shared/registerCacheWhy-CGuHRmfC.js

@@ -0,0 +1 @@
+import*as i from"zod";import{execVisJson as h}from"./execVis-CInWWszP.js";import{errorResponse as a,okResponse as c}from"./errorResponse-D1WOFYuT.js";import{isValidTaskId as d,isValidRunId as p}from"./isSafeOptionValue-BEUaZ7UP.js";const f=({server:n},r)=>{n.registerTool("cache_why",{annotations:{readOnlyHint:!0},description:"Explain why a task's cache hash rotated between runs. When the task has hashDetails (command, nodes, runtime, implicitDeps), diffs them against the previous run to pinpoint what changed. A trace-mode task has no hashDetails, so the diff is empty and the reasons are in `task.cacheMissReasons` (`{ type, detail }` entries, null when there are none). `task.hashSource` is `declared-fallback` when the run was keyed on its declared inputs.",inputSchema:{runId:i.string().optional().describe("Run ID to inspect (default: latest)"),taskId:i.string().describe('Task ID like "@my/app:build"')}},async({runId:e,taskId:t})=>{if(!d(t))return a(new Error(`Invalid taskId "${t}". Expected "<project>:<target>".`));if(e!==void 0&&!p(e))return a(new Error(`Invalid runId "${e}". Expected filesystem-safe slug ([A-Za-z0-9_.-]).`));try{const s=["cache","why",t,"--format=json"];e&&s.push("--run",e);const o=await h(r.visBin,s,{cwd:r.workspaceRoot});return c(o)}catch(s){return a(s)}})};export{f as registerCacheWhy};

package/dist/packem_shared/registerGetRunLogs-tcoMohKG.js

@@ -0,0 +1 @@
+import{readFile as f}from"node:fs/promises";import{join as u}from"@visulima/path";import*as l from"zod";import{errorResponse as e,okResponse as m}from"./errorResponse-D1WOFYuT.js";import{isValidRunId as c}from"./isSafeOptionValue-BEUaZ7UP.js";const R=({server:p},n)=>{p.registerTool("get_run_logs",{annotations:{readOnlyHint:!0},description:"Read a vis run summary from .vis/. Returns the most recent run by default, or a specific run when `runId` is set. Optionally filter to a single task with `taskId`.",inputSchema:{runId:l.string().optional().describe("Run ID (default: latest)"),taskId:l.string().optional().describe('Filter to a single task ID like "@my/app:build"')}},async({runId:r,taskId:o})=>{if(r!==void 0&&!c(r))return e(new Error(`Invalid runId "${r}". Expected filesystem-safe slug ([A-Za-z0-9_.-]).`));const i=r?u(n.workspaceRoot,".vis","runs",`${r}.json`):u(n.workspaceRoot,".vis","last-summary.json");try{const s=await f(i,"utf8"),t=JSON.parse(s);if(o){const a=t.tasks?.find(d=>d.taskId===o);return a?m({runId:t.id??t.runId??r,task:a}):e(new Error(`Task "${o}" not found in run "${t.id??t.runId??r??"(unknown)"}".`))}return m(t)}catch(s){return s.code==="ENOENT"?e(new Error(`No run summary at ${i}. Run a task first to populate it.`)):e(s)}})};export{R as registerGetRunLogs};

package/dist/packem_shared/registerLint-D0jyTg8L.js

@@ -0,0 +1 @@
+import*as e from"zod";import{errorResponse as t}from"./errorResponse-D1WOFYuT.js";import{isSafeOptionValue as f,appendPositionalFiles as h}from"./isSafeOptionValue-BEUaZ7UP.js";import{r as s,f as o,a as p}from"./orchestrator-shared-flcsuwN5.js";const g=e.object({findings:e.array(o),runs:e.array(s)}).catchall(e.unknown()),m={exitCode:e.number(),findings:e.array(o),runs:e.array(s)},w=({server:a},l)=>{a.registerTool("lint",{annotations:{readOnlyHint:!0},description:"Run the vis lint orchestrator in check-only mode via `vis lint --format json`. Auto-detects every installed linter (oxlint, biome, eslint, stylelint, ruff, markdownlint, shellcheck, deno-lint) and returns the merged { findings, runs } payload. The `typecheck` adapter (tsc) is opt-in via `lint.adapters.typecheck.enabled`: it checks the whole project even when `files` is set (skipped when none of `files` is TypeScript), and is never cached. This tool never applies fixes — invoke `vis lint --fix` directly for that.",inputSchema:{files:e.array(e.string()).optional().describe("Restrict the run to these files (relative to the workspace root). Empty/omitted = workspace-wide."),maxWarnings:e.int().nonnegative().optional().describe("Forward `--max-warnings N` to every adapter that supports it."),quiet:e.boolean().optional().describe("Suppress warning-severity findings (errors still flow through)."),since:e.string().optional().describe("Forward `--since <ref>` so only files changed vs `<ref>` are linted."),staged:e.boolean().optional().describe("Forward `--staged` so only files in the git index are linted.")},outputSchema:m},async i=>{const n=["lint","--format","json"];if(i.quiet&&n.push("--quiet"),typeof i.maxWarnings=="number"&&n.push("--max-warnings",String(i.maxWarnings)),i.staged)n.push("--staged");else if(i.since!==void 0&&i.since.length>0){if(!f(i.since))return t(new Error(`Invalid --since value "${i.since}". A leading "-" would be parsed as a CLI flag.`));n.push("--since",i.since)}const r=h(n,i.files);return r!==void 0?t(new Error(r)):p(l,"lint",n,g,(c,d)=>({...c,exitCode:d}))})};export{w as registerLint};

package/dist/packem_shared/registerListRuns-DA-dMOsv.js

@@ -0,0 +1 @@
+import{readdir as w,stat as g,readFile as k}from"node:fs/promises";import{join as c}from"@visulima/path";import*as T from"zod";import{okResponse as f,errorResponse as m}from"./errorResponse-D1WOFYuT.js";const _=/\.json$/,I=t=>t.status==="failure"||t.status==="failed"||typeof t.exitCode=="number"&&t.exitCode!==0,p=t=>typeof t.stats?.failed=="number"?t.stats.failed:t.tasks?.filter(n=>I(n)).length,S=t=>{if(typeof t.status=="string")return t.status;const n=p(t);if(n!==void 0)return n>0?"failure":"success"},R=({server:t},n)=>{t.registerTool("list_runs",{annotations:{readOnlyHint:!0},description:'List recorded vis runs from `.vis/runs/`, most recent first. Each entry includes the run ID, start timestamp, derived status, task count, and failed-task count — use it to discover run IDs for `get_run_logs`, `cache_hash`, or `cache_why` (e.g. "compare this run to the previous one").',inputSchema:{limit:T.int().positive().max(100).optional().describe("Maximum runs to return (default: 20, newest first).")}},async({limit:h})=>{const o=c(n.workspaceRoot,".vis","runs");let d;try{d=(await w(o)).filter(a=>a.endsWith(".json"))}catch(i){return i.code==="ENOENT"?f({count:0,runs:[]}):m(i)}try{const a=(await Promise.all(d.map(async e=>{try{const r=await g(c(o,e));return{file:e,modifiedMs:r.mtimeMs}}catch{return}}))).filter(e=>e!==void 0).toSorted((e,r)=>r.modifiedMs-e.modifiedMs).slice(0,h??20),l=(await Promise.all(a.map(async({file:e,modifiedMs:r})=>{try{const u=await k(c(o,e),"utf8"),s=JSON.parse(u);return{failedTasks:p(s),modifiedMs:r,runId:s.id??s.runId??e.replace(_,""),startedAt:s.startTime??s.startedAt,status:S(s),taskCount:s.stats?.total??s.tasks?.length}}catch{return}}))).filter(e=>e!==void 0).map(e=>{const{failedTasks:r,runId:u,startedAt:s,status:v,taskCount:y}=e;return{failedTasks:r,runId:u,startedAt:s,status:v,taskCount:y}});return f({count:l.length,runs:l})}catch(i){return m(i)}})};export{R as registerListRuns};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/vis-mcp",
-  "version": "1.0.47",
+  "version": "2.0.0",
   "description": "MCP (Model Context Protocol) server for @visulima/vis — exposes vis tooling to AI agents over stdio",
   "keywords": [
     "agent",
@@ -60,7 +60,7 @@
     "zod": "4.6.5"
   },
   "peerDependencies": {
-    "@visulima/vis": "4.3.1"
+    "@visulima/vis": "5.0.0"
   },
   "engines": {
     "node": "^22.14.0 || >=24.10.0"

package/dist/packem_shared/registerCacheHash-CLFe-S23.js

@@ -1 +0,0 @@
-import*as o from"zod";import{execVisJson as c}from"./execVis-CInWWszP.js";import{errorResponse as i,okResponse as p}from"./errorResponse-D1WOFYuT.js";import{isValidTaskId as d,isValidRunId as h}from"./isSafeOptionValue-BEUaZ7UP.js";const f=({server:a},s)=>{a.registerTool("cache_hash",{annotations:{readOnlyHint:!0},description:"Print the recorded hash and per-input hash details for a task — the contributing inputs (command, nodes, runtime, implicitDeps) that produced it.",inputSchema:{runId:o.string().optional().describe("Run ID to inspect (default: latest)"),taskId:o.string().describe('Task ID like "@my/app:build"')}},async({runId:e,taskId:t})=>{if(!d(t))return i(new Error(`Invalid taskId "${t}". Expected "<project>:<target>".`));if(e!==void 0&&!h(e))return i(new Error(`Invalid runId "${e}". Expected filesystem-safe slug ([A-Za-z0-9_.-]).`));try{const r=["cache","hash",t,"--format=json"];e&&r.push("--run",e);const n=await c(s.visBin,r,{cwd:s.workspaceRoot});return p(n)}catch(r){return i(r)}})};export{f as registerCacheHash};

package/dist/packem_shared/registerCacheWhy-DBIgl8ww.js

@@ -1 +0,0 @@
-import*as a from"zod";import{execVisJson as c}from"./execVis-CInWWszP.js";import{errorResponse as s,okResponse as p}from"./errorResponse-D1WOFYuT.js";import{isValidTaskId as h,isValidRunId as d}from"./isSafeOptionValue-BEUaZ7UP.js";const f=({server:o},i)=>{o.registerTool("cache_why",{annotations:{readOnlyHint:!0},description:"Explain why a task's cache hash rotated between runs. Diffs the task's hashDetails (command, nodes, runtime, implicitDeps) against the previous run to pinpoint what changed.",inputSchema:{runId:a.string().optional().describe("Run ID to inspect (default: latest)"),taskId:a.string().describe('Task ID like "@my/app:build"')}},async({runId:e,taskId:r})=>{if(!h(r))return s(new Error(`Invalid taskId "${r}". Expected "<project>:<target>".`));if(e!==void 0&&!d(e))return s(new Error(`Invalid runId "${e}". Expected filesystem-safe slug ([A-Za-z0-9_.-]).`));try{const t=["cache","why",r,"--format=json"];e&&t.push("--run",e);const n=await c(i.visBin,t,{cwd:i.workspaceRoot});return p(n)}catch(t){return s(t)}})};export{f as registerCacheWhy};

package/dist/packem_shared/registerGetRunLogs-CukA12J7.js

@@ -1 +0,0 @@
-import{readFile as f}from"node:fs/promises";import{join as u}from"@visulima/path";import*as l from"zod";import{errorResponse as e,okResponse as m}from"./errorResponse-D1WOFYuT.js";import{isValidRunId as c}from"./isSafeOptionValue-BEUaZ7UP.js";const R=({server:p},o)=>{p.registerTool("get_run_logs",{annotations:{readOnlyHint:!0},description:"Read a vis run summary from .vis/. Returns the most recent run by default, or a specific run when `runId` is set. Optionally filter to a single task with `taskId`.",inputSchema:{runId:l.string().optional().describe("Run ID (default: latest)"),taskId:l.string().optional().describe('Filter to a single task ID like "@my/app:build"')}},async({runId:r,taskId:n})=>{if(r!==void 0&&!c(r))return e(new Error(`Invalid runId "${r}". Expected filesystem-safe slug ([A-Za-z0-9_.-]).`));const i=r?u(o.workspaceRoot,".vis","runs",`${r}.json`):u(o.workspaceRoot,".vis","last-summary.json");try{const t=await f(i,"utf8"),s=JSON.parse(t);if(n){const a=s.tasks?.find(d=>d.taskId===n);return a?m({runId:s.runId,task:a}):e(new Error(`Task "${n}" not found in run "${s.runId??"(unknown)"}".`))}return m(s)}catch(t){return t.code==="ENOENT"?e(new Error(`No run summary at ${i}. Run a task first to populate it.`)):e(t)}})};export{R as registerGetRunLogs};

package/dist/packem_shared/registerLint-D_A4H5jb.js

@@ -1 +0,0 @@
-import*as e from"zod";import{errorResponse as t}from"./errorResponse-D1WOFYuT.js";import{isSafeOptionValue as f,appendPositionalFiles as g}from"./isSafeOptionValue-BEUaZ7UP.js";import{r as s,f as o,a as h}from"./orchestrator-shared-flcsuwN5.js";const m=e.object({findings:e.array(o),runs:e.array(s)}).catchall(e.unknown()),u={exitCode:e.number(),findings:e.array(o),runs:e.array(s)},w=({server:a},l)=>{a.registerTool("lint",{annotations:{readOnlyHint:!0},description:"Run the vis lint orchestrator in check-only mode via `vis lint --format json`. Auto-detects every installed linter (oxlint, biome, eslint, stylelint, ruff, markdownlint, shellcheck, deno-lint) and returns the merged { findings, runs } payload. This tool never applies fixes — invoke `vis lint --fix` directly for that.",inputSchema:{files:e.array(e.string()).optional().describe("Restrict the run to these files (relative to the workspace root). Empty/omitted = workspace-wide."),maxWarnings:e.int().nonnegative().optional().describe("Forward `--max-warnings N` to every adapter that supports it."),quiet:e.boolean().optional().describe("Suppress warning-severity findings (errors still flow through)."),since:e.string().optional().describe("Forward `--since <ref>` so only files changed vs `<ref>` are linted."),staged:e.boolean().optional().describe("Forward `--staged` so only files in the git index are linted.")},outputSchema:u},async r=>{const n=["lint","--format","json"];if(r.quiet&&n.push("--quiet"),typeof r.maxWarnings=="number"&&n.push("--max-warnings",String(r.maxWarnings)),r.staged)n.push("--staged");else if(r.since!==void 0&&r.since.length>0){if(!f(r.since))return t(new Error(`Invalid --since value "${r.since}". A leading "-" would be parsed as a CLI flag.`));n.push("--since",r.since)}const i=g(n,r.files);return i!==void 0?t(new Error(i)):h(l,"lint",n,m,(d,c)=>({...d,exitCode:c}))})};export{w as registerLint};

package/dist/packem_shared/registerListRuns-BoZ7DRKb.js

@@ -1 +0,0 @@
-import{readdir as k,stat as w,readFile as y}from"node:fs/promises";import{join as d}from"@visulima/path";import*as g from"zod";import{okResponse as m,errorResponse as p}from"./errorResponse-D1WOFYuT.js";const _=/\.json$/,I=e=>{if(typeof e.status=="string")return e.status;if(e.tasks)return e.tasks.some(a=>a.status==="failure"||a.status==="failed")?"failure":"success"},R=({server:e},a)=>{e.registerTool("list_runs",{annotations:{readOnlyHint:!0},description:'List recorded vis runs from `.vis/runs/`, most recent first. Each entry includes the run ID, start timestamp, derived status, task count, and failed-task count — use it to discover run IDs for `get_run_logs`, `cache_hash`, or `cache_why` (e.g. "compare this run to the previous one").',inputSchema:{limit:g.int().positive().max(100).optional().describe("Maximum runs to return (default: 20, newest first).")}},async({limit:h})=>{const o=d(a.workspaceRoot,".vis","runs");let l;try{l=(await k(o)).filter(u=>u.endsWith(".json"))}catch(n){return n.code==="ENOENT"?m({count:0,runs:[]}):p(n)}try{const u=(await Promise.all(l.map(async t=>{try{const s=await w(d(o,t));return{file:t,modifiedMs:s.mtimeMs}}catch{return}}))).filter(t=>t!==void 0).toSorted((t,s)=>s.modifiedMs-t.modifiedMs).slice(0,h??20),f=(await Promise.all(u.map(async({file:t,modifiedMs:s})=>{try{const c=await y(d(o,t),"utf8"),r=JSON.parse(c);return{failedTasks:r.tasks?.filter(i=>i.status==="failure"||i.status==="failed").length,modifiedMs:s,runId:r.runId??t.replace(_,""),startedAt:r.startedAt,status:I(r),taskCount:r.tasks?.length}}catch{return}}))).filter(t=>t!==void 0).map(t=>{const{failedTasks:s,runId:c,startedAt:r,status:i,taskCount:v}=t;return{failedTasks:s,runId:c,startedAt:r,status:i,taskCount:v}});return m({count:f.length,runs:f})}catch(n){return p(n)}})};export{R as registerListRuns};