@visulima/vis 1.0.0-alpha.17 → 1.0.0-alpha.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/vis",
-  "version": "1.0.0-alpha.17",
+  "version": "1.0.0-alpha.18",
   "description": "A CLI task runner for monorepo workspaces, powered by @visulima/task-runner",
   "keywords": [
     "build",
@@ -76,9 +76,9 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@visulima/secret-scanner": "1.0.0-alpha.1",
-    "@visulima/task-runner": "1.0.0-alpha.12",
-    "@visulima/tui": "1.0.0-alpha.12",
+    "@visulima/secret-scanner": "1.0.0-alpha.2",
+    "@visulima/task-runner": "1.0.0-alpha.13",
+    "@visulima/tui": "1.0.0-alpha.13",
     "jiti": "^2.7.0",
     "module-replacements": "^2.11.0",
     "module-replacements-codemods": "^1.2.1",
@@ -99,14 +99,14 @@
     }
   },
   "optionalDependencies": {
-    "@visulima/vis-binding-darwin-x64": "1.0.0-alpha.17",
-    "@visulima/vis-binding-darwin-arm64": "1.0.0-alpha.17",
-    "@visulima/vis-binding-linux-arm64-gnu": "1.0.0-alpha.17",
-    "@visulima/vis-binding-linux-x64-gnu": "1.0.0-alpha.17",
-    "@visulima/vis-binding-linux-arm64-musl": "1.0.0-alpha.17",
-    "@visulima/vis-binding-linux-x64-musl": "1.0.0-alpha.17",
-    "@visulima/vis-binding-win32-arm64-msvc": "1.0.0-alpha.17",
-    "@visulima/vis-binding-win32-x64-msvc": "1.0.0-alpha.17"
+    "@visulima/vis-binding-darwin-x64": "1.0.0-alpha.18",
+    "@visulima/vis-binding-darwin-arm64": "1.0.0-alpha.18",
+    "@visulima/vis-binding-linux-arm64-musl": "1.0.0-alpha.18",
+    "@visulima/vis-binding-linux-arm64-gnu": "1.0.0-alpha.18",
+    "@visulima/vis-binding-linux-x64-musl": "1.0.0-alpha.18",
+    "@visulima/vis-binding-win32-arm64-msvc": "1.0.0-alpha.18",
+    "@visulima/vis-binding-win32-x64-msvc": "1.0.0-alpha.18",
+    "@visulima/vis-binding-linux-x64-gnu": "1.0.0-alpha.18"
   },
   "engines": {
     "node": "^22.14.0 || >=24.10.0"

package/schemas/vis-config.schema.json

@@ -271,6 +271,18 @@
             "additionalProperties": false,
             "description": "Installer backend selection for `vis install` / `vis add` / `vis remove` / `vis update` / `vis ci`.\n\nLets users opt into [aube](https://github.com/endevco/aube) — a Rust-native package manager that reads/writes pnpm/npm/yarn/bun lockfiles in place — as the default installer, while keeping a single switch to fall back to the conventional PM detected from the lockfile.\n\nResolution precedence (highest first): 1. CLI flag (`--installer <name>` / `--no-aube`) 2. Env var `VIS_INSTALLER` 3. This config field 4. Auto-detect (the default)\n\nAube must be installed separately — `vis` does not bundle it. Install via npm (`@endevco/aube`), `mise use -g aube`, or `brew install endevco/tap/aube`."
         },
+        "mcpPromote": {
+            "type": "object",
+            "properties": {
+                "enabled": {
+                    "type": "boolean",
+                    "description": "Show the vis-mcp promotion notice on successful command completion.",
+                    "default": true
+                }
+            },
+            "additionalProperties": false,
+            "description": "`vis-mcp` promotion notice shown after successful commands when an AI CLI (Claude Code, Cursor, Windsurf, Continue, Zed, Cline) is installed but `@visulima/vis-mcp` is not wired into its config.\n\nShown at most once every 14 days; skipped in CI, non-TTY shells, during `--help`/`--version`/`ai`/`mcp` invocations, and when `VIS_NO_MCP_PROMOTE=1` is set. Set `enabled: false` to silence permanently for this workspace."
+        },
         "namedInputs": {
             "type": "object",
             "additionalProperties": {
@@ -725,6 +737,35 @@
             "additionalProperties": false,
             "description": "Pre-flight checks fired before `vis run` starts the orchestrator. Each check is opt-out (`false`) — defaults are sensible for the common monorepo case."
         },
+        "run": {
+            "type": "object",
+            "properties": {
+                "ciGrouping": {
+                    "type": "string",
+                    "enum": [
+                        "auto",
+                        "azure",
+                        "buildkite",
+                        "github",
+                        "gitlab",
+                        "off"
+                    ],
+                    "description": "Wrap each task's CI log block in collapsible groups so users can fold/unfold per-task output in the host CI's web UI. Failed tasks always render expanded so the failure is visible without an extra click.\n\n- `auto` (default): pick the format from the detected runner —   `GITHUB_ACTIONS=true` → `github` (`::group::`),   `GITLAB_CI=true` → `gitlab` (`section_start:` ANSI sequences),   `BUILDKITE=true` → `buildkite` (`---` collapsed headers),   `TF_BUILD=True` → `azure` (`##[group]`),   no grouping otherwise.\n- `off`: never group (raw separators only — useful when   piping through tools that mangle the directives).\n- `azure` / `buildkite` / `github` / `gitlab`: force the format   regardless of detected environment (useful for self-hosted   runners that don't set the standard env vars).\n\nCircleCI is intentionally not auto-detected: its 2.0+ format has no inline grouping directive — steps auto-group in the web UI without any markup from the runner."
+                },
+                "services": {
+                    "type": "string",
+                    "enum": [
+                        "auto",
+                        "ephemeral",
+                        "off",
+                        "persistent"
+                    ],
+                    "description": "One knob controlling auto-start of missing service deps.\n- `auto` (default in TTY): pick by task — `dev` → ephemeral,   others → persistent.\n- `ephemeral`: services die with the run (no registry entry).\n- `persistent`: services persist across runs in the registry.\n- `off` (default in CI / non-TTY): print diagnostics and abort."
+                }
+            },
+            "additionalProperties": false,
+            "description": "Behavior of `vis run` when invoked tasks declare service dependencies that aren't running in the workspace registry. CLI `--services=<mode>` overrides this block."
+        },
         "secrets": {
             "type": "object",
             "properties": {
@@ -986,7 +1027,7 @@
         },
         "sharedWorktreeCache": {
             "type": "boolean",
-            "description": "Share the cache between sibling git worktrees. When the workspace is a linked worktree (created with `git worktree add`), the cache root is relocated from `<linkedRoot>/.task-runner-cache` to the *main* worktree's `.task-runner-cache`. Multiple parallel agents working in sibling worktrees then share a single cache instead of rebuilding the same hash N times.\n\nSingle-checkout repos (where `.git` is a directory) are unaffected.\n\nSet to `false` to opt out — useful when worktrees deliberately need independent caches, e.g. for hermetic experiments.",
+            "description": "Share the cache between sibling git worktrees. When the workspace is a linked worktree (created with `git worktree add`), the cache root is relocated from `<linkedRoot>/.vis/cache` to the *main* worktree's `.vis/cache`. Multiple parallel agents working in sibling worktrees then share a single cache instead of rebuilding the same hash N times.\n\nSingle-checkout repos (where `.git` is a directory) are unaffected.\n\nSet to `false` to opt out — useful when worktrees deliberately need independent caches, e.g. for hermetic experiments.",
             "default": true
         },
         "sortPackageJson": {
@@ -1633,6 +1674,10 @@
                     "type": "string",
                     "description": "Directory for storing cache"
                 },
+                "dataDirectory": {
+                    "type": "string",
+                    "description": "Directory used to persist run summaries (`runs/`), `last-summary.json`, and other run-scoped state. Defaults to `{workspaceRoot}/.task-runner` when omitted so standalone task-runner consumers keep their existing layout. Vis sets this to `{workspaceRoot}/.vis` so all per-workspace state lives under a single directory."
+                },
                 "dryRun": {
                     "type": "boolean",
                     "description": "Dry-run mode: compute hashes and check cache but don't execute tasks. Useful for debugging cache hits/misses.",
@@ -1797,6 +1842,10 @@
                     "description": "When `true`, the cache directory is partitioned by a hash of the resolved `globalEnv` values. Changing a globalEnv var moves cache writes into a new namespace; rolling it back reuses the old namespace and its hits. Without this option, any globalEnv change silently busts every cached entry.\n\nKeep disabled when globalEnv is stable across runs — the extra path depth offers no value, and misconfigured namespaces can hide stale hits.",
                     "default": false
                 },
+                "onFingerprint": {
+                    "not": {},
+                    "description": "Plugin extension point invoked during task fingerprinting. Fires once per task after the built-in inputs (filesets, runtime, env) have been gathered and before the hash is sealed. Contributions made through the supplied  {@link  FingerprintContributor }  are mixed deterministically into the final hash.\n\nThrowing aborts fingerprinting for that task — the task fails before any cache lookup runs, so a buggy plugin can't silently corrupt cache state.\n\nWired by `vis` to bridge into the `task:fingerprint` hook; standalone task-runner consumers can pass a callback directly."
+                },
                 "parallel": {
                     "type": [
                         "number",
@@ -2676,6 +2725,27 @@
                                 "description": "Fired once before any task in the graph starts, after workspace discovery and graph construction. Throwing aborts the run."
                             }
                         },
+                        "service:attach": {
+                            "type": "array",
+                            "items": {
+                                "not": {},
+                                "description": "Fired after `vis run` auto-attaches to one or more registered services. `taskIds` lists the in-graph dependents that consumed the service's `env` block; an empty array means the service was registered but no kept task depended on it."
+                            }
+                        },
+                        "service:start": {
+                            "type": "array",
+                            "items": {
+                                "not": {},
+                                "description": "Fired after a service is registered and its readiness probe succeeds. Sourced from both `vis service start` (and `restart`'s post-start phase) and any future programmatic call sites."
+                            }
+                        },
+                        "service:stop": {
+                            "type": "array",
+                            "items": {
+                                "not": {},
+                                "description": "Fired after a registered service is stopped (SIGTERM/SIGKILL acknowledged, registry entry deleted). Not fired when stop is called against an unknown id — only when there was an alive entry to terminate."
+                            }
+                        },
                         "task:after": {
                             "type": "array",
                             "items": {
@@ -2711,6 +2781,20 @@
                                 "description": "Fired when a task exits non-zero."
                             }
                         },
+                        "task:fingerprint": {
+                            "type": "array",
+                            "items": {
+                                "not": {},
+                                "description": "Fired during fingerprint construction, after built-in inputs are gathered and before the hash is sealed. Plugins call `contributor.contribute(key, value)` to mix arbitrary strings into the task hash — the hasher namespaces and sorts contributions deterministically so call order doesn't change the result.\n\nThrowing aborts hashing for the offending task and surfaces as a task failure before any cache lookup runs. Use this to guarantee a buggy plugin can't quietly poison cache state."
+                            }
+                        },
+                        "task:retry": {
+                            "type": "array",
+                            "items": {
+                                "not": {},
+                                "description": "Fired right before a failed task is re-spawned by the retry controller. `attempt` is 1-indexed and counts the retry that's about to start (so the original failed run was attempt 0). `prevExitCode` is the failing exit status that triggered the retry (the full TaskResult isn't materialized at the retry boundary — only the per-attempt close event is available).\n\nThrowing aborts the retry; the previous failure becomes the final result."
+                            }
+                        },
                         "task:stderr": {
                             "type": "array",
                             "items": {

package/dist/packem_shared/flakiness-Dzz-I3dB.js

@@ -1 +0,0 @@
-var h=Object.defineProperty;var f=(a,s)=>h(a,"name",{value:s,configurable:!0});import{createRequire as k}from"node:module";import{a as y,n as T,M as v}from"../packem_chunks/config.js";import{n as S}from"../packem_chunks/bin.js";const R=k(import.meta.url),l=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,b=f(a=>{if(typeof l<"u"&&l.versions&&l.versions.node){const[s,n]=l.versions.node.split(".").map(Number);if(s>22||s===22&&n>=3||s===20&&n>=16)return l.getBuiltinModule(a)}return R(a)},"__cjs_getBuiltinModule"),{readdirSync:j}=b("node:fs");var F=Object.defineProperty,d=f((a,s)=>F(a,"name",{value:s,configurable:!0}),"i");const P=d((a,s)=>{let n=0,o=0,r=0;for(const[,t]of a)switch(t.status){case"failure":{r+=1;break}case"local-cache":case"local-cache-kept-existing":case"remote-cache":{o+=1;break}case"success":{n+=1;break}}const i=[];n>0&&i.push(`${String(n)} succeeded`),o>0&&i.push(`${String(o)} cached`),r>0&&i.push(`${String(r)} failed`);const c=(s/1e3).toFixed(1);return i.push(`${c}s`),i.join(" · ")},"formatTimingSummary"),p=d(a=>{const s=S(a);if(!y(s))return[];const n=j(s).filter(r=>r.endsWith(".json")),o=[];for(const r of n)try{o.push(T(v(s,r)))}catch{}return o},"loadRunSummaries"),D=d((a,s,n)=>{const o=n??p(a);if(o.length<2)return;let r=0,i=0;for(const e of o)typeof e.duration=="number"&&e.duration>0&&(r+=e.duration,i+=1);if(i<2)return;const c=r/i-s,t=Math.abs(c/1e3).toFixed(1);return Math.abs(c)<500?"(about average)":c>0?`(${t}s faster than avg)`:`(${t}s slower than avg)`},"compareDuration");var _=Object.defineProperty,m=f((a,s)=>_(a,"name",{value:s,configurable:!0}),"l");const E=m((a,s={},n)=>{const o=n??p(a);if(o.length===0)return[];const r=new Map;for(const t of o)if(!(s.since&&(t.startTime===void 0||t.startTime<s.since))&&Array.isArray(t.tasks))for(const e of t.tasks){if(e.cacheStatus==="HIT"||e.cacheStatus==="REMOTE_HIT"||e.cacheStatus==="SKIPPED")continue;const u=r.get(e.taskId)??{failures:0,project:e.target.project,successes:0,target:e.target.target,totalRuns:0};u.totalRuns+=1,e.exitCode!==void 0&&e.exitCode!==0?(u.failures+=1,u.lastFailure=e.startTime??t.startTime):u.successes+=1,r.set(e.taskId,u)}const i=s.minRuns??2,c=[];for(const[t,e]of r)e.totalRuns<i||e.failures!==0&&c.push({failures:e.failures,flakinessRate:e.failures/e.totalRuns,lastFailure:e.lastFailure,project:e.project,successes:e.successes,target:e.target,taskId:t,totalRuns:e.totalRuns});return c.sort((t,e)=>e.flakinessRate-t.flakinessRate),c},"analyzeFlakiness"),q=m(a=>{if(a.length===0)return["No flaky tasks detected."];const s=["Task","Runs","Failures","Rate","Last Failure"],n=a.map(t=>[t.taskId,String(t.totalRuns),String(t.failures),`${(t.flakinessRate*100).toFixed(1)}%`,t.lastFailure??"—"]),o=s.map((t,e)=>{let u=0;for(const g of n)u=Math.max(u,(g[e]??"").length);return Math.max(t.length,u)}),r=m((t,e)=>t.padEnd(e),"pad"),i=o.map(t=>"─".repeat(t)).join("──"),c=[s.map((t,e)=>r(t,o[e])).join("  "),i];for(const t of n)c.push(t.map((e,u)=>r(e,o[u])).join("  "));return c},"formatFlakinessTable");export{E as a,q as b,D as c,P as f,p as l};