Liking cljdoc? Tell your friends :D

com.blockether.vis.internal.workspace.cli

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.
raw docstring

com.blockether.vis.internal.workspace.core

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.
raw docstring

com.blockether.vis.internal.workspace.fff-index

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.
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.
raw docstring

com.blockether.vis.internal.workspace.git

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`.
raw docstring

com.blockether.vis.internal.workspace.gitignore

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.
raw docstring

com.blockether.vis.internal.workspace.read-gate

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.
raw docstring

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts
Ctrl+kJump to recent docs
←Move to previous article
→Move to next article
Ctrl+/Jump to the search field
× close