# Cobsidian for DeepSeek Harness

This package is the optional Cordis Bundle for the Cobsidian Agent Skill. It does not replace the canonical `SKILL.md` or change Cobsidian behavior in Codex, Claude Code, Cursor, MCP, or other hosts.

The bundle contributes:

- the canonical Cobsidian skill to DSH's skill registry;
- typed `cobsidian_scan`, `cobsidian_dry_run`, `cobsidian_prepare_write`, `cobsidian_apply_write`, and `cobsidian_rollback` tools;
- one-shot DSH approval for apply and rollback;
- managed Python subprocess execution with bounded JSON output;
- private temporary inputs, deterministic plan IDs, hash checks, validation, and rollback.

## Install From This Repository

Requirements: DeepSeek Harness `0.1.0-rc.6`, Node.js 22+, Python 3.10+, and a local Markdown vault.

```bash
git clone https://github.com/Totoro-qaq/Cobsidian.git
cd Cobsidian/integrations/dsh
npm install
npm run build
dsh plugin --profile web add .
```

Set one vault source before starting DSH:

```bash
export COBSIDIAN_VAULT="/absolute/path/to/obsidian-vault"
dsh web
```

Alternatively, use a Cobsidian config:

```bash
export COBSIDIAN_CONFIG="/absolute/path/to/cobsidian.config.yml"
dsh web
```

`COBSIDIAN_PYTHON` may select another Python executable. `COBSIDIAN_DSH_STATE` may select another private state directory; the default is `~/.dsh/cobsidian`. Prepared plans can contain the intended note content, use mode `0600`, and must not be committed or shared. `COBSIDIAN_ROOT` is optional and intended for source-checkout development only; the distributed package already includes the canonical skill and Python backend.

## Use

Ask DSH to load Cobsidian and organize material into the configured vault. The safe path is:

```text
cobsidian_dry_run
  -> cobsidian_prepare_write
  -> review the diff
  -> DSH asks "Apply this reviewed change?"
  -> exact plan_id stays internal
  -> cobsidian_apply_write
  -> optional cobsidian_rollback
```

Apply and rollback never accept a free-form path. Internally, they accept only a 20-character ID produced by the deterministic Cobsidian backend, but the user does not copy or type it. Approval is bound to the single displayed preview, and the vault target is fixed when the bundle loads.

## Developer Verification

```bash
npm test
npm run pack:check
```

DeepSeek Harness is currently a developer preview. This package pins its tested RC family deliberately; upgrade the DSH peer versions only after running the bundle tests and a real profile smoke test.