vis-agent projects commands: list projects, or delete one, optionally with
every session in it.
`vis-agent projects` commands: list projects, or delete one, optionally with every session in it.
Session workspaces, DB-pinned to session_state 1:1.
A workspace is the directory in which a session works: the folder where the user
started vis, or the folder that the session moved to. Vis does not require it
to be a git repository.
Vis never mutates JVM user.dir. Channels rebind workspace-root per
turn from the active workspace; tools resolve paths via
(workspace/cwd). There is NO process-cwd fallback in production -
the env carries :workspace/root from create-environment onward.
Session workspaces, DB-pinned to session_state 1:1. A workspace is the directory in which a session works: the folder where the user started `vis`, or the folder that the session moved to. Vis does not require it to be a git repository. Vis never mutates JVM user.dir. Channels rebind *workspace-root* per turn from the active workspace; tools resolve paths via (workspace/cwd). There is NO process-cwd fallback in production - the env carries `:workspace/root` from `create-environment` onward.
THE canonical way vis talks to fff.
Every fff instance in this process is born here and lives in ONE pool keyed
by [canonical-root respect-ignore-files? ignore-overlay]. Nothing else may call
fff/create — a second, unpooled instance would duplicate a whole tree's
native path+content index, spin its own watcher threads, and go stale on our
own writes.
Contract for callers:
(fff-index/with-index [idx (fff-index/lease root respect-ignore-files? overlay)] (fff/search idx …) (fff/grep idx …))
:watch? true) and resynced before the body
runs when this process wrote inside its tree since it was last synced,idx; borrowed indexes cannot be evicted,note-fs-write! with the changed path so the
next search refreshes that path and reads its own writes. A refresh does not
rescan the tree.THE canonical way vis talks to fff.
Every fff instance in this process is born here and lives in ONE pool keyed
by `[canonical-root respect-ignore-files? ignore-overlay]`. Nothing else may call
`fff/create` — a second, unpooled instance would duplicate a whole tree's
native path+content index, spin its own watcher threads, and go stale on our
own writes.
Contract for callers:
(fff-index/with-index [idx (fff-index/lease root respect-ignore-files? overlay)]
(fff/search idx …) (fff/grep idx …))
- the index is watcher-live (`:watch? true`) and resynced before the body
runs when this process wrote inside its tree since it was last synced,
- all gateway workers share the pool and the same root/policy index,
- the body must NOT close `idx`; borrowed indexes cannot be evicted,
- filesystem mutations call `note-fs-write!` with the changed path so the
next search refreshes that path and reads its own writes. A refresh does not
rescan the tree.Shared workspace inspection, backed by the native git binary.
UI surfaces and extensions depend on this namespace instead of embedding
their own git calls. It reports small, renderable facts about the current
repository (branch, dirty buckets, ahead/behind, porcelain entries) by
shelling out to git status --porcelain=v2 and git rev-parse, parsed
into stable Clojure maps. No JGit — the only git implementation is the one
already on the user's PATH, so behaviour matches their shell exactly.
Workspace lifecycle mutations stay in
com.blockether.vis.internal.workspace.core.
Shared workspace inspection, backed by the native `git` binary. UI surfaces and extensions depend on this namespace instead of embedding their own git calls. It reports small, renderable facts about the current repository (branch, dirty buckets, ahead/behind, porcelain entries) by shelling out to `git status --porcelain=v2` and `git rev-parse`, parsed into stable Clojure maps. No JGit — the only git implementation is the one already on the user's PATH, so behaviour matches their shell exactly. Workspace lifecycle mutations stay in `com.blockether.vis.internal.workspace.core`.
Minimal, pure-Clojure .gitignore matcher — the JGit-free replacement for
IgnoreNode. Parses ONE .gitignore file (the one at a walk root) into
ordered rules and evaluates a /-separated relative path against them with
git's semantics: last matching rule wins, ! negates, a trailing /
restricts to directories, a leading/embedded / anchors to the root, and a
slash-free pattern matches at any depth.
Minimal, pure-Clojure `.gitignore` matcher — the JGit-free replacement for `IgnoreNode`. Parses ONE `.gitignore` file (the one at a walk root) into ordered rules and evaluates a `/`-separated relative path against them with git's semantics: last matching rule wins, `!` negates, a trailing `/` restricts to directories, a leading/embedded `/` anchors to the root, and a slash-free pattern matches at any depth.
The one read gate for a file that a person opens on the gateway machine: the
session's filesystem roots, the configured deny rules and the
:fs/access gate hooks. The file preview, the media stream and an attachment
that keeps a reference to a file (#450) all ask here, so none of them can show
a file that another of them refuses.
The one read gate for a file that a person opens on the gateway machine: the session's filesystem roots, the configured deny rules and the `:fs/access` gate hooks. The file preview, the media stream and an attachment that keeps a reference to a file (#450) all ask here, so none of them can show a file that another of them refuses.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |