ov-resources

# OpenViking (OV) Resource Management The `ov` command group for resources covers adding external knowledge, filesystem operations, scheduled refresh (watch tasks), and ovpack import/export/backup/restore. ## Goal Guide an agent to correctly invoke resource and filesystem commands without guessing flags, URI semantics, or processing behavior. ## Load When - User explicitly requests resource operations: `ov add-resource`, `ov task watch`, `ov export`, `ov import`, `ov backup`, `ov restore`. - User asks to browse, read, write, create, move, or delete files under `viking://resources/`. - User asks to search for context: `ov find`, `ov search`, `ov grep`, `ov glob`. - Agent needs to list, inspect, or search the resource tree to find context. ## Inputs | Name | Required | Description | |---|---|---| | `subcommand` | yes | Resource command: `add-resource`, `task watch`, `export`, `import`, `backup`, `restore`, filesystem command: `ls`, `tree`, `read`, `write`, `mkdir`, `rm`, `mv`, `grep`, `glob`, or search command: `find`, `search` | | `target` | conditional | File path, URL, Viking URI, or query string | | `flags` | no | Command-specific flags like `--wait`, `--to`, `--parent`, `--recursive`, `--watch-interval` | ## Workflow 1. Identify the user's intent and map to the correct `ov <subcommand>`. 2. Resolve the target (local path, URL, or Viking URI). 3. Construct the command with appropriate flags. 4. Execute and report results. ## Permissions - `ov add-resource` from external URLs may download untrusted content; verify the source when the user provides an untrusted URL. - `ov rm --recursive` is destructive; confirm with the user before executing on large directories. - `ov export`, `ov import`, `ov backup`, `ov restore` require ROOT or ADMIN permissions. - `ov write` replaces file content in-place; the old version is not retained. ## Output - CLI output returned directly to the user. - Errors surfaced with suggested fixes and relevant flag guidance. ## Verification - After `add-resource`, `ov ls` or `ov tree` should show the new resource under the expected URI. - After `rm`, `ov ls` should no longer list the removed path. - After `write`, `ov read` should reflect the new content. - After `ov import` or `ov restore`, `ov tree` should show the imported structure. ## Boundaries - Do not invent paths or URLs. Use what the user provides. - Do not execute `ov rm --recursive` on broad paths like `viking://resources/` without explicit user confirmation. - Do not treat `ov add-skill` or `ov skills` as equivalent to resource commands; skill management is handled by `ov-skills`. - Do not treat `ov add-memory` as a resource command; memory management is out of scope for this skill. ## Runtime Resources - `docs/add-resource.md` — detailed resource ingestion docs, source types, and async processing. - `docs/filesystem.md` — filesystem operations reference (ls, tree, read, write, mkdir, rm, mv, grep, glob). - `docs/search.md` — semantic search (`ov find`, `ov search`) and search combination strategies. - `docs/watch-management.md` — watch task lifecycle (create, pause, resume, trigger, update, remove). - `docs/ovpack.md` — ovpack export/import/backup/restore reference. - `examples/commands.md` — common command patterns by scenario.