zara-files: local file search, document inspection and safe file operations #15

New issue

Closed

opened 2026-08-31 18:44:12 +00:00 by lost-rob0t · 0 comments

lost-rob0t commented

2026-08-31 18:44:12 +00:00

(Migrated from github.com)

Plugin

zara-files

Goal

Give Zara a structured local-file/document domain for finding, inspecting, opening and safely manipulating files without defaulting to arbitrary filesystem shell commands.

Initial capabilities

search files by name/path/type/mtime;
optional semantic/content search through configured index adapters;
read bounded text/ranges/metadata;
recent files and project-scoped file listing;
open/reveal files through zara-desktop when available;
copy/move/rename/create/delete through explicit operations;
document summarization/extraction adapters for supported formats;
expose active/recent file context to zara-context.

Boundaries

roots are explicitly configured;
symbolic links/path traversal cannot escape allowed roots;
binary/large files are metadata-first;
destructive operations are explicit and return resulting paths/state;
secrets and ignored paths can be excluded by policy.

Integration

Allow pluggable search/index backends rather than coupling this plugin to one vector store. zara-coding can consume project/file operations without owning the general filesystem domain.

Acceptance criteria

configured-root path sandbox exists
metadata/name/content search surfaces are structured
bounded file reads are supported
explicit copy/move/rename/delete operations are path-safe
symlink/traversal escape tests exist
semantic index integration is adapter-based and optional
tests use temp directories only
README documents root/security/index configuration
registry validation, plugin tests and nix flake check pass

## Plugin `zara-files` ## Goal Give Zara a structured local-file/document domain for finding, inspecting, opening and safely manipulating files without defaulting to arbitrary filesystem shell commands. ## Initial capabilities - search files by name/path/type/mtime; - optional semantic/content search through configured index adapters; - read bounded text/ranges/metadata; - recent files and project-scoped file listing; - open/reveal files through `zara-desktop` when available; - copy/move/rename/create/delete through explicit operations; - document summarization/extraction adapters for supported formats; - expose active/recent file context to `zara-context`. ## Boundaries - roots are explicitly configured; - symbolic links/path traversal cannot escape allowed roots; - binary/large files are metadata-first; - destructive operations are explicit and return resulting paths/state; - secrets and ignored paths can be excluded by policy. ## Integration Allow pluggable search/index backends rather than coupling this plugin to one vector store. `zara-coding` can consume project/file operations without owning the general filesystem domain. ## Acceptance criteria - [ ] configured-root path sandbox exists - [ ] metadata/name/content search surfaces are structured - [ ] bounded file reads are supported - [ ] explicit copy/move/rename/delete operations are path-safe - [ ] symlink/traversal escape tests exist - [ ] semantic index integration is adapter-based and optional - [ ] tests use temp directories only - [ ] README documents root/security/index configuration - [ ] registry validation, plugin tests and `nix flake check` pass