@kitelev/exocortex-cli 16.143.1 → 16.144.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +0 -64
- package/dist/index.js +185 -195
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -52,10 +52,8 @@ The following v15 verbs were **removed**: `batch`, `batch-repair`, `command`, `d
|
|
|
52
52
|
| [`classes`](#classes) | List vault classes or describe one class |
|
|
53
53
|
| [`create`](#create) | Create a new vault asset with auto-generated UUID and frontmatter |
|
|
54
54
|
| [`resolve`](#resolve) | Resolve a UUID (full or partial) to a file path |
|
|
55
|
-
| [`watch`](#watch) | Watch the vault for file changes; emit NDJSON events |
|
|
56
55
|
| [`workflow`](#workflow) | List / show / validate workflow definitions |
|
|
57
56
|
| [`recover`](#recover) | Detect and recover orphaned claude-child tmux sessions |
|
|
58
|
-
| [`daemon`](#daemon) | Manage the ValidatorDaemon background process |
|
|
59
57
|
| [`audit`](#audit) | Regression-pattern audits (`co-location`, `ontology-imports`) |
|
|
60
58
|
| [`apply-profile`](#apply-profile) | Apply an `exo__Profile` (mount-state filesystem mutation) |
|
|
61
59
|
| [`bootstrap`](#bootstrap) | Bootstrap a vault with the SDK floor AssetSpace |
|
|
@@ -64,7 +62,6 @@ The following v15 verbs were **removed**: `batch`, `batch-repair`, `command`, `d
|
|
|
64
62
|
| [`exosync`](#exosync) | Sync / pull / push the materialized AssetSpace set over the GitHub REST API |
|
|
65
63
|
| [`exosync-parity`](#exosync-parity) | Read-only ExoSync divergence report (M1/M2 parity check) |
|
|
66
64
|
| [`resolve-deps`](#resolve-deps) | Resolve an AssetSpace's transitive `dependsOn` closure from the registry (CI gate) |
|
|
67
|
-
| [`experimental`](#experimental) | Opt-in experimental features (`rest-push`) |
|
|
68
65
|
|
|
69
66
|
---
|
|
70
67
|
|
|
@@ -355,23 +352,6 @@ npx @kitelev/exocortex-cli resolve a1b2 --partial --format path --vault ~/vault
|
|
|
355
352
|
| `--output <type>` | `text` | Response format: `text` or `json` (for MCP tools) |
|
|
356
353
|
| `--partial` | off | Match partial UUIDs (returns all matches) |
|
|
357
354
|
|
|
358
|
-
### watch
|
|
359
|
-
|
|
360
|
-
Watch the vault for file changes and emit NDJSON events on stdout (one JSON object per line). Startup messages go to stderr. SIGINT/SIGTERM shut down gracefully with exit code `0`.
|
|
361
|
-
|
|
362
|
-
```bash
|
|
363
|
-
npx @kitelev/exocortex-cli watch --vault ~/vault --asset-type ems__Task | jq -c 'select(.type == "modify")'
|
|
364
|
-
```
|
|
365
|
-
|
|
366
|
-
| Option | Default | Description |
|
|
367
|
-
| --------------------- | ------- | -------------------------------------------------------- |
|
|
368
|
-
| `--vault <path>` | cwd | Path to Obsidian vault |
|
|
369
|
-
| `--pattern <glob>` | — | Glob pattern to filter files (e.g. `*.md`, `tasks/**`) |
|
|
370
|
-
| `--asset-type <type>` | — | Filter by asset type from frontmatter (e.g. `ems__Task`) |
|
|
371
|
-
| `--debounce <ms>` | `100` | Per-file debounce interval in milliseconds |
|
|
372
|
-
|
|
373
|
-
Event shape: `{type: "create"|"modify"|"delete", path, relativePath, timestamp, assetType?}`. Watcher errors are emitted to stdout as structured JSON error events.
|
|
374
|
-
|
|
375
355
|
### workflow
|
|
376
356
|
|
|
377
357
|
Manage custom workflow definitions stored in the vault.
|
|
@@ -405,19 +385,6 @@ npx @kitelev/exocortex-cli recover --apply --vault ~/vault-2025
|
|
|
405
385
|
| `--dry-run` | — | List orphans without applying changes (default behavior) |
|
|
406
386
|
| `--apply` | off | Apply recovery: set Failed + kill the tmux session |
|
|
407
387
|
|
|
408
|
-
### daemon
|
|
409
|
-
|
|
410
|
-
Manage the ValidatorDaemon background process (long-running, Unix socket).
|
|
411
|
-
|
|
412
|
-
```bash
|
|
413
|
-
npx @kitelev/exocortex-cli daemon start
|
|
414
|
-
```
|
|
415
|
-
|
|
416
|
-
| Subcommand | Option | Default | Description |
|
|
417
|
-
| ---------- | -------------------------- | ----------------------------------- | ---------------------------------- |
|
|
418
|
-
| `start` | `--socket <path>` | `~/.cache/exocortex/validator.sock` | Unix socket path |
|
|
419
|
-
| `start` | `--idle-timeout <seconds>` | `300` | Exit after N seconds of inactivity |
|
|
420
|
-
|
|
421
388
|
---
|
|
422
389
|
|
|
423
390
|
## Vault Management Commands
|
|
@@ -581,37 +548,6 @@ npx @kitelev/exocortex-cli resolve-deps \
|
|
|
581
548
|
| `--format <type>` | `urls` | Output format: `urls` (one clone URL per line) or `json` (full diagnostics) |
|
|
582
549
|
| `--strict` | off | Exit non-zero (`2`) when `self` is not registered, instead of validating standalone |
|
|
583
550
|
|
|
584
|
-
### experimental
|
|
585
|
-
|
|
586
|
-
Opt-in experimental features. Unstable — may change or be removed.
|
|
587
|
-
|
|
588
|
-
#### experimental rest-push
|
|
589
|
-
|
|
590
|
-
Commit and push a file to a GitHub repo via the pure REST Git Data API (no `git` binary). Gated behind `EXOCORTEX_EXPERIMENTAL_REST_PUSH=1` or `--experimental`.
|
|
591
|
-
|
|
592
|
-
```bash
|
|
593
|
-
EXOCORTEX_EXPERIMENTAL_REST_PUSH=1 npx @kitelev/exocortex-cli experimental rest-push \
|
|
594
|
-
--repo kitelev/some-repo \
|
|
595
|
-
--file notes/hello.md \
|
|
596
|
-
--content "hello" \
|
|
597
|
-
--message "docs: add hello note" \
|
|
598
|
-
--token-from-gh
|
|
599
|
-
```
|
|
600
|
-
|
|
601
|
-
| Option | Default | Description |
|
|
602
|
-
| ---------------------------- | ------------------------ | ------------------------------------------------------------------------- |
|
|
603
|
-
| `--repo <owner/repo>` | **required** | Target repo as `owner/repo` |
|
|
604
|
-
| `--branch <branch>` | `main` | Branch to commit on |
|
|
605
|
-
| `--file <repoPath>` | **required** | Path within the repo to write |
|
|
606
|
-
| `--content <text>` | — | Inline file content |
|
|
607
|
-
| `--content-file <localPath>` | — | Read file content from a local path |
|
|
608
|
-
| `--message <msg>` | **required** | Commit message |
|
|
609
|
-
| `--token-from-gh` | off | Resolve PAT via `gh auth token` |
|
|
610
|
-
| `--token <pat>` | — | GitHub PAT (or env `GITHUB_TOKEN` / `GH_TOKEN`); prefer `--token-from-gh` |
|
|
611
|
-
| `--experimental` | off | Opt in (alternative to `EXOCORTEX_EXPERIMENTAL_REST_PUSH=1`) |
|
|
612
|
-
| `--api-base <url>` | `https://api.github.com` | GitHub API base URL |
|
|
613
|
-
| `--json` | off | Emit result as JSON |
|
|
614
|
-
|
|
615
551
|
---
|
|
616
552
|
|
|
617
553
|
## Exit Codes
|